Le package Rfxcom vous permet d’interagir avec l’émetteur/récepteur RFXCOM USB.

image

Actuellement, le package en version 1.0 supporte :

  • Les sondes de température (Oregon THR128/138, THC138, THC238/268, THN132, THWR288, THRN122, THN122, AW129/131, THWR800, RTHN318, La Crosse TX2, TX3, TX4, TX17, WS2300, TS15C, Viking 02811, RUBiCSON, TFA 30.3133)
  • Les sondes de température et d’humidité  (Oregon THGN122/123, THGN132, THGR122/228/238/268, THGR810, THGN800, THGR810, RTGR328, THGR328, WTGR800, THGR918/928, THGRN228, THGN500, TFA TS34C, Cresta, WT260,WT260H,WT440H,WT450,WT450H, Viking 02035,02038, Rubicson, EW109)
  • L’envoi de commande RFY (pour le pilotage des périphérique Somfy)

Le code source est disponible sur : https://github.com/myconstellation/constellation-packages/tree/master/Rfxcom

Installation

Depuis le “Online Package Repository” de votre Console Constellation, déployez le package Rfxcom :

image

Une fois le package télécharger votre repository local, sélectionnez la sentinelle sur laquelle déployer le package.

Pour finir, sur la page de Settings, vous devez obligatoirement définir le port COM sur lequel est connecté votre RFXcom :

image

Vous pouvez également déployer ce package manuellement dans la configuration de votre Constellation :

Détails du package

Les Settings

NomTypeDétailDescription
PortNameStringObligatoireLe nom du port COM du RFXcom (ex: COM1)
VerboseBooleanOptionnel
Par défaut : false
Indique si le package écrit tous les messages qu’il reçoit dans les logs Constellation
ProtocolsEnabledStringOptionnelListe des protocoles RF à activer (sépéré par des virgules). Exemple : “Oregon,X10”. Voir la liste ici à la page 8.
ForwardRawMessageToGroupStringOptionnelIndique le nom du groupe dans lequel transférer les messages reçu.
SensorStateObjectLifetimeInt32Optionnel
Par défaut : 300
Durée de vie en seconde pour les StateObjects publiés.
StateObjectCustomNamesJsonObjectOptionnelPar défaut chaque StateObject est nommé par le type et numéro de série du capteur. Vous pouvez personnaliser le nom avec ce setting.
Personnaliser les noms des StateObjects

Le package publie un StateObject pour chaque capteur qu’il recoit. Chaque StateObject est composé du type de capteur (par exemple : “Temperature”) et de son identifiant.

Par exemple pour un capteur de température Oregon THR128 avec l’ID “21762”, le StateObject le représentant se nommera “TemperatureHumiditySensor_21762”.

Pour personnaliser les noms des StatObjects publiés vous pouvez définir un objet JSON dans le setting “StateObjectCustomNames” en indiquant le nom du capteur et son nom de StateObject :

Voici par exemple la personnalisation de plusieurs sondes Oregon :

image

Ainsi le capteur “TemperatureHumiditySensor_21762” est représenté dans la Constellation par le StateObject nommé “Capteur Bureau”.

Soyez particulièrement vigilant sur le fait que l’identifiant peut changer si le capteur n’a plus d’energie pendant plusieurs secondes (ce qui peut arriver lors du changement de pile). Il faudra alors mettre à jour la table de mapping pour que votre capteur conserve son nom de StateObject.

Les StateObjects

Vous retrouverez autant de StateObjects que de trame de capteur RF  :

NomTypeDescription
RFXCOMRfxCom.DeviceReprésente l’état du périphérique RFXcom (nom, version, protocole activée, etc..)
<< nom du capteur ou ID >>RfxCom.TemperatureSensorReprésente l’état d’un capteur 0x50 (température)
<< nom du capteur ou ID >>RfxCom.TemperatureHumiditySensorReprésente l’état d’un capteur 0x52(température et humidité)

image

Les MessageCallbacks

Le package expose 4 MessageCallbacks :

NomRéponse (saga)Description
RefreshStatusAucuneRafraichit le statuts du RFXcom.
SendMessageAucuneEnvoi un message en RF.
SendRFYCommandAucuneEnvoi une commande RFY (pour les équipements Somfy).
SetProtocolsAucuneDéfini la liste des protocoles RF à activer (voir la liste ici à la page 8).

image

Quelques exemples

  • Afficher les données de vos capteurs de température sur une page Web
  • Envoyer une notification d’urgence en cas de de température trop haute depuis un package C#
  • Piloter une prise Somfy depuis une page Web ou une application mobile multi-plateforme
Rfxcom : captez vos sondes RF et pilotez des équipements Somfy
Editer la page sur GitHub
Étiqueté avec :                                        

Un commentaire sur “Rfxcom : captez vos sondes RF et pilotez des équipements Somfy

Laisser un commentaire