Koenkk
zigbee-herdsman-converters
Collection of device converters to be used with zigbee-herdsman.
Breaking changes
15.0.0
- OTA
isUpdateAvailablenow returns an object instead of a boolean (e.g.{available: true, currentFileVersion: 120, otaFileVersion: 125}) - OTA
updateToLatestnow returns a number (fileVersionof the new OTA) instead of a void
Contributing
See Zigbee2MQTT how to support new devices.
Submitting a pull request
If you'd like to submit a pull request, you should run the following commands to ensure your changes will pass the tests:
npm install
npm run lint
npm test
npm run buildIf any of those commands finish with an error your PR won't pass the tests and will likely be rejected.
Documentation of definition meta property
multiEndpoint: enables the multi endpoint functionality in e.g. fromZigbee.on_off, example: normally this converter would return {"state": "OFF"}, when multiEndpoint is enabled the 'endpoint' method of the device definition will be called to determine the endpoint name which is then used as key e.g. {"state_left": "OFF"}. Only needed when device sends the same attribute from multiple endpoints. (default: false)multiEndpointSkip: array of attributes to not suffix with the endpoint namemultiEndpointEnforce: enforce a certain endpoint for an attribute, e.g. {"power": 4} see utils.enforceEndpoint()disableDefaultResponse: used by toZigbee converters to disable the default response of some devices as they don't provide one. (default: false)applyRedFix: see toZigbee.light_color (default: false)supportsEnhancedHue: see toZigbee.light_color (default: true)supportsHueAndSaturation: see toZigbee.light_color (default: true), usually set by light_* extends via options.timeout: timeout for commands to this device used in toZigbee. (default: 10000)coverInverted: Set to true for cover controls that report position=100 as open (default: false)coverStateFromTilt: Set cover state based on tiltturnsOffAtBrightness1: Indicates light turns off when brightness 1 is set (default: false)pinCodeCount: Amount of pincodes the lock can handledisableActionGroup: Prevents some converters adding the action_group to the payload (default: false)tuyaThermostatSystemMode/tuyaThermostatPreset: TuYa specific thermostat optionsthermostat: see e.g. HT-08 definition{dontMapPIHeatingDemand: true}: do not mappIHeatingDemand/pICoolingDemandfrom 0-255 -> 0-100, see fromZigbee.thermostat (default: false)
battery:{dontDividePercentage: true}: prevents batteryPercentageRemaining from being divided (ZCL 200=100%, but some report 100=100%) (default: false){voltageToPercentage: '3V_2100'}: convert voltage to percentage using specified option. See utils.batteryVoltageToPercentage() (default: null, no voltage to percentage conversion)