Guida alla CLI di Betaflight

La CLI, acronimo di Command Line Interface, è un'interfaccia a riga di comando che permette agli utenti di accedere ai parametri e alle impostazioni dei firmware delle flight controller come Cleanflight, Betaflight, iNav, Butterflight e derivati. Questa interfaccia è conosciuta anche come Console e consente l'accesso tramite comandi testuali.

La CLI rappresenta un'alternativa alla più comune interfaccia utente basata su menu, poiché permette un maggiore controllo e precisione nell'impostazione dei parametri. Inoltre, consente agli utenti più esperti di personalizzare le proprie configurazioni in modo più dettagliato e specifico.

L'utilizzo della CLI richiede una certa conoscenza dei comandi e dei termini utilizzati nei firmware delle flight controller. Tuttavia, una volta padroneggiata, la CLI può essere uno strumento molto utile per ottenere le migliori prestazioni dal proprio drone.

Perché utilizzarla ?

Il firmware di Betaflight offre una vasta gamma di impostazioni che possono essere personalizzate per ottenere le migliori prestazioni dal proprio drone. Tuttavia, nell'interfaccia grafica di Betaflight, vengono mostrate solo le impostazioni più comuni, in modo da mantenere l'interfaccia pulita e di facile utilizzo anche per gli utenti meno esperti.

Per accedere a tutte le altre impostazioni, gli utenti possono utilizzare la CLI di Betaflight. In questa interfaccia a riga di comando, è possibile consultare e modificare tutti i parametri disponibili, oltre a effettuare copie di backup delle impostazioni o ripristinarle in caso di problemi.

Sebbene la CLI possa sembrare intimidatoria ai principianti, è un'ottima risorsa per gli utenti esperti che desiderano personalizzare la propria configurazione in modo più dettagliato. Inoltre, una volta imparati i comandi e i termini utilizzati in Betaflight, l'utilizzo della CLI diventa più intuitivo e veloce rispetto all'interfaccia grafica.

Sintassi

La sintassi della maggior parte dei comandi utilizzati nella CLI di Betaflight segue il formato:

[comando] [settaggio] = [valore]

ad esempio se abbiamo installato la FC in una orientazione diversa da quella standard, invece di modificare l'orientazione di tutta la board dal configuratore, possiamo modificare esclusivamente l'orientazione del giroscopio tramite la CLI diminuendo così il carico della CPU

set align_gyro = DEFAULT

i valori ammessi in questo caso sono: DEFAULT, CW0, CW90, CW180, CW270, CW0FLIP, CW90FLIP, CW180FLIP, CW270FLIP

Dopo aver apportato le modifiche desiderate, è importante salvare le impostazioni tramite il comando "save" per renderle permanenti. Altrimenti, tutte le modifiche effettuate saranno temporanee e andranno perse al riavvio della board.

save

Altrimenti, tutte le modifiche effettuate saranno temporanee e andranno perse al riavvio della board.

Per uscire senza lavare inviate:

exit

Case Sensitivity e Spazi

La CLI non fa distinzione tra lettere maiuscole o minuscole quindi potete inserire i comandi come meglio vi aggrada.

La CLI non fa distinzione tra lettere maiuscole e minuscole. Ciò significa che i comandi possono essere inseriti con qualsiasi combinazione di lettere maiuscole e minuscole, a seconda delle preferenze dell'utente.

set serialrx_inverted = on
SET SERIALRX_INVERTED = ON
seT serialRX_inverTED = oN

anche gli spazi non hanno importanza, questi comandi sono tutti equivalenti:

set serialrx_inverted = on
set serialrx_inverted=on
set serialrx_inverted =on
set serialrx_inverted =               on

Consultare le impostazioni tramite la CLI

I comandi più utilizzati nella CLI sono dump , diff  e get

dump

Mostra a schermo tutte le impostazioni disponibili nel firmware e i valori attualmente assegnati.
Sono davvero tante, provare per credere.

diff

mostra a schermo esclusivamente le impostazioni che sono diverse da quelle predefinite. L'elenco restituito è molto più breve e facile da gestire se si desidera solo verificare le impostazioni modificate dall'utente.

get [settaggio]

Il comando get restituisce il valore di un determinato settaggio.

Un trucco utile nella CLI di Betaflight è l'utilizzo del comando "get", seguito da uno spazio e da alcune lettere dell'impostazione che si desidera controllare o modificare. Questo comando restituirà tutte le impostazioni che iniziano con quelle lettere.

Ad esempio digitando:

get serialrx

Ci restituirà i valori di "serialrx_inverted" e "serialrx_duplex"

Backup e ripristino delle impostazioni di Betaflight utilizzando la CLI

È buona norma eseguire un backup delle impostazioni della CLI di Betaflight prima di apportare modifiche, in modo da poter tornare indietro se qualcosa va storto.

Per eseguire il backup, inserire

diff all

e copiare la lista ottenuta in un file di testo.

Per ripristinarle, basta copiare e incollare il file di testo nella CLI e premere Invio. Non dimenticare di inviare "save" prima di chiudere la CLI.

Altrimenti potete effettuare un backup più profondo utilizzando il comando dump, e salvare anche i vostri Rate.

rateprofile 0
profile 0
dump

per dumpare solo alcuni profili

rateprofile 0
profile 0
dump

per salvare solo i Rates

rateprofile 1
dump rates
rateprofile 2
dump rates

anche in questo caso copiate la lista ottenuta in un file di testo e salvatelo.

Attenzione alla versione!!

I backup che effettuate sono compatibili sono con la stessa versione di Betaflight che state utilizzando!

Specifica Versioni

È importante tenere presente che i backups delle impostazioni effettuati tramite la CLI sono compatibili solo con la stessa versione "Minor" del firmware che si sta utilizzando, indipendentemente dalla patch. Questo significa che i backup effettuati con la versione 4.1.2 di Betaflight saranno compatibili solo con tutte le patch 4.1.X, ma non con la versione successiva 4.2.X

Ciò è dovuto al fatto che durante gli aggiornamenti del firmware, non è raro che molte funzioni cambino nome o vengano eliminate completamente. Questo può comportare incompatibilità tra i backup effettuati con diverse versioni.

Pertanto, se si decide di aggiornare la FC ad una nuova versione di firmware, è importante configurare tutto da zero, senza utilizzare i vecchi backup. Anche se può sembrare un'operazione noiosa e dispendiosa, configurare la propria FC da zero può essere un'ottima opportunità per comprendere meglio le impostazioni e personalizzare al meglio il proprio drone.

Altri comandi utili

Comando Descrizione
default ripristina il controller ai valori predefiniti e riavvia.
dump stampa a schermo tutte le impostazioni configurabili.
diff stampa solo le impostazioni che sono diverse dai valori predefiniti. Include solo il profilo PID corrente.
diff all stampa solo le impostazioni che sono diverse dai valori predefiniti. Include TUTTI i profili PID.
exit uscire senza salvare.
get ottieni il valore della variabile specificata.
help elenca tutti i comandi disponibili.
save salva le impostazioni e riavvia.
set imposta il valore dato alla variabile. ([settaggio] = [valore] o * per elenco)
status mostra lo stato del sistema.
version mostra la versione.

Per altri comandi fate riferimento alla documentazione ufficiale di betaflight:

Command Line Interface (CLI) | Betaflight
Cleanflight has a command line interface (CLI) that can be used to change settings and configure the FC.