i2c-net GitHub avatar

i2c-address-dataset

i2c-net

A datasheet-verified dataset of I2C addresses, voltages, and connector standards for 50 common sensors and breakout boards, available as JSON and CSV.

Stars

7

7-day growth

No data

Forks

0

Open issues

0

License

NOASSERTION

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a single, curated source for I2C device data that is directly verified against manufacturer datasheets, including a reverse lookup index and connector ecosystem info, saving makers from scattered datasheet hunting.

Who it is for

  • Makers and hobbyists building I2C-based projects
  • Embedded developers writing I2C scanner tools or libraries
  • IoT engineers integrating multiple sensors on a bus
  • Educators teaching I2C bus concepts

Use cases

  • Resolving which device is answering at a given I2C address
  • Checking for address conflicts before wiring multiple boards
  • Automatically configuring sensor libraries with correct addresses and voltages
  • Building a compatibility checker or wiring reference tool

Strengths

  • Every address and voltage is cross-checked against the manufacturer's datasheet
  • Includes reverse address index for quick lookup of all parts at a given address
  • Covers 50 of the most common sensors and breakout boards with clone/variant traps noted
  • Released under CC BY 4.0, free for commercial and non-commercial use

Considerations

  • Dataset limited to 50 parts; may not cover niche or very new sensors
  • Addresses are provided in 7-bit form only, which may cause confusion with 8-bit notation in some datasheets
  • Voltage and connector data are static; updates rely on community contributions or maintainer effort

README quick start

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

FileWhat it is
i2c-addresses.jsonThe full dataset — one record per board, with addresses, voltage range, connector standards, datasheet link
i2c-address-index.jsonReverse lookup: address → every part that uses it (the "what is at 0x68?" index)
i2c-addresses.csvThe same board data as a flat CSV for spreadsheets
connector-standards.jsonQwiic, STEMMA QT, Grove, Gravity, Breakout Garden, STEMMA — pinouts, pitch, logic level

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 (0x080x77) — what i2cdetect and the Arduino Wire library use. If a datasheet

Description

Curated, datasheet-checked i2c addresses, voltages and connector data for 50 common sensors and boards — JSON & CSV. Companion to i2c.net

Related repositories

Similar projects matched by category, topics, and programming language.

MoonshotAI
Featured
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI & Machine LearningAI Agents
3,348
xuchonglang
Featured
xuchonglang GitHub avatar

investing-for-beginners

A structured investing guide for Chinese beginners covering US stocks, options, and cryptocurrency, with focus on foundational concepts and risk awareness.

Blockchain & Web3
2,739
Krishnagangwal
Featured
Krishnagangwal GitHub avatar

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

Data & DatabasesDatabases & Storage
2,326