Pilote MQTT Scholt

L'intégration suivante peut être utilisée pour envoyer des mesures de site via MQTT et recevoir des commandes pour les différents types de dispositifs installés.

Script de démonstration Python

Ce code de test effectue une tâche simple consistant à envoyer en continu des mesures fictives à une installation et à recevoir des commandes :

Veuillez télécharger le fichier ci-dessous dans votre IDE Python préféré. Remplissez votre numéro de série, le filtre de site et les identifiants MQTT, puis exécutez le script :

Prérequis

Contrôleur Cloud

Les sites seront contrôlés via un Contrôleur Cloud. Veuillez contacter Eniris pour configurer un nouveau Contrôleur Cloud.

Configuration du site

Une fois qu'un Contrôleur Cloud a été créé, il contiendra un numéro de série unique (<Controller SN>).

De nouveaux sites peuvent être générés sur le Contrôleur Cloud en utilisant des filtres de site uniques <site_filter>.

Ces deux variables doivent être utilisées dans les sujets et le corps MQTT.

attention

L'utilisation de filtres de site identiques entraînera des erreurs.

Sélection de dispositif

Device Type	Supporté
Onduleurs Solaires	✅
Dispositifs de stockage
Pompes à chaleur
Compteurs de réseau et de consommation
Chargeurs de VE	❌

info

Les dispositifs dans un site ne peuvent pas être modifiés après leur création.

Identifiants MQTT

Eniris fournira les identifiants MQTT. Le nom d'utilisateur MQTT doit être saisi lors de la génération d'un nouveau site.

info

Les identifiants doivent uniquement être fournis une fois. Un ensemble d'identifiants MQTT peut être utilisé pour contrôler tous les sites.

Envoi de mesures

Pour envoyer des mesures au SmartgridOne Controller, le sujet MQTT suivant peut être utilisé pour la publication : standard1/outbound/scholt_meas/<site_filter>/<Controller SN>/

Les champs optionnels sont mentionnés en italique.

Les champs suivants peuvent être envoyés par type de dispositif :

• Stockage

  • mean_soc_perc
  • active_power_W
  • today_charged_Wh
  • today_discharged_Wh
  • energy_stored_Wh

• Solaire

  • active_power_W
  • today_energy_Wh

• Pompes à chaleur

  • operation_modes
    • Les modes de fonctionnement possibles sont off, on
  • active_power_W
    • Égal à la puissance nominale lorsque la pompe à chaleur est on

• Compteurs

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

Le message doit être structuré comme suit :

{
    "time": "<Unix Timestamp>",
    "data": {
        "state": {
            "grid": {
                "active_power_W": <Puissance active du réseau en Watts>,
                "today_imported_energy_Wh": <Énergie importée du réseau en Watt-heures>,
                "today_exported_energy_Wh": <Énergie exportée du réseau en Watt-heures>,
            },
            "meter": {
                "active_power_W": <Puissance active du réseau en Watts>,
                "today_imported_energy_Wh": <Énergie importée du réseau en Watt-heures>,
                "today_exported_energy_Wh": <Énergie exportée du réseau en Watt-heures>,
            },
            "storage": {
                "energy_stored_Wh": <Énergie stockée en Watt-heures>,
                "mean_soc_perc": <Pourcentage moyen de l'état de charge>,
                "active_power_W": <Puissance active en Watts>,
                "today_charged_Wh": <Énergie chargée aujourd'hui en Watt-heures>,
                "today_discharged_Wh": <Énergie déchargée aujourd'hui en Watt-heures>,
            },
            "solar": {
                "active_power_W": <Puissance active solaire en Watts>,
                "today_energy_Wh": <Énergie produite aujourd'hui en Watt-heures>.
            },
            "heat_pump": {
                "active_power_W": <Puissance active de la pompe à chaleur en Watts>,
                "operation_modes": <Mode de fonctionnement de la pompe à chaleur>
            }
        },
        "response_code": <Code de réponse>
    },
    "fields": {},
    "requestTime": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter"
}

Accusé de réception des mesures

Lorsque qu'une mesure a été reçue avec succès, un accusé de réception sera envoyé sur le sujet suivant : standard1/rp_one_s/scholt_ack/<site_filter>/<Controller SN>

Cet accusé de réception peut être utilisé pour :

1. Vérifier que le message de mesure a été reçu avec succès.
2. Vérifier que le message de mesure contenait toutes les données nécessaires.

Réception des commandes

Pour recevoir des commandes du SmartgridOne Controller, abonnez-vous au sujet MQTT suivant : standard1/outbound/scholt_cmd/<site_filter>/<Controller SN>/

La réponse est structurée comme suit :

{
    "extraTags": {
        "nodeId": "<Controller SN>_site_0"
    },
    "time": "<Unix Timestamp>",
    "fields": {
        "solar_policy": "<policy>",
        "solar_power_setpoint_w": 5000,
        "storage_policy": "<policy>",
        "storage_power_setpoint_w": -5000
    }
}

La liste des politiques qui peuvent être reçues se trouve ici : Liste des politiques potentielles