Skip to content

Guida

Jump to bottom
vglucas edited this page Nov 25, 2019 · 2 revisions

Guide

HomekitFlasher is a simple application for Windows desktop environments developed for free and downloadable from https://github.com/vglucas/HomeKitFlasher. An excellent tool dedicated to those who are not familiar with the terminal and want to make, and speed up, the flash of their device. The main and predefined actions of the system also allow the RavenCore firmware flash, developed by José A. Jiménez and Life Cycle Manager called OTA (acronym of Over The Air) and created by HacK (HomeACcessoryKid). As we will see below, the program also allows third-party firmware flashes thanks to a simplified interface. Sections of the program Here are the summary items of the six sections that make up the program:

  1. Menu The menu is located at the top below the title bar, which contains a welcome message. File Clicking on this item will open a drop-down menu where "Dir Homekit" will appear, which will take us to the folder where the files are downloaded, "Updates", which allows you to check for updates and eventually download them and the "Exit" item which allows the closure of the program. Credits Clicking on this item will open a window showing the relative data of the program version, copyritght and developer contacts. ? Clicking on this item will open a drop-down menu containing the menu to choose the language, check for updates and report a possible problem or a new feature iBuy New session where you will find the tools, already tested and working, to start your projects

  2. Serial converter section This section is located on the left and below the title bar. It consists of three elements, namely: Connected devices Clicking on the drop-down menu you can view the serial converters (or devices like in the case of the NodeMCU) connected to the computer. You can then select the one you want to use. Door This window will show the communication port corresponding to the serial device selected in the "Connected devices" Scan connected devices By clicking on this button the program will perform a new scan in search of serial converters, making them appear among the "Connected devices".

  3. Extraction, backup and default flash section This section is located in the middle - left section and under the "Scan connected devices" button. It consists of six elements, namely: MAC Address

In this window, at the end of the procedure performed for illustrated in the following point, the MAC address of the device connected to our serial converter will appear. Extract Mac Clicking this button will start the automatic procedure which, once completed, will show the MAC address of the device connected to the serial converter in the "MAC Address" window indicated in the previous point. Original firmware backup By clicking on this button the program will backup the firmware installed on the device connected to the serial converter. Erase firmware By clicking on this button the program will perform an erase or the deletion of the memory of our device, permanently eliminating the firmware previously installed. Flash OTA firmware Clicking on this button the program will install the latest version of the LCM - Life Cycle Manager firmware that we have called OTA several times in group posts or in the forum. Flash Ravencore last version By clicking on this button the program will install the latest version of the Ravencore firmware present in the repository of our site. In this way a flash will be made in the c.d. "Not OTA" procedure (therefore not updateable remotely).
4. Command window This section is located in the right part, is placed under the title bar and looks like a window with a white background. In this window the commands launched by the program via terminal and the status (always from the terminal) of the procedure started will appear.
5. Manual Flash section This section is located in the central part - right, below the "Command Window". It consists of four elements, namely: File 1 ... By clicking on the "..." button next to the "File 1" window, you can choose the first file with the .bin extension to flash. In the window on the right side, the address corresponding to the uploaded file (for example 0x0) will be inserted instead. File 2 ... Click on the "..." button next to the "File 2" window to select the second file with a .bin extension to flash. In the window on the right side, the address corresponding to the uploaded file (for example 0x1000) will be inserted instead. File 3 ... Click on the "..." button next to the "File 3" window to select the third file with the .bin extension to flash. In the window on the right side, the address corresponding to the uploaded file (for example 0x2000) will be inserted instead. Charge By clicking on this button the program will load the files selected in File 1, File 2 and File 3 into the device connected to the serial converter.

Use of the program: This section explains how to use the program: Mac address extraction

  1. Open the HomeFlasher program.
  2. Click on the Scan connected devices button.
  3. Click on the drop-down menu of the connected Devices and select the serial converter.
  4. Click on the Extract Mac button.
  5. A dialog box will open and prompt you to put the device in flash mode.
  6. After putting the device in flash mode, click on the OK button on the dialog box.
  7. Wait for the program to process the operation.
  8. Once the operation is completed, a dialog box informs us that the MAC address has been read successfully.
  9. Click on the Ok button to close the dialog box.
  10. The MAC address of the device can be viewed both within the Command Window and within the MAC Address window of the Extraction, Backup and default flash section.

Memory clearing

  1. Open the HomeKit Flasher program.
  2. Click on the Scan connected devices button.
  3. Click on the drop-down menu of the connected Devices and select the serial receiver.
  4. Click on the Erase firmware button.
  5. A dialog box will open which will alert you that with this operation the firmware will be deleted.
  6. Click on Yes to continue.
  7. A dialog box will open and prompt you to put the device in flash mode.
  8. After putting the device in flash mode, click on the OK button on the dialog box.
  9. Wait for the program to process the operation.
  10. Once the operation is completed, a dialog box will inform us that the Erase has been carried out successfully.
  11. Click on the Ok button to close the dialog box.
  12. Inside the Command Window you can view the status of the operation. Flash OTA firmware
  13. Open the HomekFlasher program.
  14. Click on the Scan connected devices button.
  15. Click on the drop-down menu of the connected Devices and select the serial receiver.
  16. Click on the Flash OTA firmware button.
  17. A dialog box will open and prompt you to put the device in flash mode.
  18. After putting the device in flash mode, click on the OK button on the dialog box.
  19. Wait for the program to process the operation.
  20. Once the operation is finished, a dialog box will inform us that the Writing was successfully performed.
  21. Click on the Ok button to close the dialog box.
  22. Inside the Command Window you can view the status of the operation.

Guida Utilizzo

HomekitFlasher è una semplice applicazione per ambienti desktop Windows sviluppata gratuitamente e scaricabile da https://github.com/vglucas/HomeKitFlasher . Un ottimo tool dedicato a chi non e' pratico col terminale e vuole effettuare, e velocizzare, il flash del proprio dispositivo. Le azioni principali e predefinite del sistema consentono altresì di effettuare il flash dei firmware Ravencore, sviluppato da José A. Jiménez e Life Cycle Manager chiamato OTA (acronimo di Over The Air) e realizzato da HacK (HomeACcessoryKid). Come vedremo di seguito il programma consente anche il flash di firmware di terze parti grazie ad una semplificata interfaccia. Sezioni del programma Ecco le voci riassuntive delle sei sezioni di cui si compone il programma:

  1. Menu Il menù è posto nella parte superiore sotto alla barra del titolo, all'interno della quale è contenuto un messaggio di benvenuto. File Cliccando su questa voce si aprirà un menù a tendina ove appariranno le voci "Dir Homekit" che ci porterà nella cartella dove sono scaricati i file, "Aggiornamenti",che consente di verificare la presenza di aggiornamenti ed eventualmente scaricarli e la voce "Esci" che consente la chiusura del programma. Credits Cliccando su questa voce si aprirà una finestra riportante i dati relativi della versione del programma, copyritght e contatti dello sviluppatore. ? Cliccando su questa voce si aprirà un menù a tendina contenente il menu’ per scegliere la lingua, controllare gli aggiornamenti e segnalare un eventuale problema o una nuova funzionalita’ iBuy Nuova sessione dove troverete gli strumenti, gia’ testati e funzionanti, per poter iniziare i vostri progetti

  2. Sezione Convertitore seriale Questa sezione è sita nella parte sinistra e posta sotto alla barra del titolo. Si compone di tre elementi, ovvero: Dispositivi collegati Cliccando sul menù a tendina si potranno visualizzare i convertitori seriali (o dispositivi come nel caso del NodeMCU) collegati al computer. Sarà quindi possibile selezionare quello che si desidera utilizzare. Porta In questa finestra verrà mostrata la porta di comunicazione corrispondente al dispositivo seriale selezionato nei "Dispositivi collegati" Scansiona dispositivi collegati Cliccando su questo pulsante il programma effettuerà una nuova scansione alla ricerca di convertitori seriali, facendoli comparire tra i "Dispositivi collegati".

  3. Sezione Estrazione, backup e default flash Questa sezione è sita nella parte centrale - sinistra e posta sotto al pulsante "Scansiona dispositivi collegati". Si compone di sei elementi, ovvero: MAC Address In questa finestra, al termine della procedura effettuata per illustrata al punto successivo, apparirà il MAC address del dispositivo collegato al nostro convertitore seriale. Extract Mac Cliccando questo pulsante si avvierà la procedura automatica che, una volta terminata, farà apparire il MAC address del dispositivo collegato al convertitore seriale nella finestra "MAC Address" indicata al punto precedente. Backup firmware originale Cliccando su questo pulsante il programma effettuerà il backup del firmware installato sul dispositivo collegato al convertitore seriale. Erase firmware Cliccando su questo pulsante il programma effettuerà un erase ovvero la cancellazione della memoria del nostro dispositivo, eliminando in modo permanente il firmware installato in precedenza. Flash OTA firmware Cliccando su questo pulsante il programma installerà l'ultima versione del firmware LCM - Life Cycle Manager da noi chiamato più volte OTA nei post sui gruppi o nel forum. Flash Ravencore last version Cliccando su questo pulsante il programma installerà l'ultima versione del firmware Ravencore presente nella repository del nostro sito. In questo modo si effettuerà un flash nella c.d. procedura "Non OTA" ( quindi non aggiornabile da remoto).

  4. Finestra Comandi Questa sezione è sita nella parte destra, è posta sotto alla barra del titolo e si presenta come una finestra a sfondo bianco. In questa finestra appariranno i comandi lanciati dal programma via terminale e lo stato (sempre da terminale) della procedura avviata.

  5. Sezione Manual Flash Questa sezione è sita nella parte centrale - destra, sotto alla "Finestra Comandi". Si compone di quattro elementi, ovvero: File 1 ... Cliccando sul pulsantino "..." posto a fianco della finestra "File 1" si potrà scegliere il primo file con estensione .bin da flashare. Nella finestra posta sulla sua destra andrà inserito invece l'address corrispondente al file caricato (ad esempio 0x0). File 2 ... Cliccano sul pulsantino "..." posto a fianco della finestra "File 2" si potrà scegliere il secondo file con estensione .bin da flashare. Nella finestra posta sulla sua destra andrà inserito invece l'address corrispondente al file caricato (ad esempio 0x1000). File 3 ... Cliccano sul pulsantino "..." posto a fianco della finestra "File 3" si potrà scegliere il terzo file con estensione .bin da flashare. Nella finestra posta sulla sua destra andrà inserito invece l'address corrispondente al file caricato (ad esempio 0x2000). Carica Cliccando su questo pulsante il programma effettuerà il caricamento dei file selezionati in File 1, File 2 e File 3 nel dispositivo collegato al convertitore seriale.

Utilizzo del programma: In questa sezione viene spiegato come utilizzare il programma: Estrazione del Mac address

  1. Aprire il programma HomeFlasher.

  2. Cliccare sul pulsante Scansiona dispositivi collegati.

  3. Cliccare sul menù a tendina dei Dispositivi collegati e selezionare il covertitore seriale.

  4. Cliccare sul pulsante Extract Mac.

  5. Si aprirà una finestra di dialogo che invita a mettere il dispositivo in flash mode.

  6. Dopo aver messo il dispositivo in flash mode, cliccare sul pulsante OK della maschera di dialogo.

  7. Attendere che il programma elabori l'operazione.

  8. Terminata l'operazione una finestra di dialogo ci informera che la Lettura del MAC address è stata effettuata con successo.

  9. Cliccare sul pulsante Ok per chiudere la finestra di dialogo.

  10. Il MAC address del dispositivo è visualizzabile sia all'interno della Finestra Comandi che all'interno della finestra MAC Address della sezione Estrazione, Backup e default flash

Cancellazione della memoria

  1. Aprire il programma HomeKit Flasher.

  2. Cliccare sul pulsante Scansiona dispositivi collegati.

  3. Cliccare sul menù a tendina dei Dispositivi collegati e selezionare il covertertitore seriale.

  4. Cliccare sul pulsante Erase firmware.

  5. Si aprirà una finestra di dialogo che allerterà sul fatto che con questa operazione il firmware verrà cancellato.

  6. Cliccare su Sì per proseguire.

  7. Si aprirà una finestra di dialogo che invita a mettere il dispositivo in flash mode.

  8. Dopo aver messo il dispositivo in flash mode, cliccare sul pulsante OK della maschera di dialogo.

  9. Attendere che il programma elabori l'operazione.

  10. Terminata l'operazione una finestra di dialogo ci informerà che l' Erase è stato effettuato con successo.

  11. Cliccare sul pulsante Ok per chiudere la finestra di dialogo.

  12. All'interno della della Finestra Comandi è possibile visualizzare lo stato dell'operazione.

Flash firmware OTA

  1. Aprire il programma HomekFlasher.

  2. Cliccare sul pulsante Scansiona dispositivi collegati.

  3. Cliccare sul menù a tendina dei Dispositivi collegati e selezionare il covertertitore seriale.

  4. Cliccare sul pulsante Flash OTA firmware.

  5. Si aprirà una finestra di dialogo che invita a mettere il dispositivo in flash mode.

  6. Dopo aver messo il dispositivo in flash mode, cliccare sul pulsante OK della maschera di dialogo.

  7. Attendere che il programma elabori l'operazione.

  8. Terminata l'operazione una finestra di dialogo ci informerà che la Scrittura è stata effettuata con successo.

  9. Cliccare sul pulsante Ok per chiudere la finestra di dialogo.

  10. All'interno della della Finestra Comandi è possibile visualizzare lo stato dell'operazione.

Clone this wiki locally