新手也能懂！用沁恒CH579的TMOS实现第一个蓝牙外设（附完整代码）-平芜编程栈

从零开始：用沁恒CH579打造你的第一个蓝牙LED控制器

第一次接触嵌入式开发的新手们，常常会被各种专业术语和复杂框架吓退。但今天，我要带你用沁恒CH579开发板和它的TMOS系统，完成一个实实在在的蓝牙控制LED项目——不需要深厚的编程基础，只要跟着步骤走，两小时内就能看到成果。

1. 开发环境准备与基础概念

在动手之前，我们需要先理解几个核心概念。TMOS（Task Management Operating System）是沁恒为CH579系列芯片设计的一个轻量级任务管理系统，它让开发者可以像搭积木一样组织代码。想象一下，你的蓝牙接收、LED控制、数据处理等不同功能，都可以被拆解成独立的小任务，由TMOS来协调运行。

1.1 硬件与软件准备

你需要准备以下物品：

沁恒CH579开发板（带蓝牙功能）
一台安装了Keil MDK的Windows电脑
一根Micro USB数据线
一个LED灯和220欧姆电阻（开发板通常已内置）

软件方面，确保你已经：

从沁恒官网下载了CH579的SDK包
安装了CH57x系列的Keil设备支持包
准备好了串口调试工具（如SSCOM或Putty）

提示：初次使用CH579时，建议先运行官方提供的Blinky例程，确认开发环境配置正确。

1.2 TMOS的三大核心要素

理解这三个概念，就掌握了TMOS的钥匙：

TaskID- 相当于任务的身份证，每个独立功能都需要一个唯一ID
EventID- 具体事件的编号，比如"收到蓝牙数据"可以是一个事件
事件处理函数- 当特定事件发生时，执行的实际代码

用一个生活场景类比：假设TaskID是"厨房"，EventID可以是"煮咖啡"或"烤面包"，而事件处理函数就是具体制作这些食物的步骤。

2. 从官方例程到自定义项目

官方SDK中的peripheral例程已经实现了基本的蓝牙外设功能，我们将以此为起点进行改造。

2.1 创建自定义Task

打开peripheral.c文件，在文件顶部全局变量区域添加：

#define TEST_TASK_ID 1 // 通常0被系统占用，我们从1开始 uint8_t testTaskID; // 用于存储系统分配的实际任务ID

然后在peripheral.h中定义我们的事件类型：

#define TEST_LED_TOGGLE_EVT 0x0001 // 用16位掩码定义事件

2.2 编写事件处理函数

在peripheral.c中添加以下函数：

static void Test_ProcessEvent(uint8 task_id, uint16 event) { if(event & TEST_LED_TOGGLE_EVT) { GPIOB_SetBits(GPIO_Pin_4); // 点亮LED tmos_start_task(testTaskID, TEST_LED_TOGGLE_EVT, 500); // 500ms后再次触发 GPIOB_ResetBits(GPIO_Pin_4); // 熄灭LED } }

这段代码实现了一个简单的LED闪烁效果，每次事件触发时，LED会快速亮灭一次，然后设置500ms后再次触发。

2.3 任务初始化

在同一个文件中找到初始化函数区域，添加：

void Test_Init(void) { testTaskID = TMOS_ProcessEventRegister(Test_ProcessEvent); tmos_start_task(testTaskID, TEST_LED_TOGGLE_EVT, 1000); // 1秒后首次触发 }

然后在main()函数中的适当位置调用Test_Init()。

3. 添加蓝牙控制功能

现在LED已经能自动闪烁了，接下来让我们通过蓝牙来控制它。

3.1 修改蓝牙特征值

在peripheral.c中找到蓝牙特征值定义部分，添加一个新的特征值用于LED控制：

static uint8_t ledControlChar = 0; // 0关，1开

然后在属性表(attribute table)中添加相应的特征值声明。

3.2 处理蓝牙数据

修改蓝牙事件处理函数，添加对LED控制特征值的处理：

case HANDLE_VALUE_WRITE: if(attr_handle == ledControlHandle) { ledControlChar = pEvt->para; if(ledControlChar) { tmos_start_task(testTaskID, TEST_LED_TOGGLE_EVT, 0); } else { tmos_stop_task(testTaskID, TEST_LED_TOGGLE_EVT); GPIOB_ResetBits(GPIO_Pin_4); // 确保LED关闭 } } break;

3.3 测试蓝牙控制

编译并下载程序到开发板后，你可以使用任何BLE调试APP（如nRF Connect）来：

扫描并连接到你的CH579设备
找到LED控制特征值
写入1开启LED闪烁，写入0停止闪烁

4. 优化与调试技巧

项目基本功能已经实现，但还有提升空间。

4.1 添加状态反馈

让蓝牙特征值不仅能接收命令，还能反映当前LED状态：

static void updateLedStatus(void) { attWriteHandle(ledStatusHandle, &ledControlChar, 1); }

在适当的地方调用此函数，比如在蓝牙连接建立时和LED状态改变时。

4.2 低功耗优化

CH579的一大优势是低功耗，我们可以让系统在空闲时进入睡眠：

void TMOS_SystemProcess(void) { if(!tmos_events_active()) { CH57X_LowPower(); // 进入低功耗模式 } // ...其他处理... }

4.3 常见问题排查

遇到问题时，可以检查以下几点：

问题现象	可能原因	解决方法
无法连接蓝牙	设备未广播	检查广播初始化代码
LED不响应	GPIO配置错误	确认引脚号和初始化
系统卡死	任务事件处理不当	检查事件处理函数逻辑

5. 扩展思路与项目进化

基础功能实现后，你可以考虑以下扩展方向：

5.1 多LED控制

通过定义更多的事件类型和Task，可以独立控制多个LED：

#define TEST_LED1_EVT 0x0001 #define TEST_LED2_EVT 0x0002 // 更多事件定义... static void Test_ProcessEvent(uint8 task_id, uint16 event) { if(event & TEST_LED1_EVT) { // LED1控制代码 } if(event & TEST_LED2_EVT) { // LED2控制代码 } }

5.2 模式切换

添加不同的闪烁模式，比如呼吸灯效果：

void setBreathingMode(void) { static uint16_t delay = 10; GPIOB_SetBits(GPIO_Pin_4); tmos_start_task(testTaskID, TEST_LED_BREATH_EVT, delay); delay = (delay >= 500) ? 10 : delay + 10; }