To display e.g. sensor data from your Home Assistant instance, there are two possibilitis. Using the REST API or MQTT.
The following wrapper supports for now only the JustTextPlugin.
If you want to add the wrapper to your Home Assistant instance you first need to add a REST command to your configuration.yaml
.
Add the following lines of code to your configuration.yaml
:
rest_command:
pixelix_just_text:
url: 'http://192.168.178.10/rest/api/v1/display/uid/{{ uid }}/text?text={{ "%5C" + align + "%5C" + color + text }}'
method: POST
You need to replace the IP 192.168.178.10
with your Pixelix instance IP.
You can use this link to add the wrapper to your Home Assistant installation.
As an alternative you can copy the yaml to /config/blueprints/automation/homeassistant/
.
You can find the raw YAML file here
First of all you need to install a "JustText"-Plugin in a slot in your Pixelix installation. Then note down the uid of the plugin.
The fields should be pretty self-explanatory. Just note that you have to enter the sensor labels in the following format:
- Sensor Label 1
- Sensor Label 2
- Sensor Label 3
See it in the example screenshot above. Important: Each sensor entry must have an corresponding sensor label entry!
MQTT is not part of every Pixelix installation. It depends on the development board specific configuration or in other words, mainly on the available flash size. For development boards with less than 8 MB flash, its disabled by default, except the Ulanzi TC001. You can enable it, but need to compile it by yourself and throw other plugins out to get it fit.
If not already installed, you will need to add the MQTT integration
The Home Assistant MQTT discovery is supported by several plugins and features, here are some examples:
- Display on/off
- Device restart
- Sensor information
- JustTextPlugin
- IconTextPlugin
- IconTextLampPlugin
- MultiIconPlugin
Pixelix will be shown as device with its entities. Every installed plugin will be shown as at least one entity.
More technical details about MQTT
If you have further ideas or you found some bugs, great! Create a issue or if you are able and willing to fix it by yourself, clone the repository and create a pull request.
The whole source code is published under the MIT license. Consider the different licenses of the used third party libraries too!
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any additional terms or conditions.