API & Integrations

MQTT

Publishes all available information:

  • Raw reading
  • Calibrated reading
  • etc.

Under topic: yarrboard/sendit/*

Home Assistant

To use SendIt with Home Assistant, follow these steps:

  • Install the Mosquitto Broker (MQTT server) app in Home Assistant.
  • Enable MQTT discovery in Home Assistant
  • In SendIt, enable MQTT and the Home Assistant features
  • In Home Assistant, it should show the discovered SendIt board and each channel

TODO: add link to dashboard YAML here

Raw API

The protocol for communicating with Yarrboard is entirely based on JSON messages. Each request to the server should be a single JSON object, and the server will respond with a JSON object.

The protocol works over the following transport layers:

  • HTTP API
  • Websockets
  • USB Serial
  • MQTT

Since SendIt is not interactive, the most useful command is ‘get_update’ to get the latest readings:

{"cmd": "get_update"}

Visit the YarrboardFramework documentation page for more details on the underlying protocol.

SignalK

//todo: signalk support isnt really setup yet.