esphome-docs/devices/sonoff_4ch.rst

327 lines
12 KiB
ReStructuredText
Raw Normal View History

2018-06-01 18:10:00 +02:00
Using With Sonoff 4CH
2018-05-17 16:16:50 +02:00
=====================
2018-11-14 22:12:27 +01:00
.. seo::
2019-02-16 23:25:23 +01:00
:description: Instructions for putting Sonoff 4CH devices into flash mode and installing ESPHome on them.
2018-11-14 22:12:27 +01:00
:image: sonoff_4ch.jpg
2019-02-16 23:25:23 +01:00
ESPHome can also be used with Sonoff 4CH wireless switches. These devices are
2018-06-01 18:10:00 +02:00
basically just an ESP8266 chip with 4 relays to control power output, a few buttons on the
top and a few status LEDs.
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
.. figure:: images/sonoff_4ch_header.jpg
2018-05-17 16:16:50 +02:00
:align: center
:width: 75.0%
2018-06-01 18:10:00 +02:00
Sonoff 4CH WiFi switch.
2018-05-17 16:16:50 +02:00
2019-02-16 23:25:23 +01:00
This guide will step you through setting up your Sonoff 4CH and flashing the first ESPHome firmware
2018-05-17 16:16:50 +02:00
with the serial interface. After that, you will be able to upload all future firmwares with the remote
Over-The-Air update process.
2018-05-17 21:48:50 +02:00
.. note::
If you've previously installed Sonoff-Tasmota on your Sonoff 4CH, you're in luck 😀.
2019-02-16 23:25:23 +01:00
ESPHome can generate a firmware binary which you can then upload via the
2018-06-01 18:10:00 +02:00
Tasmota web interface. To see how to create this binary, skip to :ref:`sonoff_4ch-creating_firmware`.
2018-05-17 21:48:50 +02:00
2018-05-17 16:16:50 +02:00
Since firmware version 1.6.0, iTead (the creator of this device) has removed the ability to upload
a custom firmware through their own upload process. Unfortunately, that means that the only way to
2019-02-16 23:25:23 +01:00
flash the initial ESPHome firmware is by physically opening the device up and using the UART
2018-05-17 16:16:50 +02:00
interface.
.. warning::
Opening up this device can be very dangerous if not done correctly. While the device is open,
you will be a single touch away from being electrocuted if the device is plugged in or connected to a high voltage 'mains' power supply.
2018-05-17 16:16:50 +02:00
So, during this *entire* guide **never ever** plug the device in or have it connected to mains power. Also, you should only do this
2018-05-17 16:16:50 +02:00
if you know what you're doing. If you, at any step, feel something is wrong or are uncomfortable
with continuing, it's best to just stop for your own safety.
It's your own responsibility to make sure everything you do during this setup process is safe.
For this guide you will need:
- Sonoff 4CH 😉.
- A USB to UART Bridge for flashing the device. These can be bought on Amazon (or other online stores) for less than 5 dollars.
2018-06-01 18:10:00 +02:00
Note that the bridge *must* be 3.3V compatible. Otherwise you will destroy your Sonoff.
- Jumper wires to connect the UART bridge to the header pins.
- A computer running Home Assistant with the ESPHome Home Assistant add-on.
- A screwdriver to open up the Sonoff 4CH.
2018-05-17 16:16:50 +02:00
Have everything? Great! Then you can start.
2018-06-01 18:10:00 +02:00
Step 1: Opening up the Sonoff 4CH
2018-08-24 22:44:01 +02:00
---------------------------------
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
The first step is to open up the Sonoff 4CH. Note that you do not have to run the original firmware
supplied with the Sonoff 4CH before doing this step.
2018-05-17 16:16:50 +02:00
.. warning::
Just to repeat this: Make **absolutely sure** the device is not connected to any appliance or
connected to mains power before doing this step.
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
While the device is not plugged in, turn the device so you are viewing it from the top,
then unscrew the long screws in the four corners of the top cover.
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
.. figure:: images/sonoff_4ch_top.jpg
2018-05-17 16:16:50 +02:00
:align: center
:width: 60.0%
2018-06-01 18:10:00 +02:00
There are four screws on the front of the Sonoff 4CH.
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
After that, you should be able to remove the front cover and should be greeted by the main board.
The chip we're interested in here is the "big" one encased in an aluminium cover.
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
.. figure:: images/sonoff_4ch_mcu.jpg
2018-05-17 16:16:50 +02:00
:align: center
:width: 75.0%
2018-06-01 18:10:00 +02:00
The main chip of the Sonoff 4CH and the header pins we're going to use to flash our custom
firmware.
2018-05-17 16:16:50 +02:00
Step 2: Connecting UART
2018-08-24 22:44:01 +02:00
-----------------------
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
Now we need our computer to somehow establish a data connection to the board. For this we will
have to connect the four wires on the UART to USB bridge to the UART pins of the Sonoff 4Ch.
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
Fortunately for us, exactly these pins come pre-populated with a few header pins. You can identify
these by the ``VCC33``, ``RX``, ``TX`` and ``GND`` markings on the silk-screen.
2018-05-17 16:16:50 +02:00
Now go ahead and connect these pins to your UART to USB bridge as seen in the below image. Make sure
2018-06-01 18:10:00 +02:00
that you connect these correctly, especially the ``VCC33`` and ``GND`` parts as you can otherwise
destroy the chip.
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
``VCC33`` should be connected to the ``3V3`` (**not** 5V) pin of the UART bridge, ``GND`` to ``GND``
and the same with ``RX``/``TX``.
2018-05-17 16:16:50 +02:00
When you're done, it should look something like this:
2018-06-01 18:10:00 +02:00
.. figure:: images/sonoff_4ch_uart.jpg
2018-05-17 16:16:50 +02:00
:align: center
.. note::
2018-06-01 18:10:00 +02:00
On some older 4CHs, the ``RX`` and ``TX`` pins are swapped (sometimes even the written silkscreen is
2019-10-21 20:35:56 +02:00
wrong). If your upload fails with an ``error: espcomm_upload_mem failed`` message it's most likely due
2018-05-17 16:16:50 +02:00
to the pins being swapped. In that case, just swap ``RX`` and ``TX`` and try again - you won't break
anything if they're swapped.
2018-06-01 18:10:00 +02:00
.. _sonoff_4ch-creating_firmware:
2018-05-17 16:16:50 +02:00
Step 3: Creating Firmware
2018-08-24 22:44:01 +02:00
-------------------------
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
The Sonoff 4CH is based on the ``ESP8266`` platform (technically it's the ``ESP8285``, but for our purposes
they're the same) and is a subtype of the ``esp01_1m`` board.
2019-02-16 23:25:23 +01:00
With this information, you can step through the ESPHome wizard (``esphome sonoff_4ch.yaml wizard``),
2018-05-17 16:16:50 +02:00
or alternatively, you can just take the below configuration file and modify it to your needs.
.. code-block:: yaml
2018-05-17 16:16:50 +02:00
2019-02-16 23:25:23 +01:00
esphome:
2018-05-17 21:48:50 +02:00
name: <NAME_OF_NODE>
2018-05-17 16:16:50 +02:00
platform: ESP8266
board: esp01_1m
wifi:
ssid: <YOUR_SSID>
password: <YOUR_PASSWORD>
2019-02-17 12:28:17 +01:00
api:
2018-05-17 16:16:50 +02:00
logger:
ota:
2019-02-16 23:25:23 +01:00
Now run ``esphome sonoff_4ch.yaml compile`` to validate the configuration and
2018-05-17 16:16:50 +02:00
pre-compile the firmware.
2018-05-17 21:48:50 +02:00
.. note::
After this step, you will be able to find the compiled binary under
``<NAME_OF_NODE>/.pioenvs/<NAME_OF_NODE>/firmware.bin``. If you're having trouble with
uploading, you can also try uploading this file directly with other tools.
2018-05-17 16:16:50 +02:00
Step 4: Uploading Firmware
2018-08-24 22:44:01 +02:00
--------------------------
2018-05-17 16:16:50 +02:00
In order to upload the firmware, you're first going to need to get the chip into a flash mode, otherwise
the device will start up without accepting any firmware flash attempts. To do this, while the UART
2020-05-10 21:27:59 +02:00
bridge is not connected to your USB port, press and hold the bottom-left push button labelled ``FW/IO0``
2018-06-01 18:10:00 +02:00
and continue to do so while plugging in the UART bridge into your computer. Keep holding the button for
another 2-4 seconds. The 4CH should now be in a flash mode and should not blink any LED.
2018-05-17 16:16:50 +02:00
2018-06-03 11:39:32 +02:00
.. figure:: images/sonoff_4ch_buttons.jpg
:align: center
2020-05-10 21:27:59 +02:00
You need to press the button labelled ``FW/IO0`` during startup.
2018-06-03 11:39:32 +02:00
2018-05-17 16:16:50 +02:00
Now you can finally run the upload command:
.. code-block:: bash
2018-05-17 16:16:50 +02:00
2019-02-16 23:25:23 +01:00
esphome sonoff_4ch.yaml run
2018-05-17 16:16:50 +02:00
If successful, you should see something like this:
2018-06-01 18:10:00 +02:00
.. figure:: images/sonoff_4ch_upload.png
2018-05-17 16:16:50 +02:00
:align: center
2019-02-16 23:25:23 +01:00
Hooray 🎉! You've now successfully uploaded the first ESPHome firmware to your Sonoff 4CH. And in a moment,
you will be able to use all of ESPHome's great features with your Sonoff 4CH.
2018-05-17 16:16:50 +02:00
If above step don't work, however, here are some steps that can help:
2018-05-17 16:16:50 +02:00
- Sometimes the UART bridge cannot supply enough current to the chip to operate, in this
case use a 3.3V supply you have lying around. A nice hack is to use the power supply of
NodeMCU boards. Simply connect the NodeMCU's 3.3V to VCC and GND to GND. **Do not connect mains
power to the device in an attempt to overcome this problem while troubleshooting.**
2018-05-17 16:16:50 +02:00
- In other cases the ``TX`` and ``RX`` pin are reversed. Simple disconnect the device, swap
the two pins and put it into flash mode again.
Step 5: Adding the Button, Relay and LEDs
2018-08-24 22:44:01 +02:00
-----------------------------------------
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
Now we would like the 4CH to actually do something, not just connect to WiFi and pretty much sit idle.
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
Below you will find a table of all usable GPIO pins of the Sonoff 4CH and a configuration file that exposes all
2018-05-17 16:16:50 +02:00
of the basic functions.
======================================== =========================================
``GPIO0`` Button #1 (inverted)
---------------------------------------- -----------------------------------------
``GPIO9`` Button #2 (inverted)
---------------------------------------- -----------------------------------------
``GPIO10`` Button #3 (inverted)
---------------------------------------- -----------------------------------------
``GPIO14`` Button #4 (inverted)
---------------------------------------- -----------------------------------------
``GPIO12`` Relay #1 and red LED
---------------------------------------- -----------------------------------------
``GPIO5`` Relay #2 and red LED
---------------------------------------- -----------------------------------------
``GPIO4`` Relay #3 and red LED
---------------------------------------- -----------------------------------------
``GPIO15`` Relay #4 and red LED
---------------------------------------- -----------------------------------------
``GPIO13`` Blue LED (inverted)
---------------------------------------- -----------------------------------------
``GPIO1`` ``TX`` pin (for external sensors)
---------------------------------------- -----------------------------------------
``GPIO3`` ``RX`` pin (for external sensors)
---------------------------------------- -----------------------------------------
``GPIO2`` ``IO2`` pin (for external sensors)
======================================== =========================================
2018-05-17 16:16:50 +02:00
.. note::
The ESP8266 will be prevented from booting if the following pins are pulled LOW (connected to GND) on cold startup: ``GPIO0``, ``GPIO1``, ``GPIO2``. Be prepared if you want to use them for input sensors.
.. code-block:: yaml
2018-05-17 16:16:50 +02:00
2019-02-16 23:25:23 +01:00
esphome:
2018-05-17 21:48:50 +02:00
name: <NAME_OF_NODE>
2018-05-17 16:16:50 +02:00
platform: ESP8266
board: esp01_1m
wifi:
ssid: <YOUR_SSID>
password: <YOUR_PASSWORD>
2019-02-17 12:28:17 +01:00
api:
2018-05-17 16:16:50 +02:00
logger:
ota:
binary_sensor:
- platform: gpio
pin:
number: GPIO0
mode: INPUT_PULLUP
inverted: true
2018-06-01 18:10:00 +02:00
name: "Sonoff 4CH Button 1"
- platform: gpio
pin:
number: GPIO9
mode: INPUT_PULLUP
inverted: true
2018-06-01 18:10:00 +02:00
name: "Sonoff 4CH Button 2"
- platform: gpio
pin:
number: GPIO10
mode: INPUT_PULLUP
inverted: true
2018-06-01 18:10:00 +02:00
name: "Sonoff 4CH Button 3"
- platform: gpio
pin:
number: GPIO14
mode: INPUT_PULLUP
inverted: true
2018-06-01 18:10:00 +02:00
name: "Sonoff 4CH Button 4"
2018-05-17 16:16:50 +02:00
- platform: status
2018-06-01 18:10:00 +02:00
name: "Sonoff 4CH Status"
2018-05-17 21:48:50 +02:00
2018-05-17 16:16:50 +02:00
switch:
- platform: gpio
2018-06-01 18:10:00 +02:00
name: "Sonoff 4CH Relay 1"
2018-05-17 16:16:50 +02:00
pin: GPIO12
2018-06-01 18:10:00 +02:00
- platform: gpio
name: "Sonoff 4CH Relay 2"
pin: GPIO5
- platform: gpio
name: "Sonoff 4CH Relay 3"
pin: GPIO4
- platform: gpio
name: "Sonoff 4CH Relay 4"
pin: GPIO15
2018-05-17 21:48:50 +02:00
output:
2018-06-01 18:10:00 +02:00
# Register the blue LED as a dimmable output ....
2018-05-17 21:48:50 +02:00
- platform: esp8266_pwm
2018-06-01 18:10:00 +02:00
id: blue_led
pin: GPIO13
inverted: true
2018-05-17 21:48:50 +02:00
light:
# ... and then make a light out of it.
- platform: monochromatic
2018-06-01 18:10:00 +02:00
name: "Sonoff 4CH Blue LED"
output: blue_led
2018-05-17 21:48:50 +02:00
2020-05-10 21:27:59 +02:00
Above example also showcases an important concept of ESPHome: IDs and linking. In order
to make all components in ESPHome as "plug and play" as possible, you can use IDs to define
them in one area, and simply pass that ID later on. For example, above you can see a PWM (dimmer)
2018-06-01 18:10:00 +02:00
output being created with the ID ``blue_led`` for the blue LED. Later on it is then transformed
into a :doc:`monochromatic light </components/light/monochromatic>`.
2018-06-02 21:54:39 +02:00
If you additionally want the buttons to control the relays, look at `the complete Sonoff 4CH
2019-02-26 15:09:29 +01:00
with automation example <https://github.com/esphome/esphome-docs/blob/current/devices/sonoff_4ch.yaml>`__.
2018-05-17 21:48:50 +02:00
2018-06-01 18:10:00 +02:00
.. figure:: images/sonoff_4ch_result.png
2018-05-17 16:16:50 +02:00
:align: center
:width: 75.0%
Step 6: Finishing Up
2018-08-24 22:44:01 +02:00
--------------------
2018-05-17 16:16:50 +02:00
2018-06-01 18:10:00 +02:00
If you're sure everything is done with the 4CH and have double checked there's nothing that could cause a short
in the case, you can put the front cover back on and screw everything together.
2018-05-17 16:16:50 +02:00
2020-05-10 21:27:59 +02:00
Now triple- or even quadruple-check the UART bridge is not connected to the 4CH, then comes the time when you can
2018-06-01 18:10:00 +02:00
connect it.
2018-05-17 16:16:50 +02:00
Happy hacking!
2018-06-01 18:10:00 +02:00
See Also
2018-10-12 16:33:22 +02:00
--------
2018-06-01 18:10:00 +02:00
- :doc:`sonoff`
- :doc:`sonoff_s20`
- :ghedit:`Edit`