13. Chapter WiFi Working Modes

In this chapter, we’ll focus on the WiFi infrastructure for ESP32-S3 WROOM.

ESP32-S3 WROOM has 3 different WiFi operating modes: station mode, AP mode and AP+station mode. All WiFi programming projects must be configured with WiFi operating mode before using WiFi, otherwise WiFi cannot be used.

13.1. Project Station mode

13.1.1. Component List

ESP32-S3 WROOM x1

USB cable x1

13.1.2. Component knowledge

13.1.2.1. Station mode

When ESP32-S3 selects Station mode, it acts as a WiFi client. It can connect to the router network and communicate with other devices on the router via WiFi connection. As shown below, the PC is connected to the router, and if ESP32-S3 wants to communicate with the PC, it needs to be connected to the router.

13.1.3. Circuit

Connect Freenove ESP32-S3 to the computer using the USB cable.

13.1.4. Code

Move the program folder “Freenove_Basic_Starter_Kit_for_ESP32_S3/Python/Python_Codes” to disk(D) in advance with the path of “D:/Micropython_Codes”.

Open “Thonny”, click “This computer” -> “D:” -> “Micropython_Codes” -> “Station_mode” and double click “Station_mode.py”.

13.1.4.1. Station_mode

Because the names and passwords of routers in various places are different, before the Code runs, users need to enter the correct router’s name and password in the box as shown in the illustration above.

After making sure the router name and password are entered correctly, compile and upload codes to ESP32S3, wait for ESP32-S3 to connect to your router and print the IP address assigned by the router to ESP32-S3 in “Shell”.

The following is the program code:

import time
import network

ssidRouter     = '********' #Enter the router name
passwordRouter = '********' #Enter the router password

def STA_Setup(ssidRouter,passwordRouter):
    print("Setup start")
    sta_if = network.WLAN(network.STA_IF)
    if not sta_if.isconnected():
        print('connecting to',ssidRouter)
        sta_if.active(True)
        sta_if.connect(ssidRouter,passwordRouter)
        while not sta_if.isconnected():
            pass
    print('Connected, IP address:', sta_if.ifconfig())
    print("Setup End")

try:
    STA_Setup(ssidRouter,passwordRouter)
except:
    sta_if.disconnect()

Import network module.

import network

Enter correct router name and password.

ssidRouter     = '********' #Enter the router name
passwordRouter = '********' #Enter the router password

Set ESP32-S3 in Station mode.

sta_if = network.WLAN(network.STA_IF)

Activate ESP32-S3’s Station mode, initiate a connection request to the router and enter the password to connect.

sta_if.active(True)
sta_if.connect(ssidRouter,passwordRouter)

Wait for ESP32-S3 to connect to router until they connect to each other successfully.

while not sta_if.isconnected():
    pass

Print the IP address assigned to ESP32-S3 in “Shell”.

print('Connected, IP address:', sta_if.ifconfig())

13.1.4.2. Reference

Class network

Before each use of network, please add the statement “ import network ” to the top of the python file.

WLAN(interface_id): Set to WiFi mode.

network.STA_IF: Client, connecting to other WiFi access points.

network.AP_IF: Access points, allowing other WiFi clients to connect.

active(is_active): With parameters, it is to check whether to activate the network interface; Without parameters, it is to query the current state of the network interface.

scan(ssid, bssid, channel, RSSI, authmode, hidden): Scan for wireless networks available nearby (only scan on STA interface), return a tuple list of information about the WiFi access point.

bssid: The hardware address of the access point, returned in binary form as a byte object. You can use ubinascii.hexlify() to convert it to ASCII format.

authmode: Access type

AUTH_OPEN = 0

AUTH_WEP = 1

AUTH_WPA_PSK = 2

AUTH_WPA2_PSK = 3

AUTH_WPA_WPA2_PSK = 4

AUTH_MAX = 6

Hidden: Whether to scan for hidden access points

False: Only scanning for visible access points

True: Scanning for all access points including the hidden ones.

isconnected(): Check whether ESP32-S3 is connected to AP in Station mode. In STA mode, it returns True if it is connected to a WiFi access point and has a valid IP address; Otherwise it returns False.

connect(ssid, password): Connecting to wireless network.

ssid: WiFiname

password: WiFipassword

disconnect(): Disconnect from the currently connected wireless network.

13.2. Project AP mode

13.2.1. Component List & Circuit

Component List & Circuit are the same as in Project 14.1.

13.2.2. Component knowledge

13.2.2.1. AP mode

When ESP32-S3 selects AP mode, it creates a hotspot network that is separate from the Internet and waits for other WiFi devices to connect. As shown in the figure below, ESP32-S3 is used as a hotspot. If a mobile phone or PC wants to communicate with ESP32-S3, it must be connected to the hotspot of ESP32-S3. Only after a connection is established with ESP32-S3 can they communicate.

13.2.3. Circuit

Connect Freenove ESP32-S3 to the computer using the USB cable.

13.2.4. Code

Move the program folder “Freenove_Basic_Starter_Kit_for_ESP32_S3/Python/Python_Codes” to disk(D) in advance with the path of “D:/Micropython_Codes”.

Open “Thonny”, click “This computer” -> “D:” -> “Micropython_Codes” -> “AP_mode”. and double click “AP_mode.py”.

13.2.4.1. AP_mode

Before the Code runs, you can make any changes to the AP name and password for ESP32-S3 in the box as shown in the illustration above. Of course, you can leave it alone by default.

Click “Run current script”, open the AP function of ESP32-S3 and print the access point information.

Turn on the WiFi scanning function of your phone, and you can see the ssid_AP on ESP32S3, which is called “WiFi_Name” in this Code. You can enter the password “12345678” to connect it or change its AP name and password by modifying Code.

The following is the program code:

import network

ssidAP         = 'WiFi_Name' #Enter the router name
passwordAP     = '12345678'  #Enter the router password

local_IP       = '192.168.1.10'
gateway        = '192.168.1.1'
subnet         = '255.255.255.0'
dns            = '8.8.8.8'

ap_if = network.WLAN(network.AP_IF)

def AP_Setup(ssidAP,passwordAP):
    ap_if.ifconfig([local_IP,gateway,subnet,dns])
    print("Setting soft-AP  ... ")
    ap_if.config(essid=ssidAP,authmode=network.AUTH_WPA_WPA2_PSK, password=passwordAP)
    ap_if.active(True)
    print('Success, IP address:', ap_if.ifconfig())
    print("Setup End\n")

try:
    AP_Setup(ssidAP,passwordAP)
except:
    print("Failed, please disconnect the power and restart the operation.")
    ap_if.disconnect()

Import network module.

import network

Enter correct AP name and password.

ssidAP         = 'WiFi_Name' #Enter the router name
passwordAP     = '12345678'  #Enter the router password

Set ESP32-S3 in AP mode.

ap_if = network.WLAN(network.AP_IF)

Configure IP address, gateway and subnet mask for ESP32S3.

ap_if.ifconfig([local_IP,gateway,subnet,dns])

Turn on an AP in ESP32S3, whose name is set by ssid_AP and password is set by password_AP.

ap_if.config(essid=ssidAP,authmode=network.AUTH_WPA_WPA2_PSK, password=passwordAP)
ap_if.active(True)

If the program is running abnormally, the AP disconnection function will be called.

ap_if.disconnect()

13.2.4.2. Reference

13.3. Project AP+Station mode

13.3.1. Component List

ESP32-S3 WROOM x1

USB cable x1

13.3.2. Component knowledge

13.3.2.1. AP+Station mode

In addition to AP mode and station mode, ESP32-S3 can also use AP mode and station mode at the same time. This mode contains the functions of the previous two modes. Turn on ESP32-S3’s station mode, connect it to the router network, and it can communicate with the Internet via the router. At the same time, turn on its AP mode to create a hotspot network. Other WiFi devices can choose to connect to the router network or the hotspot network to communicate with ESP32-S3.

13.3.3. Circuit

Connect Freenove ESP32-S3 to the computer using the USB cable.

13.3.4. Code

Move the program folder “Freenove_Basic_Starter_Kit_for_ESP32_S3/Python/Python_Codes” to disk(D) in advance with the path of “D:/Micropython_Codes”.

Open “Thonny”, click “This computer” -> “D:” -> “Micropython_Codes” -> “AP+STA_mode”and double click “AP+STA_mode.py”.

13.3.4.1. AP+STA_mode

It is analogous to project 13.1 and project 13.2. Before running the Code, you need to modify ssidRouter, passwordRouter, ssidAP and passwordAP shown in the box of the illustration above.

After making sure that the code is modified correctly, click “Run current script” and the “Shell” will display as follows:

Turn on the WiFi scanning function of your phone, and you can see the ssidAP on ESP32-S3.

The following is the program code:

import network

ssidRouter     = '********' #Enter the router name
passwordRouter = '********' #Enter the router password

ssidAP         = 'WiFi_Name'#Enter the AP name
passwordAP     = '12345678' #Enter the AP password

local_IP       = '192.168.4.150'
gateway        = '192.168.4.1'
subnet         = '255.255.255.0'
dns            = '8.8.8.8'

sta_if = network.WLAN(network.STA_IF)
ap_if = network.WLAN(network.AP_IF)

def STA_Setup(ssidRouter,passwordRouter):
    print("Setting soft-STA  ... ")
    if not sta_if.isconnected():
        print('connecting to',ssidRouter)
        sta_if.active(True)
        sta_if.connect(ssidRouter,passwordRouter)
        while not sta_if.isconnected():
            pass
    print('Connected, IP address:', sta_if.ifconfig())
    print("Setup End")

def AP_Setup(ssidAP,passwordAP):
    ap_if.ifconfig([local_IP,gateway,subnet,dns])
    print("Setting soft-AP  ... ")
    ap_if.config(essid=ssidAP,authmode=network.AUTH_WPA_WPA2_PSK, password=passwordAP)
    ap_if.active(True)
    print('Success, IP address:', ap_if.ifconfig())
    print("Setup End\n")

try:
    AP_Setup(ssidAP,passwordAP)    
    STA_Setup(ssidRouter,passwordRouter)
except:
    sta_if.disconnect()
    ap_if.disconnect()