loick111/homebridge-rfxcom-accessories

Homebridge RFXCOM Accessories

This Homebridge plugin allows to control devices compatible with RFXCOM.
Here is the list of implemented devices:

• RFY (Somfy RTS)
• Weather sensors

How to use

You can add this plugin to your Homebridge instance by adding the following npm package:

npm install homebridge-rfxcom-accessories

Configuration

Global configuration of this plugin containing Homebridge parameters and RFXCOM parameters.

{
  "name": "Somfy RFXCOM",
  "platform": "RFXCOMAccessories",
  "tty": "/dev/ttyUSB0",
  "debug": false
}

Devices

RFXCOM can handle multiple type of devices and each one have its own configuration.

RFY (Somfy RTS)

RFY Somfy RTS can control blinds, awning, ...
You need to associate first your RFXCOM to the wanted device with an external tool.
You can use Domoticz to setup your RFXCOM or the official tool RFXMngr running only on Windows.

{
  "devices": {
    "rfy": [
      {
        "name": "Store",
        "deviceId": "0x000610/1",
        "openCloseDurationSeconds": "20",
        "forceCloseAtStartup": true
      }
    ]
  }
}

Weather sensors

RFXCOM can receive broadcast values by sensors.
You can find supported devices here.

You need to discover devices by cheking Homebridge logs.
You will see an info log WeatherSensor event received: followed by event values.
Finally, you'll be able to configure in plugin Settings the wanted WeatherSensor device with name and id.

{
  "devices": {
    "weatherSensors": [
      {
        "name": "Salon",
        "id": "0x7201"
      }
    ]
  }
}

Switch on/off

You can create a switch for devices that supports on/off commands.
Supported devices are here (needs switchOn and switchOff commands).

You can find type and subtype here.
The subtype is the index of your device in the array.
For example, with ELRO AB400D device, the right configuration will be:

• type Lighting1
• subtype 2

For id, you'll find all the documentation here.

{
  "devices": {
    "switch": [
      {
        "name": "Fan",
        "type": "Lighting1",
        "subtype": "2",
        "id": "A 1",
        "forceOffAtStartup": true
      }
    ]
  }
}

homebridge-rfxcom-accessories's Issues

My-Position

%-Position doesnt work realy well. Maybe, the Problem ist the opening/close Duration which is different with Shutters (uptime is slower than downtime). Additionally, the My-Button is Missing.

Is it possible to link a defined % (eg 50%) to the My-Position Command?

Best Regards
Rob

Switch accessory On/Off inversion

Describe Your Problem:

Hello the plugin is perfect to me except I need the On to b be the Off and the Off to be the On....
Everything works as expected, but I need the On/Off to be inverted.
Can you tell me what file I can modify to have this behavior ?
Many thanks for your work !

Logs:

[06/01/2024, 16:07:11] [RFXcom] RFXtrx initialized!

=> Perfect

Plugin Config:

 "name": "RFXcom",
            "tty": "/dev/ttyUSB0",
            "debug": false,
            "discover": true,
            "devices": {
                "switch": [
                    {
                        "name": "XXXXXX",
                        "type": "Lighting2",
                        "subtype": "AC",
                        "id": "XXXXXX",
                        "forceOffAtStartup": true
                    }

Environment:

• Plugin Version:
• Homebridge Version: 1.7.0
• Node.js Version: 20.10.0
• NPM Version: 1.7.0
• Operating System: Raspbian

Stop position

I'm always frustrated as I can’t stop the curtains.
Can you add a new position with Up and Down for RTS Somfy curtains ?
Many Thanks un advance

Up/Down mixed up

Describe Your Problem:
Up and down is mixed up. RFXmngr Command works perfect.
Hombridge/Homekit Status is mixed up. Any Ideas?

Logs:
2021-11-03 21:25:49.288 [rfxcom] on /dev/ttyUSB0 - Sent : 0C,1A,00,01,01,01,01,01,01,00,00,00,00
2021-11-03 21:25:49.971 [rfxcom] on /dev/ttyUSB0 - Received: 04,02,01,01,00
2021-11-03 21:25:49.973 [rfxcom] on /dev/ttyUSB0 - Response: Command message 01, ACK - transmit OK
2021-11-03 21:30:03.481 [rfxcom] on /dev/ttyUSB0 - Queued : 0C,1A,00,04,01,01,01,01,03,00,00,00,00
2021-11-03 21:30:03.486 [rfxcom] on /dev/ttyUSB0 - Sent : 0C,1A,00,04,01,01,01,01,03,00,00,00,00
2021-11-03 21:30:03.762 [rfxcom] on /dev/ttyUSB0 - Queued : 0C,1A,00,05,01,01,01,01,03,00,00,00,00
2021-11-03 21:30:03.765 [rfxcom] on /dev/ttyUSB0 - Sent : 0C,1A,00,05,01,01,01,01,03,00,00,00,00
2021-11-03 21:30:04.017 [rfxcom] on /dev/ttyUSB0 - Queued : 0C,1A,00,06,01,01,01,01,03,00,00,00,00
2021-11-03 21:30:04.020 [rfxcom] on /dev/ttyUSB0 - Sent : 0C,1A,00,06,01,01,01,01,03,00,00,00,00
2021-11-03 21:30:04.171 [rfxcom] on /dev/ttyUSB0 - Received: 04,02,01,04,00
2021-11-03 21:30:04.171 [rfxcom] on /dev/ttyUSB0 - Response: Command message 04, ACK - transmit OK
2021-11-03 21:30:04.320 [rfxcom] on /dev/ttyUSB0 - Queued : 0C,1A,00,07,01,01,01,01,00,00,00,00,00
2021-11-03 21:30:04.322 [rfxcom] on /dev/ttyUSB0 - Sent : 0C,1A,00,07,01,01,01,01,00,00,00,00,00
2021-11-03 21:30:04.663 [rfxcom] on /dev/ttyUSB0 - Queued : 0C,1A,00,08,01,01,01,01,00,00,00,00,00
2021-11-03 21:30:04.827 [rfxcom] on /dev/ttyUSB0 - Received: 04,02,01,05,00
2021-11-03 21:30:04.828 [rfxcom] on /dev/ttyUSB0 - Response: Command message 05, ACK - transmit OK
2021-11-03 21:30:04.829 [rfxcom] on /dev/ttyUSB0 - Sent : 0C,1A,00,08,01,01,01,01,00,00,00,00,00
2021-11-03 21:30:04.983 [rfxcom] on /dev/ttyUSB0 - Queued : 0C,1A,00,09,01,01,01,01,00,00,00,00,00
2021-11-03 21:30:05.498 [rfxcom] on /dev/ttyUSB0 - Received: 04,02,01,06,00
2021-11-03 21:30:05.499 [rfxcom] on /dev/ttyUSB0 - Response: Command message 06, ACK - transmit OK
2021-11-03 21:30:05.501 [rfxcom] on /dev/ttyUSB0 - Sent : 0C,1A,00,09,01,01,01,01,00,00,00,00,00
2021-11-03 21:30:06.170 [rfxcom] on /dev/ttyUSB0 - Received: 04,02,01,07,00
2021-11-03 21:30:06.171 [rfxcom] on /dev/ttyUSB0 - Response: Command message 07, ACK - transmit OK
2021-11-03 21:30:06.842 [rfxcom] on /dev/ttyUSB0 - Received: 04,02,01,08,00
2021-11-03 21:30:06.843 [rfxcom] on /dev/ttyUSB0 - Response: Command message 08, ACK - transmit OK
2021-11-03 21:30:07.514 [rfxcom] on /dev/ttyUSB0 - Received: 04,02,01,09,00
2021-11-03 21:30:07.514 [rfxcom] on /dev/ttyUSB0 - Response: Command message 09, ACK - transmit OK
2021-11-03 21:30:14.017 [rfxcom] on /dev/ttyUSB0 - Queued : 0C,1A,00,0A,01,01,01,01,03,00,00,00,00
2021-11-03 21:30:14.020 [rfxcom] on /dev/ttyUSB0 - Sent : 0C,1A,00,0A,01,01,01,01,03,00,00,00,00
2021-11-03 21:30:14.696 [rfxcom] on /dev/ttyUSB0 - Received: 04,02,01,0A,00
2021-11-03 21:30:14.696 [rfxcom] on /dev/ttyUSB0 - Response: Command message 0A, ACK - transmit OK

**Plugin Config:**

{
    "bridge": {
        "name": "",
        "username": "",
        "port": ,
        "pin": ""
    },
    "accessories": [
       
    ],
    "platforms": [
       {
            "name": "RFXCOM",
            "tty": "/dev/ttyUSB0",
            "debug": true,
            "discover": false,
            "devices": {
                "rfy": [
                    {
                        "name": "Buero_RFX",
                        "deviceId": "010101/1",
                        "openCloseDurationSeconds": "30"
                    }
                ]
            },
            "platform": "RFXCOMAccessories"
        }
    ]
}

**Screenshots:**
<!-- If applicable, add screenshots to help explain your problem. -->

**Environment:**

* **Plugin Version**: homebridge-rfxcom-accessories v2.3.6
* **Homebridge Version**: v1.3.5
* **Node.js Version**: v14.18.1
* **NPM Version**: v6.14.15
* **Operating System**: Raspbian /  hb-service

When HomeBridge reboots, the RFXCom sends a command to all screens/motors to open.

Is your feature request related to a problem? Please describe:
When HomeBridge/Docker reboots, the RFXCom sends a command to all Somfy curtains/motors to open, but in HomeKit/HomeBridge it shows as if all curtains are closed. I need to open/close after every reboot to get the proper state inside HomeKit.

Describe the solution you'd like:
Remember last state before reboot and don't send any command on boot. If last state cannot be preserved on reboot, an option to change the default boot mode which signal is send to the motors.

Describe alternatives you've considered:
Change default boot mode to close all curtains, so state in HomeKit and physical state is the same, after reboot.

Integrate Blinds1 devices

Describe Your Problem:
I can't set up my blinds. I try multiple things and I always the message "device type is unknown"

Logs:

Homebridge v1.6.0 (HAP v0.11.0) (RFXCOM) is running on port 55641.
Error: Device type 'blinds1' is unknown
at new SwitchAccessory (/var/lib/homebridge/node_modules/homebridge-rfxcom-accessories/src/accessories/switchAccessory.ts:65:13)
at RFXCOMAccessories.discoverSwitchDevices (/var/lib/homebridge/node_modules/homebridge-rfxcom-accessories/src/platform.ts:278:9)
at RFXCOMAccessories.discoverDevices (/var/lib/homebridge/node_modules/homebridge-rfxcom-accessories/src/platform.ts:147:10)
at HomebridgeAPI. (/var/lib/homebridge/node_modules/homebridge-rfxcom-accessories/src/platform.ts:70:12)
at HomebridgeAPI.emit (node:events:513:28)
at HomebridgeAPI.signalFinished (/var/lib/homebridge/node_modules/homebridge/src/api.ts:275:10)
at ChildBridgeFork.startBridge (/var/lib/homebridge/node_modules/homebridge/src/childBridgeFork.ts:189:14)
[04/05/2023, 22:26:17] [RFXCOM] Child bridge process ended

Plugin Config:

"name": "RFXCOM",
"tty": "/dev/ttyUSB0",
"debug": false,
"discover": false,
"devices": {
"switch": [
{
"name": "Store",
"type": "blinds1",
"subtype": "6",
"id": "0000001"
}
]
},
"_bridge": {
"username": "",
"port":
},
"platform": "RFXCOMAccessories"

Environment:

• Plugin Version: 2.40
• Homebridge Version: 1.6.0
• Node.js Version: 18.13.0
• NPM Version:
• Operating System: Raspbian

Does this plugin support the Forest Shuttle RF curtains?

I have added several Somfy devices to my RFXcom transmitter and also two Forest Shuttle RF curtains.
These curtains have been added with the following device information:

• Forest Shuttle RF
• Protocol = BlindsT7
• 00.04.01.0 / unit all Small curtain
• 00.04.02.0 / unit all Large curtain
  By the way: unit all has to be selected, individual codes (e.g. 0 or 1) do not work

They work perfectly when transmitting open and close commands using the RFXManager programm.

I have tried to add them to the Homebridge-RFXcom-Accessories plugin as RFY devices (knowing they are not Somfy the chance of succes was near to zero) and as on/off switch with the following definition:

• type Blinds1
• subtype 7
• id 0004020 all

I've tried several variations on these settings, but I can't get the curtains to activate.
Hence the question whether this plugin support the Forest Shuttle RF curtains?

Environment:

• Plugin Version 2,4,0
• Hoobs Version 4.1.17
• Homebridge Version 1.3.6
• Node.js Version 16.13.1
• NPM Version 8.1.2
• Operating System Raspbian 5.10.63