1. 项目概述上周安信可开源硬件社区发布了一款名为“小安派-Eyes-DU”的新板子我第一时间就入手了。作为一名嵌入式开发爱好者拿到新板子后的第一件事自然是想办法“点亮”它看看它的能耐。官方资料里提到了一个亮点支持USB OTG功能这意味着它可以通过右侧的USB口直接连接U盘、SD卡甚至摄像头极大地扩展了应用场景不再是简单的单片机。不过今天我们先不玩那些“大”的而是从一个经典又直观的项目入手——用这块板子上的RGB LED实现一个PWM循环呼吸灯。这个项目非常适合刚接触小安派-Eyes-DU或者安信可Ai-M61-32S模组的开发者。通过它你不仅能快速上手这块板子的开发环境搭建、工程管理还能深入理解PWM脉冲宽度调制的原理及其在控制LED亮度上的应用。整个过程涉及查看原理图、查阅芯片手册、配置外设、编写核心逻辑以及最终的编译烧录算是一个完整的嵌入式开发小闭环。下面我就把自己从零开始实现这个呼吸灯的详细过程、踩过的坑以及一些实用技巧分享出来希望能帮你顺利点亮你的第一盏“呼吸灯”。2. 开发环境与工程搭建解析拿到一块新的开发板第一步永远不是急着写代码而是把“地基”打好。这里的地基指的就是一个可以顺利编译、链接和下载的工程框架。对于基于安信可Ai-M61-32S博流BL618芯片的小安派-Eyes-DU官方提供了完善的SDK我们的工作就是在SDK的基础上建立自己的项目工程。2.1 工程文件结构创建与获取官方SDK通常包含了芯片的所有底层驱动、各种外设的示例examples以及编译系统。我们的策略是“站在巨人的肩膀上”复制一个最接近我们需求的示例工程然后进行修改。第一步创建项目目录我习惯在电脑上一个专门的地方存放项目比如D:\Projects\Embedded\AiPi_Eyes_DU。在这个目录下我新建了一个文件夹命名为AiPi_Eyes_DU_PWM_Breathing。这个名字清晰地表明了项目和主要功能便于后期管理。你完全可以根据自己的习惯命名但建议不要用中文或特殊字符避免编译系统出现路径问题。第二步定位并复制示例代码我们的目标是实现PWM控制所以需要找到一个PWM的示例。安信可的SDK结构通常很清晰进入SDK根目录例如aithinker_Ai-M6X_SDK。找到examples文件夹这里面存放了所有外设的演示程序。进入examples/peripherals/pwm_v2/。这里注意是pwm_v2它对应新版驱动功能更完善。其下有一个pwm_basic的示例这个示例通常展示了PWM最基本的使用方法比如固定占空比输出这正是我们需要的起点。将pwm_basic文件夹下的所有文件通常包括main.c,CMakeLists.txt,Makefile,flash_prog_cfg.ini等复制到我们刚才创建的AiPi_Eyes_DU_PWM_Breathing项目文件夹中。注意这里有个关键点不是复制pwm_basic这个文件夹本身而是复制该文件夹内的所有内容到你的项目根目录。这样做的目的是让我们的项目目录结构直接成为编译系统的根简化路径配置。2.2 关键工程配置文件的修改复制过来的文件是“通用模板”我们需要将其“个性化”绑定到我们自己的项目上。主要修改三个文件CMakeLists.txt、flash_prog_cfg.ini和Makefile。这些文件共同决定了项目如何被构建以及如何被烧录到板子上。2.2.1 修改 CMakeLists.txt这个文件是CMake编译系统的入口它定义了项目名称和最低CMake版本要求。用文本编辑器如VS Code, Notepad打开它找到类似下面的一行project(pwm_basic)将其中的pwm_basic修改为你自己的项目文件夹名称例如project(AiPi_Eyes_DU_PWM_Breathing)这个名称会在编译过程中生成对应的中间文件和最终的可执行文件保持一致性可以避免混淆。2.2.2 修改 flash_prog_cfg.ini这个文件是烧录工具如Bouffalo Lab Dev Cube或blflash的配置文件告诉烧录器固件的名称和位置。打开文件找到[FW]段落修改file和name字段。[FW] file AiPi_Eyes_DU_PWM_Breathing.bin name AiPi_Eyes_DU_PWM_Breathing确保file指定的.bin文件名与CMakeLists.txt中project定义的名字一致通常编译后会生成项目名.bin。这样烧录工具才能正确找到并识别你的固件。2.2.3 修改 Makefile最关键的一步Makefile是控制编译流程的核心它定义了源代码、头文件、库文件的路径以及编译规则。对于从SDK示例复制的项目最关键的是设置正确的SDK_PATH。 打开Makefile在文件开头附近你会找到类似SDK_PATH ? ...的语句。它的默认值可能是相对路径../../../../即从示例目录pwm_basic回溯到SDK根目录。 现在我们的项目目录变了这个相对路径很可能失效。你需要将其修改为从你的项目根目录到SDK根目录的绝对路径或正确相对路径。绝对路径示例推荐更稳定SDK_PATH ? D:/Tools/aithinker_Ai-M6X_SDK相对路径示例如果你的项目目录AiPi_Eyes_DU_PWM_Breathing直接放在SDK的examples目录下不推荐会污染SDK那么路径可能是../../../。但更清晰的做法是使用绝对路径。实操心得在Windows下路径中的反斜杠\在Makefile中可能需要转义或直接使用正斜杠/使用/通常兼容性更好。修改后可以在项目目录下打开命令行先执行make clean清理旧文件再执行make尝试编译。如果出现“找不到头文件”或“未定义的引用”等错误十有八九是SDK_PATH设置不对。耐心检查路径确保它能正确指向包含components、drivers等文件夹的SDK根目录。完成以上三步工程的基础框架就搭建好了。此时执行make命令应该能成功编译生成.bin和.elf等文件。接下来我们就可以专注于业务逻辑——编写呼吸灯代码了。3. 硬件原理与PWM驱动初始化在动手写代码控制LED呼吸之前我们必须搞清楚两件事第一硬件上LED是怎么连接的第二软件上如何正确地初始化和配置PWM模块。这就像开车前要知道方向盘和油门在哪以及如何启动发动机。3.1 原理图分析与引脚确认小安派-Eyes-DU板载了一颗RGB LED三色灯。要实现呼吸灯我们需要知道这三颗颜色LED红、绿、蓝分别连接到了芯片的哪个GPIO引脚上并且要确认这些引脚是否支持PWM功能。查阅资料原理图在嘉立创EDA开源平台或安信可官网找到“AiPi-Eyes-DU”的原理图。搜索“LED”或“RGB”关键词可以找到类似下面的连接关系具体引脚号以你手中的原理图为准本例假设如下红色LED (R) 串联限流电阻后连接到芯片的IO15引脚。绿色LED (G) 连接到IO12引脚。蓝色LED (B) 连接到IO14引脚。 电路通常是共阳接法即LED的阳极接电源VCC阴极通过电阻接到GPIO。当GPIO输出低电平时LED点亮输出高电平时LED熄灭。PWM控制正是通过快速切换高低电平的比例占空比来调节平均电流从而实现亮度变化。芯片数据手册找到Ai-M61-32S模组的规格书如ai-m61-32s_v1.1.0.pdf。我们需要确认IO15、IO12、IO14这三个引脚是否具备PWM输出功能。在数据手册的“引脚功能定义”或“Pin Multiplexing”章节可以查到每个GPIO的复用功能。以BL618芯片为例其PWM输出通常标记为PWM0_CH0、PWM0_CH1等。假设我们查到IO12 可复用为PWM0_CH0IO14 可复用为PWM0_CH1IO15 可复用为PWM0_CH2这就完美了三个LED恰好可以分配到同一个PWM模块PWM0的三个不同通道上方便统一控制。注意事项一定要以官方最新原理图和规格书为准。引脚复用功能是硬件决定的如果配置错误例如试图将一个不支持PWM的引脚配置为PWM输出代码可能编译通过但硬件上不会有任何输出这是新手常踩的坑。3.2 PWM与GPIO的初始化代码详解了解了硬件连接我们就可以开始编写初始化代码了。这部分代码通常放在main()函数的开始位置。3.2.1 包含必要的头文件首先在main.c文件的开头我们需要包含芯片外设驱动的头文件。最基本的需要GPIO和PWM的头文件。#include “bflb_gpio.h” // GPIO操作头文件 #include “bflb_pwm_v2.h” // PWM v2驱动头文件 #include “board.h” // 板级支持包可能包含一些板载硬件定义3.2.2 定义设备句柄与配置结构体在驱动层编程中通常使用“句柄”handle来代表一个硬件设备实例后续所有操作都通过这个句柄进行。// 定义PWM设备句柄和GPIO设备句柄 struct bflb_device_s *pwm0; // 假设我们使用PWM0模块 struct bflb_device_s *gpio; // GPIO设备句柄 // 定义PWM的配置结构体 struct bflb_pwm_v2_config_s pwm_cfg;bflb_device_s是一个表示设备的结构体指针bflb_pwm_v2_config_s是用于配置PWM参数如频率、极性等的结构体。3.2.3 初始化硬件设备在main()函数中我们需要依次获取设备句柄并对其进行配置。int main(void) { // 1. 系统基础初始化时钟等通常board_init()会完成 board_init(); // 2. 获取PWM0设备句柄。“pwm_v2_0”是设备名称在驱动中注册的标识 pwm0 bflb_device_get_by_name(“pwm_v2_0”); if (pwm0 NULL) { printf(“PWM0 device get failed!\r\n”); while (1); } // 3. 获取GPIO设备句柄 gpio bflb_device_get_by_name(“gpio”); if (gpio NULL) { printf(“GPIO device get failed!\r\n”); while (1); } // 4. 配置PWM参数 pwm_cfg.clk_source BFLB_SYSTEM_PBCLK; // 时钟源选择外设总线时钟 pwm_cfg.clk_div 40; // 时钟分频系数用于降低PWM计数器时钟频率 pwm_cfg.period 1000; // PWM一个完整周期的计数值决定频率 // 频率计算公式Fpwm Fsource / (clk_div * (period 1)) // 假设PBCLK80MHz则 Fpwm 80,000,000 / (40 * 1001) ≈ 1999.6 Hz // 这个频率远高于人眼分辨的闪烁频率100Hz用于调光非常合适。 // 初始化PWM0设备并传入配置 bflb_pwm_v2_init(pwm0, pwm_cfg); // 5. 配置GPIO引脚复用为PWM功能 // 将IO12, IO14, IO15分别设置为PWM0的通道0,1,2输出 bflb_gpio_af_set(gpio, GPIO_PIN_12, GPIO_AF_PWM0); // PWM0_CH0 bflb_gpio_af_set(gpio, GPIO_PIN_14, GPIO_AF_PWM0); // PWM0_CH1 bflb_gpio_af_set(gpio, GPIO_PIN_15, GPIO_AF_PWM0); // PWM0_CH2 // 6. 启动PWM0模块 bflb_pwm_v2_start(pwm0); // ... 后续呼吸灯逻辑代码 }关键点解析clk_div和period这两个参数共同决定了PWM的输出频率。频率不宜过低否则LED会闪烁也不宜过高否则可能超出硬件限制或增加功耗。通常选择几百Hz到几KHz之间。上面的计算示例给出了一个约2KHz的频率是LED调光的常用范围。bflb_gpio_af_set这个函数非常关键它完成了GPIO引脚的功能复用Alternate Function。在这之前这些引脚是普通的GPIO执行此函数后它们就被“切换”到了PWM外设模块由PWM硬件控制器直接驱动输出波形CPU无需干预。board_init()这个函数由SDK提供它初始化了系统时钟、中断等基础硬件环境。在调用任何外设驱动前必须先执行它。至此硬件和底层驱动就准备就绪了。PWM模块已经开始运行并以我们设置的频率和默认占空比通常是0%在三个通道上输出信号。接下来我们就要在循环中动态改变占空比创造出呼吸的效果。4. 呼吸灯核心逻辑实现与代码剖析初始化完成后PWM硬件就会自动按照设定的周期和占空比生成方波。呼吸灯的本质就是让占空比即高电平在一个周期内所占的时间比例随时间平滑地变化。当占空比从0%逐渐增加到100%时LED亮度从暗到最亮再从100%减小到0%时亮度从最亮到暗如此循环形成“呼吸”视觉效果。4.1 占空比控制函数理解在博流BL618的PWM v2驱动中设置单个通道占空比的函数原型可能类似于void bflb_pwm_v2_channel_set_threshold(struct bflb_device_s *dev, uint8_t ch, uint32_t low_threshold, uint32_t high_threshold);或者是一个更上层的封装函数。根据原始资料我们假设有一个函数用于设置占空比其逻辑是占空比 (high_threshold - low_threshold) / (period 1) * 100%。为了更直观我们可以自己封装一个易于使用的函数/** * brief 设置指定PWM通道的占空比 * param dev PWM设备句柄 * param ch 通道号 (0, 1, 2...) * param duty_cycle 占空比范围 0.0 ~ 1.0 (对应 0% ~ 100%) */ static void pwm_set_duty_cycle(struct bflb_device_s *dev, uint8_t ch, float duty_cycle) { // 确保占空比在有效范围内 if (duty_cycle 0.0f) duty_cycle 0.0f; if (duty_cycle 1.0f) duty_cycle 1.0f; // 根据PWM周期计算阈值。假设period1000是之前初始化时设置的。 // 注意有些驱动库的阈值设置是绝对的计数值需要根据period换算。 uint32_t pulse_width (uint32_t)(duty_cycle * (period 1)); // 调用底层驱动函数。这里假设low_threshold固定为0通过high_threshold控制占空比。 // 具体函数名和参数请以实际SDK的API为准。 bflb_pwm_v2_channel_set_threshold(dev, ch, 0, pulse_width); }这个函数将浮点数的占空比0.0到1.0转换为了硬件需要的计数值。period是我们在初始化PWM配置结构体pwm_cfg时设置的周期值例如1000。4.2 呼吸效果算法实现有了设置占空比的函数接下来就需要一个算法来生成连续变化的占空比值。一个简单且效果不错的算法是使用三角函数正弦或余弦或者使用线性变化配合缓动函数。这里我们实现一个经典的线性“三角波”呼吸效果它容易理解且计算量小。思路定义一个方向变量direction1表示增加-1表示减少和一个当前亮度变量brightness范围0~1000对应0%~100%的占空比分辨率更高。在主循环while(1)中每次循环根据方向增减brightness。当brightness达到上限如1000或下限0时反转方向。将brightness转换为占空比并设置到三个PWM通道可以分别设置不同颜色实现彩色呼吸。代码示例// 在main函数初始化部分之后 uint16_t brightness 0; // 当前亮度值0~1000 int8_t direction 1; // 变化方向1为渐亮-1为渐暗 uint32_t last_tick 0; // 用于记录上次更新时间 const uint32_t interval_ms 10; // 亮度更新间隔单位毫秒控制呼吸速度 while (1) { // 获取当前系统滴答数毫秒需要SDK提供类似 bflb_mtimer_get_time_ms() 的函数 uint32_t current_tick bflb_mtimer_get_time_ms(); // 判断是否到达更新间隔 if ((current_tick - last_tick) interval_ms) { last_tick current_tick; // 更新亮度值 brightness direction; // 边界检查与方向反转 if (brightness 1000) { brightness 1000; direction -1; // 达到最亮开始变暗 } else if (brightness 0) { brightness 0; direction 1; // 达到最暗开始变亮 } // 将亮度值转换为占空比 (0.0 ~ 1.0) float duty (float)brightness / 1000.0f; // 设置三个LED的占空比可以相同也可以不同以产生混合色效果 // 示例1三色同步呼吸白光呼吸 pwm_set_duty_cycle(pwm0, 0, duty); // 绿色通道 pwm_set_duty_cycle(pwm0, 1, duty); // 蓝色通道 pwm_set_duty_cycle(pwm0, 2, duty); // 红色通道 // 示例2三色交替呼吸更炫酷 // 可以利用相位差例如 // float duty_r (sin(phase) 1.0f) / 2.0f; // 红色 // float duty_g (sin(phase 2.0f*PI/3.0f) 1.0f) / 2.0f; // 绿色 // float duty_b (sin(phase 4.0f*PI/3.0f) 1.0f) / 2.0f; // 蓝色 // 然后分别设置并让phase缓慢增加。 } // 这里可以添加一个短延时降低CPU占用率但注意不要影响定时精度 // bflb_mtimer_delay_ms(1); }参数调节与效果优化interval_ms这个值直接控制呼吸速度。值越小亮度更新越快呼吸周期越短。通常设置在5ms到50ms之间你可以根据实际效果调整。太慢会感觉卡顿太快则可能因为视觉暂留效应减弱呼吸感。brightness范围这里是0~1000这个范围决定了亮度变化的“步进”分辨率。1000意味着有1001个亮度级别变化会很平滑。如果范围太小比如0~100可能会看到明显的亮度跳变。非线性变换线性变化brightness direction产生的呼吸效果是匀速的。但人眼对亮度的感知是非线性的近似对数关系。为了获得更符合人眼直觉的“平滑”呼吸效果可以对duty进行非线性映射例如使用duty pow((float)brightness/1000.0f, 2.2)伽马校正这样在低亮度区域变化更缓慢高亮度区域变化更快视觉效果更佳。实操心得在调试呼吸灯时如果发现LED在最低亮度时没有完全熄灭或者在最高亮度时没有达到最亮可能是由于PWM的low_threshold和high_threshold设置与LED的导通电压/电流不完全匹配。可以尝试微调pwm_set_duty_cycle函数中pulse_width的计算公式例如引入一个最小/最大偏移量。另外确保你的period值设置合理如果太小可能无法提供足够的亮度分级如果太大频率会过低导致闪烁。5. 编译、烧录与调试问题全记录代码写完了离成功只差最后一步把它变成板子上跑起来的程序。这个过程看似简单却最容易遇到各种“妖魔鬼怪”。下面我把从编译到上板调试的完整流程和可能遇到的问题梳理一遍。5.1 编译流程与命令详解我们之前已经配置好了Makefile。现在打开终端命令行进入你的项目根目录AiPi_Eyes_DU_PWM_Breathing。清理编译环境可选但推荐make clean这个命令会删除之前编译生成的中间文件.o,.d等和最终输出文件.bin,.elf。在第一次编译或者修改了Makefile、CMakeLists.txt等构建文件后执行一次清理可以避免旧文件干扰。执行编译make这是最核心的命令。Make工具会读取Makefile依次执行检查所有源文件如main.c的依赖。调用交叉编译器如riscv64-unknown-elf-gcc将C源文件编译成目标文件.o。调用链接器将所有目标文件以及SDK中的库文件链接在一起生成可执行文件.elf。使用工具从.elf文件中提取出二进制机器码文件.bin这个文件才是最终要烧录到芯片Flash中的。编译成功标志 如果一切顺利你会在终端看到编译进度信息最后几行通常会出现生成文件的路径例如... Size of section .text: 12345 bytes Size of section .data: 678 bytes create AiPi_Eyes_DU_PWM_Breathing.bin build finished.并且在项目目录下或build子目录找到AiPi_Eyes_DU_PWM_Breathing.bin文件。常见编译错误与解决fatal error: xxx.h: No such file or directory 头文件找不到。99%的原因是SDK_PATH在Makefile中设置错误。请仔细检查路径确保它指向正确的SDK根目录并且该目录下存在components、drivers等文件夹。undefined reference toxxx 链接错误函数未定义。这通常是因为没有包含必要的源文件或库到编译列表中。检查Makefile中的SRCS和INCLUDES变量确保你使用的驱动模块如pwm_v2的源文件路径被正确添加。函数名拼写错误或者你调用的函数在当前SDK版本中不存在。对照SDK中的头文件.h确认函数原型。make: *** No rule to make target xxx. Stop.Makefile规则错误。可能是你移动或删除了某些源文件但Makefile的依赖关系没更新。执行make clean后再make试试。5.2 烧录固件到开发板生成.bin文件后就需要将它烧录到小安派-Eyes-DU板子的Flash存储器中。烧录需要硬件连接和烧录工具。5.2.1 硬件连接准备供电与串口使用USB-TypeC线连接板子的“USB/UART”口到电脑。这个口通常既负责供电也集成了CH340等USB转串口芯片用于程序烧录和串口日志打印。进入烧录模式大多数博流芯片需要通过拉低某个引脚如GPIO8在上电时进入烧录模式。小安派-Eyes-DU板子通常设计了一个“BOOT”按钮。操作顺序先按住板子上的BOOT按钮不放然后按一下RST复位按钮最后松开BOOT按钮。此时芯片应进入烧录等待状态。验证在电脑的设备管理器中可能会发现一个新的串口设备如COM3。或者使用烧录工具扫描时可以找到设备。5.2.2 使用烧录工具安信可通常推荐使用博流官方工具Bouffalo Lab Dev Cube或其命令行工具blflash。这里以命令行blflash为例它更轻量且易于脚本化。安装blflash根据你的操作系统Windows/macOS/Linux从博流官方GitHub仓库下载或编译blflash工具。查找设备将板子进入烧录模式并连接电脑后运行blflash --list它会列出可用的串口。记下你的板子对应的串口号如COM3或/dev/ttyUSB0。执行烧录blflash --port COM3 --baudrate 2000000 flash AiPi_Eyes_DU_PWM_Breathing.bin --address 0x0--port: 指定你的串口号。--baudrate: 烧录波特率2Mbps是常用高速波特率。flash: 子命令表示烧录操作。AiPi_Eyes_DU_PWM_Breathing.bin: 要烧录的固件文件路径。--address 0x0: 烧录的起始地址对于大多数应用从Flash的0地址开始。烧录成功工具会显示擦除、编程、校验的进度最后出现 “Flash finished” 或类似的成功提示。5.2.3 运行与复位烧录完成后按一下板子的RST复位按钮。芯片会从Flash的0地址开始执行我们刚刚烧录的程序。如果代码正确你应该能看到RGB LED开始柔和地呼吸闪烁。5.3 调试与问题排查实录第一次尝试往往不会一帆风顺。以下是我在实现过程中遇到的一些典型问题及解决方法问题1烧录工具找不到设备/连接失败。可能原因驱动未安装USB转串口芯片如CH340的驱动没有正确安装。去芯片官网下载并安装对应驱动。串口被占用其他软件如串口调试助手打开了该串口。关闭所有可能占用串口的程序。BOOT模式进入失败按键顺序不对或按键接触不良。严格按照“按住BOOT - 按RST - 松开BOOT”的顺序操作确保按键按下。线材问题换一根质量好的USB数据线试试。解决检查设备管理器端口状态重新安装驱动确保操作顺序正确。问题2程序烧录成功但LED不亮或常亮不呼吸。排查步骤检查硬件用万用表测量LED两端电压或者将GPIO配置为普通输出模式手动拉低/拉高看LED是否能点亮/熄灭排除硬件损坏或焊接问题。检查初始化确认bflb_gpio_af_set函数是否被正确调用引脚号是否与原理图一致。可以在调用后加一个延时再尝试用GPIO函数控制该引脚如果还能控制说明复用没成功。检查PWM参数确认PWM频率是否合适。频率太低如几十Hz会看到明显的闪烁频率太高可能超出LED驱动电路响应能力。尝试一个经典的1KHz频率clk_div80,period999假设时钟80MHz。检查占空比设置在while循环开始前直接写死一个占空比如50%看LED是否以一半亮度常亮。这样可以隔离呼吸算法的问题。使用调试器或串口打印如果有JTAG/SWD调试器可以单步跟踪代码。更简单的方法是使用串口打印调试信息。在代码关键位置如初始化成功、设置占空比时通过printf输出变量值到串口用串口助手查看这是嵌入式调试最常用的手段。确保在board_init()后初始化了串口。问题3呼吸效果不平滑有阶梯感或抖动。可能原因亮度变化步进太大brightness的变化步长是1但如果period很小比如100那么占空比变化分辨率就只有1%阶梯感明显。增大period如1000可以提升分辨率。更新间隔不稳定使用bflb_mtimer_delay_ms(interval_ms)做延时如果系统有其他中断或任务可能导致延时不准。建议使用基于系统滴答定时器的绝对时间判断如前面代码示例中的last_tick方法这样即使某次循环被延迟也不会影响整体的时间节奏。视觉错觉尝试非线性变换伽马校正让亮度变化更符合人眼感知。问题4编译出的.bin文件巨大。可能原因编译时没有开启优化并且包含了调试信息。解决在Makefile的CFLAGS中添加优化选项如-Os优化尺寸。对于最终发布版本还可以移除调试符号-g。注意优化可能会影响调试开发阶段可以暂时不优化。通过以上系统的编译、烧录和排查流程你应该能成功让小安派-Eyes-DU上的RGB LED按照你的代码意图“呼吸”起来。这个过程本身就是对嵌入式开发从代码到硬件运行全链路的一次完整实践。