MicroPython i2c tutorial: Pico & ESP32

Setup

MicroPython i2c setup: create the bus and scan it

Wire the sensor (3.3 V, GND, SDA, SCL — a Qwiic cable pins this down for you), then at the REPL:

# Raspberry Pi Pico — I2C0 on GP0 (SDA) / GP1 (SCL)
from machine import I2C, Pin
i2c = I2C(0, sda=Pin(0), scl=Pin(1), freq=100_000)

# ESP32 — the usual pins are 21 (SDA) / 22 (SCL)
# i2c = I2C(0, sda=Pin(21), scl=Pin(22), freq=100_000)

print([hex(a) for a in i2c.scan()])   # e.g. ['0x76']

An empty list means wiring trouble, not code trouble — the 7-step checklist sorts it. A number you don't recognise? The address list will. Note the Pico only accepts specific pin pairs per peripheral (see FAQ); for arbitrary pins swap in SoftI2C with the same arguments.

Registers

MicroPython i2c read and write: registers in one call

MicroPython's killer convenience is readfrom_mem / writeto_mem — they bundle the whole register dance (pointer write, repeated start, read) into one line:

ADDR = 0x76                                # BME280

chip_id = i2c.readfrom_mem(ADDR, 0xD0, 1)  # read 1 byte from register 0xD0
print(hex(chip_id[0]))                     # 0x60 = BME280, 0x58 = BMP280

i2c.writeto_mem(ADDR, 0xF4, bytes([0x27])) # write 0x27 to ctrl_meas

Multi-byte values arrive as a bytes object — combine them explicitly, and check the datasheet's byte order:

raw = i2c.readfrom_mem(ADDR, 0xF7, 3)          # 20-bit pressure, MSB first
press = int.from_bytes(raw, "big") >> 4

import struct                                   # or, for signed 16-bit LSB-first:
val = struct.unpack("<h", i2c.readfrom_mem(ADDR, 0x88, 2))[0]

For chips that aren't register machines (some talk raw commands), drop down to i2c.writeto(addr, buf) and i2c.readfrom(addr, n) — same bus, no pointer byte. The full method list lives in the official machine.I2C documentation.

A real loop

Continuous i2c reading in MicroPython, done politely

import time

while True:
    try:
        raw = i2c.readfrom_mem(0x76, 0xF7, 8)
        # ...decode per datasheet, or use a driver library...
        print(raw)
    except OSError:
        print("sensor didn't ACK — check the bus")
    time.sleep(1)

Bus errors in MicroPython surface as OSError (usually ENODEV when a device fails to ACK) — catch it so one loose cable or missing pull-up doesn't crash the loop. For popular parts you'll find ready drivers (bme280.py, ssd1306.py) that wrap all of the above — this tutorial is what's inside them.

Coming from C? The same concepts map one-to-one onto Arduino's Wire library — covered in our Arduino i2c tutorial. And when you outgrow one bus, the RP2040's second peripheral (I2C(1, ...)) is the cleanest fix for an address conflict.