SolarOS 4.17.7 manual · job

bridge

Bidirectional byte bridge between two byte-stream ports, or between one byte-stream port and an active SolarOS Link instance.

Usage:

job start bridge <port-a> <port-b>
job start bridge <port> <link> [broadcast|destination-id]
job stop bridge
job status bridge

Example:

job start bridge cdc0 uart0

To expose a UART byte stream over a packet-radio Link:

job start radio-link link0 radio0 lora-eu868
job start bridge uart0 link0 broadcast

That direct Link form is best-effort. For an ordered, retransmitted stream, create a peer-bound virtual port and use the normal port-to-port bridge form:

link stream create link0 vser0 0x12345678
job start bridge cdc0 vser0

The remote device creates its matching vser0 and can attach a normal shell with session create shell vser0 --term dumb. On a headless DevKit, this leaves the primary uart0 shell free for administration while Linux uses USB cdc0 for the remote terminal.

Use a decimal or 0x 32-bit Link destination instead of broadcast for acknowledged unicast:

job start bridge uart0 link0 0x12345678

Notes:

• The two ports must be different.
• Both ports are claimed by the bridge job until it stops.
• Link stream ports such as vser0 are normal byte-stream ports. Their stream service supplies peer filtering, segmentation, ordering, retransmission, and bounded backpressure before the bridge sees bytes.
• In Link mode, the serial port is claimed while the already-running Link instance remains active under its transport job.
• Available serial bytes are emitted as binary Link messages, each capped at the Link payload MTU. Received text and binary payloads are written to the serial port without a separator, preserving byte-stream behavior.
• broadcast is the default destination. Explicit destinations request normal Link acknowledgements.
• The bridge consumes the Link receive queue. Do not use link receive on the same Link while the bridge is running.
• Packet radio is usually much slower than UART. The bridge uses the existing bounded Link queues and does not add an unbounded SRAM buffer; sustained serial input can therefore overrun the port or produce Link queue drops.
• If the Link disappears, the bridge releases its serial port and stops with the Link error.
• This is the clean base for USB-to-UART converter style workflows.