SolarOS 4.13.4 manual · api

Named runtime buses

Named buses let scripts and expansion drivers share one description of a physical I2C, SPI, UART, MIDI, OneWire, or PS/2 connection. The registry records pins, readiness, sharing policy, and active leases.

Inspect before creating

import solaros

for bus in solaros.buses.list():
    print(bus)

Reuse a suitable registered bus instead of creating a duplicate on the same pins. Use attach and detach for leases, and remove only a runtime bus that has no users.

Change the clock of a board-defined or runtime-created named I2C bus without recreating its descriptor:

i2c speed i2c0 400000
i2c status i2c0

The change is serialized with transfers and applies to subsequent transactions, including when attached devices retain shared leases. The io app exposes the same operation as Set I2C speed on a selected I2C bus.

Transfer through the registry

Use the family matching the descriptor: i2c_scan, spi_xfer, uart_read, or onewire_scan. Inspect the result and release any lease even when a transfer fails.

Quick reference

Prefer solaros.buses for named hardware. list and get inspect registered buses; create_i2c, create_onewire, create_ps2, create_spi, create_uart, and create_midi create runtime buses; attach, detach, remove manage lifecycle. Transfer families are i2c_probe or scan or read_reg or write_reg, onewire_reset or scan or xfer, spi_xfer or read or write, and uart_read or write. Inspect descriptors before choosing names, pins, chip selects, or hosts.

A MIDI bus is a first-class, exclusive bus backed internally by an available UART controller. create_midi(name, {"tx": ..., "rx": ...}) does not take a controller number and defaults to 31250 baud. Start job midi to receive and transmit MIDI messages. Use optoisolated MIDI IN and a current-limited MIDI OUT driver; do not wire a DIN MIDI connector directly to ESP32 GPIOs.