Piobot
Déclarer l'instance
Si tu ajoutes un bloc de Piobot à la zone de travail, la déclaration d'instance suivante est insérée automatiquement dans le code Python :
pio = Pio(0)
# s'il y a plusieurs instances
pio_1 = Pio(1)Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| index | Option de liste | Numéro de l'instance (commence à 0) | entier supérieur ou égal à 0 | 0 |
Régler la vitesse de la roue
Règle la vitesse des roues. La plage de la vitesse des roues est -100 ~ 100.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Roue | gauche(left), droite(right), les deux(both) | - |
| speed | Entrée (bloc) | Vitesse de la roue | entier -100 ~ 100, 0 : arrêt | - |
Python
pio = Pio(0)
pio.set_wheel_speed('both', 50)Avancer d'une distance
Se déplace de la distance indiquée à la vitesse actuelle des roues.
Si tu n'as pas réglé la vitesse des roues, il avance à la vitesse par défaut.
Si la valeur de la distance est 0, il continue à se déplacer selon la vitesse actuelle des roues.
Si tu coches la case attendre, il attend que le déplacement soit terminé.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| data | Entrée (bloc) | Distance du déplacement | décimal supérieur ou égal à 0 | - |
| unit | Option de liste | Unité de la distance | cm, mm, pouces(inch) | cm |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
pio = Pio(0)
pio.move_distance(50, 'cm', wait=True)Avancer un temps
Se déplace pendant le temps indiqué à la vitesse actuelle des roues.
Si tu n'as pas réglé la vitesse des roues, il avance à la vitesse par défaut.
Si tu coches la case attendre, il attend que le déplacement soit terminé.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| data | Entrée (bloc) | Temps du déplacement (secondes) | décimal supérieur ou égal à 0 | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
pio = Pio(0)
# wait = TRUE
pio.move_time(5, wait=True)
# wait = FALSE
pio.move_time(5, wait=False)Tourner sur place
Règle la direction et l'angle de la rotation sur place.
Si tu coches la case attendre, il attend que la rotation soit terminée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| direction | Option de liste | Direction de la rotation | gauche(left), droite(right) | - |
| data | Entrée (bloc) | Angle de la rotation (degrés) | décimal supérieur ou égal à 0 | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
pio = Pio(0)
# direction = "left"
pio.turn_degree('left', 90, wait=True)
# direction = "right"
pio.turn_degree('right', 90, wait=True)Modifier la vitesse de la roue
Modifie la vitesse des roues de Piobot.
La nouvelle vitesse est la vitesse actuelle plus la vitesse que tu as saisie.
La vitesse des roues qui vient d'être réglée est limitée à la plage -100 ~ 100.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Roue | gauche(left), droite(right), les deux(both) | - |
| speed | Entrée (bloc) | Écart de vitesse à appliquer | entier -200 ~ 200 | - |
Python
pio = Pio(0)
pio.change_wheel_speed('both', 50)Activer / désactiver le mode turbo
Active ou désactive le mode turbo de Piobot.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Mode turbo ON / OFF | allumer(on=True), éteindre(off=False) | TRUE |
Python
pio = Pio(0)
pio.turbo(True)Arrêter
Arrête le déplacement de Piobot.
Les vitesses des deux roues de Piobot sont remises à 0.
Paramètres
(aucun)
Python
pio = Pio(0)
pio.stop()La roue est-elle en mouvement ?
Renvoie true si les roues sont en mouvement et false si elles sont arrêtées.
Paramètres
(aucun)
Python
pio = Pio(0)
pio.wheel_moving()Se déplacer d'une case sur le plateau
Sur le plateau il se déplace d'une case à la fois, comme prévu.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Direction du déplacement | avant(forward), arrière(backward), à gauche(left), à droite(right) | - |
Python
pio = Pio(0)
pio.grid_move('forward')Tourner une fois sur le plateau
Sur le plateau Piobot tourne de 90 degrés dans la direction reçue en entrée. Il attend toujours la fin (en interne wait=True est fixé).
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Direction de la rotation | gauche(left), droite(right) | - |
Python
pio = Pio(0)
# unit = "left"
pio.grid_turn('left')
# unit = "right"
pio.grid_turn('right')Régler la vitesse du cou
Règle la vitesse de rotation du cou. La plage de la vitesse du cou est 1 ~ 6.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| data | Entrée (bloc) | Vitesse de rotation du cou | entier 1 ~ 6 | 4 |
Python
pio = Pio(0)
pio.set_neck_speed(4)Régler l'angle du cou
Règle l'angle que le cou atteint en tournant. La plage de l'angle du cou est -45 ~ 45.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| data | Entrée (bloc) | Angle du cou (degrés) | décimal -45 ~ 45 | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
pio = Pio(0)
pio.set_neck_angle(15, wait=True)Le cou est-il en mouvement ?
Renvoie true si le cou est en mouvement et false s'il est arrêté.
Paramètres
(aucun)
Python
pio = Pio(0)
pio.neck_moving()Régler la couleur de la LED de l'œil
Règle la couleur de la LED des yeux de Piobot.
Tu peux changer la couleur de la LED de l'œil gauche, de l'œil droit ou des deux.
Si tu choisis une couleur parmi les couleurs prédéfinies, elle est convertie en nom de couleur (texte en anglais) et appelée ainsi. (le code est généré avec le nom de la couleur, pas avec les valeurs numériques R, G, B.)
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Œil à commander | gauche(left), droite(right), les deux(both) | - |
| color | Option de liste | Couleur prédéfinie → convertie en nom de couleur (en anglais) | noir(black), rouge(red), jaune(yellow), vert(green), cyan(cyan), bleu(blue), magenta(magenta), blanc(white) | - |
Python
pio = Pio(0)
pio.set_eye_color('both', 'red')Régler la couleur de la LED de l'œil avec un bloc de la catégorie Couleur
Règle la couleur de la LED des yeux de Piobot avec les blocs de la catégorie Couleur.
Tu peux changer la couleur de la LED de l'œil gauche, de l'œil droit ou des deux.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Œil à commander | gauche(left), droite(right), les deux(both) | - |
| data | Entrée (couleur) | Tableau [R, G, B] | Bloc de la catégorie Couleur ou [0~255, 0~255, 0~255] | - |
Python
pio = Pio(0)
pio.set_eye_color('both', *Utils.color('red'))Changer la couleur de la LED de l'œil d'une valeur RGB
Change la couleur de la LED des yeux de Piobot des valeurs R, G, B indiquées.
Tu peux régler la couleur de l'œil gauche, de l'œil droit ou des deux.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Œil à commander | gauche(left), droite(right), les deux(both) | - |
| r | Entrée (champ) | Variation du rouge | entier -255 ~ 255 | 0 |
| g | Entrée (champ) | Variation du vert | entier -255 ~ 255 | 0 |
| b | Entrée (champ) | Variation du bleu | entier -255 ~ 255 | 0 |
Python
pio = Pio(0)
pio.change_eye_color('both', 10, 0, 0)Définir le motif des LED des yeux
Définit le motif des yeux et indique la couleur de chaque œil au début du motif.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| pattern | Option de liste | Type de motif | éteindre(reset), clignoter(blink), fondu(dimming), arc-en-ciel(rainbow) | - |
| left | Option de liste | Couleur de l'œil gauche | par défaut(black), rouge(red), jaune(yellow), vert(green), cyan(cyan), bleu(blue), magenta(magenta), blanc(white) | white |
| right | Option de liste | Couleur de l'œil droit | (comme left) | white |
Python
pio = Pio(0)
pio.set_eye_pattern('dimming', 'green', 'red')Éteindre la LED de l'œil
Enlève la couleur des yeux.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Œil à commander | gauche(left), droite(right), les deux(both) | both |
Python
pio = Pio(0)
pio.turn_off('both')Régler le bourdonnement
Règle le bourdonnement de Piobot à la fréquence indiquée.
La plage des fréquences que l'on peut émettre est 27,5 Hz ~ 6553,5 Hz.
Si tu saisis une valeur hors de cette plage, le buzzer n'émet aucun son.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| hz | Entrée (bloc) | Fréquence (Hz) | décimal 27,5 ~ 6553,5 | - |
Python
pio = Pio(0)
pio.sound_buzz(440)Jouer la note de son
Piobot joue la note indiquée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| note | Option de liste | Note | Do(C), Do#/Ré♭(C#), Ré(D), Ré#/Mi♭(D#), Mi(E), Fa(F), Fa#/Sol♭(F#), Sol(G), Sol#/La♭(G#), La(A), La#/Si♭(A#), Si(B) | - |
| octave | Option de liste | Octave | 1, 2, 3, 4, 5, 6, 7 | 4 |
Python
pio = Pio(0)
pio.sound_note('D', 5)Jouer un extrait sonore
Piobot joue un extrait sonore donné.
Si tu coches la case attendre, il attend que la lecture soit terminée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| clip | Option de liste | Nom de l'extrait sonore | 'mute', 'beep', 'beep2', 'beep3', 'siren', 'engine', 'robot', 'connect' et d'autres | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
pio = Pio(0)
pio.sound_clip('siren', wait=True)Jouer une mélodie
Piobot joue une mélodie donnée.
Si tu coches la case attendre, il attend que la lecture soit terminée.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| melody | Option de liste | Nom de la mélodie | 'mute', 'happy', 'angry', 'sad', 'sleep', 'march', 'birthday', 'dibidibidip', 'good_job' et d'autres | - |
| wait | Case à cocher | S'il faut attendre la fin | TRUE / FALSE | TRUE |
Python
pio = Pio(0)
pio.sound_melody('happy', wait=True)Désactiver le son
Éteint le son de Piobot.
Paramètres
(aucun)
Python
pio = Pio(0)
pio.sound_off()Le son est-il en cours de lecture ?
Renvoie true si le son est en cours de lecture et false sinon.
Paramètres
(aucun)
Python
pio = Pio(0)
pio.sound_playing()Valeur de la vitesse de la roue
La vitesse d'une roue donnée
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| unit | Option de liste | Roue à lire | gauche(left), droite(right) | - |
Python
pio = Pio(0)
pio.wheel_speed('left')Valeur de la force du signal
La force du signal
Paramètres
(aucun)
Python
pio = Pio(0)
pio.signal_strength()Tension de la batterie
La tension de la batterie
Paramètres
(aucun)
Python
pio = Pio(0)
pio.battery()Bouton du clavier
Détecte le dernier bouton du clavier pressé par l'utilisateur.
Paramètres
| Nom | Type | Description | Plage / Type | Valeur par défaut |
|---|---|---|---|---|
| button | Option de liste | Bouton à détecter | exécuter(play), avancer(forward), reculer(backward), aller à gauche(left), aller à droite(right), action(action), répéter(repeat), effacer(clear) | - |
Python
pio = Pio(0)
pio.keypad('forward')