Projet

Général

Profil

Atmel AVR » Historique » Version 8

Patrice Nadeau, 2024-01-27 14:46

1 1 Patrice Nadeau
# Atmel AVR
2
3
Particularités pour les microcontrôleurs 8 bits AVR d’Atmel.
4
5
[Atmel AVR4027: Tips and Tricks to Optimize Your C Code for 8-bit AVR Microcontrollers](https://ww1.microchip.com/downloads/en/AppNotes/doc8453.pdf)
6
7 2 Patrice Nadeau
## Règles
8
1. Macros définis dans le fichier config.h
9
    1. `F_CPU` : La fréquence utilisée par l’horloge (interne ou externe) du microcontrôleur
10
11
        > Les « fuses » doivent correspondent à la bonne source de l’horloge.
12
1. De nouveau type d’entier sont fournis avec la librairie stdint.h. L’utilisation de ces types DOIT être utilisé afin d’exprimer le nombre de bit d’un objet.
13
1. Progmem : Pour mettre des variables en lecture seule dans la section FLASH au lieu de SRAM.
14
    1. Inclue la librairie avr/pgmspace.h
15
    1. Le nom de la variable DOIT être suivie de _P
16
    1. Utiliser les macros de la librairie pour accéder à ces variables
17
1. Fonction main : Un microcontrôleur AVR ne termine jamais la fonction main.
18
    1. Déclarer la fonction main avec l’attribut noreturn
19
    1. Utiliser une boucle sans fin for (;;)
20
1. Opérations atomiques Certaines opérations ne doivent pas être interrompus, par ex., charger un registre de 16 bits avec un registre de 8 bits.
21
    1. Inclure la librairie util/atomic.h
22
    1. Insérer les instructions dans une section ATOMIC_BLOCK
23
6. Interruptions
24
25 1 Patrice Nadeau
### Fichier d’en-têtes
26
27
Vérification du modèle de microcontrôleur
28
    > Via l'option `-m` de [gcc](https://github.com/embecosm/avr-gcc/blob/avr-gcc-mainline/gcc/config/avr/avr-mcus.def)
29
30
```c
31
#ifndef defined (__AVR_ATmega48__) || (__AVR_ATmega48P__) || \
32
	(__AVR_ATmega88P__) || defined (__AVR_ATmega88__) || \
33
	(__AVR_ATmega168__) || defined (__AVR_ATmega168P__) || \
34
	(__AVR_ATmega328__) || defined (__AVR_ATmega328P__)
35
#warning "Cette librairie n'as pas été testée sur cette famille de microcontrôleur."
36
#endif
37
```
38
39
Exemple :
40
```c
41 7 Patrice Nadeau
#include <avr/io.h>
42 1 Patrice Nadeau
#include <avr/pgmspace.h>
43 8 Patrice Nadeau
#include <util/atomic.h>
44
45 1 Patrice Nadeau
...
46
/** @brief Variable en FLASH */
47
const int Variable1_P PROGMEM = 42;
48 8 Patrice Nadeau
49
ATOMIC_BLOCK(ATOMIC_RESTORESTATE) {
50
    ...
51
}
52 1 Patrice Nadeau
53
54
/** 
55
 * @brief Never ending loop
56
*/
57
void main(void) __attribute__((noreturn));
58
59
/* main function definition */
60
void main(void) {
61
    ...
62
    /* never return */
63
    for (;;) {
64
    };
65
};
66
```
67
68
### Opérations « atomiques »
69
Opérations ne devant pas être interrompus (Ex. : charger un registre de 16 bits avec un registre de 8 bits).
70
71
La librairie `avr-libc` (util/atomic.h) fournit des macros permettant la gestion entre autre des interruptions.
72
73
Les instructions critiques sont insérées dans un `ATOMIC_BLOCK`.
74
75
Exemple :
76
```c
77
#include <util/atomic.h>
78
...
79
ATOMIC_BLOCK(ATOMIC_RESTORESTATE) {
80
    ...
81
}
82
...
83
```