基于蓝牙串口与LabVIEW FPGA的嵌入式无线控制项目实践-平芜编程栈

1. 项目概述：当蓝牙遇上嵌入式控制

最近在整理实验室的NI myRIO设备时，发现了一个挺有意思的玩法：用手机通过蓝牙，远程控制myRIO板载的LED灯。听起来好像很简单，不就是点个灯嘛？但当你真正把蓝牙模块HC-05、嵌入式实时控制器myRIO和手机App串起来，实现一个从无线指令到硬件动作的完整闭环时，那种“万物互联”的实感一下子就出来了。这个项目非常适合工控、自动化或者机器人入门的朋友，它不涉及复杂的算法，却能让你一次性摸透串口通信、蓝牙协议栈、LabVIEW FPGA编程以及上位机交互这几个关键环节。

我手头正好有NI myRIO-1900和一块经典的HC-05蓝牙串口模块。myRIO本身功能强大，集成了Xilinx FPGA和双核ARM处理器，但咱们今天先不搞复杂的实时控制，就聚焦在最基础的“开灯-关灯”上。通过这个项目，你能学会如何为myRIO编写底层的FPGA VI来控制I/O口，如何配置HC-05模块建立稳定的蓝牙串口链路，以及如何用手机上的串口调试工具发送指令。整个过程就像搭积木，每一步都有明确的输入输出，最终拼成一个能响应你手机命令的智能硬件节点。无论是用于设备状态远程指示、简单的无线调试，还是作为更复杂无线控制系统的原型，这个基础框架都很有价值。

2. 核心硬件与通信链路解析

2.1 NI myRIO的I/O资源与LED电路

NI myRIO-1900上自带了一些用户可编程的LED，通常位于板卡边缘，标为USER LED。以myRIO-1900为例，它通常有4个这样的LED，分别对应FPGA上的特定I/O线。这些LED的一端通过限流电阻连接到FPGA的Bank电压（通常是3.3V），另一端由FPGA的I/O引脚控制。当FPGA将对应引脚设置为低电平时，形成回路，LED点亮；设置为高电平时，LED熄灭。这是最典型的共阳极接法。

在LabVIEW FPGA项目中，这些LED被映射为布尔类型的控件或指示器。你需要知道它们对应的FPGA I/O项名称，例如“LED0”到“LED3”。控制它们本质上就是对这些布尔量进行写操作。FPGA VI运行在myRIO的Xilinx芯片上，能提供确定性的、微秒级的定时控制，这对于保证蓝牙指令响应的实时性至关重要。虽然我们这个项目对实时性要求不高，但理解FPGA的编程模型是操作myRIO硬件的基础。

2.2 HC-05蓝牙串口模块详解

HC-05是一款非常流行的蓝牙2.0+EDR模块，支持主从两种模式，我们这里将其用作从机（Slave），等待手机（主机）连接。它的核心功能是将蓝牙协议“翻译”成简单的串口通信。你通过TX、RX、VCC、GND四根线将其连接到myRIO，之后所有复杂的蓝牙配对、数据封装和解封装都由模块内部完成，对用户而言，操作它就像操作一个普通的串口一样。

模块上有几个关键点需要注意。首先是工作模式：上电即进入自动连接的数据模式；若要进入AT指令模式配置参数（如名称、配对码、波特率），需要在模块上电前，将KEY引脚（或EN引脚，视版本而定）拉高至VCC。其次是与myRIO的电平匹配：HC-05的逻辑电平通常是3.3V，与myRIO的FPGA I/O电平兼容，可以直接连接。最后是波特率：默认通常是9600 bps，但为了后续传输更流畅，我们通常会通过AT命令将其设置为115200 bps。

2.3 蓝牙串口通信协议设计

通信协议是整个项目的“语言规则”。我们需要定义一套简单有效的指令集，让手机和myRIO能互相理解。为了兼顾可靠性和易实现性，我设计了一个基于ASCII字符的文本协议。

一个完整的指令可以这样定义：[命令头][LED编号][动作符]<回车换行>。例如：

L1ON\r\n：点亮LED1。
L2OFF\r\n：熄灭LED2。
L3T\r\n：切换（Toggle）LED3的状态。

为什么用文本协议而不是二进制？首先，调试方便。你在手机串口助手上能直接看到发送和接收的字符，一目了然。其次，容错性相对好一点。即使收到个别乱码，也可以通过判断命令头（‘L’）来部分过滤错误指令。\r\n作为结束符是串口通信中的常见做法，方便上位机程序识别一条指令的结束。

在myRIO的FPGA程序中，我们需要编写一个串口接收状态机，不断累积字符直到检测到\r\n，然后对中间收到的字符串进行解析，根据解析结果去控制相应的LED布尔量。

3. 硬件连接与HC-05模块配置

3.1 物理连接步骤

首先确保myRIO和HC-05模块断电。找到myRIO上可供用户使用的3.3V电源引脚和地引脚（GND），以及一对数字I/O口（例如DIO0和DIO1）用作串口的RX和TX。连接步骤如下：

电源连接：将HC-05的VCC引脚连接到myRIO的+3.3V引脚，GND连接到myRIO的GND引脚。务必确认电压是3.3V，接5V可能会损坏模块。
串口交叉连接：这是最容易出错的地方。原则是设备的TX接对方的RX。
- 将myRIO的DIO0（配置为UART RX）连接到HC-05模块的TXD引脚。
- 将myRIO的DIO1（配置为UART TX）连接到HC-05模块的RXD引脚。
模式控制（可选，用于初次配置）：如果需要进入AT模式，将HC-05的KEY/EN引脚在模块上电前，通过杜邦线连接到3.3V。正常数据通信时，此引脚悬空或接地即可。

连接好后，先不要着急上电，仔细检查一遍线序，特别是电源正负极绝对不能反。

3.2 使用AT命令配置HC-05

如果你拿到的是全新模块，或者需要修改默认设置，就需要进行配置。你需要一个USB转TTL串口工具（如CH340、CP2102模块）来完成。

进入AT模式：将USB转TTL的3.3V、GND、RX、TX分别与HC-05的VCC、GND、TX、RX连接（注意这里是直连，不是交叉）。将HC-05的KEY引脚接高电平（3.3V）。先给USB转TTL上电，此时HC-05指示灯慢闪（约2秒一次），表示进入AT命令模式。
使用串口助手：在电脑上打开串口调试助手（如AccessPort、SSCOM），选择正确的COM口，设置波特率为38400（HC-05 AT模式常见波特率，也有可能是9600，可尝试），数据位8，停止位1，无校验。
发送测试命令：在发送框输入AT（注意是英文大写），后面加上回车换行（通常串口助手有“发送新行”选项），点击发送。如果模块正常，会返回OK。
关键配置命令：
- AT+NAME=MyRIO_LED：设置蓝牙设备名为“MyRIO_LED”，方便手机搜索。
- AT+PSWD=1234：设置配对密码为“1234”。
- AT+UART=115200,0,0：设置串口波特率为115200，停止位1，无校验（参数含义可能因固件版本略有差异，115200,0,0是常见组合）。
- AT+ROLE=0：设置模块为从机角色（Slave）。
- AT+RESET：重启模块使新设置生效（执行后模块会退出AT模式）。

配置完成后，断开KEY引脚的高电平连接，重新上电，模块会进入数据模式，指示灯快闪（约1秒2次），等待手机连接。

注意：不同批次或供应商的HC-05模块，其AT命令波特率、默认密码可能不同。如果AT无响应，请尝试将串口助手的波特率依次改为9600、19200、38400、57600、115200进行测试。命令必须大写，且以\r\n结尾。

4. LabVIEW FPGA程序设计与实现

4.1 创建FPGA项目与配置I/O

首先在LabVIEW中创建一个新的FPGA项目，并添加你的myRIO-1900设备作为目标。在项目浏览器中，右键点击myRIO设备下的“FPGA Target”，选择“New VI”来创建主FPGA VI。

我们需要配置两个关键的I/O项：

LEDs：在FPGA I/O上找到“LED0”至“LED3”（具体名称请查阅myRIO手册）。将它们拖拽到FPGA VI的前面板上，会自动创建布尔控件。这些将作为我们的输出。
串口UART：myRIO的FPGA支持通过数字I/O线实现软件定义的UART。我们需要两路数字I/O线。假设我们使用DIO0和DIO1。
- 在项目浏览器中，右键点击“FPGA Target” -> “New” -> “I/O Item”。
- 创建一个“Digital Input”命名为“UART_RX”，分配给它DIO0。
- 创建一个“Digital Output”命名为“UART_TX”，分配给它DIO1。
- 将这两个I/O项也拖拽到FPGA VI的前面板上。

4.2 实现串口接收状态机（核心）

这是FPGA程序中最核心的部分。我们需要编写一个能稳定接收字节、组装字符串并解析指令的状态机。LabVIEW FPGA适合用“单循环定时结构”来实现。

初始化：在While循环外，设置串口参数：波特率（115200）、数据位（8）、停止位（1）、无校验。创建一个移位寄存器来存储接收到的字节数组，另一个来存储当前状态（如：空闲、接收中、解析中）。
字节接收：在循环内，使用“FPGA Interface -> Serial -> Unflatten From UART”函数。将“UART_RX”连线到其data输入端，并配置好波特率等参数。该函数会返回一个布尔值new data表示是否收到新字节，以及收到的data字节。
状态机逻辑：
- 空闲态：等待new data为真。收到字节后，判断是否为命令头（如‘L’）。如果是，进入“接收态”，并将该字节存入数组；如果不是，丢弃。
- 接收态：继续接收后续字节，并依次存入数组。同时检查是否收到结束符\r\n。一旦收到\n（在\r之后），则认为一条指令接收完成，转入“解析态”。
- 解析态：对累积的字节数组进行解析。例如，检查数组长度，提取LED编号字符（‘1’， ‘2’…）和动作字符串（“ON”， “OFF”， “T”）。根据解析结果，生成对应的LED控制信号（例如，一个包含4个布尔元素的簇）。解析完成后，清空接收数组，状态跳回“空闲态”。
控制LED：将解析态输出的LED控制信号簇，通过“索引数组”或“按名称解除捆绑”函数拆分开，分别连接到前面板上“LED0”至“LED3”布尔控件的接线端。注意，这里需要“写入”操作。

实操心得：FPGA循环的周期设置很重要。周期必须小于一个字节的传输时间。对于115200波特率，1个字节（10位，含起始停止位）时间约为87微秒。将循环周期设置为50微秒或更短是安全的。过长的周期可能导致漏掉字节。

4.3 编译与下载到FPGA

程序编写完成后，右键点击FPGA VI，选择“Compile”。首次编译FPGA代码可能需要较长时间（10-30分钟）。编译成功后，再右键选择“Run”。此时，FPGA程序就开始在myRIO的芯片上独立运行了，即使你关闭电脑上的LabVIEW开发环境，只要myRIO不断电，这个控制逻辑就会一直工作。

5. 手机端控制与交互实现

5.1 选择合适的串口调试APP

在手机应用商店搜索“Serial Bluetooth Terminal”，可以找到很多同类型应用，如“Serial Bluetooth Terminal”、“蓝牙串口”等。选择一个评价好、界面简洁的即可。这些APP的核心功能是搜索并配对蓝牙设备，然后提供一个可发送和接收文本的串口界面。

5.2 连接与指令发送

打开手机蓝牙设置，搜索设备，应该能找到名为“MyRIO_LED”（或你之前配置的名称）的设备，点击配对，输入密码“1234”。
打开串口调试APP，在APP内选择连接“MyRIO_LED”。连接成功后，APP界面通常会显示“Connected”，并且HC-05模块上的指示灯会变为双秒快闪（连接态）。
在APP的发送区域，输入我们定义的指令，例如L0ON，然后点击发送。注意，很多APP默认不会自动发送回车换行，你需要勾选“Send with CR+LF”或类似的选项，或者在指令末尾手动添加\r\n。
观察myRIO板上的LED0是否被点亮。随后可以尝试L0OFF、L1ON等指令。

5.3 简易控制界面进阶

如果觉得每次输入文本命令太麻烦，一些高级的串口调试APP支持“按钮”或“宏”功能。你可以预先定义好几个按钮：

按钮1：发送文本L0ON\r\n
按钮2：发送文本L0OFF\r\n
按钮3：发送文本L1ON\r\n…… 这样，你就可以得到一个简单的手机遥控界面，一键控制指定LED。这已经是一个完整的无线控制原型了。

6. 系统调试与故障排查实录

在实际搭建过程中，你几乎一定会遇到各种问题。下面是我踩过的一些坑和解决方法，整理成了速查表。

现象	可能原因	排查步骤与解决方案
HC-05指示灯不亮	电源未接通或接反；模块损坏。	1. 用万用表测量VCC和GND之间电压是否为3.3V。 2. 检查连线是否牢固，电源正负极是否接反。 3. 尝试更换一个HC-05模块。
手机搜不到蓝牙设备	HC-05未进入配对模式；模块处于AT模式；名称设置太普通被忽略。	1. 确认HC-05指示灯是否在快闪（数据模式，可配对）。慢闪是AT模式。 2. 重启HC-05模块（重新上电）。 3. 用AT命令检查并修改一个独特的设备名。
手机连接后立即断开	波特率不匹配；串口线连接错误。	1.重点检查：确保myRIO FPGA程序中的波特率与HC-05配置的波特率完全一致（如都是115200）。 2. 检查myRIO的TX是否接HC-05的RX，RX接TX（交叉连接）。
发送指令后LED无反应	指令格式错误；FPGA程序未运行；LED I/O项映射错误。	1. 在手机APP中确认发送的指令包含`\r\n`。 2. 在LabVIEW中确认FPGA VI已编译并下载运行（Run箭头为绿色）。 3. 在FPGA VI前面板添加一个字符串显示控件，将接收到的原始字节显示出来，看是否与发送的一致。 4. 检查FPGA程序中控制LED的布尔变量，是否与物理LED正确映射（例如LED0控制的是否是板子上标0的灯）。
LED状态混乱或不受控	FPGA程序解析逻辑有bug；多条指令粘包。	1. 利用FPGA的调试功能，将解析出的LED编号和动作字符串显示出来，看是否正确。 2. 在状态机中，确保每次完整解析一条指令后，彻底清空接收缓冲区数组。 3. 手机发送指令时，不要过快连发，给FPGA留出处理时间。
通信距离短或不稳定	蓝牙信号被遮挡；电源干扰。	1. 确保HC-05天线区域（通常是小陶瓷天线）没有被金属物体完全包裹或遮挡。 2. 尝试用手机靠近模块测试，排除距离问题。 3. 检查myRIO的3.3V电源输出是否稳定，可在电源引脚并联一个10uF~100uF的电容滤波。

独家避坑技巧：

分阶段调试：不要试图一次性完成所有代码。首先写一个最简单的FPGA VI，让一个LED以1Hz频率闪烁，确认你能编译和运行FPGA基础程序。然后，再添加串口接收代码，但先不解析，只把收到的每一个字节回显（通过UART_TX发回手机），确认通信链路是通的。最后，才加上完整的指令解析逻辑。这种“步步为营”的方法能极大降低调试难度。
利用LabVIEW FPGA的调试工具：在FPGA VI运行时，你可以右键点击前面板的控件，选择“数据操作->当前值”，然后“导出”，将运行时的数据快照保存下来分析。这对于调试状态机非常有用。
电源隔离：如果发现蓝牙连接后，myRIO有复位或异常现象，可能是HC-05工作时产生的电流尖峰干扰了myRIO的电源。在HC-05的VCC和GND引脚之间，焊接一个100uF的电解电容并并联一个0.1uF的瓷片电容，能有效平滑电源，提高系统稳定性。这是我实测中解决许多灵异问题最有效的一招。