-
-
Notifications
You must be signed in to change notification settings - Fork 266
(EN) Common Issues TFT Upload
ATTENTION! if you have already installed the version "nspanel-lovelace-ui" from joBr99 on your NSPanel, an intermediate step is necessary - otherwise it is not possible to install this or any other version.
See (EN) Common Issues | TFT Upload When nspanel lovelace ui has been installed
There are a number of issues that can affect the upload of the TFT upload, these are not issues with the NSPanel HA Blueprint project but seem to be common to Nextion displays and ESPhome. Not all of the below causes affect all users however following instructions in each point have resolved
In order of likelihood:
This is our most common cause of issues and is the reason our instructions no longer point to downloading the TFT from GitHub, changing the nextion_update_url to host the TFT file on your home assistant resolves the majority of issues.
See points 2-4 from the Installation Instructions
While HTTPS may work for some users we have seen it cause a number of issues. Change your TFT file hosting and nextion_update_url to use http.
Check there are no issues with your network, bring your NSPanel and router closer together or try rebooting the router.
The issue we have seen with this is connection refused or connection reset.
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
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.
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 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.
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
If the error persists after trying all the options above, please try ending your ESPHOME with this and then press Upload TFT
button:
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#5016
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! #####
Nspanel Beschreibung