General-Purpose Input/Output (GPIO)

To configure the General-Purpose Input/Output (GPIO) of your microcontroller using our graphical user interface, you must first flash the firmware to your microcontroller. If this is your first time flashing the firmware, please read the firmware installation  guide before proceeding. 

Offline via LAN:

1. Access the Device Portal:

1. • 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.

Offline via AP-Mode:

1. Activate AP Mode:

1. • 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:

1. • 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:

1. • Open a browser and go to http://192.168.4.1, the default IP address for the device portal.

4. Login to the System:

1. • Use the following default credentials to log in:

     • Username: admin

     • Password: admin

Configuring GPIO after Login

1. Access the GPIO Configuration Interface:

1. • After logging in successfully, click on Configurations in the navigation bar.

2. Add or Modify GPIO Settings:

1. • The GUI for configuring GPIO will appear. The configuration table has five columns:

     • Device Type: Select the type of device (Analog/Digital Sensor, DHT11/22, or Shift Register for output expansion).

     • Device Name: Enter a short and unique name for the device.

     • GPIO Number: Specify the GPIO pin where the device is connected.

     • Switch: (Optional) Currently, leave this blank for future use.

     • Delete (x button): Use this to remove any unwanted rows.

Save and View Dashboard:

• Once all settings are configured based on your hardware design, click the Save button.

• You will be able to view sensor readings and control actuators in the Dashboard page, which is automatically created after configuring the GPIO settings.

Important Notes:

• Device Name and GPIO number should be unique and cannot be left empty.

Online Configuration:

1. Log in to the Web Application:

   • To configure GPIO online, you do not need to access the device portal. Configuration data will be saved in the database and transferred to the microcontroller upon successful connection.

   • First, go to https://app.iotworks.tech and log in. If you do not have an account, please register.

Add a New Device:

• If the device has not yet been added, click Add New and enter the required details.

• The system will generate a random token, which will be used to connect the microcontroller to the web application.

Configure GPIO:

• Once your device is added, go to the GPIO section in the navigation bar.

• Select the device name from the list and proceed with configuring GPIO using the interface shown earlier.