Modifications

{{LOPY-NAV}}

{{LOPY-NAV}}

= Un guide de démarrage rapide =

= Un guide de démarrage rapide =

== 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.

* 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.}}

* Créez deux fichiers: main.py et boot.py, s'il n'existent pas encore.

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.

{{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>

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).

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).

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.

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 ==

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.

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 ==

For fun, lets try again to build a traffic light. Add the following code to the main.py file:

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.

Here is the expected result:

Voici le résultat attendu:

[[Fichier:Hack-pycom-esp_32-60.gif]]

[[Fichier:Hack-pycom-esp_32-60.gif]]

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.

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=If your board is running code at boot time, you might need to boot it in safe mode.}}

{{LOPY-TRAILER}}

{{LOPY-TRAILER}}