void i2c_start(void) {
    SDA_HIGH();
    SCL_HIGH();
    delay_us(5);
    SDA_LOW();     // SCL 高时 SDA 拉低 = START
    delay_us(5);
    SCL_LOW();
}

void i2c_stop(void) {
    SDA_LOW();
    SCL_HIGH();
    delay_us(5);
    SDA_HIGH();    // SCL 高时 SDA 拉高 = STOP
    delay_us(5);
}

START | 7bit地址+R/W | ACK | 8bit寄存器地址 | ACK | 8bit数据 | ACK | STOP

void i2c_write_reg(uint8_t dev_addr, uint8_t reg, uint8_t data) {
    i2c_start();
    i2c_send_byte(dev_addr << 1);     // 7位地址 + W=0
    i2c_wait_ack();
    i2c_send_byte(reg);               // 寄存器地址
    i2c_wait_ack();
    i2c_send_byte(data);              // 数据
    i2c_wait_ack();
    i2c_stop();
}

START | 7bit地址+W | ACK | 寄存器地址 | ACK | REPEAT START | 7bit地址+R | ACK | 数据 | NACK | STOP

uint8_t i2c_read_reg(uint8_t dev_addr, uint8_t reg) {
    uint8_t data;
    
    // 先写寄存器地址
    i2c_start();
    i2c_send_byte(dev_addr << 1);      // W=0
    i2c_wait_ack();
    i2c_send_byte(reg);
    i2c_wait_ack();
    
    // 再读数据
    i2c_start();                       // Repeat Start
    i2c_send_byte((dev_addr << 1) | 1); // R=1
    i2c_wait_ack();
    data = i2c_read_byte();
    i2c_send_nack();                   // 主机回 NACK 结束
    i2c_stop();
    
    return data;
}

Rp = (Vcc - V_OL) / I_OL
典型值: 4.7kΩ (标准模式) / 2.2kΩ (快速模式)

void spi_init(SPI_Mode mode) {
    SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;
    SPI_InitStructure.SPI_Mode = SPI_Mode_Master;
    SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b;
    SPI_InitStructure.SPI_CPOL = (mode >> 1) & 0x01;   // 时钟极性
    SPI_InitStructure.SPI_CPHA = mode & 0x01;           // 时钟相位
    SPI_InitStructure.SPI_NSS = SPI_NSS_Soft;           // 软件 CS
    SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_256;
    SPI_Init(SPI1, &SPI_InitStructure);
    SPI_Cmd(SPI1, ENABLE);
}

uint8_t spi_transfer(uint8_t tx_data) {
    while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) == RESET);
    SPI_I2S_SendData(SPI1, tx_data);
    while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_RXNE) == RESET);
    return SPI_I2S_ReceiveData(SPI1);
}

void spi_write_reg(uint8_t reg, uint8_t data) {
    CS_LOW();
    spi_transfer(reg);      // 寄存器地址
    spi_transfer(data);     // 数据
    CS_HIGH();
}

STM32          BH1750
PB6 (SCL)  ─── SCL ──┬── 4.7kΩ ── VCC(3.3V)
PB7 (SDA)  ─── SDA ──┤
                     ├── ADDR ── GND  (地址 = 0x23)
                     └── VCC / GND

#define BH1750_ADDR   0x23    // ADDR 接地
#define BH1750_CMD    0x10    // 连续高分辨率模式

float bh1750_read_lux(void) {
    uint8_t data[2];
    
    // 发送测量指令
    i2c_start();
    i2c_send_byte(BH1750_ADDR << 1);
    i2c_wait_ack();
    i2c_send_byte(BH1750_CMD);
    i2c_wait_ack();
    i2c_stop();
    
    // 等待测量完成（手册：max 180ms）
    HAL_Delay(180);
    
    // 读取结果
    i2c_start();
    i2c_send_byte((BH1750_ADDR << 1) | 1);  // 读
    i2c_wait_ack();
    data[0] = i2c_read_byte();
    i2c_send_ack();
    data[1] = i2c_read_byte();
    i2c_send_nack();
    i2c_stop();
    
    uint16_t raw = (data[0] << 8) | data[1];
    return raw / 1.2f;  // 手册公式: Lux = raw / 1.2
}

#define MPU6050_ADDR   0x68
#define WHO_AM_I_REG   0x75
#define ACCEL_XOUT_H   0x3B

// 验证器件
uint8_t mpu6050_check(void) {
    return i2c_read_reg(MPU6050_ADDR, WHO_AM_I_REG);
    // 手册: 正常返回 0x68
}

手册时序图:
CS   ─┐                              ┌───
       └──────────────────────────────┘
SCK  ──┐  ┌┐  ┌┐  ┌┐  ┌┐  ┌┐  ┌┐  ┌┐  ...
        └──┘└──┘└──┘└──┘└──┘└──┘└──┘
DIN  ──X Start X SGL X D2 X D1 X D0 X──
DOUT ──X─────X─────X─────X─────X  B9 X B8 ...

uint16_t mcp3008_read(uint8_t channel) {
    uint8_t cmd = 0x80 | ((channel & 0x07) << 4);
    // Start=1, SGL=1, D2/D1/D0 = channel
    
    CS_LOW();
    spi_transfer(0x01);   // 起始位
    uint8_t high = spi_transfer(cmd) & 0x03;
    uint8_t low  = spi_transfer(0x00);
    CS_HIGH();
    
    return ((uint16_t)high << 8) | low;  // 10-bit 结果
}

1. □ 通信接口类型？（I2C / SPI / UART / 单总线）
   → 看目录找 "Interface" / "Communication" / "Bus"

2. □ I2C 器件地址是多少？有 ADDR 引脚可配置吗？
   → 搜 "Slave Address" / "Device Address"

3. □ SPI 用哪种模式（CPOL/CPHA）？
   → 看时序图，空闲时 SCK 电平 + 第几个沿采样

4. □ 最大时钟频率？
   → 搜 "Max Clock" / "SCL Frequency" / "Timing"

5. □ 寄存器地址和读写位怎么排？
   → 找 "Register Map" / "Register Description"

6. □ 数据格式？（大端/小端，符号位，精度）
   → 看寄存器描述 "MSB first" / "2's complement"

7. □ 是否需要上拉电阻？阻值多大？
   → 看典型应用电路 "Typical Application Circuit"

8. □ 上电后需要等待多久？初始化序列？
   → 搜 "Power-up" / "Start-up time" / "Initialization"

选 I2C 当：
  ✓ GPIO 引脚紧张（只占 2 根）
  ✓ 一个总线上挂多个传感器
  ✓ 速率要求不高（< 1MHz）
  ✓ PCB 走线较长
  ✓ 需要芯片可热插拔

选 SPI 当：
  ✓ 需要高速传输（> 1MHz）
  ✓ 全双工通信（同时收发）
  ✓ 响应要确定（无地址协商开销）
  ✓ 数据流连续（SD卡、LCD屏）
  ✓ 不需要多主架构