When your panel starts, a number of different things needs to be set and the ESPHome must establish connection to the Nextion display used by your panel and also to your Home Assistant, which will provide the proper settings required by your panel. If everything goes right, the boot page will be shown for just a few seconds, then the wake-up page will be shown.
If something happens during this process, your panel may get stuck on this page. In many cases, restarting your panel can resolve the issue, but if it is still showing the boot page after a reboot, this guide may help you.
Understanding what is shown on the boot page can be useful to find the cause of the problem or when you are looking for help.
Your boot page probably looks like this:
Before Home Assistant/ESPHome is connected:
When Home Assistant/ESPHome is connected:
In the top, you will see the message "Initializing..." while the display is executing it's boot sequence or waiting for a connection from ESPHome.
Once ESPHome is connected to both the display and the Wi-Fi network, that text will be replace by the IP address, which can be useful for troubleshooting.
On the top right corner, it's shown the baud rate used by the display to communicate to ESPHome. By default, all the communication should happens at 115200 bps, but as 921600 bps is also supported, the display will alternate between these 2 rates every 30 seconds until ESPHome gets connected.
Right bellow the baud rate information, you may see the framework used by ESPHome, which is either esp-idf (default for new installations) or arduino (default for installations prior v4.1.4).
That information will be available only when ESPHome establishes communication with the display. If you cannot see that information after a couple of seconds then you may have an issue on the communication between ESPHome and the display (explained later).
Here you may see the version of TFT, ESPHome and Blueprint used by this project.
If some of those versions are not shown, you can have an indication of where a possible communication issue is.
- TFT version will always be shown, as that is part of the display itself.
- ESPHome version will be shown as soon the ESPHome establishes the communication with the display.
- Blueprint version requires both ESPHome and the Blueprint (in Home Assistant) to establish communication to be shown.
In normal situation, all the versions should be displayed and should be the same. Different patch versions are supported.
You can use this button to force a reboot of your panel. This button is available when ESPHome establishes communication with the display.
Symptoms: The ESPHome version (and other info) won't be shown in the boot page.
| Possible causes | Suggestions |
|---|---|
| You may have an older version of ESPHome installed or ESPHome is not installed. | Make sure you have the latest version of ESPHome and flash your device again. |
| Baud rate mismatch. | The default baud rate for this project is 115200 bps, however your device might be set with a different baud rate. Use the baud rate selector under your device's page to adjust to the same baud rate as the display, then change it back to 115200 bps, which will instruct the display to start using that. |
Symptoms: The ESPHome version is shown, but not the blueprint version or, the Home page is shown, but the Home Assistant icon is shown in red and typically the functionality is very limited:
In some cases you can also see duplicate entities on the device's page in Home Assistant, and some of these entities may have the entity_id ending with _2, _3, etc.
| Possible causes | Suggestions |
|---|---|
| You may have an older version of the blueprint installed or the blueprint isn't installed into your Home Assistant. | Install the blueprint. Update the blueprint. |
| You don't have an automation created using the blueprint. | On Home Assistant, go to Settings --> Automations & Scenes --> Blueprints --> NSPanel Configuration --> CREATE AUTOMATION and follow the instructions to setup your automation. Attention!! You need one automation per panel, if you have more than one panel set. |
| Your panel is not selected in the automation. | Open the automation related to your panel and make sure the right device is set on the NSPanel device field. |
| Your panel's connection to Home Assistant may have issues. This could be from an invalid entity Id (e.g. ending with _2), or some action missing registration. |
Reconnect the Panel's device to Home Assistant: 1. Go to Settings --> Devices & services --> ESPHome 2. Delete the device 3. Restart Home Assistant host 4. Go back to Settings --> Devices & services 5. Click Add integration 6. Select ESPHome 7. Enter your panel's hostname or IP address. |
After troubleshooting, if issues persist, consult the Issues and feel free to create a new one asking for more personalized assistance.
Please share as much info as possible, like:
- Describing (or a picture of) what is on your screen
- Are you updating from a previous version of this project, or you coming from another NSPanel customization (which one?) or are you customizing for the first time a panel with the original Sonoff settings?
- Please share the ESPHome logs from when your panel starts to the moment the upload fails.
- Describe what you have already tried.
Remember, these steps are a guideline and might vary slightly based on your specific setup and previously installed system.