aboutsummaryrefslogtreecommitdiff
path: root/docs/fr-fr/flashing.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/fr-fr/flashing.md')
-rw-r--r--docs/fr-fr/flashing.md238
1 files changed, 0 insertions, 238 deletions
diff --git a/docs/fr-fr/flashing.md b/docs/fr-fr/flashing.md
deleted file mode 100644
index 9f5493194..000000000
--- a/docs/fr-fr/flashing.md
+++ /dev/null
@@ -1,238 +0,0 @@
1# Instructions pour flasher et informations sur les bootloader
2
3Les claviers utilisent différents types de bootloaders et certains doivent être flashés différement. Heureusement, certains projets comme la [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases) ont pour objectifs de permettre de flasher les différents bootloader sans trop se faire de soucis et ça peu importe les manières de les flasher.
4
5Si vous avez un bootloader sélectionné avec la variable `BOOTLOADER` dans votre fichier `rules.mk` alors QMK vas automatiquement calculer si votre fichier .hex n'est pas trop grand pour être flashé sur votre appareil, et il affichera la taille finale du firmware. Pour vérifier la taille manuellement, vous pouvez aussi compiler le firmware avec l'option `check-size`. Exemple : `make planck/rev4:default:check-size`.
6
7## DFU
8
9Le bootloader pour les processeurs Atmel DFU est fourni par défaut sur tous les processeurs atmega32u4. Celui-ci est utilisé par beaucoup de claviers plus vieux que les OLKB et Clueboard qui ont leur propre ICs sur leurs PCBs. D'autres claviers utilisent le bootloader DFU de LUFA (ou son fork QMK), notamment les nouveaux claviers OLKB. Ce dernier ajoute des fonctionnalités spécifiques sur le matériel.
10
11Pour vérifier la compatibilité avec le bootloader DFU, vérifiez que ce bloc de code est présent dans votre fichier `rules.mk`. Parfois il peut être inscrit `lufa-dfu` ou `qmk-dfu` à la place.
12
13```make
14# Bootloader selection
15# Teensy halfkay
16# Pro Micro caterina
17# Atmel DFU atmel-dfu
18# LUFA DFU lufa-dfu
19# QMK DFU qmk-dfu
20# ATmega32A bootloadHID
21# ATmega328P USBasp
22BOOTLOADER = atmel-dfu
23```
24
25Méthodes de flash compatibles :
26
27* [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases) (interface graphique recommandé)
28* [dfu-programmer](https://github.com/dfu-programmer/dfu-programmer) / `:dfu` avec QMK (outil en ligne de commande recommandé)
29
30Ordre des actions:
31
321. Pressez le keycode `RESET`, ou appuyez sur le bouton physique RESET ou alors créez un contact entre RST et GND.
332. Attendez que l'OS detecte l'appareil.
343. Éffacez la mémoire, cela peut être fait automatiquement.
354. Flasher le fichier .hex.
365. Redémarrez l'appareil en mode «application», cela peut être fait automatiquement.
37
38Alternativement:
39
40 make <keyboard>:<keymap>:dfu
41
42### DFU QMK
43
44QMK a un fork du bootloader LUFA DFU qui vous permet de faire un simple scan de la matrice pour quitter le bootloader et retourner à l'application. En même temps que le flash se produira, il est possible de faire flasher un led ou de produire un son via un haut parleur. Pour activer ces fonctionnalités, vous pouvez utiliser ce bloc dans votre fichier `config.h` (La touche permettant de quitter le bootloader a besoin d'être reliée entre les ports définis en INPUT et OUTPUT ici):
45
46 #define QMK_ESC_OUTPUT F1 // usually COL
47 #define QMK_ESC_INPUT D5 // usually ROW
48 #define QMK_LED E6
49 #define QMK_SPEAKER C6
50
51Le fabricant et le nom du produit proviennent de vos définitions dans fichier `config.h`, et la chaîne de caractère «bootloader» est ajoutée au nom du produit.
52
53Pour génerer le bootloader, utilisez la cible `bootloader`. Exemple: `make planck/rev4:default:bootloader`.
54
55Pour génerer un fichier .hex prêt pour la production qui contiendra tant l'application que le bootloader, utilisez la cible `production`. Exemple: `make planck/rev4:default:production`.
56
57### Commandes DFU
58
59Il y a plusieurs commandes DFU que vous pouvez utiliser pour flasher le firmware sur un appareil DFU.
60
61* `:dfu` - C'est l'option normale qui attend qu'un appareil DFU soit disponible et qui flashe le firmware dès que c'est le cas. La vérification sera faite toutes les 5 secondes.
62* `:dfu-ee` - Cette option flash un fichier `.eep` à la place d'un fichier `.hex`. Ce cas est plutôt rare.
63* `:dfu-split-left` - Cette option flashe le firmware normal comme avec l'option (`:dfu`). Mais cela aussi flash le coté gauche du fichier EEPROM pour les claviers scindés. _C'est l'option idéale pour un clavier scindé basé sur le Elite C_
64* `:dfu-split-right` - Cette option flashe le firmware normal comme avec l'option (`:dfu`). Mais cela aussi flash le coté droite du fichier EEPROM pour les claviers scindés. _C'est l'option idéale pour un clavier scindé basé sur le Elite C_
65
66## Caterina
67
68Les cartes arduinos et leurs clones utilisent le [bootloader Caterina](https://github.com/arduino/ArduinoCore-avr/tree/master/bootloaders/caterina) (tous les claviers utilisant un Pro Micro, ou un clone). Ils utilisent aussi le protocole avr109 pour communiquer en virtuellement en série (serial en anglais). Les bootloaders comme le [A-Star](https://www.pololu.com/docs/0J61/9) sont basés sur Caterina.
69
70Pour vérifier la compatibilité avec un bootloader Caterina, vérifiez que ce bloc est présent dans votre fichier `rules.mk`:
71
72```make
73# Bootloader selection
74# Teensy halfkay
75# Pro Micro caterina
76# Atmel DFU atmel-dfu
77# LUFA DFU lufa-dfu
78# QMK DFU qmk-dfu
79# ATmega32A bootloadHID
80# ATmega328P USBasp
81BOOTLOADER = caterina
82```
83
84Flashers compatibles:
85
86* [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases) (Interface graphique recommandée)
87* [avrdude](https://www.nongnu.org/avrdude/) avec avr109 / `:avrdude` (Outil en ligne de commande recommandé)
88* [AVRDUDESS](https://github.com/zkemble/AVRDUDESS)
89
90Séquence de flash :
91
921. Pressez la touche avec le keycode `RESET`, ou reliez les ports GND et RST. Vous n'avez que 7 secondes pour flasher une fois que l'opération a été faite.
932. Attendez que l'OS détecte l'appareil.
943. Flasher le fichier .hex.
954. Attendez que l'appareil redémarre automatiquement.
96
97ou, utilisez:
98
99 make <keyboard>:<keymap>:avrdude
100
101#### Commandes Caterina
102
103Il existe un certain nombre de commandes DFU que vous pouvez utiliser pour mettre à jour le firmware sur un périphérique DFU:
104
105* `: avrdude` - Il s’agit de l’option normale. Le script va attendre qu’un appareil Caterina soit disponible. Dès que c’est le cas, il flash le firmware. Il attendra de détecter un nouveau port COM pour le flasher.
106* `: avrdude-loop` - Cela fonctionne de la même manière que`: avrdude`, mais une fois que chaque périphérique est flashé, il tentera de flasher à nouveau. Cela peut être utile pour flasher plusieurs claviers à la suite. _Cela implique de sortir manuellement de la boucle en appuyant sur Ctrl + C, Cmd + C ou un raccourci équivalent selon votre OS_
107* `: avrdude-split-left` - Cela fonctionne de la même manière que la fonction (`: avrdude`). Toutefois, cela permet aussi de flasher le coté gauche de l'EEPROM des claviers splittés / divisés. C'est donc la méthode recommandée pour les claviers splittés avec Pro Micro.
108* `: avrdude-split-right` - Cela fonctionne de la même manière que la fonction (`: avrdude`). Toutefois, cela permet aussi de flasher le coté droite de l'EEPROM des claviers splittés / divisés. C'est donc la méthode recommandée pour les claviers splittés avec Pro Micro.
109
110## Halfkay
111
112Halfkay est un protocole ultra-simple développé par PJRC qui utilise HID et qui est fourni avec tous les Teensys après le modèle 2.0.
113
114Pour vérifier la compatibilité avec le booloader Halfkay, vérifiez que ce bloc est présent dans votre fichier `rules.mk`:
115
116```make
117# Bootloader selection
118# Teensy halfkay
119# Pro Micro caterina
120# Atmel DFU atmel-dfu
121# LUFA DFU lufa-dfu
122# QMK DFU qmk-dfu
123# ATmega32A bootloadHID
124# ATmega328P USBasp
125BOOTLOADER = halfkay
126```
127
128Flasher compatibles:
129
130* [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases) (Interface graphique recomandée)
131* [Teensy Loader](https://www.pjrc.com/teensy/loader.html) (petit utilitaire ultra simple)
132 [Teensy Loader en ligne de commande](https://www.pjrc.com/teensy/loader_cli.html) (Outil en ligne de commande recommandé)
133
134Séquence de flash:
135
1361. Pressez la touche du keycode `RESET`, ou reliez les ports RST et GND rapidement. Vous avez ensuite 7 secondes pour réaliser le flash.
1372. Attendez que l'OS détecte l'appareil.
1383. Flasher le fichier .hex.
1394. Redémarrez l'appareil en mode «application». Cela peut être fait automatiquement.
140
141## USBasploader
142
143USBasploader est un bootloader développé par matrixstorm. Il est utilisé sur des processeurs AVR non-USB comme le ATmega328P, qui fonctionne grâce à V-USB.
144
145Pour vérifier la compatibilité avec le booloader USBasploader, vérifiez que ce bloc est présent dans votre fichier `rules.mk`:
146
147```make
148# Bootloader selection
149# Teensy halfkay
150# Pro Micro caterina
151# Atmel DFU atmel-dfu
152# LUFA DFU lufa-dfu
153# QMK DFU qmk-dfu
154# ATmega32A bootloadHID
155# ATmega328P USBasp
156BOOTLOADER = USBasp
157```
158
159Flashers compatibles:
160
161* [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases) (Interface graphique recommandé)
162* [avrdude](https://www.nongnu.org/avrdude/) avec le programmeur `usbasp`.
163* [AVRDUDESS](https://github.com/zkemble/AVRDUDESS)
164
165Séquence de flash:
166
1671. Pressez la touche du keycode `RESET`, ou reliez le port de boot pendant que RST et GND snt reliés. Cela doit être fait très rapidement.
1682. Attendez que l'OS détecte l'appareil.
1693. Flasher le fichier .hex.
1704. Redémarrez l'appareil en mode «application». Cela peut être fait automatiquement.
171
172## BootloadHID
173
174BootloadHID est un bootloader pour les microcontrôleurs AVR. L'utilitaire de téleversement ne demande pas de drivers au niveau du kernel et peut être lancé sans installer aucune DLLs.
175
176Pour vérifier la compatibilité avec le bootloader bootloadHID, vérifiez que ce bloc existe dans votre fichier `rules.mk` :
177
178```make
179# Bootloader selection
180# Teensy halfkay
181# Pro Micro caterina
182# Atmel DFU atmel-dfu
183# LUFA DFU lufa-dfu
184# QMK DFU qmk-dfu
185# ATmega32A bootloadHID
186# ATmega328P USBasp
187BOOTLOADER = bootloadHID
188```
189
190Utilitaires de flash compatibles:
191
192* [HIDBootFlash](http://vusb.wikidot.com/project:hidbootflash) (Utilitaire avec interface graphique recommandé)
193* [bootloadhid Command Line](https://www.obdev.at/products/vusb/bootloadhid.html) / `:BootloadHID` avec QMK (utilitaire en ligne de commande recommandé)
194
195Séquence de flash
196
1971. Entrez dans le bootloader en utilisant l'une de ces méthodes:
198 * Pressez la touche du keycode `RESET` (Cela ne fonctionnera pas sur certains appareils).
199 * Verrouillez la touche «Salt» tout en branchant le clavier (Généralement ce principe est documenté dans le fichier readme du clavier)
2002. Attendez que l'OS détecte l'appareil.
2013. Flasher le fichier .hex.
2024. Redémarrez l'appareil en mode «application». Cela peut être fait automatiquement.
203
204Ou alors:
205
206 make <keyboard>:<keymap>:bootloadHID
207
208## STM32
209
210Tous les processeurs STM32 contiennent un bootloader installé en usine qui ne peut pas être modifié ou supprimé. Certains processeurs STM32 ont des bootloaders qui ne peuvent pas être programmés par USB (ex: STM32F103) mais le processus reste le même.
211
212Pour le moment, aucune variable `BOOTLOADER` n'est nécessaire dans le fichier `rules.mk`.
213
214Flashers compatibles:
215
216* [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases) (interface graphique recommandé)
217* [dfu-util](https://github.com/Stefan-Schmidt/dfu-util) / `:dfu-util` (utilitaire en ligne de commande recommandé)
218
219Séquence pour flasher:
220
2211. Entrez dans le bootloader en utilisant l'une de ces méthodes:
222 * Utilisez une touche sur laquelle le keycode `RESET` (Cela peut ne pas fonctionner sur les appareils STM32F042)
223 * Si un circuit de réinitialisation (Reset) est présent alors utilisé le bouton qui lui est dédié.
224 * Autrement, vous devez réaliser une liaison entre BOOT0 et VCC (en appuyant sur le bouton ou à l'aide d'un pont) puis faire un pont entre RESET et GND et enfin relacher le pont BOOT0.
2252. Attendre que l'os détecte l'appareil.
2263. Flasher un fichier `.bin`.h
227 * Vous allez recevoir un avertissement à propos de la signature DFU. Ignorez-la.
2284. Réinitialisez l'appareil en mode «application». Cela peut être fait automatiquement.
229 * Si vous êtes en train de travailler en ligne de commande, par exemple avec un `make planck/rev6:default:dfu-util` alors soyez bien sur que l'argument `:leave` est passé aux arguments DFU grâce à la variable `DFU_ARGS` à l'intérieur de votre fichier `rules.mk` (Ex: `DFU_ARGS = -d 0483:df11 -a 0 -s 0x08000000:leave`) afin que votre appareil redémarre après avoir été flashé.
230
231### Commandes STM32
232
233Il y a différentes commandes que vous pouvez utiliser pour flasher un firmware dans un appareil STM32:
234
235* `:dfu-util` - C'est l'option standard pour flasher un appareil STM32. Le script attendra qu'un bootloader STM32 soit présent.
236* `:dfu-util-split-left` - Permet de flasher un firmware normalement, tout comme l'option précédente mais permet de configurer le côté gauche des paramètres EEPROM sur un clavier scindé.
237* `:dfu-util-split-right` - Permet de flasher un firmware normalement, tout comme l'option précédente mais permet de configurer le côté droit des paramètres EEPROM sur un clavier scindé.
238* `:st-link-cli` - Cela permet de flasher le firmware avec l'utilitaire en ligne de commande ST-LINK's plutôt que d'utiliser dfu-util.