Getting Started

0. Requisites

Hardware

• ESP8266 or ESP32 Development Board (NodeMCU or Wemos D1 mini for example)
• Computer (tested with Windows 10 OS)
• USB cable compatible with ESP8266 or ESP32 Development Board
• Local WiFi Network 802.11 2.4 GHz

IDE

• Arduino IDE (version 14)
• For ESP32 1.0.6 https://github.com/espressif/arduino-esp32 https://dl.espressif.com/dl/package_esp32_index.json
• For ESP8266 2.7.4 https://github.com/esp8266/Arduino http://arduino.esp8266.com/stable/package_esp8266com_index.json

Libraries

• EOS (folder eos_lib from this repository)
• TimeLib.h 1.6 by Michael Margolis https://github.com/PaulStoffregen/Time
• qrcode.h 0.0.1 by Richard Moore https://github.com/ricmoo/QRCode
• SSD1306Wire.h 4.0.2 by ThingPulse https://github.com/ThingPulse/esp8266-oled-ssd1306
• ESP32Ping.h 1.5 by Daniele Colanardi https://github.com/marian-craciunescu/ESP32Ping
• ESP8266Ping.h 1.0 by Daniele Colanardi https://github.com/dancol90/ESP8266Ping
• TFT_eSPI.h by Bodmer https://github.com/Bodmer/TFT_eSPI
• OneWire 2.3.5 by Jim Studt https://github.com/PaulStoffregen/OneWire
• PubSubClient.h 2.8 by Nick O'Leary https://github.com/knolleary/pubsubclient

Files

• Folder html in this repository

1. Development Environment Setup

1. Open Arduino IDE in the Computer. It must have support to the development board you have, and the libraries listed above. Select your board (ESP8266 or ESP32) in the Arduino IDE.
2. Connect your ESP8266/ESP32 Development Module using the USB cable to the Computer, and select the USB Port in the Arduino IDE.
3. Open the eos_lib.ino example of the library eos_lib.
4. Compile and upload your firmware in your development board using the Arduino IDE and the USB cable.

2. IoT Module Setup

1. Download the files of the folder html from this repository in your computer.
2. Connect your computer directly to your IoT module by connecting to the eos_ WiFi network.
3. Go to http://192.168.4.1 address using your browser (tested with Google Chrome). If the network is not available, it has been automatically disabled after some time. In this case, reset the module.
4. Click in the "File Upload" button.
5. Click in the box after the title and select the "arquivos.htm" file. Click in "Upload", and then return to http://192.168.4.1.
6. Click in the "arquivos" link. Select the remaining files (from the folder html from this repository) and upload them to your IoT module (one by one).
7. Return to http://192.168.4.1. Click in the "WiFi" button.
8. Wait for the network discovery, and then select your local WiFi network. Type your password and click in the "Conectar" button.
9. If the module is successfully connected to the WiFi, it will blink the built-in led with a 101010 pattern. If not, it will blink in a 110110 pattern.
10. Reconnect your computer to your local WiFi network, and check the available WiFi networks. Check the eos_- network to obtain the IPaddress.
11. Open a browser and connect to http://192.168.0. using the IPaddress you obtained in the previous step.

3. Save your first sketch and update your module over the air

1. Save the eos_lib.ino example in your computer using the Arduino IDE, and rename it to your liking.
2. Change the "Versao" from "eos_lib" to the name you provided in the previous step.
3. Export your binary file using Ctrl+Alt+S or under the Sketch tab in the Arduino IDE.
4. Open a browser and connect to http://192.168.0., and click in "Update".
5. Select the binary file (it is in the same folder where you saved the example with the new name), and click in the "Update" button.
6. If it is successfull, then in the page http://192.168.0. you will see the new name in the bottom of the page.

4. And then?

Congratulations, you have setup your development environment and have successfully prepared, connected, and updated an IoT module.

Next steps: check the oscilloscope, status, config (MQTT), log pages to learn about the development tools available.