Arduino MCU
This feature is not included in precompiled binaries
When compiling your build add the following to user_config_override.h
:
#ifndef USE_TASMOTA_CLIENT
#define USE_TASMOTA_CLIENT // Enable the driver
#endif
#ifndef USE_TASMOTA_CLIENT_FLASH_SPEED
#define USE_TASMOTA_CLIENT_FLASH_SPEED 57600 // Configure the baud rate of the bootloader
#endif
#ifndef USE_TASMOTA_CLIENT_SERIAL_SPEED 57600
#define USE_TASMOTA_CLIENT_SERIAL_SPEED 57600 // Configure the baud rate at which the client microcontroller will be interfacing to Tasmota
#endif
It is possible to amend your existing Arduino Uno/Mini/Nano project to interface with a Tasmota powered ESP8266/ESP8285 generic development boards such as the Wemos D1 or NodeMCU branded hardware boards.
The creation of a client driver interface implemented since Tasmota 7.0.0.2 enables this possibility.
Please note that the USE_TASMOTA_CLIENT_FLASH_SPEED
will depend on the variant of Arduino Uno/Mini/Nano board you are using - The general observation is that the 3.3V devices usually run at 57600 whereas the 5V devices usually run on 115200 but this is provided for guidance only as it has been found that some boards will not necessarily adhere to this. The main driving factor behind the baud rate is the crystal oscillator on the board which is usually 8Mhz for 3.3V variants and 16Mhz for 5V variants - hence 57600 being 1/2 of 115200.
It should also be noted that this option is only really applicable if you're actually using an Arduino UNO/Mini/Nano as a client device and you want to be able to update the firmware on the Arduino OTA via the Tasmota Web UI.
If you are using another type of microcontroller, obviously the OTA update functionality will not work (for now, until support is added for other microcontrollers). But if you are able to program the device manually there is no reason why you cannot use any microcontroller or development board as a client to your Tasmota powered ESP8266/8285 hardware.
Once you have compiled your own variant with the correct settings and flashed the self-compiled binary to your Tasmota device it is time to make the necessary configuration within Tasmota.
Configuring Tasmota to use the TasmotaClient functionality~
The communication interface between Tasmota and your client micro-controller will be over serial communication. To make this possible you will need to configure two of the GPIO pins to Client TX
and Client RX
respectively. In addition to this you also need to define the GPIO which will be used to pull the reset pin of your client microcontroller down to GND or up to 3.3V, so either Client RST
for normal reset behaviour (active low) or Client RSTi
for inverted reset behaviour (active high)
As mentioned above it is possible to connect any microcontroller of your choice but for the purpose of this article, only the implementation of an Arduino Pro Mini (3.3V) will be covered.
Getting things wired up~
With Tasmota GPIO configuration provided above you may now proceed to make the necessary electrical connections between the ESP8266/ESP8285 and your client device, for example:
ESP | Arduino Pro Mini (3.3V) |
---|---|
VCC | VCC |
GND | GND |
D2 (GPIO4) | RX (0) |
D1 (GPIO5) | TX (1) |
D4 (GPIO2) | Reset (RST) |
So to visualize the above:
Please verify your specific board's pin naming as they are not always exactly the same depending on where they came from!
Compiling a test sketch for the client~
The TasmotaClient driver requires your client to operate within specific parameters allowed by the driver itself so head over to the TasmotaClient Library and install the library in your local Arduino development environment.
Once installed you should be able to access the examples from the menu system:
Make sure you have the correct board and speed selected:
Now that everything is set, it's time to export the compiled binary by selecting it from the Arduino menu:
Once completed head over to the known folder you chose in previous steps and locate the .hex
file which should be in the same folder as where your sketch was originally saved to.
You will most likely see a file listing like this:
You are interested in Blink.ino.eightanaloginputs.hex
and can ignore the one which has bootloader
as part of the file name since the Arduino Pro Mini already has the bootloader flashed. Take note of the location and name of this file as you will need it in the next step to upload the compiled file to your client device.
Uploading a new hex file to your client device~
If you are using an Arduino Pro Mini as is the case in this example you would have created a .hex
file in the previous step. This file can be flashed directly to the Arduino Pro Mini via the Tasmota Web UI.
Navigate to the Firmware Upgrade page where you would normally upload a new binary file to upgrade Tasmota. The same method is used to upload a HEX
file to the client device. Tasmota will automatically decide where it will flash the upload based on whether you're uploading a .bin
file or a .hex
file.
Tasmota will prompt you for the firmware file you wish to upload - You need to navigate to the previously known location folder you chose in earlier steps and select the .hex
file previously identified:
After selecting the hex file you may proceed to click the Start Upgrade button:
The hex
file will upload to Tasmota and Tasmota will flash the new client firmware onto the Arduino Pro Mini and present you with the following web page:
After the device completes a restart you should now have an Arduino Pro Mini running as a client where the blink is controlled from Tasmota's internal one-second callback.