RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 July 2020 Redpine Signals, Inc. 2107 North First Street, Suite #540, San Jose, California 95131, United States of America. Phone: +1-408-748-3385, Fax: +1-408-705-2019 Email: sales@redpinesignals.com Website: www.redpinesignals.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 July 2020 Table of Contents 1 Introduction to RS9116.............................................................................................................. 7 2 Getting Started with RS9116 ..................................................................................................... 8 2.1 Hardware Requirements ...........................................................................................................
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 July 2020 10 Antenna Diversity..................................................................................................................... 82 10.1 Introduction ............................................................................................................................. 82 10.2 Configuration ...........................................................................................................................
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 July 2020 20.1 Configuration ......................................................................................................................... 110 21 Steps to connect 802.11R client to AP .................................................................................. 111 22 Steps to configure 802.11W ................................................................................................... 112 22.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 July 2020 31.1 Bgscan and Roaming ............................................................................................................. 140 32 Appendix G: Considerations need to be made during hostapd usage................................ 142 32.1 Parameters updated from hostapd.conf file........................................................................ 142 33 Appendix H: Antennae ..........................................
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 1 Introduction to RS9116 The OneBox-Mobile(refers to single software providing combo of all the features supported) software supports the following modes. They are outlined below: • Wi-Fi (Access Point, Client, Wi-Fi-Direct (P2P), Sniffer and Monitor modes) • Bluetooth Low Energy • 802.15.4 Compatibility The OneBox-Mobile Coexistence software supports the following combination of modes.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 2 Getting Started with RS9116 This section lists the hardware and software requirements for the installation of the software and also describes the steps to be followed to initialize and run the software. 2.1 Hardware Requirements The Hardware requirements are as follows: • RS9116N n-Link® Module • Laptop/PC with SDIO or USB interface or any embedded platform with Linux Board support package.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 3 Compiling the Driver This section describes the steps to be followed in order to compile the OneBox-Mobile Linux software for different platforms. The steps are outlined below: 1. Save the required configuration of Driver using the menuconfig utility. Following are the options available in menuconfig: • • • • • • Host Interface: SDIO or USB.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Figure 2: Selecting Operating System By default, the driver package includes "BSD" support. In case the user needs "Nl80211" support for Access point and Station modes, select the menuconfig accordingly. For Nl80211, the "Hostapd" application is used as a configuration utility.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 If NL80211 support is enabled in the driver, make sure that the following modules are loaded in the kernel before running the driver in order to avoid module dependencies. This can be verified by using the commands.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Figure 5: Save the changes before exiting 4. Now to compile the driver, enter the following command: make The code is compiled and the binaries are generated in the source/host/release folder. For embedded platforms, modify the path assigned to the "DEF_KERNEL_DIR" variable in the Makefile: cd RS9116.NXX.NL.GEN.LNX.x.y.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Before installing the Onebox RS9116 Driver modules, make sure that the RSI opensource modules are uninstalled. This has been taken care in the onebox_insert.sh script.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 4 Installing the Driver 4.1 Installation of Modules After completion of compilation, the driver generates the following modules in the release folder. They are outlined below: • • • • • • • • • • • • • • onebox_common_gpl.ko onebox_gpl.ko onebox_nongpl.ko onebox_wlan_gpl.ko onebox_wlan_nongpl.ko onebox_bt_gpl.ko onebox_bt_nongpl.ko wlan.ko wlan_wep.ko wlan_ccmp.ko wlan_tkip.ko wlan_acl.ko wlan_scan_sta.ko wlan_xauth.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 4.2 Enabling a Protocol Execute following command to enable required protocol(s): # ./onebox_util rpine0 enable_protocol $protocol_value Below are the possible values of protocol. • 1 – Enables Wi-Fi only • 2 – Enables Bluetooth only • 3 – Enables both Wi-Fi+Bluetooth Note: • If user selects only Wi-Fi in Menuconfig during the compilation of Driver, use the command below : sh wlan_enable.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 2. Ensure DRIVER_MODE and COEX_MODE are set as below: • • • • DRIVER_MODE = 1 COEX_MODE = 1 (For Station Mode only/WIFI-Direct) COEX_MODE = 2 (For Access Point Mode) COEX_MODE = 3 (For Both Access Point and Station Modes) For SDIO mode, ensure that the SDIO stack related modules are already inserted in the kernel refer Appendix A: Configuration of Kernels from 3.13 and above section to install sdio stack modules . 4.4.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 network={ ssid="" key_mgmt=NONE wep_key0=XXXXXXXXXX wep_tx_keyidx=X } The key can be input either in ASCII or Hexadecimal formats: ASCII Format: wep_key0="12345" Hexadecimal Format: wep_key0=1234567890 The key index can vary between 0 and 3.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 network={ ssid="" scan_ssid=1 key_mgmt=NONE } Next, run the "start_sta.sh" script in the "release" folder to load the driver modules and the supplicant and also connect to the Access Point specified in the "sta_settings.conf" file. sh start_sta.sh User needs to make sure of the module detection w.r.t interface being used.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 $ dhclient -r wifi0 $ dhclient -v wifi0 The sample output of dhclient command is given below Listening on LPF/wifi0/88:da:1a:1e:b2:58 Sending on LPF/wifi0/88:da:1a:1e:b2:58 Sending on Socket/fallback DHCPDISCOVER on wifi0 to 255.255.255.255 port 67 interval 4 (xid=0x133cec16) DHCPREQUEST on wifi0 to 255.255.255.255 port 67 (xid=0x133cec16) DHCPOFFER from 192.168.43.1 DHCPACK from 192.168.43.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 • Channel 1 of 2.4GHz Band (2412 MHz) • Security Mode: WPA-PSK (TKIP) • Passphrase: "12345678" For Access Point in WPA2-PSK (CCMP) Mode, wpa_supplicant_ccmp.conf configuration file is used, and this starts an Access Point with the following parameters: • • • • SSID: onebox_ccmp Channel 1 of 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 ifconfig Example : ifconfig wifi1 192.168.2.1 4.4.3 Installation in Wi-Fi Client Mode (with NL80211 support) The steps for installing Wi-Fi Only mode in Client are as follows: 1. Open the common_insert.sh file present in the "release" folder. 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 In case of multiple phy's to identify the appropriate phy on which to run the command, enter the following command. iw dev The sample output of this command is phy#3 Interface wlp0s26u1u2 ifindex 10 wdev 0x300000001 addr 00:23:a7:65:2a:ac type managed phy#0 Interface wlo1 ifindex 3 wdev 0x1 addr a4:17:31:a7:82:a3 type managed In the above example "Phy3" is Redpine's interface.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 4.4.4 Installation in Wi-Fi AP mode (with NL80211 support) The steps for installing Wi-Fi Only mode in AP are as follows: 1. Open the common_insert.sh file present in the "release" folder. 2. Ensure that the DRIVER_MODE and COEX_MODE are set as below • DRIVER_MODE = 1 • COEX_MODE = 2 (For Access Point Mode) (Or) • COEX_MODE = 3 (For Both Access Point and Station Modes) 3.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Configure the SSID Settings of the AP in the hostapd_open.conf file (say if you are starting AP in open mode). In order to start AP in a particular band and channels, configure variables hw_mode, channel and country in hostapd_open.conf (present in release folder) file as follows : • hw_mode=g ( 'g'-2.4GHz) • channel=1 • country_code=US Note: Channel selection in the hostapd_open.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 # ./wpa_cli –i wifi0 p2p_group_add freq= The "channel_freq" input mentioned in the above command is the center frequency of the Wi-Fi channel in which the GO needs to be started The OneBox-Mobile software supports DFS slave mode. However, DFS Channels need to be avoided till the module is certified for DFS.. If this parameter is not provided, then the GO will start in the channel specified in the p2p.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 wpa_supplicant version used should be latest one (2.6 or higher). Please check the start_p2pgo.sh script for better understanding and update it accordingly. The given below command is used to start the device in Autonomous GO mode: # .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Note: wpa_supplicant version used should be latest one (2.6 or higher) and need to compile with CONFIG_P2P and CONFIG_WPS flag enble. Use below command to start the device in Autonomous GO mode: #./wpa_cli -i wifi0 p2p_group_add freq= Run DHCP Server on GO Interface before connecting P2P or Legacy devices using below cmd. #sh dhcp_server.sh wifi0 P2P Devices can scan this Group Owner and can connect directly.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Note: wpa_supplicant version used should be latest one (2.6 or higher) and need to compile with CONFIG_P2P and CONFIG_WPS flag enable. After starting the supplicant, the p2p_commands mentioned below should be executed. To find other P2P networks #./wpa_cli -i wifi0 p2p_find To find other P2P devices in range #./wpa_cli -i wifi p2p_peers To connect to p2p network #.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Note: For SDIO mode, ensure that the SDIO stack related modules are already inserted in the kernel refer Appendix A: Configuration of Kernels from 3.13 and above section to install sdio stack modules . 1. Follow the instructions in section 4.4.1 Installation in Wi-Fi Client Mode, inorder to install the Wi-Fi Client mode. 2. Run the bt_enable.sh or wlan_bt_insert.sh or onebox_insert.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 # hcitool –i lecc The "remote_MAC_Addr" parameter mentioned above is the MAC address of the remote device, e.g., 00:23:AC: 01:02:03. • Slave Mode Connected State Ensure that our device is in Advertise mode and then issue the command given below: # hcitool –i lecc The "device_MAC_Addr" parameter mentioned above is the MAC address of the Redpine module, e.g.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 5 Wi-Fi ioctl Usage Guide This section explains about the usage of various ioctl commands present in the OneBox-Mobile driver. The user has control over multiple settings such as device settings, radio, aggregation, fragmentation thresholds, power save configurations and so on. 5.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters VAP Name (string like wifi0, wifi1, etc.) Integer value as per the mapping below: Auto Rate – 0 1 Mbps – 2 2 Mbps – 4 5.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Default Value 2346 Input Parameters VAP Name (string like wifi0, wifi1, etc.) Integer between 256 and 2346 Output Parameter None Reset Required No.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Set Short GI Description This command is used to set the Short GI mode of the n-Link® Module. Default Value 0 (Short GI disabled for both 20 MHz and 40 Mhz Bandwidth) Input Parameters VAP Name (string like wifi0, wifi1, etc.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Output Parameter None Reset Required No Usage Example # iwpriv wmm The command below sets the WMM mode for the module: # iwpriv wifi0 wmm 1 Note: Issue this command before starting the supplicant in Access Point Mode. Set AMPDU Description This command is used to enable AMPDU Aggregation in the n-Link® Module Default Value - Input Parameters VAP Name (string like wifi0, wifi1, etc.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters VAP Name (string like wifi0, wifi1, etc.) The integer value mapping has been shown below: 1- Enable only 20MHz 2- Enable only 40MHz 3 – Enable both 20 and 40MHz Output Parameter None Reset Required Yes.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters Zone value. The integer value mapping has been shown below: 0 – Disable zone. 0x4000 – Error Zone. Output Parameter None Reset Required No Usage Example # iwpriv set_dbg_zone The following command disables debug zone level. # iwpriv wifi0 set_dbg_zone 0 Table 2: iwpriv Usage for Access Point and Client Modes 5.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Example The commands given below is used to reset the VAP and set the DTIM period: #sh remove_all.sh #sh wlan_enable.sh (or) wlan_bt_insert.sh (or) wlan_zigb_insert.sh (or) onebox_insert.sh script present in the "release" folder as per the instructions in Section 4.1 #./onebox_util rpine0 create_vap wifi1 ap #iwpriv wifi1 dtim_period $value #./wpa_supplicant –I wifi1 –D bsd –c wpa_supplicant_open.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Output Parameter Integer value Reset Required No Usage Example # iwpriv get_bintval The command given below is used to get the Beacon interval programmed in the module: #iwpriv wifi0 get_bintval MAC Command Description This command is used to set the Access Policy based on MAC address. The Access Policy can be disabled or can be used to allow or deny connection from the MAC address.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters VAP Name (string like wifi0, wifi1, etc.) 48-bit MAC Address in hexadecimal format with colon separation. e.g.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Output Parameter None Reset Required Yes. In order to move from/to Hidden SSID mode, the virtual interface has to be reset. Usage Example # iwpriv hide_ssid The command given below is used to start the Access Point in hidden mode: # ./onebox_util rpine0 create_vap wifi0 ap # iwpriv wifi0 hide_ssid 1 # ./wpa_supplicant –i wifi0 –D bsd –c wpa.conf & Note: Issue this ioctl before starting the supplicant.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters value*2 Output Parameter None Reset Required No Usage Example # iwpriv mgmt_rate The Following command sets the mgmt rate to 5.5Mbps #iwpriv wifi0 mgmt_rate 11 To disable the mgmt_rate use the below command: #iwpriv wifi0 mgmt_rate 0 Set Keep Alive Period in AP mode Description This command is used to set the Keep Alive period in the n-Link® Module.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Default Value NULL Data Input Parameters VAP Name (string like wifi0, wifi1, etc.) Integer value - 0 or 1 0 – Inform Access Point that the module is going to be in power save mode. 1 – De authenticate from the previous Access Point during Roaming. Output Parameter None Reset Required No Usage iwpriv setparam 12 The value 12 is used for setting Roaming related parameters for the setparam command.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Create a VAP The OneBoxMobile software allows creation of 4 VAPs Description This command is used to create a virtual interface (VAP) in the operating mode specified. Note: The OneBox-Mobile software allows creation of 4 VAPs Default Value - Input Parameters Base Interface (string like rpine0) VAP Name (string like wifi0, wifi1, etc.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters Base Interface (string like rpine0) VAP Name (string like wifi0, wifi1, etc.) Output Parameter None Reset Required No Usage Example # ./onebox_util delete_vap The command given below deletes a virtual interface named wifi0. # .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Default Value - Input Parameters VAP Name (string like wifi0, wifi1, etc.) 48-bit MAC Address in hexadecimal format with colon separation. e.g.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters Base Interface (string like rpine0) The integer value mapping has been shown below: 2 – Select RF_OUT_2/Integrated Antenna 3 – Select RF_OUT_1/U.FL Connector Output Parameter None Reset Required No Usage Example # ./onebox_util ant_sel The command given below selects the U.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Usage Example # .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Set SSID for Background Scan (only in Client mode) Description This command is used to set the SSID of the Hidden Access Point (SSID not being broadcast) during Background Scan. Default Value - Input Parameters Base Interface (string like rpine0) SSID (max. 32 characters) Output Parameter None Reset Required No. Usage # .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters Base Interface (string like rpine0) Power Save Enable/Disable Sleep Type Transmit Threshold Receive Threshold Transmit Hysteresis Receive Hysteresis Monitor Interval Sleep Duration Listen Interval Duration Number of Beacons per Listen Interval DTIM Interval Duration Number of DTIMs Per Sleep Duration Output Parameter None Reset Required No. Usage # .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters Base Interface (string like rpine0) UAPSD Wakeup Period in milliseconds – 0 for Transmit Based UAPSD and between 10 and 100 for Periodic UAPSD. UAPSD Service Period Length- This field indicates number of packets delivered by AP to station after receiving one trigger frame. This filed value ranges between 0-3 as described below. 0-All buffered packets will be delivered.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Example /onebox_util rpine0 reset_adapter Set Beacon Interval (only in Access Point mode) Description This command is used to set the Beacon Interval in milliseconds. It is recommended that this command is given before the VAP is created. Default Value 200 Input Parameters Base Interface (string like rpine0) Integer value between 56 and 1000 (other values will result in default value being assigned).
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Set WMM Parameters (only in Access Point mode) Description This command is used to set the WMM parameters for specific queues. Note: This ioctl is redundant, refer to the Section 16 for further details. The functionality of the ioclt is intact, however it might be removed in the future inorder to reduce redundancy.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters VAP Name (string like wifi0, wifi1, etc.) WMM Parameter Name (string like aifs, cwmin, cwmax, txop, acm) Integer value. The allowed values are as follows: AIFSN – 1 to 15 Cwmin – 2n-1, where ‘n’ is between 1 and 4 for BE_Q and BK_Q and between 1 and 3 for VI_Q and VO_Q. Cwmax – 2n-1, where ‘n’ is between 1 and 6 for BE_Q, between 1 and 10 for BK_Q and between 1 and 4 for VI_Q and VO_Q.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Input Parameters Integer (country code) mapped as below: REGION COUNTRY_CODE COUNTRY_NAME 840 UNITED STATES 124 CANADA 484 MEXICO 250 FRANCE 56 BELGIUM 276 GERMANY 380 ITALY JAPAN 392 JAPAN WORLD 36 AUSTRALIA 356 INDIA 364 IRAN 458 MALAYSIA 554 NEWZEALAND 643 RUSSIA 702 SINGAPORE 710 SOUTH AFRICA FCC ETSI Output Parameter None Reset Required Yes.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Example The commands below reset the VAP and set the country to Singapore in Station mode. # sh remove_all.sh # sh wlan_enable.sh or wlan_bt_insert.sh or wlan_zigb_insert.sh or onebox_insert.sh script present in the “release” folder as per the instructions in Section 4.1 # ./onebox_util rpine0 set_country 702 # ./onebox_util rpine0 create_vap wifi0 sta sw_bmiss Note: Issue this command before creating any interfaces.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Example The commands below set the Antenna gain values for 2.4 GHz to 3 dBm RESERVED field should be programmed as 1 # sh remove_all.sh # sh wlan_enable.sh or wlan_bt_insert.sh or onebox_insert.sh script present in the “release” folder as per the instructions mentioned in the section Installation of Modules. # ./onebox_util rpine0 set_ext_ant_gain 3 1 # .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Reset Required Usage Example No ./onebox_util rpine0 ant_type ant_path ant_type # ./onebox_util rpine0 ant_type 1 2 Set Wake-On-Wireless LAN Parameters (only in Client Mode) Description This command is used to set the Wake-On-Wireless LAN (WoWLAN) parameters in the device. The Host has to give this command each time when it enters and exits sleep state.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Output Parameters Reset Required Usage Example None No # ./onebox_util set_rf_tx_rx_pwr_mode tx_value rx_value ./onebox_util rpine0 set_rf_tx_rx_pwr_mode 0 1 Set scan type Description Default Value This command is used to select the band in which the user wants to perform the scan. Using this command the user can test in 2.4Ghz 1 – To scan 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Get Tx-Power Description Default Value Input Parameters Output Parameter Reset Required Usage Example This command is used to get current value of transmit power from firmware and updates it in iwconfig command. None No # ./onebox_util get_txpwr ./onebox_util rpine0 get_txpwr Useonly rates Description Default Value Input Prameters This command is used set the supported rates in AP mode.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 ctrl_interface=/var/run/wpa_supplicant update_config=1 uuid=12345678-9abc-def0-1234-56789abcdef0 device_name=RSI_P2P_DEVICE manufacturer=Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 #. /wpa_cli –i wps_pin This will generate a 4/8-digit numeric WPS PIN. 7. Enter the PIN on the STA. 8. Wait for the STA to parse all the WPS Access Points. Note: 1. WPS_PIN and passphrase are different. 2. WPS connection timeout is 120 seconds 3. 3rd party Stations usually try to connect to all scanned WPS Access Points until they succeed in connecting to one of them. 4.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 #. /wpa_cli –i wps_pin • This will generate an 8-digit numeric WPS PIN. • Enter the PIN on the Access Point • Wait for the STA to parse all the WPS Access Points.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 6 Configuration Using CFG80211 This section explains about the usage of various IOCTL commands, which can be issued to the Onebox-Mobile™ driver operating in CFG80211 mode from the user space. 6.1 Using iw Wireless Tool 'iw' is a new nl80211 based CLI configuration utility for wireless devices. It is used to set/get various parameters of a wireless network interface.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Usage The following command initiates a scan and displays the list of AP's scanned. $ iw dev $interface_name scan Example $ iw dev wifi0 scan Connect Description This command is used to connect devices to the Access points in open or WEP security mode. Default Value - Input Parameters SSID, BSSID, key_index, key of AP.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Link Status Description This command is used to get the connection status of our device. Default Value - Input Parameters Interface name. Output Parameter Connection status. Reset Required No Usage iw dev $interface_name link Example iw dev wifi0 link Interface Info Description This command is used to get information about the device . Default Value - Input Parameters Interface name.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Set Power save mode Description This command is used to set power save mode on/off in station mode. Default Value - Input Parameters Interface name. Output Parameter No Reset Required No Usage Example iw dev $interface_name set power_save iw dev wifi0 set power_save Get Power save mode Description This command is used to get power save mode on/off in station mode.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Note: If there are multiple phys, i.e there are several instances of cfg80211 being used by different modules, then to determine the correct phy, run the following commands: $ cat /sys/class/ieee80211/ This will give a list of all the phy’s that are currently active. $ cat /sys/class/ieee80211/phyX/macaddress where 'X' is the number of the phys which are obtained from the previous command.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 7 Enterprise security using CFG80211 7.1 Installation and configuration of FREERADIUS Server The following packages are required to install the freeradius server 3.09: • libtalloc-devel • openssl-devel The steps for downloading as well as installing the freeradius tar ball are as follows: $ tar zxvf freeradius-server-3.0.9.tar.gz $ cd freeradius_3.09 $ .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 tls-config tls-common { #private_key_password = whatever private_key_password = Wi-Fi #private_key_file = ${certdir}/server.pem private_key_file = /etc/certs/wifiuser.pem #certificate_file = ${certdir}/server.pem certificate_file = /etc/certs/wifiuser.pem #ca_file = ${cadir}/ca.pem ca_file = /etc/certs/wifiuser.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 • openssl-devel 7.2.1 Configuration of the AP Go to driver source folder and compile it with the following options enabled: [*] NL80211 support [*] HOSTAPD support $ make To start the device in AP mode, go to the release folder and run the following commands: $ cd release $ sh wlan_enable.sh or wlan_bt_insert.sh or wlan_zigb_insert.sh or onebox_insert.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 $. /hostapd hostapd_eap.conf -ddddt $ sh dhcp_server.sh >log & wifi1 , where wifi1 is the interface name 7.2.2 Configuring hostapd as RADIUS server The steps for configuring hostapd as RADIUS server are as follows: Copy the certs folder in /etc location, which will contain the certificates, hostapd.radius_clients, hostapd.eap_user and dh files.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 CONFIG_DRIVER_NL80211=y CONFIG_IEEE8021X_EAPOL=y CONFIG_EAP_MSCHAPV2=y CONFIG_EAP_TLS=y CONFIG_EAP_PEAP=y CONFIG_EAP_TTLS=y CONFIG_EAP_FAST=y CONFIG_EAP_LEAP=y CONFIG_PKCS12=y CONFIG_TLS=internal Ensure that in menuconfig, NL80211 support is enabled. Compile the driver. $ make Go to the release folder and start the device in station mode. $ cd release $ sh wlan_enable.sh or wlan_bt_insert.sh or wlan_zigb_insert.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 To connect using EAP-TTLS method, sta_settings.conf should be described as below: network={ ssid="Redpine_Signals" key_mgmt=WPA-EAP eap=TTLS anonymous_identity="ttlsuser" identity="test" password="password" } To connect using EAP-TLS method, sta_settings.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 network={ ssid="Redpine_Signals" key_mgmt=WPA-EAP eap=LEAP identity="user1" password="test123" } To connect using EAP-LEAP for CCX, sta_settings.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 8 HOSTAPD and Wi-Fi Protected Setup (WPS) This section describes how the WPS implementation in hostapd can be configured and how an external component on an AP is used to enable enrollment of client devices. WPS uses the following terms to describe the entities participating in the network setup: Access Point: WLAN access point Registrar: A device that controls a network and can authorize addition of new devices.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Check if the hostapd.wpa_psk file present in /etc/, if not, then create a new empty file naming hostapd.wpa_psk in location (/etc/ ). # Enable control interface for PBC/PIN entry ctrl_interface=/var/run/hostapd # Enable internal EAP server for EAP-WSC (part of Wi-Fi Protected Setup) eap_server=1 wps_state=2 ap_pin=12345670 wps_pin_requests=/var/run/hostapd_wps_pin_requests 8.3 WPS 8.3.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 $ iw phy ; it will give phyXX number $ iw phy phyXX interface add wifi1 type __ap $ /hostapd hostapd_wps.conf -ddddddt>log & $ sh dhcp_server.sh wifi1 ./hostapd_cli wps_pin any [wps-pin-of station] $ ./hostapd_cli wps_pin any 12345670 8.3.3 AP-mode for WPS-Generate pin- method $ sh wlan_enable.sh or wlan_bt_insert.sh or wlan_zigb_insert.sh or onebox_insert.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 $ hostapd_cli wps_ap_pin disable The command disables AP PIN (i.e., it does not allow external Registrars to use it inorder to learn the current AP settings or to reconfigure the AP). 8.3.5 Get the AP pin To fetch the current AP pin enter the command given below: $ hostapd_cli wps_ap_pin get 8.3.6 Set the AP pin $ hostapd_cli wps_ap_pin set [timeout] Sets the AP PIN and enables it.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 9 ACS with Hostapd Following steps should be followed for Auto Channel Selection using Hostapd: 1. Compilation Steps: a. Enable CONFIG_ACS in Driver Makefile b. Enable Hostapd and NL80211 in ‘make menuconfig’ c. Enable CONFIG_ACS in hostapd .config file. (wlan/hostapd/hostapd-2.4/hostapd/.config) d. Compile the driver using ‘make’ command 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 10 Antenna Diversity 10.1 Introduction Antenna diversity is a feature which enables the automatic selection of the antennas which is needed to be use. The antenna on which the packets with better RSSI values are received is selected. The RSSI monitoring happens continuously. Once it is enabled, this feature will persist for the entire duration of operation. 10.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 11 Sniffer Mode The Steps for operating the device in Sniffer Mode are outlined below. Ensure that the common_insert.sh present in the release folder has valid driver mode and coexistence mode. DRIVER_MODE=7 (Sniffer mode) COEX_MODE = 1 (Wi-Fi station/ Wi-Fi-Direct/Wlan-Per/Sniffer) Go to the release folder and start the driver modules by using the given below command # sh wlan_enable.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 12 Monitor Mode The Monitor Mode is one of the operating modes that can be set while creating a VAP. It enables capturing of packets which is transferred over a single or multiple VAPs and are operating in either Access Point or Client or P2P modes. The order of the VAPs' creation does not matter. Once it is created, the "tcpdump" command can be used to display the packets which are being transferred.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 13 Concurrent Mode Concurrent mode is the mechanism in which Onebox-Mobile can be operated in AP and Client modes simultaneously.User can create a virtual interface as client mode on one interface and as AP mode on other interface. Below are the Steps to operate the device in concurrent Mode. Ensure that common_insert.sh present in the release folder has valid driver mode and coexistence mode.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 13.1.2 Creating VAP in AP mode Create VAP in AP mode using command: $. /onebox_util rpine0 create_vap ap Ex:./onebox_util rpine0 create_vap wifi1 ap After issuing the above command virtual interface with name “wifi1” will be created. User can view the list of interfaces using the following command.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 In the case The following command scans all the 2G channels, 1-14 with periodicity of 5 seconds and active scan duration of 30ms. 1. ./onebox_util rpine0 host_scan_2g 5 30 The following command stops the host based scan. 2. ./onebox_util rpine0 host_scan_stop User can create the client mode first followed by AP mode or viceversa.If driver is unloaded in between the virtual interfaces created so far will be removed.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 disconnects from the AP, by default it will move to the INIT state. The user is expected to give the host_scan command to initiate scanning. 2. SCAN: In This state the device performs scan and sends the scan results to the supplicant. In the STA alone mode, the scan request from the supplicant is sufficient for the STA to move to this state.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 • AP will always operate in channel in which the client [corresponding to other VAP] connects. For eg: In case if client connects in ch6 then AP mode will get created in ch6 irrespective of the channel configured.Similarly if AP mode is started first in the user configured channel and client mode is started later, then AP switches to the channel in which client is finally connected.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 14 Background Scan Parameters This section describes the various parameters for the Background scan commands that can be sent to the n-Link Client using the onebox_util program. • : The Background scan threshold is referred to as the RSSI Upper Threshold.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 15 Power save Modes, Profiles and Parameters The Power save modes and parameters are valid only for the Client mode. By default, the module's power save is disabled. 15.1 Power save Modes The module broadly supports two types of power save modes.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 • Max PSP: In this mode, the module wakes up at the end of sleep period (Listen or DTIM interval) and retrieves pending Rx packets from the Access Point by sending a PS-POLL packet. It also transmits any packets received from the Host processor and then goes back to sleep. The parameters listed below are used by the module to decide the period of sleep during power save, in the same order of priority: a.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 • • • • • • values. The value is in Mbps and minimum value is 0 Mbps. This parameter should be assigned a value which is less than the value assigned to the parameter. : This parameter specifies the duration (in milliseconds) over which the Transmit and Receive throughputs are computed to compare with the , , and values.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 usb 2-1: new high-speed USB device number 4 using ehci-pci usb 2-1: New USB device found, idVendor=1618, idProduct=9113 usb 2-1: New USB device strings: Mfr=1, Product=2, SerialNumber=6 usb 2-1: Product: Wireless USB Network Module usb 2-1: Manufacturer: Redpine Signals, Inc. usb 2-1: SerialNumber: 000000000001 It means Redpine module is detected as 2-1 device. Please make a note of this.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 16 Compliance and Certification M7DB module is FCC/IC/CE certified. This section outlines the regulatory information for the M7DB module. This allows integrating the module in an end product without the need to obtain subsequent and separate approvals from these regulatory agencies.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Cet équipement est conforme aux limites d’exposition aux rayonnements IC établies pour un environnement non contrôlé. Cet équipement doit être installé et utilisé avec un minimum de 20 cm de distance entre la source de rayonnement et votre corps. This device complies with Industry Canada license-exempt RSSs.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Provision for Chip Antenna or other Antennae Label and compliance information Already in the manual Information on test modes and additional testing requirements a) The modular transmitter has been fully tested by the module grantee on the required number of channels, modulation types, and modes, it should not be necessary for the host installer to re-test all the available transmitter modes or settings.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 17 Wi-Fi Performance Test ioctl usage The One Box-Mobile software provides applications to test Transmit and receive performances of the module. The Band of operation of the module needs to be configured before performing any tests. Also open the common_insert.sh file present in the "release" folder using an editor like vim. Ensure that below parameters are set as specified.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Band (GHz) Bandwidth (MHz) Channel Number Center Frequency (MHz) 2.4 20 1 2412 2.4 20 2 2417 2.4 20 3 2422 2.4 20 4 2427 2.4 20 5 2432 2.4 20 6 2437 2.4 20 7 2442 2.4 20 8 2447 2.4 20 9 2452 2.4 20 10 2457 2.4 20 11 2462 2.4 20 12 2467 2.4 20 13 2472 2.4 40 3 2422 2.4 40 4 2427 2.4 40 5 2432 2.4 40 6 2437 2.4 40 7 2442 2.4 40 8 2447 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 #. /transmit rpine0 2 5.5 750 1 11 0 1 0 0 0 0 The above command starts continuous transmission with the following configuration: Transmit gain – 2dbm Data rate – 5.5Mbps Packet Length – 750 bytes Transmit mode – 1 (continuous mode).
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Value 8 Channel Width 20Mhz mode for 11J channel Table 10: Channel Width Values Examples: ./receive rpine0 stats 6 0 0 The above command starts the receive utility and logs statistics with the following parameters. Filename – stats Channel number – 6 Channel Width – 20MHz The test utility displays the following information: • Total number of packets received with correct CRC.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 #. /transmit rpine0 2 5.5 750 1 11 0 1 0 0 0 0 #. /transmit rpine0 0 #. /onebox_util rpine0 cw_mode 6 0 2 The above command starts continuous wave transmission with the following configuration. Channel number – 6 Type – Single tone Transmit Power – 2dBm The command used for stopping continuous wave transmission is outlined below: #.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 18 Wake-On-Wireless LAN 18.1 WoWLAN through onebox_util The parameters listed below for the Wake-On-Wireless LAN are valid only in Client mode. The parameter needs to be given as an input during VAP creation inorder to use the WoWLAN feature – refer to the section 5.5 Configuring Using onebox_util for details on VAP creation.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 18.2.2 Configure WoWLAN To configure WoWLAN, standard network tool ‘iw’ can be used. Issue below command in the terminal to configure WoWLAN. # iw phy wowlan enable phyX is the phy physical device number of the system for the device. It can be obtained by using the 'info' command. The command and its example output is shown below.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 #systemctl suspend This step will suspend the system and system goes to power save mode. 18.2.5 Trigger wakeup To initiate trigger packet, connect a PC or laptop to AP through LAN/WLAN. Get IP and check ping to AP is working or not. Copy WOWLAN applications 'wakeonlan' or 'etherwake' to this third party PC. Issue below command to issue trigger. 1. wakeonlan Or 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 19 PUF [ Physical Unclonable Functions ] 19.1 Introduction PUF, is a technology which provides a secure method for storing a key, withstanding today’s attack and even protecting against future potential attack. The purpose of PUF is to provide secure key storage without storing the key. Instead of storing the key a Key Code is generated which in combination with SRAM startup behavior is used to reconstruct keys. 19.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 ./onebox_util rpine0 puf_req 4 puf_keycode_0.txt 19.3.6 PUF Load Key This operation is used for loading key to AES engine or key holder for the given key code input. ./onebox_util rpine0 puf_req 5 puf_keycode_0.txt 19.3.7 PUF AES Encryption This operation is used for encrypting data inputted with Key provided or with key which is already loaded into AES by PUF.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 ./onebox_util rpine0 puf_req 10 19.3.12 PUF Block Get Key This operation is used for blocking further Get Key operations. .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 20 GTK Offload GTK Offload is a firmware feature that updates the Group Temporal Key (GTK) by processing EAPOL message within firmware instead of sending EAPOL messages to host driver. 20.1 Configuration To use this feature, ensure that driver is compiled with below define enabled in Makefile EXTRA_CFLAGS += -DONEBOX_CONFIG_GTK_OFFLOAD To enable/disable this feature at run time, use the following ioctl .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 21 Steps to connect 802.11R client to AP 1. Use the following configuration in sta_settings.conf file to connect to 802.11R AP. network={ ssid="" key_mgmt=FT-PSK psk= proto=WPA2 pairwise=CCMP group=CCMP } 2. Use following command to roam Over-The-DS for RSI 802.11R client: #.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 22 Steps to configure 802.11W 22.1 Configuring and Compiling Driver for PMF in client mode: 1. Enable CONFIG_11W in Driver Makefile 2. Enable CONFIG_IEEE80211W=y in wpa_supplicant .config 3. Enable WPA-PSK-SHA256 as key_mgmt in network block in supplicant sta_settings.conf i. pmf=1/2, PMF is enabled/required correspondingly .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 23 Update WLAN region based maximum powers from driver Following are the steps need to be followed to program region based maximum powers to the WLAN device. 1. Go to the host/release folder. 2. Open and update maximum powers in wlan_gain_table.txt file. 3. Now give below commands #sh wlan_enable.sh #.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 24 Bluetooth hcitool and hciconfig Usage The hcitool and hciconfig commands are used to control and configure parameters for the Bluetooth interface. The HCI commands explained here are the most frequently used commands. For other HCI commands please refer to the Bluetooth specification, Volume 2 Part E, Chapter7 from www.bluetooth.org.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Reset Required Usage No. hcitool -i cmd 0x04 0x02 Get Local BD Address Description This command is used to get the local BD Address Default Value - Input Parameters None Output Parameter 6 Byte BD Address Reset Required No.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 24.1 Bluetooth Power Save Commands The vendor-specific HCI Commands are used to configure the device in the power save mode. The module supports Low Power (LP) and Ultra-Low Power (ULP) modes. These are explained in more detail in the Power Save Modes section of WLAN ioctl Usage Guide. The LP and ULP modes are supported with the SDIO interface while only the LP mode is supported in USB mode.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 • • • • • • • • • • • • • • • • packet length ble rate Receive channel index Transmit_channel index Scrambler seed no.of packets payload type le channel type tx power tx mode hopping_type antenna selection inter_pkt_gap pll_mode rf_type rf_chain 24.3.2 IOCTL The following command can be given to start the transmission .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 inter_pkt_gap : Number of slots to be skipped between two packets - Each slot will be 1250usec pll_mode : PLL_MODE0 – 0 PLL_MODE1 – 1 rf_type : External RF – 0 Internal RF – 1 rf_chain: WLAN_HP_CHAIN 0 WLAN_LP_CHAIN 1 BT_HP_CHAIN 2 BT_LP_CHAIN 3 PLL_MODE2 – 2 24.3.4 Appendix Frequencies and channel Numbers used for Bluetooth LE Mode: Band(GHz) 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Band(GHz) 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 24.4.2 IOCTL The following command can be given to start the reception ./ble_receive After the receive starts, the following command can be given to stop the reception. .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 pwrsave_options : Disabled pll_mode : PLL_MODE0 rf_type : Internal RF rf_chain: BT_LP_CHAIN IOCTL Command: . /ble_receive 71764129 0 0 1 37 37 0 3 0 0 0 1 3 24.5 Hopping 24.5.1 Introduction The “bt_util” command is used to configure the device in order to transmit packets in required channels when random hopping feature is enabled. 24.5.2 IOCTL The parameters of "bt_util" command are as follows: .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 channel_bit_map –70000000000000000000 (here only upper 4 bits of bit map are set.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 25 Android support for RS9116 Redpine Signlas also supports Android Operating System. Currently supported variants in Android • MarshMallow (6.0.1) • Nougat (7.1) Please contact sales@redpinesignals.com for further details.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 26 Appendix A: Configuration of Kernels from 3.13 and above To ensure that the OneBox-Mobile software works on kernel versions from 3.13 and above, some configuration changes might be needed. These are explained in this section. Super user permissions are needed to make these changes. For SDIO mode, ensure that the SDIO stack related modules are already inserted in the kernel.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 5. In the new menu, press 'M' to modularize the following options: • MMC block device driver • Secure Digital Host Controller Interface support • SDHCI support on PCI bus 6. Hit the Tab key to select Exit and hit Enter. Repeat this till you are asked whether you want to save the configuration. 7. Select "Yes" and hit Enter. If the above options are already selected, the menuconfig screen will exit immediately 26.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 CONFIG_WIRELESS_EXT CONFIG_WEXT_PRIV CONFIG_WEXT_SPY 26.3 Bluetooth Stack Options If Bluetooth is required, it has to be ensured that the Bluetooth modules are compiled in the kernel. If the Bluetooth modules are not present, follow the steps below to enable Bluetooth support in the kernel. 1. Navigate to the Linux kernel source folder. This is usually in /usr/src/kernels/linux- 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 5. In the new menu, press 'M' to modularize the following options: • RFCOMM Protocol support (enable the "RFCOMM TTY support" feature under this). • BNEP Protocol support (enable the "Multicast filter support" and "Broadcast filter support" features under this). • CMTP Protocol support • HIDP Protocol support 6. Hit the Tab key to select Exit and hit Enter.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 27 Appendix B: Binary Files for Embedded Platforms Redpine offers pre-built binary files of the OneBox-Mobile software in order to enable customers to evaluate the software on specific embedded processor platforms. The platforms supported for the current release are listed below: • Freescale i.MX6 • Atmel ATSAM9G45 and AT91SAM9M10 27.1 Common Hardware Requirements for Embedded Platforms • • • • • • RS9116 Evaluation Kit.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 27.2.4 Cross Compile and Copy OneBox-Mobile Software If the OneBox-Mobile software's source is available, follow the steps mentioned in the Compiling the Driver section in order to cross compile the OneBox-Mobile software for i.MX6. Assign the DEF_KERNEL_DIR variable in the Makefile as follows (assuming the kernel source is available in the "/lib/ modules" folder): DEF_KERNEL_DIR:= /lib/modules/linux-3.0.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 4. Preparing the MMC Card: An SD/MMC memory card is required to transfer the bootloader and kernel images for initializing the partition table and copy the root file system. This is included in the i.MX53 Evaluation Kit. Refer to the i.MX53_EVK_Linux_BSP_UserGuide.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 • Stop bits: 1 • Parity: None • Flow Control: 1. Connect the RJ45 cable between the PC and the board. 2. Follow the instructions given at http://www.at91.com/linux4sam/bin/view/Linux4SAM/GettingStarted in order to setup the board with the Linux OS kernel version 2.6.30. 27.4.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 28 Appendix C: Using the Bluetooth Manager The steps given below explain about the usage of the Bluetooth Manager in Fedora Core 18 on an x86 platform for pairing Bluetooth devices and transferring files. Once the Bluetooth modules have been installed using wlan_bt_insert.sh or onebox_insert.sh script present in the "release" folder as per the instructions mentioned in Section 4.1, hit the "Windows" button on the keyboard.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Select the particular device, like your smartphone, right click and select Pair tab to pair with that device. After successfully pairing with the device, right-click on the device and select "Send a file" button in order to send data to the device. You will be presented with a dialog box to select the file that you wish to send.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 29 Appendix D: Common Configuration Parameters The common_insert.sh script is used to configure parameters at boot time. The parameters with their usage and input values are described below. 29.1 RF Power Mode parameter The RF Power Mode parameter is used to set the power mode at which the RF operates. It is applicable for each protocol. By default, it is set to high power TX and high power RX.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 If antenna diversity selection feature is also enabled, initial operation will start on the antenna selected. Antenna diversity operation will continue as expected. 29.3.1 COEX Mode selection This variable is used to select the Coex mode in which the module has to operate.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 30 Appendix E: Installation of Missing Generic Netlink Libraries libnl CFlags should be enabled with CONFIG_LIBNL32=y in supplicant and hostpad .config file \[The above configuration settings should be set to "y" in case NL80211 is used\]. Make sure that the NL80211 support and Hostapd support are enabled in the menuconfig during compilation.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 31 Appendix F: Procedure to use latest supplicant with NL80211 interface Follow the below steps to use latest supplicant with the NL80211 interface Download the supplicant from https://w1.fi/wpa_supplicant/ Extract the supplicant using the following command tar xvf wpa_supplicant-2.6.tar.gz cd wpa_supplicant-2.6/wpa_supplicant cp defconfig .
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 ctrl_interface=/var/run/wpa_supplicant update_config=1 network={ ssid="REDPINE_AP_CCMP" pairwise=CCMP TKIP group=CCMP TKIP key_mgmt=WPA-PSK psk="12345678" proto=WPA2 WPA bgscan="simple:10:-45:100" priority=1 } 31.1.2 Configure Connection quality monitoring (cqm ) rssi and hysteresis using iw command To know more about iw tool, refer to the section Configuration Using CFG80211.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 32 Appendix G: Considerations need to be made during hostapd usage 32.1 Parameters updated from hostapd.conf file The following are the parameters that will be updated from hostapd conf file instead of using onebox util ioctls. • Band Selection:To enable 40MHz for onebox-mobile AP using hostapd following params must be enabled in hostap.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 33 Appendix H: Antennae 33.1 Taoglas Antenna Part No : GW.71.5153 33.2 SMARTEQ Antenna Part No : 4211613980 33.3 InsideWLAN Antenna Part No : PRO-IS-299 33.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 34 RS9116 n-Link Software TRM Revision History Revision No. Version No. Date Changes 1 v1.0 October 2017 Preliminary version 2 v1.1 January 2018 3 v1.2 March 2018 Formatted the document as per Redpine document standard Added information related to FW_LOAD_MODE configuration option 4 v1.3 March 2018 Added information related to BGSCAN and ROAMING for NL80211 Driver 5 v1.4 April 2018 1.
RS9116 n-Link Linux and Android Technical Reference Manual Version : 2.0 July 2020 Revision No. Version No. Date Changes 10 v1.9 March 2019 1. Added the NOTES and updated the INFO for some WiFi ioctl Usage Guide commands. 2. Added Programming WLAN region based maximum powers from driver section. 3. Updated information of hostapd as radius server usage in Enterprise security using CFG80211 section 4. Updated set_scan_type ioctl in Wi-Fi ioctl Usage Guide section. 5.
RS9116 n-Link Linux and Android Technical Reference Manual Version :2.0 July 2020 Disclaimer The information in this document pertains to information related to Redpine Signals, Inc. products. This information is provided as a service to our customers, and may be used for information purposes only. Redpine assumes no liabilities or responsibilities for errors or omissions in this document. This document may be changed at any time at Redpine’s sole discretion without any prior notice to anyone.