Deploying to gh-pages from @ Klipper3d/klipper@3bd0be40d5 🚀

This commit is contained in:
KevinOConnor
2023-05-04 00:03:34 +00:00
parent 1dbb07fa83
commit c3d0aece71
45 changed files with 609 additions and 614 deletions

View File

@@ -1628,7 +1628,7 @@
<p>Ce document tente de décrire les chargeurs de démarrage courants, les étapes nécessaires pour flasher un chargeur de démarrage et les étapes nécessaires pour flasher une application. Ce document n'est pas une référence faisant autorité ; il est conçu comme une collection d'informations utiles que les développeurs de Klipper ont accumulées.</p>
<h2 id="micro-controleurs-avr">Micro-contrôleurs AVR<a class="headerlink" href="#micro-controleurs-avr" title="Permanent link">&para;</a></h2>
<p>De manière générale, le projet Arduino est une bonne référence pour les chargeurs de démarrage et les procédures de flashage sur les microcontrôleurs Atmel Atmega 8 bits. En particulier, le fichier "boards.txt" : <a href="https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt">https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt</a> est une référence utile.</p>
<p>Pour flasher le chargeur de démarrage, les puces AVR nécessitent un outil de flashage matériel externe (qui communique avec la puce à l'aide de SPI). Cet outil peut être acheté (par exemple, effectuez une recherche sur le Web pour "avr isp", "arduino isp" ou "usb tiny isp"). Il est également possible d'utiliser un autre Arduino ou Raspberry Pi pour flasher un chargeur de démarrage AVR (par exemple, faites une recherche sur le Web pour "programmer un avr à l'aide de raspberry pi"). Les exemples ci-dessous sont écrits en supposant qu'un appareil de type "AVR ISP Mk2" est utilisé.</p>
<p>Pour flasher le chargeur de démarrage, les puces AVR nécessitent un outil de flashage matériel externe (qui communique avec la puce à l'aide de SPI). Cet outil peut être acheté (par exemple, effectuez une recherche sur internet avec "avr isp", "arduino isp" ou "usb tiny isp"). Il est également possible d'utiliser un autre Arduino ou Raspberry Pi pour flasher un chargeur de démarrage AVR (par exemple, faites une recherche sur le internet pour "programmer un avr à l'aide de raspberry pi"). Les exemples ci-dessous sont écrits en supposant qu'un appareil de type "AVR ISP Mk2" est utilisé.</p>
<p>Le logiciel "avrdude" est l'outil le plus utilisé pour flasher les puces atmega (à la fois pour flasher le chargeur de démarrage et l'application).</p>
<h3 id="atmega2560">Atmega2560<a class="headerlink" href="#atmega2560" title="Permanent link">&para;</a></h3>
<p>Cette puce se trouve généralement dans les "Arduino Mega" qui sont très courante parmi les cartes d'imprimante 3d.</p>
@@ -1776,7 +1776,7 @@ stm32flash -w generic_boot20_pc13.bin -v -g 0 /dev/ttyAMA0
<p>Le chargeur de démarrage ne s'exécute généralement que pendant une courte période après le démarrage. Il peut être nécessaire de chronométrer la commande ci-dessus pour qu'elle s'exécute pendant que le chargeur de démarrage est toujours actif (le chargeur de démarrage fait clignoter une LED de la carte pendant son exécution). Vous pouvez également définir la broche "boot 0" sur low et la broche "boot 1" sur high pour rester en mode chargeur de démarrage après une réinitialisation.</p>
<h3 id="stm32f103-avec-chargeur-de-demarrage-hid">STM32F103 avec chargeur de démarrage HID<a class="headerlink" href="#stm32f103-avec-chargeur-de-demarrage-hid" title="Permanent link">&para;</a></h3>
<p>Le <a href="https://github.com/Serasidis/STM32_HID_Bootloader">chargeur de démarrage HID</a> est un chargeur de démarrage compact et sans pilote capable de flasher via USB. Un <a href="https://github.com/Arksine/STM32_HID_Bootloader/releases/latest">fork avec des builds spécifiques au SKR Mini E3 1.2</a> est également disponible.</p>
<p>For generic STM32F103 boards such as the blue pill it is possible to flash the bootloader via 3.3V serial using stm32flash as noted in the stm32duino section above, substituting the file name for the desired hid bootloader binary (ie: hid_generic_pc13.bin for the blue pill).</p>
<p>Pour les cartes STM32F103 génériques telles que la 'blue pill', il est possible de flasher le chargeur de démarrage via une ligne série 3,3 V en utilisant stm32flash comme indiqué dans la section stm32duino ci-dessus, en remplaçant le nom de fichier par le binaire du chargeur de démarrage hid souhaité (c'est-à-dire : hid_generic_pc13.bin pour la 'blue pill').</p>
<p>Il n'est pas possible d'utiliser stm32flash pour le SKR Mini E3 car la broche boot0 est directement liée à la terre et non connectée via des broches d'en-tête. Il est recommandé d'utiliser un STLink V2 avec le programmeur STM32Cube pour flasher le bootloader. Si vous n'avez pas accès à un STLink, il est également possible d'utiliser un <a href="#running-openocd-on-the-raspberry-pi">Raspberry Pi et OpenOCD</a> avec la configuration de puce suivante :</p>
<div class="highlight"><pre><span></span><code>source [find target/stm32f1x.cfg]
</code></pre></div>
@@ -1829,10 +1829,10 @@ make
<div class="highlight"><pre><span></span><code>make flash FLASH_DEVICE=/dev/ttyACM0
</code></pre></div>
<p>It may be necessary to manually enter the bootloader, this can be done by setting "boot 0" low and "boot 1" high. On the SKR Mini E3 "Boot 1" is not available, so it may be done by setting pin PA2 low if you flashed "hid_btt_skr_mini_e3.bin". This pin is labeled "TX0" on the TFT header in the SKR Mini E3's "PIN" document. There is a ground pin next to PA2 which you can use to pull PA2 low.</p>
<p>Il peut être nécessaire d'entrer manuellement dans le chargeur de démarrage, cela peut être fait en définissant "boot 0" au niveau bas et "boot 1" au niveau haut. Sur la SKR Mini E3 "Boot 1" n'est pas disponible, vous pouvez donc le faire en mettant la broche PA2 au niveau bas si vous avez flashé "hid_btt_skr_mini_e3.bin". Cette broche est étiquetée "TX0" sur le connecteur TFT dans le document "PIN" du SKR Mini E3. Il y a une broche de terre à côté de PA2 que vous pouvez utiliser pour mettre PA2 au niveau bas.</p>
<h3 id="stm32f103stm32f072-avec-chargeur-de-demarrage-msc">STM32F103/STM32F072 avec chargeur de démarrage MSC<a class="headerlink" href="#stm32f103stm32f072-avec-chargeur-de-demarrage-msc" title="Permanent link">&para;</a></h3>
<p>Le <a href="https://github.com/Telekatz/MSC-stm32f103-bootloader">chargeur de démarrage MSC</a> est un chargeur de démarrage sans pilote capable de flasher via USB.</p>
<p>It is possible to flash the bootloader via 3.3V serial using stm32flash as noted in the stm32duino section above, substituting the file name for the desired MSC bootloader binary (ie: MSCboot-Bluepill.bin for the blue pill).</p>
<p>Il est possible de flasher le chargeur de démarrage via une ligne série 3,3 V en utilisant stm32flash comme indiqué dans la section stm32duino ci-dessus, en remplaçant le nom de fichier par le binaire du chargeur de démarrage MSC souhaité (c'est-à-dire : MSCboot-Bluepill.bin pour la 'blue pill).</p>
<p>Pour les cartes STM32F072, il est également possible de flasher le bootloader via USB (via DFU) avec quelque chose comme :</p>
<div class="highlight"><pre><span></span><code> dfu-util -d 0483:df11 -a 0 -R -D MSCboot-STM32F072.bin -s0x08000000:leave
</code></pre></div>
@@ -1841,7 +1841,7 @@ make
<p>Le chargeur de démarrage peut être activé en appuyant deux fois sur le bouton de réinitialisation de la carte. Dès que le chargeur de démarrage est activé, la carte apparaît comme une clé USB sur laquelle le fichier klipper.bin peut être copié.</p>
<h3 id="stm32f103stm32f0x2-avec-chargeur-de-demarrage-canboot">STM32F103/STM32F0x2 avec chargeur de démarrage CanBoot<a class="headerlink" href="#stm32f103stm32f0x2-avec-chargeur-de-demarrage-canboot" title="Permanent link">&para;</a></h3>
<p>Le chargeur de démarrage <a href="https://github.com/Arksine/CanBoot">CanBoot</a> offre une option pour télécharger le micrologiciel Klipper via le CANBUS. Le chargeur de démarrage lui-même est dérivé du code source de Klipper. Actuellement, CanBoot prend en charge les modèles STM32F103, STM32F042 et STM32F072.</p>
<p>It is recommended to use a ST-Link Programmer to flash CanBoot, however it should be possible to flash using <code>stm32flash</code> on STM32F103 devices, and <code>dfu-util</code> on STM32F042/STM32F072 devices. See the previous sections in this document for instructions on these flashing methods, substituting <code>canboot.bin</code> for the file name where appropriate. The CanBoot repository linked above provides instructions for building the bootloader.</p>
<p>Il est préférable d'utiliser un programmeur ST-Link pour flasher CanBoot, mais il est possible de le flasher en utilisant <code>stm32flash</code> sur les appareils STM32F103 et <code>dfu-util</code> sur les appareils STM32F042/STM32F072. Consultez les sections précédentes de ce document pour obtenir des instructions sur ces méthodes de flash, en remplaçant <code>canboot.bin</code> par le nom de fichier, le cas échéant. Le référentiel CanBoot lié ci-dessus fournit des instructions pour créer le chargeur de démarrage.</p>
<p>La première fois que CanBoot a été flashé, il devrait détecter qu'aucune application n'est présente et entrer dans le chargeur de démarrage. Si cela ne se produit pas, il est possible d'entrer dans le chargeur de démarrage en appuyant deux fois de suite sur le bouton de réinitialisation.</p>
<p>L'utilitaire <code>flash_can.py</code> fourni dans le dossier <code>lib/canboot</code> peut être utilisé pour télécharger le firmware Klipper. L'UUID de l'appareil doit clignoter. Si vous n'avez pas d'UUID, il est possible d'interroger les nœuds exécutant actuellement le chargeur de démarrage :</p>
<div class="highlight"><pre><span></span><code>python3 flash_can.py -q
@@ -1855,8 +1855,8 @@ make
<p><code>aabbccddeeff</code> est remplacé par votre UUID. Notez que les options <code>-i</code> et <code>-f</code> peuvent être omises, elles sont par défaut sur <code>can0</code> et <code>~/klipper/out/klipper.bin</code>.</p>
<p>Lors de la création de Klipper pour une utilisation avec CanBoot, sélectionnez l'option 8 KiB Bootloader.</p>
<h2 id="micro-controleurs-stm32f4-skr-pro-11">Micro-contrôleurs STM32F4 (SKR Pro 1.1)<a class="headerlink" href="#micro-controleurs-stm32f4-skr-pro-11" title="Permanent link">&para;</a></h2>
<p>STM32F4 micro-controllers come equipped with a built-in system bootloader capable of flashing over USB (via DFU), 3.3V Serial, and various other methods (see STM Document AN2606 for more information). Some STM32F4 boards, such as the SKR Pro 1.1, are not able to enter the DFU bootloader. The HID bootloader is available for STM32F405/407 based boards should the user prefer flashing over USB over using the sdcard. Note that you may need to configure and build a version specific to your board, a <a href="https://github.com/Arksine/STM32_HID_Bootloader/releases/latest">build for the SKR Pro 1.1 is available here</a>.</p>
<p>Unless your board is DFU capable the most accessible flashing method is likely via 3.3V serial, which follows the same procedure as <a href="#stm32f103-micro-controllers-blue-pill-devices">flashing the STM32F103 using stm32flash</a>. For example:</p>
<p>Les microcontrôleurs STM32F4 sont équipés d'un chargeur de démarrage système intégré capable de flasher via USB (via DFU), série 3,3 V et diverses autres méthodes (voir le document STM AN2606 pour plus d'informations). Certaines cartes STM32F4, telles que le SKR Pro 1.1, ne peuvent pas passer en mode DFU. Le chargeur de démarrage HID est disponible pour les cartes basées sur STM32F405/407 si l'utilisateur préfère flasher sur USB plutôt que d'utiliser la carte SD. Notez que vous devrez peut-être configurer et construire une version spécifique à votre carte, une <a href="https://github.com/Arksine/STM32_HID_Bootloader/releases/latest">version pour le SKR Pro 1.1 est disponible ici</a>.</p>
<p>À moins que votre carte ne soit compatible DFU, la méthode de flashla plus accessible est probablement via une ligne série 3,3 V, qui suit la même procédure que <a href="#stm32f103-micro-controllers-blue-pill-devices">flasher le STM32F103 avec stm32flash</a>. Par exemple:</p>
<div class="highlight"><pre><span></span><code>wget https://github.com/Arksine/STM32_HID_Bootloader/releases/download/v0.5-beta/hid_bootloader_SKR_PRO.bin
stm32flash -w hid_bootloader_SKR_PRO.bin -v -g 0 /dev/ttyAMA0