Devantech ESP32LR42 User manual

ESP32LR42 User Manual v1.02
ESP32LR42
User Manual Version 1.02
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 1

ESP32LR42 User Manual v1.02
Table of Contents
Overview....................................................................................................................................................3
Control Protocols.......................................................................................................................................3
WiFi............................................................................................................................................................3
Configuration.............................................................................................................................................3
USB Configuration Comman s.................................................................................................................4
ST Status. Return the system status.......................................................................................................4
RB ReBoot............................................................................................................................................4
IP Sets the mo ules IP a ress..............................................................................................................5
SB Sets the SuBnet mask......................................................................................................................5
GW Sets the GateWay a ress..............................................................................................................5
PD Sets the Primary DNS.....................................................................................................................5
SD Sets the Secon ary DNS.................................................................................................................5
SS This sets the SSID............................................................................................................................6
PW Sets your networks WIFI passwor ................................................................................................6
PA Sets the TCP/IP port number for the ASCII comman s..................................................................6
MS Sets the MQTT broker a ress.......................................................................................................7
MD Sets the MQTT ID for this mo ule................................................................................................7
MP Sets the MQTT broker’s port..........................................................................................................7
R1-R4 Sets the MQTT topic this relay is subscribe to........................................................................7
N1-N2 Sets the MQTT topic this Input will publish to.........................................................................7
TCP/IP Comman s.....................................................................................................................................8
SR Set Relay..........................................................................................................................................8
GR Get Relay.........................................................................................................................................9
GI Get Input...........................................................................................................................................9
AL Get All 2 inputs...............................................................................................................................9
HTML Comman s...................................................................................................................................10
Webpage...................................................................................................................................................11
Schematics...............................................................................................................................................12
CPU.....................................................................................................................................................12
Power Supply......................................................................................................................................13
Relay Outputs......................................................................................................................................14
Digital Input........................................................................................................................................15
PCB imensions.......................................................................................................................................16
Notes........................................................................................................................................................17
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 2

ESP32LR42 User Manual v1.02
Overview
The ESP32LR42 is a WIFI connecte relay mo ule using the popular ESP32.
It provi es 4 relays capable switching up to 16Amps an 2 igital inputs with pull-ups than can
interface irectly with volt free contacts. The normally open relay contacts have snubbers fitte across
them, an can rive in uctive loa s such as contactors an solenoi s.
Power for the boar is 12v c, which can be provi e by a stan ar universal wall power supply. A 1A
or greater supply shoul be selecte .
Control Protocols
1. Simple plain text comman s sent to the mo ule.
2. HTML comman s
3. MQTT
4. A built in webpage
WiFi
The ESP32LR42 connects via WiFi to your network. Therefore it must be locate in a position where it
gets a goo WiFi signal. The mo ule shoul not be enclose in a metal box/cabinet as this will shiel
the WiFi signal.
You can check the signal level by looking at the RSSI figure which is reporte by the ST (STatus)
comman .
Configuration
The ESP32LR42 is configure by connecting a USB cable to your PC an running a terminal program.
PuTTY is a goo option if you on’t have any other preferences.
The serial port shoul be set to 115200 bau , 8 bit, 1 stop, no parity, no flow control.
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 3

ESP32LR42 User Manual v1.02
US Configuration Commands
ST Status. Return the system status
Status:
Firmware Version: 1.2
IP: 0.0.0.0 (192.168.0.30)
Subnet: 0.0.0.0
Gateway: 0.0.0.0
Primary DNS: 0.0.0.0
Secondary DNS: 0.0.0.0
SSID: ********
Password: ********
SCII TCP Port: 17123
RSSI: -66
MQTT Server: 192.168.0.115
MQTT Port: 1883
MQTT ID: ESP32LR42
Relay1 Topic: R1Topic
Relay2 Topic: R2Topic
Relay3 Topic: R3Topic
Relay4 Topic: R4Topic
Input1 Topic: Input1Topic
Input2 Topic: Input2Topic
When the IP address is set to 0.0.0.0 this means that the IP address is being provided by
your networks DHCP server. In that case the assigned IP address is also provided, as
above.
When the SSID and Password are setup, they will be displayed until the next reset, fter
that they will only show as ********.
R Re oot.
This will restart the module. It may produce a lot of random characters as the
ESP32’s boot logging runs at a different baud rate. If it succeeds in connecting to your
network it will report the IP address.
Re-Booting.. .
崳⸮⸮⸮⸮⸮⸮⸮⸮#XL###C 5)5) ia b⸮⸮⸮⸮⸮ ⸮⸮⸮ ⸮ ⸮⸮⸮⸮⸮⸮⸮⸮奅# UY o ##i#U 5⸮⸮*⸮⸮ ⸮ ⸮⸮⸮⸮⸮ ⸮ Q⸮ ⸮⸮⸮⸮⸮
WiFi connected.
IP address:
192.168.0.6
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 4

ESP32LR42 User Manual v1.02
IP Sets the modules IP address.
Enter IP followed by the required IP address. Entering address 0.0.0.0 means the IP will be
obtained from your networks DHCP server. The new IP address will take effect after the
next re-boot.
IP “192.168.0.123”
OK. Saved IP ddress: 192.168.0.123
S Sets the Su net mask.
SB “255.255.255.0”
OK. Saved Subnet Mask: 255.255.255.0
GW Sets the GateWay address.
This is normally the IP address of your router.
GW “192.168.0.1”
OK. Saved Gateway ddress: 192.168.0.1
PD Sets the Primary DNS.
The can be the IP address of your router which will then use your ISP provided DNS.
You can also specify the DNS such as 8.8.8.8 for Googles DNS server.
PD “192.168.0.1”
OK. Saved Primary DNS: 192.168.0.1
SD Sets the Secondary DNS.
The can be the IP address of your router which will then use your ISP provided DNS.
You can also specify the DNS such as 8.8.4.4 for Googles DNS server.
SD “8.8.4.4”
OK. Saved Secondary DNS: 8.8.4.4
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 5

ESP32LR42 User Manual v1.02
SS This sets the SSID.
The SSID is the public name of your WIFI network Enter your WIFI’s SSID here.
SS “Devantech”
OK. Saved SSID: Devantech
PW Sets your networks WIFI password.
PW "K]~kCZUV*UG 6SG~"
OK. Saved Password: K]~kCZUV*UG 6SG~
PA Sets the TCP/IP port number for the ASCII commands.
P 17126
OK. Saved SCII port number: 17126
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 6

ESP32LR42 User Manual v1.02
MS Sets the MQTT broker address
MS “192.168.0.121”
OK. Saved MQTT Server: 192.168.0.121
MD Sets the MQTT ID for this module
MS “UniqueModuleName”
OK. Saved MQTT ID: UniqueModuleName
MP Sets the MQTT broker’s port.
Normally, this should be set to 1883.
mp 1883
OK. Saved MQTT port number: 1883
If you are not using MQTT, set the port to 0. This will turn off MQTT, otherwise it will continuously
try to connect if there is no MQTT broker.
R1-R4 Sets the MQTT topic this relay is subscribed to.
R3 "Workshop/Heater"
OK. Saved Relay 3 Topic: Workshop/Heater
In use, the payload for relay topics should be a string with the first character set to ‘0’ or ‘1’
( SCII characters 0x31/0x30).
N1-N2 Sets the MQTT topic this Input will publish to.
N2 "Workshop/Heater"
OK. Saved Input 2 Topic: Workshop/Heater
The payload generated for input topics is a string with the first character set to ‘1’ if the input is
open or unconnected, and ‘0’ if the input pins are shorted. ( SCII characters 0x31/0x30).
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 7

ESP32LR42 User Manual v1.02
TCP/IP Commands.
The ESP32LR42 has a built in TCP/IP command set which allows you to control the module
remotely.
ll commands are sent using plain SCII text. PuTTY is a good cross platform terminal program to
use for testing. The TCP/IP port is the one you set-up with the P command during USB
configuration. Do not use port 80 as that is reserved for the HTML commands and Webpage.
SR Set Relay.
This is used to turn a relay on or off
To turn Relay 1 on:
SR 1 1
The first number is the relay number from 1 to 8.
The second number is 1 or 0, on or off.
So turn turn relay 1 off again:
SR 1 0
The command will respond with ok or fail.
SR 1 1
ok
SR 1 6
fail < 6 is not valid, only 1 or 0 for on/off
SR 9 1
fail < relay 9 does not exist.
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 8

ESP32LR42 User Manual v1.02
GR Get Relay.
Will return the state of the relay.
To get the status of relay 3:
GR 3
1
GR 3
0
GR 9
fail < relay 9 does not exist.
GI Get Input.
Will return the status of an input.
GI 2
0 Input 2 is low (Green Led is on)
GI 2 Input 2 is high (Green Led is off)
1
GI 9
fail Only 2 inputs available
AL Get All 2 inputs.
L
10 Here, Input 2 is low, all others are high.
Inputs are numbered from left to right, 1 to 2.
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 9

ESP32LR42 User Manual v1.02
HTML Commands.
There are a set of HTML commands that can be used to control the module.
?Rly3=1 This will turn on relay 3
?Rly3=0 This will turn off relay 3
?Rly3=2 This will toggle relay 3 to the opposite state.
You can enter the commands into a browser immediately after the IP address.
http://192.168.0.3/?Rly3=1
This will turn on relay 3.
In response the module will return an XML file, which your browser will display.
<ESP32LR42D T >
<REL YS>
<RLY1>off</RLY1>
<RLY2>on</RLY2>
<RLY3>on</RLY3>
<RLY4>on</RLY4>
</REL YS>
<INPUTS>
<INP1>1</INP1>
<INP2>0</INP2>
</INPUTS>
</ESP32LR42D T >
The XML file is generated after the command has executed, therefore will reflect the new status of
the relays.
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 10

ESP32LR42 User Manual v1.02
Webpage
The built in webpage can be used as a remote app to monitor and control the relays. Your can
access the page as a default with just the IP address or by specifying index.htm.
The webpage contains the Javascript to send an HTML toggle command, as described in the
previous section. It will send the toggle command each time a button is clicked. It then uses the
responding XML file to colour the buttons and set the Input buttons to indicate input status.
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 11

ESP32LR42 User Manual v1.02
Schematics
CPU
Note.
The CPU schematic is the same for the ESP32LR20, ESP32LR42 an ESP32LR88.
Relays 5-8 an Inputs 3-8 are not available on the ESP32LR42.
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 12

ESP32LR42 User Manual v1.02
Power Supply
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 13

ESP32LR42 User Manual v1.02
Relay Outputs
1 of 4 i entical circuits shown
The relays are capable of switching up to 16 Amps at 24v c or 230vac. A ata sheet of the relay can be
foun here. Only the normally open (N/O) contact has the snubber circuitry.
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 14

ESP32LR42 User Manual v1.02
Digital Input
1 of 2 i entical circuits shown
Digital Inputs have a pull-up resistor to 3.3v an will operate with a simple contact closure to groun .
Alternatively, they may be connecte to 3.3v logic. The clamping io es prevent operation at voltages
higher than 3.3v, so on’t connect to 5v logic.
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 15

ESP32LR42 User Manual v1.02
PC dimensions
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 16

ESP32LR42 User Manual v1.02
Notes
Copyright © 2018, Devantech Ltd.
ll rights reserved. www.robot-electronics.co.uk 17