RF Bridge Sensors - homebridge-plugins/homebridge-ewelink GitHub Wiki

The plugin will expose RF Bridge subdevices dependant on their eWeLink remote type:

  • 1-button will be exposed as a single accessory with one switch
  • 2-button will be exposed as a single accessory with two switches
  • 3-button will be exposed as a single accessory with three switches
  • 4-button will be exposed as a single accessory with four switches
  • Curtain will be exposed as a single accessory with three switches - ON (open), OFF (close) and Stop (pause)
  • Alarm will be exposed as a single accessory with one sensor

You can setup the type of sensor that is shown for the Alarm type. The instructions are detailed below. The valid options are:

  • motion for a motion sensor (default)
  • water for a leak sensor
  • smoke for a smoke detector
  • co for a carbon monoxide detector
  • co2 for a carbon dioxide detector
  • contact for a contact sensor (this can be further customised in the Home app as a door/window/garage sensor)
  • occupancy for an occupancy sensor, or
  • p_button for a stateless programmable switch (to add HomeKit automation on single press), or
  • doorbell for a doorbell (for doorbell press notifications only - accessory will show as unsupported)
  1. Find 'Sensor Device ID'

    To enable a different device type, you will need to find the 'Sensor Device ID' of the accessory. This can be found from the accessory information in the Home app under 'Serial Number'. It is the eWeLink Device ID of the RF Bridge followed by 'SW' followed by a number, for example 1000abcdeSW3.

  2. Update the plugin settings

    Once you have obtained the 'Sensor Device ID', then you can use the Homebridge/HOOBS UI plugin settings page to update the device. You'll need to add an entry under the 'RF Subdevices' section. Don't forget to click 'Save' (at the bottom of the screen) when finished.

    If you prefer to edit your Homebridge config file manually then here is a list of the options and and an example:

    Entry Type Required Default Min Explanation
    fullDeviceId str Yes "" Device ID of the sensor (13/14 digits normally in the format "1000ab23cdSW2").
    label str No "" This setting has no effect except to help identify this device.
    type str No "" Must be "water", "smoke", "co", "co2", "contact", "occupancy", "p_button", "doorbell" or "motion" (default).
    sensorTimeLength int No 60 1 The number of seconds which the sensor tile in the Home app will light up for if this sensor is activated.
    sensorTimeDifference int No 60 5 An offset in seconds to ignore notifications if the delay between this sensor activating and the plugin receiving the notification is greater than this number.
    overrideLogging str No “default” Override global logging setting for this device. Can be "default" (follows global setting), "standard" for standard logging, "debug" for debug logging or "disable" to disable accessory logging.
    "bridgeSensors": [
       {
          "fullDeviceId": "10009553c8SW1",
          "label": "Kitchen Leak Sensor",
          "type": "water",
          "sensorTimeLength": 60,
          "sensorTimeDifference": 60,
          "overrideLogging": "standard"
       },
       {
          "fullDeviceId": "10009553c8SW2",
          "label": "Kitchen CO2 Sensor",
          "type": "co2",
          "sensorTimeLength": 10,
          "sensorTimeDifference": 240
       }
    ]
  3. Restart Homebridge/HOOBS

    You must restart Homebridge/HOOBS for the changes to take effect.

Disclaimer

Please use these at your own risk. I do not guarantee functionality in case of emergency, nor do I take responsibility for any false alarms.

⚠️ **GitHub.com Fallback** ⚠️