From 6364f2574fe3806929b747c7f280c625b93f4216 Mon Sep 17 00:00:00 2001 From: danwright87 <87282093+danwright87@users.noreply.github.com> Date: Mon, 23 Jan 2023 19:09:10 +0000 Subject: [PATCH 01/20] Change to local tft file hosting --- (EN)-First-Steps---Installation-and-Setup.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index f857326..8dd152c 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -39,18 +39,20 @@ This section covers the initial configuration. All important steps for installat > It is also possible to copy the code from the file _**"nspnael_blueprint.yaml "**_ and paste it into HA. > You can find instructions for this under [Using Automation Blueprints](https://www.home-assistant.io/docs/automation/using_blueprints/) und [Automation blueprint tutorial](https://www.home-assistant.io/docs/blueprint/tutorial/#create-the-blueprint-file) -2. in the next step you have to create a new ESP32 device in ESPHome +2. You will need to download the nspanel.tft file and host it locally, you can use your Home assistant instance if required, see [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files section for details. -3. when the new ESP32 device has been created, next click _**"Edit "**_ on the device you have just created to open the web editor. Now the following code must be copied and pasted. +3. In the next step you have to create a new ESP32 device in ESPHome + +4. When the new ESP32 device has been created, next click _**"Edit "**_ on the device you have just created to open the web editor. Now the following code must be copied and pasted. > _**IMPORTANT!**_ The already existing code in the ESPHome file must be _**"COMPLETELY "**_ deleted and _**"REPLACED "**_ by the code below. -> _**IMPORTANT!**_ in the block _**"CHANGE ME "**_ all values _**(device_name, wifi_ssid, wifi_password)**_ in the _**" "**_ must be replaced by your own values. It is also possible to work here with _**"!secret "**_. +> _**IMPORTANT!**_ in the block _**"CHANGE ME "**_ all values _**(device_name, wifi_ssid, wifi_password, nextion_update_url )**_ in the _**" "**_ must be replaced by your own values. It is also possible to work here with _**"!secret "**_. -> _**ATTENTION!**_ for _**"device_name"**_ max. 15 characters _**[a-z] and [0-9]**_ may be used and all must be _**"lowercase"**_. Furthermore, characters like _**[-], [SPECIAL CHARACTARS] and [SPACES]**_ are forbidden and will cause problems with the blueprint. +> _**ATTENTION!**_ for _**"device_name"**_ max. 15 characters _**[a-z], [0-9] and [_]**_ may be used and all must be _**"lowercase"**_. Furthermore, characters like _**[-], [SPECIAL CHARACTARS] and [SPACES]**_ are forbidden and will cause problems with the blueprint. -**Example:** _**nspanel_blackymas**_ +**Example:** _**nspanel_kitchen**_   ### CODE: @@ -62,6 +64,7 @@ substitutions: device_name: "YOUR NSPANEL_NAME" wifi_ssid: "YOUR WIFI SSID" wifi_password: "YOUR WIFI PASSWORD" + nextion_update_url: "YOUR PATH TO nspanel.tft FROM STEP 2" ##### CHANGE ME ##### @@ -69,7 +72,6 @@ substitutions: ##### DO NOT CHANGE ANYTHING! ##### - nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" packages: ##### download esphome code from Github remote_package: @@ -96,7 +98,7 @@ packages: > _**NOTE!**_ In the blueprint, in the _**"ESPHOME Node Name"**_ field, enter exactly the same name that you assigned in the _**"ESPHome File"**_. -> **Beispiel:** _**nspanel_blackymas**_ +> **Beispiel:** _**nspanel_kitchen**_     From 0baf261bb10545eb948c1f313c0bd1d10f6c7fca Mon Sep 17 00:00:00 2001 From: danwright87 <87282093+danwright87@users.noreply.github.com> Date: Mon, 23 Jan 2023 19:13:21 +0000 Subject: [PATCH 02/20] fixed markup on underscore in allowed characters --- (EN)-First-Steps---Installation-and-Setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index 8dd152c..5955ba1 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -50,7 +50,7 @@ This section covers the initial configuration. All important steps for installat > _**IMPORTANT!**_ in the block _**"CHANGE ME "**_ all values _**(device_name, wifi_ssid, wifi_password, nextion_update_url )**_ in the _**" "**_ must be replaced by your own values. It is also possible to work here with _**"!secret "**_. -> _**ATTENTION!**_ for _**"device_name"**_ max. 15 characters _**[a-z], [0-9] and [_]**_ may be used and all must be _**"lowercase"**_. Furthermore, characters like _**[-], [SPECIAL CHARACTARS] and [SPACES]**_ are forbidden and will cause problems with the blueprint. +> _**ATTENTION!**_ for _**"device_name"**_ max. 15 characters _**[a-z], [0-9] and [\_]**_ may be used and all must be _**"lowercase"**_. Furthermore, characters like _**[-], [SPECIAL CHARACTARS] and [SPACES]**_ are forbidden and will cause problems with the blueprint. **Example:** _**nspanel_kitchen**_ From 8bc805a044b03cf702799c81f509f36986ca36b1 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 21:22:28 +0100 Subject: [PATCH 03/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index 5955ba1..3d14114 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -64,7 +64,6 @@ substitutions: device_name: "YOUR NSPANEL_NAME" wifi_ssid: "YOUR WIFI SSID" wifi_password: "YOUR WIFI PASSWORD" - nextion_update_url: "YOUR PATH TO nspanel.tft FROM STEP 2" ##### CHANGE ME ##### @@ -72,6 +71,7 @@ substitutions: ##### DO NOT CHANGE ANYTHING! ##### + nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" packages: ##### download esphome code from Github remote_package: From 3f8623f37848362e3b92db41b4e371154238b6b2 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 21:25:33 +0100 Subject: [PATCH 04/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index 3d14114..32272c1 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -61,9 +61,12 @@ substitutions: ###### CHANGE ME ###### - device_name: "YOUR NSPANEL_NAME" - wifi_ssid: "YOUR WIFI SSID" - wifi_password: "YOUR WIFI PASSWORD" + device_name: "nspanel_buero" # ändere Name zum Beispiel in den Raum wo das NSPanel verbaut wird. Wird im Blueprint benötigt + wifi_ssid: !secret wifi_ssid # Gib dein WLAN Name ein + wifi_password: !secret wifi_password # Gib dein Passwort fürs WLAN ein + + nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel/nspanel.tft" # URL to local tft File +# nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" ##### CHANGE ME ##### @@ -71,7 +74,6 @@ substitutions: ##### DO NOT CHANGE ANYTHING! ##### - nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" packages: ##### download esphome code from Github remote_package: From 25ffc5c4026e48d22af11dc15513b174195093e2 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 21:39:13 +0100 Subject: [PATCH 05/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 30 +++++++++++++------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index 32272c1..0ae0faf 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -39,11 +39,19 @@ This section covers the initial configuration. All important steps for installat > It is also possible to copy the code from the file _**"nspnael_blueprint.yaml "**_ and paste it into HA. > You can find instructions for this under [Using Automation Blueprints](https://www.home-assistant.io/docs/automation/using_blueprints/) und [Automation blueprint tutorial](https://www.home-assistant.io/docs/blueprint/tutorial/#create-the-blueprint-file) -2. You will need to download the nspanel.tft file and host it locally, you can use your Home assistant instance if required, see [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files section for details. +2. You have to download the file **_nspanel.tft_** from Github -3. In the next step you have to create a new ESP32 device in ESPHome +![Bildschirmfoto 2023-01-23 um 21 31 05](https://user-images.githubusercontent.com/41958506/214144182-e2a5f28e-e96d-4263-8c4b-b7fbcc6658e7.png) -4. When the new ESP32 device has been created, next click _**"Edit "**_ on the device you have just created to open the web editor. Now the following code must be copied and pasted. + +3. Upload the **_nspnael.tft_** file to your **_Home Assistant Server_** in the **_www_** folder, see [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files section for details. + +![Bildschirmfoto 2023-01-23 um 21 33 20](https://user-images.githubusercontent.com/41958506/214144729-08fb5d3f-9255-4f57-9c6e-a5e33665e4df.png) + + +4. In the next step you have to create a new ESP32 device in ESPHome + +5. When the new ESP32 device has been created, next click _**"Edit "**_ on the device you have just created to open the web editor. Now the following code must be copied and pasted. > _**IMPORTANT!**_ The already existing code in the ESPHome file must be _**"COMPLETELY "**_ deleted and _**"REPLACED "**_ by the code below. @@ -59,16 +67,16 @@ This section covers the initial configuration. All important steps for installat ``` substitutions: -###### CHANGE ME ###### +###### CHANGE ME START ###### device_name: "nspanel_buero" # ändere Name zum Beispiel in den Raum wo das NSPanel verbaut wird. Wird im Blueprint benötigt wifi_ssid: !secret wifi_ssid # Gib dein WLAN Name ein wifi_password: !secret wifi_password # Gib dein Passwort fürs WLAN ein - nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel/nspanel.tft" # URL to local tft File + nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel.tft" # URL to local tft File # nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" -##### CHANGE ME ##### +##### CHANGE ME END ##### @@ -87,16 +95,16 @@ packages:   -4. Now the NSPanel can be flashed with the new ESPHome code. +6. Now the NSPanel can be flashed with the new ESPHome code. > how to flash the NSPanel you can see here [HOW TO - Flash Sonoff NSPanel with ESPHome](https://www.youtube.com/watch?v=p-AK4o5jOSI) -5. After the NSPanel is flashed, you can go to _**"Settings --> Devices & Services --> Add Integration"**_ to add your new device and finish setting it up. +7. After the NSPanel is flashed, you can go to _**"Settings --> Devices & Services --> Add Integration"**_ to add your new device and finish setting it up. -6. In the last step, only the TFT must be uploaded. To do this, open your new device in the ESPHome integration and activate the item _**"Update TFT display "**_ under _**"Configuration"**_. Now the current TFT file is loaded from Github and uploaded to your NSPanel. _**ATTENTION!**_ this process may take a moment. +8. In the last step, only the TFT must be uploaded. To do this, open your new device in the ESPHome integration and activate the item _**"Update TFT display "**_ under _**"Configuration"**_. Now the current TFT file is loaded from Github and uploaded to your NSPanel. _**ATTENTION!**_ this process may take a moment. -7. now the setup of ESPHome and NSPanel is completed. +9. now the setup of ESPHome and NSPanel is completed. -8. Now you can configure your NSPanel via the Blueprint. To do this, go to _**"Settings --> Automations & Scenes --> Templates --> NSPanel Configuration --> CREATE AUTOMATION"**_ and start with the setup of the NSPanel. +10. Now you can configure your NSPanel via the Blueprint. To do this, go to _**"Settings --> Automations & Scenes --> Templates --> NSPanel Configuration --> CREATE AUTOMATION"**_ and start with the setup of the NSPanel. > _**NOTE!**_ In the blueprint, in the _**"ESPHOME Node Name"**_ field, enter exactly the same name that you assigned in the _**"ESPHome File"**_. From c48e6ef1d753ec3791ef18332f17c0b275b1dcce Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 21:50:29 +0100 Subject: [PATCH 06/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 31 +++++++++++++------- 1 file changed, 21 insertions(+), 10 deletions(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index 0ae0faf..f65b4b8 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -32,26 +32,26 @@ This section covers the initial configuration. All important steps for installat ## 1. Short version of the setup of Esphome and Blueprint > _**(for those who already have experience with ESPhome and Home Assistant)**_ -1. First you have to install the Blueprint. For this please use the following link +### 1. First you have to install the Blueprint. For this please use the following link [![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgithub.com%2FBlackymas%2FNSPanel_HA_Blueprint%2Fblob%2Fmain%2Fnspanel_blueprint.yaml) > It is also possible to copy the code from the file _**"nspnael_blueprint.yaml "**_ and paste it into HA. > You can find instructions for this under [Using Automation Blueprints](https://www.home-assistant.io/docs/automation/using_blueprints/) und [Automation blueprint tutorial](https://www.home-assistant.io/docs/blueprint/tutorial/#create-the-blueprint-file) -2. You have to download the file **_nspanel.tft_** from Github +### 2. You have to download the file **_nspanel.tft_** from Github ![Bildschirmfoto 2023-01-23 um 21 31 05](https://user-images.githubusercontent.com/41958506/214144182-e2a5f28e-e96d-4263-8c4b-b7fbcc6658e7.png) -3. Upload the **_nspnael.tft_** file to your **_Home Assistant Server_** in the **_www_** folder, see [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files section for details. +### 3. Upload the **_nspnael.tft_** file to your **_Home Assistant Server_** in the **_www_** folder, see [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files section for details. ![Bildschirmfoto 2023-01-23 um 21 33 20](https://user-images.githubusercontent.com/41958506/214144729-08fb5d3f-9255-4f57-9c6e-a5e33665e4df.png) -4. In the next step you have to create a new ESP32 device in ESPHome +### 4. In the next step you have to create a new ESP32 device in ESPHome -5. When the new ESP32 device has been created, next click _**"Edit "**_ on the device you have just created to open the web editor. Now the following code must be copied and pasted. +### 5. When the new ESP32 device has been created, next click _**"Edit "**_ on the device you have just created to open the web editor. Now the following code must be copied and pasted. > _**IMPORTANT!**_ The already existing code in the ESPHome file must be _**"COMPLETELY "**_ deleted and _**"REPLACED "**_ by the code below. @@ -93,18 +93,29 @@ packages: ##### DO NOT CHANGE ANYTHING! ##### ``` +> At **_http://HOME-ASSISTANT-IP:8123/local/nspanel.tft_** you have to enter your _**IP from Home Assistant**_. + +> This could look like this **_http://192.168.1.1:8123/local/nspanel.tft_** + +> _**ATTENTION!**_ You can also comment out the path nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" and load the TFT directly from Github. But it can happen that there are problems with the upload to the NSPanel. It should then look like this + +``` +# nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel.tft" # URL to local tft File + nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" +``` +   -6. Now the NSPanel can be flashed with the new ESPHome code. +### 6. Now the NSPanel can be flashed with the new ESPHome code. > how to flash the NSPanel you can see here [HOW TO - Flash Sonoff NSPanel with ESPHome](https://www.youtube.com/watch?v=p-AK4o5jOSI) -7. After the NSPanel is flashed, you can go to _**"Settings --> Devices & Services --> Add Integration"**_ to add your new device and finish setting it up. +### 7. After the NSPanel is flashed, you can go to _**"Settings --> Devices & Services --> Add Integration"**_ to add your new device and finish setting it up. -8. In the last step, only the TFT must be uploaded. To do this, open your new device in the ESPHome integration and activate the item _**"Update TFT display "**_ under _**"Configuration"**_. Now the current TFT file is loaded from Github and uploaded to your NSPanel. _**ATTENTION!**_ this process may take a moment. +### 8. In the last step, only the TFT must be uploaded. To do this, open your new device in the ESPHome integration and activate the item _**"Update TFT display "**_ under _**"Configuration"**_. Now the current TFT file is loaded from local Home Assistant Server or Github and uploaded to your NSPanel. _**ATTENTION!**_ this process may take a moment. -9. now the setup of ESPHome and NSPanel is completed. +### 9. now the setup of ESPHome and NSPanel is completed. -10. Now you can configure your NSPanel via the Blueprint. To do this, go to _**"Settings --> Automations & Scenes --> Templates --> NSPanel Configuration --> CREATE AUTOMATION"**_ and start with the setup of the NSPanel. +### 10. Now you can configure your NSPanel via the Blueprint. To do this, go to _**"Settings --> Automations & Scenes --> Templates --> NSPanel Configuration --> CREATE AUTOMATION"**_ and start with the setup of the NSPanel. > _**NOTE!**_ In the blueprint, in the _**"ESPHOME Node Name"**_ field, enter exactly the same name that you assigned in the _**"ESPHome File"**_. From 6d0d7fa3d0bba4c70364e9f659ab3bfc0cfa84ca Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 21:58:37 +0100 Subject: [PATCH 07/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index f65b4b8..be5627c 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -69,12 +69,12 @@ substitutions: ###### CHANGE ME START ###### - device_name: "nspanel_buero" # ändere Name zum Beispiel in den Raum wo das NSPanel verbaut wird. Wird im Blueprint benötigt - wifi_ssid: !secret wifi_ssid # Gib dein WLAN Name ein - wifi_password: !secret wifi_password # Gib dein Passwort fürs WLAN ein + device_name: "YOUR NSPANEL_NAME" + wifi_ssid: "YOUR WIFI SSID" + wifi_password: "YOUR WIFI PASSWORD" nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel.tft" # URL to local tft File -# nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" +# nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" # URL to Github ##### CHANGE ME END ##### From 588ecff5c6f3b992f28387867c12d8d2d1fa485f Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 21:59:32 +0100 Subject: [PATCH 08/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index be5627c..850d5e9 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -1,6 +1,6 @@ This section covers the initial configuration. All important steps for installation and setup of ESPHome and the Blueprint are described here.  -⭐ **_Step by Step [Setup Video](https://www.youtube.com/watch?v=3afPFg6kUdc)_** +⭐ **_Step by Step [Setup Video](https://www.youtube.com/watch?v=jpSTA_ILB8g)_**   From b17d8cbbd313d6ef1217285ee61be0de16a054dd Mon Sep 17 00:00:00 2001 From: danwright87 <87282093+danwright87@users.noreply.github.com> Date: Mon, 23 Jan 2023 21:02:31 +0000 Subject: [PATCH 09/20] fix translations --- (EN)-First-Steps---Installation-and-Setup.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index 850d5e9..bf7490a 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -37,14 +37,14 @@ This section covers the initial configuration. All important steps for installat [![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgithub.com%2FBlackymas%2FNSPanel_HA_Blueprint%2Fblob%2Fmain%2Fnspanel_blueprint.yaml) > It is also possible to copy the code from the file _**"nspnael_blueprint.yaml "**_ and paste it into HA. -> You can find instructions for this under [Using Automation Blueprints](https://www.home-assistant.io/docs/automation/using_blueprints/) und [Automation blueprint tutorial](https://www.home-assistant.io/docs/blueprint/tutorial/#create-the-blueprint-file) +> You can find instructions for this under [Using Automation Blueprints](https://www.home-assistant.io/docs/automation/using_blueprints/) and [Automation blueprint tutorial](https://www.home-assistant.io/docs/blueprint/tutorial/#create-the-blueprint-file) ### 2. You have to download the file **_nspanel.tft_** from Github ![Bildschirmfoto 2023-01-23 um 21 31 05](https://user-images.githubusercontent.com/41958506/214144182-e2a5f28e-e96d-4263-8c4b-b7fbcc6658e7.png) -### 3. Upload the **_nspnael.tft_** file to your **_Home Assistant Server_** in the **_www_** folder, see [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files section for details. +### 3. Upload the **_nspnael.tft_** file to your **_Home Assistant Server_** in the **_www_** folder, see [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files' section for details. ![Bildschirmfoto 2023-01-23 um 21 33 20](https://user-images.githubusercontent.com/41958506/214144729-08fb5d3f-9255-4f57-9c6e-a5e33665e4df.png) @@ -119,7 +119,7 @@ packages: > _**NOTE!**_ In the blueprint, in the _**"ESPHOME Node Name"**_ field, enter exactly the same name that you assigned in the _**"ESPHome File"**_. -> **Beispiel:** _**nspanel_kitchen**_ +> **Example:** _**nspanel_kitchen**_     From 255eaeacb299c9b6e8f6c7a364b619259726eb69 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 22:26:45 +0100 Subject: [PATCH 10/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index bf7490a..4c79f6a 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -53,12 +53,12 @@ This section covers the initial configuration. All important steps for installat ### 5. When the new ESP32 device has been created, next click _**"Edit "**_ on the device you have just created to open the web editor. Now the following code must be copied and pasted. -> _**IMPORTANT!**_ The already existing code in the ESPHome file must be _**"COMPLETELY "**_ deleted and _**"REPLACED "**_ by the code below. +> ❗ _**IMPORTANT!**_ The already existing code in the ESPHome file must be _**"COMPLETELY "**_ deleted and _**"REPLACED "**_ by the code below. -> _**IMPORTANT!**_ in the block _**"CHANGE ME "**_ all values _**(device_name, wifi_ssid, wifi_password, nextion_update_url )**_ in the _**" "**_ must be replaced by your own values. It is also possible to work here with _**"!secret "**_. +> ❗ _**IMPORTANT!**_ in the block _**"CHANGE ME "**_ all values _**(device_name, wifi_ssid, wifi_password, nextion_update_url )**_ in the _**" "**_ must be replaced by your own values. It is also possible to work here with _**"!secret "**_. -> _**ATTENTION!**_ for _**"device_name"**_ max. 15 characters _**[a-z], [0-9] and [\_]**_ may be used and all must be _**"lowercase"**_. Furthermore, characters like _**[-], [SPECIAL CHARACTARS] and [SPACES]**_ are forbidden and will cause problems with the blueprint. +> ⚠️ _**ATTENTION!**_ for _**"device_name"**_ max. 15 characters _**[a-z], [0-9] and [\_]**_ may be used and all must be _**"lowercase"**_. Furthermore, characters like _**[-], [SPECIAL CHARACTARS] and [SPACES]**_ are forbidden and will cause problems with the blueprint. **Example:** _**nspanel_kitchen**_ @@ -97,7 +97,7 @@ packages: > This could look like this **_http://192.168.1.1:8123/local/nspanel.tft_** -> _**ATTENTION!**_ You can also comment out the path nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" and load the TFT directly from Github. But it can happen that there are problems with the upload to the NSPanel. It should then look like this +> ⚠️ _**ATTENTION!**_ You can also comment out the path nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" and load the TFT directly from Github. But it can happen that there are problems with the upload to the NSPanel. It should then look like this ``` # nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel.tft" # URL to local tft File From 57dbf13e41700d580e760ffe50fcc786a68a5e32 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 23:23:41 +0100 Subject: [PATCH 11/20] Updated (DE) Erste Schritte Installation und Einrichtung (markdown) --- ...Schritte---Installation-und-Einrichtung.md | 50 +++++++++++++++---- 1 file changed, 39 insertions(+), 11 deletions(-) diff --git a/(DE)-Erste-Schritte---Installation-und-Einrichtung.md b/(DE)-Erste-Schritte---Installation-und-Einrichtung.md index 53d18c6..b172499 100644 --- a/(DE)-Erste-Schritte---Installation-und-Einrichtung.md +++ b/(DE)-Erste-Schritte---Installation-und-Einrichtung.md @@ -31,16 +31,30 @@ In diesem Beitrag geht es um die erst Konfiguration. Hier werden alle wichtigen ## 1. Kurz Version der Einrichtung von Esphome und Blueprint > _**(für alle die bereits mit ESPhome und Home Assistant Erfahrung haben)**_ -1. Als erstes muss das Blueprint installiert werden. Dazu nutze bitte folgenden Link +### 1. Als erstes muss das Blueprint installiert werden. Dazu nutze bitte folgenden Link [![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgithub.com%2FBlackymas%2FNSPanel_HA_Blueprint%2Fblob%2Fmain%2Fnspanel_blueprint.yaml) > Es ist auch möglich den Code aus der Datei _**"nspnael_blueprint.yaml"**_ zu kopieren und in HA einzufügen. > Hinweise dazu findest du unter [Using Automation Blueprints](https://www.home-assistant.io/docs/automation/using_blueprints/) und [Automation blueprint tutorial](https://www.home-assistant.io/docs/blueprint/tutorial/#create-the-blueprint-file) -2. im nächsten Schritt muss eine neues ESP32 Device in ESPHome erstellt werden +### 2. Nun muss von Github das File **_"nspanel.tft"_** herunter geladen werden -3. wenn das neue ESP32 Device erstellt wurde, klicke als nächstes bei dem soeben angelegten Device auf _**"Edit"**_ um den Web-Editor zu öffnen. Nun muss folgender Code kopiert und eingesetzt werden. +![Bildschirmfoto 2023-01-23 um 21 31 05](https://user-images.githubusercontent.com/41958506/214161397-ec927f77-be77-433d-84a5-79fbfed33932.png) + + +### 3. Das File **_"nspanel.tft"_** muss nun auf deinen Home Assistant Server in den Ordner **_"www"_** hochgeladen werden. Siehe dazu auch hier [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files' Bereich für weiter Informationen. + +![Bildschirmfoto 2023-01-23 um 21 33 20](https://user-images.githubusercontent.com/41958506/214162088-3bd67e46-c389-496f-a937-757ad63e1fe2.png) + + + + + + +### 4. im nächsten Schritt muss eine neues ESP32 Device in ESPHome erstellt werden + +### 5. wenn das neue ESP32 Device erstellt wurde, klicke als nächstes bei dem soeben angelegten Device auf _**"Edit"**_ um den Web-Editor zu öffnen. Nun muss folgender Code kopiert und eingesetzt werden. > ❗ _**WICHTIG!**_ Der bereits vorhanden Code in der ESPHome Datei muss _**"KOMPLETT"**_ gelöscht werden und durch den unten stehenden Code _**"ERSETZT"**_ werden. @@ -56,19 +70,21 @@ In diesem Beitrag geht es um die erst Konfiguration. Hier werden alle wichtigen ``` substitutions: -###### CHANGE ME ###### +###### CHANGE ME START ###### device_name: "YOUR NSPANEL_NAME" wifi_ssid: "YOUR WIFI SSID" wifi_password: "YOUR WIFI PASSWORD" -##### CHANGE ME ##### + nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel.tft" # URL to local tft File +# nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" # URL to Github + +##### CHANGE ME END ##### ##### DO NOT CHANGE ANYTHING! ##### - nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" packages: ##### download esphome code from Github remote_package: @@ -80,18 +96,30 @@ packages: ##### DO NOT CHANGE ANYTHING! ##### ``` + +> Im Pfad **_http://HOME-ASSISTANT-IP:8123/local/nspanel.tft_** muss nun die IP Adresse von deinem _**Home Assistant Server**_ eingetragen werden. (_**/local/**_ ist das selbe Verzeichnis wie **_"www"_** + +> Das kann dann wie folgt aussehen **_http://192.168.1.1:8123/local/nspanel.tft_** + +> ⚠️ **_ACHTUNG_** Du kannst auch den Pfad zu Github verwenden **_https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft_** und das TFT direkt von Github herunter laden. Aber dabei kann es zu Problemen mit dem Upload zum NSPanel kommen. Das hängt von deinem Internet und WLAN ab. Für mehr Informationen zu diesem Thema schauen auf der **_Issue_** Seite im Github. Das ganze sollte dann so aussehen + +``` +# nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel.tft" # URL to local tft File + nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" # URL to Github +``` +   -4. Jetzt kann das NSPanel mit dem neuen ESPHome Code geflasht werden +### 6. Jetzt kann das NSPanel mit dem neuen ESPHome Code geflasht werden > wie das NSPanel geflasht wird kannst du dir hier ansehen [HOW TO - Flash Sonoff NSPanel with ESPHome](https://www.youtube.com/watch?v=p-AK4o5jOSI) -5. Nachdem das NSPanel fertig geflasht wurde, kannst du unter _**"Einstellungen --> Geräte & Dienste --> Integration hinzufügen"**_ dein neues Gerät hinzufügen und fertig einrichten +### 7. Nachdem das NSPanel fertig geflasht wurde, kannst du unter _**"Einstellungen --> Geräte & Dienste --> Integration hinzufügen"**_ dein neues Gerät hinzufügen und fertig einrichten -6. im letzten Schritt muss nun nur noch das TFT hochgeladen werden. Dazu öffne in der Integration ESPHome dein neues Device und aktiviere unter _**"Konfiguration"**_ den Punkt _**"Update TFT display"**_. Jetzt wird aus Github das aktuelle TFT File geladen und auf dein NSPanel hochgeladen. _**ACHTUNG!**_ dieser Vorgang kann einen Moment dauern +### 8. im letzten Schritt muss nun nur noch das TFT hochgeladen werden. Dazu öffne in der Integration ESPHome dein neues Device und aktiviere unter _**"Konfiguration"**_ den Punkt _**"Update TFT display"**_. Jetzt wird aus Github das aktuelle TFT File geladen und auf dein NSPanel hochgeladen. _**ACHTUNG!**_ dieser Vorgang kann einen Moment dauern -7. jetzt ist die Einrichtung vom ESPHome und dem NSPanel abgeschlossen. +### 9. jetzt ist die Einrichtung vom ESPHome und dem NSPanel abgeschlossen. -8. Nun kannst du über das Blueprint dein NSPanel konfigurieren. Dazu gehe auf _**"Einstellungen --> Automatisierungen & Szenen --> Vorlagen --> NSPanel Configuration --> AUTOMATISIERUNG ERSTELLEN"**_ und starte mit der Einrichtung vom NSPanel. +#### 10. Nun kannst du über das Blueprint dein NSPanel konfigurieren. Dazu gehe auf _**"Einstellungen --> Automatisierungen & Szenen --> Vorlagen --> NSPanel Configuration --> AUTOMATISIERUNG ERSTELLEN"**_ und starte mit der Einrichtung vom NSPanel. > **HINWEIS!** Trage im Blueprint im Feld _**"ESPHOME Node Name"**_ exakt den selben Namen ein, den du in der _**"ESPHome Datei"**_ vergeben hast. From 5567e1845092a9f39586ac0175ac023349cf76e3 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 23:27:23 +0100 Subject: [PATCH 12/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index 4c79f6a..7122284 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -107,7 +107,7 @@ packages:   ### 6. Now the NSPanel can be flashed with the new ESPHome code. -> how to flash the NSPanel you can see here [HOW TO - Flash Sonoff NSPanel with ESPHome](https://www.youtube.com/watch?v=p-AK4o5jOSI) +> how to flash the NSPanel you can see here [Anleitung NSPanel Flashen](https://www.youtube.com/watch?v=3afPFg6kUdc) ### 7. After the NSPanel is flashed, you can go to _**"Settings --> Devices & Services --> Add Integration"**_ to add your new device and finish setting it up. From 087f57ef63fdc131006f7fafbf38ce90bfe77d20 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 23:29:23 +0100 Subject: [PATCH 13/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index 7122284..0ec03f5 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -107,7 +107,7 @@ packages:   ### 6. Now the NSPanel can be flashed with the new ESPHome code. -> how to flash the NSPanel you can see here [Anleitung NSPanel Flashen](https://www.youtube.com/watch?v=3afPFg6kUdc) +> how to flash the NSPanel you can see here [HowTo - Flash NSPanel with ESPhome](https://www.youtube.com/watch?v=jpSTA_ILB8g) ### 7. After the NSPanel is flashed, you can go to _**"Settings --> Devices & Services --> Add Integration"**_ to add your new device and finish setting it up. From 520aab6b64bb68a340786eb1aeb372d448a133c9 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 23:30:32 +0100 Subject: [PATCH 14/20] Updated (DE) Erste Schritte Installation und Einrichtung (markdown) --- (DE)-Erste-Schritte---Installation-und-Einrichtung.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/(DE)-Erste-Schritte---Installation-und-Einrichtung.md b/(DE)-Erste-Schritte---Installation-und-Einrichtung.md index b172499..b6d3014 100644 --- a/(DE)-Erste-Schritte---Installation-und-Einrichtung.md +++ b/(DE)-Erste-Schritte---Installation-und-Einrichtung.md @@ -111,7 +111,7 @@ packages:   ### 6. Jetzt kann das NSPanel mit dem neuen ESPHome Code geflasht werden -> wie das NSPanel geflasht wird kannst du dir hier ansehen [HOW TO - Flash Sonoff NSPanel with ESPHome](https://www.youtube.com/watch?v=p-AK4o5jOSI) +> wie das NSPanel geflasht wird kannst du dir hier ansehen [Anleitung - Flash Sonoff NSPanel mit ESPHome](https://www.youtube.com/watch?v=3afPFg6kUdc) ### 7. Nachdem das NSPanel fertig geflasht wurde, kannst du unter _**"Einstellungen --> Geräte & Dienste --> Integration hinzufügen"**_ dein neues Gerät hinzufügen und fertig einrichten From 8222f4cad884856dca71331f8236ec78b4edcbfe Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 23:32:01 +0100 Subject: [PATCH 15/20] Updated (DE) Erste Schritte Installation und Einrichtung (markdown) --- ...Schritte---Installation-und-Einrichtung.md | 23 ++++++++----------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/(DE)-Erste-Schritte---Installation-und-Einrichtung.md b/(DE)-Erste-Schritte---Installation-und-Einrichtung.md index b6d3014..f21599b 100644 --- a/(DE)-Erste-Schritte---Installation-und-Einrichtung.md +++ b/(DE)-Erste-Schritte---Installation-und-Einrichtung.md @@ -31,30 +31,25 @@ In diesem Beitrag geht es um die erst Konfiguration. Hier werden alle wichtigen ## 1. Kurz Version der Einrichtung von Esphome und Blueprint > _**(für alle die bereits mit ESPhome und Home Assistant Erfahrung haben)**_ -### 1. Als erstes muss das Blueprint installiert werden. Dazu nutze bitte folgenden Link +#### 1. Als erstes muss das Blueprint installiert werden. Dazu nutze bitte folgenden Link [![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgithub.com%2FBlackymas%2FNSPanel_HA_Blueprint%2Fblob%2Fmain%2Fnspanel_blueprint.yaml) > Es ist auch möglich den Code aus der Datei _**"nspnael_blueprint.yaml"**_ zu kopieren und in HA einzufügen. > Hinweise dazu findest du unter [Using Automation Blueprints](https://www.home-assistant.io/docs/automation/using_blueprints/) und [Automation blueprint tutorial](https://www.home-assistant.io/docs/blueprint/tutorial/#create-the-blueprint-file) -### 2. Nun muss von Github das File **_"nspanel.tft"_** herunter geladen werden +#### 2. Nun muss von Github das File **_"nspanel.tft"_** herunter geladen werden ![Bildschirmfoto 2023-01-23 um 21 31 05](https://user-images.githubusercontent.com/41958506/214161397-ec927f77-be77-433d-84a5-79fbfed33932.png) -### 3. Das File **_"nspanel.tft"_** muss nun auf deinen Home Assistant Server in den Ordner **_"www"_** hochgeladen werden. Siehe dazu auch hier [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files' Bereich für weiter Informationen. +#### 3. Das File **_"nspanel.tft"_** muss nun auf deinen Home Assistant Server in den Ordner **_"www"_** hochgeladen werden. Siehe dazu auch hier [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files' Bereich für weiter Informationen. ![Bildschirmfoto 2023-01-23 um 21 33 20](https://user-images.githubusercontent.com/41958506/214162088-3bd67e46-c389-496f-a937-757ad63e1fe2.png) +#### 4. im nächsten Schritt muss eine neues ESP32 Device in ESPHome erstellt werden - - - - -### 4. im nächsten Schritt muss eine neues ESP32 Device in ESPHome erstellt werden - -### 5. wenn das neue ESP32 Device erstellt wurde, klicke als nächstes bei dem soeben angelegten Device auf _**"Edit"**_ um den Web-Editor zu öffnen. Nun muss folgender Code kopiert und eingesetzt werden. +#### 5. wenn das neue ESP32 Device erstellt wurde, klicke als nächstes bei dem soeben angelegten Device auf _**"Edit"**_ um den Web-Editor zu öffnen. Nun muss folgender Code kopiert und eingesetzt werden. > ❗ _**WICHTIG!**_ Der bereits vorhanden Code in der ESPHome Datei muss _**"KOMPLETT"**_ gelöscht werden und durch den unten stehenden Code _**"ERSETZT"**_ werden. @@ -110,14 +105,14 @@ packages:   -### 6. Jetzt kann das NSPanel mit dem neuen ESPHome Code geflasht werden +#### 6. Jetzt kann das NSPanel mit dem neuen ESPHome Code geflasht werden > wie das NSPanel geflasht wird kannst du dir hier ansehen [Anleitung - Flash Sonoff NSPanel mit ESPHome](https://www.youtube.com/watch?v=3afPFg6kUdc) -### 7. Nachdem das NSPanel fertig geflasht wurde, kannst du unter _**"Einstellungen --> Geräte & Dienste --> Integration hinzufügen"**_ dein neues Gerät hinzufügen und fertig einrichten +#### 7. Nachdem das NSPanel fertig geflasht wurde, kannst du unter _**"Einstellungen --> Geräte & Dienste --> Integration hinzufügen"**_ dein neues Gerät hinzufügen und fertig einrichten -### 8. im letzten Schritt muss nun nur noch das TFT hochgeladen werden. Dazu öffne in der Integration ESPHome dein neues Device und aktiviere unter _**"Konfiguration"**_ den Punkt _**"Update TFT display"**_. Jetzt wird aus Github das aktuelle TFT File geladen und auf dein NSPanel hochgeladen. _**ACHTUNG!**_ dieser Vorgang kann einen Moment dauern +#### 8. im letzten Schritt muss nun nur noch das TFT hochgeladen werden. Dazu öffne in der Integration ESPHome dein neues Device und aktiviere unter _**"Konfiguration"**_ den Punkt _**"Update TFT display"**_. Jetzt wird von deinem lokalen Home Assistant Server oder Github das aktuelle TFT File geladen und auf dein NSPanel hochgeladen. _**ACHTUNG!**_ dieser Vorgang kann einen Moment dauern -### 9. jetzt ist die Einrichtung vom ESPHome und dem NSPanel abgeschlossen. +#### 9. jetzt ist die Einrichtung vom ESPHome und dem NSPanel abgeschlossen. #### 10. Nun kannst du über das Blueprint dein NSPanel konfigurieren. Dazu gehe auf _**"Einstellungen --> Automatisierungen & Szenen --> Vorlagen --> NSPanel Configuration --> AUTOMATISIERUNG ERSTELLEN"**_ und starte mit der Einrichtung vom NSPanel. From 6cbe38e4c605092ba92c67ccb11a4cf67d8b612e Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 23:38:12 +0100 Subject: [PATCH 17/20] Updated (EN) First Steps Installation and Setup (markdown) --- (EN)-First-Steps---Installation-and-Setup.md | 22 ++++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/(EN)-First-Steps---Installation-and-Setup.md b/(EN)-First-Steps---Installation-and-Setup.md index 0ec03f5..ab686a2 100644 --- a/(EN)-First-Steps---Installation-and-Setup.md +++ b/(EN)-First-Steps---Installation-and-Setup.md @@ -32,26 +32,26 @@ This section covers the initial configuration. All important steps for installat ## 1. Short version of the setup of Esphome and Blueprint > _**(for those who already have experience with ESPhome and Home Assistant)**_ -### 1. First you have to install the Blueprint. For this please use the following link +#### 1. First you have to install the Blueprint. For this please use the following link [![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgithub.com%2FBlackymas%2FNSPanel_HA_Blueprint%2Fblob%2Fmain%2Fnspanel_blueprint.yaml) > It is also possible to copy the code from the file _**"nspnael_blueprint.yaml "**_ and paste it into HA. > You can find instructions for this under [Using Automation Blueprints](https://www.home-assistant.io/docs/automation/using_blueprints/) and [Automation blueprint tutorial](https://www.home-assistant.io/docs/blueprint/tutorial/#create-the-blueprint-file) -### 2. You have to download the file **_nspanel.tft_** from Github +#### 2. You have to download the file **_nspanel.tft_** from Github ![Bildschirmfoto 2023-01-23 um 21 31 05](https://user-images.githubusercontent.com/41958506/214144182-e2a5f28e-e96d-4263-8c4b-b7fbcc6658e7.png) -### 3. Upload the **_nspnael.tft_** file to your **_Home Assistant Server_** in the **_www_** folder, see [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files' section for details. +#### 3. Upload the **_nspnael.tft_** file to your **_Home Assistant Server_** in the **_www_** folder, see [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files' section for details. ![Bildschirmfoto 2023-01-23 um 21 33 20](https://user-images.githubusercontent.com/41958506/214144729-08fb5d3f-9255-4f57-9c6e-a5e33665e4df.png) -### 4. In the next step you have to create a new ESP32 device in ESPHome +#### 4. In the next step you have to create a new ESP32 device in ESPHome -### 5. When the new ESP32 device has been created, next click _**"Edit "**_ on the device you have just created to open the web editor. Now the following code must be copied and pasted. +#### 5. When the new ESP32 device has been created, next click _**"Edit "**_ on the device you have just created to open the web editor. Now the following code must be copied and pasted. > ❗ _**IMPORTANT!**_ The already existing code in the ESPHome file must be _**"COMPLETELY "**_ deleted and _**"REPLACED "**_ by the code below. @@ -97,7 +97,7 @@ packages: > This could look like this **_http://192.168.1.1:8123/local/nspanel.tft_** -> ⚠️ _**ATTENTION!**_ You can also comment out the path nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" and load the TFT directly from Github. But it can happen that there are problems with the upload to the NSPanel. It should then look like this +> ⚠️ _**ATTENTION!**_ You can also comment out the path nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft" and load the TFT directly from Github. But it can happen that there are problems with the upload to the NSPanel. This depends on your internet and wifi. For more information on this issue, see the issue page on Github. It should then look like this ``` # nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel.tft" # URL to local tft File @@ -106,16 +106,16 @@ packages:   -### 6. Now the NSPanel can be flashed with the new ESPHome code. +#### 6. Now the NSPanel can be flashed with the new ESPHome code. > how to flash the NSPanel you can see here [HowTo - Flash NSPanel with ESPhome](https://www.youtube.com/watch?v=jpSTA_ILB8g) -### 7. After the NSPanel is flashed, you can go to _**"Settings --> Devices & Services --> Add Integration"**_ to add your new device and finish setting it up. +#### 7. After the NSPanel is flashed, you can go to _**"Settings --> Devices & Services --> Add Integration"**_ to add your new device and finish setting it up. -### 8. In the last step, only the TFT must be uploaded. To do this, open your new device in the ESPHome integration and activate the item _**"Update TFT display "**_ under _**"Configuration"**_. Now the current TFT file is loaded from local Home Assistant Server or Github and uploaded to your NSPanel. _**ATTENTION!**_ this process may take a moment. +#### 8. In the last step, only the TFT must be uploaded. To do this, open your new device in the ESPHome integration and activate the item _**"Update TFT display "**_ under _**"Configuration"**_. Now the current TFT file is loaded from local Home Assistant Server or Github and uploaded to your NSPanel. _**ATTENTION!**_ this process may take a moment. -### 9. now the setup of ESPHome and NSPanel is completed. +#### 9. now the setup of ESPHome and NSPanel is completed. -### 10. Now you can configure your NSPanel via the Blueprint. To do this, go to _**"Settings --> Automations & Scenes --> Templates --> NSPanel Configuration --> CREATE AUTOMATION"**_ and start with the setup of the NSPanel. +#### 10. Now you can configure your NSPanel via the Blueprint. To do this, go to _**"Settings --> Automations & Scenes --> Templates --> NSPanel Configuration --> CREATE AUTOMATION"**_ and start with the setup of the NSPanel. > _**NOTE!**_ In the blueprint, in the _**"ESPHOME Node Name"**_ field, enter exactly the same name that you assigned in the _**"ESPHome File"**_. From 0fec4169ba980fb6110ee645b8b65fe3ba896727 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 23:41:08 +0100 Subject: [PATCH 19/20] Updated Home (markdown) --- Home.md | 1 + 1 file changed, 1 insertion(+) diff --git a/Home.md b/Home.md index 330191e..8db19ca 100644 --- a/Home.md +++ b/Home.md @@ -13,6 +13,7 @@ This Wiki will grow over time and we are trying to keep up with the rapid develo DE - **_[Einrichtungs und Konfigurations Video](https://www.youtube.com/watch?v=3afPFg6kUdc) - SmartHome yourself_** EN - **_[Overview and features](https://www.youtube.com/watch?v=b7vW4YtUaTs) - Mark Watt Tech_** +EN - **_[HOW TO Setup](https://www.youtube.com/watch?v=jpSTA_ILB8g) - Mark Watt Tech_**     From 6e5b08b84597dcf9c6dc3ca57d4de73ac63266f6 Mon Sep 17 00:00:00 2001 From: Blackymas <41958506+Blackymas@users.noreply.github.com> Date: Mon, 23 Jan 2023 23:41:24 +0100 Subject: [PATCH 20/20] Updated Home (markdown) --- Home.md | 1 + 1 file changed, 1 insertion(+) diff --git a/Home.md b/Home.md index 8db19ca..7ceea5e 100644 --- a/Home.md +++ b/Home.md @@ -13,6 +13,7 @@ This Wiki will grow over time and we are trying to keep up with the rapid develo DE - **_[Einrichtungs und Konfigurations Video](https://www.youtube.com/watch?v=3afPFg6kUdc) - SmartHome yourself_** EN - **_[Overview and features](https://www.youtube.com/watch?v=b7vW4YtUaTs) - Mark Watt Tech_** + EN - **_[HOW TO Setup](https://www.youtube.com/watch?v=jpSTA_ILB8g) - Mark Watt Tech_**