Firmware Striscia Led monocolore compatibile HomeKit: installazione e configurazione

In questa breve e semplificata guida è spiegato come flashare e configurare il dispositivo Magic Home mono per renderlo compatibile con Apple Homekit.

Occorrente

Controller Magic Home -- https://amzn.to/2LJc87Q

Convertitore seriale USB -- https://amzn.to/2YzHJ03

Cavetti jumper Dupont -- https://amzn.to/2YyBObv

Saldatore -- https://amzn.to/2YwIgjg (consiglio questo modello)

 

Collegamento al lettore

Collega il tuo lettore seriale al Magic Home, saldando i PIN dei cavi dupont sulla PCB così come nello schema indicato qui sotto.

NOTA: fai molta attenzione quando effettui la saldatura della GPIO0, poichè vi sono molte piste nelle adiacenze.

Installazione con OTA

Scarica otaboot.binrboot.bin e blank_config.bin all'interno di una cartella (che per comodità chiameremo files e posizioneremo sul Desktop). Assicurati di aver collegato il tuo NodeMCU così come illustrato al passo precedente. Il tuo dispositivo è quindi già in flash mode e non dovrai fare altri passaggi. Collega la porta USB al mac. Usa esptool.py per "flashare" il dispositivo.

Primo step: fai un "erase"

Posizionati tramite terminale con il comando cd all'interno della cartella dove avevi in precedenza salvato i file

cd Desktop/files

A questo punto puoi iniziare l'erase del nostro device 

esptool.py -p /dev/your_ESPPort erase_flash

Generalmente la porta ESP è /dev/tty.SLAB_USBtoUART oppure /dev/tty.USB0000

Puoi fare una ricerca tra i vari dispositivi con il comando ls /dev/tty* che ti mostrerà tutti i dispositivi connessi Effettuato l'erase dovreste avere un messaggio come il seguente: 

Chip erase completed successfully in 0.0s Hard resetting via RTS pin... 

La procedura è quindi andata a buon fine e possiamo passare allo step successivo. Rimetti in flash mode il dispositivo e passa allo step successivo.

Secondo step: flash firmware OTA

esptool.py -p /dev/your_ESPPort --baud 115200 write_flash -fs 1MB -fm dout -ff 40m \ 0x0 rboot.bin 0x1000 blank_config.bin 0x2000 otaboot.bin 

Nota: se stai usando una vecchia versione di esptool, devi cambiare -fs 1MB con -fs 8MB 

Effettuato l'upload del firmware dovresti avere un messaggio come il seguente:

Hash of data verified. Leaving... Hard resetting via RTS pin... 

Effettuato questo scollega il cavo usb dal tuo mac, scollega il PIN collegato alla GPIO0 e ricollega il cavo USB.

(Facoltativo)

Se vuoi puoi controllare quanto avviene nel dispositivo attraverso il monitor seriale, lanciando questo comando:

screen /dev/your_ESPPort 115200

Terzo step: configurazione OTA

Ora andremo a configurare la rete wi-fi e la repositery da installare. Il dispositivo, una volta avviato, genera una sua rete wifi che inizia con LCM ed è seguita dagli ultimi numeri del mac address. Per iniziare la configurazione iniziamo con il collegare un dispositivo iOS a questa rete (sarà sufficiente andare in Impostazioni, Wi-Fi e cercare tra le varie reti raggiungibili la rete che inizia con LCM- e collegarci).

Dopo alcuni secondi si aprirà automaticamente una finestra come quella nell'immmagine qui sotto

Procedi con questo ordine, assicurati di aver seguito tutti e 5 i punti prima di premere il tasto Join!

1. seleziona la rete wifi a cui vuoi connettere il dispositivo

2. nel campo Password inserisci la password della rete wi-fi selezionata

3. sostituisci il testo presente nel campo OTA repositery con curla92/LED-Dimmer-Homekit

4. non modificare il testo presente nel campo OTA Binary File e quindi lascia la voce main.bin

5. premi il pulsante Join. Una volta cliccato il tasto join il tuo device inizierà a scaricare l'ultima release del firmware direttamente dalla repositery GitHub. Questa procedura impiega circa 5-7 minuti. 

Nota: se questo step fallisce devi iniziare la procedura dal primo step.

Quarto step: installazione nell'app Casa

Segui le normali procedure per aggiungere un dispositivo all'applicazione Casa di Apple. Non appena l'app ti chiederà di inquadrare il codice di configurazione di HomeKit, inquadra la seguente immagine:

 

(nel qual caso non riesci a far inquadrare correttamente il codice al tuo iPhone/iPad, clicca su "Non hai il codice o non puoi scansionarlo?" poi vai alla voce "codice manuale" e clicca su "inserisci codice". Inserisci quindi il codice a 8 cifre seguente: 277-66-227

Nota. per le versioni 2.1.0 ed inferiori del firmware il codice di pairing è il seguente: 111-11-111

L'operazione di pairing del tuo dispositivo impiega circa 30-60 secondi. Non appena terminato il paring potrai vedere aggiunto il tuo dispositivo nell'app casa di Apple.

Nota: se il pairing fallisce sarà sufficiente riavviare il tuo dispositivo e procedere nuovamente con questo step (non la procedura dall'inizio). 

Quinto step: configurazione nell'app EVE

Ecco come andrà configurato il tuo Magic Home nell'app EVE:

1) Actual Dev Type va impostato su MAGICHOME  

2) Device Type va impostato su 2  

3) Led GPIO di base impostato su 12 

4) Led delay di base impostato su (modificabile)

5) Toggle GPIO va impostato su 

6) External toggle type va impostato:

- su 1 se desideri collegarlo ad un pulsante (CONSIGLIATO)

- su 2 se desideri collegarlo ad un interruttore

Configurati i parametri impostiamo Reboot su usciamo dalla finestra di configurazione e dall'app (se la nostra app Casa è aperta chiudiamola. Attendiamo circa 10 secondi e riapriamo l'app Casa. Avremo ora il nostro dispositivo configurato e pronto per essere utilizzato.

Ora è possibile dissaldare tutti i cavi dupont, saldati al primo passaggio, dalla pcb del Magic Home.

 

NOTA: Le voci 7,8 e 9 indicano rispettivamente: l'indirizzo IP del dispositivo nella rete LAN, lo switch per il riavvio del dispositivo e lo switch per l'aggiornamento OTA del firmware.

 
Questa guida è stata realizzata grazie al contributo dell'amico Francesco Curlettirealizzatore del firmware (messo a disposizione gratuitamente su GitHub). Si ringrazia altresì l'amico Gianluca Piergentili che ha dato il suo prezioso contributo per la realizzazione.

Filippo Lizza

42 Blog post

Commenti
Stefano 4 anni

Molto interessante ma c’è un modo per poterlo comandare anche con un pulsante o interruttore fisico ???
Grazie

 
 
Giaino 4 anni

Scusate ma non riesco a capire come bisogna cablare il magic home rispetto alla striscia LED; soprattutto con quei due connettori jack come faccio? Grazie