From 9e5892dc6efef93f2d81753c70cfe1ec1b94b9ee Mon Sep 17 00:00:00 2001
From: Docs <docs@dummy.bot.com>
Date: Fri, 12 Dec 2025 16:21:06 +0000
Subject: [PATCH] Deployed 8805e218 to stable with MkDocs 1.6.1 and mike 2.1.3

---
 stable/prepare_nspanel/index.html |  26 ------------------
 stable/search/search_index.json   |   2 +-
 stable/sitemap.xml                |  44 +++++++++++++++---------------
 stable/sitemap.xml.gz             | Bin 374 -> 374 bytes
 4 files changed, 23 insertions(+), 49 deletions(-)

diff --git a/stable/prepare_nspanel/index.html b/stable/prepare_nspanel/index.html
index ed5cf99c..c1f61cb2 100644
--- a/stable/prepare_nspanel/index.html
+++ b/stable/prepare_nspanel/index.html
@@ -471,17 +471,6 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
-        <li class="md-nav__item">
-  <a href="#downgrade-tasmota" class="md-nav__link">
-    <span class="md-ellipsis">
-      
-        Downgrade Tasmota
-      
-    </span>
-  </a>
-  
-</li>
-      
         <li class="md-nav__item">
   <a href="#configure-tasmota-template-for-nspanel" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1318,17 +1307,6 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
-        <li class="md-nav__item">
-  <a href="#downgrade-tasmota" class="md-nav__link">
-    <span class="md-ellipsis">
-      
-        Downgrade Tasmota
-      
-    </span>
-  </a>
-  
-</li>
-      
         <li class="md-nav__item">
   <a href="#configure-tasmota-template-for-nspanel" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1387,10 +1365,6 @@ You can use the <a href="https://tasmota.github.io/install/">Tasmota Web Install
 <p>If you prefer ESPHome over Tasmota, you can use this third-party ESPHome component, which replaces Tasmota and the Berry driver used in this project.<br>
 <a href="https://github.com/sairon/esphome-nspanel-lovelace-ui">ESPHome Component</a></p>
 <hr>
-<h2 id="downgrade-tasmota">Downgrade Tasmota<a class="headerlink" href="#downgrade-tasmota" title="Permanent link">¶</a></h2>
-<p>Downgrade your Tasmota to version <strong>15.0.1</strong> - in newer versions, flashing the display currently does not work.</p>
-<p><a href="https://ota.tasmota.com/tasmota32/release-15.0.1/tasmota32-nspanel.bin">https://ota.tasmota.com/tasmota32/release-15.0.1/tasmota32-nspanel.bin</a></p>
-<hr>
 <h2 id="configure-tasmota-template-for-nspanel">Configure Tasmota Template for NSPanel<a class="headerlink" href="#configure-tasmota-template-for-nspanel" title="Permanent link">¶</a></h2>
 <p>Configure the NSPanel template for Tasmota. (Go to Configuration &gt; Configure Other, paste the template there, and make sure to tick the Activate checkbox.)</p>
 <p><img alt="tasmota-template-config" src="../img/tasmota-template-config.png"></p>
diff --git a/stable/search/search_index.json b/stable/search/search_index.json
index e1fe74ef..36026445 100644
--- a/stable/search/search_index.json
+++ b/stable/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"","title":"Overview","text":""},{"location":"#overview","title":"Overview","text":"<p>If you like this project consider buying me a pizza \ud83c\udf55 </p> <p> </p> <p>NsPanel Lovelace UI is a Firmware for the nextion screen inside of NSPanel in the Design of HomeAssistant's Lovelace UI Design.</p> <p>EU Model and US Model supported (in portrait and landscape orientation)</p> <p>Content of the screen is controlled by a AppDaemon Python Script installed on your HomeAssistant Instance.</p> <p>Or an TypeScript on your ioBroker Instance in case you are an ioBroker User.</p> <p>NsPanel needs to be flashed with Tasmota (or with the 3rd Party ESPHome Component from @sairon)</p> <p></p>"},{"location":"#features","title":"Features","text":"<ul> <li>Entities Page</li> <li>Grid Page</li> <li>Detail Pages for Lights (Brightness, Temperature and Color of the Light) and for Covers (Position)</li> <li>Thermostat Page </li> <li>Media Player Card</li> <li>Alarm Control Card</li> <li>Screensaver Page with Time, Date and Weather Information</li> <li>Card with QrCode to display WiFi Information</li> <li> <p>Localization (currently 40 languages)</p> </li> <li> <p>Everything is dynamically configurable by a yaml config, no need to code or touch Nextion Editor</p> </li> </ul> <p>It works with Tasmota and MQTT.  To control the panel and update it with content from HomeAssistant there is an AppDaemon App.</p> <p>See the following picture to get an idea of the look of this firmware for NSPanel.</p> <p></p> <p>Some (not all) screenshots from the US Portrait Version:</p> <p></p>"},{"location":"#requirements","title":"Requirements","text":"<ul> <li>NSPanel</li> <li>USB to Serial TTL Adapter</li> <li>Running Instance of the Home Automation Platform of your Choise</li> <li>Running Home Assistant Instance<ul> <li>with installed MQTT Broker</li> </ul> </li> <li>Running ioBroker Instance<ul> <li>with installed MQTT Broker</li> </ul> </li> </ul>"},{"location":"card-alarm/","title":"Alarm Card","text":""},{"location":"card-alarm/#alarm-card","title":"Alarm Card","text":"<pre><code>    cards:\n      - type: cardAlarm\n        title: Alarm Test 1\n        entity: alarm_control_panel.alarmo\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>title</code> True string <code>None</code> Title of the Page <code>entity</code> False string <code>None</code> contains the entity of the current card <code>key</code> True string <code>None</code> Used by navigate items <code>alarmControl</code> True complex <code>None</code> overwrites the action executed on pressing the left bottom icon, by default this button is used to show a list of open sensors on a failed attempt to arm. <code>supportedModes</code> True list <code>None</code> Supply list of arm modes if you want to limit the modes on the card. Example <code>['arm_away', 'arm_night']</code>"},{"location":"card-climate/","title":"Climate/Thermo Card","text":""},{"location":"card-climate/#climatethermo-card","title":"Climate/Thermo Card","text":"<pre><code>    cards:\n      - type: cardThermo\n        title: HeatPump\n        entity: climate.heatpump\n      - type: cardThermo\n        title: HvaC\n        entity: climate.hvac\n      - type: cardThermo\n        title: ecobee\n        entity: climate.ecobee\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entity</code> False string <code>None</code> contains the entitiy of this card <code>title</code> True string <code>None</code> Title of the Page <code>temperatureUnit</code> True string <code>celsius</code> set this to fahrenheit to change the temperatureUnit on the page <code>key</code> True string <code>None</code> Used by navigate items in combination with the type (cardEntities_key) <code>supportedModes</code> True list <code>None</code> Supply list of heat actions if you want to limit the actions on the card. Example <code>['heat', 'off']</code>"},{"location":"card-entities/","title":"Entities Card","text":""},{"location":"card-entities/#entities-page","title":"Entities Page","text":"<pre><code>    cards:\n      - type: cardEntities\n        title: Test Entities Card\n        entities:\n          - entity: light.bed_light\n          - entity: switch.decorative_lights\n          - entity: cover.hall_window\n          - entity: sensor.outside_temperature\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entities</code> False complex <code>None</code> contains a list of entities of this card <code>title</code> True string <code>None</code> Title of the Page <code>key</code> True string <code>None</code> Used by navigate items in combination with the type (cardEntities_key) <p>List of supported entitiy types for this page:</p> <ul> <li>cover</li> <li>switch</li> <li>input_boolean</li> <li>binary_sensor</li> <li>sensor</li> <li>button</li> <li>number</li> <li>input_number</li> <li>scenes</li> <li>script</li> <li>input_button</li> <li>light</li> <li>input_text (read-only)</li> <li>input_select</li> <li>lock</li> <li>fan</li> <li>automation</li> <li>alarm</li> <li>sun</li> <li>person</li> <li>climate (status only, may be used in combination with navigate)</li> <li>iText (internal entity for showing static text)</li> <li>delete (internal entity to keep a entiy empty in the middle of the list)</li> <li>navigate (internal entity for navigation, see subpages)</li> </ul>"},{"location":"card-grid/","title":"Grid Card","text":""},{"location":"card-grid/#grid-page","title":"Grid Page","text":"<pre><code>    cards:\n      - type: cardGrid\n        title: Test Grid Card\n        entities:\n          - entity: light.bed_light\n          - entity: switch.decorative_lights\n          - entity: sensor.outside_temperature\n            name: Outside Temp\n          - entity: sensor.carbon_monoxide\n          - entity: light.entrance_color_white_lights\n            name: Entrance\n          - entity: light.office_rgbw_lights\n            name: Office RGBW\n            icon: mdi:office-building\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entities</code> False complex <code>None</code> contains a list of entities of this card <code>title</code> True string <code>None</code> Title of the Page <code>key</code> True string <code>None</code> Used by navigate items in combination with the type (cardEntities_key) <p>List of supported entitiy types for this page:</p> <ul> <li>cover</li> <li>switch</li> <li>input_boolean</li> <li>binary_sensor</li> <li>sensor</li> <li>button</li> <li>number</li> <li>input_number</li> <li>scenes</li> <li>script</li> <li>input_button</li> <li>light</li> <li>input_text (read-only)</li> <li>input_select</li> <li>lock</li> <li>fan</li> <li>automation</li> <li>alarm</li> <li>sun</li> <li>person</li> <li>climate (status only, may be used in combination with navigate)</li> <li>iText (internal entity for showing static text)</li> <li>delete (internal entity to keep a entiy empty in the middle of the list)</li> <li>navigate (internal entity for navigation, see subpages)</li> </ul>"},{"location":"card-media/","title":"Media Card","text":""},{"location":"card-media/#media-card","title":"Media Card","text":"<pre><code>    cards:\n      - type: cardMedia\n        entity: media_player.spotify\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>title</code> True string <code>None</code> Title of the Page <code>entity</code> False string <code>None</code> contains the entity of the current card <code>entities</code> False complex <code>None</code> contains a list of entities shown in the bottom row, supports all entities supported by cardGrid <code>key</code> True string <code>None</code> Used by navigate items Example with configured Entities <pre><code>      - type: cardMedia\n        title: Kitchen\n        entity: media_player.kitchen\n        entities:\n          - entity: light.bed_light\n          - entity: light.ceiling_lights\n          - entity: light.entrance_color_white_lights\n          - entity: light.kitchen_lights\n          - entity: light.living_room_rgbww_lights\n</code></pre> Example with action on upper left media icon <pre><code>      - type: cardMedia\n        title: Kitchen\n        entity: input_select.test123\n        status: media_player.kitchen\n</code></pre> Example with moved spaker selection  The icon for speaker selection is automatically appended to the end of the list and can be moved with entities in the list. With 6 entities it is possible to remove it entirely. <pre><code>      - type: cardMedia\n        title: Kitchen\n        entity: media_player.kitchen\n        entities:\n          - entity: delete\n          - entity: delete\n</code></pre>"},{"location":"card-power/","title":"Power Card","text":""},{"location":"card-power/#power-card-v39-and-higher","title":"Power Card (v3.9 and higher)","text":"<pre><code>    cards:\n      - type: cardPower\n        title: Power Test\n        entities:\n          - entity: sensor.power_consumption\n            icon: mdi:home\n          - entity: delete\n          - entity: sensor.today_energy\n            icon: mdi:car\n            speed: -20\n          - entity: delete\n          - entity: sensor.today_energy\n            icon: mdi:battery\n            speed: 20\n          - entity: delete\n          - entity: sensor.today_energy\n            icon: mdi:solar-panel\n            color: [255, 255, 0]\n            speed: 30\n          - entity: sensor.today_energy\n            speed: -40\n            icon: mdi:help\n</code></pre> <p>The first two entities are shown in the middle of the card, all other entities are used around it. Any entity overrides (e.g. icon, color) in the first entity apply to the middle of the card.</p> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entities</code> False complex <code>None</code> contains entities of the card <code>title</code> True string <code>None</code> Title of the Page <code>cooldown</code> True float <code>None</code> Rate Limit for Entity Updates to the card in Seconds (<code>cooldown: 0.5</code>) <code>key</code> True string <code>None</code> Used by navigate items <p>List of supported entitiy types for this page:</p> <ul> <li>sensor</li> </ul> <p>N.B. Negative values will likely be truncated and not display gracefully. For this reason, when measuring energy you should use the same inputs as you use on the Home Assistant Energy Dashboard (i.e. separate grid import and grid export) and similarly when measuring power.</p> <p>Some details about speed:</p> <p>Speed expects an integer input between <code>-100</code> and <code>100</code>.</p> <p>It is possible to calculate the speed through a Home Assistant template, this allows to calculate the speed in relation to other data in Home Assistant.</p> <p>This template will calculate a speed setting based on the amount of power drawn on a device as a fraction of the total power usage. </p><pre><code>            speed: &gt;-\n              {% set entity_power = states('sensor.appliance_water_heater_power') |float | round(3)%}\n              {% set total_power = states('sensor.ams_power_active') | float | round(3) %}\n              {% set entity_usage = (entity_power / total_power * 100) | float %}\n              {{ (entity_usage | round()) * -1 }}\n</code></pre> It provides the number as a negative integer, making the dot move from the middle of the card toward the entity. If you want the dot to move toward from the middle of the card, just skip inverting it at the end of the template like this: <pre><code>              {{ (entity_usage | round()) }}\n</code></pre>"},{"location":"card-qr/","title":"Wifi/QR Card","text":""},{"location":"card-qr/#wifi-qr-card","title":"WiFi / QR Card","text":"<pre><code>    cards:\n      - type: cardQR\n        title: Guest Wifi\n        qrCode: \"WIFI:S:test_ssid;T:WPA;P:test_pw;;\"\n        entities:\n          - entity: iText.test_ssid\n            name: Name\n            icon: mdi:wifi\n          - entity: iText.test_pw\n            name: Password\n            icon: mdi:key\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entities</code> False complex <code>None</code> contains entities of the card, only valid on cardEntities and cardGrid and cardQR <code>title</code> True string <code>None</code> Title of the Page <code>key</code> True string <code>None</code> Used by navigate items <code>qrCode</code> False string <code>None</code> Value of the qrCode <p>List of supported entitiy types for this page:</p> <ul> <li>switch</li> <li>input_boolean</li> <li>binary_sensor</li> <li>sensor</li> <li>button</li> <li>scenes</li> <li>script</li> <li>input_button</li> <li>input_select</li> <li>light</li> <li>input_text (read-only)</li> <li>lock</li> <li>automation</li> </ul> <p>The qrCode value is evaluated as a homeassistant Template, so it is possible to get values from HomeAssistant within the qrCode.</p> <p><code>\"WIFI:S:{{states('input_text.test_ssid')}};T:WPA;P:{{states('input_text.test_pw')}};;\"</code></p>"},{"location":"card-unlock/","title":"Unlock Card","text":""},{"location":"card-unlock/#unlock-card-v40-and-higher","title":"Unlock Card (v4.0 and higher)","text":"<p>Can be used to navigate to create pin locked navigation to a hidden card.</p> <p></p> <pre><code>    cards:\n      - type: cardUnlock\n        pin: 1234\n        title: Admin Page\n        destination: navigate.adminpage\n    hiddenCards:\n      - type: cardGrid\n        title: Admin Page\n        key: adminpage\n        entities:\n          - entity: light.schreibtischlampe\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>title</code> True string <code>None</code> Title of the Page <code>destination</code> False string <code>None</code> contains the navigation entity this card should navigate to on unlock <code>pin</code> False string 3830 pin to unlock <code>key</code> True string <code>None</code> Used by navigate items"},{"location":"config-overview/","title":"Overview","text":""},{"location":"config-overview/#configuration","title":"Configuration","text":"<p>To confiure your NSPanel to your needs, you need to edit the <code>apps.yaml</code> inside of your Appdaemon config folder and add card and entities you want to display on the screen.</p> <p>If you've sucessfully set up mqtt, you should already have a configuration looking like this:</p> <pre><code>---\nnspanel-1:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/tasmota_your_mqtt_topic/RESULT\"\n    panelSendTopic: \"cmnd/tasmota_your_mqtt_topic/CustomSend\"\n    model: eu\n</code></pre> <p>You can continue from this point adding configuration for the weather forcecast on the screensaver, configuring a schedule for the brightness of the screensaver and your first cards.</p> <pre><code>---\nnspanel-1:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/tasmota_your_mqtt_topic/RESULT\"\n    panelSendTopic: \"cmnd/tasmota_your_mqtt_topic/CustomSend\"\n    model: eu\n    sleepTimeout: 20\n    sleepBrightness:\n      - time: \"7:00:00\"\n        value: 10\n      - time: \"23:00:00\"\n        value: 0\n    locale: \"de_DE\"\n    screensaver:\n      entity: weather.k3ll3r\n    cards:\n      - type: cardEntities\n        entities:\n          - entity: switch.example_item\n          - entity: light.example_item\n        title: Example 1\n      - type: cardGrid\n        entities:\n          - entity: switch.example_item\n          - entity: light.example_item\n        title: Example 2\n</code></pre> <p>This is the full list of configuration options supported for the config key:</p> key optional type default description <code>panelRecvTopic</code> False string <code>tele/tasmota_your_mqtt_topic/RESULT</code> The mqtt topic used to receive messages. <code>panelSendTopic</code> False string <code>cmnd/tasmota_your_mqtt_topic/CustomSend</code> The mqtt topic used to send messages. <code>updateMode</code> True string <code>auto-notify</code> Update Mode for flashing of the nextion display firmware, by default it is showing a message asking for the update after updating the backend app in HACS; Possible values: \"auto\", \"auto-notify\", \"manual\" <code>model</code> True string <code>eu</code> Model; Possible values: \"eu\", \"us-l\" and \"us-p\" <code>sleepTimeout</code> True integer <code>20</code> Timeout for the screen to enter screensaver, to disable screensaver use 0 <code>sleepBrightness</code> True integer/complex <code>20</code> Brightness for the screen on the screensaver, see example below for complex/scheduled config. <code>screenBrightness</code> True integer/complex <code>100</code> Brightness for the screen during usage, config format is the same as sleepBrightness. <code>sleepTracking</code> True string None Forces screensaver brightness to 0 in case entity state is not_home or off, can be a group, person or device_tracker entity. <code>sleepTrackingZones</code> True list <code>[\"not_home\", \"off\"]</code> Allows you to set your own states for sleepTracking <code>sleepOverride</code> True complex None Allows overriding of the sleepBrightness if entity state is on, true or home. Overrides sleepBrightness but sleepTracking takes precedence. <code>locale</code> True string <code>en_US</code> Used by babel to determinante Date format on screensaver, also used for localization. <code>dateFormatBabel</code> True string <code>full</code> formatting options on https://babel.pocoo.org/en/latest/dates.html?highlight=name%20of%20day#date-fields <code>timeFormat</code> True string <code>%H:%M</code> Time Format on screensaver. Substring after <code>?</code> is displayed in a seperate smaller textbox. Useful for 12h time format with AM/PM  <pre><code>\"%I:%M   ?%p\"</code></pre> <code>dateAdditionalTemplate</code> True string <code>\"\"</code> Addional Text dispayed after Date, can contain a Homeassistant Template Example <code>\" - {{ states('sun.sun') }}\"</code> <code>timeAdditionalTemplate</code> True string <code>\"\"</code> Addional Text dispayed below Time, can contain a Homeassistant Template <code>dateFormat</code> True string <code>%A, %d. %B %Y</code> date format used if babel is not installed <code>timezone</code> True string \"\" Timezone for the time on the panel: <code>Europe/Berlin</code> - See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for a list of TZ Identifiers (supported from upcoming version v4.4) <code>defaultBackgroundColor</code> True string ha-dark backgroud color of all cards, valid values: <code>black</code>, <code>ha-dark</code> <code>cards</code> False complex configuration for cards that are displayed on panel; see docs for cards <code>screensaver</code> True complex configuration for screensaver; see docs for screensaver <code>hiddenCards</code> True complex configuration for cards that can be accessed though navigate items; see docs for cards"},{"location":"config-overview/#details-on-sleepbrightnessscreenbrightness-and-other-configs-related-to-screen-brightness","title":"Details on sleepBrightness/screenBrightness and other configs related to screen brightness","text":"<p>It is possible to schedule a brightness change for the screen at specific times.</p> <pre><code>    sleepBrightness:\n      - time: \"7:00:00\"\n        value: 10\n      - time: \"23:00:00\"\n        value: 0\n</code></pre> <pre><code>    sleepBrightness:\n      - time: \"sunrise\"\n        value: 10\n      - time: \"sunset + 1:00:00\"\n        value: 0\n</code></pre> <p>It is also possible to use a static value or an input_number/sensor with the range between 0 and 100 as value for sleepBrightness/screenBrightness:</p> <pre><code>    sleepBrightness: input_number.brightness_nspanel\n</code></pre> <pre><code>    sleepBrightness: 50\n</code></pre> <p>The config option <code>sleepTracking</code> overrides this setting and sets the brightness to 0 if the state of the configured Home Assistant entity is <code>off</code> or <code>not_home</code>. You may also use a Home Assistant group to track multiple entities.</p> <p>The config option <code>sleepOverride</code> overrides sleepBrightness but does not take precedence over sleepTracking. This is useful if, for example, you want your NSPanel to be brighter than usual if your light is on or if you want to override a panel dimming if you are in the room.</p> <p>The following example configuration is turning off the screen after sunset, but in case the bedroom light is on the NSPanel brightness will be 20 instead of 0.</p> <pre><code>    sleepBrightness:\n      - time: \"sunrise\"\n        value: 20\n      - time: \"sunset\"\n        value: 0\n    sleepOverride:\n      entity: light.bedroomlight\n      brightness: 20\n</code></pre>"},{"location":"config-overview/#supported-keys-for-locale-config","title":"Supported keys for locale config","text":"Language Code Language <code>af_ZA</code> Afrikaans <code>ar_SY</code> Arabic <code>bg_BG</code> Bulgarian <code>ca_ES</code> Catalan <code>cs_CZ</code> Czech <code>da_DK</code> Danish <code>de_DE</code> German <code>el_GR</code> Greek <code>en_US</code> English <code>es_ES</code> Spanish <code>et_EE</code> Estonian <code>fa_IR</code> Persian <code>fi_FI</code> Finnish <code>fr_FR</code> French <code>he_IL</code> Hebrew <code>hr_xx</code> Croatian <code>hu_HU</code> Hungarian <code>hy_AM</code> Armenian <code>id_ID</code> Indonesian <code>is_IS</code> Icelandic <code>it_IT</code> Italian <code>lb_xx</code> Luxembourgish <code>lt_LT</code> Lithuanian <code>lv_LV</code> Latvian <code>nb_NO</code> Norwegian <code>nl_NL</code> Dutch <code>nn_NO</code> Norwegian <code>pl_PL</code> Polish <code>pt_PT</code> Portuguese <code>ro_RO</code> Romanian <code>ru_RU</code> Russian <code>sk_SK</code> Slovak <code>sl_SI</code> Slovenian <code>sv_SE</code> Swedish <code>th_TH</code> Thai <code>tr_TR</code> Turkish <code>uk_UA</code> Ukrainian <code>vi_VN</code> Vietnamese <code>zh_CN</code> Simplified Chinese <code>zh_TW</code> Traditional Chinese"},{"location":"config-overview/#customize-ota-urls","title":"Customize OTA URLs","text":"<p>In case you need to change the OTA URLs to do automatic updates without internet access for tasmota, you can modify the OTA URLs:</p> <pre><code>  config:\n    displayURL-US-L: \"http://example.com/us-l.tft\"\n    displayURL-US-P: \"http://example.com/us-l.tft\"\n    displayURL-EU: \"http://example.com/us-l.tft\"\n    berryURL: \"http://exampe.com/autoexec.be\"\n</code></pre>"},{"location":"config-screensaver/","title":"Screensaver","text":""},{"location":"config-screensaver/#possible-configuration-values-for-screensaver-config","title":"Possible configuration values for screensaver config","text":"key optional type default description <code>entity</code> True string <code>weather.example</code> weather entity from homeassistant <code>entities</code> True string <code>None</code> contains a list of entities of this card (will be used instead of entity) <code>statusIcon1</code> True complex <code>None</code> status icon left to the date string, config similar to weatherOverride <code>statusIcon2</code> True complex <code>None</code> status icon right to the date string, config similar to weatherOverride <code>doubleTapToUnlock</code> True boolean <code>False</code> requires to tap screensaver two times <code>theme</code> True complex configuration for theme <code>defaultCard</code> True string <code>None</code> default page after exiting screensaver; only works with top level cards defined in cards; needs to be a navigation item, see subpages (navigate.type_key) This config option will also be evaluated as a HomeAssistant Template. <code>key</code> True string <code>None</code> Used by navigate items <code>type</code> True string <code>screensaver</code> <code>screensaver</code> or <code>screensaver2</code> <p>Example for the a screensaver config with custom entities/overrides:</p> <pre><code>    screensaver:\n      entities:\n        - entity: weather.demo_weather_north\n        - entity: weather.demo_weather_north\n          type: 0\n        - entity: weather.demo_weather_north\n          type: 1\n        - entity: weather.demo_weather_north\n          type: 2\n        - entity: sensor.energy_usage\n</code></pre> <p>Using a 6th entity will automatically activate the alternative layout.</p> <p></p> <pre><code>    screensaver:\n      entities:\n        - entity: weather.demo_weather_north\n        - entity: weather.demo_weather_north\n          type: 0\n        - entity: weather.demo_weather_north\n          type: 1\n        - entity: sensor.energy_usage\n        - entity: delete\n        - entity: sensor.indoor_temp\n          icon: mdi:home-thermometer-outline\n</code></pre> <p>You can use override the options described on the entities documentation page to override colors, names or values of the entities. </p> <p>With Version 4.0.0 there is another alternative layout for the screensaver:</p> <p>Configuration is similar, you just need to add <code>type: screensaver2</code> to switch the layout.</p> <p></p> <pre><code>    screensaver:\n      type: screensaver2\n      entities:\n        - entity: weather.demo_weather_north\n</code></pre>"},{"location":"config-screensaver/#possible-configuration-values-for-screensaver-theme-config-only-normal-screensaver-layout-not-screensaver2","title":"Possible configuration values for screensaver theme config (only normal screensaver layout not screensaver2)","text":"key option type default description <code>background</code> True list Black <code>[R, G, B]</code> <code>time</code> True list White <code>[R, G, B]</code> <code>timeAMPM</code> True list White <code>[R, G, B]</code> <code>date</code> True list White <code>[R, G, B]</code> <code>tMainText</code> True list White <code>[R, G, B]</code> <code>tForecast1</code> True list White <code>[R, G, B]</code> <code>tForecast2</code> True list White <code>[R, G, B]</code> <code>tForecast3</code> True list White <code>[R, G, B]</code> <code>tForecast4</code> True list White <code>[R, G, B]</code> <code>tForecast1Val</code> True list White <code>[R, G, B]</code> <code>tForecast2Val</code> True list White <code>[R, G, B]</code> <code>tForecast3Val</code> True list White <code>[R, G, B]</code> <code>tForecast4Val</code> True list White <code>[R, G, B]</code> <code>bar</code> True list White <code>[R, G, B]</code> <code>tMainTextAlt2</code> True list White <code>[R, G, B]</code> <code>tTimeAdd</code> True list White <code>[R, G, B]</code> <p>Specify colours as red green and blue values from 0-255 e.g. <code>[255, 0, 0]</code> for red or <code>[0, 0, 255]</code> for blue. These are translated internally to RGB565 (note that this has lower color depth so the colours may not appear the same). Also note that the screen has a low contrast ratio, so colors look sigificantly different at full display brightness and lowest brightness.</p> <p>Example for the theme config:</p> <pre><code>    screensaver:\n      theme:\n        date: [255, 0, 0]\n</code></pre> Config Example for configured statusIcons <pre><code>    screensaver:\n        entity: weather.k3ll3r\n        statusIcon1:\n          entity: switch.example_item\n        statusIcon2:\n           entity: binary_sensor.example_item\n</code></pre> <p>It is possible to increase the size of the font used for the icons by adding <code>altFont: True</code> to the statusIcon configuration. Icon/Color Overrides are also possible like on any other Entity.</p> Config Example for configured statusIcons with increased size of the icons <pre><code>    screensaver:\n        entity: weather.k3ll3r\n        statusIcon1:\n          entity: switch.example_item\n          altFont: True\n        statusIcon2:\n           entity: binary_sensor.example_item\n           altFont: True\n</code></pre> Config Example for all white icons on screensaver <pre><code>    screensaver:\n      entities:\n        - entity: weather.demo_weather_north\n        - entity: weather.demo_weather_north\n          type: 0\n      color: [255,255,255]\n        - entity: weather.demo_weather_north\n          type: 1\n      color: [255,255,255]\n        - entity: weather.demo_weather_north\n          type: 2\n      color: [255,255,255]\n        - entity: weather.demo_weather_north\n          type: 3\n      color: [255,255,255]\n</code></pre> Config Example for a custom date format on forecast <pre><code>   screensaver:\n      entities:\n        - entity: weather.demo_weather_north\n        - entity: weather.demo_weather_north\n          type: 0\n          name: \"%a %-d/%-m\"\n        - entity: weather.demo_weather_north\n          type: 1\n          name: \"%a %-d/%-m\"\n        - entity: weather.demo_weather_north\n          name: \"%a %-d/%-m\"\n          type: 2\n        - entity: weather.demo_weather_north\n          name: \"%a %-d/%-m\"\n          type: 3\n</code></pre>  See Babel Documentation (https://babel.pocoo.org/en/latest/dates.html#date-fields) or the Python Documenation (https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes) in case you do not have babel installed."},{"location":"configure_mqtt/","title":"Configure MQTT","text":""},{"location":"configure_mqtt/#configure-mqtt-on-tasmota","title":"Configure MQTT on Tasmota","text":"<p>Configure your MQTT Server in Tasmota. See Tasmota MQTT Documentation for more details.</p> <p></p> <p>Please leave the Full Topic as it is in default configuration (and on the screenshot).</p> <p>Change the topic to something unique for your panel, you will need this topic later in the configuration of your panel in appdaemon / apps.yaml</p>"},{"location":"configure_mqtt/#note-for-appdeamon-addon-version-15","title":"Note for Appdeamon Addon Version &gt;= 15","text":"<p>The configuration has been moved out of the config folder from homeassistant. This is how you can access it with the VSCode Addon.</p> <p></p> <p></p>"},{"location":"configure_mqtt/#configure-mqtt-connection-on-appdaemon","title":"Configure MQTT Connection on AppDaemon","text":"<p>For the app to work you need a working MQTT Configuration in AppDaemon. Please add the configuration of your mqtt server, user and password to your existing <code>appdaemon.yaml</code> Restart your AppDaemon Container (not HomeAssistant) after adding the MQTT Configuration.</p> <p>You will find this file in the following location: <code>/addon_configs/a0d7b954_appdaemon/appdeamon.yaml</code></p> <pre><code>---\nsecrets: /homeassistant/secrets.yaml\nappdaemon:\n  latitude: 52.0\n  longitude: 4.0\n  elevation: 2\n  time_zone: Europe/Berlin\n  app_dir: /homeassistant/appdaemon/apps/ # !!! This is really important for AppDaemon HA Addon &gt;= 15\n  plugins:\n    HASS:\n      type: hass\n    MQTT:\n      type: mqtt\n      namespace: mqtt\n      client_id: \"appdaemon\"\n      client_host: core-mosquitto.local.hass.io # This should work if you are using supervised HomeAssistant; if not use the IP Address instead.\n      #client_host: 192.168.75.30\n      client_port: 1883\n      client_user: \"mqttuser\"\n      client_password: \"mqttpassword\"\n      client_topics: NONE\nhttp:\n  url: http://127.0.0.1:5050\nadmin:\napi:\nhadashboard:\n</code></pre>"},{"location":"configure_mqtt/#configure-nspanel-on-appdaemon","title":"Configure NsPanel on AppDaemon","text":"<p>Please add the following minimal configuration to your apps.yaml, which is located in <code>config/appdaemon/apps/apps.yaml</code></p> <p>Note: You need to move your <code>apps.yaml</code> to this location if it isn't there.</p> <pre><code>---\nnspanel-1:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/tasmota_your_mqtt_topic/RESULT\"\n    panelSendTopic: \"cmnd/tasmota_your_mqtt_topic/CustomSend\"\n    model: eu\n</code></pre> <p>Please adjust <code>tasmota_your_mqtt_topic</code> to the topic used in Tasmota MQTT Configuration.</p> <p>If your configuration is correct you should get the following screens on your panel:</p> <p></p> Note: You can add multiple panels to this configuration: <pre><code>---\nnspanel-1:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/first-nspanel-topic/RESULT\"\n    panelSendTopic: \"cmnd/first-nspanel-topic/CustomSend\"\nnspanel-2:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/second-nspanel-topic/RESULT\"\n    panelSendTopic: \"cmnd/second-nspanel-topic/CustomSend\"\n</code></pre>"},{"location":"entities/","title":"Special Settings for Entities","text":""},{"location":"entities/#entities","title":"Entities","text":"<p>Entities are mainly used on cardEntities and cardGrid.</p> <p>It is possible to overwrite and configure varrious things on Entities.</p>"},{"location":"entities/#possible-configuration-values-for-entities-key","title":"Possible configuration values for entities key:","text":"key optional type default description <code>entity</code> False string <code>None</code> name of ha entity <code>name</code> True string <code>None</code> Used to override names (supports home assistant templates) <code>value</code> True string <code>None</code> Used to override the value (supports home assistant templates) <code>icon</code> True string <code>None</code> Used to override icons <code>color</code> True array <code>None</code> Overwrite color of entity <code>color: [255, 0, 0]</code> <code>state</code> True string <code>None</code> Only displayed if Entity state is equal to this value <code>state_not</code> True string <code>None</code> Only displayed if Entity state is unequal to this value <code>status</code> True string <code>None</code> Only valid for navigate and service items, adds a entity to track state for the icon <code>assumed_state</code> True string <code>None</code> Only for cover items, up, down and stop buttons are always shown <code>action_name</code> True string <code>None</code> Only valid for script; Button label <code>font</code> True string <code>None</code> Used to change the font for cardGrid Icons; valid values are (<code>small</code>, <code>medium-icon</code> and <code>medium</code>). Currently only supported for homeassistant entities and not for internal ones. <code>effectList</code> True string <code>None</code> Only valid for light; for example <code>[Android, Aurora</code> (fav list for effects)"},{"location":"entities/#override-icons-or-names","title":"Override Icons or Names","text":"<p>To overwrite Icons or Names of entities you can configure an icon and/or name in your configuration, please see the following example. Only the icons listed in the Icon Cheatsheet are useable.</p> <pre><code>        entities:\n          - entity: light.test_item\n            name: NameOverride\n            icon: mdi:lightbulb\n</code></pre> <p>It is also possible to configure different icon overwrites per state:</p> <pre><code>            icon:\n                \"on\": mdi:lightbulb\n                \"off\": mdi:lightbulb\n</code></pre> <p>It is also possible to configure different color overwrites per state:</p> <p></p><pre><code>            color:\n                \"on\": [255,0,0]\n                \"off\": [0,0,255]\n</code></pre> Dynamic color overwrites using homeassistant templates: <pre><code>            color: '{{iif(states(\"binary_sensor.test\")==\"on\", \"[0,255,0]\", \"[255,165,0]\")}}'\n</code></pre> <p>It is also possible to use text instead of icons with <code>text:X</code></p> <pre><code>            icon:\n                \"on\": mdi:lightbulb\n                \"off\": \"text:\"\n</code></pre> <p>Note: State Overrides are working with all state values, not only with \"on\" and \"off\".</p> <p>To insert dynamic values from a homeassistant template, like a temperature you can also use <code>ha:</code> which will be rendered as homeassistant template. There probably not much cases where this is needed, but here is an exmaple to show the current temperature on the status icon of the screensaver:</p> <pre><code>      statusIcon2:\n        entity: climate.wohnzimmer_boden\n        icon: 'ha:{{ state_attr(\"climate.wohnzimmer_boden\",\"current_temperature\")}}'\n</code></pre> <p>If you want to display icons from a template you can put them between <code>&lt;I&gt;&lt;/I&gt;</code></p> <pre><code>        icon: 'ha:{{ iif(is_state('light.kitchen', 'on'), '&lt;I&gt;mdi:flashlight&lt;/I&gt;', '&lt;I&gt;mdi:flashlight-off&lt;/I&gt;') }}'\n</code></pre>"},{"location":"entities/#hide-item-based-on-state","title":"Hide item based on state","text":"<p>This sensor will only be shown on the card if it's state is equal to <code>off</code></p> <pre><code>      - entity: binary_sensor.sensor_bad_contact\n        state: \"off\"\n</code></pre> <p>This sensor will only be shown on the card if it's state is not equal to <code>on</code></p> <pre><code>      - entity: binary_sensor.sensor_kueche_contact\n        state_not: \"on\"\n</code></pre>"},{"location":"entities/#hide-item-based-on-ha-template","title":"Hide item based on HA Template","text":"<p>The template must evaluate to <code>true</code> for the entity to hide.</p> <pre><code>      - entity: binary_sensor.sensor_kueche_contact\n        state_template: '{{ state_attr(\"sun.sun\",\"azimuth\") &lt; 200 }}'\n</code></pre>"},{"location":"entities/#calling-service-directly-as-button","title":"Calling service directly as button","text":"<p>The following example shows how to call services directly, this enables you to call services on entities not (yet) supported by the backend and also to pass data to services.</p> <pre><code>    - entity: service.light.turn_on\n      data:\n        entity_id: light.schreibtischlampe\n        color_name: \"green\"\n</code></pre>"},{"location":"faq/","title":"FAQ","text":""},{"location":"faq/#faq-frequently-asked-questions","title":"FAQ - Frequently Asked Questions","text":""},{"location":"faq/#waiting-for-content-this-is-taking-longer-than-usual-on-the-screen","title":"Waiting for content - This is taking longer than usual on the screen","text":"<p>You have most likely an error in your MQTT configuration somewhere. To find the error follow theese steps:</p> <ol> <li> <p>Check the location of your apps.yaml With the AppDaemon Addon &gt;= 15 the config dir has been moved. It's required to configure the location back to the old one, this is done by the <code>app_dir</code> line in your <code>appdaemon.yaml</code>. This also requires you to move your apps.yaml to this location. Please make sure your apps.yaml is at <code>/config/appdaemon/apps/apps.yaml</code> and move it otherwise.</p> </li> <li> <p>Check your appdaemon log. (Settings &gt; Add-ons &gt; AppDaemon &gt; Log) You should see something like this: <code>INFO MQTT: MQTT Plugin initialization complete</code> If you are seeing Messages like this: <code>CRITICAL MQTT: Could not complete MQTT Plugin initialization, for Connection was refused due to Not Authorised</code> Your appdaemon mqtt config is wrong, check your appdaemon.yaml. The log of your mqtt broker might give you additional information.  </p> </li> <li> <p>Check MQTT Configuration of Tasmota. Your Tasmota device needs to connect sucessfully to your MQTT Broker, if you are in the waiting for content screen, the panel will send periodic messages to it's mqtt topic. Note that there is a minimum password length of 5 chars for the MQTT Connection in Tasmota.</p> </li> <li> <p>Make sure that you are using the same topic in apps.yaml and in your tasmota configuration.  The examples in the docs (MQTT Config) are an valid example (tasmota&lt;&gt;apps.yaml). Please don't modify the Full Topic in your Tasmota Config, unless you know the implications, changing the Full Topic will result in diffent Send and Receive Channels, that have to be correct in your apps.yaml.</p> </li> <li> <p>If you are still in the waiting for content screen please share the following items, with the Waiting for Content Issue type on the Github Issues Page</p> <ul> <li>a screenshot of your tasmota mqtt configration (please censor your mqtt password)</li> <li>your appdaemon.yaml (please censor your mqtt password)</li> <li>your apps.yaml</li> <li>the appdaemon log, after restarting the container</li> </ul> </li> </ol>"},{"location":"faq/#how-to-update","title":"How to update","text":""},{"location":"faq/#update-appdaemon-script","title":"Update AppDaemon Script","text":"<p>HACS will show you that there is an update avalible and ask you to update. It is important to restart the AppDaemon Container afterwards.</p>"},{"location":"faq/#update-display-firmware","title":"Update Display Firmware","text":"<p>You should get an notification on the screen, asking you to update the firmware. In case you want to update manually you can use the following commands.</p> <p>EU Version: <code>FlashNextion http://nspanel.pky.eu/lui-release.tft</code></p> <p>US Version Portrait: <code>FlashNextion http://nspanel.pky.eu/lui-us-p-release.tft</code></p> <p>US Version Landscape: <code>FlashNextion http://nspanel.pky.eu/lui-us-l-release.tft</code></p>"},{"location":"faq/#update-tasmota-berry-driver","title":"Update Tasmota Berry Driver","text":"<p>You should get an notification on the screen, asking you to update the driver, if an update is needed.</p> <p>You can update the berry driver directly from the Tasmota Console with the following command.</p> <p><code>UpdateDriverVersion https://raw.githubusercontent.com/joBr99/nspanel-lovelace-ui/main/tasmota/autoexec.be</code></p>"},{"location":"faq/#how-to-upgrade-from-a-release-to-the-current-development-version","title":"How to upgrade from a release to the current development version","text":"<ol> <li>Update App in HACS to main</li> </ol> <p>Click redownload in the menu of the app in HACS.</p> <p>Select main version.</p> <p>!!! Wait for it to load, dropdown needs to be selectable again, otherwise it will download the latest release !!!</p> <p></p> <p>!!! Wait for it to load, dropdown needs to be selectable again, otherwise it will download the latest release !!!</p> <p>Click download.</p> <ol> <li> <p>Restart AppDaemon</p> </li> <li> <p>Flash current Development Firmware in Tasmota Console. DO NOT USE THIS VERSION/URLS IF YOUR ARE NOT ON THE DEVELOPMENT VERSION</p> </li> </ol> <p>EU VERSION: <code>FlashNextion http://nspanel.pky.eu/lui.tft</code></p> <p>Development happens in the EU version, so it is possible that the US Version isn't up to date with the current development version of the EU firmware, the lastet US versions are still downloadable with the following links:</p> <p>US LANDSCAPE: <code>FlashNextion http://nspanel.pky.eu/lui-us-l.tft</code></p> <p>US PORTRAIT: <code>FlashNextion http://nspanel.pky.eu/lui-us-p.tft</code></p>"},{"location":"hmi-serial-protocol/","title":"NSPanel Lovelace UI","text":""},{"location":"hmi-serial-protocol/#nspanel-lovelace-ui","title":"NSPanel Lovelace UI","text":"<p>The HMI Project of this project is only used to display stuff, navigation ist mostly up to the backend. This allows to be way more flexible.</p> <p>Messages to the Panel can be send through the Command <code>CustomSend</code>, which is implemented in the berry driver. You can issue this command through MQTT by sending messages to the <code>cmnd/XXX/CustomSend</code> Topic. Messages from the Panel are send to the <code>tele/XXX/RESULT</code> Topic, encoded in json <code>{\"CustomRecv\":\"message_from_screen\"}</code></p>"},{"location":"hmi-serial-protocol/#table-of-contents","title":"Table of contents","text":"<ul> <li>Startup<ul> <li>Some preperation before we are acually navigating away:</li> <li>Navigate from the startup page to the screensaver, by sending this command to the CustomSend Topic.</li> <li>Exit Screensaver</li> </ul> </li> <li>Messages to Nextion Display<ul> <li>General Commands, implemented on all pages</li> <li>screensaver page</li> <li>cardEntities Page</li> <li>cardGrid Page</li> <li>cardMedia</li> <li>cardThermo</li> <li>cardAlarm</li> <li>cardQR</li> <li>cardPower</li> </ul> </li> </ul>"},{"location":"hmi-serial-protocol/#startup","title":"Startup","text":"<p>On startup the panel will send <code>{\"CustomRecv\":\"event,startup,39,eu\"}</code> every few seconds.</p> <pre><code>event,   #Every message from the screen will start with `event`\nstartup, #Startup Event\n39,      #Current HMI Project Version\neu       #Current HMI Project Model\n</code></pre> <p>You can answer this message in many different ways, but in general the goal is to navigate way from the startup page. In the following example we will navigate to the screensaver page.</p> <p>Send the following messages to the CustomSend Topic. (You can also send them on tasmota console for testing)</p>"},{"location":"hmi-serial-protocol/#some-preperation-before-we-are-acually-navigating-away","title":"Some preperation before we are acually navigating away:","text":"<p>Send this every minute: <code>time~18:17</code></p> <p>Send this at least once at midnight: <code>date~Donnerstag, 25. August 2022</code></p> <p>Send theese message once after receiving the startup event (parameters will be explained later):</p> <p><code>timeout~20</code></p> <p><code>dimmode~10~100~6371</code></p>"},{"location":"hmi-serial-protocol/#navigate-from-the-startup-page-to-the-screensaver-by-sending-this-command-to-the-customsend-topic","title":"Navigate from the startup page to the screensaver, by sending this command to the CustomSend Topic.","text":"<p><code>pageType~screensaver</code></p> <p>After sending this command you should already see the time and date. To also show weather data you have to send them with weatherUpdate, but we will skip this for now.</p>"},{"location":"hmi-serial-protocol/#exit-screensaver","title":"Exit Screensaver","text":"<p>Touching the panel on the screensaver will result in this MQTT Message on the result topic:</p> <p><code>event,buttonPress2,screensaver,bExit,1</code></p> <p>You can answer this by sending theese commands to the CustomSend Topic.</p> <p><code>pageType~cardEntities</code></p> <p><code>entityUpd~test~~button~navigate.prev~&lt;~65535~~~button~navigate.next~&gt;~65535~~~~light~light.schreibtischlampe~X~17299~Schreibtischlampe~0~text~sensor.server_energy_power~Y~17299~Server ENERGY Power~155 W~shutter~cover.rolladenfenster_cover_1~Z~17299~Fenster Eingang~A|B|C|disable|enable|enable~switch~switch.bad~D~63142~Bad~1</code></p>"},{"location":"hmi-serial-protocol/#messages-to-nextion-display","title":"Messages to Nextion Display","text":""},{"location":"hmi-serial-protocol/#general-commands-implemented-on-all-pages","title":"General Commands, implemented on all pages","text":"<p>set brightness of screensaver and active-brightness:</p> <p><code>dimmode~0~100 - (screen off)</code></p> <p><code>dimmode~100~100 - (screen on with full brightness)</code></p> <p>set current time:</p> <p><code>time~22:26</code></p> <p>set current date:</p> <p><code>date~Di 24. Februar</code></p> <p>set screensaver timeout (set time in sec~ max 65):</p> <p><code>timeout~15 - timeout after 15 seconds</code></p> <p><code>timeout~0 - disable screensaver</code></p> <p>change the page type:</p> <p><code>pageType~pageStartup</code></p> <p><code>pageType~cardEntities</code></p> <p><code>pageType~cardThermo</code></p> <p><code>pageType~cardMedia</code></p> <p><code>pageType~popupLight~Schreibtischlampe~light.schreibtischlampe</code></p> <p><code>pageType~popupNotify</code></p> <p><code>pageType~screensaver</code></p>"},{"location":"hmi-serial-protocol/#screensaver-page","title":"screensaver page","text":"Parameter Number Category Location Type Field Addional Information 0 instruction instruction weatherupdate 1 Main Icon Entity Definition type ignored 2 intNameEntity ignored 3 icon 4 iconColor 5 displayName ignored 6 optionalValue 7 First Forecast Icon Entity Definition type ignored 8 intNameEntity ignored 9 icon 10 iconColor 11 displayName 12 optionalValue 13 Second Forecast Icon Entity Definition type ignored 14 intNameEntity ignored 15 icon 16 iconColor 17 displayName 18 optionalValue 19 Third Forecast Icon Entity Definition type ignored 20 intNameEntity ignored 21 icon 22 iconColor 23 displayName 24 optionalValue 25 Fourth Forecast Icon Entity Definition type ignored 26 intNameEntity ignored 27 icon 28 iconColor 29 displayName 30 optionalValue 31 Alternative Layout Icon Entity Definition type ignored 32 intNameEntity ignored 33 icon 34 iconColor 35 displayName ignored 36 optionalValue <p><code>color~background~tTime~timeAMPM~tDate~tMainText~tForecast1~tForecast2~tForecast3~tForecast4~tForecast1Val~tForecast2Val~tForecast3Val~tForecast4Val~bar~tMainTextAlt2~tTimeAdd</code></p> Parameter Number Category Location Type Field Addional Information 0 instruction color 1 background 2 tTime 3 timeAMPM 4 tDate 5 tMainText 6 tForecast1 7 tForecast2 8 tForecast3 9 tForecast4 10 tForecast1Val 11 tForecast2Val 12 tForecast3Val 13 tForecast4Val 14 bar 15 tMainTextAlt2 16 tTimeAdd <p><code>notify~heading~text</code></p> <p><code>statusUpdate~icon1~icon1Color~icon2~icon2~icon2color~icon1font~icon2font</code></p>"},{"location":"hmi-serial-protocol/#cardentities-page","title":"cardEntities Page","text":"<p>Structure (Category): <code>entityUpd~title~[navigation]~[entity_information]</code> Example with 4 Entities:  </p><pre><code>entityUpd~LightTest~button~navigate.prev~&lt;~65535~~~button~navigate.next~&gt;~65535~~~light~light.bed_light~A~17299~Bed Light~0~light~light.ceiling_lights~B~52231~Ceiling Lights~1~switch~switch.ac~C~17299~AC~0~switch~switch.decorative_lights~D~65222~Decorative Lights~1\n</code></pre> <p>Possible entities on cardEntities/cardGrid:</p> <p><code>~light~light.entityName~1~17299~Light1~0</code></p> <p><code>~shutter~cover.entityName~0~17299~Shutter2~iconUp|iconStop|iconDown</code></p> <p><code>~delete~~~~~</code></p> <p><code>~text~sensor.entityName~3~17299~Temperature~content</code></p> <p><code>~button~button.entityName~3~17299~bt-name~bt-text</code></p> <p><code>~switch~switch.entityName~4~17299~Switch1~0</code></p> <p><code>~number~input_number.entityName~4~17299~Number123~value|min|max</code></p> <p><code>~input_sel~input_select.entityName~3~17299~sel-name~sel-text</code></p> Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title title 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 Entities First Entity Entity Definition type 15 intNameEntity 16 icon 17 iconColor 18 displayName 19 optionalValue 20 Second Entity Entity Definition type 21 intNameEntity 22 icon 23 iconColor 24 displayName 25 optionalValue 26 Thrid Entity Entity Definition type 27 intNameEntity 28 icon 29 iconColor 30 displayName 31 optionalValue 32 Forth Entiry Entity Definition type 33 intNameEntity 34 icon 35 iconColor 36 displayName 37 optionalValue 38 Fifth Entiy (US Portrait\u00a0\u00a0\u00a0Version) Entity Definition type 39 intNameEntity 40 icon 41 iconColor 42 displayName 43 optionalValue 44 Sixth Entiy (US Portrait\u00a0\u00a0\u00a0Version) Entity Definition type 45 intNameEntity 46 icon 47 iconColor 48 displayName 49 optionalValue"},{"location":"hmi-serial-protocol/#cardgrid-page","title":"cardGrid Page","text":"<p>cardGrid is using the exact same messageformat like cardEntities does. The only difference is, it ignores the information supplied in optionalValue, because it isn't needed for cardGrid.</p> Parameter\u00a0\u00a0\u00a0Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title title 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 Entities First Entity Entity Definition type 15 intNameEntity 16 icon 17 iconColor 18 displayName 19 optionalValue ignored 20 Second Entity Entity Definition type 21 intNameEntity 22 icon 23 iconColor 24 displayName 25 optionalValue ignored 26 Thrid Entity Entity Definition type 27 intNameEntity 28 icon 29 iconColor 30 displayName 31 optionalValue ignored 32 Forth Entiry Entity Definition type 33 intNameEntity 34 icon 35 iconColor 36 displayName 37 optionalValue ignored 38 Fifth Entiy (US Portrait\u00a0\u00a0\u00a0Version) Entity Definition type 39 intNameEntity 40 icon 41 iconColor 42 displayName 43 optionalValue ignored 44 Sixth Entiy (US Portrait\u00a0\u00a0\u00a0Version) Entity Definition type 45 intNameEntity 46 icon 47 iconColor 48 displayName 49 optionalValue ignored"},{"location":"hmi-serial-protocol/#cardmedia","title":"cardMedia","text":"<p>Example without icons in bottom row: <code>entityUpd~Kitchen~button~navigation.up~U~65535~~~delete~~~~~~media_player.kitchen~I'm a Hurricane~~Wellmess~~100~A~64704~B~media_pl~media_player.kitchen~C~17299~Kitchen~</code></p> Parameter\u00a0\u00a0\u00a0Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title title 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 cardMedia specific cardMedia specific intNameEntity 15 1st text row title 16 titleColor 17 2nd text row author 18 authorColor 19 slider volume 0-100 20 icon middle playPauseIcon 21 icon right side onOffBtn \"disable\" or color 22 icon left side iconShuffle \"disable\" or icon 23 Entities upper left corner media\u00a0\u00a0\u00a0icon Entity Definition type 24 intNameEntity 25 icon 26 iconColor 27 displayName only used for popups 28 optionalValue ignored 29 First Entity Entity Definition type 30 intNameEntity 31 icon 32 iconColor 33 displayName only used for popups 34 optionalValue ignored 35 Second Entity Entity Definition type 36 intNameEntity 37 icon 38 iconColor 39 displayName only used for popups 40 optionalValue ignored 41 Thrid Entity Entity Definition type 42 intNameEntity 43 icon 44 iconColor 45 displayName only used for popups 46 optionalValue ignored 47 Forth Entiry Entity Definition type 48 intNameEntity 49 icon 50 iconColor 51 displayName only used for popups 52 optionalValue ignored 53 Fifth Entiy Entity Definition type 54 intNameEntity 55 icon 56 iconColor 57 displayName only used for popups 58 optionalValue ignored"},{"location":"hmi-serial-protocol/#cardthermo","title":"cardThermo","text":"<p>Serial Protocol of cardThermo is about to change; table will be completed later</p> Parameter Number Location Type Field Addional Information 0 instruction entityUpd 1 title title title 2 Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 intNameEntity 15 2nd text box currentTemp 16 target temperature dstTemp multiplied by 10 17 Text 4th Box Left Side status 18 Min Temp minTemp multiplied by 10 19 Max Temp maxTemp multiplied by 10 20 Temperature Steps tempStep multiplied by 10 21 bottom hvac_action 1 Hvac Action icon 22 iconColorActive 23 buttonState 24 intName 25 bottom hvac_action 2 Hvac Action icon 26 iconColorActive 27 buttonState 28 intName 29 bottom hvac_action 3 Hvac Action icon 30 iconColorActive 31 buttonState 32 intName 33 bottom hvac_action 4 Hvac Action icon 34 iconColorActive 35 buttonState 36 intName 37 bottom hvac_action 5 Hvac Action icon 38 iconColorActive 39 buttonState 40 intName 41 bottom hvac_action 6 Hvac Action icon 42 iconColorActive 43 buttonState 44 intName 45 bottom hvac_action 7 Hvac Action icon 46 iconColorActive 47 buttonState 48 intName 49 bottom hvac_action 8 Hvac Action icon 50 iconColorActive 51 buttonState 52 intName 53 Currently Label 1th Text Box tCurTempLbl 54 State Label 3th Text Box tStateLbl 55 tALbl deprecated; ignored 56 Temperature Unit (Celcius/Farhenheit) tCF 57 Second Destination Tempature (Heat/Cool) second temp ; multiplied by 10 58 additonal detail button to open another page btDetail \"1\" to hide"},{"location":"hmi-serial-protocol/#cardalarm","title":"cardAlarm","text":"Parameter Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title title 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 cardAlarm specific card intNameEntity intNameEntity 15 1st button right side displayName 16 intId 17 2nd button right side displayName 18 intId 19 3rd button right side displayName 20 intId 21 4th button right side displayName 22 intId 23 icon next to code display icon 24 iconColor 25 numpad numpadStatus \"disable\" or \"enable\" 26 flashing of icon next to code flashing status \"enable\" or \"disable\" 27 button bottom left corner icon 28 iconColor 29 intNameEntity"},{"location":"hmi-serial-protocol/#cardqr","title":"cardQR","text":"<p>Example: <code>entityUpd~Guest Wifi~button~navigate.prev~&lt;~65535~~~button~navigate.next~&gt;~65535~~~WIFI:S:test_ssid;T:WPA;P:test_pw;;~text~iText.test_ssid~\ufffd\ufffd\ufffd~17299~Name~test_ssid~text~iText.test_pw~\ufffd\ufffd\ufffd~17299~Password~test_pw</code></p> Parameter\u00a0\u00a0\u00a0Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title intNameEntity 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 cardQR specific qrcode text 15 Entities 1st Entity Entity Definition type 16 intNameEntity 17 icon 18 iconColor 19 displayName 20 optionalValue 21 2nd Entity Entity Definition type 22 intNameEntity 23 icon 24 iconColor 25 displayName 26 optionalValue"},{"location":"hmi-serial-protocol/#cardpower","title":"cardPower","text":"<p><code>entityUpd~PowerTest~x~navUp~A~65535~~~delete~~~~~~text~sensor.power_consumption~B~17299~Power consumption~100W~1~text~sensor.power_consumption~C~17299~Power consumption~100W~1~text~sensor.today_energy~D~17299~Total energy 1~5836.0kWh~0~delete~~~~~~0~text~sensor.today_energy~E~17299~Total energy 1~5836.0kWh~-30~delete~~~~~~0~text~sensor.today_energy~F~65504~Total energy 1~5836.0kWh~90~text~sensor.today_energy~G~17299~Total energy 1~5836.0kWh~10</code></p> Parameter Number Location Type Field Addional Information 0 instruction entityUpd 1 title title title 2 Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 Home Icon / Value below Home Icon Entity Definition type ignored 15 intNameEntity ignored 16 icon 17 iconColor 18 displayName 19 optionalValue 20 speed ignored 21 Value above Home Icon Entity Definition type ignored 22 intNameEntity ignored 23 icon ignored 24 iconColor ignored 25 displayName ignored 26 optionalValue 27 speed ignored 28 1st Item Upper Left Entity Definition type ignored 29 intNameEntity ignored 30 icon 31 iconColor 32 displayName 33 optionalValue 34 speed numbers (between -120 and 120) 35 2nd Item Middle Left Entity Definition type ignored 36 intNameEntity ignored 37 icon 38 iconColor 39 displayName 40 optionalValue 41 speed numbers (between -120 and 120) 42 3rd Item Bottom Left Entity Definition type ignored 43 intNameEntity ignored 44 icon 45 iconColor 46 displayName 47 optionalValue 48 speed numbers (between -120 and 120) 49 4th Item Upper Right Entity Definition type ignored 50 intNameEntity ignored 51 icon 52 iconColor 53 displayName 54 optionalValue 55 speed numbers (between -120 and 120) 56 5th Item Middle Right Entity Definition type ignored 57 intNameEntity ignored 58 icon 59 iconColor 60 displayName 61 optionalValue 62 speed numbers (between -120 and 120) 63 6th Item Bottom Right Entity Definition type ignored 64 intNameEntity ignored 65 icon 66 iconColor 67 displayName 68 optionalValue 69 speed numbers (between -120 and 120)"},{"location":"hmi-serial-protocol/#cardchart-page","title":"cardChart Page","text":"<p><code>entityUpd~heading~navigation~color~yAxisLabel~yAxisTick:[yAxisTick]*[~value[:xAxisLabel]?]*</code> </p> <p><code>entityUpd~Chart Demo~~button~navigate.prev~&lt;~65535~~~button~navigate.next~&gt;~65535~~~~6666~Gas [kWh]~20:40:60:80:100~10~7^2:00~7~6^4:00~6~7^6:00~0~7^8:00~5~1^10:00~1~10^12:00~5~6^14:00~8</code></p>"},{"location":"hmi-serial-protocol/#popuplight-page","title":"popupLight Page","text":"<p><code>entityUpdateDetail~entityName~*ignored*~*iconColor*~*buttonState*~*sliderBrightnessPos*~*sliderColorTempPos*~*colorMode*~*color_translation*~*color_temp_translation*~*brightness_translation*</code></p> <p><code>entityUpdateDetail~1~17299~1~100~78~enable</code></p> <p><code>entityUpdateDetail~1~17299~1~100~disable</code></p>"},{"location":"hmi-serial-protocol/#popupshutter-page","title":"popupShutter Page","text":"<p><code>entityUpdateDetail~entityName~*sliderPos*~2ndrow~textPosition~icon1~iconUp~iconStop~iconDown~iconUpStatus~iconStopStatus~iconDownStatus~textTilt~iconTiltLeft~iconTiltStop~iconTiltRight~iconTiltLeftStatus~iconTiltStopStatus~iconTiltLeftStatus~tiltPos</code></p> <p><code>entityUpdateDetail~1~77</code></p>"},{"location":"hmi-serial-protocol/#popupnotify-page","title":"popupNotify Page","text":"<p><code>entityUpdateDetail~*internalName*~*tHeading*~*tHeadingColor*~*b1*~*tB1Color*~*b2*~*tB2Color*~*tText*~*tTextColor*~*sleepTimeout*~*font*~*alt_icon*~*altIconColor*</code></p> <p><code>exitPopup</code></p>"},{"location":"hmi-serial-protocol/#popupthermo-page","title":"popupThermo Page","text":"<p><code>entityUpdateDetail~{entity_id}~{icon_id}~{icon_color}~{heading}~{mode}~mode1~mode1?mode2?mode3~{heading}~{mode}~mode1~mode1?mode2?mode3~{heading}~{mode}~mode1~mode1?mode2?mode3~</code></p>"},{"location":"hmi-serial-protocol/#popupinsel-page-input_select-detail-page","title":"popupInSel Page (input_select detail page)","text":"<p><code>entityUpdateDetail2~*entity_id*~~*icon_color*~*input_sel*~*state*~*options*</code></p> <p>options are ? seperated</p>"},{"location":"hmi-serial-protocol/#popuptimer","title":"popupTimer","text":"<p>editable is 0 or 1</p> <p>action fields are in the answer on the button press</p> <p>in case action is empty the button will be hidden</p> <p><code>entityUpdateDetail~{entity_id}~~{icon_color}~{entity_id}~{min_remaining}~{sec_remaining}~{editable}~{action1}~{action2}~{action3}~{label1}~{label2}~{label3}</code></p>"},{"location":"hmi-serial-protocol/#messages-from-nextion-display","title":"Messages from Nextion Display","text":"<p><code>event,buttonPress2,pageName,bNext</code></p> <p><code>event,buttonPress2,pageName,bPrev</code></p> <p><code>event,buttonPress2,pageName,bExit,number_of_taps</code></p> <p><code>event,buttonPress2,pageName,sleepReached</code></p>"},{"location":"hmi-serial-protocol/#startup-page","title":"startup page","text":"<p><code>event,startup,version,model</code></p>"},{"location":"hmi-serial-protocol/#screensaver-page_1","title":"screensaver page","text":"<p><code>event,buttonPress2,screensaver,exit</code> - Touch Event on Screensaver</p> <p><code>event,screensaverOpen</code> - Screensaver has opened</p>"},{"location":"hmi-serial-protocol/#cardentities-page_1","title":"cardEntities Page","text":"<p><code>event,*eventName*,*entityName*,*actionName*,*optionalValue*</code></p> <p><code>event,buttonPress2,internalNameEntity,up</code></p> <p><code>event,buttonPress2,internalNameEntity,down</code></p> <p><code>event,buttonPress2,internalNameEntity,stop</code></p> <p><code>event,buttonPress2,internalNameEntity,OnOff,1</code></p> <p><code>event,buttonPress2,internalNameEntity,button</code></p>"},{"location":"hmi-serial-protocol/#popuplight-page_1","title":"popupLight Page","text":"<p><code>event,pageOpenDetail,popupLight,internalNameEntity</code></p> <p><code>event,buttonPress2,internalNameEntity,OnOff,1</code></p> <p><code>event,buttonPress2,internalNameEntity,brightnessSlider,50</code></p> <p><code>event,buttonPress2,internalNameEntity,colorTempSlider,50</code></p> <p><code>event,buttonPress2,internalNameEntity,colorWheel,x|y|wh</code></p>"},{"location":"hmi-serial-protocol/#popupshutter-page_1","title":"popupShutter Page","text":"<p><code>event,pageOpenDetail,popupShutter,internalNameEntity</code></p> <p><code>event,buttonPress2,internalNameEntity,positionSlider,50</code></p>"},{"location":"hmi-serial-protocol/#popupnotify-page_1","title":"popupNotify Page","text":"<p><code>event,buttonPress2,*internalName*,notifyAction,yes</code></p> <p><code>event,buttonPress2,*internalName*,notifyAction,no</code></p>"},{"location":"hmi-serial-protocol/#cardthermo-page","title":"cardThermo Page","text":"<p><code>event,buttonPress2,*entityName*,tempUpd,*temperature*</code></p> <p><code>event,buttonPress2,*entityName*,hvac_action,*hvac_action*</code></p>"},{"location":"hmi-serial-protocol/#cardmedia-page","title":"cardMedia Page","text":"<p><code>event,buttonPress2,internalNameEntity,media-back</code></p> <p><code>event,buttonPress2,internalNameEntity,media-pause</code></p> <p><code>event,buttonPress2,internalNameEntity,media-next</code></p> <p><code>event,buttonPress2,internalNameEntity,volumeSlider,75</code></p>"},{"location":"hmi-serial-protocol/#cardalarm-page","title":"cardAlarm Page","text":"<p><code>event,buttonPress2,internalNameEntity,actionName,code</code></p>"},{"location":"hmi-serial-protocol/#custom-protocol","title":"Custom Protocol","text":"<pre><code>55 BB [payload length] [payload length] [payload] [crc] [crc]\n</code></pre> <p>Payload length contains the number of bytes of the payload.</p> <p>CRC is \"CRC-16 (MODBUS) Big Endian\" calculated over the whole message</p> <p>This protocol does not try to implement broken JSON Commands with a specified type (lol). Instead the commands are plain text commands with parameters.</p>"},{"location":"hmi-serial-protocol/#example-for-valid-message","title":"Example for valid Message","text":"<p>This message has to be generated for the Message \"1337\" (1337 is not a valid command~ this is just an example)</p> <pre><code>55 BB  04 00  31 33 33 37  5F 5B\n</code></pre>"},{"location":"iobroker-install/","title":"Prepare ioBroker","text":""},{"location":"iobroker-install/#installation-iobroker","title":"Installation - ioBroker","text":"<p>The Backend for ioBroker is maintained by britzelpuf and armilar</p> <p>See the wiki for documentation around setting lovelace-ui up with ioBroker</p> <p>Wiki</p> <p>Also see the Readme in the ioBroker Folder.  iobroker ReadMe</p>"},{"location":"notifications/","title":"Notifications","text":""},{"location":"notifications/#sending-notifications-to-the-panel","title":"Sending Notifications to the Panel","text":"<p>There are two notification types, that can be triggered by sending a command over mqtt to the panel here are examples for homeassistant scripts:</p>"},{"location":"notifications/#seperate-page","title":"Seperate Page","text":"<p>This is the notification used by the backend for updates, opening it requires to the following commands to the CustomSend Topic:</p> <p><code>pageType popupNotify</code></p> <p><code>entityUpdateDetail~internalName~heading~headingColor~button1text~button1color~button2text~tB2Color~notificationText~textColor~sleepTimeout~fontIdText</code></p> <p>Alternative Layout with Icon:</p> <p><code>entityUpdateDetail~internalName~heading~headingColor~button1text~button1color~button2text~tB2Color~notificationText~textColor~sleepTimeout~fontIdText~icon~iconColor</code></p> <p><code>fontIdText</code> is the font used by the notification text Possible values are 0-5: </p><pre><code>Font 0 - Default - Size 24 (No Icons, Support for various special chars from different langs)\nFont 1 - Size 32 (Icons and limited chars)\nFont 2 - Size 32 (No Icons, Support for various special chars from different langs)\nFont 3 - Size 48 (Icons and limited chars)\nFont 4 - Size 80 (Icons and limited chars)\nFont 5 - Size 128 (ascii only)\n</code></pre> <p>You need to use the acual char for the icon instead of the icon name which is used in the configuration. You can get the char of the icon from the cheatsheet.</p> <p>https://docs.nspanel.pky.eu/icon-cheatsheet.html</p> <p>It is possible to exit from the page by sending <code>exitPopup</code></p> <p>If you want to add newlines to your message add this string for the newline <code>{{'\\r\\n'}}</code></p> <p>Send Message to the Panel combined with a buzzer sound:</p> <pre><code>nspanel_popup_notification:\n  alias: Popup Notification\n  sequence:\n  - service: mqtt.publish\n    data:\n      topic: cmnd/tasmota_NsPanelTerrasse/Backlog\n      payload: CustomSend pageType~popupNotify; CustomSend entityUpdateDetail~id~{{\n        title }}~65535~~~~~{{ message }}~65535~{{ timeout }}; Buzzer 2,2,2\n  mode: single\n  icon: mdi:message-badge\n</code></pre> <p>Send Message to the Panel:</p> <pre><code>nspanel_popup_notification:\n  alias: Popup Notification\n  sequence:\n  - service: mqtt.publish\n    data:\n      topic: cmnd/tasmota_NsPanelTerrasse/Backlog\n      payload: CustomSend pageType~popupNotify; CustomSend entityUpdateDetail~id~{{\n        title }}~65535~~~~~{{ message }}~65535~{{ timeout }}\n  mode: single\n  icon: mdi:message-badge\n</code></pre>"},{"location":"notifications/#notification-on-screensaver","title":"Notification on screensaver","text":"<p>The screensaver can display Notifications by sending this command to the CustomSend topic: <code>notify~heading~text</code></p> <p>Send Message to the Screensaver combined with a buzzer sound:</p> <pre><code>nspanel_screensaver_notification:\n  alias: Screensaver Notification\n  sequence:\n  - service: mqtt.publish\n    data:\n      topic: cmnd/tasmota_NsPanelTerrasse/Backlog\n      payload: CustomSend notify~{{ heading }}~{{ message }}; Buzzer 2,2,2\n  mode: single\n  icon: mdi:message-badge\n</code></pre> <p>Send Message to the Screensaver:</p> <pre><code>nspanel_screensaver_notification:\n  alias: Screensaver Notification\n  sequence:\n  - service: mqtt.publish\n    data:\n      topic: cmnd/tasmota_NsPanelTerrasse/Backlog\n      payload: CustomSend notify~{{ heading }}~{{ message }}\n  mode: single\n  icon: mdi:message-badge\n</code></pre>"},{"location":"notifications/#buzzer","title":"Buzzer","text":"<p>See Tasmota Buzzer for commands.</p> <p>It might be necessary to enable the buzzer with: </p><pre><code>BuzzerPWM 1\n</code></pre>"},{"location":"notifications/#color-picker","title":"Color Picker","text":"<p>Decimal RGB565: 0</p>"},{"location":"phys-btn/","title":"Physical Buttons","text":""},{"location":"phys-btn/#change-behaviour-of-hardware-buttons","title":"Change behaviour of hardware buttons","text":""},{"location":"phys-btn/#tasmota-rules","title":"Tasmota Rules","text":"<p>You can configure the buttons to mimic an UI element on the screen by configuring tasmota rules.</p> <p>The following rule will change the behaviour of the two buttons to do page navigation.</p> <pre><code>Rule2 on Button1#state do Publish tele/%topic%/RESULT {\"CustomRecv\":\"event,buttonPress2,navPrev,button\"} endon on Button2#state do Publish tele/%topic%/RESULT {\"CustomRecv\":\"event,buttonPress2,navNext,button\"} endon\n\nRule2 1\n</code></pre>"},{"location":"phys-btn/#decouple-buttons-from-controlling-power-outputs","title":"Decouple buttons from controlling power outputs","text":"<p>If you do not want your NSPanel physical buttons to trigger the relays and prefer to have them as software configurable buttons, open the Tasmota console of your NSPanel and enter the following:</p> <p><code>SetOption73 1</code></p> <p>Your relays will now appear as switches in HomeAssistant and you can control your buttons by using automations:</p> <p></p> <p>You may reverse this change by entering the following in the Tasmota console of your NSPanel:</p> <p><code>SetOption73 0</code></p> <p>Please note: Doing this will mean that if HomeAssistant is not working for any reason your buttons will not function correctly.</p>"},{"location":"prepare_ha/","title":"Prepare Home Assistant","text":""},{"location":"prepare_ha/#setup-home-assistant","title":"Setup Home Assistant","text":""},{"location":"prepare_ha/#installing-appdaemon","title":"Installing AppDaemon","text":"<p>The backend application for HomeAssistant is written in a python for AppDaemon.  This means it requires a working and running installation of AppDaemon.</p> <p>The easiest way to install it is through Home Assistant's Supervisor Add-on Store, it will be automaticly connected to your Home Assistant Instance.</p> <p></p> Instructions for users of HomeAssistant Core installed through docker containers.  In case you have a homeassistant setup using docker cotainers and the Add-on Store is not available to you, you can follow this guide for setting up AppDaemon. https://appdaemon.readthedocs.io/en/latest/DOCKER_TUTORIAL.html Please also pay attention to the correct volume mount for the conf folder of appdaemon, that has to point to the appdaemon folder within your homeassistant config folder.  Here is an example docker compose file for homeassistant and appdaemon:  <pre><code>version: \"3.5\"\nservices:\n  homeassistant:\n    image: ghcr.io/home-assistant/home-assistant:stable\n    container_name: homeassistant\n    network_mode: host\n    volumes:\n      - ./docker-data/homeassistant/:/config\n      - /etc/localtime:/etc/localtime:ro\n    environment:\n      - TZ=Europe/Berlin\n    privileged: true\n    restart: unless-stopped\n\n  appdaemon:\n    container_name: appdaemon\n    image: acockburn/appdaemon:4.2.3\n    environment:\n      - HA_URL=http://your-homeassistant-url:8123\n      - TOKEN=\"xxxxxx\"\n    volumes:\n      - /etc/localtime:/etc/localtime:ro\n      - ./docker-data/homeassistant/appdaemon:/conf\n    depends_on:\n      - homeassistant\n    restart: unless-stopped\n</code></pre>"},{"location":"prepare_ha/#add-babel-package-to-appdaemon-container-optional","title":"Add babel package to AppDaemon Container (Optional)","text":"<p>For localisation (date in your local language) you need to add the python package babel to your AppDaemon Installation.</p> <p></p>"},{"location":"prepare_ha/#installing-studio-code-server","title":"Installing Studio Code Server","text":"<p>You will need a way to edit the <code>apps.yaml</code> config file in the Appdaemon folder.  Install Studio Code Server from Home Assistant's Supervisor Add-on Store to easily edit configuration Files on your HomeAssistant Instance.</p>"},{"location":"prepare_ha/#installing-homeassistant-community-store","title":"Installing HomeAssistant Community Store","text":"<p>HACS is the Home Assistant Community Store and allows for community integrations and automations to be updated easily from the Home Assistant web user interface. You will be notified of updates, and they can be installed by a click on a button.</p>"},{"location":"prepare_ha/#installing-lovelace-appdaemon-backend-application","title":"Installing Lovelace AppDaemon Backend Application","text":"<p>To install Lovelace UI Backend App with HACS, you will need to make sure that you enabled AppDaemon automations in HACS, as these are not enabled by default:</p> <ol> <li>Click on <code>Configuration</code> on the left menu bar in Home Assistant Web UI</li> <li>Select <code>Devices &amp; Services</code></li> <li>Select <code>Integrations</code></li> <li>Find <code>HACS</code> and click on <code>Configure</code></li> <li>In the window that opens, make sure that <code>Enable AppDaemon apps discovery &amp; tracking</code>    is checked, or check it and click <code>Submit</code></li> <li>If you just enabled this (or just installed HACS), you might have to wait a few minutes    as all repositories are being fetched; you might hit a GitHub rate limit, which might    then require you to wait a few hours for HACS to be fully configured. In this case,    you won't be able to proceed to the next steps until HACS is ready.</li> </ol> <p>Now, to install NSPanel Lovelace UI Backend with HACS, follow these steps:</p> <ol> <li>Click on <code>HACS</code> on the left menu bar in Home Assistant Web UI</li> <li>Click on <code>Automations</code> in the right panel</li> <li>Click on <code>Explore &amp; download repositories</code> in the bottom right corner</li> <li>Search for <code>NSPanel</code>, and click on <code>NSPanel Lovelace UI Backend</code> in the list that appears</li> <li>In the bottom right corner of the panel that appears, click on    <code>Download this repository with HACS</code></li> <li>A confirmation panel will appear, click on <code>Download</code>, and wait for HACS to    proceed with the download</li> <li>The Backend Application is now installed, and HACS will inform you when updates are available</li> </ol>"},{"location":"prepare_nspanel/","title":"Prepare NsPanel","text":""},{"location":"prepare_nspanel/#flash-tasmota-to-your-nspanel","title":"Flash Tasmota to Your NSPanel","text":"<p>You need to connect to your NSPanel via serial and flash Tasmota using tasmota32-nspanel.bin. You can use the Tasmota Web Installer to do so.</p> <p>Check out Blakadder's Template Repo for more information on flashing. Do not use the autoexec.be from that page. NSPanel Page of the Tasmota Template Repository</p> <p>If you prefer ESPHome over Tasmota, you can use this third-party ESPHome component, which replaces Tasmota and the Berry driver used in this project. ESPHome Component</p>"},{"location":"prepare_nspanel/#downgrade-tasmota","title":"Downgrade Tasmota","text":"<p>Downgrade your Tasmota to version 15.0.1 - in newer versions, flashing the display currently does not work.</p> <p>https://ota.tasmota.com/tasmota32/release-15.0.1/tasmota32-nspanel.bin</p>"},{"location":"prepare_nspanel/#configure-tasmota-template-for-nspanel","title":"Configure Tasmota Template for NSPanel","text":"<p>Configure the NSPanel template for Tasmota. (Go to Configuration &gt; Configure Other, paste the template there, and make sure to tick the Activate checkbox.)</p> <p></p> <p>You can use the following template or copy the one from the Tasmota Template Repo Site:</p> <p>{\"NAME\":\"NSPanel\",\"GPIO\":[0,0,0,0,3872,0,0,0,0,0,32,0,0,0,0,225,0,480,224,1,0,0,0,33,0,0,0,0,0,0,0,0,0,0,4736,0],\"FLAG\":0,\"BASE\":1,\"CMND\":\"ADCParam 2,11200,10000,3950 | Sleep 0 | BuzzerPWM 1\"}</p> <p>After a reboot of Tasmota, your screen will light up with the stock display firmware.</p>"},{"location":"prepare_nspanel/#upload-berry-driver-to-tasmota","title":"Upload Berry Driver to Tasmota","text":"<p>Go to Consoles &gt; Console in Tasmota and execute the following command:</p> <p>Backlog UrlFetch https://raw.githubusercontent.com/joBr99/nspanel-lovelace-ui/main/tasmota/autoexec.be; SetOption151 0; Restart 1</p> <p>This downloads the autoexec.be file from the repository and restarts Tasmota.</p> <p>Note: This command also disables Matter to free up memory, as it's unlikely to be used by most Home Assistant users. (Matter can cause memory issues during flashing of the Nextion screen, but you can re-enable it later if needed.)</p>"},{"location":"prepare_nspanel/#flash-firmware-to-nextion-screen","title":"Flash Firmware to Nextion Screen","text":"<p>Due to the limitations of Berry, it's not possible to download the TFT file directly from GitHub. A small server is available to download the file via HTTP.</p> <p>Use one of the following commands in the Tasmota console (not the Berry console) to flash the latest release from this repository:</p> <p>EU Version: FlashNextion http://nspanel.pky.eu/lui-release.tft</p> <p>US Version Portrait: FlashNextion http://nspanel.pky.eu/lui-us-p-release.tft</p> <p>US Version Landscape: FlashNextion http://nspanel.pky.eu/lui-us-l-release.tft</p> <p>After sending the command, the screen should show a progress bar. The flashing process takes around 5 minutes.</p> <p>Note for US users: You'll need to add the model config option to your apps.yaml later. More details can be found on the config overview page.</p> Alternatively, you can use your own web server or the one built into Home Assistant:  Upload the nspanel.tft from the latest release to a web server (for example, the www folder of Home Assistant) and execute the following command in the Tasmota Console.   (Development version: [TFT file from HMI folder](HMI/nspanel.tft))  **The web server must be HTTP. HTTPS is not supported due to Berry language limitations in Tasmota.**  FlashNextion http://ip-address-of-your-homeassistant:8123/local/nspanel.tft"},{"location":"prepare_nspanel_ioBroker/","title":"Prepare NsPanel","text":""},{"location":"prepare_nspanel_ioBroker/#flash-tasmota-to-your-nspanel","title":"Flash Tasmota to your NSPanel","text":"<p>You need to connect to your nspanel via serial and flash tasmota tasmota32-nspanel.bin to your NSPanel.  You can use the Tasmota Web Installer to do so. Tasmota Web Installer</p> <p>Checkout Blakadders Template Repo for more information on flashing, do not use the autoexec.be from this page. NSPanel Page of the Tasmota Template Repository</p> <p>If you prefer EspHome over Tasmota, you can use this thrid party esphome component, which is replacing tasmota and the berry driver of this project. ESPHome component</p>"},{"location":"prepare_nspanel_ioBroker/#configure-tasmota-template-for-nspanel","title":"Configure Tasmota Template for NSPanel","text":"<p>Configure the NSPanel template for Tasmota. (Go to Configuration and Configure Other and paste the template there, make sure to tick the activate checkbox)</p> <p></p> <p>You can use the following template or copy the one on the Tasmota Template Repo Site.</p> <p><code>{\"NAME\":\"NSPanel\",\"GPIO\":[0,0,0,0,3872,0,0,0,0,0,32,0,0,0,0,225,0,480,224,1,0,0,0,33,0,0,0,0,0,0,0,0,0,0,4736,0],\"FLAG\":0,\"BASE\":1,\"CMND\":\"ADCParam 2,11200,10000,3950 | Sleep 0 | BuzzerPWM 1\"}</code></p> <p>After a reboot of tasmota your screen will light up with the stock display firmware.</p>"},{"location":"prepare_nspanel_ioBroker/#upload-berry-driver-to-tasmota","title":"Upload Berry Driver to Tasmota","text":"<p>Go to <code>Consoles</code> &gt; <code>Console</code> in Tasmota and execute the following command:</p> <pre><code>Backlog UrlFetch https://raw.githubusercontent.com/joBr99/nspanel-lovelace-ui/main/tasmota/autoexec.be; Restart 1\n</code></pre>"},{"location":"prepare_nspanel_ioBroker/#flash-firmware-to-nextion-screen","title":"Flash Firmware to Nextion Screen","text":"<p>Due the limitations of Berry, it's not possible to download the tft file directly from github, so I'm also renting a small server where you can download the file via HTTP.</p> <p>Use the one following commands to flash the latest release from this repository, just execute the following Command in Tasmota:</p> <p>EU Version: <code>FlashNextion http://nspanel.pky.eu/lui-release.tft</code></p> <p>US Version Portrait: <code>FlashNextion http://nspanel.pky.eu/lui-us-p-release.tft</code></p> <p>US Version Landscape: <code>FlashNextion http://nspanel.pky.eu/lui-us-l-release.tft</code></p> Alternatively you can use your own webserver:  Upload the nspanel.tft from the lastest release to a Webserver and execute the following command in Tasmota Console.  **Webserver must be HTTP, HTTPS is not supported, due to limitations of berry lang on tasmota**  `FlashNextion http://ip-address-of-your-webserver:8123/local/nspanel.tft`"},{"location":"subpages/","title":"Subpages","text":""},{"location":"subpages/#subpages","title":"Subpages","text":"<p>You can configure entities with with the prefix <code>navigate</code>, that are navigating to cards, in case it's hidden card, the navigation items will change and the arrow is bringing you back to the previous page.</p> <pre><code>          - entity: navigate.testKey\n</code></pre> <p>will allow you to navigate to a cardGrid page with the configured key testKey</p> <pre><code>    hiddenCards:\n      - type: cardGrid\n        title: Exmaple Grid\n        entities:\n          - entity: light.test_item\n        key: testKey\n</code></pre>"},{"location":"subpages/#override-status-of-navigation-items","title":"Override Status of Navigation Items","text":"<p>You can override the status of navigation items, to make them look like different entities.</p> <pre><code>          - entity: navigate.testKey\n            status: climate.test\n</code></pre>"},{"location":"subpages/#override-navigation-items-itself","title":"Override Navigation Items itself","text":"<pre><code>    cards:\n      - type: cardGrid\n        title: Wohnzimmer\n        navItem1:\n          entity: light.bad_lights\n        navItem2:\n          entity: light.bad_lights\n        entities:\n</code></pre> <p>This can be used to add an home button to your subpages:</p> <pre><code>    cards:\n      - type: cardGrid\n        title: Home\n        key: home\n        entities:\n          - entity: light.bad\n\n    hiddenCards:\n      - type: cardGrid\n        title: Wohnzimmer\n        navItem2:\n          entity: navigate.home\n          icon: mdi:home\n        entities:\n          - entity: light.kitchen\n</code></pre>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"","title":"Overview","text":""},{"location":"#overview","title":"Overview","text":"<p>If you like this project consider buying me a pizza \ud83c\udf55 </p> <p> </p> <p>NsPanel Lovelace UI is a Firmware for the nextion screen inside of NSPanel in the Design of HomeAssistant's Lovelace UI Design.</p> <p>EU Model and US Model supported (in portrait and landscape orientation)</p> <p>Content of the screen is controlled by a AppDaemon Python Script installed on your HomeAssistant Instance.</p> <p>Or an TypeScript on your ioBroker Instance in case you are an ioBroker User.</p> <p>NsPanel needs to be flashed with Tasmota (or with the 3rd Party ESPHome Component from @sairon)</p> <p></p>"},{"location":"#features","title":"Features","text":"<ul> <li>Entities Page</li> <li>Grid Page</li> <li>Detail Pages for Lights (Brightness, Temperature and Color of the Light) and for Covers (Position)</li> <li>Thermostat Page </li> <li>Media Player Card</li> <li>Alarm Control Card</li> <li>Screensaver Page with Time, Date and Weather Information</li> <li>Card with QrCode to display WiFi Information</li> <li> <p>Localization (currently 40 languages)</p> </li> <li> <p>Everything is dynamically configurable by a yaml config, no need to code or touch Nextion Editor</p> </li> </ul> <p>It works with Tasmota and MQTT.  To control the panel and update it with content from HomeAssistant there is an AppDaemon App.</p> <p>See the following picture to get an idea of the look of this firmware for NSPanel.</p> <p></p> <p>Some (not all) screenshots from the US Portrait Version:</p> <p></p>"},{"location":"#requirements","title":"Requirements","text":"<ul> <li>NSPanel</li> <li>USB to Serial TTL Adapter</li> <li>Running Instance of the Home Automation Platform of your Choise</li> <li>Running Home Assistant Instance<ul> <li>with installed MQTT Broker</li> </ul> </li> <li>Running ioBroker Instance<ul> <li>with installed MQTT Broker</li> </ul> </li> </ul>"},{"location":"card-alarm/","title":"Alarm Card","text":""},{"location":"card-alarm/#alarm-card","title":"Alarm Card","text":"<pre><code>    cards:\n      - type: cardAlarm\n        title: Alarm Test 1\n        entity: alarm_control_panel.alarmo\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>title</code> True string <code>None</code> Title of the Page <code>entity</code> False string <code>None</code> contains the entity of the current card <code>key</code> True string <code>None</code> Used by navigate items <code>alarmControl</code> True complex <code>None</code> overwrites the action executed on pressing the left bottom icon, by default this button is used to show a list of open sensors on a failed attempt to arm. <code>supportedModes</code> True list <code>None</code> Supply list of arm modes if you want to limit the modes on the card. Example <code>['arm_away', 'arm_night']</code>"},{"location":"card-climate/","title":"Climate/Thermo Card","text":""},{"location":"card-climate/#climatethermo-card","title":"Climate/Thermo Card","text":"<pre><code>    cards:\n      - type: cardThermo\n        title: HeatPump\n        entity: climate.heatpump\n      - type: cardThermo\n        title: HvaC\n        entity: climate.hvac\n      - type: cardThermo\n        title: ecobee\n        entity: climate.ecobee\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entity</code> False string <code>None</code> contains the entitiy of this card <code>title</code> True string <code>None</code> Title of the Page <code>temperatureUnit</code> True string <code>celsius</code> set this to fahrenheit to change the temperatureUnit on the page <code>key</code> True string <code>None</code> Used by navigate items in combination with the type (cardEntities_key) <code>supportedModes</code> True list <code>None</code> Supply list of heat actions if you want to limit the actions on the card. Example <code>['heat', 'off']</code>"},{"location":"card-entities/","title":"Entities Card","text":""},{"location":"card-entities/#entities-page","title":"Entities Page","text":"<pre><code>    cards:\n      - type: cardEntities\n        title: Test Entities Card\n        entities:\n          - entity: light.bed_light\n          - entity: switch.decorative_lights\n          - entity: cover.hall_window\n          - entity: sensor.outside_temperature\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entities</code> False complex <code>None</code> contains a list of entities of this card <code>title</code> True string <code>None</code> Title of the Page <code>key</code> True string <code>None</code> Used by navigate items in combination with the type (cardEntities_key) <p>List of supported entitiy types for this page:</p> <ul> <li>cover</li> <li>switch</li> <li>input_boolean</li> <li>binary_sensor</li> <li>sensor</li> <li>button</li> <li>number</li> <li>input_number</li> <li>scenes</li> <li>script</li> <li>input_button</li> <li>light</li> <li>input_text (read-only)</li> <li>input_select</li> <li>lock</li> <li>fan</li> <li>automation</li> <li>alarm</li> <li>sun</li> <li>person</li> <li>climate (status only, may be used in combination with navigate)</li> <li>iText (internal entity for showing static text)</li> <li>delete (internal entity to keep a entiy empty in the middle of the list)</li> <li>navigate (internal entity for navigation, see subpages)</li> </ul>"},{"location":"card-grid/","title":"Grid Card","text":""},{"location":"card-grid/#grid-page","title":"Grid Page","text":"<pre><code>    cards:\n      - type: cardGrid\n        title: Test Grid Card\n        entities:\n          - entity: light.bed_light\n          - entity: switch.decorative_lights\n          - entity: sensor.outside_temperature\n            name: Outside Temp\n          - entity: sensor.carbon_monoxide\n          - entity: light.entrance_color_white_lights\n            name: Entrance\n          - entity: light.office_rgbw_lights\n            name: Office RGBW\n            icon: mdi:office-building\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entities</code> False complex <code>None</code> contains a list of entities of this card <code>title</code> True string <code>None</code> Title of the Page <code>key</code> True string <code>None</code> Used by navigate items in combination with the type (cardEntities_key) <p>List of supported entitiy types for this page:</p> <ul> <li>cover</li> <li>switch</li> <li>input_boolean</li> <li>binary_sensor</li> <li>sensor</li> <li>button</li> <li>number</li> <li>input_number</li> <li>scenes</li> <li>script</li> <li>input_button</li> <li>light</li> <li>input_text (read-only)</li> <li>input_select</li> <li>lock</li> <li>fan</li> <li>automation</li> <li>alarm</li> <li>sun</li> <li>person</li> <li>climate (status only, may be used in combination with navigate)</li> <li>iText (internal entity for showing static text)</li> <li>delete (internal entity to keep a entiy empty in the middle of the list)</li> <li>navigate (internal entity for navigation, see subpages)</li> </ul>"},{"location":"card-media/","title":"Media Card","text":""},{"location":"card-media/#media-card","title":"Media Card","text":"<pre><code>    cards:\n      - type: cardMedia\n        entity: media_player.spotify\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>title</code> True string <code>None</code> Title of the Page <code>entity</code> False string <code>None</code> contains the entity of the current card <code>entities</code> False complex <code>None</code> contains a list of entities shown in the bottom row, supports all entities supported by cardGrid <code>key</code> True string <code>None</code> Used by navigate items Example with configured Entities <pre><code>      - type: cardMedia\n        title: Kitchen\n        entity: media_player.kitchen\n        entities:\n          - entity: light.bed_light\n          - entity: light.ceiling_lights\n          - entity: light.entrance_color_white_lights\n          - entity: light.kitchen_lights\n          - entity: light.living_room_rgbww_lights\n</code></pre> Example with action on upper left media icon <pre><code>      - type: cardMedia\n        title: Kitchen\n        entity: input_select.test123\n        status: media_player.kitchen\n</code></pre> Example with moved spaker selection  The icon for speaker selection is automatically appended to the end of the list and can be moved with entities in the list. With 6 entities it is possible to remove it entirely. <pre><code>      - type: cardMedia\n        title: Kitchen\n        entity: media_player.kitchen\n        entities:\n          - entity: delete\n          - entity: delete\n</code></pre>"},{"location":"card-power/","title":"Power Card","text":""},{"location":"card-power/#power-card-v39-and-higher","title":"Power Card (v3.9 and higher)","text":"<pre><code>    cards:\n      - type: cardPower\n        title: Power Test\n        entities:\n          - entity: sensor.power_consumption\n            icon: mdi:home\n          - entity: delete\n          - entity: sensor.today_energy\n            icon: mdi:car\n            speed: -20\n          - entity: delete\n          - entity: sensor.today_energy\n            icon: mdi:battery\n            speed: 20\n          - entity: delete\n          - entity: sensor.today_energy\n            icon: mdi:solar-panel\n            color: [255, 255, 0]\n            speed: 30\n          - entity: sensor.today_energy\n            speed: -40\n            icon: mdi:help\n</code></pre> <p>The first two entities are shown in the middle of the card, all other entities are used around it. Any entity overrides (e.g. icon, color) in the first entity apply to the middle of the card.</p> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entities</code> False complex <code>None</code> contains entities of the card <code>title</code> True string <code>None</code> Title of the Page <code>cooldown</code> True float <code>None</code> Rate Limit for Entity Updates to the card in Seconds (<code>cooldown: 0.5</code>) <code>key</code> True string <code>None</code> Used by navigate items <p>List of supported entitiy types for this page:</p> <ul> <li>sensor</li> </ul> <p>N.B. Negative values will likely be truncated and not display gracefully. For this reason, when measuring energy you should use the same inputs as you use on the Home Assistant Energy Dashboard (i.e. separate grid import and grid export) and similarly when measuring power.</p> <p>Some details about speed:</p> <p>Speed expects an integer input between <code>-100</code> and <code>100</code>.</p> <p>It is possible to calculate the speed through a Home Assistant template, this allows to calculate the speed in relation to other data in Home Assistant.</p> <p>This template will calculate a speed setting based on the amount of power drawn on a device as a fraction of the total power usage. </p><pre><code>            speed: &gt;-\n              {% set entity_power = states('sensor.appliance_water_heater_power') |float | round(3)%}\n              {% set total_power = states('sensor.ams_power_active') | float | round(3) %}\n              {% set entity_usage = (entity_power / total_power * 100) | float %}\n              {{ (entity_usage | round()) * -1 }}\n</code></pre> It provides the number as a negative integer, making the dot move from the middle of the card toward the entity. If you want the dot to move toward from the middle of the card, just skip inverting it at the end of the template like this: <pre><code>              {{ (entity_usage | round()) }}\n</code></pre>"},{"location":"card-qr/","title":"Wifi/QR Card","text":""},{"location":"card-qr/#wifi-qr-card","title":"WiFi / QR Card","text":"<pre><code>    cards:\n      - type: cardQR\n        title: Guest Wifi\n        qrCode: \"WIFI:S:test_ssid;T:WPA;P:test_pw;;\"\n        entities:\n          - entity: iText.test_ssid\n            name: Name\n            icon: mdi:wifi\n          - entity: iText.test_pw\n            name: Password\n            icon: mdi:key\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>entities</code> False complex <code>None</code> contains entities of the card, only valid on cardEntities and cardGrid and cardQR <code>title</code> True string <code>None</code> Title of the Page <code>key</code> True string <code>None</code> Used by navigate items <code>qrCode</code> False string <code>None</code> Value of the qrCode <p>List of supported entitiy types for this page:</p> <ul> <li>switch</li> <li>input_boolean</li> <li>binary_sensor</li> <li>sensor</li> <li>button</li> <li>scenes</li> <li>script</li> <li>input_button</li> <li>input_select</li> <li>light</li> <li>input_text (read-only)</li> <li>lock</li> <li>automation</li> </ul> <p>The qrCode value is evaluated as a homeassistant Template, so it is possible to get values from HomeAssistant within the qrCode.</p> <p><code>\"WIFI:S:{{states('input_text.test_ssid')}};T:WPA;P:{{states('input_text.test_pw')}};;\"</code></p>"},{"location":"card-unlock/","title":"Unlock Card","text":""},{"location":"card-unlock/#unlock-card-v40-and-higher","title":"Unlock Card (v4.0 and higher)","text":"<p>Can be used to navigate to create pin locked navigation to a hidden card.</p> <p></p> <pre><code>    cards:\n      - type: cardUnlock\n        pin: 1234\n        title: Admin Page\n        destination: navigate.adminpage\n    hiddenCards:\n      - type: cardGrid\n        title: Admin Page\n        key: adminpage\n        entities:\n          - entity: light.schreibtischlampe\n</code></pre> <p>List of supported config keys of this card:</p> key optional type default description <code>type</code> False string <code>None</code> Type of the card <code>title</code> True string <code>None</code> Title of the Page <code>destination</code> False string <code>None</code> contains the navigation entity this card should navigate to on unlock <code>pin</code> False string 3830 pin to unlock <code>key</code> True string <code>None</code> Used by navigate items"},{"location":"config-overview/","title":"Overview","text":""},{"location":"config-overview/#configuration","title":"Configuration","text":"<p>To confiure your NSPanel to your needs, you need to edit the <code>apps.yaml</code> inside of your Appdaemon config folder and add card and entities you want to display on the screen.</p> <p>If you've sucessfully set up mqtt, you should already have a configuration looking like this:</p> <pre><code>---\nnspanel-1:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/tasmota_your_mqtt_topic/RESULT\"\n    panelSendTopic: \"cmnd/tasmota_your_mqtt_topic/CustomSend\"\n    model: eu\n</code></pre> <p>You can continue from this point adding configuration for the weather forcecast on the screensaver, configuring a schedule for the brightness of the screensaver and your first cards.</p> <pre><code>---\nnspanel-1:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/tasmota_your_mqtt_topic/RESULT\"\n    panelSendTopic: \"cmnd/tasmota_your_mqtt_topic/CustomSend\"\n    model: eu\n    sleepTimeout: 20\n    sleepBrightness:\n      - time: \"7:00:00\"\n        value: 10\n      - time: \"23:00:00\"\n        value: 0\n    locale: \"de_DE\"\n    screensaver:\n      entity: weather.k3ll3r\n    cards:\n      - type: cardEntities\n        entities:\n          - entity: switch.example_item\n          - entity: light.example_item\n        title: Example 1\n      - type: cardGrid\n        entities:\n          - entity: switch.example_item\n          - entity: light.example_item\n        title: Example 2\n</code></pre> <p>This is the full list of configuration options supported for the config key:</p> key optional type default description <code>panelRecvTopic</code> False string <code>tele/tasmota_your_mqtt_topic/RESULT</code> The mqtt topic used to receive messages. <code>panelSendTopic</code> False string <code>cmnd/tasmota_your_mqtt_topic/CustomSend</code> The mqtt topic used to send messages. <code>updateMode</code> True string <code>auto-notify</code> Update Mode for flashing of the nextion display firmware, by default it is showing a message asking for the update after updating the backend app in HACS; Possible values: \"auto\", \"auto-notify\", \"manual\" <code>model</code> True string <code>eu</code> Model; Possible values: \"eu\", \"us-l\" and \"us-p\" <code>sleepTimeout</code> True integer <code>20</code> Timeout for the screen to enter screensaver, to disable screensaver use 0 <code>sleepBrightness</code> True integer/complex <code>20</code> Brightness for the screen on the screensaver, see example below for complex/scheduled config. <code>screenBrightness</code> True integer/complex <code>100</code> Brightness for the screen during usage, config format is the same as sleepBrightness. <code>sleepTracking</code> True string None Forces screensaver brightness to 0 in case entity state is not_home or off, can be a group, person or device_tracker entity. <code>sleepTrackingZones</code> True list <code>[\"not_home\", \"off\"]</code> Allows you to set your own states for sleepTracking <code>sleepOverride</code> True complex None Allows overriding of the sleepBrightness if entity state is on, true or home. Overrides sleepBrightness but sleepTracking takes precedence. <code>locale</code> True string <code>en_US</code> Used by babel to determinante Date format on screensaver, also used for localization. <code>dateFormatBabel</code> True string <code>full</code> formatting options on https://babel.pocoo.org/en/latest/dates.html?highlight=name%20of%20day#date-fields <code>timeFormat</code> True string <code>%H:%M</code> Time Format on screensaver. Substring after <code>?</code> is displayed in a seperate smaller textbox. Useful for 12h time format with AM/PM  <pre><code>\"%I:%M   ?%p\"</code></pre> <code>dateAdditionalTemplate</code> True string <code>\"\"</code> Addional Text dispayed after Date, can contain a Homeassistant Template Example <code>\" - {{ states('sun.sun') }}\"</code> <code>timeAdditionalTemplate</code> True string <code>\"\"</code> Addional Text dispayed below Time, can contain a Homeassistant Template <code>dateFormat</code> True string <code>%A, %d. %B %Y</code> date format used if babel is not installed <code>timezone</code> True string \"\" Timezone for the time on the panel: <code>Europe/Berlin</code> - See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for a list of TZ Identifiers (supported from upcoming version v4.4) <code>defaultBackgroundColor</code> True string ha-dark backgroud color of all cards, valid values: <code>black</code>, <code>ha-dark</code> <code>cards</code> False complex configuration for cards that are displayed on panel; see docs for cards <code>screensaver</code> True complex configuration for screensaver; see docs for screensaver <code>hiddenCards</code> True complex configuration for cards that can be accessed though navigate items; see docs for cards"},{"location":"config-overview/#details-on-sleepbrightnessscreenbrightness-and-other-configs-related-to-screen-brightness","title":"Details on sleepBrightness/screenBrightness and other configs related to screen brightness","text":"<p>It is possible to schedule a brightness change for the screen at specific times.</p> <pre><code>    sleepBrightness:\n      - time: \"7:00:00\"\n        value: 10\n      - time: \"23:00:00\"\n        value: 0\n</code></pre> <pre><code>    sleepBrightness:\n      - time: \"sunrise\"\n        value: 10\n      - time: \"sunset + 1:00:00\"\n        value: 0\n</code></pre> <p>It is also possible to use a static value or an input_number/sensor with the range between 0 and 100 as value for sleepBrightness/screenBrightness:</p> <pre><code>    sleepBrightness: input_number.brightness_nspanel\n</code></pre> <pre><code>    sleepBrightness: 50\n</code></pre> <p>The config option <code>sleepTracking</code> overrides this setting and sets the brightness to 0 if the state of the configured Home Assistant entity is <code>off</code> or <code>not_home</code>. You may also use a Home Assistant group to track multiple entities.</p> <p>The config option <code>sleepOverride</code> overrides sleepBrightness but does not take precedence over sleepTracking. This is useful if, for example, you want your NSPanel to be brighter than usual if your light is on or if you want to override a panel dimming if you are in the room.</p> <p>The following example configuration is turning off the screen after sunset, but in case the bedroom light is on the NSPanel brightness will be 20 instead of 0.</p> <pre><code>    sleepBrightness:\n      - time: \"sunrise\"\n        value: 20\n      - time: \"sunset\"\n        value: 0\n    sleepOverride:\n      entity: light.bedroomlight\n      brightness: 20\n</code></pre>"},{"location":"config-overview/#supported-keys-for-locale-config","title":"Supported keys for locale config","text":"Language Code Language <code>af_ZA</code> Afrikaans <code>ar_SY</code> Arabic <code>bg_BG</code> Bulgarian <code>ca_ES</code> Catalan <code>cs_CZ</code> Czech <code>da_DK</code> Danish <code>de_DE</code> German <code>el_GR</code> Greek <code>en_US</code> English <code>es_ES</code> Spanish <code>et_EE</code> Estonian <code>fa_IR</code> Persian <code>fi_FI</code> Finnish <code>fr_FR</code> French <code>he_IL</code> Hebrew <code>hr_xx</code> Croatian <code>hu_HU</code> Hungarian <code>hy_AM</code> Armenian <code>id_ID</code> Indonesian <code>is_IS</code> Icelandic <code>it_IT</code> Italian <code>lb_xx</code> Luxembourgish <code>lt_LT</code> Lithuanian <code>lv_LV</code> Latvian <code>nb_NO</code> Norwegian <code>nl_NL</code> Dutch <code>nn_NO</code> Norwegian <code>pl_PL</code> Polish <code>pt_PT</code> Portuguese <code>ro_RO</code> Romanian <code>ru_RU</code> Russian <code>sk_SK</code> Slovak <code>sl_SI</code> Slovenian <code>sv_SE</code> Swedish <code>th_TH</code> Thai <code>tr_TR</code> Turkish <code>uk_UA</code> Ukrainian <code>vi_VN</code> Vietnamese <code>zh_CN</code> Simplified Chinese <code>zh_TW</code> Traditional Chinese"},{"location":"config-overview/#customize-ota-urls","title":"Customize OTA URLs","text":"<p>In case you need to change the OTA URLs to do automatic updates without internet access for tasmota, you can modify the OTA URLs:</p> <pre><code>  config:\n    displayURL-US-L: \"http://example.com/us-l.tft\"\n    displayURL-US-P: \"http://example.com/us-l.tft\"\n    displayURL-EU: \"http://example.com/us-l.tft\"\n    berryURL: \"http://exampe.com/autoexec.be\"\n</code></pre>"},{"location":"config-screensaver/","title":"Screensaver","text":""},{"location":"config-screensaver/#possible-configuration-values-for-screensaver-config","title":"Possible configuration values for screensaver config","text":"key optional type default description <code>entity</code> True string <code>weather.example</code> weather entity from homeassistant <code>entities</code> True string <code>None</code> contains a list of entities of this card (will be used instead of entity) <code>statusIcon1</code> True complex <code>None</code> status icon left to the date string, config similar to weatherOverride <code>statusIcon2</code> True complex <code>None</code> status icon right to the date string, config similar to weatherOverride <code>doubleTapToUnlock</code> True boolean <code>False</code> requires to tap screensaver two times <code>theme</code> True complex configuration for theme <code>defaultCard</code> True string <code>None</code> default page after exiting screensaver; only works with top level cards defined in cards; needs to be a navigation item, see subpages (navigate.type_key) This config option will also be evaluated as a HomeAssistant Template. <code>key</code> True string <code>None</code> Used by navigate items <code>type</code> True string <code>screensaver</code> <code>screensaver</code> or <code>screensaver2</code> <p>Example for the a screensaver config with custom entities/overrides:</p> <pre><code>    screensaver:\n      entities:\n        - entity: weather.demo_weather_north\n        - entity: weather.demo_weather_north\n          type: 0\n        - entity: weather.demo_weather_north\n          type: 1\n        - entity: weather.demo_weather_north\n          type: 2\n        - entity: sensor.energy_usage\n</code></pre> <p>Using a 6th entity will automatically activate the alternative layout.</p> <p></p> <pre><code>    screensaver:\n      entities:\n        - entity: weather.demo_weather_north\n        - entity: weather.demo_weather_north\n          type: 0\n        - entity: weather.demo_weather_north\n          type: 1\n        - entity: sensor.energy_usage\n        - entity: delete\n        - entity: sensor.indoor_temp\n          icon: mdi:home-thermometer-outline\n</code></pre> <p>You can use override the options described on the entities documentation page to override colors, names or values of the entities. </p> <p>With Version 4.0.0 there is another alternative layout for the screensaver:</p> <p>Configuration is similar, you just need to add <code>type: screensaver2</code> to switch the layout.</p> <p></p> <pre><code>    screensaver:\n      type: screensaver2\n      entities:\n        - entity: weather.demo_weather_north\n</code></pre>"},{"location":"config-screensaver/#possible-configuration-values-for-screensaver-theme-config-only-normal-screensaver-layout-not-screensaver2","title":"Possible configuration values for screensaver theme config (only normal screensaver layout not screensaver2)","text":"key option type default description <code>background</code> True list Black <code>[R, G, B]</code> <code>time</code> True list White <code>[R, G, B]</code> <code>timeAMPM</code> True list White <code>[R, G, B]</code> <code>date</code> True list White <code>[R, G, B]</code> <code>tMainText</code> True list White <code>[R, G, B]</code> <code>tForecast1</code> True list White <code>[R, G, B]</code> <code>tForecast2</code> True list White <code>[R, G, B]</code> <code>tForecast3</code> True list White <code>[R, G, B]</code> <code>tForecast4</code> True list White <code>[R, G, B]</code> <code>tForecast1Val</code> True list White <code>[R, G, B]</code> <code>tForecast2Val</code> True list White <code>[R, G, B]</code> <code>tForecast3Val</code> True list White <code>[R, G, B]</code> <code>tForecast4Val</code> True list White <code>[R, G, B]</code> <code>bar</code> True list White <code>[R, G, B]</code> <code>tMainTextAlt2</code> True list White <code>[R, G, B]</code> <code>tTimeAdd</code> True list White <code>[R, G, B]</code> <p>Specify colours as red green and blue values from 0-255 e.g. <code>[255, 0, 0]</code> for red or <code>[0, 0, 255]</code> for blue. These are translated internally to RGB565 (note that this has lower color depth so the colours may not appear the same). Also note that the screen has a low contrast ratio, so colors look sigificantly different at full display brightness and lowest brightness.</p> <p>Example for the theme config:</p> <pre><code>    screensaver:\n      theme:\n        date: [255, 0, 0]\n</code></pre> Config Example for configured statusIcons <pre><code>    screensaver:\n        entity: weather.k3ll3r\n        statusIcon1:\n          entity: switch.example_item\n        statusIcon2:\n           entity: binary_sensor.example_item\n</code></pre> <p>It is possible to increase the size of the font used for the icons by adding <code>altFont: True</code> to the statusIcon configuration. Icon/Color Overrides are also possible like on any other Entity.</p> Config Example for configured statusIcons with increased size of the icons <pre><code>    screensaver:\n        entity: weather.k3ll3r\n        statusIcon1:\n          entity: switch.example_item\n          altFont: True\n        statusIcon2:\n           entity: binary_sensor.example_item\n           altFont: True\n</code></pre> Config Example for all white icons on screensaver <pre><code>    screensaver:\n      entities:\n        - entity: weather.demo_weather_north\n        - entity: weather.demo_weather_north\n          type: 0\n      color: [255,255,255]\n        - entity: weather.demo_weather_north\n          type: 1\n      color: [255,255,255]\n        - entity: weather.demo_weather_north\n          type: 2\n      color: [255,255,255]\n        - entity: weather.demo_weather_north\n          type: 3\n      color: [255,255,255]\n</code></pre> Config Example for a custom date format on forecast <pre><code>   screensaver:\n      entities:\n        - entity: weather.demo_weather_north\n        - entity: weather.demo_weather_north\n          type: 0\n          name: \"%a %-d/%-m\"\n        - entity: weather.demo_weather_north\n          type: 1\n          name: \"%a %-d/%-m\"\n        - entity: weather.demo_weather_north\n          name: \"%a %-d/%-m\"\n          type: 2\n        - entity: weather.demo_weather_north\n          name: \"%a %-d/%-m\"\n          type: 3\n</code></pre>  See Babel Documentation (https://babel.pocoo.org/en/latest/dates.html#date-fields) or the Python Documenation (https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes) in case you do not have babel installed."},{"location":"configure_mqtt/","title":"Configure MQTT","text":""},{"location":"configure_mqtt/#configure-mqtt-on-tasmota","title":"Configure MQTT on Tasmota","text":"<p>Configure your MQTT Server in Tasmota. See Tasmota MQTT Documentation for more details.</p> <p></p> <p>Please leave the Full Topic as it is in default configuration (and on the screenshot).</p> <p>Change the topic to something unique for your panel, you will need this topic later in the configuration of your panel in appdaemon / apps.yaml</p>"},{"location":"configure_mqtt/#note-for-appdeamon-addon-version-15","title":"Note for Appdeamon Addon Version &gt;= 15","text":"<p>The configuration has been moved out of the config folder from homeassistant. This is how you can access it with the VSCode Addon.</p> <p></p> <p></p>"},{"location":"configure_mqtt/#configure-mqtt-connection-on-appdaemon","title":"Configure MQTT Connection on AppDaemon","text":"<p>For the app to work you need a working MQTT Configuration in AppDaemon. Please add the configuration of your mqtt server, user and password to your existing <code>appdaemon.yaml</code> Restart your AppDaemon Container (not HomeAssistant) after adding the MQTT Configuration.</p> <p>You will find this file in the following location: <code>/addon_configs/a0d7b954_appdaemon/appdeamon.yaml</code></p> <pre><code>---\nsecrets: /homeassistant/secrets.yaml\nappdaemon:\n  latitude: 52.0\n  longitude: 4.0\n  elevation: 2\n  time_zone: Europe/Berlin\n  app_dir: /homeassistant/appdaemon/apps/ # !!! This is really important for AppDaemon HA Addon &gt;= 15\n  plugins:\n    HASS:\n      type: hass\n    MQTT:\n      type: mqtt\n      namespace: mqtt\n      client_id: \"appdaemon\"\n      client_host: core-mosquitto.local.hass.io # This should work if you are using supervised HomeAssistant; if not use the IP Address instead.\n      #client_host: 192.168.75.30\n      client_port: 1883\n      client_user: \"mqttuser\"\n      client_password: \"mqttpassword\"\n      client_topics: NONE\nhttp:\n  url: http://127.0.0.1:5050\nadmin:\napi:\nhadashboard:\n</code></pre>"},{"location":"configure_mqtt/#configure-nspanel-on-appdaemon","title":"Configure NsPanel on AppDaemon","text":"<p>Please add the following minimal configuration to your apps.yaml, which is located in <code>config/appdaemon/apps/apps.yaml</code></p> <p>Note: You need to move your <code>apps.yaml</code> to this location if it isn't there.</p> <pre><code>---\nnspanel-1:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/tasmota_your_mqtt_topic/RESULT\"\n    panelSendTopic: \"cmnd/tasmota_your_mqtt_topic/CustomSend\"\n    model: eu\n</code></pre> <p>Please adjust <code>tasmota_your_mqtt_topic</code> to the topic used in Tasmota MQTT Configuration.</p> <p>If your configuration is correct you should get the following screens on your panel:</p> <p></p> Note: You can add multiple panels to this configuration: <pre><code>---\nnspanel-1:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/first-nspanel-topic/RESULT\"\n    panelSendTopic: \"cmnd/first-nspanel-topic/CustomSend\"\nnspanel-2:\n  module: nspanel-lovelace-ui\n  class: NsPanelLovelaceUIManager\n  config:\n    panelRecvTopic: \"tele/second-nspanel-topic/RESULT\"\n    panelSendTopic: \"cmnd/second-nspanel-topic/CustomSend\"\n</code></pre>"},{"location":"entities/","title":"Special Settings for Entities","text":""},{"location":"entities/#entities","title":"Entities","text":"<p>Entities are mainly used on cardEntities and cardGrid.</p> <p>It is possible to overwrite and configure varrious things on Entities.</p>"},{"location":"entities/#possible-configuration-values-for-entities-key","title":"Possible configuration values for entities key:","text":"key optional type default description <code>entity</code> False string <code>None</code> name of ha entity <code>name</code> True string <code>None</code> Used to override names (supports home assistant templates) <code>value</code> True string <code>None</code> Used to override the value (supports home assistant templates) <code>icon</code> True string <code>None</code> Used to override icons <code>color</code> True array <code>None</code> Overwrite color of entity <code>color: [255, 0, 0]</code> <code>state</code> True string <code>None</code> Only displayed if Entity state is equal to this value <code>state_not</code> True string <code>None</code> Only displayed if Entity state is unequal to this value <code>status</code> True string <code>None</code> Only valid for navigate and service items, adds a entity to track state for the icon <code>assumed_state</code> True string <code>None</code> Only for cover items, up, down and stop buttons are always shown <code>action_name</code> True string <code>None</code> Only valid for script; Button label <code>font</code> True string <code>None</code> Used to change the font for cardGrid Icons; valid values are (<code>small</code>, <code>medium-icon</code> and <code>medium</code>). Currently only supported for homeassistant entities and not for internal ones. <code>effectList</code> True string <code>None</code> Only valid for light; for example <code>[Android, Aurora</code> (fav list for effects)"},{"location":"entities/#override-icons-or-names","title":"Override Icons or Names","text":"<p>To overwrite Icons or Names of entities you can configure an icon and/or name in your configuration, please see the following example. Only the icons listed in the Icon Cheatsheet are useable.</p> <pre><code>        entities:\n          - entity: light.test_item\n            name: NameOverride\n            icon: mdi:lightbulb\n</code></pre> <p>It is also possible to configure different icon overwrites per state:</p> <pre><code>            icon:\n                \"on\": mdi:lightbulb\n                \"off\": mdi:lightbulb\n</code></pre> <p>It is also possible to configure different color overwrites per state:</p> <p></p><pre><code>            color:\n                \"on\": [255,0,0]\n                \"off\": [0,0,255]\n</code></pre> Dynamic color overwrites using homeassistant templates: <pre><code>            color: '{{iif(states(\"binary_sensor.test\")==\"on\", \"[0,255,0]\", \"[255,165,0]\")}}'\n</code></pre> <p>It is also possible to use text instead of icons with <code>text:X</code></p> <pre><code>            icon:\n                \"on\": mdi:lightbulb\n                \"off\": \"text:\"\n</code></pre> <p>Note: State Overrides are working with all state values, not only with \"on\" and \"off\".</p> <p>To insert dynamic values from a homeassistant template, like a temperature you can also use <code>ha:</code> which will be rendered as homeassistant template. There probably not much cases where this is needed, but here is an exmaple to show the current temperature on the status icon of the screensaver:</p> <pre><code>      statusIcon2:\n        entity: climate.wohnzimmer_boden\n        icon: 'ha:{{ state_attr(\"climate.wohnzimmer_boden\",\"current_temperature\")}}'\n</code></pre> <p>If you want to display icons from a template you can put them between <code>&lt;I&gt;&lt;/I&gt;</code></p> <pre><code>        icon: 'ha:{{ iif(is_state('light.kitchen', 'on'), '&lt;I&gt;mdi:flashlight&lt;/I&gt;', '&lt;I&gt;mdi:flashlight-off&lt;/I&gt;') }}'\n</code></pre>"},{"location":"entities/#hide-item-based-on-state","title":"Hide item based on state","text":"<p>This sensor will only be shown on the card if it's state is equal to <code>off</code></p> <pre><code>      - entity: binary_sensor.sensor_bad_contact\n        state: \"off\"\n</code></pre> <p>This sensor will only be shown on the card if it's state is not equal to <code>on</code></p> <pre><code>      - entity: binary_sensor.sensor_kueche_contact\n        state_not: \"on\"\n</code></pre>"},{"location":"entities/#hide-item-based-on-ha-template","title":"Hide item based on HA Template","text":"<p>The template must evaluate to <code>true</code> for the entity to hide.</p> <pre><code>      - entity: binary_sensor.sensor_kueche_contact\n        state_template: '{{ state_attr(\"sun.sun\",\"azimuth\") &lt; 200 }}'\n</code></pre>"},{"location":"entities/#calling-service-directly-as-button","title":"Calling service directly as button","text":"<p>The following example shows how to call services directly, this enables you to call services on entities not (yet) supported by the backend and also to pass data to services.</p> <pre><code>    - entity: service.light.turn_on\n      data:\n        entity_id: light.schreibtischlampe\n        color_name: \"green\"\n</code></pre>"},{"location":"faq/","title":"FAQ","text":""},{"location":"faq/#faq-frequently-asked-questions","title":"FAQ - Frequently Asked Questions","text":""},{"location":"faq/#waiting-for-content-this-is-taking-longer-than-usual-on-the-screen","title":"Waiting for content - This is taking longer than usual on the screen","text":"<p>You have most likely an error in your MQTT configuration somewhere. To find the error follow theese steps:</p> <ol> <li> <p>Check the location of your apps.yaml With the AppDaemon Addon &gt;= 15 the config dir has been moved. It's required to configure the location back to the old one, this is done by the <code>app_dir</code> line in your <code>appdaemon.yaml</code>. This also requires you to move your apps.yaml to this location. Please make sure your apps.yaml is at <code>/config/appdaemon/apps/apps.yaml</code> and move it otherwise.</p> </li> <li> <p>Check your appdaemon log. (Settings &gt; Add-ons &gt; AppDaemon &gt; Log) You should see something like this: <code>INFO MQTT: MQTT Plugin initialization complete</code> If you are seeing Messages like this: <code>CRITICAL MQTT: Could not complete MQTT Plugin initialization, for Connection was refused due to Not Authorised</code> Your appdaemon mqtt config is wrong, check your appdaemon.yaml. The log of your mqtt broker might give you additional information.  </p> </li> <li> <p>Check MQTT Configuration of Tasmota. Your Tasmota device needs to connect sucessfully to your MQTT Broker, if you are in the waiting for content screen, the panel will send periodic messages to it's mqtt topic. Note that there is a minimum password length of 5 chars for the MQTT Connection in Tasmota.</p> </li> <li> <p>Make sure that you are using the same topic in apps.yaml and in your tasmota configuration.  The examples in the docs (MQTT Config) are an valid example (tasmota&lt;&gt;apps.yaml). Please don't modify the Full Topic in your Tasmota Config, unless you know the implications, changing the Full Topic will result in diffent Send and Receive Channels, that have to be correct in your apps.yaml.</p> </li> <li> <p>If you are still in the waiting for content screen please share the following items, with the Waiting for Content Issue type on the Github Issues Page</p> <ul> <li>a screenshot of your tasmota mqtt configration (please censor your mqtt password)</li> <li>your appdaemon.yaml (please censor your mqtt password)</li> <li>your apps.yaml</li> <li>the appdaemon log, after restarting the container</li> </ul> </li> </ol>"},{"location":"faq/#how-to-update","title":"How to update","text":""},{"location":"faq/#update-appdaemon-script","title":"Update AppDaemon Script","text":"<p>HACS will show you that there is an update avalible and ask you to update. It is important to restart the AppDaemon Container afterwards.</p>"},{"location":"faq/#update-display-firmware","title":"Update Display Firmware","text":"<p>You should get an notification on the screen, asking you to update the firmware. In case you want to update manually you can use the following commands.</p> <p>EU Version: <code>FlashNextion http://nspanel.pky.eu/lui-release.tft</code></p> <p>US Version Portrait: <code>FlashNextion http://nspanel.pky.eu/lui-us-p-release.tft</code></p> <p>US Version Landscape: <code>FlashNextion http://nspanel.pky.eu/lui-us-l-release.tft</code></p>"},{"location":"faq/#update-tasmota-berry-driver","title":"Update Tasmota Berry Driver","text":"<p>You should get an notification on the screen, asking you to update the driver, if an update is needed.</p> <p>You can update the berry driver directly from the Tasmota Console with the following command.</p> <p><code>UpdateDriverVersion https://raw.githubusercontent.com/joBr99/nspanel-lovelace-ui/main/tasmota/autoexec.be</code></p>"},{"location":"faq/#how-to-upgrade-from-a-release-to-the-current-development-version","title":"How to upgrade from a release to the current development version","text":"<ol> <li>Update App in HACS to main</li> </ol> <p>Click redownload in the menu of the app in HACS.</p> <p>Select main version.</p> <p>!!! Wait for it to load, dropdown needs to be selectable again, otherwise it will download the latest release !!!</p> <p></p> <p>!!! Wait for it to load, dropdown needs to be selectable again, otherwise it will download the latest release !!!</p> <p>Click download.</p> <ol> <li> <p>Restart AppDaemon</p> </li> <li> <p>Flash current Development Firmware in Tasmota Console. DO NOT USE THIS VERSION/URLS IF YOUR ARE NOT ON THE DEVELOPMENT VERSION</p> </li> </ol> <p>EU VERSION: <code>FlashNextion http://nspanel.pky.eu/lui.tft</code></p> <p>Development happens in the EU version, so it is possible that the US Version isn't up to date with the current development version of the EU firmware, the lastet US versions are still downloadable with the following links:</p> <p>US LANDSCAPE: <code>FlashNextion http://nspanel.pky.eu/lui-us-l.tft</code></p> <p>US PORTRAIT: <code>FlashNextion http://nspanel.pky.eu/lui-us-p.tft</code></p>"},{"location":"hmi-serial-protocol/","title":"NSPanel Lovelace UI","text":""},{"location":"hmi-serial-protocol/#nspanel-lovelace-ui","title":"NSPanel Lovelace UI","text":"<p>The HMI Project of this project is only used to display stuff, navigation ist mostly up to the backend. This allows to be way more flexible.</p> <p>Messages to the Panel can be send through the Command <code>CustomSend</code>, which is implemented in the berry driver. You can issue this command through MQTT by sending messages to the <code>cmnd/XXX/CustomSend</code> Topic. Messages from the Panel are send to the <code>tele/XXX/RESULT</code> Topic, encoded in json <code>{\"CustomRecv\":\"message_from_screen\"}</code></p>"},{"location":"hmi-serial-protocol/#table-of-contents","title":"Table of contents","text":"<ul> <li>Startup<ul> <li>Some preperation before we are acually navigating away:</li> <li>Navigate from the startup page to the screensaver, by sending this command to the CustomSend Topic.</li> <li>Exit Screensaver</li> </ul> </li> <li>Messages to Nextion Display<ul> <li>General Commands, implemented on all pages</li> <li>screensaver page</li> <li>cardEntities Page</li> <li>cardGrid Page</li> <li>cardMedia</li> <li>cardThermo</li> <li>cardAlarm</li> <li>cardQR</li> <li>cardPower</li> </ul> </li> </ul>"},{"location":"hmi-serial-protocol/#startup","title":"Startup","text":"<p>On startup the panel will send <code>{\"CustomRecv\":\"event,startup,39,eu\"}</code> every few seconds.</p> <pre><code>event,   #Every message from the screen will start with `event`\nstartup, #Startup Event\n39,      #Current HMI Project Version\neu       #Current HMI Project Model\n</code></pre> <p>You can answer this message in many different ways, but in general the goal is to navigate way from the startup page. In the following example we will navigate to the screensaver page.</p> <p>Send the following messages to the CustomSend Topic. (You can also send them on tasmota console for testing)</p>"},{"location":"hmi-serial-protocol/#some-preperation-before-we-are-acually-navigating-away","title":"Some preperation before we are acually navigating away:","text":"<p>Send this every minute: <code>time~18:17</code></p> <p>Send this at least once at midnight: <code>date~Donnerstag, 25. August 2022</code></p> <p>Send theese message once after receiving the startup event (parameters will be explained later):</p> <p><code>timeout~20</code></p> <p><code>dimmode~10~100~6371</code></p>"},{"location":"hmi-serial-protocol/#navigate-from-the-startup-page-to-the-screensaver-by-sending-this-command-to-the-customsend-topic","title":"Navigate from the startup page to the screensaver, by sending this command to the CustomSend Topic.","text":"<p><code>pageType~screensaver</code></p> <p>After sending this command you should already see the time and date. To also show weather data you have to send them with weatherUpdate, but we will skip this for now.</p>"},{"location":"hmi-serial-protocol/#exit-screensaver","title":"Exit Screensaver","text":"<p>Touching the panel on the screensaver will result in this MQTT Message on the result topic:</p> <p><code>event,buttonPress2,screensaver,bExit,1</code></p> <p>You can answer this by sending theese commands to the CustomSend Topic.</p> <p><code>pageType~cardEntities</code></p> <p><code>entityUpd~test~~button~navigate.prev~&lt;~65535~~~button~navigate.next~&gt;~65535~~~~light~light.schreibtischlampe~X~17299~Schreibtischlampe~0~text~sensor.server_energy_power~Y~17299~Server ENERGY Power~155 W~shutter~cover.rolladenfenster_cover_1~Z~17299~Fenster Eingang~A|B|C|disable|enable|enable~switch~switch.bad~D~63142~Bad~1</code></p>"},{"location":"hmi-serial-protocol/#messages-to-nextion-display","title":"Messages to Nextion Display","text":""},{"location":"hmi-serial-protocol/#general-commands-implemented-on-all-pages","title":"General Commands, implemented on all pages","text":"<p>set brightness of screensaver and active-brightness:</p> <p><code>dimmode~0~100 - (screen off)</code></p> <p><code>dimmode~100~100 - (screen on with full brightness)</code></p> <p>set current time:</p> <p><code>time~22:26</code></p> <p>set current date:</p> <p><code>date~Di 24. Februar</code></p> <p>set screensaver timeout (set time in sec~ max 65):</p> <p><code>timeout~15 - timeout after 15 seconds</code></p> <p><code>timeout~0 - disable screensaver</code></p> <p>change the page type:</p> <p><code>pageType~pageStartup</code></p> <p><code>pageType~cardEntities</code></p> <p><code>pageType~cardThermo</code></p> <p><code>pageType~cardMedia</code></p> <p><code>pageType~popupLight~Schreibtischlampe~light.schreibtischlampe</code></p> <p><code>pageType~popupNotify</code></p> <p><code>pageType~screensaver</code></p>"},{"location":"hmi-serial-protocol/#screensaver-page","title":"screensaver page","text":"Parameter Number Category Location Type Field Addional Information 0 instruction instruction weatherupdate 1 Main Icon Entity Definition type ignored 2 intNameEntity ignored 3 icon 4 iconColor 5 displayName ignored 6 optionalValue 7 First Forecast Icon Entity Definition type ignored 8 intNameEntity ignored 9 icon 10 iconColor 11 displayName 12 optionalValue 13 Second Forecast Icon Entity Definition type ignored 14 intNameEntity ignored 15 icon 16 iconColor 17 displayName 18 optionalValue 19 Third Forecast Icon Entity Definition type ignored 20 intNameEntity ignored 21 icon 22 iconColor 23 displayName 24 optionalValue 25 Fourth Forecast Icon Entity Definition type ignored 26 intNameEntity ignored 27 icon 28 iconColor 29 displayName 30 optionalValue 31 Alternative Layout Icon Entity Definition type ignored 32 intNameEntity ignored 33 icon 34 iconColor 35 displayName ignored 36 optionalValue <p><code>color~background~tTime~timeAMPM~tDate~tMainText~tForecast1~tForecast2~tForecast3~tForecast4~tForecast1Val~tForecast2Val~tForecast3Val~tForecast4Val~bar~tMainTextAlt2~tTimeAdd</code></p> Parameter Number Category Location Type Field Addional Information 0 instruction color 1 background 2 tTime 3 timeAMPM 4 tDate 5 tMainText 6 tForecast1 7 tForecast2 8 tForecast3 9 tForecast4 10 tForecast1Val 11 tForecast2Val 12 tForecast3Val 13 tForecast4Val 14 bar 15 tMainTextAlt2 16 tTimeAdd <p><code>notify~heading~text</code></p> <p><code>statusUpdate~icon1~icon1Color~icon2~icon2~icon2color~icon1font~icon2font</code></p>"},{"location":"hmi-serial-protocol/#cardentities-page","title":"cardEntities Page","text":"<p>Structure (Category): <code>entityUpd~title~[navigation]~[entity_information]</code> Example with 4 Entities:  </p><pre><code>entityUpd~LightTest~button~navigate.prev~&lt;~65535~~~button~navigate.next~&gt;~65535~~~light~light.bed_light~A~17299~Bed Light~0~light~light.ceiling_lights~B~52231~Ceiling Lights~1~switch~switch.ac~C~17299~AC~0~switch~switch.decorative_lights~D~65222~Decorative Lights~1\n</code></pre> <p>Possible entities on cardEntities/cardGrid:</p> <p><code>~light~light.entityName~1~17299~Light1~0</code></p> <p><code>~shutter~cover.entityName~0~17299~Shutter2~iconUp|iconStop|iconDown</code></p> <p><code>~delete~~~~~</code></p> <p><code>~text~sensor.entityName~3~17299~Temperature~content</code></p> <p><code>~button~button.entityName~3~17299~bt-name~bt-text</code></p> <p><code>~switch~switch.entityName~4~17299~Switch1~0</code></p> <p><code>~number~input_number.entityName~4~17299~Number123~value|min|max</code></p> <p><code>~input_sel~input_select.entityName~3~17299~sel-name~sel-text</code></p> Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title title 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 Entities First Entity Entity Definition type 15 intNameEntity 16 icon 17 iconColor 18 displayName 19 optionalValue 20 Second Entity Entity Definition type 21 intNameEntity 22 icon 23 iconColor 24 displayName 25 optionalValue 26 Thrid Entity Entity Definition type 27 intNameEntity 28 icon 29 iconColor 30 displayName 31 optionalValue 32 Forth Entiry Entity Definition type 33 intNameEntity 34 icon 35 iconColor 36 displayName 37 optionalValue 38 Fifth Entiy (US Portrait\u00a0\u00a0\u00a0Version) Entity Definition type 39 intNameEntity 40 icon 41 iconColor 42 displayName 43 optionalValue 44 Sixth Entiy (US Portrait\u00a0\u00a0\u00a0Version) Entity Definition type 45 intNameEntity 46 icon 47 iconColor 48 displayName 49 optionalValue"},{"location":"hmi-serial-protocol/#cardgrid-page","title":"cardGrid Page","text":"<p>cardGrid is using the exact same messageformat like cardEntities does. The only difference is, it ignores the information supplied in optionalValue, because it isn't needed for cardGrid.</p> Parameter\u00a0\u00a0\u00a0Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title title 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 Entities First Entity Entity Definition type 15 intNameEntity 16 icon 17 iconColor 18 displayName 19 optionalValue ignored 20 Second Entity Entity Definition type 21 intNameEntity 22 icon 23 iconColor 24 displayName 25 optionalValue ignored 26 Thrid Entity Entity Definition type 27 intNameEntity 28 icon 29 iconColor 30 displayName 31 optionalValue ignored 32 Forth Entiry Entity Definition type 33 intNameEntity 34 icon 35 iconColor 36 displayName 37 optionalValue ignored 38 Fifth Entiy (US Portrait\u00a0\u00a0\u00a0Version) Entity Definition type 39 intNameEntity 40 icon 41 iconColor 42 displayName 43 optionalValue ignored 44 Sixth Entiy (US Portrait\u00a0\u00a0\u00a0Version) Entity Definition type 45 intNameEntity 46 icon 47 iconColor 48 displayName 49 optionalValue ignored"},{"location":"hmi-serial-protocol/#cardmedia","title":"cardMedia","text":"<p>Example without icons in bottom row: <code>entityUpd~Kitchen~button~navigation.up~U~65535~~~delete~~~~~~media_player.kitchen~I'm a Hurricane~~Wellmess~~100~A~64704~B~media_pl~media_player.kitchen~C~17299~Kitchen~</code></p> Parameter\u00a0\u00a0\u00a0Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title title 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 cardMedia specific cardMedia specific intNameEntity 15 1st text row title 16 titleColor 17 2nd text row author 18 authorColor 19 slider volume 0-100 20 icon middle playPauseIcon 21 icon right side onOffBtn \"disable\" or color 22 icon left side iconShuffle \"disable\" or icon 23 Entities upper left corner media\u00a0\u00a0\u00a0icon Entity Definition type 24 intNameEntity 25 icon 26 iconColor 27 displayName only used for popups 28 optionalValue ignored 29 First Entity Entity Definition type 30 intNameEntity 31 icon 32 iconColor 33 displayName only used for popups 34 optionalValue ignored 35 Second Entity Entity Definition type 36 intNameEntity 37 icon 38 iconColor 39 displayName only used for popups 40 optionalValue ignored 41 Thrid Entity Entity Definition type 42 intNameEntity 43 icon 44 iconColor 45 displayName only used for popups 46 optionalValue ignored 47 Forth Entiry Entity Definition type 48 intNameEntity 49 icon 50 iconColor 51 displayName only used for popups 52 optionalValue ignored 53 Fifth Entiy Entity Definition type 54 intNameEntity 55 icon 56 iconColor 57 displayName only used for popups 58 optionalValue ignored"},{"location":"hmi-serial-protocol/#cardthermo","title":"cardThermo","text":"<p>Serial Protocol of cardThermo is about to change; table will be completed later</p> Parameter Number Location Type Field Addional Information 0 instruction entityUpd 1 title title title 2 Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 intNameEntity 15 2nd text box currentTemp 16 target temperature dstTemp multiplied by 10 17 Text 4th Box Left Side status 18 Min Temp minTemp multiplied by 10 19 Max Temp maxTemp multiplied by 10 20 Temperature Steps tempStep multiplied by 10 21 bottom hvac_action 1 Hvac Action icon 22 iconColorActive 23 buttonState 24 intName 25 bottom hvac_action 2 Hvac Action icon 26 iconColorActive 27 buttonState 28 intName 29 bottom hvac_action 3 Hvac Action icon 30 iconColorActive 31 buttonState 32 intName 33 bottom hvac_action 4 Hvac Action icon 34 iconColorActive 35 buttonState 36 intName 37 bottom hvac_action 5 Hvac Action icon 38 iconColorActive 39 buttonState 40 intName 41 bottom hvac_action 6 Hvac Action icon 42 iconColorActive 43 buttonState 44 intName 45 bottom hvac_action 7 Hvac Action icon 46 iconColorActive 47 buttonState 48 intName 49 bottom hvac_action 8 Hvac Action icon 50 iconColorActive 51 buttonState 52 intName 53 Currently Label 1th Text Box tCurTempLbl 54 State Label 3th Text Box tStateLbl 55 tALbl deprecated; ignored 56 Temperature Unit (Celcius/Farhenheit) tCF 57 Second Destination Tempature (Heat/Cool) second temp ; multiplied by 10 58 additonal detail button to open another page btDetail \"1\" to hide"},{"location":"hmi-serial-protocol/#cardalarm","title":"cardAlarm","text":"Parameter Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title title 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 cardAlarm specific card intNameEntity intNameEntity 15 1st button right side displayName 16 intId 17 2nd button right side displayName 18 intId 19 3rd button right side displayName 20 intId 21 4th button right side displayName 22 intId 23 icon next to code display icon 24 iconColor 25 numpad numpadStatus \"disable\" or \"enable\" 26 flashing of icon next to code flashing status \"enable\" or \"disable\" 27 button bottom left corner icon 28 iconColor 29 intNameEntity"},{"location":"hmi-serial-protocol/#cardqr","title":"cardQR","text":"<p>Example: <code>entityUpd~Guest Wifi~button~navigate.prev~&lt;~65535~~~button~navigate.next~&gt;~65535~~~WIFI:S:test_ssid;T:WPA;P:test_pw;;~text~iText.test_ssid~\ufffd\ufffd\ufffd~17299~Name~test_ssid~text~iText.test_pw~\ufffd\ufffd\ufffd~17299~Password~test_pw</code></p> Parameter\u00a0\u00a0\u00a0Number Category Location Type Field Addional Information 0 instruction instruction entityUpd 1 title title title intNameEntity 2 Navigation Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 cardQR specific qrcode text 15 Entities 1st Entity Entity Definition type 16 intNameEntity 17 icon 18 iconColor 19 displayName 20 optionalValue 21 2nd Entity Entity Definition type 22 intNameEntity 23 icon 24 iconColor 25 displayName 26 optionalValue"},{"location":"hmi-serial-protocol/#cardpower","title":"cardPower","text":"<p><code>entityUpd~PowerTest~x~navUp~A~65535~~~delete~~~~~~text~sensor.power_consumption~B~17299~Power consumption~100W~1~text~sensor.power_consumption~C~17299~Power consumption~100W~1~text~sensor.today_energy~D~17299~Total energy 1~5836.0kWh~0~delete~~~~~~0~text~sensor.today_energy~E~17299~Total energy 1~5836.0kWh~-30~delete~~~~~~0~text~sensor.today_energy~F~65504~Total energy 1~5836.0kWh~90~text~sensor.today_energy~G~17299~Total energy 1~5836.0kWh~10</code></p> Parameter Number Location Type Field Addional Information 0 instruction entityUpd 1 title title title 2 Upper Left Icon Entity Definition type (ignored)\u00b9 3 intNameEntity 4 icon 5 iconColor 6 displayName ignored 7 optionalValue ignored 8 Upper Right Icon Entity Definition type (ignored)\u00b9 9 intNameEntity 10 icon 11 iconColor 12 displayName ignored 13 optionalValue ignored 14 Home Icon / Value below Home Icon Entity Definition type ignored 15 intNameEntity ignored 16 icon 17 iconColor 18 displayName 19 optionalValue 20 speed ignored 21 Value above Home Icon Entity Definition type ignored 22 intNameEntity ignored 23 icon ignored 24 iconColor ignored 25 displayName ignored 26 optionalValue 27 speed ignored 28 1st Item Upper Left Entity Definition type ignored 29 intNameEntity ignored 30 icon 31 iconColor 32 displayName 33 optionalValue 34 speed numbers (between -120 and 120) 35 2nd Item Middle Left Entity Definition type ignored 36 intNameEntity ignored 37 icon 38 iconColor 39 displayName 40 optionalValue 41 speed numbers (between -120 and 120) 42 3rd Item Bottom Left Entity Definition type ignored 43 intNameEntity ignored 44 icon 45 iconColor 46 displayName 47 optionalValue 48 speed numbers (between -120 and 120) 49 4th Item Upper Right Entity Definition type ignored 50 intNameEntity ignored 51 icon 52 iconColor 53 displayName 54 optionalValue 55 speed numbers (between -120 and 120) 56 5th Item Middle Right Entity Definition type ignored 57 intNameEntity ignored 58 icon 59 iconColor 60 displayName 61 optionalValue 62 speed numbers (between -120 and 120) 63 6th Item Bottom Right Entity Definition type ignored 64 intNameEntity ignored 65 icon 66 iconColor 67 displayName 68 optionalValue 69 speed numbers (between -120 and 120)"},{"location":"hmi-serial-protocol/#cardchart-page","title":"cardChart Page","text":"<p><code>entityUpd~heading~navigation~color~yAxisLabel~yAxisTick:[yAxisTick]*[~value[:xAxisLabel]?]*</code> </p> <p><code>entityUpd~Chart Demo~~button~navigate.prev~&lt;~65535~~~button~navigate.next~&gt;~65535~~~~6666~Gas [kWh]~20:40:60:80:100~10~7^2:00~7~6^4:00~6~7^6:00~0~7^8:00~5~1^10:00~1~10^12:00~5~6^14:00~8</code></p>"},{"location":"hmi-serial-protocol/#popuplight-page","title":"popupLight Page","text":"<p><code>entityUpdateDetail~entityName~*ignored*~*iconColor*~*buttonState*~*sliderBrightnessPos*~*sliderColorTempPos*~*colorMode*~*color_translation*~*color_temp_translation*~*brightness_translation*</code></p> <p><code>entityUpdateDetail~1~17299~1~100~78~enable</code></p> <p><code>entityUpdateDetail~1~17299~1~100~disable</code></p>"},{"location":"hmi-serial-protocol/#popupshutter-page","title":"popupShutter Page","text":"<p><code>entityUpdateDetail~entityName~*sliderPos*~2ndrow~textPosition~icon1~iconUp~iconStop~iconDown~iconUpStatus~iconStopStatus~iconDownStatus~textTilt~iconTiltLeft~iconTiltStop~iconTiltRight~iconTiltLeftStatus~iconTiltStopStatus~iconTiltLeftStatus~tiltPos</code></p> <p><code>entityUpdateDetail~1~77</code></p>"},{"location":"hmi-serial-protocol/#popupnotify-page","title":"popupNotify Page","text":"<p><code>entityUpdateDetail~*internalName*~*tHeading*~*tHeadingColor*~*b1*~*tB1Color*~*b2*~*tB2Color*~*tText*~*tTextColor*~*sleepTimeout*~*font*~*alt_icon*~*altIconColor*</code></p> <p><code>exitPopup</code></p>"},{"location":"hmi-serial-protocol/#popupthermo-page","title":"popupThermo Page","text":"<p><code>entityUpdateDetail~{entity_id}~{icon_id}~{icon_color}~{heading}~{mode}~mode1~mode1?mode2?mode3~{heading}~{mode}~mode1~mode1?mode2?mode3~{heading}~{mode}~mode1~mode1?mode2?mode3~</code></p>"},{"location":"hmi-serial-protocol/#popupinsel-page-input_select-detail-page","title":"popupInSel Page (input_select detail page)","text":"<p><code>entityUpdateDetail2~*entity_id*~~*icon_color*~*input_sel*~*state*~*options*</code></p> <p>options are ? seperated</p>"},{"location":"hmi-serial-protocol/#popuptimer","title":"popupTimer","text":"<p>editable is 0 or 1</p> <p>action fields are in the answer on the button press</p> <p>in case action is empty the button will be hidden</p> <p><code>entityUpdateDetail~{entity_id}~~{icon_color}~{entity_id}~{min_remaining}~{sec_remaining}~{editable}~{action1}~{action2}~{action3}~{label1}~{label2}~{label3}</code></p>"},{"location":"hmi-serial-protocol/#messages-from-nextion-display","title":"Messages from Nextion Display","text":"<p><code>event,buttonPress2,pageName,bNext</code></p> <p><code>event,buttonPress2,pageName,bPrev</code></p> <p><code>event,buttonPress2,pageName,bExit,number_of_taps</code></p> <p><code>event,buttonPress2,pageName,sleepReached</code></p>"},{"location":"hmi-serial-protocol/#startup-page","title":"startup page","text":"<p><code>event,startup,version,model</code></p>"},{"location":"hmi-serial-protocol/#screensaver-page_1","title":"screensaver page","text":"<p><code>event,buttonPress2,screensaver,exit</code> - Touch Event on Screensaver</p> <p><code>event,screensaverOpen</code> - Screensaver has opened</p>"},{"location":"hmi-serial-protocol/#cardentities-page_1","title":"cardEntities Page","text":"<p><code>event,*eventName*,*entityName*,*actionName*,*optionalValue*</code></p> <p><code>event,buttonPress2,internalNameEntity,up</code></p> <p><code>event,buttonPress2,internalNameEntity,down</code></p> <p><code>event,buttonPress2,internalNameEntity,stop</code></p> <p><code>event,buttonPress2,internalNameEntity,OnOff,1</code></p> <p><code>event,buttonPress2,internalNameEntity,button</code></p>"},{"location":"hmi-serial-protocol/#popuplight-page_1","title":"popupLight Page","text":"<p><code>event,pageOpenDetail,popupLight,internalNameEntity</code></p> <p><code>event,buttonPress2,internalNameEntity,OnOff,1</code></p> <p><code>event,buttonPress2,internalNameEntity,brightnessSlider,50</code></p> <p><code>event,buttonPress2,internalNameEntity,colorTempSlider,50</code></p> <p><code>event,buttonPress2,internalNameEntity,colorWheel,x|y|wh</code></p>"},{"location":"hmi-serial-protocol/#popupshutter-page_1","title":"popupShutter Page","text":"<p><code>event,pageOpenDetail,popupShutter,internalNameEntity</code></p> <p><code>event,buttonPress2,internalNameEntity,positionSlider,50</code></p>"},{"location":"hmi-serial-protocol/#popupnotify-page_1","title":"popupNotify Page","text":"<p><code>event,buttonPress2,*internalName*,notifyAction,yes</code></p> <p><code>event,buttonPress2,*internalName*,notifyAction,no</code></p>"},{"location":"hmi-serial-protocol/#cardthermo-page","title":"cardThermo Page","text":"<p><code>event,buttonPress2,*entityName*,tempUpd,*temperature*</code></p> <p><code>event,buttonPress2,*entityName*,hvac_action,*hvac_action*</code></p>"},{"location":"hmi-serial-protocol/#cardmedia-page","title":"cardMedia Page","text":"<p><code>event,buttonPress2,internalNameEntity,media-back</code></p> <p><code>event,buttonPress2,internalNameEntity,media-pause</code></p> <p><code>event,buttonPress2,internalNameEntity,media-next</code></p> <p><code>event,buttonPress2,internalNameEntity,volumeSlider,75</code></p>"},{"location":"hmi-serial-protocol/#cardalarm-page","title":"cardAlarm Page","text":"<p><code>event,buttonPress2,internalNameEntity,actionName,code</code></p>"},{"location":"hmi-serial-protocol/#custom-protocol","title":"Custom Protocol","text":"<pre><code>55 BB [payload length] [payload length] [payload] [crc] [crc]\n</code></pre> <p>Payload length contains the number of bytes of the payload.</p> <p>CRC is \"CRC-16 (MODBUS) Big Endian\" calculated over the whole message</p> <p>This protocol does not try to implement broken JSON Commands with a specified type (lol). Instead the commands are plain text commands with parameters.</p>"},{"location":"hmi-serial-protocol/#example-for-valid-message","title":"Example for valid Message","text":"<p>This message has to be generated for the Message \"1337\" (1337 is not a valid command~ this is just an example)</p> <pre><code>55 BB  04 00  31 33 33 37  5F 5B\n</code></pre>"},{"location":"iobroker-install/","title":"Prepare ioBroker","text":""},{"location":"iobroker-install/#installation-iobroker","title":"Installation - ioBroker","text":"<p>The Backend for ioBroker is maintained by britzelpuf and armilar</p> <p>See the wiki for documentation around setting lovelace-ui up with ioBroker</p> <p>Wiki</p> <p>Also see the Readme in the ioBroker Folder.  iobroker ReadMe</p>"},{"location":"notifications/","title":"Notifications","text":""},{"location":"notifications/#sending-notifications-to-the-panel","title":"Sending Notifications to the Panel","text":"<p>There are two notification types, that can be triggered by sending a command over mqtt to the panel here are examples for homeassistant scripts:</p>"},{"location":"notifications/#seperate-page","title":"Seperate Page","text":"<p>This is the notification used by the backend for updates, opening it requires to the following commands to the CustomSend Topic:</p> <p><code>pageType popupNotify</code></p> <p><code>entityUpdateDetail~internalName~heading~headingColor~button1text~button1color~button2text~tB2Color~notificationText~textColor~sleepTimeout~fontIdText</code></p> <p>Alternative Layout with Icon:</p> <p><code>entityUpdateDetail~internalName~heading~headingColor~button1text~button1color~button2text~tB2Color~notificationText~textColor~sleepTimeout~fontIdText~icon~iconColor</code></p> <p><code>fontIdText</code> is the font used by the notification text Possible values are 0-5: </p><pre><code>Font 0 - Default - Size 24 (No Icons, Support for various special chars from different langs)\nFont 1 - Size 32 (Icons and limited chars)\nFont 2 - Size 32 (No Icons, Support for various special chars from different langs)\nFont 3 - Size 48 (Icons and limited chars)\nFont 4 - Size 80 (Icons and limited chars)\nFont 5 - Size 128 (ascii only)\n</code></pre> <p>You need to use the acual char for the icon instead of the icon name which is used in the configuration. You can get the char of the icon from the cheatsheet.</p> <p>https://docs.nspanel.pky.eu/icon-cheatsheet.html</p> <p>It is possible to exit from the page by sending <code>exitPopup</code></p> <p>If you want to add newlines to your message add this string for the newline <code>{{'\\r\\n'}}</code></p> <p>Send Message to the Panel combined with a buzzer sound:</p> <pre><code>nspanel_popup_notification:\n  alias: Popup Notification\n  sequence:\n  - service: mqtt.publish\n    data:\n      topic: cmnd/tasmota_NsPanelTerrasse/Backlog\n      payload: CustomSend pageType~popupNotify; CustomSend entityUpdateDetail~id~{{\n        title }}~65535~~~~~{{ message }}~65535~{{ timeout }}; Buzzer 2,2,2\n  mode: single\n  icon: mdi:message-badge\n</code></pre> <p>Send Message to the Panel:</p> <pre><code>nspanel_popup_notification:\n  alias: Popup Notification\n  sequence:\n  - service: mqtt.publish\n    data:\n      topic: cmnd/tasmota_NsPanelTerrasse/Backlog\n      payload: CustomSend pageType~popupNotify; CustomSend entityUpdateDetail~id~{{\n        title }}~65535~~~~~{{ message }}~65535~{{ timeout }}\n  mode: single\n  icon: mdi:message-badge\n</code></pre>"},{"location":"notifications/#notification-on-screensaver","title":"Notification on screensaver","text":"<p>The screensaver can display Notifications by sending this command to the CustomSend topic: <code>notify~heading~text</code></p> <p>Send Message to the Screensaver combined with a buzzer sound:</p> <pre><code>nspanel_screensaver_notification:\n  alias: Screensaver Notification\n  sequence:\n  - service: mqtt.publish\n    data:\n      topic: cmnd/tasmota_NsPanelTerrasse/Backlog\n      payload: CustomSend notify~{{ heading }}~{{ message }}; Buzzer 2,2,2\n  mode: single\n  icon: mdi:message-badge\n</code></pre> <p>Send Message to the Screensaver:</p> <pre><code>nspanel_screensaver_notification:\n  alias: Screensaver Notification\n  sequence:\n  - service: mqtt.publish\n    data:\n      topic: cmnd/tasmota_NsPanelTerrasse/Backlog\n      payload: CustomSend notify~{{ heading }}~{{ message }}\n  mode: single\n  icon: mdi:message-badge\n</code></pre>"},{"location":"notifications/#buzzer","title":"Buzzer","text":"<p>See Tasmota Buzzer for commands.</p> <p>It might be necessary to enable the buzzer with: </p><pre><code>BuzzerPWM 1\n</code></pre>"},{"location":"notifications/#color-picker","title":"Color Picker","text":"<p>Decimal RGB565: 0</p>"},{"location":"phys-btn/","title":"Physical Buttons","text":""},{"location":"phys-btn/#change-behaviour-of-hardware-buttons","title":"Change behaviour of hardware buttons","text":""},{"location":"phys-btn/#tasmota-rules","title":"Tasmota Rules","text":"<p>You can configure the buttons to mimic an UI element on the screen by configuring tasmota rules.</p> <p>The following rule will change the behaviour of the two buttons to do page navigation.</p> <pre><code>Rule2 on Button1#state do Publish tele/%topic%/RESULT {\"CustomRecv\":\"event,buttonPress2,navPrev,button\"} endon on Button2#state do Publish tele/%topic%/RESULT {\"CustomRecv\":\"event,buttonPress2,navNext,button\"} endon\n\nRule2 1\n</code></pre>"},{"location":"phys-btn/#decouple-buttons-from-controlling-power-outputs","title":"Decouple buttons from controlling power outputs","text":"<p>If you do not want your NSPanel physical buttons to trigger the relays and prefer to have them as software configurable buttons, open the Tasmota console of your NSPanel and enter the following:</p> <p><code>SetOption73 1</code></p> <p>Your relays will now appear as switches in HomeAssistant and you can control your buttons by using automations:</p> <p></p> <p>You may reverse this change by entering the following in the Tasmota console of your NSPanel:</p> <p><code>SetOption73 0</code></p> <p>Please note: Doing this will mean that if HomeAssistant is not working for any reason your buttons will not function correctly.</p>"},{"location":"prepare_ha/","title":"Prepare Home Assistant","text":""},{"location":"prepare_ha/#setup-home-assistant","title":"Setup Home Assistant","text":""},{"location":"prepare_ha/#installing-appdaemon","title":"Installing AppDaemon","text":"<p>The backend application for HomeAssistant is written in a python for AppDaemon.  This means it requires a working and running installation of AppDaemon.</p> <p>The easiest way to install it is through Home Assistant's Supervisor Add-on Store, it will be automaticly connected to your Home Assistant Instance.</p> <p></p> Instructions for users of HomeAssistant Core installed through docker containers.  In case you have a homeassistant setup using docker cotainers and the Add-on Store is not available to you, you can follow this guide for setting up AppDaemon. https://appdaemon.readthedocs.io/en/latest/DOCKER_TUTORIAL.html Please also pay attention to the correct volume mount for the conf folder of appdaemon, that has to point to the appdaemon folder within your homeassistant config folder.  Here is an example docker compose file for homeassistant and appdaemon:  <pre><code>version: \"3.5\"\nservices:\n  homeassistant:\n    image: ghcr.io/home-assistant/home-assistant:stable\n    container_name: homeassistant\n    network_mode: host\n    volumes:\n      - ./docker-data/homeassistant/:/config\n      - /etc/localtime:/etc/localtime:ro\n    environment:\n      - TZ=Europe/Berlin\n    privileged: true\n    restart: unless-stopped\n\n  appdaemon:\n    container_name: appdaemon\n    image: acockburn/appdaemon:4.2.3\n    environment:\n      - HA_URL=http://your-homeassistant-url:8123\n      - TOKEN=\"xxxxxx\"\n    volumes:\n      - /etc/localtime:/etc/localtime:ro\n      - ./docker-data/homeassistant/appdaemon:/conf\n    depends_on:\n      - homeassistant\n    restart: unless-stopped\n</code></pre>"},{"location":"prepare_ha/#add-babel-package-to-appdaemon-container-optional","title":"Add babel package to AppDaemon Container (Optional)","text":"<p>For localisation (date in your local language) you need to add the python package babel to your AppDaemon Installation.</p> <p></p>"},{"location":"prepare_ha/#installing-studio-code-server","title":"Installing Studio Code Server","text":"<p>You will need a way to edit the <code>apps.yaml</code> config file in the Appdaemon folder.  Install Studio Code Server from Home Assistant's Supervisor Add-on Store to easily edit configuration Files on your HomeAssistant Instance.</p>"},{"location":"prepare_ha/#installing-homeassistant-community-store","title":"Installing HomeAssistant Community Store","text":"<p>HACS is the Home Assistant Community Store and allows for community integrations and automations to be updated easily from the Home Assistant web user interface. You will be notified of updates, and they can be installed by a click on a button.</p>"},{"location":"prepare_ha/#installing-lovelace-appdaemon-backend-application","title":"Installing Lovelace AppDaemon Backend Application","text":"<p>To install Lovelace UI Backend App with HACS, you will need to make sure that you enabled AppDaemon automations in HACS, as these are not enabled by default:</p> <ol> <li>Click on <code>Configuration</code> on the left menu bar in Home Assistant Web UI</li> <li>Select <code>Devices &amp; Services</code></li> <li>Select <code>Integrations</code></li> <li>Find <code>HACS</code> and click on <code>Configure</code></li> <li>In the window that opens, make sure that <code>Enable AppDaemon apps discovery &amp; tracking</code>    is checked, or check it and click <code>Submit</code></li> <li>If you just enabled this (or just installed HACS), you might have to wait a few minutes    as all repositories are being fetched; you might hit a GitHub rate limit, which might    then require you to wait a few hours for HACS to be fully configured. In this case,    you won't be able to proceed to the next steps until HACS is ready.</li> </ol> <p>Now, to install NSPanel Lovelace UI Backend with HACS, follow these steps:</p> <ol> <li>Click on <code>HACS</code> on the left menu bar in Home Assistant Web UI</li> <li>Click on <code>Automations</code> in the right panel</li> <li>Click on <code>Explore &amp; download repositories</code> in the bottom right corner</li> <li>Search for <code>NSPanel</code>, and click on <code>NSPanel Lovelace UI Backend</code> in the list that appears</li> <li>In the bottom right corner of the panel that appears, click on    <code>Download this repository with HACS</code></li> <li>A confirmation panel will appear, click on <code>Download</code>, and wait for HACS to    proceed with the download</li> <li>The Backend Application is now installed, and HACS will inform you when updates are available</li> </ol>"},{"location":"prepare_nspanel/","title":"Prepare NsPanel","text":""},{"location":"prepare_nspanel/#flash-tasmota-to-your-nspanel","title":"Flash Tasmota to Your NSPanel","text":"<p>You need to connect to your NSPanel via serial and flash Tasmota using tasmota32-nspanel.bin. You can use the Tasmota Web Installer to do so.</p> <p>Check out Blakadder's Template Repo for more information on flashing. Do not use the autoexec.be from that page. NSPanel Page of the Tasmota Template Repository</p> <p>If you prefer ESPHome over Tasmota, you can use this third-party ESPHome component, which replaces Tasmota and the Berry driver used in this project. ESPHome Component</p>"},{"location":"prepare_nspanel/#configure-tasmota-template-for-nspanel","title":"Configure Tasmota Template for NSPanel","text":"<p>Configure the NSPanel template for Tasmota. (Go to Configuration &gt; Configure Other, paste the template there, and make sure to tick the Activate checkbox.)</p> <p></p> <p>You can use the following template or copy the one from the Tasmota Template Repo Site:</p> <p>{\"NAME\":\"NSPanel\",\"GPIO\":[0,0,0,0,3872,0,0,0,0,0,32,0,0,0,0,225,0,480,224,1,0,0,0,33,0,0,0,0,0,0,0,0,0,0,4736,0],\"FLAG\":0,\"BASE\":1,\"CMND\":\"ADCParam 2,11200,10000,3950 | Sleep 0 | BuzzerPWM 1\"}</p> <p>After a reboot of Tasmota, your screen will light up with the stock display firmware.</p>"},{"location":"prepare_nspanel/#upload-berry-driver-to-tasmota","title":"Upload Berry Driver to Tasmota","text":"<p>Go to Consoles &gt; Console in Tasmota and execute the following command:</p> <p>Backlog UrlFetch https://raw.githubusercontent.com/joBr99/nspanel-lovelace-ui/main/tasmota/autoexec.be; SetOption151 0; Restart 1</p> <p>This downloads the autoexec.be file from the repository and restarts Tasmota.</p> <p>Note: This command also disables Matter to free up memory, as it's unlikely to be used by most Home Assistant users. (Matter can cause memory issues during flashing of the Nextion screen, but you can re-enable it later if needed.)</p>"},{"location":"prepare_nspanel/#flash-firmware-to-nextion-screen","title":"Flash Firmware to Nextion Screen","text":"<p>Due to the limitations of Berry, it's not possible to download the TFT file directly from GitHub. A small server is available to download the file via HTTP.</p> <p>Use one of the following commands in the Tasmota console (not the Berry console) to flash the latest release from this repository:</p> <p>EU Version: FlashNextion http://nspanel.pky.eu/lui-release.tft</p> <p>US Version Portrait: FlashNextion http://nspanel.pky.eu/lui-us-p-release.tft</p> <p>US Version Landscape: FlashNextion http://nspanel.pky.eu/lui-us-l-release.tft</p> <p>After sending the command, the screen should show a progress bar. The flashing process takes around 5 minutes.</p> <p>Note for US users: You'll need to add the model config option to your apps.yaml later. More details can be found on the config overview page.</p> Alternatively, you can use your own web server or the one built into Home Assistant:  Upload the nspanel.tft from the latest release to a web server (for example, the www folder of Home Assistant) and execute the following command in the Tasmota Console.   (Development version: [TFT file from HMI folder](HMI/nspanel.tft))  **The web server must be HTTP. HTTPS is not supported due to Berry language limitations in Tasmota.**  FlashNextion http://ip-address-of-your-homeassistant:8123/local/nspanel.tft"},{"location":"prepare_nspanel_ioBroker/","title":"Prepare NsPanel","text":""},{"location":"prepare_nspanel_ioBroker/#flash-tasmota-to-your-nspanel","title":"Flash Tasmota to your NSPanel","text":"<p>You need to connect to your nspanel via serial and flash tasmota tasmota32-nspanel.bin to your NSPanel.  You can use the Tasmota Web Installer to do so. Tasmota Web Installer</p> <p>Checkout Blakadders Template Repo for more information on flashing, do not use the autoexec.be from this page. NSPanel Page of the Tasmota Template Repository</p> <p>If you prefer EspHome over Tasmota, you can use this thrid party esphome component, which is replacing tasmota and the berry driver of this project. ESPHome component</p>"},{"location":"prepare_nspanel_ioBroker/#configure-tasmota-template-for-nspanel","title":"Configure Tasmota Template for NSPanel","text":"<p>Configure the NSPanel template for Tasmota. (Go to Configuration and Configure Other and paste the template there, make sure to tick the activate checkbox)</p> <p></p> <p>You can use the following template or copy the one on the Tasmota Template Repo Site.</p> <p><code>{\"NAME\":\"NSPanel\",\"GPIO\":[0,0,0,0,3872,0,0,0,0,0,32,0,0,0,0,225,0,480,224,1,0,0,0,33,0,0,0,0,0,0,0,0,0,0,4736,0],\"FLAG\":0,\"BASE\":1,\"CMND\":\"ADCParam 2,11200,10000,3950 | Sleep 0 | BuzzerPWM 1\"}</code></p> <p>After a reboot of tasmota your screen will light up with the stock display firmware.</p>"},{"location":"prepare_nspanel_ioBroker/#upload-berry-driver-to-tasmota","title":"Upload Berry Driver to Tasmota","text":"<p>Go to <code>Consoles</code> &gt; <code>Console</code> in Tasmota and execute the following command:</p> <pre><code>Backlog UrlFetch https://raw.githubusercontent.com/joBr99/nspanel-lovelace-ui/main/tasmota/autoexec.be; Restart 1\n</code></pre>"},{"location":"prepare_nspanel_ioBroker/#flash-firmware-to-nextion-screen","title":"Flash Firmware to Nextion Screen","text":"<p>Due the limitations of Berry, it's not possible to download the tft file directly from github, so I'm also renting a small server where you can download the file via HTTP.</p> <p>Use the one following commands to flash the latest release from this repository, just execute the following Command in Tasmota:</p> <p>EU Version: <code>FlashNextion http://nspanel.pky.eu/lui-release.tft</code></p> <p>US Version Portrait: <code>FlashNextion http://nspanel.pky.eu/lui-us-p-release.tft</code></p> <p>US Version Landscape: <code>FlashNextion http://nspanel.pky.eu/lui-us-l-release.tft</code></p> Alternatively you can use your own webserver:  Upload the nspanel.tft from the lastest release to a Webserver and execute the following command in Tasmota Console.  **Webserver must be HTTP, HTTPS is not supported, due to limitations of berry lang on tasmota**  `FlashNextion http://ip-address-of-your-webserver:8123/local/nspanel.tft`"},{"location":"subpages/","title":"Subpages","text":""},{"location":"subpages/#subpages","title":"Subpages","text":"<p>You can configure entities with with the prefix <code>navigate</code>, that are navigating to cards, in case it's hidden card, the navigation items will change and the arrow is bringing you back to the previous page.</p> <pre><code>          - entity: navigate.testKey\n</code></pre> <p>will allow you to navigate to a cardGrid page with the configured key testKey</p> <pre><code>    hiddenCards:\n      - type: cardGrid\n        title: Exmaple Grid\n        entities:\n          - entity: light.test_item\n        key: testKey\n</code></pre>"},{"location":"subpages/#override-status-of-navigation-items","title":"Override Status of Navigation Items","text":"<p>You can override the status of navigation items, to make them look like different entities.</p> <pre><code>          - entity: navigate.testKey\n            status: climate.test\n</code></pre>"},{"location":"subpages/#override-navigation-items-itself","title":"Override Navigation Items itself","text":"<pre><code>    cards:\n      - type: cardGrid\n        title: Wohnzimmer\n        navItem1:\n          entity: light.bad_lights\n        navItem2:\n          entity: light.bad_lights\n        entities:\n</code></pre> <p>This can be used to add an home button to your subpages:</p> <pre><code>    cards:\n      - type: cardGrid\n        title: Home\n        key: home\n        entities:\n          - entity: light.bad\n\n    hiddenCards:\n      - type: cardGrid\n        title: Wohnzimmer\n        navItem2:\n          entity: navigate.home\n          icon: mdi:home\n        entities:\n          - entity: light.kitchen\n</code></pre>"}]}
\ No newline at end of file
diff --git a/stable/sitemap.xml b/stable/sitemap.xml
index 00f34f7b..1d922237 100644
--- a/stable/sitemap.xml
+++ b/stable/sitemap.xml
@@ -2,90 +2,90 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/card-alarm/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/card-climate/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/card-entities/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/card-grid/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/card-media/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/card-power/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/card-qr/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/card-unlock/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/config-overview/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/config-screensaver/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/configure_mqtt/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/entities/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/faq/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/hmi-serial-protocol/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/iobroker-install/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/notifications/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/phys-btn/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/prepare_ha/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/prepare_nspanel/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/prepare_nspanel_ioBroker/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
     <url>
          <loc>https://jobr99.github.io/nspanel-lovelace-ui/stable/subpages/</loc>
-         <lastmod>2025-11-29</lastmod>
+         <lastmod>2025-12-12</lastmod>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/stable/sitemap.xml.gz b/stable/sitemap.xml.gz
index 57da472942d4e614e3feeb2d3ad5e29e13bdfc50..040ad9a2c8dc5858955c1ce6501282f0eeca20cf 100644
GIT binary patch
literal 374
zcmV-+0g3(}iwFn+TRUk2|8r?{Wo=<_E_iKh0L|CUZi6rk0O0$c0&x#%D@|IbmP$M9
z3AS@(f(u^rL*oG3+b^ZnwEK2&gajDJ`Gi6gc85=AiwPrB@cVLIt;zzu2`%|<U%tP+
zs;BZ$KkUY68B>vyJ@3mtrQuoYd7dk#gboI-LhLk~KHspu2lcAjmi0rC+qJ;$YH2$g
zOnt4wxy(ms;&xkgl=`u$C}__Ec(lrf2`v~@BWX_1Skyax?fJV9aB`uoH>=H~T5s}^
zQ|__b$ogmK|3VmutpW?t3Gx_A4w9rdgg#LsWI?1ZQY(n#uq6=W8N!TFkmn)^Gy2^9
zECdw%i8_@Z#EEbgg<=yCJ;NksDlM)t;?Z4Fl3|jyHlE-j1JXNEjFG^qA%+x8urgqj
zbHf><BA+8xh{}gVCo+)o=1s^{8u~9*P4YrC5eLX0eh;!d_Y{$+BZZe`uFKHz*bLD9
UWu;tB`R}Fv2C8L~0PPF_09hNdH2?qr

literal 374
zcmV-+0g3(}iwFpSH!5iY|8r?{Wo=<_E_iKh0L|CIZi6rk0MPrs0&x#%D@_^`rP2=j
zg6&+H;DXnX&^W;M_e*It?Y<qH3t$}Q37H70!{=bL83U7d`+Qq$@(i8vExB%=zrVez
zr~FVqR8z2wF-ysg_jw=V_^kD^ECo}<0Y)x-=ro%?U9i3f^`<EE`XNi>THtoJj>>vd
zU#oB`^WmFNmPJRgpPGWac07VZtE`{Vf<ZNr<_L{NUFqx0--UqV;M;n)**&W5R_)4^
za*y3s);~-C7s5bj6<7#^Adj&$K$P@^&_#-bEQr(vY6WoyYzYK;M!#SX<he+~OfF47
z3juj|qE4k7VJ2Keq1XgO$1sa&rPVbBJPwx_Wte2`jVHLsfb;_?#z0`z7<}}`TNyA)
zx&DknkxLOPMCE*>6B&r<<4s5_jr|v^CORRSfFq<AzXw^Kdx}WZk^IZr>oRmaH6wI?
U*(ujU`g^Ir0WkNp-|Y+l0P~WwlmGw#