pse-firmware/docs/Upload.md

Procédure de mise à jour du logiciel embarqué, en utilisant l'environnement STM32CubeIDE à partir du code disponible sur git.

# Résumé
1. [Installer STM32CubeIDE](#installer-le-programme-stm32cubeide)
3. [Installer le plugin EGit](#installer-le-plugin-egit)
4. [Télécharger le projet à partir du dépot](#importer-le-projet)
5. [Envoyer le projet sur la carte](#téléverser-le-logiciel)

# Installer le programme STM32CubeIDE
Le programme STM32CubeIDE est disponible (Win, Mac, Linux) gratuitement sur le site du fabricant (https://www.st.com/en/development-tools/stm32cubeide.html) moyennant la création d'un compte lui aussi gratuit.

# Installer le plugin EGit :
1. Help > Eclipse Marketplace ![](Marketplace.png)
2. Chercher "git" ![](Git_search.png)
3. Choisir "EGit - Git integration for Eclipse" et cliquer "install"
4. Dans le choix des option voulues ne garder que celles nécessaires ![](egit_install.png)
5. L'installation peut prendre quelque minutes (indicateur en bas à droite ![](install_status.png))
6. Redémarrer le programme quand le dialogue apparaît : ![](restart_after_install.png)

# Importer le projet :
1. File > Import Project
2. Un menu "select" apparaît
   Git > Projects from Git > Next ![](import_project.png)
4. Dans le menu "Select repository source"
   sélectionner "Clone URI"  ![](repo_src_sel.png)
5. Dans le menu "Source Git Repository"
   Entrer l'adresse du dépôt (https://git.leserveurdansmongrenier.uk/leo/PSE-firmware.git) dans le champ "URI" ![](repo_src.png)
6. Dans le menu "Branch selection"
   Choisir la branche "master" ![](branch.png)
7. Dans le menu "Local Destination"
   Modifier au besoin l'emplacement de sauvegarde du dépôt
   > ⚠ Penser à bien sélectionner l'option "clone submodules" pour télécharger en même temps tout les éléments. ![](local_dest.png)
8. Le projet va maintenant être téléchargé, cette opération peut prendre plusieurs minutes. ![](clone_process.png)
9. Dans le menu "Select wizard to use for importing project"
   Sélectionner "Import existing Eclipse project" ![](import_type.png)
10. Dans le menu "Import Project" garder les options par défaut ![](final_import.png)

# Téléverser le logiciel
1. Connecter l'interface STLink à la carte selon la définition des pins suivante : ![](carte_alfawise_ann_annotated.png)
2. Envoyer le logiciel : `Run` ![](run.png)
   Le code est compilé puis envoyé sur le carte : la LED d'état du STLink clignote pendant l'envoi. Après quelques minutes la carte redémarre, le logiciel est maintenant mis à jour.