openHASP

openHASP (HASwitchPlate): pagine touch per Home Assistant descritte in JSONL e comandate via MQTT. Funziona con l'integrazione openHASP di HACS.

versione 0.7.0.1 · Licenza: MIT · Sito del progetto

openHASP

A cosa serve

openHASP trasforma il pannello in un'interfaccia touch per Home Assistant. È il progetto della community HASwitchPlate: le pagine (pulsanti, interruttori, slider, termometri, orologi, icone) si descrivono in un file JSONL e si comandano via MQTT. Chi usa già openHASP con Home Assistant ritrova le stesse pagine e la stessa integrazione.

Cosa serve prima

1. Un broker MQTT, di solito il componente aggiuntivo Mosquitto broker di Home Assistant.
2. Sul pannello: Impostazioni > Casa, inserisci broker, utente e password MQTT e attiva la connessione.
3. In Home Assistant installa l'integrazione openHASP da HACS (HASwitchPlate/openHASP-custom-component).

Come si usa

• Apri openHASP: il pannello si presenta su MQTT con il nome plate (topic hasp/plate/...).
• In Home Assistant l'integrazione lo trova da sola: aggiungilo e indica il tuo file di pagine (pages_jsonl). L'integrazione carica le pagine e collega gli oggetti alle entità.
• In alternativa, senza Home Assistant, copia un file pages.jsonl nella cartella /sdcard/apps/openhasp/data/ (app File o companion web) e riapri l'app.
• Il gesto indietro torna alla pagina precedente; dalla prima pagina chiude l'app.

Configurazione facoltativa

Un file /sdcard/apps/openhasp/data/config.json cambia nome del nodo, gruppo, pagina iniziale e fuso orario:

{"mqtt": {"name": "cucina", "group": "casa"}, "time": {"zone": "CET-1CEST,M3.5.0,M10.5.0/3"}}

Prova rapida da un PC

mosquitto_pub -t hasp/plate/command/p1b2.text -m "Ciao"
mosquitto_pub -t hasp/plate/command/page -m 2

Limiti

• Immagini da URL (http://...) e il servizio push_image non sono supportati: le immagini PNG vanno copiate nella cartella dati e indicate come L:/nome.png.
• Niente GPIO, relè, web UI, OTA e Wi-Fi propri di openHASP: rete, aggiornamenti e MQTT sono quelli del sistema.
• reboot e restart non fanno nulla.

Crediti

openHASP (MIT) © openHASP contributors, https://github.com/HASwitchPlate/openHASP. LVGL 7 (MIT), ArduinoJson (MIT), FreeType (FTL: "Portions of this software are copyright © The FreeType Project (www.freetype.org). All rights reserved."). I testi completi delle licenze sono nel file LICENSE.txt dell'app.

openHASP

openHASP (HASwitchPlate): touch pages for Home Assistant described in JSONL and driven over MQTT. Works with the openHASP integration from HACS.

version 0.7.0.1 · License: MIT · Project site

openHASP

What it is for

openHASP turns the panel into a touch interface for Home Assistant. It is the HASwitchPlate community project: pages (buttons, switches, sliders, gauges, clocks, icons) are described in a JSONL file and driven over MQTT. If you already use openHASP with Home Assistant, the same pages and the same integration work here.

Before you start

1. An MQTT broker, usually Home Assistant's Mosquitto broker add-on.
2. On the panel: Settings > Home, enter the MQTT broker, user and password and turn the connection on.
3. In Home Assistant install the openHASP integration from HACS (HASwitchPlate/openHASP-custom-component).

How to use it

• Open openHASP: the panel announces itself on MQTT as plate (topics hasp/plate/...).
• Home Assistant finds it: add it and point the integration to your pages file (pages_jsonl). The integration pushes the pages and links objects to entities.
• Without Home Assistant, copy a pages.jsonl to /sdcard/apps/openhasp/data/ (Files app or web companion) and reopen the app.
• The back gesture goes to the previous page; on the first page it closes the app.

Optional configuration

/sdcard/apps/openhasp/data/config.json sets node name, group, start page and time zone:

{"mqtt": {"name": "kitchen", "group": "home"}, "time": {"zone": "CET-1CEST,M3.5.0,M10.5.0/3"}}

Quick test from a PC

mosquitto_pub -t hasp/plate/command/p1b2.text -m "Hello"
mosquitto_pub -t hasp/plate/command/page -m 2

Limits

• Images from URLs (http://...) and the push_image service are not supported: copy PNG images to the data folder and use L:/name.png.
• No openHASP GPIO, relays, web UI, OTA or Wi-Fi: networking, updates and MQTT come from the system.
• reboot and restart do nothing.

Credits

openHASP (MIT) © openHASP contributors, https://github.com/HASwitchPlate/openHASP. LVGL 7 (MIT), ArduinoJson (MIT), FreeType (FTL: "Portions of this software are copyright © The FreeType Project (www.freetype.org). All rights reserved."). Full license texts are in the app's LICENSE.txt.