mirrors
/
Tasmota
mirror of https://github.com/arendst/Tasmota.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

frazeology edits

blakadder 2019-11-06 20:23:58 +01:00
parent 3931f9f87b
commit 6f6aaf2f82
1 changed files with 13 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
Zigbee.md

@ -5,8 +5,8 @@ Note: Zigbee to Tasmota is still **experimental** and changing rapidly. MQTT mes
The purpose of Z2T is to serve as a gateway for devices connected to a Zigbee wireless network to bridge their communications over to Wi-Fi. Z2T is a lightweight Zigbee solution running on an ESP82xx Wi-Fi chip. Hence it is easier to deploy in your living room or around your home. It is largely inspired from [Zigbee2mqtt](#why-another-zigbee-project) but it's a complete rewrite to make it fit on an ESP82xx with 80kB of RAM and only 1MB of flash memory.
## Zigbee primer
Before using Zigbee, you need to understand a few concepts. Here is a simplified comparison to the Wi-Fi equivalent (sort of).
## Introduction
Before using Zigbee to Tasmota, you need to understand a few concepts. Here is a simplified comparison to the Wi-Fi equivalent (sort of).
|Zigbee concept|Wi-Fi equivalent|
|---|---|
@ -18,9 +18,9 @@ Before using Zigbee, you need to understand a few concepts. Here is a simplified
|**Encryption Key**<BR>128-bit encryption key.<BR>*default: 0x0D0C0A08060402000F0D0B0907050301*|Wi-Fi password|
|**Pairing**<BR>By default the coordinator does not accept new devices unless put in pairing mode. When in pairing mode, it will accept pairing requests from any device within range.<BR>*Default: pairing disabled*|WPS|
## Hardware
### Zigbee Adapter
**You cannot use any CC2531 based device with Tasmota** - the CC2531 only supports USB communication. It does not support serial communications as required by Z2T.
# Hardware
## Zigbee Adapter
**You cannot use any CC2531 based device with Tasmota!**. CC2531 supports USB communication and not serial communication required by Z2T.
|Device |Notes|
|---|---|
@ -28,18 +28,13 @@ Before using Zigbee, you need to understand a few concepts. Here is a simplified
|**[CC2530 with external antenna](https://www.aliexpress.com/item/33007098493.html)**<BR><img src="https://user-images.githubusercontent.com/49731213/64906209-c0ad1680-d6e3-11e9-8703-71ea36c5be72.jpg" width="240"><BR>or<BR><img src="https://user-images.githubusercontent.com/49731213/64913622-eec24300-d743-11e9-9416-0b19a4cbc3c4.jpg" width="240">|Better range.|
|**[CC2530 with external antenna and CC2591 RF front end](https://www.aliexpress.com/item/4000118023903.html)**<BR><img src="https://user-images.githubusercontent.com/49731213/64906219-f0f4b500-d6e3-11e9-8cd0-e135af531718.jpg" width="240">|Best range.<BR>Please note you need a specific firmware for CC2591 frontend.|
### Wi-Fi Adapter
## Wi-Fi Adapter
Using an ESP82xx device such as a Wemos D1 Mini or a NodeMCU to flash the CC2530 (described below) is a lower cost alternative than using a single purpose [CC_DEBUGGER](https://www.aliexpress.com/item/32869263224.html). When in normal operation, this ESP82xx device can then also serve as the Wi-Fi adapter for the Z2T messaging.
In normal operation, only two free GPIO are needed for the serial communications with the CC2530. You can use the ESP82xx device above to flash the CC2530 adapter(s) and then use any other ESP82xx device flashed with Z2T as the gateway between Zigbee and Wi-Fi.
## Procedure
1. Flash the CC2530 with appropriate firmware
2. Flash an ESP82xx device with Z2T firmware
3. Connect the CC2530 to the Tasmota Device
4. Configure and run Z2T
## 1. Flashing the CC2530
# Connecting Zigbee adapter to Tasmota
## 1. Flash the CC2530 module
Z2T requires a TI CC2530 based module flashed with [Z-Stack-firmware](https://github.com/Koenkk/Z-Stack-firmware) from [Koen Kanters](https://github.com/Koenkk). To simplify this procedure, a ready to use [fork of the needed firmware files](https://github.com/s-hadinger/CCLib) is available.
### A. Flash CCLib on an ESP82xx Device
@ -205,10 +200,10 @@ Configure the Tasmota device using a custom template. Assign **`Zigbee Tx (165)`
<img src="https://user-images.githubusercontent.com/49731213/64920989-ec043400-d7bd-11e9-8f5c-74ece5c4e26c.jpg" width="240">
## 4. Running Z2T
Due to memory constraints of the CC2530, you can only pair 16 devices to a coordinator ([See details](https://github.com/Koenkk/Z-Stack-firmware/tree/master/coordinator)). **You cannot use any CC2531 based device with Tasmota** - the CC2531 only supports USB communication. It does not support serial communications as required by Z2T.
## 4. First run
Due to memory constraints of the CC2530, you can only pair 16 devices to a coordinator ([See details](https://github.com/Koenkk/Z-Stack-firmware/tree/master/coordinator)).
There is an alternative firmware allowing for Zigbee routers to create a mesh network and go beyond 16 devices. This is currently not tested nor supported by Z2T. It may be added later.
> There is an alternative firmware allowing for Zigbee routers to create a mesh network and go beyond 16 devices. This is currently not tested nor supported by Z2T. It may be added later.
Z2T is still in its early phase. Logging is set to verbose mode to ease reporting or debugging. It should become less verbose in the future.
@ -332,8 +327,8 @@ MQT: tele/<topic>/RESULT = {"ZigbeeStatus":{"Status":0,"Message":"Started"}}
ZIG: zigbee device ready, listening...
```
## Using Z2T
[Zigbee to Tasmota Configuration and Setup](Zigbee-Commands)
# Using Zigbee to Tasmota
Read more on [Zigbee to Tasmota commands and zigbee device configuration](Zigbee-Commands).
## Why another Zigbee project?
There are several excellent open-source Zigbee to MQTT solutions like the widely used [Zigbee2mqtt](https://www.zigbee2mqtt.io/) or [Aqara Hub](https://github.com/Frans-Willem/AqaraHub). Zigbee2mqtt is a comprehensive solution but requires at least a Raspberry Pi to run it. Z2T is a lightweight solution running on an ESP82xx Wi-Fi chip. Hence it is easier to deploy in your living room or around your home.