zigbee2mqtt/docs/how_tos/how_to_esp8266_with_cc2530.md

How to connect a CC2530 coordinator via an ESP8266

This setup allows you to connect a CC2530 to an ESP8266 which can be put everywhere in your house. Via a serial socket, Zigbee2mqtt will connect to your CC2530.

Wiring

Wire the CC2530 to the ESP8266 using the following scheme:

ESP8266	CC2530
3v3	VCC
GND	GND
TX	P02
RX	P03
GND	P20
GND	P04
GND	P05

Flashing the ESP8266

The ESP8266 needs to be flashed with ESPEasy. ESPEasy has suficient documentation on how to get you up and running:

• How to flash the ESP8266 with ESPEasy
• ESP8266 firmware: ESP_Easy_mega-XXXXXXXX_normal_ESP8266_4096.bin
• More information about ESPEasy

Setting up the ESP8266

Open the ESPEasy web interface and complete the setup. Afterwards open the web interface again.

Click on Devices Edit of the first task and select Communication - Serial Server from the dropdown list.

Fill in the form as following:

a.    Name: ZIGBEE2MQTT
b.    Enabled: checked
c.    TCP Port: a number between 1000 and 9999 "1775"
d.    Baud Rate: 115200
e.    Data bits: 8
f.    Parity: No Parity
g.    Stop bits: 1
h.    Reset target after boot: - none –
i.    RX receive timeout: 0
j.    Event processing: Generic

Press Submit, the setup is now completed.

Mounting the serialport

The following instructions need to be executed on the computer that Zigbee2mqtt is running on.

# Install soccat
sudo apt-get install -y socat

# Create directory for mount point
sudo mkdir /opt/zigbee2mqtt/vusb/

# Give pi user owner rights to /opt/zigbee2mqtt/vusb/
sudo chown -R pi:pi /opt/zigbee2mqtt/vusb/

Comfirm that the connection works

Change the IP and PORT and execute:

socat -d -d pty,raw,echo=0,link=/opt/zigbee2mqtt/vusb/zigbee_cc2530 tcp-connect:IP:PORT

or

socat -d -d pty,raw,b115200,echo=0,link=/opt/zigbee2mqtt/vusb/zigbee_cc2530 tcp:127.0.0.1:1775

Mounting the serialport on boot

sudo nano /etc/systemd/system/socat-vusb.service

Add the following to this file (make sure to change the IP and PORT)

[Unit]
Description=socat-vusb
After=network-online.target

[Service]
User=pi
ExecStart=/usr/bin/socat -d -d pty,raw,echo=0,link=/opt/zigbee2mqtt/vusb/zigbee_cc2530 tcp:IP:PORT,reuseaddr
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.targett

Save the file and exit.

Update systemd:

sudo systemctl --system daemon-reload

Verify that the configuration works:

sudo systemctl start socat-vusb.service

Show status

systemctl status socat-vusb.service

Restart and check Log

sudo systemctl restart socat-vusb.service && sudo journalctl -f -u socat-vusb.service

Now that everything works, we want systemctl to start socat-vusb automatically on boot, this can be done by executing:

sudo systemctl enable socat-vusb.service

Some tips that can be handy later:

Stopping socat-vusb

sudo systemctl stop socat-vusb

Starting socat-vusb

sudo systemctl start socat-vusb

View the log of socat-vusb

sudo journalctl -u socat-vusb.service -f

Output should look like:
```bash
pi@hassbian:~ $ systemctl status socat-vusb.service
● socat-vusb.service - socat-vusb
   Loaded: loaded (/etc/systemd/system/socat-vusb.service; enabled; vendor preset: enabled)
   Active: active (running) since Fri 2019-02-01 15:35:24 UTC; 4min 11s ago
 Main PID: 1406 (socat)
   CGroup: /system.slice/socat-vusb.service
           └─1406 /usr/bin/socat -d -d pty,raw,b115200,echo=0,link=/opt/zigbee2mqtt/vusb/zigbee_cc2530 tcp:127.0.0.1:1775,reuseaddr

Feb 01 15:35:24 hassbian systemd[1]: Started socat-vusb.
Feb 01 15:35:24 hassbian socat[1406]: 2019/02/01 15:35:24 socat[1406] N PTY is /dev/pts/3
Feb 01 15:35:24 hassbian socat[1406]: 2019/02/01 15:35:24 socat[1406] N opening connection to AF=2 127.0.0.1:1775
Feb 01 15:35:24 hassbian socat[1406]: 2019/02/01 15:35:24 socat[1406] N successfully connected from local address AF=2 127.0.0.1:47512
Feb 01 15:35:24 hassbian socat[1406]: 2019/02/01 15:35:24 socat[1406] N starting data transfer loop with FDs [5,5] and [7,7]

Adding virtual device to zigbee2mqtt config

sudo nano  /opt/zigbee2mqtt/data/configuration.yaml

serial:
  port: /opt/zigbee2mqtt/vusb/zigbee_cc2530

advanced:
  rtscts: false

Restart zigbee2mqtt and confirm it works.

sudo systemctl restart zigbee2mqtt.service && sudo journalctl -f -u zigbee2mqtt.service