Aller au contenu principal

Tableaux de bord

Jusqu'ici, chaque tutoriel a piloté la carte au moyen de matériel (boutons, capteurs) ou l'a observée via la console série et le traceur. Un tableau de bord vous permet de construire votre propre panneau de contrôle à l'écran : boutons, interrupteurs, curseurs, champs numériques et LED indicatrices qui dialoguent avec une carte en cours d'exécution en temps réel — aucun téléversement n'est nécessaire pour modifier une valeur.

Un tableau de bord est un troisième type de feuille, aux côtés des feuilles de flux classiques et de la feuille de câblage. Au lieu de câbler des modules entre eux, vous déposez des widgets sur un canevas libre et pointez chacun d'eux vers un module de votre conception.

remarque

Le tableau de bord dialogue avec la carte via la même liaison en direct que le reste de l'IDE (USB ou Bluetooth Low Energy). Il ne génère pas et ne modifie pas le firmware — il envoie des commandes à un firmware déjà en cours d'exécution. Veillez à téléverser votre projet au préalable.

Ajouter une feuille de tableau de bord​

Depuis le menu, choisissez Feuilles → Ajouter un tableau de bord (ou le + à côté des onglets de feuille, puis sélectionnez Tableau de bord). Un nouvel onglet apparaît après la feuille de câblage, affichant un canevas sombre vide au lieu de la grille de câblage habituelle.

Vous pouvez avoir un tableau de bord par projet. Basculez vers lui comme vers n'importe quelle autre feuille en cliquant sur son onglet.

Widgets​

Les widgets figurent dans leurs propres catégories de palette (affichées uniquement lorsqu'une feuille de tableau de bord est active). Faites glisser l'un d'eux depuis la palette sur le canevas, puis double-cliquez dessus — ou clic droit → Éditer — pour le configurer dans la barre latérale.

WidgetFonction
ButtonContrôle momentané — envoie une valeur pendant l'appui, une autre au relâchement.
ToggleInterrupteur marche/arrêt à état stable — envoie une valeur marche ou une valeur arrêt et mémorise son état.
SliderFaites glisser pour définir une valeur dans une plage ; envoie à chaque changement.
NumberTapez ou incrémentez un nombre précis ; l'envoie, avec conversion d'unité facultative.
Number SelectorComme Number, mais l'utilisateur choisit dans une liste déroulante fixe de valeurs prédéfinies au lieu de taper.
Number DisplayValeur formatée en lecture seule avec un suffixe d'unité facultatif — interroge une sortie / un paramètre de module.
LedIndicateur en lecture seule — interroge une valeur de la carte et se teinte entre deux couleurs.
GraphSérie temporelle en lecture seule en temps réel — interroge une valeur à une cadence configurable et la trace sur un graphique défilant.

Ce qu'envoie un widget — l'Action​

Chaque widget de contrôle possède une Action qui détermine quel type de commande il envoie à son module cible. Elles correspondent une à une aux commandes d'exécution que l'IDE utilise déjà :

ActionEffet sur la cible
SetInputInjecte une valeur dans l'une des entrées du module (comme si un fil l'avait acheminée).
SetOutputForce l'une des sorties du module.
SetParamModifie un paramètre d'exécution en direct (par exemple la fréquence d'un Software Timer). Non sauvegardé.
SetAndSaveParamComme SetParam, mais enregistre aussi la nouvelle valeur dans le stockage de la carte afin qu'elle survive à une réinitialisation.

Vous choisissez ensuite le nœud cible (n'importe quel module de votre projet) et l'index (quelle entrée / sortie / paramètre sur cette cible — le libellé change en Index d'entrée, Index de sortie ou Index de paramètre selon l'Action).

astuce

SetParam / SetAndSaveParam ciblent les paramètres d'exécution d'un module — les mêmes champs que vous réglez dans sa boîte de dialogue d'édition (la Fréquence d'un Software Timer, les bornes d'un module Range, etc.). C'est ainsi que vous ajustez une carte en direct depuis un curseur ou un champ numérique.

Options communes​

Chaque widget dispose également de :

  • Color — la couleur d'accent (fond du bouton, teinte du curseur, remplissage de l'interrupteur…). Un sélecteur de couleur en direct met à jour le canevas au fur et à mesure que vous faites glisser.
  • Comment — une info-bulle affichée lorsque vous survolez le widget dans la visionneuse du tableau de bord.

Button​

OptionSignification
Press valueValeur envoyée pendant que le bouton est maintenu (par défaut 255).
Release valueValeur envoyée au relâchement (par défaut 0).

Un Button est idéal pour un SetInput vers l'entrée de réinitialisation d'un Software Timer, un déclenchement ponctuel, des commandes de déplacement momentanées (jog), et ainsi de suite.

Toggle​

OptionSignification
On valueValeur envoyée à l'activation (par défaut 255).
Off valueValeur envoyée à la désactivation (par défaut 0).

L'interrupteur se remplit de la couleur d'accent lorsqu'il est activé, et est contouré lorsqu'il est désactivé. Son état est mémorisé avec le projet.

Slider​

OptionSignification
Min / MaxPlage du curseur.
StepIncrément (entier ou fractionnaire).

Le curseur envoie en continu pendant que vous le faites glisser. En interne, le flux rapide de valeurs est limité en débit pour ne jamais saturer la liaison.

Number​

Un champ numérique à saisie avec un bouton Send (Entrée envoie également). Au-delà de Min / Max / Step, il ajoute deux choses :

OptionSignification
Value typeRaw (envoyé tel quel), Frequency (affiché en Hz/kHz/mHz, le firmware reçoit toujours des Hz), ou Period (affiche une période en µs/ms/s/mn, le firmware reçoit la fréquence équivalente 1 / period).
UnitL'unité affichée à côté du champ ; les choix dépendent du Value type.
DigitsNombre de décimales auquel la valeur affichée est arrondie.

Le type de valeur Period est pratique avec un Software Timer : pensez « clignoter toutes les 20 ms » et laissez le widget envoyer la fréquence correspondante.

Number Selector​

Même envoi que Number — choisissez une Action (SetInput / SetOutput / SetParam / SetAndSaveParam), un nœud cible et un index — mais au lieu de taper une valeur, l'utilisateur en choisit une dans une liste déroulante d'options prédéfinies. La liste se configure dans la boîte de dialogue d'édition, une option par ligne, sous l'une ou l'autre forme :

Format de ligneEffet
123Valeur 123, affichée dans la liste déroulante comme 123.
123=SlowValeur 123, affichée dans la liste déroulante comme Slow.
0.5=HalfLes nombres à virgule fonctionnent aussi.

Usage typique : un Software Timer entre des fréquences nommées, un moteur pas à pas entre des rapports nommés, une sortie Range entre des modes grossier / moyen / fin — partout où l'utilisateur ne devrait pas taper des nombres arbitraires.

Number Display​

Contrepartie en lecture seule de Number. Comme la Led, il possède une Source (GetOutput ou GetParam), un nœud cible et un index ; au lieu d'une couleur, il affiche la valeur sous forme de nombre formaté :

OptionSignification
SourceGetOutput ou GetParam.
Refresh (ms)Période d'interrogation (par défaut 500).
DigitsDécimales auxquelles la valeur est arrondie.
UnitSuffixe facultatif (°C, mm, V, kg, …).
ColorCouleur du texte de la valeur.

Parfait pour l'affichage en direct de capteurs — une température DS18B20, un poids HX711, un angle AS5600, une tension ADC.

Graph​

Graphique en temps réel en lecture seule, utilisant le même moteur Dygraph que board_manager.html et le traceur de l'IDE. Mêmes Source / Target / index que Display, avec quelques options propres au graphique :

OptionSignification
Source / Target / indexCe qu'il faut lire.
Refresh (ms)À quelle fréquence un nouvel échantillon est récupéré (par défaut 200).
Window (s)Combien de secondes d'historique sont conservées à l'écran — les échantillons plus anciens défilent hors champ.
Auto YMet automatiquement à l'échelle l'axe Y sur les données en direct.
Y min / Y maxUtilisés lorsque Auto Y est désactivé — utile pour maintenir plusieurs widgets Graph à la même échelle.
ColorCouleur du tracé.

Un seul canal par widget ; déposez plusieurs widgets Graph côte à côte pour des tracés à plusieurs variables.

Led​

Un indicateur en lecture seule. Au lieu d'une Action, il possède une Source :

OptionSignification
SourceGetOutput (lire une sortie de module) ou GetParam (lire un paramètre d'exécution).
Target node / indexQuel module et quelle sortie/paramètre lire.
Min / MaxValeurs associées aux couleurs arrêt et marche.
Off color / On colorLa teinte de la LED est interpolée entre ces deux couleurs à mesure que la valeur passe de Min à Max.
Refresh (ms)À quelle fréquence la valeur est interrogée (par défaut 500).

La couleur de la Led est interpolée en douceur, de sorte qu'elle fonctionne aussi bien comme un simple bargraphe dans un point que comme un voyant marche/arrêt.

Connecter la carte pour un contrôle en direct​

Les widgets n'agissent que lorsqu'une carte est connectée. Sélectionnez votre carte dans la liste déroulante de connexion en haut de la fenêtre — exactement comme vous le feriez avant un téléversement :

  • USB — via le Board Server, ou directement par le navigateur (WebHID / Web Serial).
  • Bluetooth Low Energy — choisissez + Ajouter une carte BLE… pour appairer une carte exposant le service Nordic UART. Une fois appairée, elle apparaît dans la liste déroulante comme n'importe quelle autre carte.

Votre projet doit contenir une NodeBlue Interface pour que la carte puisse recevoir ces commandes. Sur la plupart des cartes, une interface est ajoutée automatiquement (l'interface de configuration HID/série) ; vous pouvez aussi placer un module d'interface explicite et le câbler.

remarque

Pour le BLE, le firmware de la carte doit exécuter un UART BLE (le module nBLEuart) câblé à une NodeBlue Interface. L'IDE maintient la liaison active en arrière-plan pour que le tableau de bord reste réactif.

Relire les valeurs de la carte​

Un tableau de bord n'est pas unidirectionnel. Lorsque vous l'ouvrez, les widgets qui lisent des valeurs récupèrent l'état actuel de la carte en cours d'exécution :

  • Les widgets Number et Slider réglés sur SetParam / SetAndSaveParam émettent un GetParam au chargement et affichent la valeur réelle de la carte — ainsi un tableau de bord fraîchement ouvert reflète la réalité, et non la dernière valeur que vous avez pu taper.
  • Les widgets Led interrogent en continu (GetOutput ou GetParam) à leur cadence de rafraîchissement.

Pour que la relecture fonctionne, deux conditions doivent être réunies côté firmware :

  1. La carte doit pouvoir répondre — la sortie de la NodeBlue Interface doit être recâblée vers le transport (pour le BLE, sortie de l'interface → nBLEuart). Le seul envoi (SetParam, appuis de bouton) ne nécessite que le sens entrant.
  2. Le module cible doit prendre en charge la lecture — il doit répondre à GetParam / GetOutput. Les modules standard qui exposent des paramètres d'exécution (la fréquence, le mode et le nombre de périodes d'un Software Timer, par exemple) répondent à GetParam ; les modules qui ont des sorties répondent à GetOutput.
attention

Si la carte est hors ligne, ou si une cible ne répond pas, le widget conserve simplement sa dernière valeur (et une note d'une ligne est consignée dans le panneau d'information). Rien ne casse — la relecture se fait au mieux.

Éditer le tableau de bord​

Le canevas du tableau de bord se comporte comme le canevas de flux, avec des commodités pour disposer les widgets :

  • Déplacer — faites glisser un widget. Redimensionner — faites glisser une poignée d'angle.
  • Sélectionner — cliquez sur un widget ; Maj-clic ou tracez un cadre de sélection élastique pour en sélectionner plusieurs.
  • Aligner — clic droit sur une sélection multiple pour Aligner à gauche / à droite / Centrer H / En haut / En bas / Centrer V.
  • Copier / Couper / Coller — Ctrl-C / Ctrl-X / Ctrl-V, ou le menu contextuel. Les widgets collés arrivent légèrement décalés et restent sélectionnés.
  • Supprimer — touche Suppr ou le menu contextuel.
  • Annuler / Rétablir — Ctrl-Z / Ctrl-Y, y compris les déplacements, redimensionnements et alignements.

Cliquer sur un widget le charge aussi dans l'onglet Éditer de la barre latérale (si cet onglet est ouvert), ce qui vous permet d'ajuster le dernier widget cliqué sans rouvrir la boîte de dialogue à chaque fois. Cliquer sur un canevas vide efface l'onglet Éditer.

Partager un tableau de bord : la visionneuse​

Une fois un tableau de bord construit, vous pouvez en ouvrir une version épurée en plein écran, sans interface d'éditeur, via Affichage → Visionneuse de tableau de bord (elle s'ouvre dans un nouvel onglet, en emportant l'identifiant du projet courant). La visionneuse masque la palette, les barres latérales et la majeure partie de la barre d'outils — ne conservant que le sélecteur de carte, le bouton de thème clair/sombre et le sélecteur de langue — et rend les widgets non éditables mais pleinement interactifs.

Qui peut l'ouvrir dépend du réglage de partage du projet :

  • Un projet marqué Public peut être ouvert par toute personne disposant du lien.
  • Sinon, la visionneuse exige que le propriétaire du projet (ou un administrateur) soit connecté.

La visionneuse utilise exactement la même liaison en direct que l'éditeur : un téléphone ou une tablette pointé vers l'URL devient ainsi une télécommande pour la carte.


Ceci conclut les tutoriels NodeBlue essentiels. À partir d'ici, explorez les groupes de modules — logique, mathématiques, communication, capteurs, audio et plus encore — chacun traité dans son propre tutoriel.