Page 1
DIGIRAIL IoT MODE D'EMPLOI V1.1x A Recommandé pour les appareils dotés d'un micrologiciel à partir de la version V1.1x.
Page 2
PROTOCOLE MODBUS-TCP ....................................24 COMMANDES ......................................24 GATEWAY MODBUS TCP/RTU ................................. 24 TABLEAU DE REGISTRES ..................................24 LOGICIEL DE CONFIGURATION ..................................32 CONFIGURER LE DIGIRAIL IOT AVEC LE NXPERIENCE ........................32 8.1.1 INFORMATIONS GÉNÉRALES DE L'APPAREIL ..........................32 8.1.2 COMMUNICATION ..................................... 33 8.1.3...
Page 3
OBJECTIF ....................................... 49 11.2 BONNES PRATIQUES POUR L’INSTALLATION INDUSTRIELLE ......................49 11.3 RECOMMANDATIONS D'INSTALLATION POUR LES SIGNAUX D'ENTRÉE NUMÉRIQUE DU DIGIRAIL IOT ......... 49 11.3.1 ALIMENTATION ISOLÉE MISE À LA TERRE............................ 49 11.3.2 RÉSISTANCES DE RENFORCEMENT POUR LES CAPTEURS ..................... 50 11.3.3...
Page 4
Les recommandations de sécurité doivent être observées pour assurer la sécurité du personnel et éviter d’endommager l’appareil ou le système. Si l’appareil est utilisé d’une manière autre que celle spécifiée dans ce manuel, ses protections de sécurité peuvent ne pas être efficaces. NOVUS AUTOMATION 4/108...
Page 5
PRÉSENTATION Le DigiRail IoT est l'outil idéal pour la lecture des capteurs qui surveillent l'opération de machines, appareils ou processus. Parmi ses diverses applications, ce module à plusieurs entrées permet, par exemple, de compter les temps d’opération et d'arrêt, de compter les pièces approuvées ou refusées, d'indiquer la nécessité...
Page 6
MAC et le numéro de série, comme indiqué dans la figure ci-dessous : MODÈLES DE L'APPAREIL Le DigiRail IoT est vendu en deux modèles : DigiRail IoT – WRL et DigiRail IoT – ETH, dont les caractéristiques sont décrites sur le Tableau 1 : Interface de...
Page 7
INSTALLATION INSTALLATION MÉCANIQUE Comme le montre la figure ci-dessous, le DigiRail IoT peut être installé sur rail DIN 35 mm. La fixation doit être réalisée à l'aide de ses attaches arrière : De plus, l'appareil dispose aussi de deux trous traversants, qui permettent une fixation au moyen de vis, comme le montre la figure ci-dessous : Le DigiRail IoT a un capot de protection amovible qui protège ses bornes de raccordement.
Page 8
4.1.1 DIMENSIONS Le DigiRail IoT a les dimensions suivantes : Le capot de protection du DigiRail IoT a les dimensions suivantes : NOVUS AUTOMATION 8/108...
Page 9
INSTALLATION ÉLECTRIQUE Le DigiRail IoT a trois bornes de raccordement détachables pour les branchements de la source externe d'alimentation, de la RS485, des entrées et sorties numériques et des entrées analogiques, comme le montre la figure ci-dessous : Pour le branchement des capteurs, il est recommandé de détacher les bornes de l'appareil préalablement et d'observer la numérotation imprimée sur le boîtier de l'appareil, comme le montre la figure des branchements électriques ci-dessus.
Page 10
ENTRÉES NUMÉRIQUES Le DigiRail IoT a des canaux d'entrée numérique pouvant être configurés en tant que « Compteur » ou « Événement ». Quelle que soit la fonction sélectionnée, le type de capteur branché à l'entrée doit être configuré : PNP, NPN ou Contact sec. Puis, il est nécessaire de sélectionner le front d'intérêt du signal numérique pour générer le comptage ou l'événement : front montant, front descendant ou les deux.
Page 11
Le branchement des sorties numériques se fait aux bornes correspondantes, selon la figure ci-dessous : INDICATEURS LED Le DigiRail IoT a trois indicateurs LED, situés dans la partie avant de l'appareil, comme le montre la figure ci-dessous : Le fonctionnement et la description de chaque indicateur sont présentés ci-dessous : SYMBOLE ÉTAT...
Page 12
INTERFACE USB Le DigiRail IoT dispose d'un port USB type C, situé sur le côté du boîtier, destiné de préférence aux tâches de configuration, de surveillance et de diagnostic de l'appareil. Pour brancher l'appareil à un ordinateur de bureau ou à un ordinateur portable, utilisez un câble USB (non fourni).
Page 13
INTERFACE ETHERNET Le DigiRail IoT – ETH dispose d'une interface Ethernet, située auprès des bornes de l'appareil, comme le montre la figure ci-dessous : Si l'interface Ethernet est activée et que l'appareil est connecté à un réseau Ethernet, l'indicateur LED , situé...
Page 14
PROTOCOLE MQTT Le DigiRail IoT est compatible avec le protocole Message Queue Telemetry Transport (MQTT), versions 3.1 et 3.1.1, qui permet la publication de données sur nuage, et prend en charge les Brokers MQTT suivants : Google Cloud, Microsoft Azure, AWS, NOVUS Cloud et Brokers MQTT génériques.
Page 15
Configuration du canal distant 'X' (Disponible : chr1, chr2, chr3, chr4, chr5, chr6, chr7 et chr8). Configuration des paramètres réseau. Wifi Configuration de l'interface Wi-Fi (s'il existe). Configuration du serveur NTP pour le réglage automatique de l’horloge. modbus-tcp Configuration du protocole Modbus-TCP. rs485 Configuration de l'interface RS485. Tableau 7 NOVUS AUTOMATION 15/108...
Page 16
Reported properties après l'exécution de la commande ou de la configuration. Cette étape est appelée « response ». Pour plus d'informations sur l'envoi de paramètres via MQTT au DigiRail IoT, consultez ANNEXE 3 – PROTOCOLE MQTT.
Page 17
La valeur « 0 », à son tour, indique que le compteur ne doit pas être modifié. Dans ce cas, il est également possible d'omettre simplement le canal du JSON. REQUEST RESET COUNTERS : "timestamp":1585819219, "desired": { "reset_counters" "reset_chd2":1, "reset_chd4":1 RESPONSE RESET COUNTERS : "pid": 51387408, "device_id": "device0", "timestamp":1585819219, "reported" "reset_counters": { "error": 0, NOVUS AUTOMATION 17/108...
Page 18
Dans cet exemple, les canaux numériques 1, 4, 5 et 6 n'apparaissent pas sur le JSON desired, car on ne veut pas modifier leurs • compteurs. La valeur actuelle du canal numérique sera renvoyée dans la réponse. Pour les canaux numériques 1, 4, 5 et 6, on prend en compte que la valeur actuelle est zéro. NOVUS AUTOMATION 18/108...
Page 19
CONFIGURATION) est activé, les compteurs d’occurrences des événements du système seront aussi ajoutés à la réponse : "pid_id":51387408, "device_id":"device0", "timestamp":1585819219, "reported":{ "diag":{ "error":0, "title":"Pci v2", "location":" home ", "curr_timestamp":1589326517, "cfg_timestamp":1589311676, "fw_v":"1.23", "mqtt_queue":1, "sn":"00000001", "curr_rssi":"55", "min_rssi":"45", "max_rssi":"70", "avg_rssi":"55", "ipv4":[ 192, 168, "log_counters":{ "pwr_on":1, "pwr_sw_reset":0, "net_disconnected":1, "wifi_prov_error":0, "dhcp_error":0, NOVUS AUTOMATION 19/108...
Page 20
à une rubrique pour publier des confirmations (réponses des appareils esclaves). Pour envoyer des commandes à distance, il est nécessaire de connecter autre client MQTT au Broker auquel le DigiRail IoT est connecté et, par la suite, de s'abonner à la rubrique configurée pour confirmer les commandes. La commande doit ensuite être publiée sur la rubrique configurée dans DigiRail IoT pour recevoir des commandes.
Page 21
Puis, la réponse reçue via l'interface série RS485 sera publiée par DigiRail IoT dans la rubrique affectée à la confirmation des commandes, suivant le format : "pid": XXX, "device_id":XX, "timestamp":XXXX, "reported": { "gateway_485": {"error":0; "mb_buffer":"octets reçus en réponse à la commande envoyée"}...
Page 22
Cependant, au lieu d’indiquer un ID, elle présentera une brève description du journal, en plus de l’horodatage du moment de l’occurrence, ainsi comme dans la commande de logs. Il est possible de consulter une description détaillée des journaux dans le Tableau 8. REQUEST LOGS_PARSED “timestamp”:1585819219, “desired”: { “logs_parsed”: {} RESPONSE LOGS_PARSED "pid": 51387408 "device_id":"digirail_iot", "timestamp":1585819219, "reported":{ "logs_parsed":{ NOVUS AUTOMATION 22/108...
Page 23
Erreur lors du démarrage de la mémoire circulaire. L'appareil est rétabli. not_init Mémoire circulaire non démarrée. read_error Erreur lors de la lecture de la mémoire circulaire. updated Configuration de l'appareil mise à jour. updated Firmware de l'appareil mis à jour. Tableau 9 NOVUS AUTOMATION 23/108...
Page 24
PROTOCOLE MODBUS-TCP Le DigiRail IoT est compatible avec le protocole Modbus-TCP, un protocole de communication de données utilisé pour connecter l’appareil à des systèmes de contrôle et d'acquisition de données (SCADA). Il prend en charge jusqu’à 3 connexions simultanées et permet à jusqu’à 3 clients (maîtres) Modbus-TCP de le surveiller en même temps.
Page 25
0 Pas configuré ; HR_CHD1_STATUS 1 Configuration correcte ; 2 Configuration avec erreur. HR_CHD1_VALUE_HIGH 65535 Valeur du compteur en 32 bits. HR_CHD1_VALUE_LOW 65535 HR_CHD1_TIME_STAMP_LAST_HIGH 0x0000 0xFFFF Horodatage du dernier événement. 32bits. Format Unix. HR_CHD1_TIME_STAMP_LAST_LOW 0x0000 0xFFFF Réservé. NOVUS AUTOMATION 25/108...
Page 26
Valeur dans l'unité de mesure (mA ou V). Format Float 32 bits. HR_CH1_MV_MA_VALUE_L 0x0000 0xFFFF HR_CH1_SENSE_USER_RANGE_H 0x0000 0xFFFF Valeur dans la plage de l'utilisateur. Format Float 32 bits. Remarque : cette valeur est la même de la publication sur le nuage. HR_CH1_SENSE_USER_RANGE_L 0x0000 0xFFFF NOVUS AUTOMATION 26/108...
Page 28
1 Événement de front descendant du canal numérique ; 2 Événement de front montant du canal numérique. HR_SS_COLLECT_CHD1_VALUE_H 65535 Valeur du canal numérique 1 dans la collecte demandée. HR_SS_COLLECT_CHD1_VALUE_L 65535 HR_SS_COLLECT_CHD2_VALUE_H Valeur du canal numérique 2 dans la collecte demandée. 65535 NOVUS AUTOMATION 28/108...
Page 29
Valeur du canal distant 1 au format Double 64 bits. 0x0000 0xFFFF La disposition des données Double 64 bits dans les 4 enregistreurs HR_SS_CH_REMOTE_01_DOUBLE_HL 0x0000 0xFFFF Modbus suit d'abord la partie haute. HR_SS_CH_REMOTE_01_DOUBLE_LH 0x0000 0xFFFF HR_SS_CH_REMOTE_01_DOUBLE_LL 0x0000 0xFFFF Réservé. HR_SS_CHR2_STATUS État du canal distant 2. NOVUS AUTOMATION 29/108...
Page 30
Informe la valeur de la dernière lecture du canal distant 6. 0x0000 0xFFFF HR_SS_CH_REMOTE_06_VALUE_HL 0x0000 0xFFFF HR_SS_CH_REMOTE_06_VALUE_LH 0x0000 0xFFFF HR_SS_CH_REMOTE_06_VALUE_LL 0x0000 0xFFFF HR_SS_CH_REMOTE_06_DOUBLE_HH Valeur du canal distant 6 au format Double 64 bits. 0x0000 0xFFFF HR_SS_CH_REMOTE_06_DOUBLE_HL 0x0000 0xFFFF HR_SS_CH_REMOTE_06_DOUBLE_LH 0x0000 0xFFFF NOVUS AUTOMATION 30/108...
Page 31
Informe la valeur de la dernière lecture du canal distant 8. 0x0000 0xFFFF HR_SS_CH_REMOTE_08_VALUE_HL 0x0000 0xFFFF HR_SS_CH_REMOTE_08_VALUE_LH 0x0000 0xFFFF HR_SS_CH_REMOTE_08_VALUE_LL 0x0000 0xFFFF HR_SS_CH_REMOTE_08_DOUBLE_HH Valeur du canal distant 8 au format Double 64 bits. 0x0000 0xFFFF HR_SS_CH_REMOTE_08_DOUBLE_HL 0x0000 0xFFFF HR_SS_CH_REMOTE_08_DOUBLE_LH 0x0000 0xFFFF HR_SS_CH_REMOTE_08_DOUBLE_LL 0x0000 0xFFFF Tableau 10 NOVUS AUTOMATION 31/108...
Page 32
LOGICIEL DE CONFIGURATION Le logiciel NXperience est le principal outil de configuration et de diagnostic pour le DigiRail IoT. Il permet d'explorer toutes les fonctionnalités de l'appareil en communiquant via son interface USB ou via Modbus-TCP. Cependant, il est important de noter que le NXperience n'est pas un système de supervision et ne dispose pas de la fonctionnalité...
Page 33
Cet onglet est spécifique au modèle DigiRail IoT – ETH. Modèle Ethernet Obtenir l'adresse : il permet de définir la manière dont le DigiRail IoT – ETH tentera d'obtenir une adresse IP : • o DHCP (Dynamic Host Configuration Protocol) : protocole qui permet au serveur du réseau d'attribuer l'IP (Internet Protocol) de l'appareil.
Page 34
32 caractères alphanumériques. o Mot de passe du point d'accès : il permet de saisir le mot de passe du réseau Wi-Fi auquel le DigiRail IoT – WRL tentera de se connecter. Le champ permet jusqu'à 42 caractères alphanumériques.
Page 35
Nuage : il permet de sélectionner la plateforme à utiliser lors de la connexion avec le Broker MQTT : plateforme générique, Google Cloud, • Amazon AWS, Microsoft Azure ou NOVUS Cloud. En fonction de l'option choisie, les autres paramètres seront ajustés pour répondre aux exigences spécifiques de la plateforme. Pour personnaliser tous les paramètres, sélectionnez l'option « Général », concernant la plateforme générique.
Page 36
Lire le certificat par Modbus-TCP : une fois activé, il permet au NXperience de lire les certificats via l’interface Modbus-TCP. • Publier diagnostic périodiquement : lorsque ce paramètre est activé, le DigiRail IoT publiera périodiquement le diagnostic sur la rubrique de •...
Page 37
Limite supérieure : il permet de définir une valeur maximale pour le capteur choisi. • Valeur d'erreur : il permet de définir la valeur d'erreur à considérer pour l'affichage lorsqu'une erreur est détectée dans la lecture du capteur. • NOVUS AUTOMATION 37/108...
Page 38
AJOUTER COMPTAGE DANS LES CANAUX CONFIGURÉS COMME ÉVÉNEMENTS Lorsque le canal numérique est configuré comme « Événement », il permet d’ajouter la valeur de comptage dans la mémoire circulaire et dans la publication MQTT. NOVUS AUTOMATION 38/108...
Page 39
Ce paramètre doit être appliqué chaque fois qu’il est nécessaire d’ajuster l’ordre (endianness) des octets de données. Exemple : lorsque vous activez l’inversion de 8 bits d’une valeur hexadécimale lue du périphérique esclave 0x1234, il sera enregistré dans DigiRail IoT comme 0x3412 8.1.4 ENREGISTREMENT DE DONNÉES...
Page 40
SCHEMA Cette section fournit des informations sur l'installation et les connexions électriques de l'appareil. DIAGNOSTIC Pour visualiser l'onglet de diagnostics du DigiRail IoT, cliquez sur le bouton Diagnostics, situé sur l'écran d'accueil du NXperience. 8.2.1 INFORMATIONS Nom de l'appareil : il affiche l'identifiant configuré pour l'appareil.
Page 41
Valeur en unité d'ingénierie : il affiche la valeur mesurée par le canal en V ou mA, selon le type de canal configuré. • 8.2.3 SORTIES Cette section permet de forcer les sorties 1 et 2 dans un état actif ou inactif à l'aide du bouton Allumer, en plus d'afficher l'état actuel de chaque sortie. NOVUS AUTOMATION 41/108...
Page 42
8.2.4 CONECTIVITÉ ETHERNET Cette section présente les paramètres concernant le modèle de l'appareil : DigiRail IoT – ETH ou DigiRail IoT – WRL. Qualité du signal Wi-Fi : il affiche la qualité du signal Wi-Fi en pourcentage. • Connexion passerelle : il affiche des informations sur l'état actuel de la connexion avec la passerelle.
Page 43
ÉVÉNEMENTS DU SYSTÈME Cette section permet de visualiser les événements du système. De plus, il est possible d’émettre un rapport avec l’extension .CSV contenant le journal des événements et un comptage du nombre d’occurrences de chaque événement. NOVUS AUTOMATION 43/108...
Page 44
Interface USB 2.0 type C ; • Modèle Interface Ethernet 10/100 Mbps en connecteur RJ45 ; • DigiRail IoT – ETH Interface de communication RS485 avec protocole Modbus RTU en • mode passerelle. Interface USB 2.0 type C ; •...
Page 45
CARACTÉRISTIQUES DIGIRAIL IoT Humidité : 5 à 95 % HR, sans condensation. Boîtier ABS+PC. Indice de protection IP20. ANATEL (09260-20-07089), CE, FCC ; Compatible avec CEI 60068-2-6 (2007) ; Certifications Contient FCC ID : 2ADHKATWINC1500 ; Contient IC : 20266-WINC1500PB.
Page 46
CONNECTIVITÉ SANS FIL Le DigiRail IoT WRL dispose d'un module de connectivité sans fil intégré pour la communication avec les réseaux Wi-Fi 2,4 GHz 802.11 b/g/n. Le module de connectivité Wi-Fi utilisé est l'ATWINC1500-MR210PB du fabricant Microchip, qui fournit une connectivité de données via Wi-Fi.
Page 47
être démontrée conformément à la procédure ISED SAR. ESSAIS DE VIBRATION Cet appareil est conforme aux essais de vibration du profil décrit dans la norme CEI 60068-2-6 (2007) – Environmental Testing – Part 2 : Tests – Test Fc : Vibration (Sinusoidal). NOVUS AUTOMATION 47/108...
Page 48
GARANTIE Les conditions de garantie se trouvent sur notre site Web www.novusautomation.fr/garantie. NOVUS AUTOMATION 48/108...
Page 49
ALIMENTATION ISOLÉE MISE À LA TERRE La figure ci-dessous illustre comment connecter une alimentation au DigiRail IoT, un capteur type Contact sec au canal numérique 1, un capteur type NPN au canal numérique 2 et un capteur type PNP au canal numérique 3. Dans ce cas, on illustre également que la source d’alimentation doit être mise à...
Page 50
¼ W. Cela s’appelle la résistance de rappel (pull-down). Cette technique est utilisée pour renfoncer le signal du capteur lorsqu’il est ouvert. Les résistances de tirage et de rappel peuvent être connectées soit auprès de l'appareil, soit auprès des capteurs, afin de faciliter l'installation. La figure ci-dessous illustre comment connecter chacun de ces capteurs. NOVUS AUTOMATION 50/108...
Page 51
Une bonne pratique d'installation qui évite d'éventuels problèmes de lecture des capteurs consiste à utiliser des conduits mis à la terre entre l’appareil et les capteurs. La figure ci-dessous illustre comment utiliser un conduit électrique mis à la terre pour le chemin où les signaux des capteurs traversent l’installation. NOVUS AUTOMATION 51/108...
Page 52
12.1 INTRODUCTION Le DigiRail IoT est compatible avec le protocole Modbus-TCP, un protocole de communication de données utilisé pour connecter l’appareil à des systèmes de contrôle et d'acquisition de données (SCADA). Il prend en charge jusqu’à 3 connexions simultanées et permet à jusqu’à 3 clients (maîtres) Modbus-TCP de le surveiller en même temps.
Page 53
2 Configuration avec erreur. HR_CHD1_VALUE_HIGH 65535 Mode compteur : valeur du compteur en 32 bits. Mode événement : niveau logique de l'entrée. HR_CHD1_VALUE_LOW 65535 HR_CHD1_TIME_STAMP_LAST_ 0x0000 0xFFFF HIGH Horodatage du dernier événement. 32 bits. Format Unix. HR_CHD1_TIME_STAMP_LAST_ 0x0000 0xFFFF NOVUS AUTOMATION 53/108...
Page 54
2 Configuration avec erreur. HR_CHD6_VALUE_HIGH 65535 Mode compteur : valeur du compteur en 32 bits. Mode événement : niveau logique de l'entrée. HR_CHD6_VALUE_LOW 65535 HR_CHD6_TIME_STAMP_LAST_ 0x0000 0xFFFF HIGH Horodatage du dernier événement. 32 bits. Format Unix. HR_CHD6_TIME_STAMP_LAST_ 0x0000 0xFFFF Réservé. NOVUS AUTOMATION 54/108...
Page 55
Dec 0 . Dec 1 . Dec 2 . Dec 3 HR_LAN_GATEWAY_ADDR_2_3 65535 HR_LAN_DNS_ADDR_0_1 65535 IP du serveur de DNS. Deux octets par registre. Dec 0 . Dec 1 . Dec 2 . Dec 3 HR_LAN_DNS_ADDR_2_3 65535 NOVUS AUTOMATION 55/108...
Page 56
HR_SS_COLLECT_LAST_RECORD 7096 mémoire. HR_SS_COLLECT_FIRST_ Position de la première collecte ajoutée à la 7096 mémoire. RECORD HR_SS_COLLECT_REQUESTED_ Position de la collecte demandée pour la lecture. 7096 RECORD HR_SS_COLLECT_TIMESTAMP_ Horodatage de la collecte demandée en format 65535 Unix. UNIX_H NOVUS AUTOMATION 56/108...
Page 57
HR_WIFI_RSSI. Il est possible de remettre la HR_SS_WIFI_RSSI_MAX -120 valeur à zéro à l’aide registre HR_RESET_DIAG_RSSI. Valeur moyenne indiquée par le registre HR_WIFI_RSSI. Il est possible de remettre la HR_SS_WIFI_RSSI_AVERAGE -120 valeur à zéro à l’aide registre HR_RESET_DIAG_RSSI. Réservé. NOVUS AUTOMATION 57/108...
Page 58
0xFFFF HR_SS_CH_REMOTE_02_DOUBLE 0x0000 0xFFFF HR_SS_CH_REMOTE_02_DOUBLE 0x0000 0xFFFF Réservé. État du canal distant 3. HR_SS_CHR3_STATUS HR_SS_CH_REMOTE_03_VALUE_ Informe la valeur de la dernière lecture du canal 0x0000 0xFFFF distant 3. HR_SS_CH_REMOTE_03_VALUE_ 0x0000 0xFFFF HR_SS_CH_REMOTE_03_VALUE_ 0x0000 0xFFFF HR_SS_CH_REMOTE_03_VALUE_ 0x0000 0xFFFF NOVUS AUTOMATION 58/108...
Page 59
0x0000 0xFFFF HR_SS_CH_REMOTE_06_VALUE_ 0x0000 0xFFFF HR_SS_CH_REMOTE_06_VALUE_ 0x0000 0xFFFF HR_SS_CH_REMOTE_06_DOUBLE Valeur du canal distant 6 au format Double 64 0x0000 0xFFFF bits. HR_SS_CH_REMOTE_06_DOUBLE 0x0000 0xFFFF HR_SS_CH_REMOTE_06_DOUBLE 0x0000 0xFFFF HR_SS_CH_REMOTE_06_DOUBLE 0x0000 0xFFFF Réservé. Statut du canal distant 7. HR_SS_CHR7_STATUS NOVUS AUTOMATION 59/108...
Page 60
0x0000 0xFFFF HR_SS_CH_REMOTE_08_DOUBLE 0x0000 0xFFFF Tableau 16 12.2.3 TABLEAU DE REGISTRES DE CONFIGURATION Le DigiRail IoT prend en charge les registres de configuration suivants : REGISTRE DESCRIPTION VALEUR MINIMUM VALEUR MAXIMUM TYPE ADRESSE HR_CS_SETTING_RESTORE_ Il permet de remettre tous les paramètres de 1000 configuration aux valeurs par défaut.
Page 61
Il permet de définir l’heure de mise à zéro des 1049 HR_CS_CHD_RESET_HOUR compteurs numériques selon la configuration du registre 1060. Il permet de définir la minute de mise à zéro des compteurs numériques selon la configuration du 1050 HR_CS_CHD_RESET_MINUTE registre 1060. NOVUS AUTOMATION 61/108...
Page 62
Bit 0 Overflow ; 1074 HR_CS_CHD2_RESET_MODE Bit 1 Calendrier ; 2 Protocole. HR_CS_CHD2_DEBOUNCE_ Il permet d’activer le Debounce pour le canal 1075 numérique 2. ENABLE 1076 HR_CS_CHD2_CHANGE_VALUE_ Il permet d’activer la permission pour modifier la NOVUS AUTOMATION 62/108...
Page 63
HR_CS_CHD4_DEBOUNCE_ Il permet d’activer le Debounce pour le canal 1103 numérique 4. ENABLE Il permet d’activer la permission pour modifier la HR_CS_CHD4_CHANGE_VALUE_ 1104 valeur de comptage du canal numérique 4 via les ENABLE protocoles Modbus-TCP ou MQTT. NOVUS AUTOMATION 63/108...
Page 64
6. ENABLE Il permet d’activer la permission pour modifier la HR_CS_CHD6_CHANGE_VALUE_ 1132 valeur de comptage du canal numérique 6 via les ENABLE protocoles Modbus-TCP ou MQTT. Réservé. 1138 HR_CS_CH1_ENABLE Il permet d’activer le canal analogique 1. NOVUS AUTOMATION 64/108...
Page 65
à la RS485, en agissant comme passerelle. Il permet de définir la Baud Rate (vitesse de transmission) de l’interface RS485 : 0 1200 ; 1175 HR_CS_RS485_BAUD_RATE, 1 2400 ; 2 4800 ; 3 9600 ; NOVUS AUTOMATION 65/108...
Page 66
0_1 : 2_3 : 4_5 : 6_7 : 8_9 : 10_11 : 12_13 HR_CS_ETH_IPV6_DNS_ADDR_8_ 1203 65535 : 14_15 HR_CS_ETH_IPV6_DNS_ADDR_10 1204 65535 _11, HR_CS_ETH_IPV6_DNS_ADDR_12 1205 65535 _13, HR_CS_ETH_IPV6_DNS_ADDR_14 1206 65535 _15, 1207 HR_CS_WIFI_ROUTER_TITLE_1 0x0000 0xFFFF Il permet de définir le SSID du réseau Wi-Fi. NOVUS AUTOMATION 66/108...
Page 76
1553 HR_CS_SNTP_SERVER_ENABLE Il permet d’activer le serveur NTP. Il permet de définir la différence minimale entre 1554 HR_CS_SNTP_SERVER_MIN_DIFF l’horloge du DigiRail IoT et l’information reçue via 0xFFFF serveur NTP pour la mise à jour (en secondes). 1555 HR_CS_SNTP_SERVER_IP_URL_1 0x0000 0xFFFF...
Page 77
1 16 bits avec signal (Signed) ; HR_CS_MODBUS_MASTER_CH1_ 1635 2 32 bits sans signal (Unsigned) ; DATA_TYPE 3 32 bits avec signal (Signed) ; 4 64 bits sans signal (Unsigned) ; 5 64 bits avec signal (Signed) ; NOVUS AUTOMATION 77/108...
Page 78
16 bits de lecture de données. 1653 0x0000 0xFFFF ERROR_PART_LH Enregistreurs _LH et _LL haut et bas de la valeur HR_CS_MODBUS_MASTER_CH2_ d’erreur lorsque le canal est configuré sur 32 bits. 1654 0x0000 0xFFFF ERROR_PART_LL Les enregistreurs _HH à _LL correspondent à la NOVUS AUTOMATION 78/108...
Page 79
0 16 bits sans signal (Unsigned) ; 1 16 bits avec signal (Signed) ; HR_CS_MODBUS_MASTER_CH4_ 1674 DATA_TYPE 2 32 bits sans signal (Unsigned) ; 3 32 bits avec signal (Signed) ; 4 64 bits sans signal (Unsigned) ; NOVUS AUTOMATION 79/108...
Page 80
HR_CS_MODBUS_MASTER_CH5_ 16 bits de lecture de données. 1692 0x0000 0xFFFF ERROR_PART_LH Enregistreurs _LH et _LL haut et bas de la valeur 1693 d’erreur lorsque le canal est configuré sur 32 bits. 0x0000 0xFFFF HR_CS_MODBUS_MASTER_CH5_ NOVUS AUTOMATION 80/108...
Page 81
1 16 bits avec signal (Signed) ; HR_CS_MODBUS_MASTER_CH7_ 1713 2 32 bits sans signal (Unsigned) ; DATA_TYPE 3 32 bits avec signal (Signed) ; 4 64 bits sans signal (Unsigned) ; 5 64 bits avec signal (Signed) ; NOVUS AUTOMATION 81/108...
Page 82
Enregistreurs _LH et _LL haut et bas de la valeur d’erreur lorsque le canal est configuré sur 32 bits. HR_CS_MODBUS_MASTER_CH8_ 1732 0x0000 0xFFFF Les enregistreurs _HH à _LL correspondent à la ERROR_PART_LL valeur d’erreur 64 bits lorsque le canal est NOVUS AUTOMATION 82/108...
Page 85
12.3 ACCÈS À LA MÉMOIRE CIRCULAIRE Le DigiRail IoT dispose d’une mémoire circulaire pour enregistrer des événements et des collectes périodiques. Dans les collectes périodiques, les données relatives à tous les canaux actifs sont enregistrées. Dans le mode Événement, par contre, seules les données concernant l’événement qui a produit l’enregistrement seront sauvegardées.
Page 87
// requests a record by writing the index through a modbus register FncWriteSingleRegisterModbus(ADDR_REQUESTED_RECORD, nextIndex); // collects record data from requested index FncReadBufferModbus(buf, ADDR_TIMESTAMP_UNIX_HIGH, COLLECTED_DATA_SIZE); // after app uses the record, should update the index (FncUseColletedData(buf) == FNC_SUCCESS) NOVUS AUTOMATION 87/108...
Page 88
EXEMPLES DE MÉMOIRE CIRCULAIRE EXEMPLE 1 Dans cet exemple, il n'y a pas encore d’enregistrements suffisants pour faire circuler la mémoire : EXEMPLE 2 Dans cet exemple, les nouveaux enregistrements ont déjà fait circuler la mémoire : NOVUS AUTOMATION 88/108...
Page 89
EXEMPLE 3 Dans cet exemple, les enregistrements avancent sur la mémoire déjà en circulation : 12.3.5 EXEMPLE DE COLLECTES EXEMPLE 4 Événement montant dans le canal numérique 2 : NOVUS AUTOMATION 89/108...
Page 90
EXEMPLE 5 Enregistrement périodique avec les canaux numériques 3 et 6 désactivés, aussi que le canal analogique 1 : NOVUS AUTOMATION 90/108...
Page 91
13.1 INTRODUCTION Ce document décrit l'infrastructure requise, les données publiées et le modèle de fonctionnement du DigiRail IoT pour publier des données sur un nuage à l’aide du protocole MQTT. L’appareil prend en charge l'ensemble de Brokers MQTT suivant : Google IoT ;...
Page 92
JSON et ont les paires clé/valeur suivants : "pid": 51387408, "device_id": "device0", "events": { "chd1": { "timestamp":1585819219.685, "edge":1, Remarque : La valeur de timestamp est aussi en UTC, mais en format double, avec les millisecondes de l'événement dans la partie fractionnaire. • NOVUS AUTOMATION 92/108...
Page 93
Lorsqu’il y a des exceptions, elles seront indiquées dans chacun des éléments de configuration ci-dessous. NOVUS AUTOMATION 93/108...
Page 94
La publication de request de configuration peut avoir plusieurs empty desired item, un pour chaque élément qu’on veut consulter. La structure de données des reported item est la même utilisée dans les response de modification de paramètres. Si l’élément consulté existe, la valeur d’error indiquera que l’opération a été réalisée avec succès. NOVUS AUTOMATION 94/108...
Page 96
L’exemple de cette section ne présente que le canal analogique 1, appelé ch1. L’autre canal (ch2) suit le même modèle de données. REQUEST ANALOG CHANNELS RESPONSE ANALOG CHANNELS "timestamp":1585819219, "pid": 51387408, "desired": { "device_id": "device0", "ch1" "timestamp":1585819219, "enable":1, "reported": { "sensor_type":1, "ch1" "range_min":-10, "error": 0, "range_max":2020, "enable":1, "decimal_point":2 "sensor_type":1, "range_min":-10, "range_max":2020, "decimal_point":2 Tableau 32 NOVUS AUTOMATION 96/108...
Page 97
Tableau 34 WI-FI REQUEST ETHERNET RESPONSE ETHERNET "timestamp":1585819219, "pid": 51387408, "desired": { "device_id": "device0", "wifi" "timestamp":1585819219, "ssid":"WifiName", "reported": { "pwd":"password" "wifi" "error": 0, "ssid":"WifiName" Tableau 35 Remarque : La clé pwd n’est pas transmise dans la response. • NOVUS AUTOMATION 97/108...
Page 98
"timestamp":1585819219, "baudrate":6, "reported": { "stopbits":1, "rs485" "parity":1, "error": 0, "timeout":500, "baudrate":6, "oper_mode":1, "stopbits":1, "addr_rtu":1, "parity":1, "num_read":1, "timeout":500, "int_read":100 "oper_mode":1, "addr_rtu":1, "num_read":1, "int_read":100 Tableau 38 Remarque : Les clés timeout et int_read ont une valeur en millisecondes. • NOVUS AUTOMATION 98/108...
Page 99
Les clés reset_chdX (avec X de 1 à 6) peuvent prendre les • valeurs 0 ou 1. Lorsque la valeur est 1, le compteur sera réinitialisé. La valeur 0 indique que le compteur ne doit pas être modifié. NOVUS AUTOMATION 99/108...
Page 100
RS485 sont contenus dans mb_buffer. La valeur d’error est un entier et elle indique l’erreur trouvée • Lors de l’occurrence de timeout de l’appareil adressé dans lors de l'exécution de la commande. • l’interface RS485, le mb_buffer retourne vide. NOVUS AUTOMATION 100/108...
Page 101
CONFIGURATION) est activé, les compteurs d’occurrences des événements du système seront aussi ajoutés à la réponse : "pid":51387408, "device_id":"digirail_iot", "timestamp":1585819219, "reported":{ "diag":{ "error":0, "title":"Pci v2", "location":" home ", "curr_timestamp":1589326517, "cfg_timestamp":1589311676, "fw_v":"1.23", "mqtt_queue":1, "sn":"00000001", "curr_rssi":"55", "min_rssi":"45", "max_rssi":"70", "avg_rssi":"55", "ipv4":[ 192, 168, "log_counters":{ "pwr_on":1, "pwr_sw_reset":0, "net_disconnected":1, "wifi_prov_error":0, "dhcp_error":0, "dns_error_1":0, "dns_error_2":0, "cfg_updated":1, "fw_updated":0 "watchdog_counters":{ "analog":"0", NOVUS AUTOMATION 101/108...
Page 102
La commande logs retourne les 50 derniers événements du journal du système. Tous les événements ont un ID, qui peut être consulté par cette commande, et un horodatage du moment de l’occurrence. REQUEST LOGS RESPONSE LOGS "timestamp":1585819219, "pid":51387408, "desired": { "device_id":"digirail_iot", "logs": {} "timestamp":1585819219, "reported":{ "logs":{ "error":0, "events":[ "ts":1638193059, "id":9 "ts":1638193055, "id":10 NOVUS AUTOMATION 102/108...
Page 103
Cependant, au lieu d’indiquer un ID, elle présentera une brève description du journal, en plus de l’horodatage du moment de l’occurrence, ainsi comme dans la commande de logs. REQUEST LOGS_PARSED RESPONSE LOGS_PARSED "timestamp":1585819219, "device_id":"digirail_iot", "desired": { "timestamp":1585819219, "logs_parsed": {} "reported":{ "logs_parsed":{ "error":0, "events":[ "ts":1638193059, "mqtt":"connected" "ts":1638193055, "mqtt":"disconnected" "ts":1638192333, "mqtt":"connected" "ts":1636468024, "net":"connected" Tableau 46 NOVUS AUTOMATION 103/108...
Page 104
Les rubriques utilisées par l’appareil seront configurées selon le type de nuage sélectionné. Les rubriques seront exclusives à un appareil, identifié par la variable {id}. Cette variable est fournie lors du processus de configuration. 13.6.1 VARIABLE RUBRIQUE Device data NOVUS/{id}/events Config NOVUS/{id}/config Config Ack NOVUS/{id}/ack/config Command NOVUS/{id}/command Command Ack NOVUS/{id}/ack/command Tableau 48 NOVUS AUTOMATION 104/108...
Page 106
COUNTERS RESET Il permet de définir l’heure pour mettre à zéro le hour compteur. Il permet de définir la minute pour mettre à zéro le minute compteur. Il permet de définir la seconde pour mettre à zéro le NOVUS AUTOMATION 106/108...
Page 107
3 Mode esclave. Il permet de configurer l'adresse de l'appareil sur le addr_rtu réseau Modbus-RTU (lors du fonctionnement en mode esclave). Nombre de tentatives de lecture des appareils esclaves num_read 65535 (lors du fonctionnement en mode maître). NOVUS AUTOMATION 107/108...
Page 108
à zéro des accumulateurs du canal numérique 1 : Bit 0 Overflow ; reset_m Bit 1 Calendrier ; Bit 2 Protocole. Il p debounce_enable ermet d’activer le Debounce pour le canal configuré. Tableau 53 NOVUS AUTOMATION 108/108...