Skip to content

Getting to the Configuration Portal

jbaumann edited this page Aug 4, 2022 · 5 revisions

Entering the Portal Mode

When the ESP32 turns on it starts to check the button connected to GPIO0 (this button is labelled PROG). You can also use the alternative trigger pin if you have configured it. During the execution of its normal loop it checks the button repeatedly, and if it has been pressed for more than a second, it enters the portal mode. If you don't want to wait until the RTC turns the ESP32 on, then press the power button until the LED turns on.

The small challenge with the default button connected to GPIO0 is that this pin is also used to enter the programming mode, when booting. Thus, if you simply press the button before the ESP32 is turned on by the RTC, then this programming mode is entered when the ESP32 starts execution. So, to enter the portal mode, wait until the LED comes on, and then press the button, and keep it pressed until the LED starts blinking.

When the portal mode has been entered, the LED flashes in a 1s interval. Now point your browser to the IP address of your H32 device and you will see the main portal page.

If you have configured an alternative trigger pin, then pulling this pin to GND for at least 1 second during the wake time of the ESP e.g., by connecting a button that you press, switches to the portal mode. I personally configure GPIO 5, and if I want to enter the portal mode, simply connect it to GND with a wire. The next time the ESP wakes up it automatically switches to portal mode.

The Main Portal Page

The main portal page looks as follows:

The buttons have the following meaning:

Button Meaning
Configure WiFi This leads to a page where you can enter / update your WiFi configuration
Setup This is the main configuration page containing all firmware configuration options
Info Here you get a page that shows a lot of information of the ESP and of the WiFi connection
Restart This button resets the ESP32
Update This button allows to select a new firmware on your computer to upload the the H32 board
Erase This button deletes the configuration information