https://github.com/legobas/rfxcom2mqtt

RFXCOM to MQTT bridge
https://github.com/legobas/rfxcom2mqtt

433mhz home-automation mqtt raspberry-pi rfxcom rfxcom-device rfxtrx

Last synced: about 17 hours ago
JSON representation

RFXCOM to MQTT bridge

• Host: GitHub
• URL: https://github.com/legobas/rfxcom2mqtt
• Owner: Legobas
• License: apache-2.0
• Created: 2022-01-09T20:13:56.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2023-02-05T19:58:53.000Z (almost 2 years ago)
• Last Synced: 2023-04-07T12:20:59.082Z (over 1 year ago)
• Topics: 433mhz, home-automation, mqtt, raspberry-pi, rfxcom, rfxcom-device, rfxtrx
• Language: JavaScript
• Homepage:
• Size: 91.8 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# RFXCOM2MQTT

[![RFXCOM](rfxcom.png)](http://www.rfxcom.com)

RFXCOM to MQTT bridge for RFXtrx433 devices

All received RFXCOM events are published to the MQTT rfxcom2mqtt/devices/\ topic.

It is up to the MQTT receiver to filter these messages or to have a register/learning/pairing mechanism.

## Usage

### Configuration

See example **config.yml**

###

List of available commands: 

[DeviceCommands](https://github.com/rfxcom/node-rfxcom/blob/master/DeviceCommands.md)

### Subscribe to topic **rfxcom2mqtt/devices** to receive incoming messages.

Example JSON message on topic `"rfxcom2mqtt/devices/0x5C02"`:

    {

      "title": "Bathroom Temp & Hum",

      "type":"temperaturehumidity1",

      "subtype": 13,

      "id": "0x5C03",

      "seqnbr": 12,

      "temperature": 18,

      "humidity": 74,

      "humidityStatus": 3,

      "batteryLevel": 9,

      "rssi": 6

    }

### Publish command examples (topic/payload)

    rfxcom2mqtt/commmand/CucuDimmer

    on

    rfxcom2mqtt/commmand/CucuDimmer

    off

    rfxcom2mqtt/commmand/CucuDimmer

    level 15

    rfxcom2mqtt/commmand/Switch1 (lighting4, payload identifies device)

    on

    rfxcom2mqtt/commmand/Switch1

    off

    rfxcom2mqtt/commmand/Lights/Light1  (lighting2, unitName identifies device)

    on

    rfxcom2mqtt/commmand/Lights/Light1

    off

### Healthcheck

If healthcheck is enabled in the config, the rfxcom status will checked every minute.

In case of an error the node process will exit.

If installed in docker the container will try to restart try to reconnect to the RFXCOM device.

----

## Dependencies:

The [RFXCOM](https://github.com/rfxcom/node-rfxcom) Node library for the communication with the [RFXCOM](http://www.rfxcom.com) RFXtrx433 433.92MHz Transceiver.

The [MQTT.js](https://github.com/mqttjs/MQTT.js) library for sending and receiving MQTT messages.