PixelIt Documentation

# ioBroker

The PixelIt adapter (opens new window) sends screens from ioBroker and receives device status, button and sensor updates. This page describes published adapter version 1.1.4 with firmware 2.6.0. The adapter requires Node.js 18 or newer; also meet your ioBroker installation's runtime requirements.

Install the adapter through ioBroker Admin and create an instance. Commands use HTTP port 80 and status updates use WebSocket port 81, so both ports must be reachable from the ioBroker host.

# Basic settings

  • IP address: Enter the PixelIt IP address without http:// or a path. Save the instance configuration and check info.connection.

# Data points

  • brightness:
    • Set brightness as a percentage from 0 to 100.
  • brightness_255:
    • Set brightness from 0 to 255.
  • ext_message:
    • Write a JSON string containing a screen payload. Prefer inline pixel arrays for bitmap payloads.
    • Only commands from the endpoint /api/screen are accepted!
  • message:
    • Write text, optionally followed by an RGB color and a gallery ID.
    • The structure looks like this Miau!;255,255,255;387.
  • show_clock:
    • Sends {"clock": {}} to display the device clock.
  • sleep_mode:
    • Set true to sleep or false to wake. Send a new screen separately after waking; see Sleep Mode.

Write command states with ack: false; acknowledged states are feedback. Automatic brightness control can override a manually requested brightness.

Gallery ID lookups depend on the external gallery service. The adapter's numeric-ID handling in ext_message is different from its simple message lookup; use inline RGB565 arrays in complex screens instead of relying on numeric data IDs. Start with a text-only message such as Hello PixelIt! to verify device communication independently of the gallery.

The adapter does not provide the Node-RED playlist engine. Use your own ioBroker scheduling logic when rotating screens.

← Troubleshooting →