C++标准库不提供I2C原生支持，因其属物理层协议，需操作寄存器、GPIO、时钟等硬件资源，必须依赖HAL库（如STM32 HAL）或Linux的/dev/i2c-*设备节点+ioctl实现。
直接说结论：C++ 本身不提供 I2C 原生支持，必须依赖底层驱动或硬件抽象层（HAL）封装的 API；在裸机/嵌入式场景下用 C++ 调用 HAL 库（如 STM32 HAL、Zephyr、Arduino API）是主流做法，Linux 用户空间则走 /dev/i2c- 设备节点 + ioctl。
为什么不能直接用 C++ 标准库操作 I2C
C++ 标准库（STL）不涉及硬件外设访问。I2C 是物理层协议，需要操作 GPIO、时钟、DMA、寄存器等，这些由操作系统内核或 MCU 厂商 HAL 提供接口。试图绕过驱动直接 bit-bang（模拟时序）虽可行，但极难保证时序精度，且与平台强耦合。
- 标准模式（100kHz）要求 SCL 高/低电平各 ≥4.7μs，快速模式（400kHz）则 ≤1.3μs —— 普通 C++ 循环很难稳定满足
- 中断响应延迟、编译器优化、CPU 负载都会导致时序漂移，ACK/NACK 采样失败率陡增
- 多数现代 MCU（如 STM32、ESP32、nRF52）已集成硬件 I2C 外设，弃之不用等于自废武功
Linux 用户空间：用 i2c-dev 和 ioctl
在树莓派、Jetson 或通用 Linux 嵌入式板上，I2C 总线被映射为 /dev/i2c-0、/dev/i2c-1 等设备节点。C++ 程序需打开设备、设置从机地址、调用 ioctl 发起读写。
- 必须用
open()打开设备节点，权限需为可读写（常需sudo或加入i2c用户组） - 关键 ioctl 命令：
I2C_SLAVE设置目标地址，I2C_RDWR执行组合读写（避免手动发 START/STOP） - 数据结构用
i2c_msg封装单次传输，i2c_rdwr_ioctl_data封装多条消息（如先写寄存器地址再读数据） - 示例片段（省略错误检查）：
int fd = open("/dev/i2c-1", O_RDWR);
ioctl(fd, I2C_SLAVE, 0x48); // 设置从机地址 0x48（如 TMP102 温度传感器）
uint8_t reg_addr = 0x00;
uint8_t buf[2];
struct i2c_msg msgs[2] = {
{ .addr = 0x48, .flags = 0, .len = 1, .buf = ®_addr }, // 写寄存器地址
{ .addr = 0x48, .flags = I2C_M_RD, .len = 2, .buf = buf } // 读 2 字节
};
struct i2c_rdwr_ioctl_data data = { .msgs = msgs, .nmsgs = 2 };
ioctl(fd, I2C_RDWR, &data);
嵌入式裸机或 RTOS：调用厂商 HAL 库（以 STM32 HAL 为例）
STM32CubeMX 生成的 HAL 库提供 C 接口，C++ 可直接调用（注意 extern "C" 链接规则）。关键函数是 HAL_I2C_Master_Transmit 和 HAL_I2C_Master_Receive，它们自动处理 START/STOP/ACK/时钟延时。
立即学习“C++免费学习笔记（深入）”；
- 务必先调用
HAL_I2C_Init()，否则外设处于复位状态，所有传输返回HAL_ERROR - 地址参数是 7 位格式（如芯片手册写 0x48，就传 0x48，不是 0x90）；HAL 自动左移 + R/W 位
- 超时参数（单位 ms）不能设为 0，否则立即返回超时；建议 ≥10ms，尤其对 EEPROM 等慢速器件
- 若需重复启动（RESTART），HAL 不直接支持，得用
HAL_I2C_Master_Sequential_Transmit_IT+ 回调组合实现
容易忽略的硬件和配置坑
90% 的 I2C 通信失败跟软件逻辑无关，而是硬件或初始化配置埋的雷：
- 上拉电阻缺失或阻值错：标准模式用 4.7kΩ，快速模式必须 ≤2.2kΩ；没上拉，SDA/SCL 永远拉不起来，示波器看全是低电平
- SCL/SDA 引脚复用功能未使能：比如 STM32 的 PB6/PB7 要同时开启 GPIOB 时钟和 I2C1 时钟，缺一不可
- 从机地址匹配失败：查芯片手册确认是 7 位还是 10 位地址；有些模块（如某些 OLED）默认地址是 0x3C，但焊接跳线后变 0x3D
- 总线被锁死：某设备异常拉低 SDA 持续超过 9 个 SCL 周期，主机会认为总线 busy；解决方法是发送 9 个时钟脉冲强制释放（HAL 有
HAL_I2C_ClearBusyFlag）
真正麻烦的从来不是“怎么写代码”，而是“为什么信号线上看不到 START”——先抓波形，再查手册，最后碰代码。
