Network Configration

obnizOS for ESP32 can connect to the internet by using belows

  • Wi-Fi (b/g/n 2g)
  • Ethernet (10M/100M)

Wi-Fi needs antenna. Ethernet needs PHY transceiver (LAN8720 or TLK110) and connector.

Ethernet available with obnizOS 2.1.0 and later

See more at release notes


Configration is done from one of below two methods.

  • serial communication

  • connectin ESP32 via W-Fi (Wi-Fi only) (obnizOS 2.1.0 and later)

    obniz_cli which is used for flashing obnizOS will start serial communication after flashing see more detail at Install obnizOS.

2. Connect and configure by connecting ESP32 via Wi-Fi (obnizOS 2.1.0 and later)

ESP32 is available as Wi-Fi access point when

  1. Wi-Fi or Ethernet is not choosen yet.
  2. Wi-Fi was choosen. But connection failed or no known Wi-Fi found.

By connecting it Wi-Fi, choosing SSID and typeing password is done on a smartphone.

2-1 Connect to ESP32 Wi-Fi

It SSID is obniz-XXXXXXXX. Connect to that SSID.

2-2 Passowrd

On the same smartphone, Open the page on your browser Then configration page will appeaer.

Choose SSID from pull down and type a password for that.
Then press "Connect" Button.
ESP32 start connection immidiately and your browser shows "can't open page".
When success, your ESP32 will be online otherwise return to same state.

To configure static ip, Press "Option Setting".

You can configure

  • Static IP Address
  • SubnetMask
  • Gateway IP Address
  • DNS Server IP Address

You need to fill all of these parameters.

Configration via Serial - Network

It start from choosing network type.

  1. Wi-Fi or Ethernet
  2. When Wi-Fi, ssid and password type then choosing IP aquiring method.
  3. When Ethernet, PHY transceiver configrations.

First step is choosing Wi-Fi or Ethernet.

-----Select Interface-----

0:Wireless LAN(default)
1:Wired LAN:

Type 0 for Wi-Fi or 1 for Ethernet.
All selection will timtout after 60 seconds. If selections has no default selection, then ESP32 will reboot. Otherwise, default selection will be choosen.

Configration via Serial - Wi-Fi

In Wi-Fi mode, ESP32 start Wi-Fi Scannnig and wait for ssid selection.

Wi-Fi Scanning...

---Nearby SSID List---
 - obniz_wifi
 - AirPortXXX
 - freewifi2g-2019

Enter SSID-Pass

Type SSID want to connect to and press Enter.
Then ESP32 will ask password.


In password typing, characters you type will never printed.
After pressing enter ESP32 will try to connect.

Wi-Fi Connecting SSID: obniz_wifi

When it fail, ESP32 will scan again. After connection estabilished, ESP32 will ask IP aquiation method. 0 for DHCP 1 for static IP. If you are not familiar with IP, It may be DHCP.

select Network
1:Static IP: 

With DHCP, It will start connection to obniz cloud then show online when success.

Connecting Cloud

With Static IP, Below settings will be asked. All of below settings are needed to use static IP. No empty will be accepted.

IP Address: 
Default Gateway: 
Subnet Mask: 
DNS Address: 

After done, ESP32 will start connection to obniz cloud then show online when success.

Connecting Cloud

Configration via Serial - Ethernet

In Ethernet mode, ESP32 will ask PHY transceiver connection settings.

--- Phy Base Address ---

First PHY transciver base address. It depends on transceiver you use.

In case ofLAN8720, It should 0 or 1.
In case of TLK110, It should 31.

--- Clock Mode ---
0:IO0 IN
2:IO16 OUT
3:IO17 OUT

Clock synchronize method between ESP32 and PHY transciever.

Option Description
IO0 IN Input external clock in GPIO0
IO0 OUT Output internal APLL 50Mhz clock from GPIO0
IO16 OUT Output internal APLL 50Mhz clock from GPIO16
IO17 OUT Output inverted internal APLL 50Mhz clock from GPIO17
--- Power Mode ---
0-40:GPIO reset + module reset
41:only module reset:

Reset method for PHY transciever.

Option Description
0-40 Use hardware and module reset with GPIOXX
41 Only module reset
--- MDC GPIO ---

GPIO number which is connected to MDC of PHY transciever.

--- MDIO GPIO ---

GPIO number which is connected to MDIO of PHY transciever.

--- CHIP ---

Choose a PHY transciever from two option.

That's all. ESP32 will show settings you set then save it.

---Check Data---
ClockMode : 3
PowerMode : 5
CHIP : 0


After saving, ESP32 will try to obniz cloud. then show online when success.

Connecting Cloud

Reset Configration

After boot or when connection to the cloud is not established, ESP32 will ask you to enter setting mode or not. It is very short time, about 0.5 sec.

Press 's' to setting mode: s

Press s to enter setting.

-----Select Setting-----

1:Interface(Wireless LAN or Wired LAN)
2:All Reset
3:Wireless LAN Reset
4:Wired LAN Reset: 

Choose from a setting list by typing number.

Option Description
0 Back to normal operatio mode
1 Go to Wi-Fi、Ethenert selection
2 Reset all stored settings except for devicekey
3 Reset only Wi-Fi settings
4 Reset only Ethernet settings

Some setting option require confirmation like below.

-----All Reset (WirelessLAN and WiredLAN setting delete)-----


You will Get in Few Days

Circuit for Starter “obniz Board” is available on Amazon and other online stores.
You can get it at below

Our products and resellers


Visit our developer’s forum to discuss and discover technologies.



Feel free to contact out support and technical team.

Contact us