Setting from Browser

obnizOS is itself a Wi-Fi access point and can be configured from your browser.

Connecting to the ESP32 as an access point

This setting is possible under the following conditions

  1. Wi-Fi or Ethernet, but the network is not yet selected
  2. if you selected Wi-Fi but failed to connect or couldn't find a possible connection

The ESP32 is outputting Wi-Fi with the above mentioned status. You can select SSID, password and IP address by connecting to it from your smartphone.

1 Connect to the ESP32's Wi-Fi

Connect to the ESP32's Wi-Fi with a smartphone or other device. The name of the Wi-Fi will be obniz-XXXXXXXXXX.

2 Open in your browser

The URL may vary depending on the OS version.

obnizOS 3.0.2 or olderhttp://
obnizOS 3.0.3 or laterhttp://

Here's what to do if you can open a page in your browser from your smartphone or other device to set up your settings, but you can't open that page.

If this happens, set the smartphone or other device you want to view to Airplane mode and connect only to Wi-Fi.

After that, open it again in your browser and it may work.

3 Set up in your browser

Wi-Fi Settings.

Select the SSID of the Wi-Fi you want to connect to from the pull-down menu, and enter the password in alphanumeric characters.

If you want to set up Wi-Fi for the Secret SSID, select "OtherNetwork" in the SSID selection field and enter the SSID in the SSID entry field.

If you want to set up a static IP or Proxy, go to "Option Setting".

The fixed IP can be set in the

  • fixed IP address
  • subnet mask
  • gateway IP address
  • DNS server IP address

It is not possible to set only one of them, but you must enter values for all of them. It is not possible to set only one of them, but you must enter values for all of them.

If you need to set up proxy settings, use the

  • The IP address of the proxy server (obnizOS3.1.0 or later)
  • Port number of the proxy server (obnizOS3.1.0 or later)

is configurable.

Press "Connect" to try to connect. Regardless of success or failure, your browser will display the following. The browser will be displayed differently on each OS.

obnizOS 3.0.2 or olderIt shows "can't be opned"
obnizOS 3.1.0 or laterIt shows "Accepted and connecting"

If it is successful, you will be online. If it fails, you will be back to the original state, so please check your password and try again.

Hidden SSID.

Supported since obnizOS 3.2.0
Save it as a stealth SSID and it will actively connect regardless of the Wi-Fi scan results.

Select the Other Network item in the SSID section of the settings screen.

Select the field labeled "Other Network" and you will see a field for entering the SSID and Password that you want to connect to.

If obnizOS is below from 3.4.1, you need to choose "Enable" and select to connect to a private SSID.

OptionSetting allows you to set up proxies and static addresses.

Ethernet Setting

Select LAN under Network Settings and you will see the following screen.

Choose the connection module and select Phy Base Address.

If it is LAN8720, choose 0 or 1.
For a TLK110 it's 31.

Set the Clock Mode, which is how to synchronize the PHY transceiver with the ESP32

Setting Description
IO0 IN GPIO0 become clock input
IO0 OUT GPIO0 become 50Mhz clock output from internal APLL
IO16 OUT GPIO16 become 50Mhz clock output from internal APLL
IO17 OUT GPIO17 become 50Mhz reversed clock output from internal APLL

This is how to reset the PHY transceiver from the ESP side.

Setting Description
0-40 specified GPIO will output reset
41 just module reset.

Set MDC and MDIO to the connected GPIOs.

Cellular Settings.

Select LTE under Network Settings and you'll see the following screen.

Select a communication module and configure the IO settings for each module.

For BG96, you can set Power GPIOs and Reset GPIOs; for SARA-U2, there are no additional items.

The Uart Index 0 is the same as obniz's Uart which is logged, Uart Index 1 and 2 allow you to specify from which GPIO to send signals.

APN, ID and Password should be provided by your carrier in each field.