i2c-address-dataset

A curated, datasheet-checked dataset of i2c addresses, operating voltages and connector-ecosystem data for 50 of the most common sensors and breakout boards — as plain JSON and CSV, free to use in your own tools, libraries and scanners.

Maintained as the machine-readable companion to i2c.net, the structured reference for the i2c bus.

---

Why this exists

Every maker eventually hits the same wall: a bus scan prints 0x76 and you have no idea what's answering, two boards fight over 0x68, or a datasheet quotes 0xEC when your scanner says 0x76. The data to resolve all of that is scattered across dozens of datasheets and vendor pages.

This repo collects it in one structured, verified place — the same dataset that powers the address tables and wiring pages on i2c.net — so you can drop it straight into code instead of re-scraping datasheets.

Every address and voltage here was checked against the manufacturer's own datasheet (linked per part), including the clone/variant traps that bite people: the QMC5883L that ships as an "HMC5883L", the PCF8574A at 0x38–0x3F, the BMP280 sold as a BME280.

What's in the box

Schema

Each board record:

{
  "part": "BME280",
  "chip": "Bosch BME280",
  "category": "Environmental",
  "type": "sensor",
  "i2c_addresses": ["0x76", "0x77"],
  "address_selectable": true,
  "voltage_min": 3.3,
  "voltage_max": 5,
  "connector_standards": ["qwiic", "stemma-qt"],
  "datasheet": "https://www.bosch-sensortec.com/products/environmental-sensors/humidity-sensors-bme280/",
  "reference": "https://i2c.net/boards/bme280/"
}

Addresses are the 7-bit form (0x08–0x77) — what i2cdetect and the Arduino Wire library use. If a datasheet