Scribd
Upload
154 views8 pages

Quick Start Guide For SoftAP

This document provides instructions for starting Soft-AP mode on a wireless device using hostapd. It describes downloading and compiling the driver and hostapd, configuring hostapd using an rtl_hostapd.conf file to set the SSID, security settings, and channels, and starting hostapd to enable Soft-AP mode. It also discusses using the proc filesystem to trigger Automatic Channel Selection and setting a hidden SSID or MAC address access control list.

Uploaded by

Cyber Bellaa
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
154 views8 pages

Quick Start Guide For SoftAP

This document provides instructions for starting Soft-AP mode on a wireless device using hostapd. It describes downloading and compiling the driver and hostapd, configuring hostapd using an rtl_hostapd.conf file to set the SSID, security settings, and channels, and starting hostapd to enable Soft-AP mode. It also discusses using the proc filesystem to trigger Automatic Channel Selection and setting a hidden SSID or MAC address access control list.

Uploaded by

Cyber Bellaa
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 8

Quick Start Guide for starting

Soft-AP mode

1
Version Date Change list Notes
V0.3 2020/11/24 Add VHT configuration of hostapd
V0.2 2019/09/18 Add Realtek proprietary ACS (Automatic Channel Selection)
V0.1 Initial version

(A) How to start Soft-AP mode:


(1) Disable network management or other wireless tools, e.g. wpa_supplicant
P.S. If now is in concurrent mode. The wlan0 interface used by STA mode
still needs its wpa_supplicant. For more information, please refer the document
“Realtek_WiFi_concurrent_mode_Introduction.doc”
(2) Uncompress the driver and then compile the driver
./make

P.S. If the driver uses CFG80211, there are several steps below need to do:
I. If the driver package is for single interface
1. Uncomment the definition “//#define
CONFIG_IOCTL_CFG80211” of the file “include/autoconf.h” to
“#define CONFIG_IOCTL_CFG80211”
2. If the Linux kernel version is greater than 3.2.0
(kernel>=3.2.0),user must uncomment the definition “//#define
RTW_USE_CFG80211_STA_EVENT” of file include/autoconf.h
to “#define RTW_USE_CFG80211_STA_EVENT”
II. If the driver package is for multiple interfaces
1. user should modify the definition in the
“autoconf_xxx_yyy_linux.h” file but not “include/autoconf.h”.
The “xxx” is IC type and the “yyy” is interface type. For example,
the IC type is RTL8192C and the interface type is USB, the file
name is “autoconf_rtl8192c_usb_linux.h”.
III. If the driver uses CFG80211 and the Linux kernel version >= 3.2.0, the
SOFTAP must use the
"wpa_supplicant_8_jb_4.2_rtw_zzzzz.20130821.tar.gz” or
“wpa_supplicant_8_kk_4.4_rtw_zzzzz.20140220.tar.gz" package. In
contrast, the SOFTAP should use
“wpa_supplicant_hostapd-0.8_rtw_zzzzz.20130812.tar.gz” package for
WEXT. The zzzz is version number. If the driver using CFG80211 but
kernel < 3.2.0, wpa_supplicant are not available in driver package so far,
and please contact us.
(3) insmod 8192cu.ko
2
(4) ifconfig wlan0 up
(5) ifconfig wlan0 192.168.0.1 (using the static ip for testing)
(6) Compile SOFTAP, unpack wpa_supplicant_hostapd-0.8_rtw_20120803.zip
in the folder (wpa_supplicant_hostapd-0.8\hostapd)
./make
(7) start hostapd daemon:
./hostapd rtl_hostapd.conf -B

(B) Configure file for Soft-AP mode setting:


(1) rtl_hostapd.conf is the configure file for functions setting.
(2) The major variable setting in the rtl_hostapd.conf configure file,

(i) basic configuration


interface=wlan0
ssid=rtwap

# channel 1-14 is 2.4 GHz ; channel 36, 40, 44, 46, 48, 52, 56, 60,
# 64, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140, 149,
# 153, 157, 161 is 5GHz
# The channels that are available for use in a particular country differ
# according to the regulations of that country.
channel=6

# Operation mode (a = IEEE 802.11a, b = IEEE 802.11b, g = IEEE


# 802.11g, Default: IEEE 802.11b )
hw_mode=g

#If the wireless interface is included in a bridge,


#an additional configuration parameter, bridge, is needed
bridge=br0

# set “driver=rtl871xdrv” for WEXT, or “driver=nl80211” for


# CFG80211
driver=nl80211

3
(ii) security mode configuration
# This field is a bit field that can be used to enable WPA
# (IEEE 802.11i/D3.0)
# and/or WPA2 (full IEEE 802.11i/RSN):
# bit1 = IEEE 802.11i/RSN (WPA2) (dot11RSNAEnabled)
wpa=2

# wpa_passphrase=secret passphrase
wpa_passphrase=87654321

# Set of accepted key management algorithms


# (WPA-PSK, WPA-EAP, or both).
wpa_key_mgmt=WPA-PSK

# Set of accepted cipher suites (encryption algorithms)


# for pairwise keys
wpa_pairwise=CCMP

(iii) IEEE 802.11n related configuration


# ieee80211n: Whether IEEE 802.11n (HT) is enabled
# 0 = disabled (default)
# 1 = enabled
ieee80211n=1

# ht_capab: HT capabilities (list of flags)


# Supported channel width set: [HT40-] = both 20 MHz and 40 MHz
# with secondary channel below the primary channel;
# [HT40+] = both 20 MHz and 40 MHz with secondary channel upon
# the primary channel
# Note:There are limits on which channels can be used with HT40- and
# HT40+.Following table shows the channels that may be available for
# HT40- and HT40+ use per IEEE 802.11n Annex J:
# freq HT40- HT40+
# 2.4 GHz 5-13 1-7 (1-9 in Europe/Japan)
# 5 GHz 40,48,56,64 36,44,52,60
# Short GI for 20 MHz: [SHORT-GI-20] (disabled if not set)
# Short GI for 40 MHz: [SHORT-GI-40] (disabled if not set)
ht_capab=[SHORT-GI-20][SHORT-GI-40][HT40+]

4
(iv) IEEE 802.11ac related configuration
# ieee80211ac: Whether IEEE 802.11ac (VHT) is enabled
# 0 = disabled (default)
# 1 = enabled
# Note: You will also need to enable WMM for full VHT functionality.
# Note: hw_mode=a is used to specify that 5 GHz band is used with
VHT.
ieee80211ac=1

# 0 = 20 or 40 MHz operating Channel width


# 1 = 80 MHz channel width
# 2 = 160 MHz channel width
# 3 = 80+80 MHz channel width
vht_oper_chwidth=1

# center freq = 5 GHz + (5 * index)


# So index 42 gives center freq 5.210 GHz
# which is channel 42 in 5G band
# You don’t need to set this if you use 20/40MHz
vht_oper_centr_freq_seg0_idx=42

For example:
 VHT20
ieee80211ac=1
vht_oper_chwidth=0

 VHT40
ieee80211ac=1
ht_capab=[HT40+]
vht_oper_chwidth=0

 VHT80
ieee80211ac=1
ht_capab=[HT40+]
vht_oper_chwidth=1
vht_oper_centr_freq_seg0_idx=42

5
(v) Check the station connected to softap using hostapd_cli:
./hostapd_cli all_sta

(vi) How to start WPS process as internal registrar?


1. for PIN code = 12345670
./hostapd_cli wps_pin any 12345670
2. for PBC
./hostapd_cli wps_pbc

(C) How to get the best channel?


1. Assume the WLAN interface is wlan0 and the IC is RTL8192DU-VS:
ifconfig wlan0 up
iwlist wlan0 scan
iwlist wlan0 scan
iwlist wlan0 scan
cat /proc/net/rtl8192du/wlan0/best_channel

Notes:
1. If your WLAN interface is not wlan0, please change it to your used interface.
(ex: wlan51)
2. If your driver IC is not RTL8192DU-VS, please change the rtl8192du to your
used IC. (e.g. rtl8192cu, rtl8188eu, etc.)
3. The result of “cat /proc/net/rtl…/wlan0/best_channel” has two parts. The first
part is received packet count at all supported channels during site survey.
Developers can use these statics to decide your own best channel. The second
part is the simple estimated best channels for 5G and 2.4G band for reference
only. HT40+ rule is used to estimate the best channel when the primary
channel is at 1, 6, 36, 44, etc., and the primary channel with minimum
received packet count is selected.

(D) Realtek proprietary ACS (Automatic Channel Selection)


Realtek driver has ability to switch to low interference channel (best channel)
automatically. It relies on third party software to trigger Realtek proprietary ACS via
proc filesystem.

How to use Realtek proprietary ACS


1.) Enable compiler flag and rebuild the driver
Modify include/autoconf.h to add ACS macro

6
#define CONFIG_RTW_ACS

2.) Trigger ACS via proc filesystem


When soft AP was started, echo acs > /proc/net/rtl…./wlan0/survey_info, to
trigger driver processing ACS mechanism to scan all supported channels, After
scan, driver switches to the best channel automatically.

The usage of survey_info:


 echo 1 > /proc/net/rtl…./wlan0/survey_info
Driver processes normal scan.
 echo acs > /proc/net/rtl…./wlan0/survey_info
Driver processes ACS scan and then switch to the best channel.
 cat /proc/net/rtl…./wlan0/survey_info
Driver dumps all AP info from scan queue.

(E) How to set Hidden SSID?


# Send empty SSID in beacons and ignore probe request frames that do not
# specify full SSID, i.e., require stations to know SSID.
# default: disabled (0)
# 1 = send empty (length=0) SSID in beacon and ignore probe request for
# broadcast SSID
# 2 = clear SSID (ASCII 0), but keep the original length (this may be required
# with some clients that do not support empty SSID) and ignore probe
# requests for broadcast SSID
ignore_broadcast_ssid=0

(F) How to set MAC address ACL


# Station MAC address -based authentication
# Please note that this kind of access control requires a driver that uses
# hostapd to take care of management frame processing and as such, this can be
# used with driver=hostap or driver=nl80211, but not with driver=madwifi.
# 0 = accept unless in deny list, deny_mac_file is used to specify deny list.
# 1 = deny unless in accept list, accept_mac_file is used to specify deny list.
#macaddr_acl=1

# Accept/deny lists are read from separate files (containing list of


# MAC addresses, one per line). Use absolute path name to make sure that the
# files can be read on SIGHUP configuration reloads.

7
accept_mac_file=/etc/hostapd.accept
deny_mac_file=/etc/hostapd.deny

(G) How to delete hostapd


# rm /var/run/hostapd/wlan0

You might also like

pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy