Projet

Général

Profil

Atmel AVR » Historique » Version 11

Patrice Nadeau, 2024-01-27 14:49

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 10 Patrice Nadeau
    1. Inclure la librairie `util/atomic.h`
22
    1. Insérer les instructions dans une section `ATOMIC_BLOCK`
23 2 Patrice Nadeau
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 11 Patrice Nadeau
68
## Justifications
69
* [Atmel AVR4027 : Tips and Tricks to Optimize Your C Code for 8-bit AVR Microcon-trollers](https://ww1.microchip.com/downloads/en/AppNotes/doc8453.pdf)
70
* [AVR035 : Efficient C Coding for AVR6](https://ww1.microchip.com/downloads/en/AppNotes/doc1497.pdf)
71
* [Vérification du modèle de microcontrôleur via l’option -m de gcc](https://github.com/embecosm/avr-gcc/blob/avr-gcc-mainline/gcc/config/avr/avr-mcus.def)