做BLE模块开发这几年我最大的感受是很多人在“选模块还是选芯片”这个问题上纠结很久最后选了模块结果发现模块买回来只是省了射频和协议栈的功夫应用逻辑还是得靠一颗外部MCU来跑。实际上有一种被低估的方案——BLE模块直接支持smartBASIC这类脚本语言让模块自己把应用跑起来。这篇文章我就以实际开发过的Laird Connectivity现在归入Ezurio品牌BL654模块为例聊聊smartBASIC这条技术路线到底能干什么、适合谁以及从编写、编译到烧录跑通的完整过程。1. 先搞懂smartBASIC在解决什么问题BLE模块开发的两条路线1.1 传统方案把BLE模块当成“无线串口管道”大部分人对BLE模块的认知是这样的模块就像一个无线串口MCU通过UART往模块里丢数据模块再通过BLE协议栈把数据发出去。反过来手机发过来的数据也由模块转成串口字节流交给MCU处理。这种模块通常叫“透传模块”很多产品里的做法就是“MCU AT命令控制BLE模块”。这种方案最大的优点是开发快、门槛低。你不需要理解GATT、ATT、L2CAP这些协议层细节只要会用串口发几条AT命令模块就能连上手机收发数据。我也是从这条路入门的当时做第一个BLE项目时大概花了一周就把设备和手机App之间的通信跑通了。但用久了就会发现它的痛点很明显第一外部MCU省不掉。传感器、按键、LED、显示屏这些外围设备总得有人管模块本身只是把数据从串口搬到蓝牙上所有业务逻辑还是得写在外部MCU里。BOM上有两颗芯片成本和体积都上去了。第二功耗很难降到极致。为了跟模块通信外部MCU就不能长时间深度睡眠不然串口数据来了没人处理。而BLE最大的卖点本来就是低功耗结果被外部MCU拖了后腿。第三串口是瓶颈。即使模块的BLE吞吐量能跑到几十KB/sUART的波特率和收发机制也会限制实际数据速率对于需要传输较大数据量的场景很不友好。1.2 smartBASIC方案让模块自己成为“应用大脑”smartBASIC的思路完全不同既然模块内部的SoC本身就有完整的处理器核、内存和外设控制器那为什么不让应用逻辑直接跑在模块上smartBASIC是一种基于BASIC语法的脚本语言由Laird Connectivity为其BLE模块专门设计早期的BL600系列就在用后来的BL654也完整支持。你不需要外挂MCU直接在模块里写脚本控制GPIO、ADC、UART、PWM同时模块内部已经帮你封装好了BLE协议栈脚本里一个函数就能注册服务、发广播、回读写请求。用个不恰当的类比普通透传模块好比一个对讲机你按下按钮只能按固定频道说话smartBASIC模块更像一台带着无线网卡的小电脑你可以在里面编程什么时候说话、说什么内容、怎么处理信号都由自己决定。我实际用下来这种方案有几个很实际的好处系统功耗可以做得非常低。模块平时可以进sleep状态靠GPIO事件、BLE连接事件或者定时器唤醒应用逻辑和无线协议栈都在一颗芯片里不需要跨芯片通信也不会因为外部MCU空转浪费能量。BOM精简。少一颗MCUPCB面积、贴片成本、外围去耦电容都跟着省对成本敏感的产品帮助明显。响应快。GPIO中断直接在模块内部处理不需要经过串口转发到外部MCU再绕回来从事件发生到执行动作的路径短很多。1.3 两种路线怎么选一张对照表我整理过一张选型对照表基本可以覆盖大多数项目的判断依据对比维度透传模块 外部MCUsmartBASIC模块直接编程是否需要外部MCU一般需要不需要模块本身可编程系统功耗较高外部MCU难长时间睡眠低模块可深度睡眠事件唤醒开发门槛低AT命令即可上手中等需要学smartBASIC语法和API灵活性受限通常只能做透传或简单协议高可自定义外设逻辑和BLE服务数据吞吐受串口速率限制模块内部直接访问协议栈路径更短BOM成本两颗主芯片加外围单颗模块适用产品快速验证、简单透传、已有MCU架构低功耗传感器、可穿戴、小批量定制设备需要注意的是这两种路线并不总是非此即彼。有些模块同时支持AT命令和smartBASIC你可以先在AT模式下快速验证硬件再切换到smartBASIC做深入开发。BL654就是这么个路子硬件上是同一颗nRF52840只是固件和运行环境不同。2. smartBASIC的核心机制事件驱动、GATT封装和API体系2.1 为什么BLE应用天然适合事件驱动刚开始写嵌入式固件的人习惯的编程模型是轮询一个while(1)循环不断读按键、查标志位、处理数据。这种模型在简单场景下问题不大但放在低功耗BLE设备上就很吃亏因为CPU必须一直醒着转圈功耗压不下去。BLE应用本质上是事件驱动的。设备大部分时间在等待等待手机连接、等待传感器触发、等待某个定时器到期。用事件驱动模型来写主流程可以随时休息只有事件来的时候才醒来处理处理完继续睡。smartBASIC把这种模型直接做进了语言层面。它提供了一组on_开头的事件处理器你只需要写好“事件来了之后干什么”剩下的调度、睡眠、唤醒都由运行时帮你搞定。举个例子on_ble_connected() // 手机连上了 printf(connected\n) end on_ble_disconnected() // 手机断开了 printf(disconnected\n) end这跟你平时写中断服务程序的思路很像区别在于smartBASIC已经把这些事件底层的东西包装好了不用你去翻协议栈的回调注册机制。我推荐你写smartBASIC程序的时候先把整个应用的事件列表列出来哪些是GPIO触发的哪些是BLE事件哪些是定时器事件。列出之后你会发现代码结构基本就出来了剩下的事情就是在每个事件处理函数里填动作。2.2 GATT是BLE世界里的“文件系统”聊BLE应用绕不开GATT。很多接触过BLE但没深入的人对GATT的理解停留在“一种数据格式”上其实用一个文件系统的类比会更直观Service服务相当于文件夹是某一类功能的集合Characteristic特征值相当于文件夹里的文件具体数据就存在这里每个Service和Characteristic都有一个UUID相当于文件和文件夹的路径标识属性Properties相当于文件的访问权限是只读、可写还是支持通知。smartBASIC里注册一个GATT服务核心APi实际上就三步先注册一个服务端实例然后往里加Service和Characteristic再给Characteristic设置属性。代码逻辑大概是这样的dim hServer hServer ble_registergattserver() dim hBattService, hBattChar hBattService ble_addattr(hServer, 0x180F) // Battery Service hBattChar ble_addattr(hServer, 0x2A19) // Battery Level ble_addattrflag(hServer, hBattChar, 0x10) // 允许Notify0x180F和0x2A19都是Bluetooth SIG定义的16位标准UUID一个代表电池服务一个代表电量值。这样定义好之后手机端就能通过标准BLE API读到这个服务。在做这个部分时我踩过一个坑只加了Characteristic但没设置Notify属性结果手机端一直收不到数据推送。后来查了官方文档才发现Characteristic的属性标志决定了这个数据是只能被手机主动读还是模块可以主动通知两个能力是分开控制的。2.3 smartBASIC的语法和常用APIsmartBASIC的语法基础是BASIC系跟Visual Basic有点像但也有嵌入式语言特有的简洁。变量用dim声明逻辑块用if/endif、for/next、while/wend函数用function...end事件处理器用on_.../end。我刚接触的时候最不适应的点在于smartBASIC不区分大小写而且变量类型没那么严格。写惯了C语言的人可能觉得这有点随意但反过来看这恰恰降低了上手难度——你不必纠结int、uint8_t、size_t这些类型声明一个变量就能存数值、字符串用到哪算哪。常用API我按功能分了一下类功能分类典型API说明GPIOgpiocfg / gpioset / gpioget配置方向、上下拉读写引脚UARTuartopen / uartxwrite / uartread串口收发ADCadcread读取模拟电压PWMpwmopen / pwmwrite驱动蜂鸣器、LED调光BLE广播ble_setadvertisementdata / ble_startadvertising设置广播数据并启动广播BLE GATTble_registergattserver / ble_addattr / ble_senddata注册服务、添加属性、发送通知定时器timer_start / on_timer周期执行任务系统printf / sleep / reset打印日志、延时、复位需要提醒一下不同模块、不同固件版本的smartBASIC API名称可能有细微差别实际开发时要以官方提供的smartBASIC Reference文档为准。我这里列出的API从BL600时代到BL654基本是兼容的大方向不会有问题。3. 实操在BL654模块上跑通第一个smartBASIC工程3.1 硬件准备BL654模块、DVK-BL654开发板、串口BL654是一颗基于Nordic nRF52840 SoC的BLE模块支持BLE 5.0自带天线或外接天线版本都有算力在BLE模块里属于比较强的。它的smartBASIC运行时直接跑在nRF52840上所以你能用到的外设资源也很可观多个GPIO、UART、SPI、I2C、ADC、PWM甚至还有USB外设接口。我推荐有条件的直接上一块DVK-BL654开发板不要一开始就自己画模块底板。开发板上面集成了USB转串口、几个按键、LED、温湿度传感器、光敏传感器新手可以少踩很多硬件坑。我当时自己做底板时就因为天线区域铺铜和匹配电路处理不当导致信号差了一大截后来换成官方开发板才定位到问题出在底板上。开发板上电之后的接线很简单USB线连接开发板和电脑电脑上会出现一个虚拟串口。注意安装好串口驱动BL654开发板用的是FTDI芯片一般会自动识别如果识别不到去官网拉一下驱动就行。3.2 搭工具链uSDK UwTerminalXsmartBASIC开发离不开两样官方工具uSDK和UwTerminalX。uSDK是软件包里面包含了smartBASIC编译器、文档、示例代码、固件镜像。UwTerminalX是一个跨平台的串口终端工具作用是连接模块、发送命令、上传脚本调试时可以直接把UART日志打印到终端里。我一般的工作流是先用UwTerminalX连接模块确认串口能通信然后用uSDK里的编译器把smartBASIC源码编译成模块可执行的格式最后在UwTerminalX里操作上传命令。下载uSDK之后建议先看一下核心文档比如smartBASIC Reference Guide和BL654 User Guide。Laird的文档风格偏工程化目录很清晰遇到API不确定时的第一反应应该是查文档而不是搜论坛。打开UwTerminalX后选择正确的COM口和波特率。这里有个经验BL654默认的串口波特率不一定是常见的115200我的这块板子默认配对波特率就是115200但有些固件版本是9600连接不上时先试试几个常用波特率。连接成功后在终端里输入AT指令能看到模块返回OK说明链路正常。3.3 写一个按键控制LED的应用从代码到跑通我先从一个最简单的应用开始一个按键控制一个LED翻转同时把按键状态更新到广播数据里让手机App能扫描到状态变化。这个小例程麻雀虽小五脏俱全涵盖了GPIO、事件处理、BLE广播三块核心内容。看一下smartBASIC源码// smartBASIC demo: button toggles LED and updates adv data dim nLed, nBtn nLed 1 nBtn 2 // configure pins gpiocfg(nLed, 1, 0) // LED as output, no pull gpiocfg(nBtn, 0, 1) // button as input, pull-up // start advertising with a custom flag dim nAdvFlag nAdvFlag 0 ble_setadvertisementdata(0, nAdvFlag) ble_startadvertising(0) // 0 advertise indefinitely // event: button falling edge on_gpio(nBtn, 1) if nAdvFlag 0 then nAdvFlag 1 gpioset(nLed, 1) else nAdvFlag 0 gpioset(nLed, 0) endif ble_setadvertisementdata(0, nAdvFlag) ble_startadvertising(0) end逐段解释一下nLed和nBtn是两个变量用来存引脚编号。gpiocfg是引脚配置函数三个参数分别是引脚号、方向、上拉模式。nLed作为输出所以方向填1nBtn作为输入因为按钮一端接地需要内部上拉所以第三个参数填1。这里有个很容易弄反的点很多人看到“上拉”就以为按键按下时读到高电平实际上按钮接GND时内部上拉让引脚默认高电平按下瞬间被拉低所以事件触发条件要选下降沿。on_gpio(nBtn, 1)里的1就是下降沿触发。广播数据的设置使用ble_setadvertisementdata第一个参数是广播句柄单广播时通常填0第二个参数是要放进广播包的数据。这里用nAdvFlag当状态位方便手机端扫描解析。编译时在uSDK目录里找到编译器命令行工具执行类似这样的操作sbc -o demo.bcm demo.swd其中demo.swd是smartBASIC源文件demo.bcm是编译产物。编译过程都很顺利如果打出error大概率是API名称拼写或者参数个数不对对照参考文档改了就好。上传脚本到模块时需要先让模块进入DFU模式。不同板子操作方法略有不同我的DVK-BL654上是用跳线帽把DFU引脚拉高然后按一下复位键再插入USBUwTerminalX里就能进入烧录模式。之后在UwTerminalX里选择“Send File”把demo.bcm发进去等进度条走完复位模块应用就跑起来了。跑通那一刻还是有点小兴奋的按下按钮LED翻转手机端用nRF Connect扫描能看到广播数据里的状态位同步变化一个没有外部MCU的BLE节点就这样完成了。3.4 进阶玩法把传感器数据通过BLE通知发出去按键控制LED只是热身实际产品里更常见的需求是定时把传感器数据通过BLE通知发送给手机。比如一个电池供电的温度传感器每隔500毫秒读一次ADC把电压值换算成温度然后通过GATT的Notify属性推给手机。这个逻辑用smartBASIC写核心其实就是一个定时器加一个通知函数dim hServer, hTempChar hServer ble_registergattserver() ble_addattr(hServer, 0x1809) // Health Thermometer Service hTempChar ble_addattr(hServer, 0x2A1C) // Temperature Measurement ble_addattrflag(hServer, hTempChar, 0x10) // Notify property on_timer(500) // every 500ms dim nRaw, nTemp nRaw adcread(0) // read ADC channel 0 nTemp nRaw * 100 / 4096 // simple conversion ble_senddata(hServer, hTempChar, nTemp) end timer_start(500)这里有一个值得注意的点定时器一旦启动就会周期性触发如果不及时睡眠功耗会上去。如果是电池供电设备建议把周期拉长或者在数据没变化时跳过发送。另外手机端必须订阅了该Characteristic的Notification模块才能把数据推送过去否则ble_senddata不会产生实际效果。我一开始没在手机端点击订阅按钮结果模块这边数据一直在发手机端却一点反应都没有排查了半天才发现是订阅问题。4. 常见问题与排查实录脚本、事件、低功耗4.1 串口连不上、脚本上传失败这是新手遇到最多的一个问题。我在调试BL654时就遇到过串口识别不到、上传脚本一直卡住的情况整理下来主要原因有三种现象可能原因排查方法串口列表里找不到COM口驱动没装好重新安装FTDI/CP210x驱动检查USB线是否数据线能打开串口但无响应波特率不对依次尝试9600、115200、57600脚本上传到一半失败模块没正确进入DFU模式检查DFU引脚设置确认上传前模块处于Bootloader状态再提醒一个细节USB线一定要用能传输数据的线。现在很多Type-C线只能充电插上去电脑完全没有反应我因为这个浪费了半小时后来换了一根好的USB线立刻就好了。4.2 事件不触发、数据发不出去代码逻辑看着没问题但模块就是没反应这类问题通常是以下几个原因GPIOCFG方向配置反了。输入引脚配成了输出事件永远不会触发。上下拉设置不对。按钮接法跟pin配置不一致导致电平状态完全反了。广播数据超长。BLE广播包单包最多31字节塞了太多数据会被截断或直接报错。GATT属性没开Notify。加了服务但没加属性标志手机收不到通知。MTU太小。有些数据量较大的通知一次可能发不完需要协商MTU或者分帧发送。我的排查习惯是先在事件处理器里加printf把执行路径打印出来。比如事件到底有没有触发、参数是什么一打印就知道比自己瞎猜快得多。等到逻辑确认没问题再把调试打印删掉。4.3 低功耗和量产踩坑记录smartBASIC的一大卖点是低功耗但低功耗不是写几行sleep代码就能实现的实测下来有几个经验尽量不要用轮询写业务逻辑。while循环读传感器虽然代码简单但CPU一直在跑功耗立刻上去。改成定时器事件或者GPIO中断唤醒状态不处理业务时让模块睡觉功耗可以差出几个数量级。GPIO不要悬空。悬空的引脚会有漏电流而且可能随机跳变产生误触发白白唤醒模块。没有使用的引脚也要配置成固定电平或上拉。调试时串口会显著增加功耗。printf输出会唤醒底层外设测功耗时要把所有调试打印关掉。我一开始一直开着UART打印看温度曲线结果测出来电流总有几毫安以为代码有问题关了打印瞬间降到微安级别。量产烧录时不要一台一台用UwTerminalX手动传。到小批量阶段建议准备一个批量烧录夹具或者直接通过模块的SWD接口烧录比串口方式稳定且快很多。手动串口烧录偶尔会遇到超时、丢包的问题批量生产时完全不可接受。5. 写在最后一些实际体会用smartBASIC做项目是一种和传统MCU开发不太一样的体验。它不会给你C语言那种对底层完全掌控的感觉但反过来BLE协议栈那一大堆复杂细节也不由你操心在中小规模的产品里这种“够用就行、快速交付”的思路非常舒服。我个人的体会是它特别适合低功耗传感器节点、便携设备、医疗健康类小批量产品这类场景团队里如果没有人对BLE协议栈特别熟smartBASIC能帮你绕开很多深坑。如果你做的产品需要对数据吞吐量要求很高、或者要跑复杂的加密算法和UI逻辑那smartBASIC目前未必是最佳选择外挂MCU的多核方案会更合适。可如果你只需要一个稳定省电的BLE数据节点它绝对值得认真评估。最后分享一个我自己常用的扩展思路smartBASIC模块不一定只是“模块”它可以当作一个独立的低功耗协处理器来用。主系统有一颗应用处理器smartBASIC模块负责跟手机通信和传感器采集两边通过UART或者GPIO交换数据。这样主系统依然是自己熟悉的环境BLE部分则交给smartBASIC处理整个架构清晰又稳定。这个用法我在好几个项目里都验证过效果一直很稳。