Energisme permet de mettre en place des connecteurs avec des sources de données télé relevées pour remonter automatiquement ces données.
Plusieurs solutions techniques sont disponibles pour mettre en place de tels interfaçages, et sont disponibles ci-dessous.
FTP / SFTP
La première option est de mettre en place un dépôt de fichiers plats (JSON, CSV ou XML) sur un serveur FTP ou SFTP. Le serveur peut être hébergé par Energisme, ou hébergé par un partenaire.
Les fichiers peuvent être intégrés tous les jours, toutes les heures ou toutes les 10 minutes.
Le pas de temps de données peut descendre jusqu’à 10 minutes.
Dans le cadre ou il est hébergé par un partenaire, il nous faut les informations suivantes pour s’y connecter :
- Host + port ou adresse IP publique
- Login
- Password
Le fichier plat doit contenir les informations suivantes :
- Module : chaque point de données doit être défini par un module unique, qui pourra être réutilisé dans la base de données Energisme
- Timestamp : il doit contenir la date et l’heure, à un format standard. Par ex : AAAA-MM-JJ HH:MM:SS
Le process est le suivant :
- Transmission des informations de connexion au serveur ou demande de création à Energisme
- Transmission d’un exemple de fichier plat pour validation par Energisme
- Mise en place du dépôt automatique sur le serveur
- Priorisation dans les sprints Energisme
- Développements par Energisme
- Tests par Energisme
- Déploiement en production par Energisme
En moyenne, un tel flux prend environ 4 semaines à être déployé.
API
Une API est une interface qui permet à Energisme de se connecter au système du fournisseur de matériel (en général au cloud) pour aller récupérer des données de consommation.
Dans ce cas, c’est donc Energisme qui vient se connecter sur la base de données du fournisseur / prestataire pour récupérer les données.
Exemples de marques qui proposent ce service : WIT, Schneider.
Le process est le suivant :
- Le client demande au prestataire l’activation de l’API si ce n’est pas déjà fait et reçoit des infos de connexion : souvent, 1 ou 2 “clés API” sont transmises + une documentation API (en ligne ou au format PDF)
- Energisme se connecte à l’API et vérifie que toutes les informations
- Energisme développe la récupération automatique des données
- Energisme déploie le flux en production
En moyenne, un tel flux prend environ 4 semaines à être déployé.
PUSH HTTP / HTTPS
Cette méthode permet de récupérer des données de plateformes dédiées aux objets connectés comme les plateformes Objenious, Sigfox, Technilog, LiveObject, Synox et autres ou bien de passerelles de communication, comme les passerelles Multitech, PicoGW, GigaConcept, multitech, et autres.
Elle est donc beaucoup utilisée pour les sondes IOT d’ambiance (température, hygrométrie) par exemple.
Le process est le suivant :
- Le client fournit à Energisme la marque et le modèle du matériel qui doit envoyer des données
- Energisme fournit au client un token + une adresse http de préproduction + un devicetype (propre au matériel) qui permet de générer l’envoi des trames de données dans les environnements de test
Exemple de trame :
curl --location --request POST 'https://iot-datacollect-pprod.energisme.com' \
2--header 'source: generic-sensors' \
3--header 'Content-Type: application/json' \
4--header 'Authorization: Basic token fourni par Energisme \
5--data-raw '{
6 "timestamp": "2019-04-28T12:59:36.599Z",
7 "deviceid": "123124",
8 "payload": "2367A3B3C1DEFE", donnée brute envoyée par le matériel
9 "devicetype": " fourni par Energisme"
10}
- Energisme valide le décodage des données
- Si le décodeur existe déjà, ça va très vite
- Sinon, il faut implémenter le décodeur, ça prend environ 1-2 semaines au total
- Energisme transmet au client le token pour envoyer les données en production
- Le client envoie les données avec le token de production
- Energisme valide le déploiement en production