1. 认识黄山派SF32开发板第一次拿到黄山派SF32开发板时这块板子的精致程度让我有点意外。作为一款定位低功耗、显示和无线场景的开发板它搭载的SF32LB52x芯片模组确实让人眼前一亮。板载8MB OPI-PSRAM和128Mb QSPI-NOR Flash的配置对于开发智能手表、桌面助手这类应用绰绰有余。这块开发板最吸引我的地方是它的1.85寸MOLED屏幕390*450的分辨率显示效果非常细腻。实际测试时发现800cd/m²的亮度在阳光下也能清晰可见这对于户外设备开发是个巨大优势。板子上的Type-C接口直接集成了CH340N串口芯片省去了外接调试器的麻烦插上电脑就能直接调试。硬件亮点六轴IMULSM6DS3TR-C和环境光传感器LTR-303ALS-01的加入让运动追踪开发变得简单板载Class-D音频功放可以直接驱动喇叭实测音质比想象中好通过40pin排针引出的丰富接口可以灵活扩展各种外设2. 开发环境搭建全流程2.1 基础软件安装在Windows下搭建开发环境时我建议先安装这几个必备工具Git版本控制必备建议从官网下载最新版Python 3.9注意不要用太新的版本比如3.14会有兼容问题VSCode后续开发主要用的IDE安装Python时有个坑要注意一定要勾选Add Python to PATH选项否则后面运行脚本会遇到各种找不到命令的问题。我一开始没注意后来不得不卸载重装。2.2 获取SDK代码官方提供了两个代码仓库地址git clone --recursive https://github.com/OpenSiFli/SiFli-SDK # 或者国内镜像 git clone --recursive gitgitee.com:SiFli/sifli-sdk.git这里特别强调--recursive参数必须加上因为SDK依赖很多子模块。我第一次没加这个参数结果编译时各种报错不得不删除重新克隆。2.3 工具链安装在SDK目录下打开PowerShell记得用管理员权限先设置执行策略Set-ExecutionPolicy RemoteSigned然后配置工具链路径和国内镜像源$env:SIFLI_SDK_TOOLS_PATHD:\DevEnv\SIFLI_Toolchain $env:SIFLI_SDK_GITHUB_ASSETSdownloads.sifli.com/github_assets $env:PIP_INDEX_URLhttps://mirrors.ustc.edu.cn/pypi/simple .\install.ps1这里我踩过一个坑工具链路径最好不要包含中文和空格否则某些脚本会解析失败。安装过程会下载约1.5GB的工具链文件用国内镜像能快很多。3. 编译第一个Hello World3.1 环境变量配置每次打开新终端都需要先配置环境cd E:\Git_Projects\sifli-sdk $env:SIFLI_SDK_TOOLS_PATHD:\DevEnv\SIFLI_Toolchain .\export.ps1建议把这几行保存成start_dev.ps1脚本以后双击就能配置好环境。3.2 编译示例项目进入hello_world例程目录cd example\get-started\hello_world\rtt\project scons --boardsf32lb52-lchspi-ulp -j8编译过程中可能会遇到子模块未初始化的错误这时需要运行git submodule update --init --recursive编译成功标志最后看到scons: done building targets且没有报错在build_sf32lb52-lchspi-ulp_hcpu目录下会生成.bin和.hex文件。4. 烧录与调试技巧4.1 硬件连接准备烧录前需要用Type-C线连接开发板和电脑短接5-6、7-8和11-12脚重要在设备管理器中确认CH340串口识别正常4.2 烧录操作运行烧录脚本build_sf32lb52-lchspi-ulp_hcpu\uart_download.bat根据提示选择正确的COM口编号。烧录成功后用串口工具如SSCOM打开对应端口波特率设为1000000可以看到程序输出。常见问题如果烧录失败尝试按一下板子上的复位键出现校验错误可以多试几次有时是接触不良导致确保跳线帽连接正确这个最容易忽略5. 进阶开发指南5.1 使用VSCode高效开发推荐配置安装C/C、Python、RT-Thread插件配置SF32专用终端terminal.integrated.profiles.windows: { SF32: { path: C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe, args: [ -ExecutionPolicy, Bypass, -NoExit, -Command, $env:SIFLI_SDK_TOOLS_PATHD:\\DevEnv\\SIFLI_Toolchain; . E:\\Git_Projects\\sifli-sdk\\export.ps1 ] } }5.2 小智AI应用开发克隆AI示例仓库git clone --recursive gitgithub.com:78/xiaozhi-sf32.git编译命令与之前类似但需要注意# 修改app/project/SConstruct文件 # 将 PrepareEnv(board_search_path../boards) # 改为 PrepareEnv()5.3 Watch UI开发获取UI示例代码git clone --recursive https://github.com/OpenSiFli/lckfb-hspi-ulp_example这个项目使用了LVGL图形库编译时会自动处理图片资源转换。遇到图片格式问题时可以检查ezip工具的版本是否匹配。6. 常见问题解决方案问题1运行install.ps1时报权限错误解决方案以管理员身份运行PowerShell先执行Set-ExecutionPolicy RemoteSigned问题2Python包安装失败解决方案检查Python版本是否为3.9.x确保pip源配置正确问题3编译时报内存不足解决方案减少并行编译线程数把-j8改为-j4问题4烧录后无输出解决方案检查串口波特率是否为1000000尝试在串口工具里勾选/取消RTS触发复位开发过程中最耗时的往往是环境配置环节特别是网络不稳定时工具链下载容易中断。建议把下载好的工具链备份下次可以直接指定路径使用。