i2c – I²C transactions

Performs I²C transactions — read, write and scan the bus for devices — directly from the shell.

View as Markdown (for AI/KB)

Description

The i2c command performs I2C bus transactions including reading, writing, and scanning for devices. It provides low-level I2C communication capabilities.

Syntax

i2c --channel <channel_name> [options]

Required Options

Option Short Description
--channel -c I2C channel name to use for the transaction

Optional Options

Option Short Description
--address -a 7-bit I2C device address (prefix with 0x for hex)
--write -w Perform write operation
--read -r Perform read operation
--scan -s Scan I2C bus for devices
--length -l Number of bytes to read (default: 1)
--data -d Data bytes to send (space-separated)

Examples

i2c --channel "I2C_BUS_1" --scan
i2c -c "I2C_BUS_1" -a 0x50 -w -d 0x00
i2c -c "I2C_BUS_1" -a 0x50 -w -d 0x00 0xFF 0xAA 0x55
i2c -c "I2C_BUS_1" -a 0x50 -r -l 16
i2c -c "I2C_BUS_1" -a 0x50 -w -r -l 4 -d 0x00

Operation Types

Operation Flags Description
Scan --scan Detect all devices on bus
Send --write Write data only
Receive --read Read data only
SendReceive --write --read Write then read (restart)

Output Format

Sent: 0x00 0xFF
Received: 0x12 0x34 0x56 0x78
Transaction took 3.45 ms

Address & Data Format

Addresses may be hex (0x50) or decimal (80) — always 7-bit (not 8-bit with R/W bit). Data bytes may be hex, decimal or mixed (0xFF 0 0xAA).

Use Cases

Read EEPROM

i2c -c "I2C_MAIN" -a 0x50 -w -d 0x00 0x00
i2c -c "I2C_MAIN" -a 0x50 -r -l 256

Detect Devices

i2c -c "I2C_MAIN" -s

Error Handling

  • No option supplied: Must specify scan, read, or write
  • Address required: Read/write operations need device address
  • NACK: Device didn’t acknowledge (wrong address or device error)
  • Timeout: Bus or device not responding
  • Not connected: Run init command first

Notes

  • Requires an active connection (use init first)
  • Speed depends on hardware (typically 100 kHz or 400 kHz)
  • Address range 0x08–0x77 (7-bit); 0x00–0x07 and 0x78–0x7F reserved

Book a demo of Probe

Show us your board — we review it and go through the findings together.

Prefer to email? info@esharp.se