Compilare QMK con supporto Vial

Rocca di Mezzo (AQ)

Ecco la procedura per compilare il firmware della tastiera Marea a partire dagli ultimi sorgenti di QMK e Vial. È una procedura facoltativa, quasi accidentale, sulla quale vai a finire se vuoi controllare da cima a fondo il comportamento dell’hardware; oppure quando non ti fidi del firmware che hai adesso sotto le dita, e vuoi, appunto, partire al codice sorgente pubblico. Le possibilità di personalizzazione di QMK sono anche troppe, ma non per questo sono mal organizzate; vien facile dare un’occhiata e pensare: ma sì, lo voglio fare anche io - oppure: voglio usare l’encoder rotativo per cambiare l’intensità dei LED o scrollare le pagine del browser.

E da qui a fare danno è un attimo. Perché è tutto bello, tutto open-source, e tutto nello spirito della Marea, ma con un rischio presente e impossibile da ignorare: il brick. Bisogna sapere cosa si sta facendo, come tutte le cose; e avere l’attitudine giusta per affrontare, e poi aggirare, i problemi che vengono fuori. È per questo che abbiamo aggiunto il supporto Vial al firmware caricato su tutte le tastiere spedite, perché il 99% di quel che serve si riesce a fare dalla sua interfaccia utente.

Marea QMK Vial
Il file config.h e le direttive per i LED RGB della Marea.

Cosa occorre

Queste linee guida sono per ambienti Linux, ma con Windows e macOS cambia poco. Soprattutto, queste linee guida non sostituiscono quelle dei siti ufficiali, più aggiornate e più curate. Si riassume tutto in tre passaggi:

  1. Preparazione di QMK e Vial-QMK
  2. Compilazione del firmware con le eventuali personalizzazioni
  3. Installazione del firmware sulla tastiera

Compilare il firmware

  • Installare QMK seguendo la procedura ufficiale.
  • Clonare il repo Vial-QMK seguendo la procedura ufficiale.
  • Scaricare i sorgenti della Marea dal sito ufficiale.
  • Estrarre la cartella marea dentro vial-qmk/keyboards/
  • Modificare quel che si vuole modificare.
  • Da vial-qmk, compilare con make marea:via_vial.
  • Verrà creato un file marea_via_vial.hex.

Consiglio di ignorare quei due o tre warnings visti in fase di compilazione; andrebbero risolti ma non sono fondamentali.

Flashare il firmware

Lo so, flashare non è elegante, ma se scrivo “masterizzare” qualcuno va a prendere il drive CD esterno, e se uso termini più snob come “inizializzare” o “programmare” finisco per passare per un vecchio più vecchio di quel che sono. Quindi, una volta per tutte, flesciamo!

  • Digitare qmk flash -kb marea -km via_vial.
  • Dopo l’INVIO, staccare la tastiera, tenere premuto ESC e ricollegare la tastiera (così si entra in modalità bootloader). (nota: Oppure premere, con uno spillo, il piccolo foro sul bottom - se presente nel vostro esemplare. ).
  • Aspettare che la procedura finisca senza errori.

Tips: su Windows e macOS si può usare QMK Toolbox.

A questo punto, volendo, si può aprire Vial e controllare che il layout armonico della Marea sia ben in vista, pronto per le personalizzazioni; conviene, ad esempio, disattivare le luci LED nell’apposito Tab. Comunque sia, è tutto: la procedura è completata e, almeno stavolta, niente è stato rotto.

Qualche considerazione

Lo ripeto: non è necessario compilare il firmware a partire dai sorgenti. La procedura appena descritta è per utenti esigenti. Si può scaricare il file .hex dal sito della Marea (e flasharlo proprio come fatto sopra) oppure affidarsi a Vial per le personalizzazioni più comuni (macro, livelli, effetti di luce). Di sicuro chi decide di farlo impara qualcosa di nuovo - e di solito questo significa avere certezze in più - ma è un extra.

Infine: queste istruzioni valgono al 5 maggio 2024 e potrebbero far uscire degli avvisi o degli errori nella versioni successive di QMK; impossibile saperlo, adesso. Di solito le problematiche dovute ad aggiornamenti di versioni sono ben documentate e note, ma scrivetemi in caso di problemi.

31