Votre premier équipement connecté à Cepaos, pas à pas

Avant de commencer

• Offre : la télémétrie IoT est incluse à partir du plan Domaine (et dans toutes les offres supérieures). Si votre offre ne l’inclut pas, Cepaos vous indique, en ouvrant IoT & Automatisation, quelle offre l’inclut et son prix sur votre marché.
• Droits : connecter des équipements et des passerelles nécessite le rôle Propriétaire ou Admin.
• Ce que vous connectez : si votre équipement (ou le cloud de son fabricant) peut envoyer des données par internet de lui-même, suivez le parcours A. S’il s’agit d’un automate ou d’une machine industrielle sans connexion propre, suivez le parcours B. Vous hésitez entre équipement et capteur ? Lisez l’article « Équipement ou capteur ? » de ce centre d’aide.

Parcours A — l’équipement envoie déjà des données par internet

1. Ouvrez IoT & Automatisation → Équipements → Équipements connectés et cliquez sur + Connecter un équipement.
2. Choisissez le type d’équipement (pressoir, pompe, ligne d’embouteillage, station météo…) et, s’il est proposé, le profil de votre modèle.
3. Saisissez un nom que votre équipe reconnaîtra. Fabricant, emplacement et identifiant machine sont facultatifs ; avec le fabricant, Cepaos vous suggère des étapes d’installation.
4. À la création, Cepaos affiche la clé d’API une seule fois. Dans « Pour votre technicien », vous trouvez l’adresse à laquelle l’équipement doit envoyer ses données, un message d’exemple pour ce type d’équipement, un test rapide avec curl, un fichier de configuration à télécharger et un QR code. Conservez la clé en lieu sûr : si vous la perdez, elle ne peut plus être affichée ; vous pouvez seulement la renouveler (une nouvelle clé est générée et l’ancienne cesse de fonctionner).
5. Votre technicien configure l’équipement pour envoyer chaque mesure en POST à cette adresse, avec l’en-tête Authorization: Bearer suivi de la clé, et un JSON contenant au minimum eventType (et, si besoin, value et unit).
6. Ouvrez la fiche de l’équipement. Tant que rien n’arrive, une salle d’attente se met à jour toute seule toutes les 10 secondes ; dès que la première donnée arrive, elle s’affiche avec son heure et son contenu pour que vous vérifiiez que le format est correct.

Parcours B — équipements sans connexion propre : passerelle Cepaos

La passerelle est un Raspberry Pi ou un mini-PC installé à la cave, qui traduit les protocoles industriels en données compréhensibles par Cepaos.

1. Préparez l’appareil : Raspberry Pi 3 ou plus récent (Pi 4 avec 2 Go ou plus recommandé) ou un mini-PC, sous Raspberry Pi OS Lite 64 bits ou Ubuntu Server 22.04 ou ultérieur, relié par câble au réseau de la cave et avec accès à internet.
2. Ouvrez IoT & Automatisation → Équipements → Passerelle et cliquez sur Connecter une passerelle. Saisissez un nom et, si vous le souhaitez, l’emplacement.
3. Cepaos génère une commande d’installation avec un jeton affiché une seule fois, valable 24 heures et consommé à la première connexion. Collez-la dans le terminal du Pi (en SSH ou avec clavier et écran). Le script installe l’agent comme service et le démarre ; comptez environ 2 minutes.
4. Sur la page de la passerelle, le statut passe à « En ligne » quand l’agent se connecte. Si rien n’apparaît au bout de 5 minutes, consultez les journaux sur le Pi avec journalctl -u cepaos-gateway -f.
5. La passerelle analyse le réseau et liste ce qu’elle trouve dans « Appareils découverts » (nouvelle analyse toutes les 5 minutes). Cliquez sur Adopter, donnez un nom : l’appareil devient un équipement connecté.

Protocoles : Modbus TCP et MQTT ont déjà été validés sur du matériel réel. Modbus RTU, OPC-UA et Siemens S7 sont implémentés mais pas encore validés sur du matériel réel : contactez-nous avant de vous y fier en production.

Quand les données arrivent

• Vue d’ensemble (IoT & Automatisation → Équipements → Vue d’ensemble) : l’état de tous vos équipements d’un coup d’œil.
• Fiche de l’équipement : mesures, historique et vue en direct.
• Alertes : la cloche en haut à droite des pages IoT ouvre le centre d’alertes (commandes échouées, erreurs signalées par l’équipement, analyses de laboratoire hors plage, mises en bouteille non rapprochées). Vous pouvez les marquer comme lues ou les résoudre.
• E-mail : activez « Alertes IoT critiques par e-mail » dans vos préférences de notification (Paramètres). Les e-mails ne partent que pour les nouvelles alertes critiques ; les alertes répétées sont regroupées.

En option : contrôle à distance (Cave connectée)

Recevoir des données ne demande rien de plus. Envoyer des ordres à une machine (pause, reprise, lancement d’un cycle, selon ce qu’elle prend en charge) nécessite le module complémentaire Cave connectée, disponible dans Paramètres → Modules avec son prix et un bouton de souscription (certaines offres l’incluent par contrat avec notre équipe commerciale).

• La première fois que vous envoyez une commande à risque moyen ou élevé à une machine, Cepaos vous demande d’accepter l’accord d’utilisation pour cette machine.
• Les commandes à risque élevé ne s’exécutent qu’après l’approbation d’un second administrateur (ou, si la machine a sa fiche équipement avec QR code, après confirmation de la présence physique en le scannant). Les commandes en attente se trouvent dans IoT & Automatisation → Équipements → Contrôle à distance.

En cas de problème

• L’équipement n’a pas de signal : vérifiez l’alimentation et le réseau. S’il est derrière une passerelle, vérifiez d’abord la passerelle.
• L’équipement reçoit une erreur 401 : la clé est incorrecte, a été renouvelée, ou l’équipement a été archivé.
• Erreur 422 ou 400 : le JSON n’a pas le format attendu (eventType manquant ou JSON invalide). Comparez-le avec le message d’exemple de « Pour votre technicien ».
• Erreur 413 : le message dépasse 8 Ko ; envoyez des mesures plus petites.