Plugin to use an RFXcom key with Jeedom. This plugin works both locally and remotely (with the Jeedom Link plugin)
The RFXcom plugin allows you to communicate with all the peripherals compatible with the RFXCOM USB module. Among these peripherals are the following brands : Oregon, LaCross, Chacon, X10, DI-O, Blyss, etc.
After installing the plugin, you just need to activate it and set the port to auto, after saving the daemon should launch. The plugin is already configured by default; you don’t have to do anything more. However you can modify this configuration. Here is the detail of the parameters :
If you do not know which USB port is used, you can simply indicate “Auto”. But be careful, some modules may conflict with auto discovery (teleinfo type) and automatic selection will not work.
Communication speed : communication speed of RFXcom port.
Leave at default unless using an older controller model.
Change only if you know what you are doing.
Protocols : allows you to select the active protocols of the RFXcom interface.
Do not activate them all, some being incompatible with each other, here is the compatibility matrix :
To launch the daemon in debug it is enough at the level of the configuration of the logs of the plugin to put in debug, to save and to restart the daemon.
In this mode, the demon is very talkative. Once the debug is finished, don’t forget to click on “Restart” to exit the debug mode !!
RFXcom equipment configuration is accessible from the plugins menu then home automation protocol. You will find here :
By clicking on one of your equipment you arrive on the configuration page of your equipment including 2 tabs, equipment and controls.
At the top of your equipment configuration page, you have 3 buttons that allow you to perform certain options :
Adding RFXcom equipment is very simple, you just have to go into inclusion mode and wait for the equipment to send a message, when this is the case Jeedom will tell you that it has included new equipment and will create it automatically.
You will find the non-exhaustive list of compatible modules here
This operating mode is valid for sockets, light receivers, etc. Go to the “Plugins” menu then “Home automation protocol” and finally “RFXcom”.
Click on “Add” to add a module, name your module and click on “Okay””.
Select “Plug - Fault” in “Equipment”, then click on “Save”.
Your module / socket is now connected with JEEDOM, remember to activate it and make it visible to see it appear on the Dashboard.
Since the release of the new RFXcom RFXtrx433E module, it is now possible to control its Somfy RTS devices (RFY / RFU) from Jeedom. (Who supports this module via the RFXcom plugin)
Pour ajouter un nouveau périphérique, se rendre dans le menu Plugins > Protocole Domotique > RFXcom
Click the + Add button and give a name to your device. Ex : « Veranda shutter ».
Se rendre sur le nouveau Périphérique créé et dans le menu déroulant Equipement, choisir « RTS Store Somfy – Défaut », en profiter pour lui définir un objet parent et une catégorie si vous le souhaitez et cliquer sur Enregistrer.
The commands useful for managing the roller shutter are automatically generated. It only remains to pair the shutter with this Jeedom device. To do this, press the pairing button on the remote control of the shutter you wish to control for 2 to 3 seconds, until the shutter makes a slight return trip.
Once the shutter has signified that it is awaiting an order for pairing, click on the Test button corresponding to the Program command in Jeedom.
To validate the learning of the new command, the shutter will then make a short return trip.
Afin de tester tout de suite, vous pouvez cliquer sur les boutons Test correspondants aux commandes « Monter, Descendre, Stop ». Le bouton « My » correspond à la commande Stop.
Activate and make visible the device with the corresponding check boxes in order to be able to view and use it in the dashboard.
You can now order your Somfy RTS component with Jeedom.
Simulate / recognize a Chinese rfxcom remote control (undecoded).
Programming of Chinese code remote controls in Jeedom
At the RFXCom plugin → Management of RFXCom protocols :
- Do NOT check Undecoded
- Check Lightning4
To retrieve the codes from the remote control : Activate the option “Save all messages” and retrieve the IDs by pressing the Remote control keys that look like Message : 0913004C410A24015970, Subtype = ARC, Id = 400A24… Example “Messages” a 4-button remote control : 0913006D410A21015E70 0913006E410A22015970 0913006F410A24015970 09130070410A28015970
To simulate a press on the command (emission), you must choose a type of equipment “Lightning4 (13) Default”. Then add an Action / Fault type command and put the value “Message” in Logicial ID (of type0913006D410A21015E70). The test button allows you to check the correct operation.
For reception, it is imperative to use the auto command generated by Jeedom (one per key) with the value Id = 400A24 in the ID field at the top left, while selecting a type of equipment “Lightning4 (13) Default”. It is the “Pulse” info which is received each time the remote control is pressed, and therefore makes it possible to trigger events in Jeedom.
Chinese relay box ak-rk01-12 piloted from Jeedom
For relay control from Jeedom live : put the jumper in position 1-2 (red LED side and 3 terminal blocks) to activate the Latch mode with separate ON and OFF command. At Jeedom, create an ON command with a value 09130038410B20015C70 (what is important is the chain in the middle 410B20 for ON and 410B21 for OFF. It is possible to vary the codes with the first 4 letters 410B, but keep the ends in 20 and 21 for the ON and OFF commands. You can also set the jumper to 2-3 and use only the first command to reverse the ON / OFF state each time the command is sent
I don’t see the rfxcom USB port
Make sure you don’t have brltty to install (
sudo apt-get remove brlttyto remove it)
After a few hours / days I no longer have any updates to my probes, a revival of the demon corrects
Check your USB cable (a bad USB cable often causes this kind of problem, it should not be too long either), also check your power supply, a USB hub is strongly recommended
I have a message telling me that the port does not exist
Check that the port is correctly configured and that the configuration is saved (it must be saved otherwise the modification is not taken into account).
My probes are not seen
Make sure you have checked the box for automatic creation of equipment. Check that the demon is launched. It is also possible to restart the debug daemon to see if it receives the messages from the probes. Also check that the correct protocols are activated (be careful not to activate too many, otherwise it will not work either).
When starting in debug mode I get the message : “can not bind socket address “or” Cannot assign requested address”
This is probably due to a wrong IP address configured in the General / administration / Configuration menu, “Network configuration” section, then “Internal access” and URL or IP address.
The demon refuses to start
Try to start the daemon in debug mode to see the error.
Why the association of a socket is more complex on Jeedom than on other home automation solutions ?
On other home automation solutions it is often enough just to click on the buttons on the remote control to be able to control the socket that the remote control controls, why this is not the case with Jeedom ?
Jeedom dissociates the remote control from the socket, with the previous method your buttons must control the socket, and if you break the association between the socket and the remote control the home automation solution can no longer control the socket.
Under Jeedom it’s different : the association is more complex but it is no longer necessary for the remote control to have X buttons monopolized by the control of the socket. These buttons can be used to control an outlet group mixing several technologies (Z-Wwave, Enocean and RFXcom for example).
My DIO plug does not want to associate with Jeedom
This usually happens when the internal memory of the outlet is full. To clear the memory of the DIO / Chacon sockets (they do not accept more than 3 different codes) under Jeedom, you must create a “reset” command with the value 0B110006 #ID#09030070 At this time, the red led flashes twice, and the socket can accept a new association with Jeedom.
The battery of my probes does not go up correctly
Check that you have a battery order with logicalId “battery” on your equipment
I have the error [Errno 5] Input / output error
This error is unfortunately hardware (communication problem with RFXcom). Often this is due to a problem with the power supply or the USB cable, so you can try changing the USB cable and / or going through a powered USB hub
I can not recognize some sensor despite the activation of the correct protocol
Check that the firmware is up to date. Then if it’s still not good you have to test with rfxmng
I have the error Timeout waiting status
This usually happens in 2 cases :
- Your RFXCOM module is not up to date, see here
- You took the RFXCOM plugin while you have an RFPLAYER, so you must take the RFPLAYER plugin
I have problems reassembling the sensors and the only solution is to restart everything
With the help of windows and the rfxmanager it is necessary to harden in the rfxcom the activation or not of the different protocols