Devantech ESP32LR88, User Manual

Page 1: ...ESP32LR88 User Manual v1 6 ESP32LR88 User Manual Version 1 6 Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 1 ...

Page 2: ... the ASCII password 8 MS Sets the MQTT broker address 8 MD Sets the MQTT ID for this module 8 MP Sets the MQTT broker s port 8 MU Sets the MQTT user name V1 6 8 MW Sets the MQTT password V1 6 9 R1 R8 Sets the MQTT topic this relay is subscribed to 9 N1 N8 Sets the MQTT topic this Input will publish to 9 TCP IP Commands 10 SR Set Relay 10 GR Get Relay 10 GI Get Input 11 AL Get All 8 inputs 11 Passw...

Page 3: ...should be selected Control Protocols 1 Simple plain text commands sent to the module 2 HTML commands 3 MQTT 4 A built in webpage WiFi The ESP32LR88 connects via 2 4GHz WiFi to your network Therefore it must be located in a position where it gets a good WiFi signal The module should not be enclosed in a metal box cabinet as this will shield the WiFi signal You can check the signal level by looking ...

Page 4: ... R4Topic Relay5 Topic R5Topic Relay6 Topic R6Topic Relay7 Topic R7Topic Relay8 Topic R8Topic Input1 Topic myNew TopicA Input2 Topic myNew TopicB Input3 Topic N3Topic Input4 Topic N4Topic Input5 Topic N5Topic Input6 Topic N6Topic Input7 Topic N7Topic Input8 Topic N8Topic 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 ...

Page 5: ...ned 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 Address 192 168 0 123 SB Sets the SuBnet 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 Address 192 168 0 1 PD Sets the Primary DNS The can be the IP address of...

Page 6: ...ed Secondary DNS 8 8 4 4 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 UGA6SG OK Saved Password K kCZUV UGA6SG PA Sets the TCP IP port number for the ASCII commands PA 17126 OK Saved ASCII port number 17126 Copyright 2021 Devantech Ltd All rights reserved www rob...

Page 7: ...ally 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 MU Sets the MQTT user name V1 6 This is for MQTT brokers that are setup to require a username and password For open MQTT brokers that do not require a user name password these may be ignor...

Page 8: ...hop Heater In use the payload for relay topics should be a string with the first character set to 0 or 1 ASCII characters 0x31 0x30 N1 N8 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 ...

Page 9: ...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 GR Get Relay Will return th...

Page 10: ... are numbered from left to right 1 to 8 Password From version 1 5 we have added a password to the ASCII commands this can be set with the AP command over the USB connection The password is passed as a prefix to any command For example if a password is set and relay 1 is required to be turned on start with the password example password of 1234 then the command so it becomes 1234 SR 1 1 Copyright 20...

Page 11: ...In response the module will return an XML file which your browser will display xml version 1 0 encoding UTF 8 ESP32LR88DATA RELAYS RLY1 off RLY1 RLY2 off RLY2 RLY3 on RLY3 RLY4 off RLY4 RLY5 off RLY5 RLY6 off RLY6 RLY7 off RLY7 RLY8 off RLY8 RELAYS INPUTS INP1 1 INP1 INP2 1 INP2 INP3 1 INP3 INP4 1 INP4 INP5 1 INP5 INP6 0 INP6 INP7 1 INP7 INP8 1 INP8 INPUTS ESP32LR88DATA The XML file is generated a...

Page 12: ...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 2021 Devantech Ltd All rights reserved www robot electronics co uk 12 ...

Page 13: ...ESP32LR88 User Manual v1 6 Schematics CPU Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 13 ...

Page 14: ...ESP32LR88 User Manual v1 6 Power Supply Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 14 ...

Page 15: ...uits shown The relays are capable of switching up to 16 Amps at 24vdc or 230vac A data sheet of the relay can be found here Only the normally open N O contact has the snubber circuitry Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 15 ...

Page 16: ...up resistor to 3 3v and will operate with a simple contact closure to ground Alternatively they may be connected to 3 3v logic The clamping diodes prevent operation at voltages higher than 3 3v so don t connect to 5v logic Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 16 ...

Page 17: ...ESP32LR88 User Manual v1 6 PCB dimensions Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 17 ...

Page 18: ... be achieved by using the Arduino studio and importing the required libraries Step 1 Arduino IDE installation Obtain and install the latest Arduino IDE from https www arduino cc en Main Software it should be the latest to ensure compatibility Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 18 ...

Page 19: ...ow we need to enter https dl espressif com dl package_esp32_index json into the Additional Board Manager URLs option If you already have libraries added you may need to add a comma between the URLs You can now click the OK button to finish with this screen Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 19 ...

Page 20: ...ESP32LR88 User Manual v1 6 Step 3 Install the ESP32 library Go to Tools Board Boards Manager Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 20 ...

Page 21: ...ESP32LR88 User Manual v1 6 Now filter by esp32 and install the Espressif Systems library Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 21 ...

Page 22: ...ESP32LR88 User Manual v1 6 Step 4 Board selection Go to Tools Board and select ESP32 Dev Module Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 22 ...

Page 23: ...ent and select PubSubClient by Nick O Leary then press the install button That s it Your Arduino IDE should now be able to program the ESP32LR88 module The factory shipped code is available Here https github com devantech Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 23 ...

Page 24: ...ESP32LR88 User Manual v1 6 Notes Copyright 2021 Devantech Ltd All rights reserved www robot electronics co uk 24 ...