The Device Settings page is essential for configuring your microcontroller so it can be accessed, monitored, and controlled online via our platform. This guide will help you configure the microcontroller settings for Wi-Fi, MQTT, and connecting to our online web applications.
Important: Before accessing the device settings page, you must have flashed the firmware to your microcontroller. If you haven't done so, please refer to the Firmware Installation instructions first.
1. Access the Device Portal:
First, connect to the device portal by accessing the device's IP address in your browser.
If your hardware design includes an OLED display, the IP address will be visible on the OLED screen.
If there is no OLED display, you can find the IP address by opening our web application and navigating to Logs & Console under the Firmware section.
Ensure the microcontroller is still connected to your computer via USB during this step.
2. Find the IP Address:
After opening Logs & Console, locate the device’s IP address in the console.
If no text appears, restart the microcontroller.
1. Activate AP Mode:
If you want to use the ESP microcontroller's Wi-Fi Access Point (AP) mode, press the AP-Mode button (connected to GPIO 21 in the hardware design) for at least 5 seconds.
The device will then switch to AP-Mode.
2. Connect to the Microcontroller:
Connect your computer or mobile device to the microcontroller's Wi-Fi SSID. No password is required.
Ensure that your mobile device is not using mobile data during this connection.
3. Access the Portal:
Open a browser and go to http://192.168.4.1, the default IP address for the device portal.
4. Login to the System:
Use the following default credentials to log in:
Username: admin
Password: admin
1. Accessing the Device Settings Page
To configure your device, click on Settings in the navigation bar of the device portal. This will take you to the device settings page.
2. Configuring Wi-Fi Settings
The first section of the device settings page is dedicated to Wi-Fi configuration. This allows your microcontroller to connect to your Wi-Fi network for communication with the IoT platform.
Step 1: In the Wi-Fi Settings section, enter the SSID (Wi-Fi network name) and the Password for the Wi-Fi network you wish to connect to.
Step 2: Ensure that the Wi-Fi network is within range and operates at 2.4 GHz, as ESP32 microcontrollers do not support 5 GHz networks.
Step 3: After entering the details, click the Save button.
The microcontroller will restart and reconnect to the network.
Once connected, the microcontroller will automatically populate the Wi-Fi SSID in the input box if it’s already configured.
3. Configuring MQTT Settings
Next, you'll configure the MQTT settings, which allow the microcontroller to communicate with the MQTT broker for data exchange.
Step 1: In the MQTT Settings section, input the following:
Address: mqtt.iotworks.tech
Port: 1883
Username: Leave this field empty.
Password: Leave this field empty.
Step 2: Click the Save button to store the MQTT settings.
4. Connecting the Device to the Online Platform
In the final section, you will configure the device to connect to the IoT web application. You will need to input the Host/DNS and the Authentication Token to establish the connection.
Step 1: In the IoT Cloud Settings section, input the following details:
Host/DNS: https://app.iotworks.tech
Token: The token is automatically generated when you create a new device in the online platform. Copy and paste the token from the platform’s AuthToken field into the corresponding field in the settings.
Step 2: After entering these details, click the Save button to save the configurations.
Step 3: Restart the device to apply the changes and connect it to the online platform. Once the device is successfully connected, it will sync with the web application.
Only 2.4 GHz Wi-Fi signals are supported by the ESP32 microcontroller. Make sure you are connecting to the correct frequency.
The Authentication Token is unique for each device and is generated automatically in the web application when a new device is created. Ensure you copy and paste the correct token for your device.
After saving your configurations, always Restart the microcontroller to apply the new settings.
If you face connection issues, check the Logs & Console section for additional debugging information.