Logiciel pour les cartes Fils Pilotes Wifi de type Remora
Switch branches/tags
Clone or download
Latest commit c537ea3 Aug 30, 2018
Permalink
Failed to load latest commit information.
data Correction d'erreur d'ID dans la page HTML Aug 13, 2018
webdev Security Fix Aug 30, 2018
.gitignore Ajout dossier webdev May 13, 2016
LibGFX.cpp Creation Dec 2, 2015
LibGFX.h Creation Dec 2, 2015
LibHardwareSerial.h Creation Dec 2, 2015
LibLibTeleinfo.cpp plusieurs modifs Jul 25, 2016
LibLibTeleinfo.h Suppression du debug de la lib téléinfo Oct 1, 2016
LibMCP23017.cpp Creation Dec 2, 2015
LibMCP23017.h Creation Dec 2, 2015
LibRHDatagram.cpp Creation Dec 2, 2015
LibRHDatagram.h Creation Dec 2, 2015
LibRHGenericDriver.cpp Creation Dec 2, 2015
LibRHGenericDriver.h Creation Dec 2, 2015
LibRHGenericSPI.cpp Creation Dec 2, 2015
LibRHGenericSPI.h Creation Dec 2, 2015
LibRHHardwareSPI.cpp Creation Dec 2, 2015
LibRHHardwareSPI.h Creation Dec 2, 2015
LibRHReliableDatagram.cpp Creation Dec 2, 2015
LibRHReliableDatagram.h Creation Dec 2, 2015
LibRHSPIDriver.cpp Creation Dec 2, 2015
LibRHSPIDriver.h Creation Dec 2, 2015
LibRH_RF69.cpp Creation Dec 2, 2015
LibRH_RF69.h Creation Dec 2, 2015
LibRadioHead.h Creation Dec 2, 2015
LibSSD1306.cpp Creation Dec 2, 2015
LibSSD1306.h Creation Dec 2, 2015
LibULPNode_RF_Protocol.cpp Erreur de casse #include "Arduino.h" Dec 17, 2015
LibULPNode_RF_Protocol.h Creation Dec 2, 2015
Libatomic.h Creation Dec 2, 2015
Libradio_config_Si4460.h Creation Dec 2, 2015
README.md Ajout informations textuelles Mar 4, 2017
config.cpp Correction lien Mar 4, 2016
config.h Correction erreur config port Jeedom (Fixe #26) Oct 16, 2017
display.cpp Merge async with hallard/master Mar 4, 2017
display.h Creation Dec 2, 2015
i2c.cpp Modification des Serial.print => Debug Oct 1, 2016
i2c.h Creation Dec 2, 2015
linked_list.cpp Modification des Serial.print => Debug Oct 1, 2016
linked_list.h Creation Dec 2, 2015
pilotes.cpp Ajout de la gestion du relais inversé Mar 4, 2017
pilotes.h Add fnct_relais in header of pilotes file Oct 2, 2016
remora.h Add remora board version 1.4 Oct 16, 2017
remora_soft.ino Add remora board version 1.4 Oct 16, 2017
rfm.cpp Modification des Serial.print => Debug Oct 1, 2016
rfm.h Creation Dec 2, 2015
spark.ignore Creation Dec 2, 2015
tinfo.cpp Merge async with hallard/master Mar 4, 2017
tinfo.h Ajout de la variable fnctRelais pour la gestion du mode de fonctionne… Oct 1, 2016
webclient.cpp adaptation http.begin() suite changement lib officielle May 9, 2016
webclient.h Creation Jan 5, 2016
webserver.cpp Add remora board version 1.4 Oct 16, 2017
webserver.h Mise à jour de la fonction d'update par le Web, Firmware & SPIFFS Oct 9, 2016

README.md

Version Logicielle pour toutes les versions du matériel

Cette version logicielle est compatible avec la version matérielle 1.2 ainsi que les anciennes versions des cartes electroniques. Elle est aussi compatible avec les cartes à base d'ESP8266 via un adaptateur

Installation (Particle)

  • Télécharger l'environnement de développement Particle-Dev puis lancer l'IDE.
  • Télécharger l'archive du repo logiciel github et le copier sur votre disque dur puis le décompresser
  • Une fois l'IDE ouvert, menu File/Open et ouvrir le dossier programmateur-fil-pilote-wifi-master\Logiciel\remora
  • Dans le menu Particle/Log in to Particle Cloud, entrez vos identifiants Particle pour vous connecter
  • Dans le menu Particle/Select Device selectionnez votre Spark Core ou Particle Photon
  • Ouvrir ensuite depuis l'IDE les fichers remora.ino et remora.h
  • Selectionner la version de carte utilisé dans le fichier remora.h (les defines REMORA_BOARD_Vxx)
  • Selectionner les modules utilisés dans le fichier remora.h (les defines MOD_xxxx)
  • Selectionner l'onglet remora.ino
  • Lancer la compilation+upload (icone éclair en haut à gauche)
  • Si vous avez une erreur de type "App code was invalid" durant la compilation, supprimer le ficher README.md du dossier

Installation (Arduino ESP8266 NodeMCU)

  • Suivre la procédure détaillée ici, Attention Arduino 1.6.5 pas 1.6.6 Maintenant c'est compatible Arduino 1.6.7 et je vous conseille d'utiliser la version git
  • Installer le plugins SPIFFS pour l'IDE Arduino comme indiqué ici
  • Lancer l'IDE Arduino
  • Installer la librairie NeoPixelBus depuis l'IDE Menu Sketch / Include Library / Manage Library => NeoPixelBus by Makuna
  • Installer la librairie Blynk depuis l'IDE Menu Sketch / Include Library / Manage Library / Blynk by Volodymyr Shymanskyy
  • Installer la bibliothèque ESPAsyncTCP depuis l'IDE. Télécharger la dernière release au format zip, puis Menu Croquis / Inclure une bibliothèque / Ajouter la bibliothèque .ZIP
  • Installer la bibliothèque ESPAsyncWebServer depuis l'IDE. Télécharger la dernière release au format zip, puis Menu Croquis / Inclure une bibliothèque / Ajouter la bibliothèque .ZIP
  • Lancer ensuite l'IDE Arduino et ouvrir depuis celui-ci le ficher remora_soft.ino
  • Selectionner la version de carte utilisé dans le fichier remora.h (les defines REMORA_BOARD_Vxx)
  • Selectionner les modules utilisés dans le fichier remora.h (les defines MOD_xxxx)
  • choisir dans l'IDE Arduino Menu Tools / Board => NodeMCU 1.0 (ESP12E-Module) ainsi que le bon serial port
  • choisir dans l'IDE Arduino Menu Tools / CPU Frequency => 160MHz
  • choisir dans l'IDE Arduino Menu Tools / Flash Size => 4M (1M SPIFFS)
  • mettre votre SSID et mot de passe Wifi dans le fichier remora.h. DEFAULT_WIFI_AP_PASS est le mot de passe de connection Wifi au remora quand celui ci se positionne en point d'accès (lorsqu'il n'arrive pas à se connecter à vôtre Wifi par exemple) son IP est alors 192.168.4.1
		// Définir ici les identifiants de
		// connexion à votre réseau Wifi
		// =====================================
		#define DEFAULT_WIFI_SSID "VotreSSID"
		#define DEFAULT_WIFI_PASS "VotreClé"
		#define DEFAULT_WIFI_AP_PASS "Remora_WiFi"
		// =====================================
  • Lancer l'upload SPIFFS (les fichiers WEB) Menu Tools / ESP8266 Sketch Data Upload (c'est assez long)
  • Lancer la compilation + upload (CTRL-U)

Attention, pour pouvoir uploader via le cable USB, la téléinfo ne doit pas être connectée (en OTA pas de soucis avec ça) car le port série est partagé. Donc soit il faut la débrancher soit il faut sortir le module NodeMCU du support.

Pour les mêmes raisons, et afin d'afficher les informations de debug dans une console, celle-ci doit être configurée à la même vitesse que la téléinfo (car c'est le même port série) donc 1200 bps, parité paire et 7 bits de data, or cette configuration n'est pas possible dans le moniteur série de l'Arduino. Il faut alors prendre un autre terminal comme putty, coolterm, ...

  • La procédure OTA (télédéversement sans fil) est disponible ici

API Exposée (Particle)

Toutes les API se font via des requêtes HTTP sur le cloud Particle.

A documenter!

API Exposée (ESP8266 NodeMCU)

Toutes les API se font via des requêtes HTTP sur le Remora. Il existe deux formats possibles si l'on veut récupérer des données ou exécuter des action avec le Remora. Chaque requête se verra retourner des données (ou un code de bonne éxécution) au format JSON.

Toute requête sera donc adressée sous la forme http://adresse_ip_du_remora/requete_plus_ou_moins_longue dans les exemples ci dessous l'adresse IP de mon Remora est la 192.168.1.201, veillez à bien la changer pour mettre la vôtre. Les exemples ont été exécutés depuis la ligne de commande avec curl mais ils pourraient l'être depuis la barre d'addresse de votre navigateur.

Les Etats de fil pilote

Les différents états possibles de fil pilote dans l'API correspondent à la notation suivante, une lettre représente l'état lu ou le mode à positionner tel que :

C = Confort
A = Arrêt
E = Eco
H = Hors gel
1 = Eco-1 (non géré pour le moment)
2 = Eco-2 (non géré pour le moment)

Les Etats du mode de fonctionnement du relais

Voici les différents modes de fonctionnement du relais que vous pourrez trouver dans l'API:

0: arrêt
1: marche forcée
2: automatique

Les API d'intérrogation

Les API d'intérrogation se presentent sous la forme http://adresse_ip_du_remora/ma_donnee et la/les donnée(s) sont retournées au format JSON (j'ai volontairement supprimé certains sauts de lignes de sortie pour une meilleure lecture)

  • Durée de fonctionnement en secondes depuis le dernier reboot/reset/allumage http://ip_du_remora/uptime
    ~ # curl http://192.168.1.201/uptime
    { "uptime": 120 }
  • Etat du relais et du mode de fonctionnement http://ip_du_remora/relais
    ~ # curl http://192.168.1.201/relais
    { "relais": 0, "fnct_relais": 2 }
  • Etat du délestage http://ip_du_remora/delestage
		~ # curl http://192.168.1.201/delestage
		{ "niveau": 0, "zone": 1 }

Si le délestage est désactivé http://ip_du_remora/delestage

		~ # curl http://192.168.1.201/delestage
		{ "etat": "désactivé" }
  • Etat d'un fil pilote http://ip_du_remora/fpn avec n = numéro du fil pilote (1 à 7)
		~ # curl http://192.168.1.201/fp3
		{ "fp3": "E" }
  • Etat de tous les fils pilotes http://ip_du_remora/fp
		~ # curl http://192.168.1.201/fp
		{
		"fp1": "A",
		"fp2": "E",
		"fp3": "E",
		"fp4": "E",
		"fp5": "C",
		"fp6": "H",
		"fp7": "C"
		}
  • Récupérer une étiquette Téléinfo par non nom http://ip_du_remora/Nom_Etiquette
		~ # curl http://192.168.1.201/PAPP
		{ "PAPP": 170 }
		~ # curl http://192.168.1.201/IINST
		{ "IINST": 1 }
		~ # curl http://192.168.1.201/PTEC
		{ "PTEC":"HC.." }
  • Récupérer toutes les étiquettes Téléinfo en une fois http://ip_du_remora/tinfo
		~ # curl http://192.168.1.201/tinfo
		{ "_UPTIME":1614,
			"ADCO":31428067147,
			"OPTARIF":"HC..",
			"ISOUSC":15,
			"HCHC":410994,
			"HCHP":0,
			"PTEC":"HC..",
			"IINST":1,
			"IMAX":1,
			"PAPP":170,
			"HHPHC":3,
			"MOTDETAT":0
		}

A noter la présence de certaines étiquettes virtuelles commencant par un _

Les API d'action

Les API d'action se presentent sous la forme http://adresse_ip_du_remora/?action=ma_donnee, notez la différence avec les intérrogations, le ?. Le résultat est retourné au format JSON avec un code réponse, il est :

  • négatif en cas d'erreur
  • à 0 si tout est OK
  • positif pour indiquer un code retour OK différent si besoin.

Note, il est possible d'enchainer les actions en une requête mais un seul code d'erreur sera retourné pour l'ensemble, si une des commandes échoue, il faudra intérroger afin de savoir laquelle n'a pas fonctionnée.

  • Faire un reset (reboot) http://ip_du_remora/reset
		# curl http://192.168.1.201/reset
		OK, Redémarrage en cours
  • Faire une remise à zero usine http://ip_du_remora/factory_reset, attention tout va être vidé, y compris le système de fichier SPIFFS, c'est comme si votre NodeMCU arrivait d'usine
		# curl http://192.168.1.201/factory_reset
		OK, Redémarrage en cours
  • Activer le relais http://ip_du_remora/?relais=1
		# curl http://192.168.1.201/?relais=1
		{ "response": 0 }
  • désactiver le relais http://ip_du_remora/?relais=0
		# curl http://192.168.1.201/?relais=0
		{ "response": 0 }
  • Exemple d'erreur avec le relais http://ip_du_remora/?relais=3
		# curl http://192.168.1.201/?relais=3
		{ "response": -1 }
  • Utiliser le mode automatique du relais basé sur les changements de périodes tarifaires
		# curl http://192.168.1.201/?frelais=2
		{ "response": 0 }
  • Arrêter la gestion du relais et ouvrir le contact
		# curl http://192.168.1.201/?frelais=0
		{ "response": 0 }
  • Mettre le relais en marche forcée
		# curl http://192.168.1.201/?frelais=1
		{ "response": 0 }

Il est aussi possible de forcer le relais jusqu'au prochain changement de période tarifaire, si le mode est en automatique. Pour cela, il vous suffit d'activer le relais directement.

		# curl http://192.168.1.201/?relais=1
		{ "response": 0 }
  • selectionne le mode d'un des fils pilotes http://ip_du_remora/?setfp=na avec n=numéro du fil pilote et a=le mode à positionner (non sensible à la casse) Fil pilote 1 en arret
		# curl http://192.168.1.201?setfp=1a
		{ "response": 0 }

Fil pilote 7 en Eco

		# curl http://192.168.1.201?setfp=7E
		{ "response": 0 }

Mauvaise commande

		curl http://192.168.1.201?setfp=5X
		{ "response": -1 }
  • Selectionne le mode d'un ou plusieurs les fils pilotes d'un coup http://ip_du_remora/?fp=CMD avec 7 commandes de fil pilote. Tous les fils pilote en confort
		curl http://192.168.1.201/?fp=CCCCCCC
		{ "response": 0 }

Tous les fils pilote en arret

		curl http://192.168.1.201/?fp=AAAAAAA
		{ "response": 0 }

Tous les fils pilote en eco

		curl http://192.168.1.201/?fp=EEEEEEE
		{ "response": 0 }

Tous OFF sauf le fil pilote 1 en confort

		curl http://192.168.1.201/?fp=CAAAAAA
		{ "response": 0 }

Tous OFF sauf le fil pilote 2 A-AAAAA

		curl http://192.168.1.201/?fp=CCCCCCC
		{ "response": 0 }

FP1 Eco, FP2 inchangé, FP3 confort, FP4 hors gel, FP5 arrêt, FP6 Eco-1, FP7 Eco-2

		curl http://192.168.1.201/?fp=E-CHA12
		{ "response": -1 }

Erreur car les modes ECO-1 et ECO-1 ne sont pas gérés pour le moment.

A faire

  • Mettre des icones plus sympas sur l'afficheur
  • Gérer les retour de sondes RF, pour le moment seules les trames sont affichées sur la serial, rien n'est encore fait
  • Gérer le RF des sondes Oregon Scientific
  • pour le moment seul les OLED I2C sont gérés
  • tout autre idée est bienvenue

Historiques des Modifications

16/02/2015 : Ajout délestage cascadocyclique / Possibilité de ne récupérer l'état que d'un seul fil pilote

14/04/2015 : Ajout d'une variable spark pour la teleinfo. Passage en un seul appel pour script jeedom. Les variables d'origine restent utilisables.

30/09/2015 : voir le post dédié.

02/12/2015 : Ajout Version 1.3 Remora NodeMCU

04/01/2016 : Integration Interface WEB

01/10/2016 : Ajout de la (dés)activation du délestage. Ajout de la gestion automatisée du mode du relais.

07/01/2017 : Modification de la taille de la clé API pour Jeedom (32 => 48)

08/02/2017 : Ajout de la variable RELAIS_REVERSE à décommenter dans remora.h pour inverser l'état du relais en cas de problème

04/03/2017 : Ajout des connexions TCP Asynchrones

Exemple

Pour les photos la téléinfo n'était pas branchée sur la carte, c'est pour celà que les compteurs et le bargraphe sont à 0

Top  Bottom

Avec la téléinfo branchée sur la carte, le bargraph indique la puissance instantanée par rapport au contrat souscrit, ici soit 11% car on consomme 5A sur un contrat de 45A. Nous sommes en heures pleines (affichage sur fond blanc) Bottom