From e8c1f3692e7601ba52652fe2350d2ecc52a1f86a Mon Sep 17 00:00:00 2001
From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com>
Date: Sun, 28 May 2023 11:44:44 +0200
Subject: [PATCH] Updated (EN) Common Issues TFT Upload (markdown)

---
 (EN)-Common-Issues-TFT-Upload.md | 62 ++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/(EN)-Common-Issues-TFT-Upload.md b/(EN)-Common-Issues-TFT-Upload.md
index fb64b7a..81f1d67 100644
--- a/(EN)-Common-Issues-TFT-Upload.md
+++ b/(EN)-Common-Issues-TFT-Upload.md
@@ -26,3 +26,65 @@ The issue we have seen with this is _connection refused_ or _connection reset_.
 
 #### 4. DNS
 Related to point 2, please use IP address instead of DNS. e.g. use http://192.168.0.100:8123/local/nspanel.tft instead of http://homeassistant.local:8123/local/nspanel.tft
+
+#### 5. Check the file size by downloading to your computer
+Use the same url provided to ESPHome into your browser (in your computer), e.g. http://192.168.0.100:8123/local/nspanel_eu.tft, and make sure you can download the file to your computer and the file have the same size as the one from GitHub.
+
+#### 6. Try an alternative http service. There are many options available for free to run under you local Windows, MAC or Linux machine.
+Just to name some:
+- NGINX
+- IIS
+- Apache
+- Xampp
+- etc.
+
+#### 7. "Exit reparse" button
+One of the biggest challenges to a new user is to upload the TFT file for the first time. This is due to Sonoff using the [Protocol Reparse Mode](https://nextion.tech/instruction-set/#:~:text=20-,Advanced.,the%20serial%20buffer%20for%20processing) to control the communication with the Nextion display. This prevents ESPHome to communicate with the display using its default libraries and therefore prevents installing the new TFT.
+With this version you will have a new button named "Exit reparse", which will send a command to the Nextion to exit that mode for a few seconds, giving to the use a chance to then upload the TFT file without the need to change your ESPHome settings or using older Nextion libraries.
+![image](https://user-images.githubusercontent.com/94725493/235167581-50070e44-fff8-46b9-a036-c6b60b278d77.png)
+Once you have successfully uploaded any of the TFT files from this project (`nspanel_blank.tft`, `nspanel_eu.tft` or `nspanel_us.tft`), the reparse mode will be permanently disabled and this button is not needed anymore.
+
+If you have your panel displaying the Sonoff original screen, please follow the following steps to install your TFT file:
+a. Go to the front of your panel with a portable device with access to Home Assistant
+b. Open the device related to your panel under Settings > Device & Services > ESPHome
+c. Press the new button "Exit reparse" and wait for your panel to change it's screen to another page (which will take around 10s)
+d. While the new page is shown (it will be there for just a couple of seconds), press the button "Upload TFT"
+e. You should then see the progress bar in your display and after no more than 20 minutes the new TFT will be displayed
+
+#### 8. Use an older Nextion library for ESPHome
+
+If the error persists after trying all the options above, please try ending your ESPHOME with this and then press `Upload TFT` button:
+```yaml
+substitutions:
+
+###### CHANGE ME START ######
+
+  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_us.tft" # URL to local tft File
+#  nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel_us.tft" # URL to Github
+
+##### CHANGE ME END #####
+
+###### USE THIS ONLY FOR YOUR FIRST TFT UPLOAD, ONCE IT WORKED, REMOVE THESE LINES ######
+external_components:
+  - source: github://pr#2956
+    components: [nextion]
+    refresh: 1h
+###############################################################################
+
+
+##### DO NOT CHANGE ANYTHING! #####
+
+packages:
+  ##### download esphome code from Github
+  remote_package:
+    url: https://github.com/Blackymas/NSPanel_HA_Blueprint
+    ref: main
+    files: [nspanel_esphome.yaml]
+    refresh: 300s
+
+##### DO NOT CHANGE ANYTHING! #####
+```
\ No newline at end of file