1. GD32F303RGT6平台I²C总线驱动BH1750光照传感器工程实践

在嵌入式系统开发中，I²C（Inter-Integrated Circuit）总线因其硬件资源占用少、协议简洁、支持多主多从架构等优势，成为连接MCU与各类低速外设（如传感器、EEPROM、实时时钟等）的首选通信接口。本实践以GD32F303RGT6微控制器为核心，通过其硬件I²C外设驱动BH1750数字环境光传感器，完整呈现从协议原理理解、外设配置、寄存器操作到数据解析与应用控制的全链路工程实现。整个过程不依赖任何抽象库的“黑盒”封装，所有底层时序与状态机逻辑均基于GD32官方数据手册与参考手册进行严谨推导与验证。

1.1 硬件平台与传感器选型依据

本项目采用小熊派GD32开发板，其核心为兆易创新GD32F303RGT6芯片。该芯片基于ARM Cortex-M3内核，主频可达108MHz，集成丰富的模拟与数字外设。开发板上已预留标准I²C扩展接口，物理层直接引出至排针，极大简化了硬件连接。

所选用的BH1750环境光传感器由日本ROHM公司设计，是一款高精度、低功耗的数字光照强度检测芯片。其核心价值在于：
- 原生数字输出 ：内部集成16位ADC与信号调理电路，直接输出代表照度（单位：lux）的16位数字量，无需MCU进行额外的模拟信号处理或查表计算；
- 宽动态范围 ：可测量1–65535 lux的光照强度，典型分辨率达1 lux，在室内弱光至室外强光场景下均能提供有效数据；
- 标准I²C兼容 ：完全遵循I²C总线规范，支持标准模式（100 kbps）与快速模式（400 kbps），地址可配置，便于多传感器挂载；
- 低功耗与抗干扰 ：内置50/60 Hz电源纹波抑制电路，有效消除交流光源下的测量波动；待机电流低至0.01 µA，适合电池供电设备。

硬件连接关系明确且固定：
- I²C总线 ：开发板I²C1外设复用在GPIOB端口，具体为PB6（SCL，时钟线）与PB7（SDA，数据线）。此为GD32F303系列推荐的默认I²C1引脚组合，经芯片内部硬件逻辑优化，时序裕量充足。
- BH1750地址选择 ：BH1750支持两个7位I²C地址：0x23（ADDR引脚接地）与0x5C（ADDR引脚接VCC）。本开发板将ADDR引脚设计为接地，故其7位从机地址为0x23。在I²C通信中，写地址为 0x23 << 1 | 0 = 0x46 ，读地址为 0x23 << 1 | 1 = 0x47 。
- LED控制引脚 ：开发板上预留的LED指示灯（路灯）连接至PB9。该引脚配置为推挽输出模式，用于根据光照强度值实时控制LED的亮灭状态，构成一个直观的闭环反馈演示。

1.2 I²C协议核心机制深度解析

I²C协议的本质是两线制、半双工、同步串行通信。其设计哲学在于以最小的硬件开销换取最大的系统灵活性。理解其底层机制是规避通信故障、编写健壮驱动代码的前提。

1.2.1 物理层与电气特性

I²C总线仅需两条开漏（Open-Drain）信号线：SCL（Serial Clock）与SDA（Serial Data）。二者均需通过上拉电阻（通常为4.7kΩ）连接至VCC。这种设计强制规定了总线的“空闲”状态为高电平（逻辑1），而“有效”状态则由任意连接设备主动将线路拉低（逻辑0）来实现。开漏结构天然支持“线与”（Wired-AND）逻辑，这是多主竞争仲裁的基础。GD32的I²C外设内部集成了上拉控制与总线恢复电路，但在实际PCB布局中，仍需确保外部上拉电阻的阻值与总线电容匹配，以满足上升时间要求（标准模式下t _r ≤ 1000 ns）。

1.2.2 通信帧结构与时序关键点

一次完整的I²C数据传输由主机发起，包含起始条件（START）、地址帧、数据帧（可多个）、应答（ACK/NACK）及停止条件（STOP）。其时序严格受SCL时钟控制：

• 起始条件（START） ：当SCL为高电平时，SDA由高变低。这标志着一次通信的开始，所有从机必须监听后续地址。
• 停止条件（STOP） ：当SCL为高电平时，SDA由低变高。这标志着一次通信的结束，总线恢复空闲。
• 地址帧 ：主机发送的第一个字节，高7位为从机地址（0x23），最低位（Bit0）为读写方向位（R/W）。 0 表示写操作（主机向从机发送数据）， 1 表示读操作（主机从从机接收数据）。BH1750在收到匹配的地址后，会立即拉低SDA线发出ACK信号。
• 数据帧 ：每个字节为8位，MSB先行。每发送完一个字节，接收方必须在第9个时钟周期内拉低SDA以产生ACK，否则为主机视为NACK，通常意味着从机忙或地址错误。
• 重复起始（Repeated START） ：在不发送STOP的情况下，主机可再次发送START，用于切换读写方向（如先写寄存器地址，再读取数据），避免总线释放。

1.2.3 多主仲裁与冲突检测

I²C总线允许多个主机共存。当两个主机同时尝试启动通信时，它们会各自输出自己的SCL和SDA信号。由于SDA是开漏线，“线与”逻辑保证了只有所有主机都输出高电平时，总线才为高；任一主机输出低电平，总线即为低。仲裁过程发生在SDA线上：主机在发送每一位的同时，也监测总线电平。若主机输出为高，但监测到总线为低，则说明有其他主机正在发送低电平，该主机立即退出竞争，转为从机。此机制确保了数据完整性，无需额外的总线管理协议。

1.3 GD32F303RGT6 I²C外设硬件架构与寄存器映射

GD32F303系列MCU的I²C外设是一个高度集成的硬件模块，其设计目标是最大限度地卸载CPU负担，使其专注于应用逻辑而非底层时序。理解其寄存器结构是进行精确配置与状态监控的关键。

1.3.1 核心寄存器功能概览

GD32的I²C外设主要通过以下寄存器组进行控制与状态反馈：

• I²C_CR1（Control Register 1） ：主控寄存器。关键位包括 PE （Peripheral Enable，使能I²C外设）、 ACK （Enable Acknowledge，使能应答生成）、 STOP （Generate Stop condition）、 START （Generate Start condition）。
• I²C_CR2（Control Register 2） ：时钟控制寄存器。关键位为 FREQ[5:0] ，用于设置APB1总线频率（单位MHz），该值直接影响后续 CCR 与 TRISE 寄存器的计算。
• I²C_OAR1（Own Address Register 1） ：本机地址寄存器。当GD32作为I²C从机时使用，本项目中GD32始终作为主机，故此寄存器可忽略。
• I²C_CCR（Clock Control Register） ：时钟控制寄存器。核心字段 CCR[11:0] 决定了SCL的低电平与高电平时间，从而设定通信速率。其计算公式为：
• 标准模式（100 kbps）： CCR = F_APB1 / (2 * F_SCL)
• 快速模式（400 kbps）： CCR = F_APB1 / (3 * F_SCL) （需配合 DUTY=1 ）
• I²C_TRISE（TRISE Register） ：最大上升时间寄存器。 TRISE[5:0] 字段定义了SCL信号的最大允许上升时间（单位：I²C时钟周期），用于滤除高频噪声。其值通常设为 F_APB1(MHz) + 1 。
• I²C_SR1（Status Register 1） ：主状态寄存器1。包含大量关键状态位，如 SB （Start Bit generated）、 ADDR （Address sent/matched）、 BTF （Byte Transfer Finished）、 RXNE （Read Data Register Not Empty）、 TXE （Transmit Data Register Empty）、 ARLO （Arbitration Lost）、 AF （Acknowledge Failure）等。所有I²C操作都必须在此寄存器的状态位指导下进行。
• I²C_SR2（Status Register 2） ：主状态寄存器2。包含 MSL （Master/Slave）、 BUSY （Bus Busy）等辅助状态位。
• I²C_DR（Data Register） ：数据寄存器。所有发送与接收的数据均通过此寄存器进出。

1.3.2 时钟树配置与I²C时钟源

GD32F303RGT6的I²C1外设挂载在APB1总线上。在本项目中，系统主频为108MHz，APB1总线预分频系数为2，故APB1时钟频率为54MHz。此频率是计算 CCR 与 TRISE 寄存器值的唯一依据。任何对系统时钟的修改，都必须同步更新I²C的时钟配置参数，否则将导致通信速率严重偏离预期，引发超时或数据错乱。

1.4 BH1750传感器指令集与工作模式详解

BH1750并非简单的数据采集器件，其内部集成了一个微型状态机，通过一组精确定义的I²C指令进行控制。掌握其指令集是实现精准测量的核心。

1.4.1 指令集与寄存器映射

BH1750没有传统意义上的“寄存器地址”，其所有指令均通过向I²C总线发送一个字节的命令码（Command Code）来触发。该命令码直接写入I²C数据流，BH1750内部逻辑单元对其进行识别并执行相应动作。其核心指令如下：

指令码 (Hex)	指令名称	工作模式	测量时间	功耗状态	说明
0x10	Continuous H-Resolution Mode	连续高分辨率模式	~120 ms	活跃	输出16位数据，分辨率为1 lux，是默认推荐模式
0x11	Continuous H-Resolution Mode 2	连续高分辨率模式2	~120 ms	活跃	输出16位数据，分辨率为0.5 lux（数值翻倍）
0x13	Continuous L-Resolution Mode	连续低分辨率模式	~16 ms	活跃	输出16位数据，分辨率为4 lux，速度最快
0x20	One-Time H-Resolution Mode	单次高分辨率模式	~120 ms	自动进入待机	执行一次测量后自动进入低功耗状态，需再次发送指令唤醒
0x23	One-Time L-Resolution Mode	单次低分辨率模式	~16 ms	自动进入待机	执行一次测量后自动进入低功耗状态

1.4.2 数据读取与格式解析

BH1750在完成一次测量后，会将16位光照数据存储在其内部结果寄存器中。该数据为大端（Big-Endian）格式，即高字节（MSB）在前，低字节（LSB）在后。读取流程为：
1. 主机发送START条件；
2. 主机发送BH1750的7位地址（0x23）+ R/W位（1），即 0x47 ；
3. BH1750响应ACK；
4. 主机读取第一个字节（MSB）；
5. 主机发送ACK；
6. 主机读取第二个字节（LSB）；
7. 主机发送NACK（告知从机本次读取结束）；
8. 主机发送STOP条件。

最终得到的16位值即为光照强度（lux）。例如，读取到 0x0072 （十进制114），即表示当前光照强度为114 lux。值得注意的是， 0x11 指令模式下，内部ADC的增益被提升，因此相同光照下输出的数值是 0x10 模式的两倍，这并非误差，而是设计特性，为需要更高精度的应用提供了选项。

1.5 GD32 I²C主机驱动程序设计与实现

本节将摒弃HAL库的高层封装，直接操作GD32的I²C寄存器，构建一个轻量、高效、可移植的底层驱动。所有函数均围绕I²C状态寄存器（SR1）的状态位进行轮询，确保每一步操作的原子性与可靠性。

1.5.1 I²C外设初始化

初始化的核心是配置时钟、引脚、以及最关键的 CCR 与 TRISE 寄存器。以下是针对APB1=54MHz、目标速率为400kbps（快速模式）的初始化代码片段：

void I2C1_Init(void) {
    // 1. 使能GPIOB与I2C1时钟
    rcu_periph_clock_enable(RCU_GPIOB);
    rcu_periph_clock_enable(RCU_I2C1);

    // 2. 配置PB6(SCL)与PB7(SDA)为开漏复用输出
    gpio_init(GPIOB, GPIO_MODE_AF_OD, GPIO_OSPEED_50MHZ, GPIO_PIN_6 | GPIO_PIN_7);

    // 3. 配置I2C1时钟：APB1=54MHz -> FREQ=54
    I2C_CTL2(I2C1) = I2C_CTL2_FREQ(54);

    // 4. 计算CCR：快速模式，DUTY=1 -> CCR = F_APB1 / (3 * F_SCL) = 54000 / (3 * 400) = 45
    I2C_CKCFGR(I2C1) = I2C_CKCFGR_CKCL(45) | I2C_CKCFGR_DTCY;

    // 5. 设置TRISE：TRISE = F_APB1(MHz) + 1 = 54 + 1 = 55
    I2C_RT(I2C1) = I2C_RT_RISET(55);

    // 6. 使能I2C1外设
    I2C_CTL1(I2C1) = I2C_CTL1_I2CEN;
}

1.5.2 I²C主机发送函数（带状态轮询）

该函数负责向指定从机地址发送一个或多个字节的数据，并确保每一步都得到从机的正确响应。

ErrorStatus I2C1_MasterSend(uint8_t slave_addr, uint8_t *data, uint16_t len) {
    uint16_t i = 0;

    // 1. 等待总线空闲
    while (I2C_STAT1(I2C1) & I2C_STAT1_BUSY);

    // 2. 发送START条件
    I2C_CTL1(I2C1) |= I2C_CTL1_START;
    // 等待START位被清除（表示START已发出）
    while (!(I2C_STAT1(I2C1) & I2C_STAT1_SB));

    // 3. 发送从机地址（写模式）
    I2C_DATA(I2C1) = (slave_addr << 1) & 0xFE; // 地址左移，最低位置0
    // 等待地址发送完成（ADDR位被置位）
    while (!(I2C_STAT1(I2C1) & I2C_STAT1_ADDR));
    // 清除ADDR位（读取SR1后自动清除）
    (void)I2C_STAT1(I2C1);
    (void)I2C_STAT2(I2C1);

    // 4. 循环发送数据
    for (i = 0; i < len; i++) {
        // 等待TXE标志，表示数据寄存器为空
        while (!(I2C_STAT1(I2C1) & I2C_STAT1_TBE));
        I2C_DATA(I2C1) = data[i];

        // 等待BTF标志，表示字节传输完成
        while (!(I2C_STAT1(I2C1) & I2C_STAT1_BTF));
    }

    // 5. 发送STOP条件
    I2C_CTL1(I2C1) |= I2C_CTL1_STOP;

    return SUCCESS;
}

1.5.3 I²C主机接收函数（带状态轮询）

该函数负责从指定从机地址读取指定数量的字节。

ErrorStatus I2C1_MasterReceive(uint8_t slave_addr, uint8_t *data, uint16_t len) {
    uint16_t i = 0;

    // 1. 等待总线空闲
    while (I2C_STAT1(I2C1) & I2C_STAT1_BUSY);

    // 2. 发送START条件
    I2C_CTL1(I2C1) |= I2C_CTL1_START;
    while (!(I2C_STAT1(I2C1) & I2C_STAT1_SB));

    // 3. 发送从机地址（读模式）
    I2C_DATA(I2C1) = (slave_addr << 1) | 0x01; // 地址左移，最低位置1
    while (!(I2C_STAT1(I2C1) & I2C_STAT1_ADDR));
    (void)I2C_STAT1(I2C1);
    (void)I2C_STAT2(I2C1);

    // 4. 循环读取数据
    for (i = 0; i < len; i++) {
        // 等待RXNE标志，表示数据寄存器非空
        while (!(I2C_STAT1(I2C1) & I2C_STAT1_RBNE));

        if (i == (len - 1)) {
            // 最后一个字节：发送NACK并STOP
            I2C_CTL1(I2C1) &= ~I2C_CTL1_ACK;
            I2C_CTL1(I2C1) |= I2C_CTL1_STOP;
        }

        data[i] = I2C_DATA(I2C1);
    }

    // 重新使能ACK，为下一次通信做准备
    I2C_CTL1(I2C1) |= I2C_CTL1_ACK;

    return SUCCESS;
}

1.5.4 BH1750传感器驱动封装

基于上述底层函数，可以轻松封装BH1750的专用驱动：

#define BH1750_ADDR 0x23

// 初始化BH1750，进入连续高分辨率模式
void BH1750_Init(void) {
    uint8_t cmd = 0x10; // Continuous H-Resolution Mode
    I2C1_MasterSend(BH1750_ADDR, &cmd, 1);
}

// 读取16位光照数据
uint16_t BH1750_ReadLight(void) {
    uint8_t buff[2];
    uint16_t data = 0;

    // 延时180ms，确保BH1750完成一次测量
    delay_ms(180);

    // 读取2个字节
    I2C1_MasterReceive(BH1750_ADDR, buff, 2);

    // 合成16位数据：MSB << 8 | LSB
    data = ((uint16_t)buff[0] << 8) | buff[1];

    return data;
}

1.6 应用层逻辑与交互实验设计

驱动层的完备性最终要服务于具体的应用需求。本项目设计了两个层次的应用逻辑：基础数据读取与显示，以及基于阈值的智能控制。

1.6.1 LCD与串口数据可视化

开发板配备的LCD屏幕与USB转串口芯片为数据提供了双重可视化途径。主循环中， BH1750_ReadLight() 函数被周期性调用，其返回值被格式化为字符串，通过 printf 重定向至串口，并通过LCD驱动库绘制在屏幕上。这一过程不仅验证了I²C通信的正确性，更将抽象的数字信号转化为工程师可直观感知的物理量。

1.6.2 LED智能控制策略

这是一个典型的嵌入式闭环控制案例。其逻辑如下：
- 阈值设定 ：定义两个关键阈值： LIGHT_OFF_THRESHOLD = 50 （lux）， LIGHT_ON_THRESHOLD = 5000 （lux）。
- 状态机逻辑 ：
- 当读取到的光照值 < LIGHT_OFF_THRESHOLD ：认为环境极暗，点亮LED（PB9 = 0）。
- 当读取到的光照值 > LIGHT_ON_THRESHOLD ：认为环境过亮，熄灭LED（PB9 = 1）。
- 当读取到的光照值处于两者之间：保持LED当前状态（即“记忆”上次状态），避免在临界点频繁闪烁。
- 延时去抖 ：在每次状态切换后，插入一个 delay_ms(500) 的软件延时，有效滤除因手部遮挡等瞬态操作引入的噪声，使LED状态变化平滑、稳定。

此策略模拟了真实世界中的“智能照明”行为，其效果远超简单的开关控制，体现了嵌入式系统对物理环境的感知与响应能力。

1.7 调试技巧与常见问题排查

在I²C开发过程中，即使原理清晰，也常会遇到各种“玄学”问题。以下是我在多个GD32项目中总结的实战经验：

• 白屏与卡死 ：这是最典型的初始化失败现象。其根源几乎总是 I2C1_MasterSend() 函数在等待 SB （Start Bit）或 ADDR （Address Sent）状态位时陷入无限循环。首要检查项是 I2C_STAT1(I2C1) & I2C_STAT1_BUSY 是否永远为真，这表明总线被意外拉低（如上拉电阻缺失、SDA/SCL短路、BH1750芯片损坏）。使用万用表测量PB6/PB7对地电压，正常空闲时应为3.3V。
• 地址不响应（AF标志置位） ：当 I2C_STAT1(I2C1) & I2C_STAT1_AFS 为真时，说明从机未应答。除了确认BH1750的 ADDR 引脚电平外，更要检查 I2C_DATA(I2C1) 写入的地址是否正确。一个常见错误是将7位地址 0x23 直接写入，而忽略了I²C协议要求的地址左移操作。
• 数据错乱 ：读取到的数值随机跳变，通常是时序问题。首先确认 CCR 与 TRISE 寄存器的计算值是否与实际APB1频率严格匹配。其次，检查 delay_ms(180) 是否足够——BH1750在 0x10 模式下的典型转换时间为120ms，但留出60ms余量是必要的。
• 多传感器挂载 ：若需在同一总线上挂载多个BH1750，必须确保它们的 ADDR 引脚电平不同（一个接地，一个接VCC），从而获得 0x23 与 0x5C 两个独立地址。切勿尝试通过软件方式“软切换”地址，这在物理层上是不可能的。

2. GD32与STM32 I²C外设的工程化差异对比

作为国内主流的ARM Cortex-M3 MCU，GD32F303系列在引脚、外设与寄存器层面高度兼容STM32F103系列，这为开发者迁移提供了便利。然而，深入到驱动开发层面，二者在I²C等关键外设上存在若干不容忽视的工程化差异，这些差异直接影响代码的可移植性与调试效率。

2.1 状态机行为与轮询模型的差异

这是最核心、最易被忽略的差异点。在GD32的I²C参考手册中， SB （Start Bit Generated）与 ADDR （Address Sent/Matched）等状态位的置位与清除机制，与STM32F103存在微妙但关键的不同。

• GD32的“强轮询”特性 ：GD32的I²C状态寄存器（SR1）在事件发生后，其对应的状态位会持续保持置位，直到被显式读取（对于 ADDR ）或执行特定操作（如读取 SR1 后再读取 SR2 以清除 ADDR ）。这意味着，一个健壮的GD32 I²C驱动 必须 在每一个关键步骤后，通过轮询（Polling）的方式等待该状态位被置位，才能进行下一步。任何跳过轮询、依赖“大概率成功”的代码，在GD32上极易因时序偏差而卡死。
• STM32的“弱轮询”特性 ：相比之下，STM32F103的I²C状态机在某些版本的固件库中，对轮询的要求更为宽松。例如，部分示例代码可能在发送地址后，仅简单延时几个微秒便直接发送数据，这在STM32的硬件时序裕量下可能“碰巧”成功，但在GD32上则必然失败。这种差异源于两家公司在IP核设计时对“硬件友好性”与“软件可控性”的不同权衡。

这一差异直接导致了驱动代码风格的分化：GD32驱动倾向于“步步为营、稳扎稳打”的显式状态机；而STM32驱动（尤其基于旧版标准外设库）有时会显得更为“激进”。在进行跨平台移植时，首要任务就是将所有隐式的延时替换为显式的、基于 SR1 状态位的轮询。

2.2 中断与DMA支持的成熟度

虽然GD32与STM32的I²C外设在数据手册中都宣称支持中断与DMA，但在实际工程应用中，其成熟度与稳定性存在差距。

• GD32中断向量表 ：GD32的I²C中断向量（如 I2C1_EV_IRQn , I2C1_ER_IRQn ）与STM32完全一致，这使得中断服务函数（ISR）的框架可以无缝复用。然而，GD32的中断服务函数内部，对 SR1 与 SR2 寄存器的读取顺序与清除方式，必须严格遵循其参考手册的指导。一个常见的坑是，在GD32中，读取 SR1 后紧接着读取 SR2 是清除 ADDR 位的必要条件，而在STM32中，仅读取 SR1 即可。
• DMA集成 ：GD32的I²C与DMA的集成在早期版本中存在一些已知的Errata（勘误表），例如在特定条件下DMA传输最后一个字节时可能丢失。因此，在对实时性要求极高的量产项目中，我更倾向于在GD32平台上优先使用轮询模式，待其固件库与硬件版本迭代成熟后再启用DMA。而对于STM32，得益于其更长的市场验证周期，DMA方案已被广泛证明是稳定可靠的。

2.3 模拟I²C（Bit-Banging）的必要性与实现

当项目面临硬件资源紧张（如所有硬件I²C引脚已被占用）或需要极致的时序控制（如与非标准I²C器件通信）时，软件模拟I²C（Bit-Banging）成为一项必备技能。GD32与STM32在此方面并无本质区别，其核心思想是：用通用IO口（GPIO）精确模拟SCL与SDA的电平变化，手动“画出”I²C的时序波形。

实现一个可靠的模拟I²C，关键在于两点：
1. 精确的延时 ：必须使用 __NOP() 指令或基于SysTick的微秒级延时函数，确保 SCL 的高/低电平时间严格符合协议要求（标准模式下，t _LOW /t _HIGH ≥ 4.7 µs）。
2. SDA的双向控制 ：在模拟I²C中，SDA线需要在“输出”（主机发送）与“输入”（主机接收）两种模式间动态切换。这要求在发送数据时将GPIO配置为推挽输出，在接收数据前将其配置为浮空输入，并在读取后及时恢复。

一个经过充分测试的GD32模拟I²C驱动，其性能完全可以媲美硬件I²C，且最大的优势在于 引脚的完全自由 ——你可以将SCL与SDA任意分配到GPIOA、B、C、D的任意引脚上，彻底摆脱硬件外设的物理约束。这在原型设计与小批量定制项目中，具有不可估量的价值。

3. 性能优化与工程实践建议

一个合格的嵌入式驱动，不仅要“能用”，更要“好用”、“耐用”。以下是我基于多年GD32项目经验总结的几条关键实践建议。

3.1 降低CPU占用率的策略

在前述的轮询式I²C驱动中， while 循环会持续占用CPU，影响系统整体响应性。一个简单的优化是在轮询循环中加入 __WFI() （Wait For Interrupt）指令，让CPU在等待期间进入低功耗睡眠状态，待状态位就绪后由硬件自动唤醒。这不仅能降低系统功耗，还能将宝贵的CPU周期释放给其他高优先级任务。

3.2 错误处理的健壮性设计

工业级产品绝不允许一个I²C通信失败就导致整个系统崩溃。一个成熟的驱动必须包含完善的错误处理分支：
- 对于 AF （Acknowledge Failure），不应简单报错，而应尝试重新发送START，或执行一次总线恢复（Send 9个时钟脉冲）。
- 对于 ARLO （Arbitration Lost），应主动放弃本次通信，稍作延时后重试。
- 所有超时循环（如等待 SB ）都必须设置一个最大计数器，超时后强制退出并返回错误码，防止系统“假死”。

3.3 从“能跑通”到“可量产”的跨越

教学项目的目标是“跑通”，而工程项目的终极目标是“可量产”。这意味着代码必须经受住严苛的考验：
- 压力测试 ：在 main() 循环中，将 BH1750_ReadLight() 调用频率提高到极限（如每10ms一次），观察系统是否在长时间运行后出现内存泄漏或状态机紊乱。
- 环境鲁棒性 ：将开发板置于不同温度、湿度环境下，或人为制造电源电压波动（如用可调电源在3.0V–3.6V间切换），验证I²C通信的稳定性。
- EMC预兼容 ：在PCB设计阶段，就为I²C总线预留滤波电容（如100pF陶瓷电容）的位置，并确保SCL/SDA走线尽可能短、远离高速信号线，这是后期通过EMC认证的关键前置条件。

在小熊派开发板上完成这个BH1750实验后，我曾将其代码移植到一个真实的农业物联网节点中。那个节点需要同时挂载温湿度、CO₂、土壤水分等多个I²C传感器，并通过LoRa进行远距离数据上报。正是在这个过程中，我深刻体会到：一个在实验室里“完美”运行的I²C驱动，在复杂的电磁环境与多任务并发的压力下，其健壮性与可维护性，才是衡量其真正价值的唯一标尺。