Outils pour utilisateurs

Outils du site


documentation:reference_blocky_rduino

Guide de référence de blockly@rduino ( version TZ51 )

Blocs disponibles dans la version TZ51 de Blockly@rduino

Les blocs relatifs au matériel Technozone51 sont rangés dans des catégories comme illustré sur l'image ci-dessous :

Les blocs de la catégorie "Logique"


  • Bloc 'instruction conditionnelle' qui exécute les instructions contenues dans le bloc si la condition logique testée est vrai. Cliquez sur l'étoile pour ajouter au bloc un nouveau connecteur 'sinon' ou 'sinon si'.

  • Opérateur logique de comparaison de deux valeurs numérique ou textuelle renvoyant une condition logique vrai ou faux

  • Opérateur logique de combinaison booléenne de deux conditions logiques renvoyant une condition vrai ou faux

  • Bloc de négation logique renvoyant une condition vrai ou faux.

  • Bloc de condition logique vrai ou faux

  • Bloc 'null'.

Les blocs de la catégorie "Boucles/Pause"


  • Bloc Pause pour suspendre l'exécution du programme durant une durée définie en millisecondes.

  • Bloc de répétition permettant de répéter un ensemble d'instructions un certain nombre de fois.

  • Bloc de répétition permettant de répéter un ensemble d'instructions un certain nombre de fois.

  • Bloc Boucle Principale. Répète indéfiniment les instructions contenu à l'intérieur.

  • Bloc de répétition sous condition. Le contenu du bloc est répété 'tant que' ou 'jusqu'à' ce qu'une condition logique soit testée comme vrai.

  • Bloc de répétition avec comptage permet de répéter un ensemble d'instructions un certain nombre de fois tout en incrémentant une variable compteur à chaque itération dans la boucle.

  • Bloc d'intéruction de boucle qui permet de sortir d'une boucle avant sa fin normale. Ce bloc ne doit être utilisé qu'à l'intérieur d'un bloc de répétition.

  • Bloc fin de programme qui interrompt l'exécution du programme de manière définitive. Un reset de la carte arduino est nécessaire pour relancer l'exécution du programme depuis le début.

Les blocs de la catégorie "Variables/conversions"


  • Déclaration d'une variable et de son type ( Entier, Entier long, Octet , Nombre décimal, Texte, Booléen ). Cliquez sur le nom de la variable pour le changer ou en créer une nouvelle.

  • Fixe la valeur d'une variable.

  • Renvoie la valeur d'une variable

  • Effectue la convertion d'une valeur dans le type 'caractêre'

  • Effectue la convertion d'une valeur dans le type 'octet'

  • Effectue la convertion d'une valeur dans le type 'entier'

  • Effectue la convertion d'une valeur dans le type 'entier long'

  • Effectue la convertion d'une valeur dans le type 'nombre décimal'

Les blocs de la catégorie "Fonctions"


  • Déclaration d'une procédure. Permet de regrouper un ensemble d'instruction dans une procédure que l'on peut 'appeler' plusieurs fois et exécuter ultérieurement. Cliquer sur le nom de la procédure pour le changer ou pour en créer une nouvelle.

  • Déclaration d'une fonction qui renvoir en retour une valeur. Permet de regrouper un ensemble d'instruction dans une fonction que l'on peut 'appeler' plusieurs fois et exécuter ultérieurement. Cliquer sur le nom de la fonction pour le changer ou pour en créer une nouvelle.

  • Ce bloc permet d'interrompre l'exécution d'une procédure ou d'une fonction et de revenir à l'instruction principale du programme si une condition logique est testée comme vrai. Ce bloc ne doit être utilisé que dans une procédure ou une fonction.

  • Ce bloc appelle une procédure pour exécuter les instructions contenues à l'intérieur de celle-ci. Une fois la procédure entièrement exécuté, l'exécution du programme reprends à la suite de ce bloc.

  • Ce bloc appelle une fonction pour exécuter les instructions contenues à l'intérieur de celle-ci et renvoie la valeur de retour de cette fonction. Une fois la function entièrement exécuté, l'exécution du programme reprends à la suite de ce bloc.

Les blocs de la catégorie "Maths"


  • Bloc nombre

  • Renvoie le résultat d'une Opérations arithmétiques de base ( addition, soustraction, multiplication, division, exposant ) entre deux valeurs numérique

  • Renvoie la racine carré, la valeur absolue ou l'opposé d'une valeur

  • Renvoie le résultat d'une fonction trigonométrique appliquée à une valeur

  • Effectue un test ( pair , impaire, premier, entier, négatif, positif, divisible par un nombre ) sur une valeur numérique et renvoie la condition logique vrai ou faux

  • Incrémente une variable d'un certain nombre. Pour décrémenter la variable d'un certain nombre il suffit d'incrémenter par une valeur négative.

  • Renvoie la valeur arrondi d'une valeur numérique

  • Renvoie le reste de la division d'un nombre par un autre

  • Renvoie une valeur contrainte entre une limite basse et une limite haute

  • Renvoie un nombre entier aléatoire comprise entres deux limites incluses

  • Renvoie un nombre décimal aléatoire entre 0(inclus) et 1(exclus)

Les blocs de la catégorie "Texte"


  • Bloc texte

  • Concatène des morceaux de texte ou des valeurs numériques et renvoie un texte. On peut ajouter d'autres connecteurs en cliquant sur l'étoile.

  • Ajoute un texte à une variable texte

  • Renvoie la longueur d'un texte

  • Renvoie Vrai si le texte est vide, faux sinon

  • Extraire une des partie d'un texte formaté CSV avec un séparateur au choix

Les blocs de la catégorie "Capteurs"


  • Teste si un bouton blanc connecté à la broche spécifiée a été appuyée.

  • Teste si un bouton noir connecté à la broche spécifiée a été appuyée.

  • Teste si un bouton vert connecté à la broche spécifiée a été appuyée.

  • Teste si un bouton rouge connecté à la broche spécifiée a été appuyée.

  • Teste si le fin de course connecté à la broche spécifiée a été appuyée.

  • Teste si le capteur ILS connecté à la broche spécifiée détecte un champ magnétique

  • Teste si le capteur de proximité connecté à la broche spécifiée détecte un obstacle

  • Teste si la barrière infrarouge connectée à la broche spécifiée détecte un obstacle

  • Teste si le capteur de ligne connecté à la broche spécifiée détecte une ligne

  • Teste si le capteur de mouvement connecté à la broche spécifiée détecte une présence

  • Lit la position du potentiomètre connecté à la broche analogique spécifiée. Renvoie une valeur entre 0 et 1023.

  • Lit la température en °C sur la CTN connectée à la broche analogique spécifiée

  • Lit la luminosité en Lux sur la cellule LDR connectée à la broche analogique spécifiée

  • Lit la distance en cm mesuré par le sonar connecté aux broches TRIG et DIST spécifiées

  • Provoque la lecture de la température sur un capteur DS18B20 connecté à la broche spécifiée. Ce bloc ne renvoie pas le résultat de la lecture. Utilisez le bloc suivant pour obtenir le résultat de la mesure.

  • Renvoie la température lu avec le bloc précédent en centième de degré. Par exemple une valeur de 2045 correspond à une température de 20,45 °C. Il faut a nouveau préciser sur quel broche le capteur DS18B20 est connecté.

  • Ce bloc d'initialisation d'un capteur de température et d'humidité DHT22/DHT11 est à mettre avant la boucle principale de votre programme. Ce bloc est nécessaire pour utilisez les deux blocs suivants.

  • Lit la température en centième de °C sur le capteur DHT22 connecté à la broche spécifiée

  • Lit le taux d'humidité en % sur le capteur DHT22 connecté à la broche spécifiée

  • Initialise le capteur BME280 connecté au bus I2C

  • Provoque une lecture de la températute/humidité/pression sur un BME280 connecté au bus I2C. Utilisez les trois blocs suivants pour accéder aux mesures.

  • Lit la température en °C

  • Lit l'humidité en %

  • Lit la pression en Pascal (Pa)

Les blocs de la catégorie "Actionneurs"


  • Allume ou éteint la led rouge connectée à la broche spécifiée

  • Allume ou éteint la led verte connectée à la broche spécifiée

  • Allume ou éteint la led jaune connectée à la broche spécifiée

  • Allume ou éteint la led blanche connectée à la broche spécifiée

  • Active ou désactive le relais connecté à la broche spécifiée

  • Commande la puissance du module MOSFET connecté à la broche PWM spécifiée

  • Joue une note de musique sur le buzzer connecté à la broche spécifiée. On peut choisir la hauteur de la note a jouer ( en Hertz ) ainsi que sa durée ( en ms ).

Les blocs de la catégorie "Moteurs CC"


  • Commande le moteur A ou B connecté à la carte EASYCON1 équipée de l'option MOT1. Choisir le sens de rotation et la vitesse du moteur comprise entre 0 (arrêt) et 255 (pleine vitesse)

  • Commande le moteur A ou B connecté à la carte EASYBOT1 équipée de l'option MOT1. Choisir le sens de rotation et la vitesse du moteur comprise entre 0 (arrêt) et 255 (pleine vitesse)

  • Commande le moteur connecté à la carte MOT2. Choisir le sens de rotation et la vitesse du moteur comprise entre 0 (arrêt) et 255 (pleine vitesse). Spécifiez les broche DIR et PWM utilisées

Les blocs de la catégorie "Moteur PAP"


  • Bloc d'initialisation de la carte PAP1 de commande de deux moteurs pas à pas connecté à la carte EASYBOT1 ou EASYCON2.

  • Commande le moteur A ou B connecté à la carte PAP1 en mode rotation continue. Choisir le sens de rotation et la vitesse du moteur comprise entre 0 (arrêt) et 255 (pleine vitesse)

  • Commande le moteur connecté à la carte PAP1 en mode relatif. Choisir le sens de rotation , la vitesse du moteur comprise entre 0 (arrêt) et 255 (pleine vitesse) et le nombre de pas à réalisé.

  • Utilisé avec le bloc précédent, ce test permet de savoir si les moteurs sont encore en rotation ou non : cela permet de détecter si tous les pas moteur en mode relatif ont été réalisés.

Les blocs de la catégorie "Servo-moteurs"


  • Commande la position entre 0° et 180° d'un servo-moteur connecté à la broche spécifiée. Utilise la librairie standard d'Arduino qui n'est pas compatible avec l'utilisation des blocs de la catégorie Wifi ou Bluetooth car utlisant le même timer TIMER1 !

  • Commande la position entre 0° et 180° d'un servo-moteur connecté à la broche spécifiée. Utilise une librairie particulière s'appuyant sur le TIMER2 et qui rend ce bloc compatible avec une utilisation simultanée des blocs des catégories Wifi et Bluetooth.

  • Renvoie la position du servo-moteur connecté à la broche spécifiée

Les blocs de la catégorie "Ecran LCD"


  • Ce bloc d'initialisation d'un écran LCD LCD1 à interface I2C est à mettre avant la boucle principale de votre programme. Ce bloc est nécessaire pour utilisez les trois blocs suivants. Spécifiez l'adresse I2C de votre écran LCD ainsi que ses caractéristiques. L'écran se connecte à la broche I2C d'une carte EASYBOT1 ou EASYCON2

  • Permet de contrôler les fonctions spéciales de l'afficheur LCD ( Rétro-éclairage, curseur, clignotement du curseur … )

  • Efface l'écran LCD

  • Ecrit un texte sur l'écran LCD à la position spécifiée

Les blocs de la catégorie "Télécommande"


  • Ce bloc d'initialisation d'une télécommande infrarouge est à mettre avant la boucle principale de votre programme. Ce bloc est nécessaire pour utiliser les trois blocs suivants. Spécifiez la broche sur laquelle est connecté votre capteur infrarouge

  • Vide le tampon de la télécommande. Utilisez ce bloc après avoir testé si une touche a été appuyé et après avoir testé le code des touches

  • Teste si une touche de la télécommande a été appuyée

  • Renvoie le code de la touche appuyée sous la forme d'une chaine hexadécimale

Les blocs de la catégorie "Synthé Vocal"

Ces blocs nécessitant un accès direct à la base de donnée du dictionnaire de chaines LPC, ils ne fonctionnent que sur la version en ligne de Blockly@rduino. . Ne fonctionne pas sur une version locale de Blockly@rduino !

Les blocs de la catégorie "RFID"


  • Ce bloc d'initialisation d'un module RFID1 est à mettre avant la boucle principale de votre programme. Ce bloc est nécessaire pour utiliser les quatre blocs suivants. Spécifiez la broche sur laquelle est connecté votre module.

  • Teste si une carte est présente sur le lecteur. Spécifiez la broche sur laquelle est connecté votre moduleRFID1

  • Permet de lire un des secteurs de la carte. Utilisez le bloc suivant pour obtenir la chaine de caractêre qui a été lu. Le secteur 0 correspond à l'ID de la carte RFID. Spécifiez la broche sur laquelle est connecté votre moduleRFID1

  • Renvoie le texte lu avec le bloc précédent. Spécifiez la broche sur laquelle est connecté votre moduleRFID1

  • Pour écrire un texte dans un des secteurs d'une carte RFID. Tous les secteurs sauf le 0 peuvent être écrit avec les données de votre choix. Spécifiez la broche sur laquelle est connecté votre moduleRFID1

Les blocs de la catégorie "Liaison Série"


  • Ce bloc d'initialisation de la liaison série est à mettre avant la boucle principale de votre programme. Ce bloc est nécessaire pour utiliser les blocs suivants. Spécifiez la vitesse de transmission souhaitée.

  • Ecrit un texte ou une valeur sur le port série sans effectuer de retour à la ligne.

  • Ecrit un texte ou une valeur sur le port série en effectuant un retour à la ligne.

Les blocs de la catégorie "Wifi"

Voir les exemples d'utilisation des modules WIFIx


  • Ce bloc d'initialisation du module WIFI1 ou WIFI2 à mettre avant la boucle principale de votre programme. Ce bloc est nécessaire pour utilisez les blocs suivants. Spécifiez les broches RX et TX

  • Utilisez une fois ce bloc pour configurer votre module WIFI1 ou WIFI2 :
    • Choisir entre le mode AP ( Access Point ) ou STA ( Station ) : Seul le module WIFI2 tient compte de ce paramètre. Le module WIFI1 est toujours en mode STA
    • Choisir le SSID de votre module en mode AP ou le SSID de votre réseau wifi en mode STA
    • Choisir le mot de passe de votre choix ( plus que 8 caractères ) en mode AP ou spécifier le mot de passe de votre réseau wifi en mode STA
    • Choisir l'IP de votre module en mode AP ou STA
    • Choisir l'IP de votre passerelle (gateway) : En mode AP il doit être identique à l'IP de votre module. En mode STA, il faut renseigner l'IP de la passerelle de votre box
    • Choisir le masque de sous réseau utilisé (subnet)
    • Basculer verbose sur ACTIVE ou DESACTIVE pour obtenir des informations de débogage sur le port série du module. N'est valable que pour le module WIFI2

  • Ce bloc doit être inclus dans la boucle principale de votre programme ( en général à la fin ou au début ) afin de garantir la bonne réception des ordres wifi

  • Teste si un message wifi a été reçu

  • Vide le tampon des message wifi. Faire obligatoirement cette opération après avoir traité un éventuelle message wifi pour permettre la réception d'un nouveau message.

  • Change la couleur de la led de l'interface web associée au champ spécifié

  • Teste si l'interrupteur de l'interface web associé au champ spécifié a basculé sur VRAI ou FAUX

  • Modifie la position de l'interrupteur sur VRAI ou FAUX associé au champ spécifié.

  • Teste si le bouton de l'interface web associé au champ spécifié a été appuyé

  • Utilisez ce bloc juste après le test précédent pour réinitialiser l'état du bouton associé au champ spécifié dans son état original. Si vous ne réinitialiser pas le bouton, il sera impossible de tester un nouvel appuie sur celui-ci

  • teste si le potentiomètre associé au champ spécifié a changé de position

  • Renvoie la valeur donnant la position du potentiomètre qui a changé de position. Ce bloc doit être utilisé juste après le test précédent

  • modifie la position du potentiomètre de l'interface web associé au champ spécifié

  • modifie la position de la gauge de l'interface web associée au champ spécifié

  • modifie le texte du label de l'interface web associé au champ spécifié

  • teste si le texte contenu dans la zone d'édition de l'interface web associé au champ spécifié a changé

  • lit le texte de la zone d'édition de l'interface web qui a changé. Ce bloc doit être utilisé juste après le test précédent

  • lit le nombre contenu dans la zone d'édition qui a changé. Ce bloc doit être utilisé juste après le test précédent

  • Ecrire un texte dans le fichier de log dont le numéro est spécifié. Ce bloc permet de stocker les valeurs de mesures par exemples. Ne fonctionne que sur le module WIFI2

  • Efface le fichier de log dont le numéro est spécifié. Ne fonctionne que sur le module WIFI2

  • Change la résolution de la caméra. A n'utiliser que si le shield ARDUCAM2MP est présent sur le module WIFI2

  • Prends une photo avec la camera (ARDUCAM2MP) est la stocke dans le fichier image dont le numéro est spécifié.A n'utiliser que si le shield ARDUCAM2MP est présent sur le module WIFI2

  • Affiche l'image dont le numéro est spécifié dans le camera wiever associé au champ spécifié. Ne fonctionne que sur le module WIFI2

Les blocs de la catégorie "Horloge temps réel"


  • Ce bloc d'initialisation de l'horloge temps réel RTC1 est à utiliser avant la boucle principale du programme.

  • Ce bloc est à utiliser une fois pour mettre à jour la date de l'horloge temps réel RTC1 montée sur une carte EASYBOT1 ou EASYCON2. Il vous suffit de préciser le jour, le mois et l'année

  • Ce bloc est à utiliser une fois pour mettre à l'heure l'horloge temps réel RTC1 montée sur une carte EASYBOT1 ou EASYCON2. Il vous suffit de préciser les heures, minutes et secondes

  • Renvoie la date actuelle sous la forme d'une chaine formatée JJ/MM/AA

  • Renvoie l'heure actuelle sous la forme d'une chaine formatée HH:MM:SS

  • Renvoie un nombre correspondant au jour, mois, année, heure, minute, seconde de la date actuelle

  • Renvoie le nombre de millisecondes ou de microsecondes écoulées depuis le dernier démarrage de la carte arduino

Les blocs de la catégorie "Bluetooth"


  • Ce bloc d'initialisation du module bluetooth BT1 est à mettre avant la boucle principale de votre programme. Ce bloc est nécessaire pour utilisez les trois blocs suivants. Spécifiez les broches RX et TX

  • Teste si un message bluetooth a été reçu

  • Lit le dernier message bluetooth reçu sous forme d'une chaine de caractêres

  • Envoie un texte sur la liaison bluetooth

Les blocs de la catégorie "Console IHM"

Plus d'informations sur La console IHM.

Voir les exemples d'utilisation de la console IHM


  • Ce bloc d'initialisation du module BT1 est à mettre avant la boucle principale de votre programme. Ce bloc est nécessaire pour utilisez les blocs suivants. Spécifiez les broches RX et TX

  • Teste si la console IHM ( application Barbot sur un appareil Android )est prête a recevoir des instructions de la part de la carte Arduino

  • Teste si une action a été réalisée sur l'interface IHM. Un clic sur un bouton, sur un interrupteur , le changement de position d'un potentiomètre …

  • Fait apparaître une led sur la console IHM. Ce bloc d'initialisation doit être positionné avant la boucle principale du programme. Un texte peut être affiché a côté de la led.

  • Permet de choisir la couleur d'une led de l'interface IHM

  • Fait apparaître un bouton sur la console IHM. Ce bloc d'initialisation doit être positionné avant la boucle principale du programme. Un texte peut être affiché a côté du bouton.

  • Teste si un des bouton de l'interface IHM a été appuyé

  • Fait apparaître un interrupteur sur la console IHM. Ce bloc d'initialisation doit être positionné avant la boucle principale du programme. Un texte peut être affiché a côté de l'interrupteur.

  • Bascule un des interrupteur de la console IHM sur la position “activé” ou “désactivé”

  • Teste si un des interrupteurs de la console IHM a été activé.

  • Fait apparaître un potentiomètre sur la console IHM. Ce bloc d'initialisation doit être positionné avant la boucle principale du programme. On peut modifier les paramètres d'affichage du potentiomètre suivant :
    • Le diviseur ( 1 , 10 , 100 , 1000 )
    • La valeur minimal est un entier qui sera divisé par le diviseur
    • La valeur maximale est un entier qui sera divisé par le diviseur
    • La position initiale du potentiomètre est un entier qui sera divisé par le diviseur
    • Un texte a afficher à côté du potentiomètre

  • Renvoie la valeur donnant la position d'un des potentiomètres de l'interface IHM

  • Fait apparaître une gauge sur la console IHM. Ce bloc d'initialisation doit être positionné avant la boucle principale du programme. On peut modifier les paramètres d'affichage de la gauge suivant :
    • La valeur minimal de la gauge
    • La valeur maximale de la gauge
    • Le pas principal de graduation
    • Le pas secondaire de graduation
    • Un titre et une unité séparé par un ;
    • Un texte écrit a côté de la gauge

  • modifie la position d'une des gauges de l'interface IHM

Les blocs de la catégorie "Mémoire"


  • Ce bloc d'initialisation réserve une zone de mémoire dans la RAM de l'Arduino pour y stocker un certain nombre d'entiers. Ce bloc est a mettre avant la boucle principale du programme. Ce bloc est nécessaire pour utiliser les trois blocs suivants.

  • Remet à zéro la zone de mémoire en RAM

  • Pour stocker une valeur entière dans une des “cases mémoire” réservée dans la RAM

  • Renvoie la valeur entière stockée dans la case mémoire spécifiée

  • Par défaut, les blocs textes sont stockés en RAM. Ce bloc force le stockage du texte spécifié dans la mémoire programme ( FLASH MEMORY ) de la carte Arduino ( d'ou un gain de place en RAM ! )
documentation/reference_blocky_rduino.txt · Dernière modification: 2018/12/12 12:05 par admin