Menu TI Hub

Remarque : Lors de la création d’un nouveau programme qui utilise ce module, il est recommandé d’utiliser le type de programme Projet hub (Hub Project). Ceci garantit que tous les modules nécessaires sont importés.

Élément

descriptions

from ti_hub import *

Importe toutes les méthodes du module ti_hub.

 

Dispositifs intégrés du hub > Sortie couleur

Élément

descriptions

rgb(red,green,blue)

Définit la couleur de la DEL RGB.

blink(frequency,time)

Définit la fréquence (frequency) et la durée (time) de clignotement pour la couleur sélectionnée.

off()

Éteint la DEL RGB.

 

Dispositifs intégrés au Hub (Hub Built-in Devices) > Sortie lumière (Light Output)

Élément

descriptions

on()

Allume la DEL.

off()

Éteint la DEL.

blink(frequency,time)

Définit la fréquence (frequency) et la durée (time) de clignotement de la DEL.

 

Dispositifs intégrés au Hub (Hub Built-in Devices) > Sortie audio (Sound Output)

Élément

descriptions

tone(frequency,time)

Joue une tonalité à la fréquence spécifiée pendant le temps spécifié.

note("note",time)

Joue la note spécifiée pendant la durée (time) spécifiée.

La note est spécifiée au moyen de son nom (en anglais) et d’une octave. Par exemple : A4, C5.

Les noms des notes (en anglais) sont C, CS, D, DS, E, F, FS, G, GS, A, AS et B.

Les octaves sont comprises entre 1 et 9 (inclus).

tone(frequency,time,tempo)

Joue une tonalité à la fréquence spécifiée pendant le temps et au tempo spécifiés.

Le tempo définit le nombre de bips par seconde entre 0 et 10 (inclus).

note("note",time,tempo)

Joue la note spécifiée pendant le temps et au tempo spécifiés.

La note est spécifiée au moyen de son nom (en anglais) et d’une octave. Par exemple : A4, C5.

Les noms des notes (en anglais) sont C, CS, D, DS, E, F, FS, G, GS, A, AS et B.

Les octaves sont comprises entre 1 et 9 (inclus).

Les valeurs de tempo sont comprises entre 0 et 10 (inclus).

 

Dispositifs intégrés au Hub (Hub Built-in Devices) > Entrée luminosité (Brightness Input)

Élément

descriptions

measurement()

Lit le capteur de LUMINOSITÉ (niveau de lumière) intégré et retourne la valeur relevée.

La plage par défaut est de 0 à 100. Cela peut être modifié via la fonction range().

range(min,max)

Définit la plage pour la configuration des relevés du capteur de niveau de lumière.

Si les deux valeurs sont manquantes, ou si elles sont définies sur une valeur évaluée à None, alors la plage de luminosité par défaut (de 0 à 100) est utilisée.

 

Ajouter un dispositif d’entrée (Add Input Device)

Ce menu contient une liste des capteurs (dispositifs d’entrée) pris en charge par le module ti_hub. Toutes les options du menu collent le nom de l’objet et attendent une variable et un port utilisés avec le capteur. Chaque capteur possède une méthode measurement() qui retourne la valeur mesurée.

Élément

descriptions

DHT (Capteur de température et d’humidité) (DHT, Digital Humidity & Temp)

Renvoie une liste comportant la température, l’humidité, le type de capteur actuels et le dernier état mis en mémoire.

Ranger (Capteur de distance)

Renvoie la mesure de la distance courante issue du capteur de distance à ultrasons spécifié.

• measurement_time() : renvoie le temps pris par le signal ultrasonique pour atteindre l’objet (le « temps de vol »).

Niveau de lumière

Renvoie le niveau de luminosité issu du capteur de lumière externe (luminosité).

température

Renvoie la lecture de la température issue du capteur de température externe.

La configuration par défaut prend en charge le capteur de température Seeed sur les ports IN 1, IN 2 ou IN 3.

Pour utiliser le capteur de température TI LM19 du pack de platines d’essais TI-Innovator™ Hub, modifiez le port sur la broche BB en service et utilisez un argument optionnel « TIANALOG ».

Exemple : mylm19=temperature("BB 5","TIANALOG")

Humidité

Renvoie la lecture du capteur d’humidité.

Champ magnétique

Détecte la présence d’un champ magnétique.

La valeur seuil pour déterminer la présence du champ est fixée par la fonction trigger().

La valeur par défaut du seuil est de 150.

App Vernier

Lit la valeur du capteur analogique Vernier spécifié dans la commande.

La commande prend en charge les capteurs Vernier suivants :

• température : capteur de température en acier inoxydable.
• niveau de lumière : capteur de niveau de lumière TI.
• pression : capteur de pression de gaz d'origine.
• pression : capteur de pression de gaz plus récent.
• pH : capteur de pH.
• force10 : réglage ±10 N, capteur de force double échelle.
• force50 : réglage ±50 N, capteur de force double échelle.
• accéléromètre : accéléromètre Low-G.
• générique : permet le réglage d’autres capteurs non pris en charge directement comme ci-dessus et l’utilisation de l’API calibrate() ci-dessus pour définir des coefficients d’équation.

Entrée analogique

Prend en charge l’utilisation de dispositifs génériques d’entrée analogique.

Entrée numérique

Renvoie l’état actuel de la broche numérique connectée à l’objet DIGITAL ou l’état de mise en cache de la valeur de sortie numérique DÉFINIE en dernier lieu sur l’objet.

Potentiomètre

Prend en charge un potentiomètre.

La plage du capteur peut être modifiée par la fonction range().

Thermistor

Lit le thermistor.

Les coefficients par défaut sont adaptés au thermistor inclus dans le pack de platine d’essais TI-Innovator™ Hub, lorsqu’il est utilisé avec un résistor fixe de 10 kΩ.

Un nouveau jeu de coefficients d’étalonnage et une résistance de référence pour le thermistor peuvent être configurés à l’aide de la fonction calibrate().

Intensité sonore

Prend en charge les capteurs de niveau sonore.

Entrée couleur

Fournit des interfaces à un capteur colorimétrique d’entrée connecté au port I2C.

La broche bb_port est utilisée en plus du port I2C pour contrôler la DEL du capteur de couleur.

• color_number(): Retourne une valeur comprise entre 1 et 9 qui représente la couleur détectée par le capteur.

Les chiffres représentent les couleurs selon les correspondances suivantes :

1: Rouge

2: Vert

3: Bleu

4: Cyan

5: Magenta

6: Jaune

7: Noir

8 : Blanc

9: Gris

• red(): Retourne une valeur de 0 à 255 qui représente l’intensité du niveau de couleur ROUGE détecté.
• green(): Retourne une valeur de 0 à 255 qui représente l’intensité du niveau de couleur VERTE détecté.
• blue(): Retourne une valeur de 0 à 255 qui représente l’intensité du niveau de couleur BLEUE détecté.
• gray(): Retourne une valeur de 0 à 255 qui représente le niveau de gris détecté, où 0 correspond au noir et 255 au blanc.

Port BB

Permet d’utiliser les 10 broches du port BB comme un port d’entrée/sortie numérique combiné.

Les fonctions d’initialisation disposent d’un paramètre « masque (mask) » optionnel qui permet d’utiliser le sous-ensemble de 10 broches.

• read_port(): Lit les valeurs courantes sur les broches d’entrée du port BB.
• write_port(value): Règle la broche de sortie à la valeur spécifiée (la valeur est comprise entre 0 et 1023). Notez que la valeur est également ajustée par rapport à la valeur du masque dans l’opération var=bbport(mask), si un masque a été fourni.

Hub Time

Permet d’accéder au timer interne (en millisecondes).

TI-RGB Array

Fournit des fonctions pour la programmation de TI-RGB Array.

La fonction d’initialisation accepte un paramètre optionnel « LAMP » pour activer le mode haute luminosité de TI-RGB Array. Il requiert une alimentation électrique externe.

• set(led_position, r,g,b): Règle la valeur r,g,b spécifiée pour la DEL située à la position (led_position) spécifiée (0-15). r, g et b sont des valeurs comprises entre 0 et 255.
• set(led_list,red,green,blue): Définit les DEL de la « led_list » sur la couleur spécifiée « rouge », « vert » ou « bleu ». La « led_list » est une liste Python qui inclut les index des DEL de 0 à 15. Par exemple, set([0,2,4,6,15], 0, 0, 255) définira les DEL 0, 2, 4, 6 et 15 sur le bleu.
• set_all(r,g,b): Règle la même valeur r,g,b pour toutes les DEL RGB de la matrice.
• all_off(): Éteint toutes les DEL RGB de la matrice.
• measurement(): Retourne la valeur approximative du courant consommé (en milliampères) sur TI-Innovator™ par la matrice RGB.
• pattern(pattern): L’argument « pattern » est une valeur binaire de 16 bits (de 0 à 65 535), où la valeur « 1 » active le pixel correspondant. Les DEL sont allumées en ROUGE avec une valeur de niveau MLI de 255.
• pattern(value,red,green,blue): Définit les DEL caractérisées par le « modèle » sur la couleur spécifiée « rouge », « vert » ou « bleu ».

 

Ajouter un dispositif de sortie

Ce menu contient une liste des dispositifs de sortie pris en charge par le module ti_hub. Toutes les options du menu collent le nom de l’objet et attendent une variable et un port utilisés avec le dispositif.

Élément

descriptions

VOYANT

Fonctions de contrôle des DEL connectées externes.

RVB

Prise en charge du contrôle des DEL RGB externes.

TI-RGB Array

Fournit des fonctions pour la programmation de TI-RGB Array.

Haut-parleur

Fonctions de prise en charge d’un haut-parleur externe avec le TI-Innovator™ Hub.

Les fonctions sont les mêmes que celles relatives au « son » décrites plus haut.

Puissance

Fonctions de contrôle des alimentations externes avec le TI-Innovator™ Hub.

• set(value): Règle le niveau de puissance à la valeur (value) spécifiée, entre 0 et 100.
• on(): Règle le niveau de puissance à 100.
• off(): Règle le niveau de puissance à 0.

Servomoteur continu

Fonctions de contrôle des servomoteurs continus.

• set_cw(speed,time): Le servomoteur tournera dans le sens des aiguilles d’une montre à la vitesse (speed) spécifiée (0-255) et pendant la durée (time) spécifiée (en secondes).
• set_ccw(speed,time): Le servomoteur tournera dans le sens inverse des aiguilles d’une montre à la vitesse (speed) spécifiée (0-255) et pendant la durée (time) spécifiée (en secondes).
• stop(): Arrête le servomoteur continu.

Sortie analogique

Fonctions pour l’utilisation de dispositifs génériques d’entrée analogique.

Moteur vibrant

Fonctions de contrôle des moteurs vibrants.

• set(val): Règle l’intensité du moteur vibrant au niveau « val » (0-255).
• off(): Éteint le moteur vibrant.
• on(): Met en marche le moteur vibrant au niveau le plus élevé.

Relais

Interfaces de contrôle des relais.

• on(): Règle le relais sur l’état ON.
• off(): Règle le relais sur l’état OFF.

Servo

Fonctions de contrôle des servomoteurs.

• set_position(pos): Règle la position angulaire (pos) du servomoteur entre -90° et +90°.
• zero(): Règle le servomoteur angulaire sur la position zéro.

Squarewave

Fonctions de génération d’un signal carré.

• set(frequency,duty,time): Règle le signal carré de sortie avec un rapport cyclique (duty) par défaut de 50 % (s’il n’est pas spécifié) et une fréquence de sortie spécifiée par « frequency ». La fréquence peut être comprise entre 1 et 500 Hz. Le rapport cyclique, s’il est spécifié, peut être compris entre 0 et 100 %.
• off(): Désactive le signal carré.

Sortie numérique

Interfaces de contrôle d’une sortie numérique.

• set(val): Règle la sortie numérique à la valeur spécifiée par « val » (0 ou 1).
• on(): Règle la sortie numérique à un niveau haut (1).
• off(): Règle la sortie numérique à un niveau bas (0).

Port BB

Fournit des fonctions pour la programmation de TI-RGB Array.

Voir les détails ci-dessus.

 

Commandes

Élément

descriptions

sleep(seconds)

Interrompt le programme pendant le nombre spécifié de secondes.

Importé depuis le module « temps ».

text_at(row,"text","align")

Affiche, dans la zone de graphe, le texte (text) spécifié avec l’alignement (align) spécifié.

Fait partie du module ti_plotlib.

cls()

Efface l’écran de la console (Shell) pour une représentation graphique.

Fait partie du module ti_plotlib.

while get_key() != "esc":

Exécute les commandes dans la boucle « while » jusqu’à ce que la touche d’échappement « esc » soit enfoncée.

get_key()

Retourne une chaîne représentant la touche enfoncée.

La touche « 1 » retourne « 1 », la touche d’échappement retourne « esc », etc.

Lorsque la fonction est appelée sans paramètres (get_key()), elle retourne immédiatement la chaîne de caractères vide ('').

Lorsque la fonction est appelée avec un paramètre (get_key(1)), elle attend qu’une touche soit enfoncée.

Fait partie du module ti_system.

 

Ports

Ce sont les ports d’entrée et de sortie disponibles sur le TI-Innovator™ Hub.

Élément

OUT 1

OUT 2

OUT 3

IN 1

IN 2

IN 3

BB 1

BB 2

BB 3

BB 4

BB 5

BB 6

BB 7

BB 8

BB 9

BB 10

Port I2C