当前位置：首页 > news >正文

从点亮LED到驱动外设：手把手教你用RT-Thread玩转星火一号开发板

news 2026/5/2 12:11:26

从点亮LED到驱动外设：手把手教你用RT-Thread玩转星火一号开发板

第一次拿到星火一号开发板时，面对密密麻麻的芯片引脚和陌生的RT-Thread环境，不少开发者会感到无从下手。本文将带你从最基础的LED控制开始，逐步深入SPI Flash读写、串口通信等核心功能，用实际项目串联起RT-Thread的开发全流程。

1. 开发环境搭建与第一个LED程序

星火一号开发板搭载的STM32F407ZGT6芯片拥有168MHz主频和丰富外设资源，但要让这颗"心脏"跳动起来，首先需要配置好开发环境。不同于裸机开发，RT-Thread作为实时操作系统，提供了更高效的资源管理方式。

必备工具清单：

MDK Keil 5.30+（或IAR 8.50+）
ST-Link/V2调试器
RT-Thread ENV工具
PuTTY/Tera Term串口终端

安装完基础工具后，通过以下命令克隆BSP源码：

git clone https://github.com/RT-Thread/rt-thread.git cd rt-thread/bsp/stm32/stm32f407-rt-spark

打开工程后，在applications/main.c中添加LED控制代码：

#include <rtthread.h> #include <rtdevice.h> #define LED_PIN GET_PIN(F, 11) void led_thread_entry(void *parameter) { rt_pin_mode(LED_PIN, PIN_MODE_OUTPUT); while(1) { rt_pin_write(LED_PIN, PIN_HIGH); rt_thread_mdelay(500); rt_pin_write(LED_PIN, PIN_LOW); rt_thread_mdelay(500); } } int main(void) { rt_thread_t tid = rt_thread_create("led", led_thread_entry, RT_NULL, 512, 20, 10); if(tid != RT_NULL) rt_thread_startup(tid); return RT_EOK; }

提示：RT-Thread的PIN驱动框架统一了不同芯片的GPIO操作接口，GET_PIN(F,11)对应PF11引脚（板载绿色LED）

2. 深入RT-Thread驱动框架

2.1 设备驱动模型解析

RT-Thread采用经典的UNIX设备驱动模型，所有外设都被抽象为rt_device结构体。通过以下代码可以查看当前已注册设备：

#include <rtdevice.h> void list_devices(void) { struct rt_device *dev = RT_NULL; rt_ubase_t index = 0; rt_kprintf("--- Registered Devices ---\n"); while ((dev = rt_device_find_by_index(index++)) != RT_NULL) { rt_kprintf("%-16s %s\n", dev->parent.name, dev->flag & RT_DEVICE_FLAG_ACTIVATED ? "ACTIVE" : "INACTIVE"); } } MSH_CMD_EXPORT(list_devices, List all registered devices);

2.2 SPI Flash驱动实战

星火一号板载W25Q128（16MB SPI Flash），通过以下步骤实现读写操作：

在ENV工具中启用SPI驱动：

menuconfig → Hardware Drivers Config → On-chip Peripheral Drivers → Enable SPI1

添加Flash设备初始化代码：

#include <drv_spi.h> #include <spi_flash.h> static int spi_flash_init(void) { __HAL_RCC_GPIOB_CLK_ENABLE(); struct rt_spi_device *spi_dev; rt_hw_spi_device_attach("spi1", "spi10", GPIOB, GPIO_PIN_14); spi_dev = (struct rt_spi_device *)rt_device_find("spi10"); struct rt_spi_configuration cfg; cfg.data_width = 8; cfg.mode = RT_SPI_MODE_0 | RT_SPI_MSB; cfg.max_hz = 30 * 1000 * 1000; rt_spi_configure(spi_dev, &cfg); return RT_EOK; } INIT_DEVICE_EXPORT(spi_flash_init);

使用SFUD组件操作Flash：

void test_flash(void) { struct rt_spi_device *spi_dev = rt_device_find("spi10"); struct rt_spi_flash_device *flash = rt_sfud_flash_probe("W25Q128", "spi10"); /* 读写测试 */ rt_uint8_t buf[256], rbuf[256]; rt_memset(buf, 0x55, sizeof(buf)); rt_spi_flash_write(flash, 0, buf, sizeof(buf)); rt_spi_flash_read(flash, 0, rbuf, sizeof(rbuf)); if(rt_memcmp(buf, rbuf, sizeof(buf)) == 0) { rt_kprintf("SPI Flash test success!\n"); } } MSH_CMD_EXPORT(test_flash, Test W25Q128 operations);

3. 多线程与IPC实战

3.1 创建管理多个线程

RT-Thread的线程调度器支持优先级抢占，下面示例创建三个不同优先级的线程：

static rt_thread_t tid1, tid2, tid3; static void thread1_entry(void *param) { while(1) { rt_kprintf("[Thread1] priority 8 running\n"); rt_thread_mdelay(1000); } } static void thread2_entry(void *param) { while(1) { rt_kprintf("[Thread2] priority 10 running\n"); rt_thread_mdelay(1500); } } void thread_sample(void) { tid1 = rt_thread_create("thread1", thread1_entry, RT_NULL, 1024, 8, 10); tid2 = rt_thread_create("thread2", thread2_entry, RT_NULL, 1024, 10, 10); rt_thread_startup(tid1); rt_thread_startup(tid2); }

3.2 使用消息队列通信

线程间通信是RTOS的核心功能，以下示例展示消息队列的使用：

#include <rtthread.h> #define MSG_QUEUE_SIZE 10 static struct rt_messagequeue mq; static rt_uint8_t msg_pool[MSG_QUEUE_SIZE * sizeof(rt_uint32_t)]; static void sender_thread_entry(void *param) { rt_uint32_t count = 0; while(1) { if(rt_mq_send(&mq, &count, sizeof(count)) == RT_EOK) { rt_kprintf("[Sender] send message: %d\n", count++); } rt_thread_mdelay(500); } } static void receiver_thread_entry(void *param) { rt_uint32_t rx_data; while(1) { if(rt_mq_recv(&mq, &rx_data, sizeof(rx_data), RT_WAITING_FOREVER) == RT_EOK) { rt_kprintf("[Receiver] got message: %d\n", rx_data); } } } int ipc_sample(void) { rt_mq_init(&mq, "msgq", msg_pool, sizeof(rt_uint32_t), sizeof(msg_pool), RT_IPC_FLAG_FIFO); rt_thread_t sender = rt_thread_create("sender", sender_thread_entry, RT_NULL, 512, 15, 10); rt_thread_t receiver = rt_thread_create("receiver", receiver_thread_entry, RT_NULL, 512, 15, 10); rt_thread_startup(sender); rt_thread_startup(receiver); return RT_EOK; } MSH_CMD_EXPORT(ipc_sample, Message queue sample);

4. 外设进阶开发技巧

4.1 ADC采样与数据处理

星火一号开发板提供了多个ADC通道，以下代码实现周期采样与滤波：

#include <rtdevice.h> #define ADC_DEV_NAME "adc1" #define ADC_CHANNEL 5 static void adc_thread_entry(void *param) { rt_adc_device_t adc_dev = (rt_adc_device_t)rt_device_find(ADC_DEV_NAME); rt_adc_enable(adc_dev, ADC_CHANNEL); float avg = 0; rt_uint32_t samples[10]; while(1) { /* 采集10次取平均 */ for(int i=0; i<10; i++) { samples[i] = rt_adc_read(adc_dev, ADC_CHANNEL); rt_thread_mdelay(10); } /* 移动平均滤波 */ avg = 0; for(int i=0; i<10; i++) avg += samples[i]; avg /= 10; rt_kprintf("ADC value: %.2f\n", avg * 3.3 / 4096); rt_thread_mdelay(1000); } } int adc_sample(void) { rt_thread_t tid = rt_thread_create("adc", adc_thread_entry, RT_NULL, 512, 20, 10); if(tid) rt_thread_startup(tid); return RT_EOK; }

4.2 硬件定时器精确定时

对于需要精确时间控制的场景，可以使用STM32的硬件定时器：

#include <rtdevice.h> static rt_device_t hwtimer_dev; static rt_err_t timeout_cb(rt_device_t dev, rt_size_t size) { rt_kprintf("Hardware timer timeout!\n"); return RT_EOK; } int timer_sample(void) { hwtimer_dev = rt_device_find("timer2"); rt_device_set_rx_indicate(hwtimer_dev, timeout_cb); rt_device_control(hwtimer_dev, HWTIMER_CTRL_FREQ_SET, (void *)1000000); rt_hwtimer_mode_t mode = HWTIMER_MODE_PERIOD; rt_device_control(hwtimer_dev, HWTIMER_CTRL_MODE_SET, &mode); rt_hwtimerval_t timeout_s = {.sec=1, .usec=0}; rt_device_write(hwtimer_dev, 0, &timeout_s, sizeof(timeout_s)); return RT_EOK; }

5. 调试与性能优化

5.1 使用ulog组件

RT-Thread的ulog组件提供分级日志功能，在rtconfig.h中配置：

#define ULOG_USING_SYSLOG #define ULOG_OUTPUT_LVL_D #define ULOG_OUTPUT_TIME #define ULOG_OUTPUT_LEVEL #define ULOG_OUTPUT_THREAD_NAME

在代码中使用不同级别日志：

#include <ulog.h> void log_demo(void) { LOG_D("This is debug message"); LOG_I("System running time: %d", rt_tick_get()); LOG_W("Low memory warning!"); LOG_E("I2C communication failed"); }

5.2 内存使用分析

通过以下命令查看系统资源占用：

msh >free total memory: 192048 used memory: 65432 maximum allocated memory: 72320 msh >list_thread thread pri status sp stack size max used left tick error ------ --- ------ -- ---------- -------- --------- --- led 20 running 0x00000060 0x00000200 28% 0x0000000a 000 tshell 10 suspend 0x00000080 0x00001000 15% 0x00000014 000

在项目开发中，遇到SPI通信不稳定时，通过逻辑分析仪抓取波形发现时钟极性配置错误。修改RT_SPI_MODE_0为RT_SPI_MODE_3后问题解决，这种实战经验往往比文档更有价值。

查看全文

http://www.jsqmd.com/news/737916/