Configuring the ESP32

Configuring the ESP32

Now that we've created a device for the ESP32 in the application, we can utilize the provided credentials with the Zoho IOT Arduino SDK. This setup allows us to establish a connection to the Zoho IOT application, enabling us to send soil moisture data and control the setup remotely through the application.

Downloading the Zoho IOT Arduino SDK

First, we need to download the SDK zip file from git.

To download the SDK,
  2. Click on the latest release in the Release section.



  3. Click on Source Code (zip) to download the latest SDK zip file. A file name zoho-iot-sdk-arduino-x.x.x.zip will be downloaded. Here, x.x.x will depend on the latest build number.


NotesNote: Find out the location/path where the zip file is downloaded.

Downloading the Arduino IDE

The SDK and the script file will be uploaded to the ESP32 using the Arduino IDE.

To download the Arduino IDE,
  2. Download the IDE package based on your system.



  3. Install the downloaded package in your Mac or PC.

Accessing the Connection Credentials

You can access the connection credentials of the registered device with the following steps.
  1. Select Devices > Devices in the left pane.
  2. Click the name of the device you want the connection credentials for. For this illustration, My ESP(Device created in the previous step) is selected. This will open the device's information page.



  3. Click Actions > Connection Credentials. The connection credentials of that specific device will be displayed.



    The connection credentials will now be displayed.

Note: Keep the connection credentials tab open in your browser, as this will allow you to easily copy and paste the credentials.

Configuring the ESP32

With the necessary packages downloaded, the IDE installed, and the ESP32 connected to your computer, you are now ready to configure the ESP32 with the connection credentials of your registered device and establish a connection with the Zoho IOT application.
NotesNote: Ensure you maintain a stable internet connection for the upcoming steps.
To onboard the ESP32,
  1. Connect the ESP32 to your Mac or PC using the appropriate cable and adapters.



  2. Open the Arduino IDE. 



    Notes
    Note: Click Open or Proceed if a do you want proceed pop up appears.
  3. Select Boards Manager in the left pane.



  4. Search for esp32 and Install esp32 by Expressif Systems.



    NotesNote: This will take several minutes.

  5. Select Sketch > Include Library > Add.ZIP Library.



  6. Go to the location of the downloaded Arduino SDK > Select zoho-iot-sdk-arduino-x.x.x.zip file > click Open. Replace x.x.x with the latest version number. The SDK library will be installed.



  7. Select Files > Examples > ZOHO-IOT-SDK > esp32_soil_moisture_sensor. Scroll down to the last to find ZOHO-IOT-SDK. The program will now be loaded.



  8. Replace Wifi_ssid with the WiFi name and Wifi_password with the corresponding wifi password.



  9. Replace /mqtt_domain_name/v1/devices/client_id/connect with the Username from the connection credentials of My ESP device. (Device created in the Zoho IOT application).



  10. Replace mqtt_password with the Password/Authentication Token form the connection credentials of My ESP device (Device created in the Zoho IOT application).



  11. Click on Select Board > Select Other Board and Port.



  12. Search for your ESP32 board. For this illustration, DOIT ESP32 DEVKIT V1 is selected > Select the port of the esp32 connected to your Mac or PC.



  13. Click the Upload button.


The program will now be uploaded to the connected ESP32 board.