MicroPython-Hack-souris - Historique des versions

Admin le 13 avril 2015 à 20:29

2015-04-13T20:29:12Z

Admin : /* Restaurer l'état normal de la PyBoard */

2015-04-13T20:28:54Z

Restaurer l'état normal de la PyBoard

Admin : /* Restaurer l'état normal de la PyBoard */

2015-04-13T19:51:39Z

Restaurer l'état normal de la PyBoard

Admin : /* Transformer l'accéléromètre en souris */

2015-04-13T19:51:29Z

Transformer l'accéléromètre en souris

Admin : /* Transformer l'accéléromètre en souris */

2015-04-13T19:51:15Z

Transformer l'accéléromètre en souris

Admin : /* Transformer l'accéléromètre en souris */

2015-04-13T19:32:35Z

Transformer l'accéléromètre en souris

Admin : /* Transformer l'accéléromètre en souris */

2015-04-10T11:09:18Z

Transformer l'accéléromètre en souris

Admin : /* Envoyer des événements souris */

2015-04-10T11:08:58Z

Envoyer des événements souris

Admin : /* Transformer votre PyBoard en souris */

2015-04-08T20:39:31Z

Transformer votre PyBoard en souris

Admin le 7 avril 2015 à 11:05

2015-04-07T11:05:27Z

@@ Ligne 1 : / Ligne 1 : @@
 {{MicroPython-Hack-Prepare-NAV}}
 == Transformer votre PyBoard en souris ==
 {{bloc-etroit|text=La carte pyboard est un périphérique USB et peut être configurée pour agir comme une souris à la place du lecteur Flash USB que vous connaissez déjà.

@@ Ligne 101 : / Ligne 101 : @@
 == Restaurer l'état normal de la PyBoard ==
-{{traduction}}
+Si vous laissez la carte PyBoard tel quelle, elle agira comme une souris à chaque fois que vous la brancherez.
-If you leave your pyboard as-is, it’ll behave as a mouse everytime you plug it in. You probably want to change it back to normal. To do this you need to first enter safe mode (see above), and then edit the boot.py file. In the {{fname|boot.py}} file, comment out (put a # in front of) the line with the {{fname|CDC+HID}} setting, so it looks like:
+Vous voudrez certainement revenir au fonctionnement normale. Pour y arriver, vous aurez d'abord besoin d'entrer en "Safe Mode" (vois ci-dessus) pour pouvoir éditer le fichier boot.py. Dans le fichier {{fname|boot.py}}, commentez la ligne (en plaçant un # en début de ligne) qui contient la configuration {{fname|CDC+HID}}. De sorte, la ligne doit ressembler à ceci:
   <nowiki>#pyb.usb_mode('CDC+HID') # act as a serial device and a mouse</nowiki>
-Save your file, eject/unmount the drive, and reset the pyboard. It is now back to normal operating mode.
+Savez votre fichier, éjectez/démontez le lecteur et réinitialisez votre carte PyBoard (en pressant le bouton reset). Elle fonctionnera maintenant en mode normal.
 {{MicroPython-Hack-Souris-TRAILER}}

← Version précédente		Version du 13 avril 2015 à 19:51
Ligne 101 :		Ligne 101 :

	== Restaurer l'état normal de la PyBoard ==		== Restaurer l'état normal de la PyBoard ==
		+	{{traduction}}
		+
	If you leave your pyboard as-is, it’ll behave as a mouse everytime you plug it in. You probably want to change it back to normal. To do this you need to first enter safe mode (see above), and then edit the boot.py file. In the {{fname\|boot.py}} file, comment out (put a # in front of) the line with the {{fname\|CDC+HID}} setting, so it looks like:		If you leave your pyboard as-is, it’ll behave as a mouse everytime you plug it in. You probably want to change it back to normal. To do this you need to first enter safe mode (see above), and then edit the boot.py file. In the {{fname\|boot.py}} file, comment out (put a # in front of) the line with the {{fname\|CDC+HID}} setting, so it looks like:

← Version précédente		Version du 13 avril 2015 à 19:51
Ligne 65 :		Ligne 65 :

	== Transformer l'accéléromètre en souris ==		== Transformer l'accéléromètre en souris ==
−	~~{{traduction}}~~
−
	Maintenant, faisons bouger la souris en fonction de l'angle de la carte PyBoard, ceci est rendu possible grâce à l'accéléromètre. Le code suivant peut être tapé directement sur sur l'invite de commande REPL ou placé dans le fichier {{fname\|main.py}}. Ici, nous le plaçons dans {{fname\|main.py}} parce que nous allons également apprendre comment passer en "Safe Mode".		Maintenant, faisons bouger la souris en fonction de l'angle de la carte PyBoard, ceci est rendu possible grâce à l'accéléromètre. Le code suivant peut être tapé directement sur sur l'invite de commande REPL ou placé dans le fichier {{fname\|main.py}}. Ici, nous le plaçons dans {{fname\|main.py}} parce que nous allons également apprendre comment passer en "Safe Mode".

@@ Ligne 73 : / Ligne 73 : @@
 De même vous ne pouvez pas modifier votre fichier {{fname|boot.py}} pour sortir du mode HID et revenir au mode normal (lecteur USB)...
-Pour y arriver, vous avez besoin de passer en "Safe Mode". Cela est décrit en détail dans le tutoriel sur le Safe-Mode mais vous pouvez répéter les opérations ci-dessous:
+Pour y arriver, vous avez besoin de passer en "Safe Mode". Cela est décrit en détail dans le [[MicroPython-Hack-safemode|tutoriel sur le Safe-Mode]] mais vous pouvez répéter les opérations ci-dessous:
-In safe mode, the {{fname|boot.py}} and {{fname|main.py}} files are not executed, and so the pyboard boots up with default settings. This means you now have access to the filesystem (the USB drive should appear), and you can edit {{fname|main.py}}. (Leave {{fname|boot.py}} as-is, because we still want to go back to HID-mode after we finish editting {{fname|main.py}}.)
+# Maintenez le bouton USR enfoncé.
-In {{fname|main.py}} put the following code:
+En "Safe Mode", les fichiers {{fname|boot.py}} et {{fname|main.py}} ne sont pas exécutés et la carte PyBoard démarre avec ses paramètres par défaut. Cela signifie que, maintenant, vous pouvez accéder au système de fichier (le lecteur USB devrait apparaître).
   <nowiki>import pyb
@@ Ligne 95 : / Ligne 96 : @@
      pyb.delay(20)</nowiki>
-Save your file, eject/unmount your pyboard drive, and reset it using the RST switch. It should now act as a mouse, and the angle of the board will move the mouse around. Try it out, and see if you can make the mouse stand still!
+Sauvez votre fichier, éjectez/démontez le lecteur de la carte PyBoard puis réinitialisez votre carte avec le bouton RST. La carte devrait maintenant agir comme une souris et l'angle de la carte bougera la souris. Essayez ce programme et voyez comment vous pouvez immobiliser la souris!
-Press the USR switch to stop the mouse motion.
+Pressez le bouton '''USR''' pour arrêter les déplacements de la souris.
-You’ll note that the y-axis is inverted. That’s easy to fix: just put a minus sign in front of the y-coordinate in the {{fname|pyb.hid()}} line above.
+Vous remarquerez que l'axe-Y est inversé. C'est vraiment facile à corrigé: placez juste un signe moins devant la coordonnée-y de la ligne {{fname|pyb.hid()}} (ci dessus).
 == Restaurer l'état normal de la PyBoard ==

@@ Ligne 67 : / Ligne 67 : @@
 {{traduction}}
-Now lets make the mouse move based on the angle of the pyboard, using the accelerometer. The following code can be typed directly at the REPL prompt, or put in the {{fname|main.py}} file. Here, we’ll put in in {{fname|main.py}} because to do that we will learn how to go into safe mode.
+Maintenant, faisons bouger la souris en fonction de l'angle de la carte PyBoard, ceci est rendu possible grâce à l'accéléromètre. Le code suivant peut être tapé directement sur sur l'invite de commande REPL ou placé dans le fichier {{fname|main.py}}. Ici, nous le plaçons dans {{fname|main.py}} parce que nous allons également apprendre comment passer en "Safe Mode".
-At the moment the pyboard is acting as a serial USB device and an HID (a mouse). So you cannot access the filesystem to edit your {{fname|main.py}} file.
+Pour le moment, la carte PyBoard agit comme un périphérique USB série et un périphérique HID (une souris). Par conséquent, cela empêche d'accéder au système de fichier pour éditer le fichier {{fname|main.py}}.
-You also can’t edit your {{fname|boot.py}} to get out of HID-mode and back to normal mode with a USB drive...
+De même vous ne pouvez pas modifier votre fichier {{fname|boot.py}} pour sortir du mode HID et revenir au mode normal (lecteur USB)...
 # Hold down the USR switch.
 # While still holding down USR, press and release the RST switch.

← Version précédente		Version du 10 avril 2015 à 11:09
Ligne 65 :		Ligne 65 :

	== Transformer l'accéléromètre en souris ==		== Transformer l'accéléromètre en souris ==
		+	{{traduction}}
		+
	Now lets make the mouse move based on the angle of the pyboard, using the accelerometer. The following code can be typed directly at the REPL prompt, or put in the {{fname\|main.py}} file. Here, we’ll put in in {{fname\|main.py}} because to do that we will learn how to go into safe mode.		Now lets make the mouse move based on the angle of the pyboard, using the accelerometer. The following code can be typed directly at the REPL prompt, or put in the {{fname\|main.py}} file. Here, we’ll put in in {{fname\|main.py}} because to do that we will learn how to go into safe mode.

@@ Ligne 41 : / Ligne 41 : @@
 == Envoyer des événements souris ==
-To get the py-mouse to do anything we need to send mouse events to the PC. We will first do this manually using the REPL prompt. Connect to your pyboard using your serial program and type the following:
+Pour que notre souris-python fasse des choses, il faut que le programme envoie des événements souris à notre PC. Pour commencer, nous allons faire cela manuellement avec une invite de commande REPL (''voyez les précédents tutoriels''). Connectez-vous sur votre PyBoard à l'aide de votre logiciel terminal favoris et tapez la commande suivante:
   <nowiki>>>> pyb.hid((0, 10, 0, 0))</nowiki>
-Your mouse should move 10 pixels to the right! In the command above you are sending 4 pieces of information: button status, x, y and scroll. The number 10 is telling the PC that the mouse moved 10 pixels in the x direction.
+Votre souris devrait se déplacer de 10 pixels sur la droite!
-Let’s make the mouse oscillate left and right:
+La commande ci-dessus envoi 4 informations: l'état du bouton, x, y et défilement (''scroll'' en anglais). Le numéro 10 indique à notre ordinateur qu'il y a un déplacement de 10 pixels (10 points) dans la direction x.
   <nowiki>>>> import math
@@ Ligne 57 : / Ligne 59 : @@
 >>> osc(100, 50)</nowiki>
-The first argument to the function {{fname|osc}} is the number of mouse events to send, and the second argument is the delay (in milliseconds) between events. Try playing around with different numbers.
+Le premier argument de la fonction {{fname|osc}} est le nombre d'événement souris à envoyer. Le second argument est le délais (en millisecondse) entre les événements. Testez la fonction avec différentes valeurs numériques.
 === Exercice ===
-Make the mouse go around in a circle.
+Une petit exercice amusant est de faire dessiner un cercle à la souris.
 == Transformer l'accéléromètre en souris ==

@@ Ligne 3 : / Ligne 3 : @@
 {{Traduction}}
 == Transformer votre PyBoard en souris ==
-{{bloc-etroit|text=The pyboard is a USB device, and can configured to act as a mouse instead of the default USB flash drive.
+{{bloc-etroit|text=La carte pyboard est un périphérique USB et peut être configurée pour agir comme une souris à la place du lecteur Flash USB que vous connaissez déjà.
-To do this we must first edit the {{fname|boot.py}} file to change the USB configuration. If you have not yet touched your {{fname|boot.py}} file then it will look something like this:}}
+Pour transformer votre PyBoard en périphérique souris, vous devez d'abord editer le fichier {{fname|boot.py}} et y changer la configuration USB. Si vous n'avez pas encore modifié votre fichier {{fname|boot.py}} il devrait ressembler à quelque-chose comme ceci:}}
   <nowiki># boot.py -- run on boot-up
@@ Ligne 15 : / Ligne 15 : @@
 #pyb.usb_mode('CDC+HID') # act as a serial device and a mouse</nowiki>
-{{bloc-etroit|text=To enable the mouse mode, uncomment the last line of the file, to make it look like:}}
+{{bloc-etroit|text=Vous trouverez ci-dessous une version du même fichier avec une traduction des commentaire pour vous aider à en comprendre le contenu.}}
   <nowiki>pyb.usb_mode('CDC+HID') # act as a serial device and a mouse</nowiki>
-{{bloc-etroit|text=If you already changed your {{fname|boot.py}} file, then the minimum code it needs to work is:}}
+{{bloc-etroit|text=Si vous avez déjà modifié votre fichier {{fname|boot.py}} alors le code minimum pour fonctionner est celui-ci:}}
   <nowiki>import pyb
 pyb.usb_mode('CDC+HID')</nowiki>
-This tells the pyboard to configure itself as a CDC (serial) and HID (human interface device, in our case a mouse) USB device when it boots up.
+Cela informe le pyboard de se configurer son USB comme un CDC (port série) et HID (interface Homme-Machine dite "''human interface device''", dans notre cas, c'est une souris) au moment du boot.
-Eject/unmount the pyboard drive and reset it using the RST switch. Your PC should now detect the pyboard as a mouse!
+Ejectez/démonter le lecteur USB/Flash de votre carte Pyboard et réinitialisez votre carte en pressant le bouton RST. Votre PC détectera maintenant puboard comme une souris!
 == Envoyer des événements souris ==

← Version précédente		Version du 7 avril 2015 à 11:05
Ligne 2 :		Ligne 2 :

	{{Traduction}}		{{Traduction}}
		+	== Transformer votre PyBoard en souris ==
		+	{{bloc-etroit\|text=The pyboard is a USB device, and can configured to act as a mouse instead of the default USB flash drive.

		+	To do this we must first edit the {{fname\|boot.py}} file to change the USB configuration. If you have not yet touched your {{fname\|boot.py}} file then it will look something like this:}}
		+
		+	<nowiki># boot.py -- run on boot-up
		+	# can run arbitrary Python, but best to keep it minimal
		+
		+	import pyb
		+	#pyb.main('main.py') # main script to run after this one
		+	#pyb.usb_mode('CDC+MSC') # act as a serial and a storage device
		+	#pyb.usb_mode('CDC+HID') # act as a serial device and a mouse</nowiki>
		+
		+	{{bloc-etroit\|text=To enable the mouse mode, uncomment the last line of the file, to make it look like:}}
		+
		+	<nowiki>pyb.usb_mode('CDC+HID') # act as a serial device and a mouse</nowiki>
		+
		+	{{bloc-etroit\|text=If you already changed your {{fname\|boot.py}} file, then the minimum code it needs to work is:}}
		+
		+	<nowiki>import pyb
		+	pyb.usb_mode('CDC+HID')</nowiki>
		+
		+	This tells the pyboard to configure itself as a CDC (serial) and HID (human interface device, in our case a mouse) USB device when it boots up.
		+
		+	Eject/unmount the pyboard drive and reset it using the RST switch. Your PC should now detect the pyboard as a mouse!
		+
		+	== Envoyer des événements souris ==
		+	To get the py-mouse to do anything we need to send mouse events to the PC. We will first do this manually using the REPL prompt. Connect to your pyboard using your serial program and type the following:
		+
		+	<nowiki>>>> pyb.hid((0, 10, 0, 0))</nowiki>
		+
		+	Your mouse should move 10 pixels to the right! In the command above you are sending 4 pieces of information: button status, x, y and scroll. The number 10 is telling the PC that the mouse moved 10 pixels in the x direction.
		+
		+	Let’s make the mouse oscillate left and right:
		+
		+	<nowiki>>>> import math
		+	>>> def osc(n, d):
		+	... for i in range(n):
		+	... pyb.hid((0, int(20 * math.sin(i / 10)), 0, 0))
		+	... pyb.delay(d)
		+	...
		+	>>> osc(100, 50)</nowiki>
		+
		+	The first argument to the function {{fname\|osc}} is the number of mouse events to send, and the second argument is the delay (in milliseconds) between events. Try playing around with different numbers.
		+
		+	=== Exercice ===
		+	Make the mouse go around in a circle.
		+
		+	== Transformer l'accéléromètre en souris ==
		+	Now lets make the mouse move based on the angle of the pyboard, using the accelerometer. The following code can be typed directly at the REPL prompt, or put in the {{fname\|main.py}} file. Here, we’ll put in in {{fname\|main.py}} because to do that we will learn how to go into safe mode.
		+
		+	At the moment the pyboard is acting as a serial USB device and an HID (a mouse). So you cannot access the filesystem to edit your {{fname\|main.py}} file.
		+
		+	You also can’t edit your {{fname\|boot.py}} to get out of HID-mode and back to normal mode with a USB drive...
		+
		+	To get around this we need to go into safe mode. This was described in the [safe mode tutorial](tut-reset), but we repeat the instructions here:
		+
		+	# Hold down the USR switch.
		+	# While still holding down USR, press and release the RST switch.
		+	# The LEDs will then cycle green to orange to green+orange and back again.
		+	# Keep holding down USR until only the orange LED is lit, and then let go of the USR switch.
		+	# The orange LED should flash quickly 4 times, and then turn off.
		+	# You are now in safe mode.
		+
		+	In safe mode, the {{fname\|boot.py}} and {{fname\|main.py}} files are not executed, and so the pyboard boots up with default settings. This means you now have access to the filesystem (the USB drive should appear), and you can edit {{fname\|main.py}}. (Leave {{fname\|boot.py}} as-is, because we still want to go back to HID-mode after we finish editting {{fname\|main.py}}.)
		+
		+	In {{fname\|main.py}} put the following code:
		+
		+	<nowiki>import pyb
		+
		+	switch = pyb.Switch()
		+	accel = pyb.Accel()
		+
		+	while not switch():
		+	pyb.hid((0, accel.x(), accel.y(), 0))
		+	pyb.delay(20)</nowiki>
		+
		+	Save your file, eject/unmount your pyboard drive, and reset it using the RST switch. It should now act as a mouse, and the angle of the board will move the mouse around. Try it out, and see if you can make the mouse stand still!
		+
		+	Press the USR switch to stop the mouse motion.
		+
		+	You’ll note that the y-axis is inverted. That’s easy to fix: just put a minus sign in front of the y-coordinate in the {{fname\|pyb.hid()}} line above.
		+
		+	== Restaurer l'état normal de la PyBoard ==
		+	If you leave your pyboard as-is, it’ll behave as a mouse everytime you plug it in. You probably want to change it back to normal. To do this you need to first enter safe mode (see above), and then edit the boot.py file. In the {{fname\|boot.py}} file, comment out (put a # in front of) the line with the {{fname\|CDC+HID}} setting, so it looks like:
		+
		+	<nowiki>#pyb.usb_mode('CDC+HID') # act as a serial device and a mouse</nowiki>
		+
		+	Save your file, eject/unmount the drive, and reset the pyboard. It is now back to normal operating mode.

	{{MicroPython-Hack-Souris-TRAILER}}		{{MicroPython-Hack-Souris-TRAILER}}