diff --git a/docs/assets/m1-navigate-to-configuration-yaml.gif b/docs/assets/m1-navigate-to-configuration-yaml.gif new file mode 100755 index 000000000..e4df31fce Binary files /dev/null and b/docs/assets/m1-navigate-to-configuration-yaml.gif differ diff --git a/docs/products/m1/examples/share-data-from-home-assistant.md b/docs/products/m1/examples/share-data-from-home-assistant.md new file mode 100755 index 000000000..66a9231f9 --- /dev/null +++ b/docs/products/m1/examples/share-data-from-home-assistant.md @@ -0,0 +1,66 @@ +--- +title: >- + M-1 LED Matrix Setting up scrolling text with the states of Home Assistant + entities! +description: >- + Step by step guide for custom scrolling text using the states of Home + Assistant entities! +--- +# Share Data from Home Assistant on your M-1 LED Matrix + +!!! tip "This tutorial expects you to already have 4 segments created!" + + Please follow this wiki article to setup your M-1 LED Matrix with segments. If you are using multiple panels, follow this article instead then come back! + +The WLED integration for Home Assistant does not support sending data from our devices directly to the M-1 LED Matrix, however, we are still able to do so using the WLED JSON API. This is an advanced tutorial but if you follow each step closely you should be able to follow along! + +1\. Install "Studio Code Server" from the addon store in Home Assistant OS. Click Open Webui and navigate to your configuration.yaml file. + +![](../../../assets/m1-navigate-to-configuration-yaml.gif) + +!!! danger "This file is used by Home Assistant and must be careful edited" + + Home Assistant requires this file to work properly so only make changes exactly as shown below. Do NOT add any extra spaces or change anything other than what is shown in the steps below! + +## 🧩 WLED Matrix YAML Generator + + + +  + +2\. Copy the code below and paste it at the very bottom of your configuration.yaml file. + +```yaml +rest_command: + matrix_all_segments: + url: http://10.10.10.176/json/state + content_type: 'application/json' + verify_ssl: false + method: 'post' + timeout: 20 + payload: > + { + "seg":[ + { + "id":0, + "fx":122, + "n": "{{state_attr('weather.nowcast','temperature')}}F {{states('weather.nowcast')|title}} FL: {{ states('sensor.feels_like') | round(0) | int }}F" + }, + { + "id":1, + "fx":122, + "n": "{{ states('lock.front_door_lock') == 'locked' and 'Front Door Locked' or 'Front Door Unlocked' }}" + }, + { + "id":2, + "fx":122, + "n": "CO2 {{states('sensor.brandon_air_1_co2') | int}}ppm VOC {{states('sensor.brandon_air_1_sen55_voc') | int}}ppm" + }, + { + "id":3, + "fx":122, + "n": "Ping {{ states('sensor.1_1_1_1_round_trip_time_average') | float | round(0) | int }}ms {{ states('alarm_control_panel.alarmo') }}" + } + ] + } +``` \ No newline at end of file diff --git a/docs/products/m1/setup/m1-general-tips.md b/docs/products/m1/setup/m1-general-tips.md index 8c84a233f..cdd482f1a 100755 --- a/docs/products/m1/setup/m1-general-tips.md +++ b/docs/products/m1/setup/m1-general-tips.md @@ -4,13 +4,12 @@ description: Multiple helpful tips to use your M-1 LED Matrix to the fullest! --- # General Tips -###### Known issues +The M-1 LED Matrix is using WLED MoonModules which is a fork of WLED that supports the Hub75 Matrix. -As of 6/25/25 these are the known issues with the firmware shipped with the device: +WLED uses segments which allow you to create virtual led strips (or panels) of leds to control individually. This is useful in cases where you want to connect multiple panels and have text scrolling across the screens. -* unable to set default preset at boot (only will boot to orange screen) -* randomly crashes after 1-2 days -* changing custom preset to effect does not work unless you turn the leds off then back on (not power cycle). -* Error 11 not enough space after saving some presets -* Once you edit a setting and save in the LED Preferences and go try to save again it will crash the device. Workaround for now is to edit the json manually using ChatGPT. -* Image and effects are shifted to the left by 1 column \ No newline at end of file +Segments are also able to be used to control two panels from one controller such as making the first segment a 64x64 panel and the second segment control second 64x64 panel. + +The M-1 matrix is able to be controlled via the JSON API and this allows to do some really neat things such as send data from Home Assistant to show up as "scrolling text" on your matrix. (Works best with 2 or 3 panels not 4 due to 32 characters available as scrolling text. + +The M-1 Matrix can be controlled using the JSON API, allowing you to do some really cool things like sending data from Home Assistant to display as scrolling text on the matrix. (For best results, use 1 to 3 panels instead of 4, as the scrolling text supports up to 32 characters.) \ No newline at end of file diff --git a/docs/static/matrix-jinja-generator.htm b/docs/static/matrix-jinja-generator.htm new file mode 100755 index 000000000..de96bfc25 --- /dev/null +++ b/docs/static/matrix-jinja-generator.htm @@ -0,0 +1,92 @@ +

🧩 WLED Matrix YAML Generator (4 Segments)

+

Select the entity type and enter the full Home Assistant entity ID. Example: sensor.temp_living_room

+ +
+
+
+ +

📝 Generated YAML:

+

+
+
+