# IconTextLampPlugin

The plugin shows an icon on left side, text on right side and lamps at the bottom.

Each part can be set separately via the REST API.

Show bitmap in the specified slot. Supported are bitmap files (.bmp) with:

- 24 or 32 bits per pixel.
- 1 plane.
- No compression.

Note, if you are using _gimp_ to create bitmap files, please configure like:

- Compatibility options: Don't write color informations.
- Extended options: Select 24 bit per pixel.

If MQTT is built in and enabled, it will support Home Assistant MQTT discovery.

## REST API

### Get text

    GET {{ORIGIN}}/rest/api/v1/display/uid/<PLUGIN-UID>/text

    GET {{ORIGIN}}/rest/api/v1/display/alias/<PLUGIN-ALIAS>/text

- PLUGIN-UID: The plugin unique id.
- PLUGIN-ALIAS: The plugin alias name.

### Set text

    POST {{ORIGIN}}/rest/api/v1/display/uid/<PLUGIN-UID>/text?text=<TEXT>

    POST {{ORIGIN}}/rest/api/v1/display/alias/<PLUGIN-ALIAS>/text?text=<TEXT>

- PLUGIN-UID: The plugin unique id.
- PLUGIN-ALIAS: The plugin alias name.
- TEXT: The text to show on the display.

### Set icon

    POST {{ORIGIN}}/rest/api/v1/display/uid/<PLUGIN-UID>/bitmap

    POST {{ORIGIN}}/rest/api/v1/display/alias/<PLUGIN-ALIAS>/bitmap

- PLUGIN-UID: The plugin unique id.
- PLUGIN-ALIAS: The plugin alias name.

### Get all lamp states

    GET {{ORIGIN}}/rest/api/v1/display/uid/<PLUGIN-UID>/lamps

    GET {{ORIGIN}}/rest/api/v1/display/alias/<PLUGIN-ALIAS>/lamps

- PLUGIN-UID: The plugin unique id.
- PLUGIN-ALIAS: The plugin alias name.

### Set lamp state

    POST {{ORIGIN}}/rest/api/v1/display/uid/<PLUGIN-UID>/lamp/<LAMP-ID>?state=<LAMP-STATE>

    POST {{ORIGIN}}/rest/api/v1/display/alias/<PLUGIN-ALIAS>/lamp/<LAMP-ID>?state=<LAMP-STATE>

- PLUGIN-UID: The plugin unique id.
- PLUGIN-ALIAS: The plugin alias name.
- LAMP-ID: The id of the lamp (starting with 0 from left).
- LAMP-STATE: `on` or `off`

## Configuration

### Icon

Plugin UID:
Icon:

### Text

Plugin UID:
Text:

### Lamp

Plugin UID:
Lamp:
State: