Guida alla CLI di Betaflight

Guida alla CLI di Betaflight

Acronimo di Command Line Interface la CLI è l'interfaccia a riga di comando, chiamata anche Console, che ci permette di accedere tramite comandi testuali a tutti i parametri e settaggi disponibili nei firmwares delle flight controllers come Cleanflight, Betaflight, iNav, Butterflight e derivati.

Perché utilizzarla ?

Betaflight possiede una valanga di impostazioni che possiamo modificare, ma nell' interfaccia grafica troviamo esclusivamente quelle più utilizzate, questo per mantenerla pulita e di facile utilizzo anche ai meno esperti.

Tutti gli altri settaggi sono disponibili tramite la CLI, dove è possibile comodamente consultarli, modificarli, oppure effettuare una copia di backup delle nostre impostazioni o ripristinarle.

Sintassi

La sintassi della quasi totalità dei comandi è questa:

[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

una volta effettuate le modifiche che vi interessano ricordate di salvarle con il comando

save

infatti tutte le modifiche effettuate sono temporanee, usate il comando "save"per salvarle e riavviare la board.

Case Sensitivity e Spazi

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

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

anche gli spazi non hanno importanza  

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 seguito da uno spazio e da alcune lettere dell'impostazione che si desidera controllare o modificare, restituirà tutte le impostazioni che iniziano con quelle lettere. È molto utile quando non ricordiamo il nome del settaggio preciso.
Per esempio

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.

Attenzione alla versione!!

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

I backups che effettuate sono compatibili sono con la stessa versione "Minor" che state utilizzando indipendentemente dalla patch, quindi le nuove versioni non sono retro compatibili!

Per farvi un esempio il backup di una versione 4.1.2 sarà compatibile con tutte le patch 4.1.X, ma se aggiornate ad una versione più recente come 4.2.X non potete ripristinare il backup della 4.1. Questo perché non è raro che da una minor release all'altra molte funzioni cambino nome o vengano del tutto eliminate.

Quindi nel caso stiate aggiornando la vostra FC ad una nuova versione dovrete configurare tutto da zero.

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.

Share Tweet Send
0 Comments
You've successfully subscribed to FPV Italia Blog: Notizie, Recensioni e Guide all'Acquisto
Great! Next, complete checkout for full access to FPV Italia Blog: Notizie, Recensioni e Guide all'Acquisto
Welcome back! You've successfully signed in
Success! Your account is fully activated, you now have access to all content.