Tutoriel développement embarqué
Dans le cadre des mes missions de développeur embarqué sur plateforme libre depuis plus de 15 ans, j'ai dû mettre en place un certain nombre d'outils. Celui qui revient régulièrement est le debug. Lors de la phase de développement, le debug est indispensable mais nécessite d'avoir les équipements et les outils adaptés. Voici mon retour d'expérience sur ce sujet que je (Francois Bonningues) veux partager avec le système d'exploitation Zephyr OS. Cela comprend les traces sur la console et le debug avec un outil comme gdb.
L'objectif de ce tutorial est de déboguer une application basique d'exemple (blinky fourni par Zephyr) qui s'exécute sur une carte d'évaluation stm32F4 depuis un PC sous linux.
Environnement
Zephyr OS
L'installation de l'environnement est très bien documenté sur le site officiel:
https://docs.zephyrproject.org/latest/develop/getting_started/index.html
Matériels utilisés
Voici le matériel nécessaire pour cet exemple :
- un PC sous Debian 12 "Bookworm"
- le kit d'évaluation stm32F407 https://www.st.com/en/evaluation-tools/stm32f4discovery.html
- un module USB TTL, par exemple https://www.amazon.fr/dp/B0BTB2TZW2/ref=pe_27091421_487030221_TE_SCE_3p_dp_i1
Compilation, flashage
Une fois l'environnnement installé sur le PC (ici dans mon répertoire home) et après y avoir branché la carte d'évaluation, il suffit de taper ces commandes:
cd ~/zephyrproject/zephyr
source ~/zephyrproject/.venv/bin/activate
west build -p always -b stm32f4_disco samples/basic/blinky
west flash
Débogage de l'application embarquée
Traces sur la console série
Les traces de l'application peuvent être observées via la liaison série. Les broches PA2, PA3 et GND de la carte d'évaluation doivent être reliées à un adaptateur USB TTL comme indiqué ci-dessous.
L'illustration ci-dessous montre les 3 fils connectés utilisés par la liaison série:
Ensuite lancer l'outil minicom (ou équivalent) sur /dev/ttyUSB0*
.
*
Remplacer le x de /dev/ttyUSB<x> par celui qui correspond à votre configuration. Pour le savoir, exécuter sudo dmesg.
A noter qu'il est sans doute nécessaire d'ajouter l'utilisateur au groupe dialout (sous debian) pour avoir accès à la console sans être root.
minicom -D /dev/ttyUSB0
Les traces s'affichent alors:
Debug en ligne de commande
Il est possible d'aller plus loin dans le debug notamment en exécutant le programme en pas à pas.
Il faut alors enlever les optimisations du compilateur. Pour cela, dans le fichier prj.conf (samples/basic/blinky/prj.conf), ajouter la ligne suivante:
CONFIG_NO_OPTIMIZATIONS=y
Ensuite depuis votre terminal, il suffit d'exécuter la commande:
west debug
Debug sous VisualStudio Code
Le debug peut être exécuté depuis l'IDE VisualStudio Code.
Exécuter visualStudio Code
(.venv) francois@debian-acer-fb:~/zephyrproject/zephyr$ code &
Ajouter l'extension Cortex-Debug
Installer l'extension Cortex-Debug.
Définir la configuration de Debug
Cela peut être fait via le menu View\Commande palette Ctrl-shift-P et en tapant Debug: Add configuration
Editer le fichier launch.json. En voici un exemple. Les chemins sont à modifier pour correspondre à votre environnement:
{
"version": "0.2.0",
"configurations": [
{
"type": "cortex-debug",
"request": "launch",
"servertype": "openocd",
"serverpath": "${env:HOME}/zephyr-sdk-0.16.4/sysroots/x86_64-pokysdk-linux/usr/bin/openocd",
"cwd": "${workspaceRoot}",
"executable": "./build/zephyr/zephyr.elf",
"gdbPath": "${env:HOME}/zephyr-sdk-0.16.4/arm-zephyr-eabi/bin/arm-zephyr-eabi-gdb",
"name": "Debug",
"device": "STM32F407",
"configFiles": [
"${env:HOME}/zephyrproject/zephyr/boards/arm/stm32f4_disco/support/openocd.cfg"
],
}
]
}
Exécution en pas à pas Placer un point d'arrêt et exécuter le programme via le menu Run\Start Debugging (touche F5). Le debugger s'exécute et s'arrête sur le point d'arrêt comme illustré dans l'exemple ci-dessous: