Skip to content

(EN) Common Issues TFT Upload

Jump to bottom
Edward Firmo edited this page Sep 3, 2023 · 10 revisions

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


The previous method of having the NSPanel download the TFT directly from GitHub has been discontinued due to a large number of users experiencing slow or failed downloads. Please make sure you change to locally hosted tft file

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:

1. Using a local source (Home Assistant)

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

 

2. HTTP instead of HTTPS

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.

 

3. Network issues

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.

 

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. Power cycle your panel

Cut the power supply off, wait a bit, and power on again. It usually helps when you already tried many other things. If your panel is already installed in your wall, you probably can still power cycle using your power relay connected to that room.

 

7. Flash your panel again

Remove all add-ons and non-essential customization, flash your panel again (you can do this over the air/wirelessly), try to update the TFT, add the add-ons and removed customization back and then flash it again.

 

8. 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.

 

9. "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 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 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

 

10. 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:

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

Clone this wiki locally