SolarOS 4.17.7 manual · app

io

Interactive expansion I/O manager. Its default Layout view presents the board's connectors in their physical arrangement, followed by the existing pin, named-bus, and resource-claim views. It uses the same ownership and validation services as the gpio, i2c, spi, uart, midi, onewire, and expansion commands.

Usage:

io

Controls:

• Tab switches between Layout, Pins, Buses, and Claims. Outside Layout, Left and Right also switch views.
• Arrows move through the physical connector grid in Layout and through rows in the other views. Page Up/Page Down, Home, and End make larger moves.
• Layout adapts to the terminal: compact headers show several pins across, while long headers such as the DevKitC J1/J3 pair scroll vertically with one physical pin pair per row. Narrow screens show fewer columns and keep the selected pin visible.
• Pins, Buses, and Claims fit their columns to the screen width. Bus state stays ahead of routing details; trailing columns are omitted when space is limited.
• Layout markers are * free, ~ releasable, @ claimed, ! fixed/control, + power, - ground, and x not connected.
• Enter opens context-sensitive actions for a pin or bus.
• n creates a board-approved named I2C, SPI, UART, MIDI, 1-Wire, PS/2, or CAN bus, depending on the installed drivers.
• Bus creation uses arrows to select fields and values; the generated bus name can be edited directly.
• Runtime buses can be attached, detached, or removed when their lease state permits it. Their Autostart action idempotently appends the matching expansion bus create ... command to /.shell/startup. Direct GPIO and PWM assignments can be created and released from the Pins or Layout view.
• CAN creation selects TX/RX GPIOs, bitrate in kbit/s, listen-only or normal mode, and an optional transceiver-select GPIO with its active level. The default is 500 kbit/s in listen-only mode. CAN controllers appear in Buses; runtime controllers support removal and Autostart, which saves an expansion attach twai-can ... command. A compatible CAN transceiver is required; see manual hardware.can.
• A selected I2C bus has a Set I2C speed action with 100 kHz, 400 kHz, and 1 MHz choices. The change applies at runtime even while devices lease the bus.
• r refreshes; q, Esc, or the app-exit key exits.