1. 为什么选择RT-Thread来驱动BH1750？聊聊我的真实感受

很多刚接触STM32的朋友，一听到要驱动传感器，尤其是像BH1750这种需要IIC通信的，第一反应可能就是去网上找“裸机”代码。我以前也是这么干的，从正点原子的例程开始，一点点啃IIC的时序，写起始信号、停止信号、应答信号，一个字节一个字节地读写。说实话，这个过程很锻炼人，能让你把IIC协议吃得透透的。但后来项目多了，我发现一个问题：每次换一个传感器，哪怕同样是IIC接口，我都得重新去研究它的数据手册，写一堆底层的读写函数，调试起来也挺费时间。

直到我开始用RT-Thread，我才发现原来驱动一个传感器可以这么“省心”。这感觉就像以前出门总要自己规划路线、买票、找酒店，现在直接用个“一站式”旅行App，把目的地告诉它，剩下的行程、住宿它都帮你安排好了。RT-Thread的软件包和驱动框架就是这个“一站式”工具。对于BH1750，社区里已经有前辈写好了成熟的软件包，我们只需要在配置界面里点几下，然后在应用层写几行“人话”（比如“初始化传感器”、“读取光照值”），就能把数据拿到手。操作系统帮我们管理了底层的硬件资源（比如IIC总线）和任务调度（比如定时采集），我们只需要关注业务逻辑就行。

我这次要分享的，就是基于RT-Thread来驱动BH1750的“极简”方法。说它极简，是因为整个过程你几乎不用碰底层硬件寄存器，也不用自己从头写IIC驱动。我们更像是在搭积木，利用RT-Thread生态里现成的模块，快速拼装出一个能稳定工作的应用。这对于需要快速验证想法、搭建原型，或者不想在底层驱动上耗费太多精力的开发者来说，效率提升不是一点半点。当然，这并不意味着我们不需要懂原理，只是RT-Thread把那些繁琐、重复的工作给抽象和封装了，让我们能站在更高的层面去解决问题。

2. 动手之前：搭建你的RT-Thread开发环境

工欲善其事，必先利其器。用RT-Thread开发，你需要准备两样核心工具：Keil MDK（或者你喜欢的其他IDE，如IAR、RT-Thread Studio）和 RT-Thread Env工具。

Keil大家应该很熟悉了，我们写代码、编译、下载调试都靠它。我用的版本是5.24以上，确保对AC6编译器支持良好。重点是Env工具，你可以把它理解为RT-Thread的“瑞士军刀”或者“管家”。它是一个命令行工具，但我们主要用它里面的menuconfig图形化配置界面。通过这个界面，我们可以像逛超市一样，选择我们需要的内核功能、设备驱动、软件包，然后它自动帮我们生成工程、解决依赖、下载代码，非常方便。

搭建环境的步骤网上教程很多，我就不再赘述了。核心就几步：安装好Env，把它所在目录添加到系统环境变量。然后在你的项目根目录下打开命令行，输入 menuconfig，就能看到那个蓝底黄字的配置界面了。第一次用可能会觉得选项很多，别怕，我们这次只关注几个关键点。如果你手头有块STM32F103的开发板（比如正点原子的战舰、精英板，或者野火的指南者），那跟着做会非常顺利，因为RT-Thread对F1系列的支持非常完善。

提示：如果你对搭建RT-Thread环境还不太熟悉，强烈建议先花点时间看看官方文档或者一些入门教程。把Env用熟了，后续添加任何组件、软件包都会事半功倍。这就像学做饭前，先得知道怎么开火、怎么用锅。

3. 创建工程与获取BH1750软件包

有了环境，我们就要创建一个属于自己项目的“工作间”了。RT-Thread针对不同的芯片型号，提供了丰富的BSP（板级支持包）。BSP里包含了该芯片的启动文件、外设驱动、引脚定义等，相当于RT-Thread为这块开发板准备好的“基础装修”。

对于STM32F103，我们可以使用 stm32f103-atk-nano 或者 stm32f103-blue-pill 这类常见的BSP。创建工程的方法很简单：在Env命令行中，进入你打算存放项目的目录，使用 scons --dist 命令生成一个工程模板，或者更直接地，从RT-Thread GitHub仓库里找到对应的BSP目录，把它复制出来作为你的工程基础。

工程创建好后，重头戏来了——获取BH1750软件包。在项目根目录打开Env，输入 menuconfig 进入配置界面。通过键盘方向键导航，找到这个路径：RT-Thread online packages -> peripheral libraries and drivers -> sensors drivers。在这里，你应该能看到 bh1750 这个软件包。选中它，按回车进入。

这里你会看到一个版本选择菜单。通常会有 latest（最新版）、v2.0.0、v1.0.0等。这几种版本有什么区别呢？根据我实际使用的经验，v1.0.0 是一个比较纯粹、独立的驱动包，它只提供了BH1750设备的基本操作接口，比如初始化、读取光照值。它的用法和你自己写的裸机驱动函数很像，直接调用即可，非常直观。

而 v2.0.0 和 latest 版本，则集成了RT-Thread的 Sensor驱动框架。这个框架是一个中间层，它定义了一套标准的传感器操作接口（打开、关闭、读取、控制等）。不同厂家的、不同类型的传感器（如光照、温湿度、加速度计）只要按照这个框架实现驱动，那么在上层应用看来，它们的操作方式就是统一的。这对于项目里需要管理多个传感器时特别有用，应用层代码可以写得非常通用。但对于我们初学者，或者只是想快速用上BH1750来说，v1.0.0 版本更简单直接，不容易被框架的概念绕晕。所以，我建议新手先选择 v1.0.0 版本。

选好版本后，保存退出。Env会自动下载这个软件包到你的工程目录下的 packages 文件夹里。你会发现多了一个 bh1750-v1.0.0 的文件夹，里面就是驱动源码 bh1750.c 和头文件 bh1750.h。我们的“积木”已经到手了。

4. 配置IIC硬件：告诉系统你的传感器接在哪

软件包有了，接下来要告诉RT-Thread，我们的BH1750传感器通过哪组IIC接口连接到STM32。这是整个过程中非常关键的一步，但操作起来却异常简单。

再次打开 menuconfig，这次我们找硬件驱动的配置路径：Hardware Drivers Config -> On-chip Peripheral Drivers -> Enable I2C Bus。你会看到 I2C1 BUS、I2C2 BUS 等选项。根据你的硬件连接，选择启用对应的IIC总线。比如，你的BH1750模块的SCL和SDA线接到了STM32的PB6和PB7，那么这两根引脚通常对应着I2C1，你就启用 I2C1 BUS。

启用后，下面会出现配置引脚号的选项。这里有个很大的便利：RT-Thread的IIC驱动支持引脚重映射。也就是说，你不需要非得使用芯片手册上标注的“默认IIC引脚”。只要是一个普通的GPIO，并且硬件上允许（没有其他功能冲突），你都可以指定它为IIC的SCL和SDA。这给了我们布线极大的灵活性。比如，我手头这块板子的PB6、PB7可能被其他功能占用了，我完全可以把BH1750接到PA8和PA9上，只要在这里把SCL和SDA的引脚号分别配置为 8 和 9（对应PA8和PA9）即可。

配置完成后，保存退出。Env会根据你的配置，自动生成相应的底层驱动初始化代码。你完全不用去关心IIC的GPIO初始化、时钟使能这些底层细节。这就是操作系统的魅力——它提供了统一的硬件抽象层，我们只需做声明式的配置。

注意：这里配置的IIC总线名称（比如 i2c1）非常重要，它相当于给这个IIC硬件通道起了一个“名字”。我们后续在应用代码里，就是通过这个名字来找到并使用这个IIC设备的。所以一定要记清楚你启用的是 i2c1 还是 i2c2。

5. 编写应用层代码：让传感器工作起来

环境、工程、驱动、硬件接口都准备好了，现在终于到了最激动人心的环节——写代码让传感器跑起来。得益于RT-Thread的软件包，我们的应用层代码会非常简洁。

首先，在你的主文件（通常是 main.c 或者 applications 文件夹下的某个源文件）里，包含必要的头文件。除了RT-Thread的标准头文件，最关键的就是 #include “bh1750.h”。

接下来，我们需要做两件事：初始化BH1750设备和创建一个线程来周期性地读取数据。为什么用线程？这是RT-Thread编程的一个好习惯。把传感器的数据采集任务放在一个独立的线程里，它就可以按照自己的节奏（比如每500毫秒）去读取数据，而不会阻塞主线程或其他任务（比如处理用户输入、刷新显示等）。整个系统的响应会更加流畅。

初始化设备非常简单，只需要一行代码：bh1750_device_t dev = bh1750_init(“i2c1”);。这里的 “i2c1” 字符串，必须和上一步在 menuconfig 里配置的IIC总线名称完全一致。这个函数会返回一个设备句柄 dev，后续所有的操作都要基于这个句柄。

然后，在一个循环里，我们可以调用 bh1750_read_light(dev) 来读取光照值。这个函数返回一个浮点数，单位是勒克斯（lx）。读取之后，你可以通过串口打印出来，或者通过OLED屏幕显示，甚至可以通过网络发送到云端。为了演示，我们就用RT-Thread内置的 rt_kprintf 函数打印到串口终端。

下面我结合一个完整的、带注释的代码示例，把整个过程串起来讲。我会创建一个独立的线程来处理BH1750，同时主线程里让一个LED灯闪烁，这样你能直观地看到多任务在同时运行。

#include <rtthread.h>
#include <rtdevice.h>
#include <board.h>
#include "bh1750.h" // 引入BH1750软件包的头文件

/* 定义LED引脚，根据你的实际板子修改 */
#define LED_PIN    GET_PIN(C, 13) // 假设LED接在PC13，经典蓝色LED位置

/* 定义BH1750所使用的IIC设备名称，必须与menuconfig中配置的完全一致 */
#define BH1750_IIC_BUS_NAME    "i2c1"

/* 全局变量，用于存储光照传感器设备句柄和光照值 */
static bh1750_device_t bh1750_dev = RT_NULL;
static float light_lux = 0.0f;

/* BH1750数据采集线程的入口函数 */
static void bh1750_thread_entry(void *parameter)
{
    /* 初始化BH1750传感器，传入IIC总线名称 */
    bh1750_dev = bh1750_init(BH1750_IIC_BUS_NAME);
    
    /* 检查设备是否初始化成功 */
    if (bh1750_dev == RT_NULL)
    {
        rt_kprintf("BH1750 device initialize failed!n");
        return; // 初始化失败，线程退出
    }
    rt_kprintf("BH1750 device initialize success!n");
    
    /* 线程主循环 */
    while (1)
    {
        /* 读取光照强度，单位：勒克斯 (Lux) */
        light_lux = bh1750_read_light(bh1750_dev);
        
        /* 通过串口1打印光照值。
         * 注意：rt_kprintf默认输出到串口1（控制台）。
         * %.2f 表示以浮点数格式输出，保留两位小数。
         */
        rt_kprintf("[BH1750] Light intensity: %.2f lxn", light_lux);
        
        /* 线程睡眠500毫秒，即每0.5秒采集一次数据。
         * 使用 rt_thread_mdelay 而不是普通的 delay，这样不会阻塞整个系统。
         */
        rt_thread_mdelay(500);
    }
}

/* 标准的主函数 */
int main(void)
{
    rt_thread_t tid; // 线程控制块句柄
    
    /* 初始化LED引脚为推挽输出模式 */
    rt_pin_mode(LED_PIN, PIN_MODE_OUTPUT);
    
    /* 创建BH1750数据采集线程。
     * 参数依次为：线程名、入口函数、入口参数、栈大小、优先级、时间片。
     * 栈大小1024字节对于这个简单任务足够了。
     * 优先级设为25（数字越小优先级越高），时间片设为10个系统Tick。
     */
    tid = rt_thread_create("bh1750_th",
                            bh1750_thread_entry,
                            RT_NULL,
                            1024,
                            25,
                            10);
    
    /* 判断线程是否创建成功 */
    if (tid != RT_NULL)
    {
        /* 启动线程，使其进入就绪状态，由调度器安排运行 */
        rt_thread_startup(tid);
        rt_kprintf("BH1750 thread startup success!n");
    }
    else
    {
        rt_kprintf("Create BH1750 thread failed!n");
    }
    
    /* 主线程循环：让LED以1Hz频率闪烁 */
    while (1)
    {
        rt_pin_write(LED_PIN, PIN_HIGH); // LED亮
        rt_thread_mdelay(500);           // 延时500ms
        rt_pin_write(LED_PIN, PIN_LOW);  // LED灭
        rt_thread_mdelay(500);           // 延时500ms
    }
    
    /* 通常不会运行到这里 */
    return 0;
}

这段代码的结构非常清晰。main 函数负责硬件初始化和创建线程。bh1750_thread_entry 函数是线程的主体，它初始化传感器后，就在一个死循环里不断地读取并打印光照数据。rt_thread_mdelay(500) 是关键，它让出了CPU的使用权，在这500毫秒里，操作系统可以去执行其他就绪的线程（比如主线程的LED闪烁）。这就是协作式调度的魅力，虽然我们写了死循环，但系统不会卡死。

把代码编译下载到板子上，打开串口调试助手（波特率通常为115200），你应该能看到类似 [BH1750] Light intensity: 256.34 lx 的信息周期性输出。用手遮住传感器，数值会变小；用手机手电筒照它，数值会急剧变大。恭喜你，你的BH1750已经在RT-Thread上欢快地跑起来了！

6. 进阶玩法与深度优化

上面的例子展示了最基础的用法。但在实际项目中，我们可能需要更可靠、更高效、功能更丰富的实现。这里我分享几个进阶的实战经验。

首先，关于错误处理。 上面的示例代码对 bh1750_init 的返回值做了判断，这很好。但在实际环境中，IIC通信可能因为线缆松动、电源不稳等原因偶尔失败。bh1750_read_light 函数内部也可能出错。一个健壮的程序应该能处理这些异常。我们可以修改读取数据的部分，加入重试机制：

int retry_count = 0;
float light_lux = 0.0f;

while (retry_count < 3) // 最多重试3次
{
    light_lux = bh1750_read_light(bh1750_dev);
    if (light_lux >= 0) // 假设读取成功返回非负值，失败返回负数
    {
        break; // 读取成功，跳出重试循环
    }
    rt_thread_mdelay(10); // 短暂延时后重试
    retry_count++;
}
if (retry_count == 3)
{
    rt_kprintf("Read BH1750 failed after 3 retries!n");
    // 这里可以执行更严格的错误恢复，比如重新初始化设备
}
else
{
    rt_kprintf("Light: %.2f lxn", light_lux);
}

其次，关于测量模式。 BH1750支持多种测量模式，比如连续高分辨率模式（代码中默认）、连续低分辨率模式、单次测量模式等。不同模式在精度和功耗上有所权衡。软件包的 bh1750.h 头文件里通常定义了这些模式的命令字。虽然 bh1750_read_light 函数内部可能已经设置了默认模式，但如果你需要更精细的控制（比如为了省电，使用单次测量，读一次就让传感器休眠），你可能需要深入研究驱动源码，或者选择使用 v2.0.0 版本的软件包，它通过Sensor框架可能提供了模式选择的接口。

再者，关于数据的使用。 我们读取到的光照值，除了打印，更应该被其他任务使用。这就涉及到RT-Thread的另一个核心机制——线程间通信。例如，我们可以创建一个“灯光控制线程”，它需要根据光照值来调节LED的亮度（PWM）。那么，BH1750线程在读取到数据后，就不应该直接打印，而是通过一个消息队列、邮箱或者信号量，将数据发送给灯光控制线程。这样，数据采集和业务逻辑就彻底解耦了，系统架构更清晰，也更容易维护和扩展。

最后，关于软件包的选择。 如果你打算在项目中接入多个传感器，我强烈建议你尝试 v2.0.0 或 latest 版本，即基于Sensor框架的版本。它的初始化代码可能稍微复杂一点，需要先注册传感器设备到框架，然后再从框架里打开设备。但之后，你读取任何传感器（光照、温度、湿度）的代码都会是类似的 sensor_read 这样的统一接口。这对于构建复杂的物联网传感节点非常有价值。

7. 调试技巧与常见问题排查

即使按照步骤一步步来，第一次也难免会遇到问题。这里我总结几个我踩过的“坑”和解决办法。

问题一：编译通过，但串口没有任何输出。

• 检查串口连接和配置： 确保USB转串口线连接正确，电脑上的串口调试助手波特率设置为115200（RT-Thread Console默认波特率）。
• 检查FinSH控制台： 在 menuconfig 中，确保 RT-Thread Kernel -> Kernel Device Object 和 RT-Thread Components -> Command shell 是开启的，并且 RT-Thread Components -> Device Drivers -> Using serial frame drivers 以及下面的 Using UART1 drivers（或你使用的串口）是启用的。这样 rt_kprintf 的输出才能正确重定向到串口。
• 检查线程是否创建成功： 在主函数里，在 rt_thread_startup 之后加一句 rt_kprintf(“Main thread is running…n”);，看看主线程本身能否打印。如果不能，可能是串口驱动根本没起来。

问题二：串口有输出，但打印的是“BH1750 device initialize failed!”或者读取的值一直是0。

• 检查IIC总线名称： 这是最常见的问题！确保代码中的 BH1750_IIC_BUS_NAME 字符串（如 “i2c1”）与 menuconfig 里配置的IIC总线名称一字不差。大小写也要一致。
• 检查硬件连接： 用万用表测量BH1750模块的VCC和GND，确保供电正常（通常是3.3V）。检查SCL和SDA线是否接反、是否虚焊。BH1750模块的ADDR引脚电平决定了它的IIC地址，通常接GND地址是0x23，接VCC是0x5C，确保你的接法与软件包中定义的地址一致。
• 检查上拉电阻： IIC总线需要上拉电阻（通常4.7kΩ到10kΩ）到VCC。有些模块板载了，有些没有。如果你的模块没有，必须在SCL和SDA线上各加一个上拉电阻到3.3V，否则通信无法进行。
• 用逻辑分析仪抓取波形： 这是终极调试手段。将逻辑分析仪的通道连接到SCL和SDA，看看单片机是否有起始信号发出，地址是否正确，传感器是否有应答。通过波形可以非常直观地定位是软件配置问题还是硬件问题。

问题三：读取的数据波动很大，或者明显不准。

• 检查电源噪声： 传感器对电源质量比较敏感。尝试在VCC和GND之间并联一个10uF和0.1uF的电容，进行滤波。
• 检查测量模式： 确认你使用的测量模式是否适合当前环境光照。在极暗环境下，高分辨率模式可能更合适。
• 检查传感器窗口： 确保传感器感光窗口没有被遮挡或污染。

调试是一个需要耐心和逻辑的过程。遵循“先软后硬，先通后优”的原则。先确保软件配置、代码逻辑无误，再排查硬件连接、电源、信号完整性等问题。充分利用RT-Thread提供的 list_device、list_thread、list_sem 等FinSH命令，可以实时查看系统状态，对调试有巨大帮助。

8. 从项目到产品：更多的可能性

当你成功驱动了BH1750，这只是一个起点。RT-Thread的强大生态能让这个小项目迅速扩展成一个真正可用的产品原型。

数据上云： 你可以很容易地集成RT-Thread的 AT组件 和 网络框架，通过ESP8266、4G Cat.1等模组，将光照数据上传到阿里云、腾讯云或者你自己的服务器。软件包里都有现成的连接MQTT、HTTP的示例，你只需要填上你的设备证书和服务器地址。

本地显示与交互： 结合RT-Thread的 U8G2 软件包（用于OLED）或者 LVGL 软件包（用于更华丽的图形界面），你可以将光照值实时显示在屏幕上。再配合按键软件包，就能做出一个可以设置光照阈值、进行报警的智能光照检测仪。

联动控制： 这是智能家居的核心。你可以再写一个线程，监听光照值。当光照低于某个阈值时，自动控制一个GPIO引脚输出高电平，来打开一盏LED灯；当光照过强时，又可以控制一个舵机来关闭百叶窗。所有的逻辑都可以在RT-Thread这个统一的操作系统内，用多个线程和IPC机制优雅地实现。

低功耗优化： 对于电池供电的设备，功耗至关重要。BH1750本身有低功耗模式。你可以结合RT-Thread的电源管理框架，在不需要采集数据时，将传感器设置为休眠模式，甚至将MCU本身也进入睡眠模式，定时唤醒进行采集。RT-Thread提供了完善的休眠唤醒机制，可以大幅延长设备续航。

我自己的一个智能花盆项目就用了这套组合拳：STM32 + RT-Thread + BH1750 + 土壤湿度传感器 + 水泵继电器。系统每隔10分钟采集一次光照和湿度，通过Wi-Fi上传数据到手机App。当光照不足或土壤太干时，App会推送通知，我也可以远程手动控制补光灯和水泵。整个系统的代码结构清晰，各个功能模块互不干扰，维护和添加新功能都非常方便。而这，正是RT-Thread这类实时操作系统带给开发者的最大价值——它让你从繁琐的底层协调工作中解放出来，更专注于产品功能和用户体验本身。