i2c-address-dataset
收藏资源简介：
一个经过整理和验证的数据集，包含50种常见传感器和扩展板的I2C地址、工作电压和连接器生态系统数据，以JSON和CSV格式提供，可用于工具、库和扫描器。该数据集作为i2c.net的结构化参考，所有地址和电压均根据制造商数据表验证。
A curated and validated dataset containing I2C addresses, operating voltages, and connector ecosystem data for 50 common sensors and expansion boards. It is provided in both JSON and CSV formats, and can be utilized for tools, libraries and scanners. This dataset serves as a structured reference for i2c.net, with all addresses and voltages verified against manufacturer datasheets.
数据集概述
该数据集是一个经过数据手册核验的 I²C 地址、工作电压和连接器生态系统的结构化集合，涵盖 50 种最常见的传感器和分线板。数据以 JSON 和 CSV 格式提供，旨在直接集成到工具、库和扫描代码中。
数据内容与结构
数据集包含以下核心文件：
i2c-addresses.json：完整数据集，每条记录包含分线板的地址、电压范围、连接器标准和数据手册链接。i2c-address-index.json：反向查找索引，将 I²C 地址映射到所有使用该地址的部件。i2c-addresses.csv：与 JSON 对应的平面 CSV 文件，适用于电子表格。connector-standards.json：包含 Qwiic、STEMMA QT、Grove、Gravity、Breakout Garden 和 STEMMA 连接器的引脚定义、间距和逻辑电平。
数据记录模式
每条板卡记录包含以下字段：
| 字段 | 说明 |
|---|---|
part |
部件名称（如 "BME280"） |
chip |
芯片完整名称（如 "Bosch BME280"） |
category |
分类（如 "Environmental"） |
type |
类型（如 "sensor"） |
i2c_addresses |
I²C 地址列表（7 位形式，如 ["0x76", "0x77"]） |
address_selectable |
地址是否可选 |
voltage_min / voltage_max |
最小/最大工作电压（V） |
connector_standards |
支持的连接器标准列表 |
datasheet |
官方数据手册链接 |
reference |
i2c.net 上的参考页面链接 |
地址说明：数据集中所有地址均为 7 位形式（0x08–0x77），与 i2cdetect 和 Arduino Wire 库使用的格式一致。若数据手册显示的地址约为该值的两倍，则为 8 位形式，需右移一位。
数据来源与验证
- 每条记录的地址和电压均根据制造商官方数据手册进行核对，并提供数据手册链接。
- 特别标注了克隆/变体陷阱，例如标注为 "HMC5883L" 的 QMC5883L、地址为
0x38–0x3F的 PCF8574A、以及标注为 BME280 的 BMP280。
使用示例
JavaScript / Node： js import data from "./i2c-addresses.json" with { type: "json" }; const at0x68 = data.boards.filter(b => b.i2c_addresses.includes("0x68"));
Python： python import json boards = json.load(open("i2c-addresses.json"))["boards"] selectable = [b["part"] for b in boards if b["address_selectable"]]
反向查找： js import idx from "./i2c-address-index.json" with { type: "json" }; console.log(idx.addresses["0x3C"]); // ["SSD1306 OLED", "SH1106 OLED", "1.9inch Segment e-Paper"]
相关资源
- 完整 I²C 地址列表：人类可读版本，包含保留地址范围和 7 位/8 位地址解释。
- I²C 地址冲突解决方案：如何运行共享同一地址的两个设备。
- 连接器兼容性检查器：查询 Qwiic、STEMMA QT、Grove 等连接器之间的线缆和适配器。
- I²C 总线扫描器代码：Arduino、MicroPython 和 Raspberry Pi 的扫描代码。
许可证
采用 CC BY 4.0 许可证，允许自由使用、分享和改编（包括商业用途）。唯一要求是署名时链接到 i2c.net。
