Les microcontrôleurs STM32

Les familles de microcontrôleurs STM32

Il existe plusieurs familles de microcontrôleurs STM32, classés selon leur cœur ARM

http://www.st.com/en/microcontrollers/stm32-32-bit-arm-cortex-mcus.html

Les cartes de prototypages proposées par ST

STMicroelectronics propose toute une gamme de cartes de prototypage pour diverses applications et différents microcontrôleurs STM32.

Les cartes "Discovery"

Historiquement, les “discovery boards” étaient développées pour montrer aux clients les possibilités du microcontrôleur STM32.
De nombreuses cartes (de couleur verte) embarquent des composants supplémentaires (par exemple un accéléromètre) pour montrer leur fonctionnement et leur mise en œuvre.

Les cartes "Nucleo"

Les cartes de la gamme “nucleo” (de couleur blanche), sont en général (pour la gamme nucleo 64) équipés des connecteurs compatibles “arduino shield”.
Ainsi un grand nombre de "shields arduino" peuvent être utilisés avec ces cartes.

les cartes "Eval-boards"

Ces cartes (de couleur verte) ont été développées pour le marché professionnel.
Ces cartes embarquent en général de très nombreux composants électroniques supplémentaires. Elles sont souvent assez chères.

Introductions aux ateliers STM32

Dans les ateliers, on va utiliser l'outil "STM32CubeMx" pour la génération de code "canevas" et l'IDE "eclipse" pour la compilation et le debug. Un tutoriel permettant d'installer l'ensemble des outils de développement OpenSTM32 est disponible à la page suivante :
http://wiki.labaixbidouille.com/index.php/Installation_de_l%27environnement_de_d%C3%A9veloppement_OpenSTM32

Les ateliers STM32

Premier programme “blinky”

Ce tout premier programme va nous permettre de valider l'installation de l'environnement de développement SW4STM32.
Dans notre exemple nous allons utiliser la carte “Nucleo32” de référence “NUCLEO-F303K8”.

Création du projet avec STM32CubeMx

On va utiliser “STM32CubeMx” pour générer la trame du code source :
Après avoir ouvert “STM32CubeMx”. Il faut exécuter “New Project”.
Dans la fenêtre ouverte, il faut choisir l’onglet “Board Selector”.
Le “Type of Board” et “MCU Series” doivent correspondre à la carte connectée.
Dans notre exemple, on choisira “Type of Board” : Nucleo32 (le nombre de cartes listées n'étant pas très grand, il ne sera pas nécessaire de préciser “MCU Series”)
Dans le champs “Boards List:”, on choisit la carte connectée en double cliquant. Dans notre exemple : “Nucleo32” de référence “NUCLEO-F303K8”

Sur cette carte, une LED est connectée sur la broche “PB3” (appellation de STM32) correspondant à la broche D13 du connecteur arduino.

Dans l’onglet “Pinout”, il faut cliquer dans le dessin du chip sur la broche “PB3”. Dans le menu, il faut sélectionner “GPIO_Output”. La broche change alors de couleur en devenant verte.



Dans le menu “Project” -> “Settings…”, on ouvre la boîte de dialogue “Project Settings”

• On saisi un nom de projet (“Project Name”) et le répertoire (“Project Location”).
• Avec le bouton “Browse”, on choisit le répertoire “workspace”, qu’on avait spécifié lors de l'installation d'eclipse.
• Dans la liste “Toolchain / IDE” il faut choisir le “SW4STM32” (très important!!!).
• On ferme le dialogue par “OK”.

Lors de la première utilisation de STM32CubeMx, toutes les sources des firmware packages ne sont pas encore installées.
Il nous est proposé de les télécharger depuis le site st.com.
Par le menu “Project” -> “Generate Code…”, on peut générer automatiquement le code de base.
Dans la boîte de dialogue “Code Generation”, on faut cliquer sur “Open Project” pour visualiser le code dans eclipse.

Développement du code source dans eclipse

Le projet “Blinky” contient les répertoires :

• “Drivers”,
• “Inc”,
• “Src”
• “startup”.
  

Il faut ouvrir “main.c” du répertoire “Src”.

Dans la fonction “void main(void)”, on trouve trois appels de fonction “HAL_Init()”, “SystemClock_Config()” et “MX_GPIO_Init()” nécessaires pour l’initialisation du système.
Ensuite, il y a une boucle infinie, dans laquelle on peut ajouter son propre code, par exemple :

while (1)
{
   HAL_GPIO_WritePin(GPIOB, GPIO_PIN_3, 1 );   // LED on PB3 ON
   HAL_Delay(500);                             // wait 500 milli seconds
   HAL_GPIO_WritePin(GPIOB, GPIO_PIN_3, 0 );   // LED on PB3 OFF
   HAL_Delay(500);                             // wait 500 milli seconds
}

Compilation

Pour compiler le projet, il faut aller dans le menu “Project” -> “Build Project”.
Eclipse va utiliser la toolchain “GNU Tools ARM Embedded” pour la compilation.

Débogage

Pour déboguer le projet; il faut aller dans le menu “Run” -> “Debug”.
Dans la boîte de dialogue “Debug As” il faut choisir “Ac6 STM32 C/C++ Application”.
Eclipse va utiliser OpenOCD et STLink pour communiquer avec le microcontrôleur.
Avec les fonctionnalités de debug, on peut avancer pas à pas dans le code et voir la LED s’allumer et s'éteindre.
“Resume (F8)” va exécuter le code sans intervention supplémentaire de l’IDE et donc la LED va clignoter...

Rajout d'une LED externe

On peut facilement rajouter une LED externe en montant la carte nucleo32 F303K8 sur une plaque d'essai (breadbord)et en branchant l'anode (broche la plus longue) d'une LED sur la broche D13 et sa cathode à une résistance d'environ 220 Ohms reliées au 0V (GND).

Deuxième Programme “Commander une LED avec un variateur PWM”

Si on connecte une LED à des broches digitales comme vu dans le programme "blinky", on a seulement deux possibilités : "on" avec la pleine luminosité et "off" éteint.
En utilisant le PWM (en anglais "pulse wide modulation"), on peux faire varier la luminosité de la LED.

Explication du PWM

Si on allume la LED, il y a une tension de 3.3 volt sur la broche, pour éteindre, on applique 0 volt:



Si on change rapidement (par exemple 100 fois par seconde) entre "on" et "off", l’œil humain ne distingue plus ce changement et on a l’impression, que la LED brille avec une luminosité moindre:



A partir d’une certaine fréquence (25 fois par seconde), celle ci n’est plus importante car elle n'est plus perceptible à l’œil.



Une periode "T" est défini par le temps entre deux allumage "on" (front montant du signal).
Maintenant, on peut diminuer ou augmenter le temps "t1" de l’état "on" par rapport à l’état "off". Par exemple dans le dessin, "t1" est à un quart de "T".



Ce rapport t1/T est appelé le rapport cyclique ("duty cycle").

• S’il est à 0 ( t1 = 0 ), la LED est "off" en continue.
• S’il est à 1 ( t1 = T ), la LED est "on" en continue.
• Si on modifie le rapport de "t1 beaucoup plus petit que T" (la LED brille très peu) à "t1 presque égale à T" (la LED brille beaucoup), on peux varier la luminosité de la LED.

Support du PWM par les STM32

Sur STM32, le PWM est supporté par l’utilisation du timer et des drivers HAL (source code "Hardware Abstraction Layer" distribué par ST).
Il faut savoir que les STM32 contiennent plusieurs types de timer avec des fonctionnalités différentes. Une description des timers se trouve dans les fichiers (en anglais) de STMicroelectronics:

• Application Note 4013 et
• Application Note 4776.

On va utiliser l’outil STM32CubeMx pour générer le code source de base.

• Première étape: Créer un nouveau projet en sélectionnant la carte sur laquelle on va travailler.
• Dans l’onglet "Pinout" de la fenêtre principale, on sélectionne un timer (par exemple "TIM3"), qui propose plusieurs "Channel" avec la fonction "PWM Generation".

On peut voir sur l’image de la puce que la broche PA5 est utiliser pour le canal 1 du timer 3: "TIM3_CH1".
Pour calculer des valeurs "t1" et "T", il faut configurer le timer dans l’onglet "Configuration" en cliquant sur le bouton "TIM3" dans la rubrique "Control".



Dans l’onglet « Parameter Settings » de la boite de dialogue, il faut configurer le timer.
Pour cela, il faut savoir que le timer est sequencé par l’horloge du CPU. Dans le cas de la carte sélectionné, cette fréquence est de 80 MHz.
Si on configure le "Prescaler" (voir image) du timer à 80, le timer va déclencher l’incrémentation du compteur avec une fréquence de 1 MHz (80 MHz / 80). Il faut configurer une deuxième valeur "Counter Periode" à 100.
Ainsi, chaque micro seconde, le timer va incrémenter (en commençant à 0 jusqu’à 100). Ce temps (100 micro secondes) corresponds au "T". Maintenant on peut générer le code source.

Pour le contrôle du timer, il faut trois fonctions:

• Démarrer le timer: HAL_TIM_PWM_Start( &htim3, TIM_CHANNEL_1 );
• Arrêter le timer: HAL_TIM_PWM_Stop( &htim3, TIM_CHANNEL_1 );
• Modifier la valeur de "t1": __HAL_TIM_SET_COMPARE( &htim3, TIM_CHANNEL_1, Value );