注释以下每一行代码#include "bflb_adc.h" #include "bflb_mtimer.h" #include "board.h" struct bflb_device_s *adc; #define TEST_ADC_CHANNELS 2 #define TEST_COUNT 10 struct bflb_adc_channel_s chan[] = { { .pos_chan = ADC_CHANNEL_2, .neg_chan = ADC_CHANNEL_GND }, { .pos_chan = ADC_CHANNEL_GND, .neg_chan = ADC_CHANNEL_3 }, }; int main(void) { board_init(); board_adc_gpio_init(); adc = bflb_device_get_by_name("adc"); /* adc clock = XCLK / 2 / 32 */ struct bflb_adc_config_s cfg; cfg.clk_div = ADC_CLK_DIV_32; cfg.scan_conv_mode = true; cfg.continuous_conv_mode = false; cfg.differential_mode = true; cfg.resolution = ADC_RESOLUTION_16B; cfg.vref = ADC_VREF_3P2V; bflb_adc_init(adc, &cfg); bflb_adc_channel_config(adc, chan, TEST_ADC_CHANNELS); for (uint32_t i = 0; i < TEST_COUNT; i++) { bflb_adc_start_conversion(adc); while (bflb_adc_get_count(adc) < TEST_ADC_CHANNELS) { bflb_mtimer_delay_ms(1); } for (size_t j = 0; j < TEST_ADC_CHANNELS; j++) { struct bflb_adc_result_s result; uint32_t raw_data = bflb_adc_read_raw(adc); printf("raw data:%08x\r\n", raw_data); bflb_adc_parse_result(adc, &raw_data, &result, 1); printf("pos chan %d,neg chan %d,%d mv \r\n", result.pos_chan, result.neg_chan, result.millivolt); } bflb_adc_stop_conversion(adc); bflb_mtimer_delay_ms(100); } while (1) { } }

这段代码是使用芯片上的ADC模块读取外部电压信号，并将读取结果打印出来。具体注释如下：

#include "bflb_adc.h"        // 包含 ADC 操作库的头文件
#include "bflb_mtimer.h"     // 包含毫秒级延时库的头文件
#include "board.h"           // 包含与硬件板子相关的头文件

struct bflb_device_s *adc;    // 定义一个指向 ADC 设备的结构体指针

#define TEST_ADC_CHANNELS 2   // 定义测试的 ADC 通道数量为 2
#define TEST_COUNT 10         // 定义测试的次数为 10

struct bflb_adc_channel_s chan[] = {   // 定义 ADC 通道的结构体数组
    {.pos_chan = ADC_CHANNEL_2, .neg_chan = ADC_CHANNEL_GND},
    {.pos_chan = ADC_CHANNEL_GND, .neg_chan = ADC_CHANNEL_3},
};

int main(void) {                         // 主函数

    board_init();                        // 初始化板子
    board_adc_gpio_init();               // 初始化 ADC 相关的 GPIO

    adc = bflb_device_get_by_name("adc"); // 获取 ADC 设备的结构体指针

    /* adc clock = XCLK / 2 / 32 */       // 设置 ADC 的时钟分频为 XCLK/2/32
    struct bflb_adc_config_s cfg;
    cfg.clk_div = ADC_CLK_DIV_32;
    cfg.scan_conv_mode = true;
    cfg.continuous_conv_mode = false;
    cfg.differential_mode = true;
    cfg.resolution = ADC_RESOLUTION_16B;
    cfg.vref = ADC_VREF_3P2V;
    bflb_adc_init(adc, &cfg);             // 初始化 ADC

    bflb_adc_channel_config(adc, chan, TEST_ADC_CHANNELS);   // 配置 ADC 通道

    for (uint32_t i = 0; i < TEST_COUNT; i++) {  // 循环读取 ADC 的值
        bflb_adc_start_conversion(adc);         // 启动 ADC 转换

        while (bflb_adc_get_count(adc) < TEST_ADC_CHANNELS) {  // 等待 ADC 转换完成
            bflb_mtimer_delay_ms(1);                          // 延时 1 毫秒
        }

        for (size_t j = 0; j < TEST_ADC_CHANNELS; j++) {        // 遍历每个 ADC 通道
            struct bflb_adc_result_s result;                    // 定义保存 ADC 转换结果的结构体
            uint32_t raw_data = bflb_adc_read_raw(adc);         // 读取 ADC 原始数据
            printf("raw data:%08x\r\n", raw_data);              // 打印原始数据

            bflb_adc_parse_result(adc, &raw_data, &result, 1);  // 解析 ADC 转换结果
            printf("pos chan %d,neg chan %d,%d mv \r\n", result.pos_chan, result.neg_chan, result.millivolt);   // 打印解析后的数据
        }

        bflb_adc_stop_conversion(adc);        // 停止 ADC 转换
        bflb_mtimer_delay_ms(100);            // 延时 100 毫秒
    }

    while (1) {                               // 循环等待
    }
}