Redpine Signals RS9116 Reference Manual Download Page 144

Page: 144 / 146

RS9116 n-Link Linux and Android Technical Reference Manual

Version : 2.0

July 2020

144

34 RS9116 n-Link Software TRM Revision History

Revision
No.

Version No.

Date

Changes

v1.0

October 2017

Preliminary version

v1.1

January 2018

Formatted the document as per Redpine
document standard

v1.2

March 2018

Added information related to FW_LOAD_MODE
configuration option

v1.3

March 2018

Added information related to BGSCAN and
ROAMING for NL80211 Driver

v1.4

April 2018

1. Added Appendix I page regarding hostapd.conf file

usage considerations

2. Added support for GTK offload feature
3. Added support for 802.11R roaming feature
4. Added support for PUF feature
5. Updated the hostapd configuration parameter info
6. Added new parameter(service period length) in uapsd

power save params ioctl.

v1.5

June 2018

1. Modified AP set channel/frequency command usage

Wi-Fi ioctl Usage Guide section.

2. Updated PER transmit and receive commands in Wi-Fi

Performance Test ioctl usage section.

Updated info note in

Monitor Mode

section.

4. Fixed documentation issues.
5.

Added information of radius server usage in

Enterprise security using CFG80211

section.

v1.6

October 2018

1. Added Notes in bgscan ioctl section
2. Added missing info notes in IOCTL section.
3. Added information regarding Country code update

from supplicant in NL mode.

4. Fixed documentation issues.
5. Removed ESSID change and modified channel change

commands in

Wi-Fi ioctl Usage Guide section

v1.7

December 2018

1. Updated configuration parameters for WIFI PER mode

Wi-Fi Performance Test ioctl usage

2. Added

Steps to configure 802.11W

3. Updated BLE Transmit commands.
4. Updated ioctl details for hostapd.
5. Fixed documentation issues.

v1.8

January 2019

1. Removed the set mode and get mode commands in

Wi-Fi ioctl Usage Guide section.

Summary of Contents for RS9116

Page 1: ... 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 com RS9116 n Link Linux and Android Technical Reference Manual Version 2 0 July 2020 ...

Page 2: ...mation 30 5 Wi Fi ioctl Usage Guide 31 5 1 Configuring using Wireless Extensions 31 5 2 Private Driver Specific Commands for Access Point and Client Modes 33 5 3 Private Driver Specific Commands for Access Point Mode 38 5 4 Private Driver Specific Commands for Client Mode 43 5 5 Configuring Using onebox_util 44 6 Configuration Using CFG80211 65 6 1 Using iw Wireless Tool 65 7 Enterprise security u...

Page 3: ...rameters 92 15 5 Procedure to enable device power save for USB interface 93 16 Compliance and Certification 95 16 1 Federal Communication Commission Statement 95 16 2 Industry Canada ISED Statement 95 16 3 Regulatory Module Integration Instructions 96 17 Wi Fi Performance Test ioctl usage 98 17 1 WiFi Transmit Tests 98 17 2 Wi Fi Receive Tests 101 17 3 Continuous Wave CW mode 102 18 Wake On Wirele...

Page 4: ...ing 122 25 Android support for RS9116 124 26 Appendix A Configuration of Kernels from 3 13 and above 125 26 1 SDIO Stack Options 125 26 2 Wireless Extension Tools 126 26 3 Bluetooth Stack Options 127 26 4 Kernel Compilation 128 27 Appendix B Binary Files for Embedded Platforms 129 27 1 Common Hardware Requirements for Embedded Platforms 129 27 2 Freescale i MX6 129 27 3 Freescale i MX53 130 27 4 A...

Page 5: ...ing 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 143 33 1 Taoglas Antenna 143 33 2 SMARTEQ Antenna 143 33 3 InsideWLAN Antenna 143 33 4 PCB Antenna 143 34 RS9116 n Link Software TRM Revision History 144 ...

Page 6: ...Linux and Android Technical Reference Manual Version 2 0 July 2020 6 About this Document This document is a preliminary version of RS9116 n Link Technical Reference Manual for Linux and Android provided to customers ...

Page 7: ... The OneBox Mobile Coexistence software supports the following combination of modes They are as follows WLAN STATION WIFI Direct WLAN PER WLAN ACCESS POINT including muliple APs on different vaps WLAN ACCESS POINT STATION MODE on multiple vaps WAKE ON WIRELESS WOWLAN BT LE MODE BT LE PER MODE WLAN STATION BT LE MODE WLAN STATION BT LE MODE WLAN ACCESS POINT BT LE MODE The subsequent sections expla...

Page 8: ... ncurses and ncurses devel libraries 2 3 Software Package Contents The OneBox Mobile Software is delivered as a tarball with a filename in the format RS9116 NXX NL GEN LNX x y z tgz where the naming convention is as follows NXX defines whether the package supports only Wi Fi N00 or BT Low Energy along with Wi Fi NB0 x y z identifies the software package Redpine driver comes in proprietary and open...

Page 9: ...ined below 1 Save the required configuration of Driver using the menuconfig utility Following are the options available in menuconfig Host Interface SDIO or USB Operating system Linux or Android Nl80211 support Hostapd Support Wi Fi Bluetooth 2 To open menuconfig utility untar the tar ball go to source host folder enter the given below command make menuconfig The following images show the menuconf...

Page 10: ...ing 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 Figure 3 Selection of NL80211 and Hostapd Support ...

Page 11: ...nly the Wi Fi and Bluetooth mode must be enabled Refer to the following images of Menuconfig utility for more information Figure 4 Selection of WIFI Only Mode 3 After selecting the configuration exit the menuconfig and save the configuration Please refer the given below image of saving the configuration If NL80211 support is enabled in the driver make sure that the following modules are loaded in ...

Page 12: ... an x86 based Linux platform the path is usually lib modules kernel_version build and this is the path assigned in the Makefile provided in the package Example DEF_KERNEL_DIR lib modules 3 4 66 build Next use the make command to start compiling the driver For embedded platforms add the target platform and toolchain path as cross compilation option to the make command For example if the target plat...

Page 13: ...3 In order to un install the RSI opensource driver use the following commands rmmod rsi_usb rmmod rsi_sdo rmmod rsi_91x 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 ...

Page 14: ... Load protocol related Modules Wi Fi BT Load common Hal Modules onebox_nongpl ko and onebox_gpl ko Note Please change operating voltage configuration 1 8V or 3 3V in common_insert sh file in FEATURE_BITMAP_9116 Example For 3 3V keep FEATURE_BITMAP_9116 0 For 1 8V keep FEATURE_BITMAP_9116 2 For 3 3V 5Mhz BW keep FEATURE_BITMAP_9116 32 Note Please select appropriate SLEEP CLOCK SOURCE in common_inse...

Page 15: ...lects all the protocols in Menuconfig during the compilation of Driver use the command below sh onebox_insert sh and need to run individual protocol enable scripts 4 3 Disabling a Protocol Execute he following command to disable required protocol s onebox_util rpine0 disable_protocol protocol_value the possible values of protocol is same as mentioned in Enabling a Protocol Note If user wants to di...

Page 16: ...n the release folder and enter the parameters of the Wi Fi network as given below For Open non Secure mode network ssid SSID of Access Point key_mgmt NONE For WPA PSK TKIP mode network ssid SSID of Access Point key_mgmt WPA PSK psk passphrase specified in the Access Point proto WPA pairwise TKIP group TKIP For WPA2 PSK CCMP mode network ssid SSID of Access Point key_mgmt WPA PSK psk passphrase spe...

Page 17: ...XX wep_tx_keyidx X The key can be input either in ASCII or Hexadecimal formats ASCII Format wep_key0 1234567890123 Hexadecimal Format wep_key0 12345678901234567890123456 The key index can vary between 0 and 3 For WEP Shared 64 bit mode network ssid SSID of Access Point key_mgmt NONE wep_key0 XXXXXXXXXX wep_tx_keyidx X auth_alg SHARED The key can be input either in ASCII or Hexadecimal formats ASCI...

Page 18: ... Mb s Tx Power 16 dBm Sensitivity 1 0 RTS thr off Fragment thr off Encryption key Security mode restricted Power Management off Link Quality 80 80 Signal level 28 dBm Noise level 0 dBm Rx invalid nwid 0 Rx invalid crypt 0 Rx invalid frag 0 Tx excessive retries 0 Invalid misc 0 Missed beacon 0 This command gives the status of the device If the connection is successful then the connected Access poin...

Page 19: ...ity modes sh start_ap sh conf_file For example sh start_ap sh wpa_supplicant_open conf The different configuration files conf files present in the release folder are as follows For Access Point in Open Mode wpa_supplicant_open conf configuration file is used and this starts an Access Point with the following parameters SSID REDPINE_AP Channel 1 of 2 4GHz Band 2412 MHz Open non Secure mode For Acce...

Page 20: ...requency 2 432 GHz Access Point 88 DA 1A 16 E5 5D Bit Rate 6 Mb s Tx Power 30 dBm Sensitivity 1 0 RTS thr off Fragment thr off Encryption key off Power Management off Link Quality 80 80 Noise level 0 dBm Rx invalid nwid 0 Rx invalid crypt 0 Rx invalid frag 0 Tx excessive retries 0 Invalid misc 0 Missed beacon 0 This command gives the status of the device It displays the Access Point s SSID along w...

Page 21: ...oned in Figure 4 3 Compile the driver make 4 Go to the release folder and start the device in station mode cd release sh wlan_enable sh 5 Issue the following command to get physical interfaces on which we can add wifi0 interface iw phy grep phy The output of the command will be phyX X can be 1 2 3 eg phy1 phy2 etc For SDIO mode ensure that the SDIO stack related modules are already inserted in the...

Page 22: ...owing the above 2 steps i e step 5 and step 6 we can directly create vap by using onebox_util binary present in the release folder cd release onebox_util rpine0 create_vap wifi0 sta sw_bmiss Run the supplicant after configuring sta_settings conf with required AP settings as mentioned in the section Installation in Wi Fi Client Mode with BSD interface support In the sta_settings conf file in additi...

Page 23: ...l interfaces on which we can add wifi0 interface iw phy grep phy The output of the command will be phyX X can be 1 2 3 eg phy1 phy2 etc Now add wifi0 interface to phyX service NetworkManager stop iw phy phy1 interface add wifi0 type __ap Instead of following the above steps in step 6 we can directly create vap by using onebox_util binary present in the release folder onebox_util rpine0 create_vap ...

Page 24: ...BSD Interface Support The steps for installing OneBox Mobile software in Wi Fi Direct Mode are as follows The start_p2p sh script present in the release folder needs to be run in order to start the supplicant and also for installing the Wi Fi Direct mode The configurable parameters in the p2p conf file are outlined below listen channel operating channel GO Intent After starting the supplicant the ...

Page 25: ...or installing the Wi Fi Direct mode The configurable parameters in the p2p_nl80211 conf file are outlined below listen channel operating channel GO Intent wpa_supplicant version used should be latest one 2 6 or higher Please check the start_p2p_nl80211 sh script for better understanding and update it accordingly After starting the supplicant the p2p_commands mentioned below should be executed To f...

Page 26: ...calls from other P2P Devices in the vicinity You can see the running logs on wpa_cli prompt for the device getting connected Legacy Wi Fi clients non P2P clients need a passphrase to connect to the p2p group The command given below generates the passphrase for legacy Wi Fi clients wpa_cli i wifi0 p2p_get_passphrase Run DHCP Server on GO Interface before connecting P2P or Legacy devices 4 4 6 2 To ...

Page 27: ...n below cmd in wpa_cli cmd promt wps_pbc If p2p client is RSI p2p client then we need to run below cmd on RSI P2P Client side wpa_cli i wifi0 p2p_connect RSI P2P_GO Mac Addr pbc join 2 GO negotiation Mode Steps for installing Onebox Mobile software in Wi Fi Direct Mode Open the common_insert sh file present in the release folder Ensure that the DRIVER_MODE and COEX_MODE are set as below DRIVER_MOD...

Page 28: ...vice as client and 15 makes p2p device as group owner If you are becoming GO dhcp server should be running on GO Interface After becoming p2p go run below cmd wpa_cli i wifi0 To recieve each connection request from P2P Client s every time need to run below cmd in wpa_cli cmd promt wps_pbc If p2p client is RSI p2p client then we need to run below cmd on RSI P2P Client side wpa_cli i wifi0 p2p_conne...

Page 29: ...has been started successfully or not by running the following command hciconfig If the driver is loaded correctly the above command displays a network adaptor named hciX An example output is given below hci0 Type BR EDR Bus SDIO BD Address 00 23 A7 00 05 68 ACL MTU 1021 8 SCO MTU 30 8 UP RUNNING PSCAN RX bytes 478 acl 0 sco 0 events 20 errors 0 TX bytes 331 acl 0 sco 0 commands 19 errors 0 4 After...

Page 30: ...n to view Wi Fi related statistics related to module then Use the below command cat proc rpine0 stats When 2nd usb device is connected to same host then rpine1 will get created In order to see the Wi Fi related statistics related to 2nd usb module use the below command cat proc rpine1 stats This command prints statistics related to the total management packets total data packets with respect to a ...

Page 31: ... the software package This section describes the usage of iwconfig in conjunction with the Onebox Mobile driver For a detailed description of the tool refer to the relevant main pages in Linux iwconfig only works when the driver is operating in the BSD mode The details of the Access Point for which the n Link is connected in the Client mode can be viewed by using the given below command iwconfig v...

Page 32: ... MCS1 26 MCS2 39 MCS3 52 MCS4 78 MCS5 104 MCS6 117 MCS7 130 Output Parameter None Reset required No Usage iwconfig vap_name rate rate_val Note For Access Point mode this command has to be issued after the Set Mode command only if the VAP has started using iwconfig commands and not using the supplicant provided by Redpine Signals For Client mode the Set Mode command is not mandatory Set RTS CTS Thr...

Page 33: ...he two values shall be used Default Value Input Parameters VAP Name string like wifi0 wifi1 etc Integer value in dBm Output Parameter None Reset Required No Usage iwconfig vap_name txpower val_in_dBm Example iwconfig wifi0 txpower 10 Note Txpower setting can be defined as the minimum value that can be picked from the max regulatory power settings from any user defined value and also from the maxim...

Page 34: ...Parameter None Reset Required Yes Refer to the example for the reset process Usage iwpriv vap_name short_gi value Example The commands given below set the Short GI for 20MHz bandwidth and then reset the adapter for the command to take effect iwpriv wifi0 short_gi 1 onebox_util rpine0 reset_adapter Note Issue this ioctl before starting the supplicant Note Here short_gi ioctl will work only in case ...

Page 35: ...ription This command is used to get the Privacy bit of the n Link Module Default Value Input Parameters VAP Name string like wifi0 wifi1 etc Output Parameter The integer value mapping has been shown below 0 Privacy is disabled 1 Privacy is enabled Reset Required No Usage iwpriv vap_name get_privacy Example The command given below tells about like how to get the Privacy information in the module iw...

Page 36: ...ut Parameters VAP Name string like wifi0 wifi1 etc The integer value mapping has been shown below 0 Disable AMPDU Aggregation 1 Enable AMPDU Aggregation for Transmit disable for Receive 2 Enable AMPDU Aggregation for Receive disable for Transmit Output Parameter None Reset Required No Usage iwpriv vap_name ampdu_set value Example The command given below disables A MPDU aggregation iwpriv wifi0 amp...

Page 37: ...width in Access Point mode onebox_util rpine0 delete_vap wifi0 onebox_util rpine0 create_vap wifi0 ap iwpriv wifi0 set_htconf value wpa_supplicant i wifi0 wpa_supplicant_open conf Note Issue this ioctl before starting the supplicant The commands given below is used to set the 20MHz bandwidth in Client mode and reset the Client for the command to take effect iwpriv wifi0 set_htconf 1 onebox_util rp...

Page 38: ...t and Client Modes 5 3 Private Driver Specific Commands for Access Point Mode The table below describes the usage of the iwpriv command for setting and getting parameters common for the Access Point Mode Set DTIM Period Description This command is used to set the DTIM period in the n Link Module Issue this command before starting the supplicant Default Value 1 Input Parameters VAP Name string like...

Page 39: ...t Note Here dtim_period ioctl will work only in case of bsd To set dtim_period using hostapd refer to the section Appendix G Considerations need to be made during hostapd usage Get DTIM Period Description This command is used to get the DTIM period in the n Link Module Default Value Input Parameters VAP Name string like wifi0 wifi1 etc Output Parameter Integer value ranges between 1 and 15 Reset R...

Page 40: ...y commands need to be issued before starting the wpa_supplicant Default Value Input Parameters VAP Name string like wifi0 wifi1 etc The integer value mapping has been shown below 0 Disable Access Policy 1 Enable Access Policy and Allow connection 2 Enable Access Policy and Deny connection Output Parameter None Reset Required No Usage iwpriv vap_name maccmd value Example The command given below ena...

Page 41: ...m the Access Policy described in the n Link Module Default Value Input Parameters VAP Name string like wifi0 wifi1 etc 48 bit MAC Address in hexadecimal format with colon separation e g 00 23 A7 01 02 03 Output Parameter None Reset Required No Usage iwpriv vap_name delmac mac_addr Example The command given below is used to delete a MAC Address 10 10 A9 12 13 14 from the ACL Policy iwpriv wifi0 del...

Page 42: ...ns for onebox mobile AP using hostapd refer to the section Appendix G Considerations need to be made during hostapd usage Set DFS channel to switch to Description This command is used to select a channel to switch to in case of Radar Detection in Access Point mode This is used only when the bsd driver is used Default Value Disabled A channel gets picked at random Input Parameters VAP Name string l...

Page 43: ...Input Parameters VAP Name string like wifi0 wifi1 etc Integer value ranges between 15 and 12000 seconds Integer value should be a multiple of 15 if the value is not a multiple of 15 it will rounded off to nearst multiple of 15 Output Parameter None Reset Required No Usage iwpriv vap_name keep_alive value Example The command given below sets the Keep Alive period to 30 seconds after rounding off 35...

Page 44: ...g iwpriv wifi0 setparam 12 1 Set Keep Alive Period Description This command is used to set the Keep Alive period in the n Link Module Default Value 90 seconds Input Parameters VAP Name string like wifi0 wifi1 etc Integer value ranges between 15 and 12000 seconds Output Parameter None Reset Required No Usage iwpriv vap_name keep_alive value Example The command given below sets the Keep Alive period...

Page 45: ...an Access Point only for Client mode Valid inputs are sw_bmiss Beacon filtering disabled All beacons of connected Access Point provided to Host driver hw_bmiss Beacon filtering is enabled The Beacon is provided to Host driver when there is a change in the Beacon from the connected Access Point This feature also programs the device to indicate to the Host driver when 20 consecutive beacons are not ...

Page 46: ...wifi1 etc v Get description of the fields in the statistics Filename string to which the statistics will be written Output Parameter Statistics like 1 Number of Beacons transmitted for Access Point P2P GO modes 2 Number of Beacons received for Client P2P Client modes 3 Number of Management packets received 4 Number of packets received from a different BSS etc Reset Required No Usage onebox_util va...

Page 47: ... filename Example The command below logs the statistics of the packets exchanged between the Access Point wifi0 and a Station with MAC address 00 1C 2b 10 19 1a into the file named stats onebox_util wifi0 print_station_stats 00 1C 2b 10 19 1a v f stats Select Antenna Description This command is used to select one of the two RF ports connecting to antennas For the modules without integrated antenna...

Page 48: ... an integrated antenna onebox_util rpine0 ant_sel 3 Enable Background Scan and Set Parameters only in Client mode Description This command is used to enable background scan and set the relevant parameters Refer to the section on Background Scan Parameters for more details on each parameter Default Value 2 Input Parameters Base Interface string like rpine0 Background Scan Threshold RSSI Tolerance T...

Page 49: ... set_bgscan_params 10 10 3 20 100 1 3 36 40 44 Note In order to select 11J channels 8 12 16 enter the channel number as 8J 12J 16J respectively Remaining 11J channels can be selected with their channel numbers Example onebox_util rpine0 set_bgscan_params 10 10 3 20 100 1 4 36 40 44 8J Host Triggered Background Scan only in Client mode Description This command is used to trigger background scan wit...

Page 50: ...ssid Example The command below sets the SSID of a Hidden Access Point during Background Scan onebox_util rpine0 bgscan_ssid REDPINE_AP Note The bgscan_ssid command has to be followed by the set_bgscan_params or do_bgscan command in order for the Probe Request to be sent with the SSID requested in the bgscan_ssid command Enable Power Save and Set Parameters only in Client mode Description This comm...

Page 51: ...eep_type tx_threshold rx_threshold tx_hysteresis rx_hysteresis monitor_interval sleep_duration listen_interval_duration num_beacons_per_listen_interval dtim_interval_duration num_dtims_per_sleep Example The command below enables ULP Power Save Mode for a duration of 100 ms and with a listen_interval_duration of 100ms onebox_util rpine0 set_ps_params 1 2 0 0 0 0 0 100 100 0 0 1 Enable UAPSD Normal ...

Page 52: ...nebox_util base_interface set_uapsd_params 0xF sp_len uapsd_wakeup_period Example The command enables UAPSD mode and sets the wakeup period as 100ms onebox_util rpine0 set_uapsd_params 0xF 0 100 Note The set_uapsd_params command needs to be followed by the command given below for the values to take effect onebox_util base_interface reset_adapter Reset Adapter only in Client mode Description This c...

Page 53: ...l interface has to be reset Usage onebox_util base_interface set_beacon_intvl beacon_intvl Example The commands given below are used to reset the Access Point and set the beacon interval to 100ms 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 Installation of Modules onebox_util rpine...

Page 54: ...pecific 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 Default Value Access Point AIFSN Cwmin Cwmax TxOp AC_BE 3 4 6 0 AC_BG7 4 10 0 AC_VI 1 3 4 94 AC_VO1 2 3 47 Station AIFSN Cwmin Cwmax TxOp AC_BE 3 4 6 0 AC_BG7 4 10 0 AC_VI 4 3 4 94 AC_VO4 2 3 47 ...

Page 55: ...e data packets queue 2 VI_Q Video data packets queue 3 BK_Q Background data packets queue 4 BE_Q Best effort data packets queue Self or Broadcast selection Self is for the module s Access Point VAP Broadcast is for Clients connected to the Access Point Update Params integer value mapped as below 0 To set more WMM Parameters 1 To update current WMM Parameters Output Parameter None Reset Required No...

Page 56: ...UNITED STATES 124 CANADA 484 MEXICO ETSI 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 Output Parameter None Reset Required Yes In order to change the country code the virtual interface has to be reset Usage onebox_util base_interface set_country country_code ...

Page 57: ... JP Reset Required No Usage onebox_util base_interface get_info country Example onebox_util rpine0 get_info country Set External Antenna Gain Description This command is used to program the gain of the external antenna for the module without antenna The gain values are used by the module to attenuate the output transmit power so that regulatory requirements like FCC ETSI etc are not violated This ...

Page 58: ...selected antenna type for the corresponding path so that the regulatory requirements like FCC ETSI etc are not violated This command needs to be given before creating the VAP in the normal mode and before the transmit command in the Wi Fi Performance Test ioctl usage as mentioned in the section Wi Fi Performance Test ioctl usage Default Value ant_path 1 ant_type 1 For ant_path If value is 1 then i...

Page 59: ... hexadecimal format with colon separation e g 00 23 A7 01 02 03 valid when Unicast packet filtering from specific MAC address is enabled Host Sleep Status WoWLAN Flags Output Parameters None Reset Required No Usage onebox_util base_interface wowlan src_mac_addr host_sleep_status wowlan_flags Example onebox_util rpine0 wowlan 00 23 a7 0c bb aa 1 3 Set RF Power Mode Description This command is used ...

Page 60: ...ommand performs scan only in 2 4Ghz band Note Issue this command before creating station virtual interface Set Beacon Filter Only in AP mode Description This command is used to enable beacon filtering in the firmware All the third party beacons will be filtered at the firmware after applying beacon filter Ioctl Default Value 0 Disabled by default Input Parameters The integer value mapping has been...

Page 61: ...All rates supported as per regulatory domain Input Prameters Integer value as per the mapping below 1 Mbps 2 2 Mbps 4 5 5 Mbps 11 11 Mbps 22 6 Mbps 12 12 Mbps 24 Output Parameters None Reset Required No Usage onebox_util base_interface useonly_rates rate_val rate_val rate_val Example onebox_util rpine0 useonly_rates 2 11 12 Table 5 Usage of onebox util 5 5 1 WPS Configuration Wi Fi Protected Setup...

Page 62: ...e as follows 1 Start the driver in Access Point mode 2 Start the supplicant by entering the following command wpa_supplicant i vap_name D bsd c wps_conf_file ddddt 3 For Push Button method Push the button on the STA Enter the command below for the n Link Access Point wpa_cli i vap_name wps_pbc sta_mac_addr 4 Wait for the STA to parse all the WPS Access Points 5 For Enter PIN method Click on Genera...

Page 63: ...PS in Client mode are as follows 1 Start the driver in Client mode 2 Start the supplicant by entering the following command wpa_supplicant i vap_name D bsd c wps_conf_file ddddt 3 For Push Button method Push the button on the Access Point Enter the command below for the n Link STA wpa_cli i vap_name wps_pbc bssid Note This is the Access Point s MAC address If the BSSID is not known the input param...

Page 64: ... Android Technical Reference Manual Version 2 0 July 2020 64 wpa_cli i vap_name wps_pin bssid 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 ...

Page 65: ...sted by user Default Value Input Parameters phy name Phy name can be obtained by using the following command iw phy In case of multiple wireless interfaces are present please refer to the NOTE given below on how to determine the phy name interface name name of the virtual interface to be created operating mode operating mode of the virtual interface that can be either managed for station mode or _...

Page 66: ...EP Security iw dev interface_name ssid_name bssid keyid key_index key Example iw dev wifi0 connect REDPINE_AP 00 23 a7 00 05 55 The above command connects to REDPINE_AP access point in open mode iw dev wifi0 REDPINE_AP 00 23 a7 00 05 55 keys d 1 234567890 The above command instructs our device to connect to the REDPINE_AP in wep64 mode with the key index 1 and key 234567890 Disconnect Description ...

Page 67: ... about the device Default Value Input Parameters Interface name Output Parameter Interface mac address type operating mode etc Reset Required No Usage iw dev interface_name info Example iw dev wifi0 info Station Dump Description This command is used to station statistic information such as the amount of tx rx bytes the last TX bitrate including MCS rate Default Value Input Parameters Interface nam...

Page 68: ...Parameter No Reset Required No Usage iw dev interface_name set power_save on off Example iw dev wifi0 set power_save on off Get Power save mode Description This command is used to get power save mode on off in station mode Default Value Input Parameters Interface name Output Parameter Shows whether power save mode is on off in station mode Reset Required No Usage iw dev interface_name get power_sa...

Page 69: ...r usage iw phy phyname info iw dev devname del iw reg get iw reg set ISO IEC 3166 1 alpha2 iw dev devname scan dump u iw phy phyname set name new name The commands that are supported only in the Access Point mode are as follows iw dev devname set channel channel HT20 HT40 HT40 iw dev devname set freq freq HT20 HT40 HT40 iw dev devname station del MAC address iw dev devname station get MAC address ...

Page 70: ...low Edit users file which will contain the identity and password vim usr local etc raddb users Add the following line at the starting in the users file test Cleartext Password password 2 As an example user1 is an identity and test123 is the password that has to be entered at client side i e in the sta_settings conf file 3 Now we need to edit eap file which contains the paths consisting of certific...

Page 71: ...he terminal radiusd X 7 2 Configuration of AP and RADIUS server to use EAP methods Hostapd is used as the RADIUS Server The AP and the server are co located in the same system The following packages which have to be installed are as follows libnl devel libsqlite3x devel For openssl versions of range 1 0 2 release 1 0 2h release or in range 1 0 1 1 0 1t release or in range 1 1 0 1 1 0a release edit...

Page 72: ... script present in the release folder as per the instructions mentioned in Section 4 1 iw phy phyX interface add wifi1 type __ap where X represents phy number It can be obtained by the following command iw list grep phy Before starting the device in AP mode ensure that in hostapd_eap conf the following entities are enabled ieee8021x 1 own_ip_addr 192 168 2 1 IP address of AP RADIUS authentication ...

Page 73: ...nterface wifi1 so that RADIUS server will listen on that interface name Start the RADIUS server after AP had started in a new terminal hostapd hostapd_server conf ddddd All the Credentials will be in etc certs hostapd eap_user file A sample hostapd eap_user file is present in the certs tgz in the release folder The etc certs hostapd radius_clients file contains the IP required to communicate the s...

Page 74: ...sh or wlan_zigb_insert sh or onebox_insert sh script present in the release folder as per the instructions in Section 4 1 service NetworkManager stop iw phy phyX interface add wifi0 type managed Run the supplicant after configuring sta_settings conf according to the required EAP method The network blocks listed below can be used as a reference wpa_supplicant i wifi0 D nl802ll c sta_settings conf d...

Page 75: ... test password password ca_cert etc certs wifiuser pem client_cert etc certs wifiuser pem private_key_passwd Wi Fi private_key etc certs wifiuser key To connect using EAP FAST method sta_settings conf should be described as below network ssid Redpine_Signals key_mgmt WPA EAP eap FAST anonymous_identity fastuser identity test password password phase1 fast_provisioning 1 pac_file etc p1 pac phase2 a...

Page 76: ...Signals key_mgmt WPA EAP eap LEAP identity user1 password test123 To connect using EAP LEAP for CCX sta_settings conf should be described as below network ssid Redpine_Signals key_mgmt WPA CCKM eap LEAP identity user1 password test123 pairwise TKIP group TKIP proto WPA2 WPA scan_ssid 1 priority 2 radiusd X ...

Page 77: ...ed to use the network It should also be noted that the AP and a client device may change roles i e AP acts as an Enrollee and client device as a Registrar when WPS is used to configure the access point 8 1 Hostapd Configuration before Compilation WPS component needs to be enabled in hostapd build configuration config i e vim host wlan hostapd 2 3 hostapd config Ensure that the below mentioned enti...

Page 78: ...t in the release folder as per the instructions mentioned in Section 4 1 is phi it will give phyX number iw phy phyX interface add wifi1 type __ap hostapd hostapd_wps conf ddddddt log sh dhcp_server sh wifi1 hostapd_cli wps_pbc Now push wps button on station side At this point the client has two minutes to complete WPS negotiation 8 3 2 AP mode for WPS Enter pin method sh wlan_enable sh or wlan_bt...

Page 79: ...d wifi1 type __ap hostapd hostapd_wps conf ddddddt log sh dhcp_server sh wifi1 hostapd_cli wps_ap_pin random timeout The above command generates a random AP pin number If the optional timeout parameter is given then the AP pin will be enabled for the specified number of seconds hostapd_cli wps_ap_pin random 300 The above command generates a 8digit random pin which needs to be entered at the statio...

Page 80: ...configure 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 PIN timeout Sets the AP PIN and enables it If the optional timeout parameter is given the AP PIN will be enabled for the specified number of seconds 8 3 7 Get the current configuration hostapd_cli get_config The above command dis...

Page 81: ...ce and driver in hostapd conf file driver will be nl80211 for this interface wlan0 driver nl80211 Set SSID you want to configure ssid REDPINE Set hw_mode to g for 2 4 GHz hw_mode g Set channel 0 For ACS this value should be zero Hostapd will pick a channel depending upon survey dump from driver channel 0 Select the number of scans to be performed to trigger survey data commands Hostapd will call t...

Page 82: ...s feature will persist for the entire duration of operation 10 2 Configuration The steps described in this section are used to start the antenna diversity feature in Client mode only Once it is enabled the antenna selection happens automatically 1 Open the common_insert sh file present in the release folder 2 Ensure that the variable RSI_ANTENNA_DIVERSITY is set as given below RSI_ANTENNA_DIVERSIT...

Page 83: ...d start the driver modules by using the given below command sh wlan_enable sh Create the virtual interface in monitor mode onebox_util base_interface create_vap wifi0 mon For NL80211 mode Set Country code with the following command iw reg set Country_code Ex iw reg set JP This command will set country to Japan To select the channel use the given below command iwconfig interface_name wifi0 freq Fre...

Page 84: ...te_vap wifi1 mon ifconfig wifi0 up ifconfig wifi1 up tcpdump i wifi1 Example Scenario 2 Create an Access Point mode VAP a Client mode VAP and a Monitor mode VAP and display the packets which are being transferred to from the Access Point and Client onebox_util rpine0 create_vap wifi0 ap onebox_util rpine0 create_vap wifi1 sta sw_bmiss onebox_util rpine0 create_vap wifi2 mon ifconfig wifi0 up ifcon...

Page 85: ...older cd home rsi release sh wlan_insert sh Create VAP in client mode using command onebox_util rpine0 create_vap vap name sta sw_bmiss For example onebox_util rpine0 create_vap wifi0 sta sw_bmiss After issuing the above command virtual interface with the specified interface name wifi0 will be created User can view the list of interfaces using the following command ifconfig a Make sure the appropr...

Page 86: ...city This parameter specifies the interval between the scans The unit of this field is seconds Setting the value of this field as 0 will disable scans b Active scan duration This parameter determines the duration of the active scan in each channel during the on demand scan process The recommended value for this parameter is 20ms for quicker scan operations and uninterrupted throughput The maximum ...

Page 87: ...e please follow th e below command onebox_util rpine0 delete_vap vap_name Ex onebox_util rpine0 delete_vap wifi0 You can create two VAPs at a time and then run corresponding supplicant command because supplicant command will be differentiated by using the interface name user has mentioned while creating VAP 13 1 3 State of the Station To check the Station state Use the below command onebox_util rp...

Page 88: ... 3 AUTH This is an intermediate state during connection Once the STA collects the SCAN results and sends to the supplicant if any desired BSS is found then the STA moves to this state to complete authentication 4 ASSOC Once the AUTH is successful the STA moves to the ASSOCIATION State 5 RUN Once the ASSOCIATION is successful the STA moves to RUN state and the user can co relate this to Connection ...

Page 89: ...P mode would also not be operational i e the AP stops beaconing and disconnects all of the connected stations Background scan Bg scan and powersave features are not supported for the station mode vap in concurrent mode In NL80211 mode STA VAP has to be settled first i e should be connected to use proper country code Whatever country of STA VAP s AP third party AP to which STA is connected that wil...

Page 90: ...an Assigning a large value to this field will eliminate this method of triggering background scans periodicity This parameter specifies the interval between the background scans The unit of this field is seconds Setting the value of this field as 0 will disable background scans active_scan_duration This parameter determines the duration of the active scan in each channel during the Background scan...

Page 91: ...e Profile PSP or Fast PSP These profiles are used by the module to decide when to enter and exit from power save modes on the fly They have to be selected based on the performance and power consumption requirements of the end product Traffic Based PSP This profile is dependent on the tx_threshold and rx_threshold parameters which indicate transmit and receive throughput thresholds beyond which the...

Page 92: ...re is no packet transmitted for the sleep duration programmed in the set_ps_params command If the Access Point does not support UAPSD the module mimics this mode by waking up whenever there is a packet to be transmitted It generally transmits the packet and then retrieves the pending data from the Access Point by sending a PS_POLL packet 15 4 Power save Parameters The input parameters of the set_p...

Page 93: ...ies the number of beacon intervals for which the module sleeps in the connected state power save modes Here the device will wake up for the nth beacon where n is the listen interval value programmed by the user If a non zero value is assigned to this parameter it takes precedence over the other sleep duration parameters that follow dtim_interval_duration num_dtims_per_sleep This parameter is used ...

Page 94: ...etwork 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 Read the manufacturer of 2 1 device using following command cat sys bus usb devices 2 1 manufacturer The output of this command should be Redpine Signals Inc Issue the following command to enable device power saves for RSI module in U...

Page 95: ...nt off and on the user is encouraged to try to correct the interference by doing one or more of the following measures Reorient or relocate the receiving antenna Increase the separation between the equipment and receiver Connect the equipment into an outlet on a circuit different from that to which the receiver is connected Consult the dealer or an experienced radio TV technician for help FCC Caut...

Page 96: ...ntioned statement or equivalent notice in a conspicuous location in the user manual or alternatively on the device or both Le module M7DB a été étiqueté avec son propre numéro d ID IC 8407A M7DB7 et si l ID IC n est pas visible lorsque le module est installé dans un autre périphérique alors l extérieur du produit fini dans lequel le module est installé doit également afficher une étiquette faisant...

Page 97: ... device until the interference hasbeen corrected 2 10 Additional testing Part 15 sub part B disclaimer The final host module combination need to be evaluated against the FCC Part 15Bcriteria for unintentional radiators in order to be properly authorized for operation as a Part15 digital device Below are steps for TX verification Already in the manual Other in User Manual The host integrator instal...

Page 98: ...upported in the current release Rate Flags like Short GI Greenfield etc Enable Disable Aggregation Number of packets to be transmitted in Burst Mode Delay between packets in Burst Mode Regulatory Domain 17 1 1 Transmit Command Usage The command usage is explained below transmit base interface tp r l m c p f a n d rd base_interface This parameter specifies the Base Interface string like rpine0 tp T...

Page 99: ...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 4 40 9 2452 2 4 40 10 2457 2 4 40 11 2462 p Enable Disable External PA This parameter is not supported in the current release f Rate Flags This parameter is used to enable disable Short GI and Greenfield and also to set the channel width of the transmitted packets The table b...

Page 100: ...de of transmission n Number of packets to be transmitted in Burst mode The transmission stops after the number of packets specified by this parameter are transmitted in the Burst mode If this value is 0 then the transmission will not stop until the user gives the transmit 0 command inorder to stop the transmissions This parameter is ignored in the case of Continuous mode of transmission d Delay be...

Page 101: ...t GI with Full 40MHz Channel width Aggregation disabled Number of packets to be transmitted 1000 Delay between the packets 0 17 2 Wi Fi Receive Tests The receive utility present in the release folder can be invoked for displaying the following information Total number of CRC PASS packets Total number of CRC FAIL packets and Total number of FALSE CCAs 17 2 1 Receive Command Usage receive base inter...

Page 102: ... number in which the transmission has to be done Please refer to the Table 7 Channel Numbers and Corresponding Center Frequencies for a mapping between the channel numbers and the center frequencies start stop This parameter is used to start or stop the transmission Enter 0 to start transmission and 2 to stop transmission In order to start transmission for 11J 20MHz channels enter 1 type This para...

Page 103: ...ransmission with the following configuration Channel number 6 Type Single tone Transmit Power 2dBm The command used for stopping continuous wave transmission is outlined below onebox_util rpine0 cw_mode 6 2 2 The command used for starting transmission in 184 11J channel is outlined below onebox_util rpine0 cw_mode 184 1 2 The command used for stopping the transmission is outlined below onebox_util...

Page 104: ...inux power state machine Linux supports different power states to handle power management i e S3 suspend S4 hibernate and S5 poweroff WoWLAN can be verified through these power states which is the idle way Presently only S3 is supported in N Link Linux driver Also WoWLAN configuration is allowed in NL80211 interface only Enable ONEBOX_CONFIG_WOWLAN in Makefile to use this feature before building t...

Page 105: ...the type of triggers currently available in linux Possible triggers are any disconnect magic packet gtk rekey failure eap identity request 4way handshake rfkillrelease net detect interval in_msecs delay in_secs freqs freq matches ssid ssid active ssid ssid passive randomise addr mask tcp config file patterns offset1 pattern1 Triggers which are currently supported are any To wake for any received p...

Page 106: ...k 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 MAC_addr_of_our_device Or 2 etherwake MAC_addr_or_our_device For eatherwake application please edit ether wake c and go to main function update the ifname with the interface name of our device Compile the application using below command 3 gcc ether ...

Page 107: ... 3 PUF Operations and IOCTL Usage 19 3 1 PUF Enroll This operation enrolls PUF After successful operation Activation code will be either saved in flash or it will be sent to host The stored activation code shall be used for every further start operation on PUF onebox_util rpine0 puf_req 0 1 19 3 2 PUF Start This operation is used to start PUF Once valid activation code is available PUF will be sta...

Page 108: ...dy loaded into AES by PUF It also provides provision for decryption with AES engine for two modes ECB CBC Parameters should be provided depending on mode of usage onebox_util rpine0 puf_req 7 0 0 0 0 128 aes_enc_data txt 0 0 19 3 9 PUF AES MAC Generation This operation is used for generating Message authentication check MAC for the data inputted with provided key as well as Initialization Vector I...

Page 109: ...ference Manual Version 2 0 July 2020 109 onebox_util rpine0 puf_req 10 19 3 12 PUF Block Get Key This operation is used for blocking further Get Key operations onebox_util rpine0 puf_req 11 Refer the page Features for all IOCTL commands in detail ...

Page 110: ...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 onebox_util rpine0 gtk_offload 1 0 ...

Page 111: ...n in sta_settings conf file to connect to 802 11R AP network ssid SSID of Access Point key_mgmt FT PSK psk passphrase specified in the Access Point proto WPA2 pairwise CCMP group CCMP 2 Use following command to roam Over The DS for RSI 802 11R client wpa_cli i interface_name ft_ds AP_MAC_ID NOTE Here AP_MAC_ID is obtained from scan results and given manually ...

Page 112: ...2 priority 1 4 Configure AP as MFP Capable Required 22 2 Configuring and Compiling Driver for PMF in AP mode 1 Enable CONFIG_11W in Driver Makefile 2 Enable CONFIG_IEEE80211W y in hostapd config 3 Enable WPA PSK SHA256 as key_mgmt in hostapd_ccmp conf i pmf 1 2 PMF is enabled required correspondingly Make sure below options are enabled apart from your configuration This field is a bit field that c...

Page 113: ... wlan_gain_table txt file 3 Now give below commands sh wlan_enable sh onebox_util rpine0 update_wlan_gain_table With the above commands gain tables programming will start and a successful programming should show below output in dmesg logs Successfully completed programming n gain tables Here n is the number of structures given in wlan_gain_table txt file Note Please note that in END TO END mode ga...

Page 114: ...sed to issue a soft reset to the Bluetooth module Default Value Input Parameters None Output Parameter None Reset Required No Usage hcitool i hciX cmd 0x03 0x03 Read Local Version Information Description This command is used to read the local version information Default Value Input Parameters None Output Parameter HCI version HCI revision LMP version Manufacturer name LMP subversion Reset Required...

Page 115: ...scription This command is used to start the Inquiry process Default Value Input Parameters LAP 3 Bytes 0x9E8B00 0x9E8B3F Inquiry duration 0x01 to 0x30 1 28 to 61 44 Seconds Number of responses 0x01 0xFF Output Parameter None Reset Required No Usage hcitool i hciX cmd 0x01 0x01 LAP duration no_of_responses Write Local Name Description This command is used to Set the local device name Default Value ...

Page 116: ...2 ULP Ultra Low Power mode Sleep Duration in Standby mode in msec Range 0x00 0xFF Output Parameter None Reset Required No Usage hcitool i hciX cmd 0x3F 0x0003 sleep enable disable sleep mode sleep duration 24 2 Bluetooth Performance Test ioctl Usage The OneBox Mobile software provides applications to test Transmit and Receive performance of the module Open the common_insert sh file present in the ...

Page 117: ...mat e g 00112233 pkt_length Length of the packet in bytes to be transmitted ble_rate 1Mbps 1 2Mbps 2 125Kbps 4 500Kbps 8 rx_channel_index Receive channel index as per the Bluetooth standard i e 0 to 39 tx_channel_index Transmit channel index as per the Bluetooth standard i e 0 to 39 scrambler_seed Initial seed to be used for whitening It should be set to 0 in order to disable whitening In order to...

Page 118: ...IN 3 24 3 4 Appendix Frequencies and channel Numbers used for Bluetooth LE Mode Band GHz Bandwidth MHz Channel Centre Freq MHz 2 4 2 0 2402 2 4 2 1 2404 2 4 2 2 2406 2 4 2 3 2408 2 4 2 4 2410 2 4 2 5 2412 2 4 2 6 2414 2 4 2 7 2416 2 4 2 8 2418 2 4 2 9 2420 2 4 2 10 2422 2 4 2 11 2424 2 4 2 12 2426 2 4 2 13 2428 2 4 2 14 2430 2 4 2 15 2432 2 4 2 16 2434 2 4 2 17 2436 2 4 2 18 2438 2 4 2 19 2440 2 4...

Page 119: ...ayload_type le_channel_type tx_power tx_mode hopping_type ant_sel inter_pkt_gap pll_mode rf_type rf_chain Continuous mode ble_transmit 71764129 250 1 38 38 2 0 0 1 10 1 0 3 0 0 1 3 For transmitting a BLE 1Mbps Advertising packet with Access Address of 0x71764129 and packet length of 250bytes on 2478MHz with the following parameters Access_Addr 71764129 pkt_length 250 ble_rate 1 rx_channel_index 38...

Page 120: ...s 0 payload_type 0 le_channel_type 1 tx_power 10 tx_mode 0 hopping_type 0 ant_sel 3 inter_pkt_gap 0 pll_mode 0 rf_type 1 rf_chain 3 24 4 BLE BLR Receive 24 4 1 Introduction The receive utility present in the release folder requires configuring the following parameters to start transmitting packets Access Address Data Length indication Scrambler_seed ble_rate Receive channel index Transmit_channel ...

Page 121: ...2 Long Range LR 4 rx_channel_index Receive channel index as per the Bluetooth standard i e 0 to 39 tx_channel_index Transmit channel index as per the Bluetooth standard i e 0 to 39 le_channel_type advertising channel 0 data channel 1 hopping_type no hopping 0 fixed hopping 1 random hopping 2 ant_sel onchip antenna 2 u f l 3 loop_back_mode Disable 0 Enable 1 pwrsave_options Disable 0 Enable 1 pll_m...

Page 122: ... 10 bytes in length Range 00000000000000000001 to 7FFFFFFFFFFFFFFFFFFF Bit number is the channel number used 24 5 4 Appendix Note The above configuration is used only when you have kept the device in transmit burst mode and has made random hopping as enabled For more details in Configuration of device in the transmit burst mode please refer to the section BLE BLR Transmit 111111111111 Examples bt_...

Page 123: ... Link Linux and Android Technical Reference Manual Version 2 0 July 2020 123 channel_bit_map 70000000000000000000 here only upper 4 bits of bit map are set So transmission happens in 76 77 78 channels randomly ...

Page 124: ...nce Manual Version 2 0 July 2020 124 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 ...

Page 125: ...ers should use their controller specific ko mmc_block ko as well as mmc_core ko modules This is a one time process and need not be repeated unless the modules are explicitly removed by the user 26 1 SDIO Stack Options If SDIO is the interface to the Host processor it has to be ensured that the SDIO stack related modules are compiled in the kernel If the SDIO stack modules are not present follow th...

Page 126: ...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 2 Wireless Extension Tools Wireless Extension tools like iwconfig and iwpriv are required for configuring the OneBox Mobile software Make sure that the wireless extensions are enabled in the Linux kernel configuration file User...

Page 127: ...ooth 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 kernel version 2 Execute the make menuconfig command in order to open the Kernel Configuration menu 3 Scroll down to Networking support and hit Enter 4 In the new menu scroll down to the Bluetooth subsystem support optio...

Page 128: ...lect 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 4 Kernel Compilation The steps used for Kernel Compilation are as follows 1 Navigate to the kernel source folder 2 Execute the make command 3 Execute the make modules_install command 4 E...

Page 129: ...id e Linux PC with Serial to USB drivers installed Used to communicate with the i MX6 platform 27 2 2 Software Requirements Toolchain BSP and Ubuntu Linux OS package for i MX6 Kernel version 3 0 35 OneBox Mobile Software Release package 27 2 3 Hardware Setup The steps for Hardware Setup are as follows 1 Connect the i MX6 board to the Linux PC by using the USB to microUSB cable the cable has to be ...

Page 130: ...plained in the Installing the Driver section 27 3 Freescale i MX53 27 3 1 Hardware Requirements IMX53QSB i MX53 Quick Start Board The kit contents are as follows a i MX53 QUICK START Board b microSD Card preloaded with Ubuntu Demonstration Software c USB Cable Standard A to Micro B connectors d 5V 2 0A Power Supply e Quick Start Guide f Documentation DVD g Linux PC with Serial port this will be us...

Page 131: ...procedure Once the bootup and login are completed go to the release folder and follow the procedure explained in the section 4 Installing the Driver 27 4 Atmel AT91SAM9G45 and AT91SAM9M10 The Linux kernel version used on the Atmel AT91SAM9G45 M10 is 2 6 30 This is used to verify only the Wi Fi mode Bluetooth drivers are not compatible with this kernel version 27 4 1 Hardware Requirements SAM9M10 G...

Page 132: ... for the AT91SAM9G45 M10 is as follows assuming the toolchain is present in the toolchain opt atmel folder make ARCH arm CROSS_COMPILE toolchain opt atmel arm 2007q1 bin arm none linux gnueabi The steps need to be followed inorder to copy the pre built binaries or the binaries generated above the Atmel processor platform are as follows Ensure that the Linux PC and the Atmel platform are in the sam...

Page 133: ...evices 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 You will see Bluetooth symbol at the bottom right corner of the screen as shown in the given below figure This will open the Bluetooth Manager as shown in...

Page 134: ...lar 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 ...

Page 135: ...RS9116 n Link Linux and Android Technical Reference Manual Version 2 0 July 2020 135 ...

Page 136: ...o set the rf power mode for WLAN protocol BT_RF_PWR_MODE is used to set the rf power mode for Bluetooth protocol Example WLAN_RF_PWR_MODE 0x00 The above sets high TX and high RX power for WLAN BT_RF_PWR_MODE 0x00 The above sets high TX and high RX power for Bluetooth 29 2 Country selection This parameter is used to set the module in a specific country This is set commonly across all protocols The ...

Page 137: ...ample LED_FUNC_EN 1 The above line enables the LED functionality for Wi Fi activity 29 3 3 BT RF Type This variable is used to select the BT RF TYPE which the module has to operate The following are the possible values 0 EXTERNAL RF 1 INTERNAL RF Example BT_RF_TYPE 1 The above sets bt rf type to Internal RF 29 3 4 BLE_TX_PWR_INX This variable is used to select the BLE_TX _PWR index value The follo...

Page 138: ...RS9116 n Link Linux and Android Technical Reference Manual Version 2 0 July 2020 138 BLR_DUTY_CYCLING BIT 1 BLE_PWR_SAVE_4X_MODE BIT 2 ...

Page 139: ... or else they will be installed in usr local lib and usr local include libnl folders of host machine by default Follow the example given below make DESTDIR arm cortex_a8 linux gnueabihf gcc print path to build directory build Exporting the path for build directory in the command line or add these flags in the supplicant and hostapd config files under CONFIG_DRIVER_NL80211 y variable export LDFLAGS...

Page 140: ... exit Compile the supplicant using make command in the following path cd wpa_supplicant 2 6 wpa_supplicant make clean make After successful compilation the supplicant executable will be found in the same path Copy the supplicant executable to the driver release folder cp wpa_supplicant RS9116 NXX NL XXX LNX XXX source host release 31 1 Bgscan and Roaming To enable Bgscan and Roaming add bgscan sim...

Page 141: ...sing iw command To know more about iw tool refer to the section Configuration Using CFG80211 iw dev devname cqm rssi threshold off hysteresis Set connection quality monitor RSSI threshold Example iw dev wlan0 cqm rssi 45 4 When finished execute the commands given in the chapter Wi Fi ioctl Usage Guide Enable Background Scan and Set Parameters only in Client mode To know more about Background Scan ...

Page 142: ...gnore_broadcast_ssid 0 DTIM Interval To set dtim interval in beacons for onebox mobile AP using hostapd use following variable in hostapd conf file dtim_period 5 SHORT GI To enable Short GI using hostapd following params must be enabled in hostap conf file ht_capab SHORT GI 20 SHORT GI 40 Beacon Interval To set beacon interval for onebox mobile AP using hostapd use following variable in hostapd co...

Page 143: ...d Technical Reference Manual Version 2 0 July 2020 143 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 4 PCB Antenna Part No RSIA7 ...

Page 144: ...June 2018 1 Modified AP set channel frequency command usage in Wi Fi ioctl Usage Guide section 2 Updated PER transmit and receive commands in Wi Fi Performance Test ioctl usage section 3 Updated info note in Monitor Mode section 4 Fixed documentation issues 5 Added information of radius server usage in Enterprise security using CFG80211 section 7 v1 6 October 2018 1 Added Notes in bgscan ioctl sec...

Page 145: ...ximum 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 Added Get Country information ioctl in Wi Fi ioctl Usage Guide section 6 Added operating voltage configuration information to the Installing the Driver section 11 v2 0 August 2019 Added LED ON OFF p...

Page 146: ...ion 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 Redpine is not committed to updating this document in the future Copyright 2020 Redpine Signals Inc All rights ...

Search results

Summary of Contents for RS9116

Reviews:

Related manuals for RS9116

Brands by name

Popular brands

Redpine Signals RS9116, Reference Manual

Search results

Summary of Contents for RS9116

Reviews:

Related manuals for RS9116

Brands by name

Popular brands