Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools

Home / products / sbc / edge2 / applications / wifi-sta-ap-mode
products:sbc:edge2:applications:wifi-sta-ap-mode

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
products:sbc:edge2:applications:wifi-sta-ap-mode [2023/05/20 04:35]
nick 		products:sbc:edge2:applications:wifi-sta-ap-mode [2025/04/23 06:40] (current)
nick
Line 1: Line 1:
-====== Edge2 Wi-Fi AP Mode ======+====== Edge2 Wi-Fi STA/AP Mode Configuration ======
  
-This documentation will introduce how to setup Wi-Fi working on AP mode.+===== Download ===== 
 +``` 
 +wget https://raw.githubusercontent.com/khadas/fenix/refs/heads/master/archives/filesystem/common/usr/local/bin/khadas_ap.sh 
 +sudo chmod 777 khadas_ap.sh 
 +sudo mv khadas_ap.sh /usr/local/bin 
 +``` 
 +We will add it in next version and users could also rebuild the image. 
 +===== Overview ===== 
 +This guide explains how to configure dual Wi-Fi mode using the provided script (v1.0), enabling simultaneous operation in:
  
-===== Setup Wlan0 as a Hotspot =====+STA+AP Mode: ''wlan0'' as STA (connects to existing Wi-Fi) + ''wlan1'' as AP (creates hotspot)
  
-==== 2.4 GHz Frequency ====+ETH+AP Mode: ''eth0'' as Ethernet uplink + ''wlan1'' as AP (//Note: Not available on Edge2 devices//)
  
-For example, the following commands will create AP configuration named ''Hostspot'' on interface ''wlan0'', with SSID ''khadas_ap_2.4G'', ''2.4GHz'' band, ''channel 1'', ''WPA2-PSK'' security, ''CCMP encryption'' and passphrase ''12345678''.+===== Prerequisites =====
  
 +Root privileges required
  
-```shell +Ensure wireless interfaces are properly identified: 
-sudo nmcli con add type wifi ifname wlan0 mode ap con-name Hostspot ssid khadas_ap_2.4G + 
-sudo nmcli con modify Hostspot 802-11-wireless.band bg +STA interface: ''wlan0'' 
-sudo nmcli con modify Hostspot 802-11-wireless.channel 1 + 
-sudo nmcli con modify Hostspot 802-11-wireless-security.key-mgmt wpa-psk +AP interface: ''wlan1'' 
-sudo nmcli con modify Hostspot 802-11-wireless-security.proto rsn + 
-sudo nmcli con modify Hostspot 802-11-wireless-security.group ccmp +Ethernet interface: ''eth0'' (not present on Edge2) 
-sudo nmcli con modify Hostspot 802-11-wireless-security.pairwise ccmp + 
-sudo nmcli con modify Hostspot 802-11-wireless-security.psk 12345678 +===== Configuration Script Usage ===== 
-sudo nmcli con modify Hostspot ipv4.addresses 192.168.2.1/24 +Run the script with root privileges: 
-sudo nmcli con modify Hostspot ipv4.gateway 192.168.2.1 + 
-sudo nmcli con modify Hostspot ipv4.method shared +``` 
-sudo nmcli con up Hostspot+sudo khadas_ap.sh
 ``` ```
  
-==== 5 GHz Frequency ==== 
  
-For example, the following commands will create AP configuration named ''Hostspot'' on interface ''wlan0'', with SSID ''khadas_ap_5G'', ''5GHz'' band, ''channel 149'', ''WPA2-PSK'' security, ''CCMP encryption'' and passphrase ''12345678''.+==== Main Menu Options ==== 
 +``` 
 +======================================== 
 + WiFi Configuration Tool v1.0 
 +======================================== 
 +1. STA+AP Mode 
 +2. ETH+AP Mode 
 +3. Stop All Services 
 +4. Exit 
 +======================================== 
 +Please select an option [1-4]: 
 +``` 
 +1.STA+AP Mode - Recommended for most devices: creates NAT forwarding between ''wlan0'' (STA) and ''wlan1'' (AP), requires existing Wi-Fi connection on ''wlan0'', hotspot IP: ''192.168.43.1'' (DHCP range: 192.168.43.2-254)
  
-```shell +2.ETH+AP Mode - For devices with Ethernet port: creates NAT forwarding between ''eth0'' and ''wlan1''//Not functional on Edge2 devices// (no eth0 interface). Same hotspot IP range as STA+AP mode 
-sudo nmcli con add type wifi ifname wlan0 mode ap con-name Hostspot ssid khadas_ap_5G + 
-sudo nmcli con modify Hostspot 802-11-wireless.band a +3.Stop All Services - Terminates AP/DHCP/NAT services 
-sudo nmcli con modify Hostspot 802-11-wireless.channel 149 + 
-sudo nmcli con modify Hostspot 802-11-wireless-security.key-mgmt wpa-psk +4.Exit - Quit the script 
-sudo nmcli con modify Hostspot 802-11-wireless-security.proto rsn + 
-sudo nmcli con modify Hostspot 802-11-wireless-security.group ccmp +==== Configuration Steps ==== 
-sudo nmcli con modify Hostspot 802-11-wireless-security.pairwise ccmp + 
-sudo nmcli con modify Hostspot 802-11-wireless-security.psk 12345678 +Select operation mode from menu 
-sudo nmcli con modify Hostspot ipv4.addresses 192.168.2.1/24 + 
-sudo nmcli con modify Hostspot ipv4.gateway 192.168.2.1 +For AP modes (1 or 2): 
-sudo nmcli con modify Hostspot ipv4.method shared + 
-sudo nmcli con up Hostspot+  * Enter SSID for hotspot 
 +  * Set password (WPA2-PSK required) 
 +  * Script automatically handles: 
 +  * Hostapd configuration 
 +  * Dnsmasq DHCP setup 
 +  * IP forwarding 
 +  * iptables NAT rules 
 + 
 +===== Verification ===== 
 +Check interface status after configuration: 
 + 
 +``` 
 +ifconfig wlan0 && ifconfig wlan1
 ``` ```
 +Verify internet connectivity (STA+AP mode):
  
-Use ''ifconfig'' to check if everything has been setup correctly:+``` 
 +ping -I wlan0 google.com 
 +``` 
 +Test hotspot access: 
 + 
 +SSID: [Your configured SSID] 
 + 
 +Password: [Your set password] 
 + 
 +Client IP range: 192.168.43.2-254 
 + 
 +===== Important Notes ===== 
 +<WRAP important> 
 +Edge2 Device Limitations: 
 + 
 +No Ethernet interface (''eth0'') 
 + 
 +ETH+AP Mode (Option 2) will not function 
 + 
 +Use STA+AP Mode (Option 1) exclusively 
 + 
 +</WRAP> 
 +===== Technical Details ===== 
 + 
 +IP Configuration: 
 + 
 +  * AP Static IP: 192.168.43.1/24 
 +  * DHCP Range: 192.168.43.2-254 
 +  * DNS: Google DNS (8.8.8.8) via port 5353 
 + 
 +Security: 
 + 
 +  * WPA2-PSK encryption 
 +  * CCMP/AES cipher mandatory 
 + 
 +Default channel: 6 
 + 
 +Dependencies: 
 + 
 +  * dnsmasq (DHCP server) 
 +  * hostapd (AP configuration) 
 +  * iptables (NAT forwarding) 
 + 
 +===== Troubleshooting ===== 
 + 
 +AP Not Appearing: 
 + 
 +Confirm ''wlan1'' interface exists 
 + 
 +Check for conflicting services:
  
-```shell 
-$ ifconfig 
-wlan0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500 
-        inet 192.168.2.1  netmask 255.255.254.0  broadcast 192.168.31.255 
-        inet6 fda2:a164:f7fb:4b66:1466:7d8b:b8e3:49a  prefixlen 64  scopeid 0x0<global> 
-        inet6 fe80::6eed:eaf2:6ba8:5cd7  prefixlen 64  scopeid 0x20<link> 
-        inet6 fda2:a164:f7fb:4b66:a823:4487:8651:4d61  prefixlen 64  scopeid 0x0<global> 
-        ether 10:2c:6b:10:d5:0a  txqueuelen 1000  (Ethernet) 
-        RX packets 4271  bytes 3725737 (3.7 MB) 
-        RX errors 0  dropped 13  overruns 0  frame 0 
-        TX packets 1663  bytes 321613 (321.6 KB) 
-        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0 
 ``` ```
 +ps aux | grep -E 'hostapd|dnsmasq'
 +```
 +No Internet Access:
  
-===== Verify =====+Verify STA connection:
  
-You connect to AP ''khadas_ap_2.4G'' or ''khadas_ap_5G'' with password ''12345678''.+``` 
 +iwconfig wlan0 
 +``` 
 +Check NAT rules:
  
 +```
 +iptables -t nat -L -n -v
 +```
 +DHCP Failures:
  
 +Confirm dnsmasq running:
 +
 +```
 +systemctl status dnsmasq
 +```
Last modified: 2023/05/20 04:35 by nick

Page Tools

Khadas Site

Khadas Community

Khadas GitHub

Khadas Downloads