Skip to main content

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

OutputBehavior
TCPThe port's TCP server is a raw byte pipe — identical to the serial line in both directions.
MQTTPublishes <prefix>/rx (inbound bytes, base64); subscribes <prefix>/tx (outbound).
RESTPOST /api/ports/:path/rest/tx to send bytes.
WebhooksFan out the rx event.

MQTT

  • publish <prefix>/rx — base64-encoded inbound bytes.
  • subscribe <prefix>/tx — outbound bytes, as base64 or hex:….

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.