Déclarer un équipement
Un équipement est un appareil physique (compteur, capteur, automate…) ou virtuel (connecteur) qui remonte des données vers la plateforme.
Pour qu'il puisse exister sur la plateforme et puisse émettre, il faut le déclarer. Deux parcours sont possibles : la création manuelle depuis l'IHM, ou l'activation automatique par l'équipement lui-même. Cette page décrit les deux, et détaille le formulaire de création manuelle.
Création manuelle dans la plateforme
Un opérateur ouvre le module Administration et crée l'équipement à la main via un formulaire. Toutes les informations : nom, numéro de série, fabricant, type… sont saisies manuellement, puis l'équipement apparaît dans la liste. Cette approche est adaptée à la mise en service à l'unité, à la validation d'un nouveau type d'équipement, ou à un déploiement à petit volume où l'effort de saisie reste raisonnable.
- Création possible sans que l'équipement soit présent ni connecté : la fiche peut être préparée en amont.
- Validation visuelle directe par l'opérateur, correction immédiate dans la fiche si erreur de saisie.
- Idéal pour piloter ou valider un nouveau type d'équipement à petite échelle.
- Ne passe pas à l'échelle : déclarer 500 équipements à la main devient vite ingérable en temps homme.
- Erreurs de saisie ou d'incohérences entre opérateurs (numéro de série mal recopié, type mal choisi).
- Le firmware doit quand même intégrer l'envoi de données : credentials (deviceDeveloperId, apiKey, URLs) à préconfigurer par un canal externe à la plateforme.
Activation automatique par l'équipement
L'équipement se déclare lui-même sur la plateforme dès son premier démarrage. Le firmware embarque une logique générique : il utilise la clé d'activation pré-chargée pour appeler l'API et reçoit en retour tout ce dont il a besoin pour envoyer ses données (UUID device, credentials, URLs d'envoi). Aucune saisie manuelle n'est requise - c'est l'approche standard pour les flottes industrielles, les déploiements automatisés, et les gateways qui agrègent des équipements non capables de s'auto-déclarer.
- Passe à l'échelle sans effort : déclarer 10 ou 10 000 équipements coûte le même temps opérateur.
- Idempotent (rejouer l'appel ne crée pas de doublon), les retries côté firmware restent simples à gérer.
- Accélérer la création de grappe de produit : Une gateway est chargé de déclarer ses équipements muets.
- Effort de dev firmware initial pour intégrer l'appel à l'API d'activation.
- Surcouche peu justifiée pour un pilote de quelques unités.
Le détail du protocole, les cas de réactivation, la gestion des erreurs et les bonnes pratiques côté firmware sont documentés dans Automatiser l'activation d'équipements.
Création manuelle - formulaire en détail
La déclaration manuelle s'effectue depuis le module Administration. Une fois le site sélectionné, le bouton « + Ajouter un équipement » dans le volet latéral ouvre le formulaire ci-dessous.
Informations obligatoires
| Champ | Description |
|---|---|
| Nom technique | Identifiant technique de l'équipement |
| Nom affiché | Nom visible dans l'interface |
| Numéro de série | Numéro de série unique de l'équipement |
| Fabricant | Fabricant de l'équipement |
| Famille | Famille d'équipement |
| Type d'équipement | Modèle à appliquer (sélectionner Generic si aucun modèle n'est configuré) |
| Site | Site de rattachement de l'équipement |
Le type d'équipement détermine la structure de données héritée par l'équipement (items, services, mapping). S'il n'existe pas encore, créez-le au préalable depuis le Référentiel : voir Décrire un type d'équipement.
Informations facultatives
| Champ | Description |
|---|---|
| Passerelle | Passerelle de connexion |
| Autorisation de déplacement | Permet le déplacement de l'équipement |
| Numéro de contrat | Référence du contrat associé |
| Date d'expiration du contrat | Date de fin du contrat |
| Mode de Mapping | Mode de correspondance des données (Auto par défaut) |
| Description | Description de l'équipement |
| Adresse | Adresse de l'équipement (utile pour l'affichage sur carte) |
| Icône/Photo | Image représentant l'équipement |
Cliquez sur Envoyer pour créer l'équipement. Il apparaîtra ensuite dans la liste des équipements.
Héritage du type d'équipement
Lorsque vous sélectionnez un type d'équipement, l'équipement hérite automatiquement de :
- la liste des items définis dans le type
- la liste des services (variables) associés
- la configuration de mapping des données
Cela permet de standardiser la collecte de données pour tous les équipements d'un même type. Pour construire un type adapté à votre flotte, voir Décrire un type d'équipement.
Et après ?
Une fois l'équipement déclaré, il est prêt à recevoir des données. Selon votre contexte :
- Quelques équipements à la main - vous pouvez en rester là et configurer la collecte de données directement.
- Flotte ou gateway industrielle - passez à Automatiser l'activation d'équipements pour utiliser l'API d'activation.
- Modéliser une famille d'équipements - voyez Décrire un type d'équipement avant tout déploiement.
