Skip to content

Commit

Permalink
Merge pull request #11 from zigbee2mqtt/dev
Browse files Browse the repository at this point in the history
Bump stable to 1.16.0
  • Loading branch information
ciotlosm authored Nov 1, 2020
2 parents bcd47e0 + e520ce8 commit c72b673
Show file tree
Hide file tree
Showing 4 changed files with 17 additions and 14 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

Add the repository URL under **Supervisor → Add-on store → ⋮ → Manage add-on repositories**:

/~https://github.com/danielwelch/hassio-zigbee2mqtt
/~https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

The repository includes two add-ons:

Expand Down
3 changes: 3 additions & 0 deletions zigbee2mqtt/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
## 1.16.0
- Updated Zigbee2mqtt to version [`1.16.0`](/~https://github.com/Koenkk/zigbee2mqtt/releases/tag/1.16.0)

## 1.15.0-3
- Fixed `external_converters` not working

Expand Down
24 changes: 12 additions & 12 deletions zigbee2mqtt/DOCS.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,9 +35,18 @@ zigbee_herdsman_debug: true


# Adding Support for New Devices
If you are interested in [adding support for new devices to zigbee2mqtt](https://www.zigbee2mqtt.io/how_tos/how_to_support_new_devices.html) you will need to use one of the methods below to allow you to change the required files.
If you are interested in [adding support for new devices to zigbee2mqtt](https://www.zigbee2mqtt.io/how_tos/how_to_support_new_devices.html) see methods below

### Using devices.js override in add-on
### Using external_converters

Using `external_converters` option you will have more flexibility to add support but also allow you to maintain a DIY device support. Follow the [documentation](https://www.zigbee2mqtt.io/information/configuration.html#external-converters-configuration) to get started.

If you are searching to edit specific files, please find the Line reference in the example converter where to make your changes:

- `fromZigbee.js`: /~https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/externalConvertersExample/dummy-converter.js#L15
- `homeassistant.js`: /~https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/externalConvertersExample/dummy-converter.js#L66

### [Not recommended] Using devices.js override in add-on

Set the optional, top-level `zigbee_shepherd_devices` option to `true` in your configuration.

Expand All @@ -57,19 +66,10 @@ When set, the add-on will scan your `data_path` for a `devices.js` file, and wil
6. Click on the commit hash (ex. `3a5abc7`) and then `browse files` button
7. Find `devices.js` file and download it (use `raw` version)

### Using external_converters

Using `external_converters` option you will have more flexibility to add support but also allow you to maintain a DIY device support. Follow the [documentation](https://www.zigbee2mqtt.io/information/configuration.html#external-converters-configuration) to get started.

If you are searching to edit specific files, please find the Line reference in the example converter where to make your changes:

- `fromZigbee.js`: /~https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/externalConvertersExample/dummy-converter.js#L15
- `homeassistant.js`: /~https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/externalConvertersExample/dummy-converter.js#L66

# Notes
- Depending on your configuration, the MQTT server config may need to include the port, typically `1883` or `8883` for SSL communications. For example, `mqtt://core-mosquitto:1883` for Home Assistant's Mosquitto add-on.
- To find out which serial ports you have exposed go to **Supervisor → System → Host system → ⋮ → Hardware**
- Please see this add-on's [documentation on GitHub](/~https://github.com/danielwelch/hassio-zigbee2mqtt#socat) for further add-on-specific information (using Socat, how to add support for new devices etc.).
- Please see this add-on's [documentation on GitHub](/~https://github.com/zigbee2mqtt/hassio-zigbee2mqtt/blob/dev/zigbee2mqtt/DOCS.md#socat) for further add-on-specific information (using Socat, how to add support for new devices etc.).

# Additional Configuration Options
- `network_key_string`
Expand Down
2 changes: 1 addition & 1 deletion zigbee2mqtt/config.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "Zigbee2mqtt",
"version": "1.15.0-3",
"version": "1.16.0",
"slug": "zigbee2mqtt",
"description": "Zigbee2mqtt add-on",
"auto_uart": true,
Expand Down

0 comments on commit c72b673

Please sign in to comment.