BLUENRG355MC低功耗蓝牙例程实战：从Beacon广播到射频校准-北京尧图网络

简介这份资源是ST公司BLUENRG355MC蓝牙低功耗SoC的配套例程包面向物联网与可穿戴设备开发者尤其是希望快速上手BlueNRG-LP系列、掌握BLE协议栈配置与低功耗设计的中高级嵌入式工程师。包内共约2000个文件以C源码与头文件为核心辅以hex、bin固件、ewp/uvprojx等IAR与Keil工程文件、icf与sct链接脚本、html文档及png图示压缩包约264.55MB覆盖初始化配置、连接管理、GATT数据传输、功耗控制与中断事件处理等关键模块。已有344人学习下载。借助这些例程读者可对照官方SDK理解BLE协议栈分层结构参考HCI命令交互与自定义服务实现并复用现成的工程模板与链接配置快速将BLUENRG355MC集成到智能家居、健康监测等实际产品中。1. 拿到 BLUENRG355MC 例程包先别急着烧录如果你手里正捏着一块基于 BLUENRG355MC 的板子或者刚接手一个 BlueNRG-LP 系列的低功耗蓝牙项目大概率会遇到一个很现实的问题官方 SDK 里例程一大堆但真要从零跑通一个能用的 BLE 从机光靠翻文档得折腾好几天。BLUENRG355MC 这颗芯片属于 ST 的 BlueNRG-LP 家族主打低功耗蓝牙 5.x内置 Cortex-M0 内核Flash 和 RAM 的配置在同级里算宽裕适合做传感器节点、穿戴设备、工业遥控这类对功耗敏感的场景。这份例程包的价值就在于它把 GPIO 翻转、UART 收发、BLE 广播、连接参数配置这些基础操作都拆成了独立工程你不需要从空白工程开始搭环境直接拿一个最接近需求的例程改能省掉大量底层初始化的时间。适合谁刚接触 BlueNRG-LP 的嵌入式新手以及从其他 BLE 平台迁移过来、想快速摸清 ST 这套工具链脾气的老手。2. 例程包的结构与工具链选型为什么不是 Keil 就是 IAR2.1 例程目录里到底放了什么拿到一个 BlueNRG-LP 的例程包第一件事是看目录结构。常见的组织方式是按功能分文件夹比如BLE_Examples、Peripherals_Examples、Radio_Examples这几大类。BLE 下面又会细分Beacon、Chat、HeartRate、SensorDemo等角色例程。每个例程文件夹里通常包含Inc、Src、EWARMIAR 工程、MDK-ARMKeil 工程以及一个readme.txt。Src里的main.c是入口app_bluenrg.c或类似命名的文件负责 BLE 协议栈的初始化和事件回调。Inc里放的是hci.h、bluenrg_lp_api.h这类协议栈头文件不要改它们改了容易和库版本对不上。一个典型的 BLE 从机例程核心文件就三个main.c做时钟和 GPIO 初始化app_bluenrg.c里调用aci_gap_init设置设备名和广播参数bluenrg_lp_it.c处理中断。剩下的system_bluenrg_lp.c是 ST 提供的系统级初始化一般不动。如果你看到例程里还有sensor.c或led.c那是外设驱动按板子原理图改引脚就行。2.2 Keil 和 IAR 怎么选别在这件事上纠结太久ST 的 BlueNRG-LP SDK 同时提供 Keil MDK 和 IAR EWARM 的工程文件。选哪个如果你公司或团队已经有 Keil 的授权直接用 Keil因为 ST 的很多应用笔记和社区回答都是基于 Keil 的遇到问题搜起来方便。IAR 的优势在编译优化和调试体验但 BlueNRG-LP 的 IAR 工程有时候需要手动调整链接脚本里的 Flash 起始地址新手容易在这里翻车。我一般会建议先打开 Keil 工程确认能编译通过、能下载、能跑起来再考虑要不要换 IAR。不要一上来就两个都装环境变量和 Pack 包容易打架。Keil 需要安装 BlueNRG-LP 的 Device Family PackIAR 需要安装对应的 CMSIS 支持包这些在 SDK 的Utilities文件夹里都有说明。2.3 用命令行编译一次确认工具链没问题在打开 IDE 之前可以先在命令行里跑一次编译确认编译器路径和头文件搜索路径都是对的。以 Keil 为例假设你装的是 MDK可以用UV4.exe做命令行编译# 进入例程的 MDK-ARM 目录 cd BLUENRG_LP_Examples/BLE_Examples/Beacon/MDK-ARM # 用 Keil 命令行编译-b 表示 build-j0 表示不弹窗 UV4.exe -b Beacon.uvprojx -j0 -o build_log.txt # 查看编译结果 cat build_log.txt这段命令的作用是让 Keil 在后台完成一次完整编译输出日志到build_log.txt。如果日志最后出现0 Error(s), 0 Warning(s)说明工具链和工程配置没问题。参数-j0是禁止弹出 GUI 窗口适合脚本化操作。注意UV4.exe的路径要加到系统 PATH 里或者写全路径。如果报错说找不到armcc说明 Keil 的编译器组件没装全重新跑一遍安装程序勾选 ARM Compiler 选项。编译通过之后用 ST-LINK 或 J-Link 下载。BlueNRG-LP 支持 SWD 调试接线就四根VCC、GND、SWDIO、SWCLK。下载完复位如果板子上有 LED应该能看到例程里定义的闪烁模式。3. 从 Beacon 例程改出一个自定义广播参数怎么设、坑在哪3.1 广播间隔和发射功率的取舍Beacon 例程是最适合拿来改的起点因为它只做广播不建立连接代码路径短出问题容易定位。打开app_bluenrg.c找到aci_gap_set_discoverable或aci_gap_set_non_discoverable的调用。广播间隔由adv_interval_min和adv_interval_max两个参数控制单位是 0.625 毫秒。比如你要设 100 毫秒的广播间隔就填 160。发射功率在aci_hal_set_tx_power_level里设置BlueNRG-LP 支持从 -20 dBm 到 8 dBm 的档位。功率越高广播距离越远但功耗也越大。如果是纽扣电池供电的传感器建议设在 0 dBm 到 4 dBm 之间配合 500 毫秒以上的广播间隔实测能撑几个月。如果是对响应速度要求高的遥控器可以设 8 dBm 和 20 毫秒间隔但电池寿命会明显缩短。// 设置广播间隔为 100ms160 * 0.625ms uint16_t adv_interval_min 160; uint16_t adv_interval_max 160; // 设置发射功率为 4 dBm aci_hal_set_tx_power_level(1, 4); // 配置广播数据 uint8_t adv_data[] { 0x02, 0x01, 0x06, // Flags: LE General Discoverable, BR/EDR Not Supported 0x03, 0x03, 0xAA, 0xBB, // 16-bit UUID 0x05, 0x09, T, E, S, T // Complete Local Name }; aci_gap_set_discoverable(ADV_IND, adv_interval_min, adv_interval_max, PUBLIC_ADDR, 0, NULL, 0, sizeof(adv_data), adv_data);这段代码里aci_gap_set_discoverable的第一个参数是广播类型ADV_IND表示可连接的非定向广播。如果你只想广播不想被连接改成ADV_NONCONN_IND。PUBLIC_ADDR表示使用芯片出厂固化的公共地址如果想用随机地址改成RANDOM_ADDR并提前调用aci_hal_write_config_data写入随机地址。广播数据里的0x02, 0x01, 0x06是固定格式表示设备支持 BLE 且不可被 BR/EDR 发现不要随意改。3.2 中断优先级和协议栈回调的配合BlueNRG-LP 的 BLE 协议栈跑在独立的内核上和 Cortex-M0 通过 SPI 或共享内存通信。中断优先级配错会出现广播发不出去、连接后立刻断开这类玄学问题。在bluenrg_lp_it.c里BLE_IRQHandler的优先级要设成最高比 SysTick 和 UART 都高。如果用了 FreeRTOS还要注意协议栈回调里不能调用阻塞式 API。常见做法是在main.c里调用NVIC_SetPriority(BLE_IRQn, 0)把 BLE 中断设为最高优先级。然后检查aci_gap_set_discoverable的返回值如果不是BLE_STATUS_SUCCESS说明协议栈还没初始化完需要等HCI_RESET完成后再调用。这个等待过程通常放在app_bluenrg_init里用while循环轮询hci_read_event直到收到HCI_COMMAND_COMPLETE_EVENT。3.3 用手机 App 验证广播是否正常改完代码烧录后用手机上的 nRF Connect 或 LightBlue 扫一下看能不能看到你设置的设备名和 UUID。如果扫不到先确认板子的天线匹配电路有没有问题再检查广播数据长度是否超过 31 字节。BLE 4.x 的广播包最大 31 字节BLE 5.x 可以用扩展广播突破这个限制但 BlueNRG-LP 的例程默认还是传统广播。超过 31 字节会直接返回错误但有些版本的协议栈不报错只是广播不出去这点特别坑。如果手机能扫到但连不上检查aci_gap_set_discoverable的第二个参数是不是设成了ADV_NONCONN_IND。另外连接参数里的conn_interval_min和conn_interval_max也要设合理太短会增加功耗太长会导致手机端操作卡顿。一般设 30 毫秒到 50 毫秒比较均衡。4. 避坑与排查BlueNRG-LP 例程里最容易翻车的五个点4.1 编译通过但下载后没反应现象Keil 里编译零错误零警告ST-LINK 也显示下载成功但板子上的 LED 不闪手机也扫不到广播。原因BlueNRG-LP 的 Flash 起始地址和 Keil 工程里的 IROM 配置不匹配。有些例程默认从0x10040000开始但实际芯片的 Flash 映射可能不同。解决打开 Keil 的Options for Target在Target标签页里核对IROM1的起始地址和大小。参考 SDK 里system_bluenrg_lp.c中的FLASH_BASE定义确保一致。改完重新编译下载。4.2 广播数据里设备名显示乱码现象手机 App 里能看到设备但名字是一串乱码或者只显示前几个字符。原因广播数据里的长度字段写错了。比如0x05, 0x09, T, E, S, T表示长度 5 字节类型 0x09Complete Local Name后面跟 4 个字符。如果实际写了 6 个字符但长度字段还是 5就会截断或乱码。解决数清楚每个 AD 结构的字节数长度字段类型字段 1 字节数据字节数。设备名建议不超过 10 个字符留空间给其他 AD 结构。4.3 连接后频繁断开现象手机能连上但几秒后就断开反复重连。原因连接参数里的conn_latency设得太大或者从机延迟响应了协议栈的时钟同步事件。解决把conn_latency设为 0conn_interval_min和conn_interval_max设成相同值supervision_timeout至少设为conn_interval的 6 倍。另外检查aci_gap_connect的回调里有没有及时调用aci_gap_slave_security或类似的安全请求函数。4.4 低功耗模式下电流降不下来现象进入睡眠模式后实测电流还是毫安级达不到微安级。原因GPIO 没配置成模拟输入或下拉浮空的引脚会漏电。另外UART 和 SPI 的外设时钟没关。解决在进入低功耗前把所有未使用的 GPIO 设为GPIO_MODE_ANALOG关闭 UART、SPI、I2C 的时钟。BlueNRG-LP 的aci_hal_set_sleep_mode可以配置睡眠深度但需要配合PWR_EnterSTOPMode一起用。实测中把调试用的 SWD 引脚也关掉能再省几十微安。4.5 例程里的 UUID 和手机端对不上现象手机 App 按例程里的 UUID 去读特征值返回GATT_INVALID_HANDLE。原因BlueNRG-LP 协议栈在添加服务时UUID 的字节序和手机端解析的字节序相反。比如 16 位 UUID0xAAAB在代码里要写成{0xAB, 0xAA}。解决统一用aci_gatt_add_service和aci_gatt_add_char的返回值来操作句柄不要硬编码 UUID。如果必须用 UUID 匹配在手机端把字节序反过来试一次。5. 进阶用例程里的 Radio 测试代码做射频校准例程包里通常还有一个Radio_Examples文件夹里面是射频测试代码能发单载波、调频、收包统计。这个比 BLE 例程更底层适合做产线校准或天线匹配调试。我一般会在板子打样回来后先跑一遍Radio_Test用频谱仪看发射功率和频偏确认天线匹配网络没问题再去调 BLE 协议栈的参数。具体操作是打开Radio_Test工程在main.c里选择测试模式。比如要发单载波调用radio_set_tx_test_mode设置信道和功率然后芯片会持续发射。用频谱仪接上天线耦合器看中心频率是不是 2.402 GHz、2.440 GHz 这些 BLE 信道频点。如果频偏超过 ±50 kHz检查晶振的负载电容匹配。// 设置射频测试模式单载波发射信道 02402 MHz功率 0 dBm radio_set_tx_test_mode(0, 0); // 延时 10 秒让频谱仪读数稳定 for (volatile uint32_t i 0; i 10000000; i); // 退出测试模式 radio_set_tx_test_mode(0xFF, 0);这段代码里radio_set_tx_test_mode的第一个参数是信道号0 对应 2402 MHz39 对应 2480 MHz。第二个参数是功率档位0 表示 0 dBm。退出时把信道设为0xFF表示停止发射。注意这个测试模式会绕过协议栈直接控制射频前端所以不要在正常 BLE 连接中使用。还有一个实用技巧用Radio_Test里的收包统计功能可以测出接收灵敏度和丢包率。把两块板子分别设成发射和接收距离拉远看丢包率什么时候超过 1%。这个数据比看数据手册上的灵敏度指标更真实因为包含了天线和匹配电路的损耗。从那以后我每次拿到新的 BlueNRG-LP 板子都会先跑一遍 Radio 测试确认射频链路没问题再去调 BLE 例程。这个习惯帮我省掉了很多“以为是代码问题、其实是天线没匹配好”的后悔药。希望帮到你。本文还有配套的精品资源点击获取

BLUENRG355MC低功耗蓝牙例程实战：从Beacon广播到射频校准

相关推荐

Linux/Android下RTL8188FU/FTV USB WiFi驱动移植与编译实战

MATLAB实现格子Boltzmann两相流模拟：从D2Q9骨架到Shan-Chen调参

RAID 磁盘阵列详解：级别原理、选型指南与故障排查

更多资讯

国内大模型长期使用选型指南：稳定、嵌入、安全、可维的四维评估法

五大主流AI图像生成模型实测与选型指南

MIMO波束成形MATLAB仿真：从信道建模到ZF/MMSE检测完整指南

模型预测控制与扰动观测器：提升PMSM鲁棒性的工程实践

Artcraft：人机协作的决策分层与触觉断点设计

Python Django构建图书管理系统：从模型设计到部署实战

今日更新

智能硬件视频会议集成：从芯片选型到场景落地的全栈实践

FFmpeg音视频处理与5路RTMP推流实战：从原理到118克盒子部署

RK3528+1GB内存如何变身直播节点？硬编解码与六协议实战复盘

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

基于GMM的语音识别系统原理与MATLAB实现详解

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？