29 917
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 1 :
Ligne 1 : − − {{traduction}} Ligne 94 :
Ligne 92 : − − {{traduction}} Ligne 109 :
Ligne 105 : − + − When booting, two files are executed automatically: first boot.py and then main.py. These are placed in the /flash folder on the board. Any other files or libraries can be placed here as well, and included or used from boot.py or main.py.+ − The folder structure in /flash looks like the picture below. The files can be managed either using [[hack-pycom-lopy-ftp|FTP]] or using [[hack-pycom-lopy-ftp|Pymakr]].+ − To make it as easy as possible, we developed Pymakr, a tool that will allow you to connect to and program your Pycom devices. We’re going to use it in this section to give you a quick taste of how you can work with your device. You can download Pymakr from [https://www.pycom.io/solutions/pymakr/ lien].+ + + − More extended info on pymakr like how to use the pycom console and the expert interface can be found under [[Hack-pycom-esp_32-Pymakr|Pymakr]]+ − + − After installing Pymakr, you need to take a few seconds to configure it for the first time. Please follow these steps:+ − + − + − + − + − + − + + + − + − That’s it for the first time configuration. In the lower portion of the screen, you should see the console, with the connection process taking place. At the end of it, you’ll get a ‘connected’ message and a colored '''>>>''' prompt, indicating that you are connected:+ + + − + − + − * In Pymakr, go to Project > New project.+ − * Give it a name and select a folder for your project, either a new of existing one. − * Create two files: main.py and boot.py, if you don’t already have those. − {{ambox|text=You can also use FTP to download boot.py and main.py from the board to your project folder, after which you can right-click the project viewer and use the ‘add source files’ option to add them to your project.}}+ + + − The boot.py file should always have the following code on the top, so we can run our python scripts over serial or telnet. All of our newer boards have this code already in the boot.py file.+ + + Ligne 161 :
Ligne 165 : − Most users, especially WiPy users, would want a wifi script in the boot.py file. A basic wifi script but also more advanced WLAN examples, like fixed IP and multiple networks, can be found in the [https://docs.pycom.io/pycom_esp32/pycom_esp32/tutorial/includes/wlan.html#wlan-step-by-step Wifi Examples] chapter (''PyCom, anglais''). Nous avons également [[Hack-wipy-wlan|un tutoriel en Français sur le sujet]] (également applicable à Wipy2 et Lopy même s'il s'agit d'un tutoriel WiPy 1).+ − Besides the neccesary main.py and boot.py files, you can create any folders and python files or libraries that you want to include in your main file. Pymakr will synchronize all files in the project to the board when using the sync button.+ − + − If you just want to test some code on the module, you can create a new file or open an existing one and press the ‘run’ button.+ − + − For fun, lets try again to build a traffic light. Add the following code to the main.py file:+ Ligne 188 :
Ligne 192 : − + − + − Here is the expected result:+ − You now have a traffic light in your hands! To stop a running program, use ctrl-c or do a right click on the console and press Reset. You can also reboot the board by pressing the physical {{fname|reset}} button.+ − − {{tmbox| type = speedy |text=If your board is running code at boot time, you might need to boot it in safe mode.}} +
aucun résumé de modification
{{LOPY-NAV}}
{{LOPY-NAV}}
= Un guide de démarrage rapide =
= Un guide de démarrage rapide =
Connecter la broche G23 à la masse permet de placer la carte en "mode de mise-à-jour". Vous n'aurez pas besoin de réaliser cette tâche que pour faire une mise-à-jour du FirmWare.
Connecter la broche G23 à la masse permet de placer la carte en "mode de mise-à-jour". Vous n'aurez pas besoin de réaliser cette tâche que pour faire une mise-à-jour du FirmWare.
Une fois la mise-à-jour terminée, vous pouvez utiliser Pymakr pour téléverser et exécuter vos programmes sur votre périphérique.
Une fois la mise-à-jour terminée, vous pouvez utiliser Pymakr pour téléverser et exécuter vos programmes sur votre périphérique.
= Introduction à MicroPython =
= Introduction à MicroPython =
Les cartes PyCom boards work with [https://micropython.org/ Micropython]; a Python 3 implementation that is optimised to run on micocontrollers. This allows for much faster and easier development than using C.
Les cartes PyCom fonctionne avec [https://micropython.org/ Micropython]; une implémentation de Python 3 optimisée pour microcontrôleurs. Cela permet de débuter vos développements plus rapidement et plus facilement qu'avec des plateformes orientés C/C++.
Lorsque le WiPy démarre (boot), deux fichiers sont automatiquement exécutés: d'abord {{fname|boot.py}} puis {{fname|main.py}}. Ces fichiers sont placés dans le répertoire {{fname|/flash}} de la carte. Tous les autres fichiers et bibliothèques peuvent également être placés ici pour être importé ou utilisé depuis boot.py (ou main.py).
La structure des répertoire dans {{fname|/flash}} ressemble à la capture d'image ci-dessous. Les fichiers peuvent être gérés en utilisant un client [[hack-pycom-lopy-ftp|FTP]] ou [[hack-pycom-lopy-ftp|Pymakr]] ou [[MicroPython-Hack-RShell|RShell (comme avec de nombreuses autres plateformes)]].
[[Fichier:Hack-pycom-esp_32-40.png|240px]]
[[Fichier:Hack-pycom-esp_32-40.png|240px]]
= Se connecter sur la carte avec Pymakr =
= Se connecter sur la carte avec Pymakr =
Il y a plusieurs façon de se connecter sur votre WiPy.... Les fichiers peuvent être gérés en utilisant un [[Hack-pycom-lopy-ftp|client FTP, Telnet]] ou [[MicroPython-Hack-RShell|RShell]] mais '''le plus simple est probablement l'utilisation de Pymakr''', un éditeur intégré abordé ci-dessous.
Pour faciliter les développements, Pycom.io à développé Pymakr, un outil qui vous permet de vous connecter et de programmer vos cartes Pycom. Nous allons utiliser ici pour vous donner un avant goût des possibilités. [https://www.pycom.io/solutions/pymakr/ Vous pouvez télécharger Pymakr depuis ce lien].
Vous trouverez [[Hack-pycom-esp_32-Pymakr|plus d'informations sur l'utilisation de Pymakr ici]], entre-autre sur l'utilisation de la console et interface expert.
{{ambox|text=If you have any trouble connecting over USB using pymakr, make sure you have the proper FTDI drivers installed}}
{{ambox|text=SI vous rencontrez des problèmes à vous connecter avec Pymakr via USB ALORS vérifiez si vous avez bien installé les pilotes FTDI adéquat}}
== Configuration initiale ==
== Configuration initiale ==
Après avoir installé Pymakr, vous aurez besoin de prendre quelques secondes pour le configurer la première fois.
# Connect your computer to the WiFi network named after your board (e.g. '''lopy-wlan-xxxx''', '''wipy-wlan-xxxx'''). The password is '''www.pycom.io'''
# Open Pymakr.
Suivez les étapes suivantes:
# In the menu, go to '''Settings > Preferences''' (''Pymakr > Preferences'' on macOS).
# Connectez votre ordinateur sur le réseau WiFi de votre carte Pycom. Un réseau nommé comme ceci '''lopy-wlan-xxxx''' ou '''wipy-wlan-xxxx'''.<br />Le mot de passe est '''www.pycom.io'''
# In the left list look for Pycom Device.
# Ouvrez Pymakr.
# For device, type down '''192.168.4.1'''. The default username and password are '''micro''' and '''python''', respectively.
# Dans le menu, sélectionnez '''Settings > Preferences''' (''Configuration > Préférences'').<br />Sur MacOS, se sera ''Pymakr > Preferences''.
# Click OK
# La liste sur la gauche affiche une entrée '''Pycom Device''' (''carte Pycom'').
# Pour la carte, saisissez '''192.168.4.1'''.<br />Le nom-d-utilisation et mot-de-passe par défauts (''username'' et ''password'') sont respectivement '''micro''' et '''python'''.
# Cliquer sur le bouton "OK"
{{ambox|text=Pymakr also supports wired connections. Instead of typing the IP address, you can click on the combo box arrow and select the proper serial port from the list. Our boards don’t require any username or password for the serial connection, so you can leave those fields empty.}}
{{ambox|text=Pymakr supporte également la connexion filaire. A la place de saisir une adresse IP, vous pouvez cliquer sur le bouton de la liste déroulante et sélectionner le port série dans la liste. Dans ce cas, la connexion série ne nécessite pas de nom-d-utilisateur, ni de mot-de-passe, vous pourrez laisser ces champs vides.}}
[[Fichier:Hack-pycom-esp_32-50.png|800px]]
[[Fichier:Hack-pycom-esp_32-50.png|800px]]
Cette opération de configuration ne sera nécessaire que la première fois. Dans la partie basse de l'écran, il y a une console où vous pouvez voir les informations du processus de connexion.
A la fin, vous trouverez le message "connected" (connecté) avec une invite de commande '''>>>'''.
[[Fichier:Hack-pycom-esp_32-51.png]]
[[Fichier:Hack-pycom-esp_32-51.png]]
[https://www.youtube.com/embed/bL5nn2lgaZE There is also a video] that explains these steps on macOS (it is similar for other operating systems).
[https://www.youtube.com/embed/bL5nn2lgaZE Il y a également une vidéo] qui explique les différentes étapes sur un macOS (étapes similaires aux autres systèmes d'exploitation).
== Créer un projet ==
== Créer un projet ==
Pymakr has a feature to sync and run your code on your device. This is mostly done using projects. The following steps will get you started.
Pymakr permet de synchroniser et exécuter votre code sur votre périphérique PyCom. Cela se fait en utilisant les fonctionnalités "Projet" de Pymakr.
Les étapes suivantes vous permet de commencer.
* Dans Pymakr, sélectionnez '''Project > New project''' (''Projet > Nouveau Projet'').
* Donnez lui un nom et sélectionnez un répertoire stocker y stocker les informations du projet (ou créer un nouveau répertoire).
* Créez deux fichiers: main.py et boot.py, s'il n'existent pas encore.
{{ambox|text=Vous pouvez également utiliser FTP pour télécharger, dans votre projet, les fichiers boot.py et main.py déjà présent sur la carte. Après quoi, vous utilisez le clique droit sur ces fichiers et sélectionnez l'option "add source files" (''ajouter des fichiers sources'') pour les ajouter dans votre projet.}}
Boot.py devrait toujours avoir les lignes de code suivantes en début de fichier {{fname|boot.py}}. Ces lignes permettent d'exécuter vos scripts Python via une ligne série ou telnet. Toutes les cartes récentes disposent déjà de ce code dans le fichier {{fname|boot.py}}.
<syntaxhighlight lang="python">
<syntaxhighlight lang="python">
</syntaxhighlight>
</syntaxhighlight>
La plupart des utilisateurs, principalement les utilisateurs WiPy, aurait besoin d'un script WiFi spécifique dans {{fname|boot.py}} . Des scripts de configuration WLAN basiques et plus avancées (adresse IP Fixe, réseaux multiples) sont disponible [https://docs.pycom.io/pycom_esp32/pycom_esp32/tutorial/includes/wlan.html#wlan-step-by-step dans le chapitre Wifi de Pycom.io] (''PyCom, anglais''). <font color="red">Nous avons également [[Hack-wipy-wlan|un tutoriel en Français sur le sujet]] en français</font> (également applicable à Wipy2 et Lopy même s'il s'agit d'un tutoriel WiPy 1).
Après les fichiers nécessaires (main.py et boot.py), vous pouvez créer n'importe quels répertoires, bibliothèques ou fichiers python que vous voudriez inclure dans votre fichier main.py . Pymakr synchronisera tous les fichiers du projet avec la carte lorsque le bouton "sync" ('synchronisé'') est utilisé.
{{tmbox| type = speedy |text=When synchronizing your project to the board, make sure the REPL console is ready. If any programs are running or the board is still booting, synchronization might fail.}}
{{tmbox| type = speedy |text=Avant de synchroniser votre projet vers la carte, assurez vous que la console REPL soit disponible. Si un programme/script est en cours de fonctionnement ou si la carte boot/démarre alors la synchronisation échouera.}}
== Sans créer de projet ==
== Sans créer de projet ==
Si vous voulez simplement tester du code d'un module, vous pouvez créer un nouveau fichier (ou ouvrir un fichier existant) et presser le bouton "run" (''exécuté'').
{{tmbox| type = speedy |text=The changes you make to your file won’t be automatically saved to the device on execution.}}
{{tmbox| type = speedy |text=Les changements que vous faite sur vos fichiers ne seront pas sauvés automatiquement sur le périphérique au moment de l'exécution.}}
== Un exemple simple ==
== Un exemple simple ==
Pour le fun, essayons de réaliser un feu tricolore. Ajoutez le code suivant dans le fichier {{fname|main.py}}:
<syntaxhighlight lang="python">
<syntaxhighlight lang="python">
</syntaxhighlight>
</syntaxhighlight>
* Make sure the connection to your board is open in the Pycom Console
* Assurez vous que la connexion avec la carte est active (en consultant les messahes dans la console Pycom)
* Press the sync button on the top toolbar. Any progress will be shown in the console.
* Pressez le bouton "sync" (visible dans la barre d'outil). La progression est affichée dans la console.
Voici le résultat attendu:
[[Fichier:Hack-pycom-esp_32-60.gif]]
[[Fichier:Hack-pycom-esp_32-60.gif]]
Voila, vous avez maintenant un feu tricolore entre vos mains! Pressez la combinaison de toute ctrl-c pour arrêter le script (vous pouvez également arrêter le script en faisant un clique droit dans la console et en sélectionnnant le point de menu "Reset"). Vous pouvez également pressez le bouton "Reset" présent sur la carte.
{{tmbox| type = speedy |text=Si votre carte exécute du code au moment du boot, vous pourriez avoir besoin de démarrer en "safe mode" pour désactiver ce script et reprendre la main sur votre WiPy.}}
{{LOPY-TRAILER}}
{{LOPY-TRAILER}}