ChibiStudio 2022

Guida d’installazione
Versione 1.2

NeaPolis Innovation - PlayEmbedded

15 maggio 2024

1
Contenuti
1 Introduzione___________________________________________________________________ 3
2 Installazione __________________________________________________________________ 4
2.1 7-zip _______________________________________________________________________ 4
2.2 Toolchain ChibiStudio ______________________________________________________ 5
2.3 Driver USB per ST-Link/V2 __________________________________________________ 6
2.4 TortoiseSVN _______________________________________________________________ 7
3 Flash&Run ____________________________________________________________________ 8

2
1 Introduzione
Questo documento vuole essere una guida per l’installazione di ChibiStudio,
una toolchain basata su Eclipse e pensata per sviluppare firmware embedded
per diverse famiglie di microcontrollori. La guida mostra anche come eseguire
in modo corretto ed affidabile il Flash&Run (programma ed esecuzione) di un
progetto in ChibiStudio.
Per ogni punto verranno spiegate tutte le operazioni richieste, con particolare
attenzione a quelle che generano gli errori più comuni.

NOTA
• L’installazione della toolchain deve essere fatta su un sistema operativo
Windows 64-bit. Nel caso si stia utilizzando un MacBook, procedere
all’installazione tramite una Virtual Machine con Windows.
• È necessario seguire attentamente tutti i passaggi, per evitare il verificarsi
di errori o discrepanze nell’installazione che possono rendere difficoltoso
il supporto in caso di problemi.
• Durante l’installazione della toolchain è consigliabile disabilitare l’antivirus
perché potrebbe corrompere alcuni componenti della toolchain e renderla
inutilizzabile.

3
2 Installazione
2.1 7-zip
ChibiStudio viene distribuito come archivio portatile 7-zip, un programma di
compressione che sfrutta un algoritmo proprietario; qualsiasi altro
programma di estrazione potrebbe corrompere i file e rendere inutilizzabile
la toolchain.
Il programma è disponibile sul sito ufficiale ed è scaricabile da questo link:

https://www.7-zip.org/a/7z2404-x64.exe

Una volta completato il download e avviato il file, si aprirà una finestra che
chiederà di scegliere dove salvare il contenuto, suggerendo
C:\ProgramFiles\7-Zip\.

Premete su Install e attendete che l’installazione sia completa. Completata

l’installazione, verificate che il processo sia andato a buon fine scrivendo sulla
barra di ricerca di Windows “7-Zip” e controllando che l’applicazione sia
presente.

4
2.2 Toolchain ChibiStudio
ChibiStudio viene distribuito come archivio compresso, la versione che
useremo durante il campus può essere scaricata da questo link:

https://sourceforge.net/projects/chibios/files/ChibiStudio%20Wi
ndows/ChibiStudio_Windows_2022-01.7z/download

Aprendo il link, il download inizierà automaticamente. Una volta completato il

download, procedete con l’estrazione dell’archivio utilizzando il programma
scaricato al punto precedente della guida. Selezionate l’archivio compresso,
cliccate con il tasto destro del mouse e selezionate la voce 7-Zip e quindi
Estrai i file...
Se state utilizzando Windows 11, premete prima su Mostra altre opzioni.

Selezionate C:\ come percorso di estrazione, avendo l’accortezza di

rimuovere la spunta dalla casella presente sotto la barra di inserimento del
testo, come mostrato nell’immagine. Selezionare qualsiasi altro percorso che
non sia C:\ darà problemi durante l'esecuzione della toolchain.
Successivamente inizierà il processo di estrazione.

5
2.3 Driver USB per ST-Link/V2
Le schede di sviluppo STM32-Nucleo64 di STMicroelectronics, oltre al
microcontrollore includono anche un programmatore (ST-Link/V2) che per
poter essere utilizzato necessita degli appositi driver, scaricabili dal sito di
STMicroelectronics al seguente link:

https://www.st.com/en/development-tools/stsw-link009.html

Per scaricare i driver, premete sull’icona Get Software e poi Get Latest. Si
aprirà poi il License Agreement che bisogna accettare cliccando su
Accept e successivamente un modulo di registrazione. Una volta compilato il
modulo vi arriverà una mail all’indirizzo di posta specificato in fase di
registrazione, dalla quale potrete scaricare il pacchetto driver necessario.
Estraete il pacchetto utilizzando 7-zip e fate click con il tasto destro sul file
dpinst_amd64.exe. Selezionate Esegui come amministratore e seguite le
istruzioni a schermo per procedere con l’installazione.

6
2.4 TortoiseSVN
Durante il NeaPolis Innovation Summer Campus, faremo utilizzo di un
sistema di versionamento chiamato SVN. Di seguito, le indicazioni per
l’installazione del programma client consigliato, TortoiseSVN. Il programma è
disponibile sul sito ufficiale:

https://tortoisesvn.net/downloads.html

Verrete reindirizzati sulla pagina di TortoiseSVN, dalla quale dovrete scaricare

la versione 1.14.7 a 64 bit, come indicato nella figura.

Una volta scaricato il programma, apritelo e seguite le indicazioni a schermo

per completare l’installazione. Attenzione: al termine dell’installazione di
TortoiseSVN, è necessario riavviare il PC. Se l’installazione è andata a buon
fine noterete che, cliccando col tasto destro del mouse in un punto vuoto del
desktop, saranno presenti nuove voci nel menù. Se state usando Windows 11,
dovrete premere prima su Mostra altre opzioni.

7
3 Flash&Run

ATTENZIONE
Prima di iniziare assicurarsi che la scheda di sviluppo STM32-Nucleo64 sia
correttamente collegata al PC e che i driver siano riconosciuti.

Lanciate la toolchain ChibiStudio utilizzando il collegamento “Chibi Studio

GCC 10.3.1”, che si trova nella cartella C:\ChibiStudio e cliccate col tasto
destro a vuoto nella sezione Project Explorer in alto a sinistra.
Selezionate la voce Import e successivamente, quando si aprirà la nuova
finestra, la voce Existing Projects into Workspace. Premete poi su “Next”. Su
“Select root directory”, premete su “Browse…”, selezionando il seguente
percorso:
C:\ChibiStudio\chibios2111\demos\STM32\RT-STM32G474RE-NUCLEO64

Controllate che siano selezionate sia la casella all’interno di Projects sia la

voce Copy projects into workspace e successivamente fate click su Finish.
Fatto questo, comparirà una nuova cartella nel Project Explorer chiamata
RT-STM32G474RE-NUCLEO64.

8
Aprite il Makefile e modificate il valore della variabile CHIBIOS alla riga 92 da
../../.. a ../../chibios2111.

Salvate le modifiche e premete l’icona del martello per compilare il progetto.

Verranno create delle nuove cartelle, tra le quali quella di build. In quest’ultima,
selezionare il file ch.elf.

Con il file ch.elf selezionato, aprite il seguente menù a tendina e selezionate

la voce Create OpenOCD Debug Configuration (pre-selected elf file into a
project).

L’avvenuta creazione del file di debug sarà confermata da un messaggio nella

finestra Console. Per avviare OpenOCD e procedere con la programmazione
del microcontrollore, aprite lo stesso menù a tendina del passo precedente e

9
selezionate la voce OpenOCD on STLink (prompts for .cfg target
configuration). Si aprirà una nuova finestra, nella quale andrete a selezionare
il seguente file:
C:\ChibiStudio\tools\openocd\scripts\board\st_nucleo_g4.cfg

Successivamente sarà possibile effettuare il Debug del codice appena

caricato nella memoria flash del microcontrollore, premendo sull’apposito
simbolo e scegliendo la prima opzione:

Fatto ciò, si aprirà una nuova interfaccia di Debug; cliccando sul pulsante di
Resume il LED1 sul microcontrollore inizierà a lampeggiare.

10