Comment configurer votre Datastream MQTT ? – Portail d'assistance Wattsense

parcourir

Voici un article sur la façon de configurer votre Datastream MQTT.

Un Datastream MQTT est une communication MQTT entre notre backend Wattsense et votre broker MQTT basé sur le Cloud.

Disponible uniquement avec un abonnement Tower, lorsque notre backend recevra soit une valeur, un événement ou une alarme de la Tower, il sera automatiquement envoyé à votre broker MQTT.

Architecture Datastream MQTT

Article.HowToConfigureDataStreamMQTT.Schema.png

Conditions requises pour configurer un DataStream MQTT

Pour configurer correctement la communication MQTT, il est nécessaire d'obtenir les informations imporantes des paramètres de votre broker, que Wattsense ne fournit pas. Ces informations permettront à notre backend de se connecter à votre broker MQTT, qui peut être AWS, Azure, IBM ou un broker personnalisé.

Broker URL	l'URL du broker suivi de ":" et port de communication MQTT.
Topic	Nom du Topic pour chaque flux : Evènements / Alarmes / Valeurs
Client ID	Doit être unique, vous aidera à identifier le requester de connexion
Quality of Service / Qualité de service	Niveau QoS 0 : « Au plus une fois » - Le message est envoyé sans accusé de réception QoS niveau 1 : « Au moins une fois » - Le message est envoyé avec accusé de réception QoS niveau 2 : « Exactement une fois » - Le message est envoyé avec accusé de réception (éviter le mécanisme de duplication de message)
Type de Broker	Nous vous laisserons choisir entre ces types de broker
Certificats	Nous vous laisserons la possibilité d'ajouter des certificats si votre courtier MQTT l'exige.
Authentification	Authentification de base (avec nom d'utilisateur/mot de passe) Pas d'authentification

Configuration étape par étape

Configuration du connecteur

Tout d'abord, cliquez sur l'onglet "Organisation", sélectionnez l'organisation dans laquelle vous souhaitez créer votre datastream MQTT et cliquez sur "Ajouter un connecteur".

Article.HowToConfigureDataStreamMQTT.AddAConnector.FR.png

Nommez votre MQTT myMqttDataStream et remplissez les champs en fonction des paramètres de votre broker :

Article.HowToConfigureDataStreamMQTT.AddAConnectorDetails.FR.png

Configuration des triggers

Une fois la configuration de la communication effectuée, vous devrez créer les Triggers :

Article.HowToConfigureDataStreamMQTTCreateYourTrigger.FR.png

Les triggers définissent ce qui est requis pour appeler le connecteur et quelles valeurs envoyer.

Lorsque vous cliquerez sur le bouton « Créer votre premier trigger », voici l'interface que vous devrez remplir :

Article.HowToConfigureDataStreamMQTT.AddATriggerValue.FR.png

- Sélectionnez le type de trigger que vous souhaitez recevoir dans votre broker MQTT.

- Ajoutez la ou les Tower dans la liste dans le périmètre du trigger. (Notez que vous ne verrez que les Towers de l'organisation courante, pas d'une autre)

Activer le DataStream

A la fin de la configuration, n'oubliez pas d'activer le datastream en activant le toggle button

Article.HowToConfigureDataStreamMQTT.Activate.FR.png

Format des données

Les données sont envoyées avec la structure suivante :

deviceId: String,
property: String,
timestamp: Long,
payload: Any,
receivedAt: Long?
scaledPayload: Number?
name: String?
unit: String?
externalId: String?
propertyId: String?
equipmentId: String?
gatewayInterfaceId: String?
slug: String?
isOutOfService: Boolean?
tags: Map<String, String>

Le ? à la fin de la ligne signifie que le champ peut être nul.

Voici un exemple :

Article.DataStreams.ExempleData.png

Si vous avez besoin d'informations supplémentaires, veuillez nous contacter ici.