Raw Byte Stream
The raw adapter is a transparent pass-through. It does no protocol decoding —
bytes from the serial line go out verbatim, and bytes you send come back in
verbatim. Use it for a protocol OmniBus doesn't natively decode, or as a plain
serial-to-TCP/MQTT tunnel.
Configuration
- Serial settings — baud, data bits, parity, stop bits to match the device.
- Command throttling (optional) — rate-limit outbound writes for devices that can't keep up with back-to-back commands.
Outputs
| Output | Behavior |
|---|---|
| TCP | The port's TCP server is a raw byte pipe — identical to the serial line in both directions. |
| MQTT | Publishes <prefix>/rx (inbound bytes, base64); subscribes <prefix>/tx (outbound). |
| REST | POST /api/ports/:path/rest/tx to send bytes. |
| Webhooks | Fan out the rx event. |
MQTT
- publish
<prefix>/rx— base64-encoded inbound bytes. - subscribe
<prefix>/tx— outbound bytes, as base64 orhex:….
REST
POST /api/ports/:path/rest/tx
Authorization: Bearer <token>
Content-Type: application/json
{ "data": "<base64>" } // or: { "hex": "01 02 03" }
:path is the URL-encoded device path, e.g. %2Fdev%2FttyUSB0.