OpenNextion openHASP turns your screen into a touch control panel for Home Assistant. No coding needed—just edit a JSON config file following the official format to add buttons for lights, air conditioning, scenes, and more. You can freely adjust their positions and styles. Flash the firmware to the screen, connect to Wi‑Fi and MQTT, and it becomes a fully touch‑controlled smart home dashboard. All operations sync with Home Assistant in real time, and the status updates instantly.
| Feature | Description |
|---|---|
| JSON‑configured UI | Freely define the screen layout by writing simple JSON files – no programming required, easy to get started. |
| Rich UI components | Design freely with buttons, switches, sliders, arc controls, labels, color pickers, dropdown menus, and more. |
| MQTT protocol communication | All operations and statuses are transmitted via MQTT, compatible with Home Assistant, openHAB, and other open‑source smart home platforms. |
| Web‑based device management | Provides a web management interface with online UI preview, file editing, network configuration, firmware upgrades, etc. |
| OTA firmware updates | Supports over‑the‑air upgrades without re‑flashing. |
Before starting, ensure the USB cable supports data transfer and maintain a stable connection between the board and your computer.
After successful flashing, the board will automatically restart.
After the firmware is flashed, you can configure the network using either of the following methods:
Once the network is configured, the device will display its assigned IP address at every boot, making it easy to access later.
After network configuration is complete, enter the IP address shown on the device into your browser to access the web management backend. The backend mainly offers the following features:
| Function | Description |
|---|---|
| HASP Design | Upload and edit page layout JSON files online. |
| Screenshot | Take and save a screenshot of the current UI preview. |
| Information | View device status and MQTT connection status. |
| Configuration | Configure Wi‑Fi, MQTT, HTTP, and other connection settings. |
| Firmware Update | Perform online OTA upgrades. |
| File Editor | A simple file management system that allows uploading resource files and modifying page layouts in real time via the web. |
Before integrating openHASP into Home Assistant, you need to install HACS (Home Assistant Community Store).
*Detailed tutorial:__ https://hacs.xyz/docs/use/configuration/basic/
Click the link and enter the verification code shown in Home Assistant: https://github.com/login/device
After completing the above steps, HACS installation is finished.
Search for the openHASP integration in HACS and install it, then restart Home Assistant.
openHASP relies on MQTT to communicate with Home Assistant. You need to configure it in Home Assistant:
*Remember to note the port number at the bottom of the MQTT user configuration.
In the openHASP device web backend, go to Settings → MQTT Settings and fill in the following:
livingroom_panel.After configuration, restart the device. The openHASP device will then be automatically discovered in Home Assistant.
openHASP and Home Assistant must be on the same local network for discovery to work.
💡 Tip: If the device entity status does not appear correctly, check the MQTT connection status on the openHASP integration configuration page. After configuration, a restart is required (Main Menu → Restart).
First, you need to set up a UI layout containing components in the device web backend under “File Editor”.
For example, display an icon for a light.
{
"page": 1,
"id": 10,
"x": 110,
"y": 190,
"w": 100,
"h": 100,
"obj": "btn",
"toggle": true,
"text": "\uE335"
}
To make the panel components functional, you need to configure control events for them – for example, triggering on/off actions when a button is pressed or released.
There are three ways to edit automation events for components:
For detailed instructions, see the official documentation: How-To - openHASP
openHASP is an open-source firmware project that turns a regular touch screen into a smart home control panel. An openHASP-equipped screen can communicate via MQTT with smart home systems like Home Assistant to control devices.
No. The UI is configured through JSON files, which are a structured data format. You just need to follow the official syntax. Refer to: https://www.openhasp.com/0.7.0/examples/widgets/
Not necessarily. Since openHASP is based on the MQTT protocol, it can be used completely without Home Assistant, directly connecting to Node-RED or any MQTT-compatible system. This is why openHASP is very flexible.
Simply edit the corresponding JSON file in the device's web backend under "File Editor". After saving, refresh the screen to see the new UI. Some changes may require a device restart to take effect.
Yes. A configured openHASP device will appear as a device entity in Home Assistant, with two-way synchronization – actions on the screen sync to Home Assistant, and changes in Home Assistant device status are reflected back on the screen.
Among the three methods, the openHASP integration approach is more stable. The automation method may occasionally have a delay where the status reverts to the previous state, while the openHASP integration handles event attribute changes internally, ensuring more accurate status feedback.
In the device backend under "Configuration -> GPIO Settings", you can map GPIO pins as entities. After modification, you need to restart the device, and then delete the existing device in Home Assistant and re-add it for the GPIO entities to display properly.