RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 January 2019 Redpine Signals, Inc. 2107 North First Street, #540 San Jose, CA 95131. Tel: (408) 748-3385 Fax: (408) 705-2019 Email: sales@redpinesignals.com Website: www.redpinesignals.com Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 About this Document This document is a preliminary version of RS9116 n-Link Technical Reference Manual for Linux and Android, provided to customers under a Non-Disclosure Agreement (NDA). src-23903865_BluetoothhcitoolandhciconfigUsage-_Toc174878560 Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Table Of Contents 1 2 Introduction to RS9116 ........................................................................................................... 11 Getting Started with RS9116 ................................................................................................... 12 2.1 2.2 2.3 3 4 Hardware Requirements ..............................................................................................................
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 7.2 Configuration of AP and RADIUS server to use EAP methods ......................................................... 63 7.2.1 7.2.2 7.2.3 8 Configuration of the AP ................................................................................................................................... 64 Configuring hostapd as RADIUS server ..................................................................................................
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 16.2.1 17 Labeling and User Information ........................................................................................................................ 89 Wi-Fi Performance Test ioctl usage ...................................................................................... 90 17.1 WiFi Transmit Tests .................................................................................................................. 90 17.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 23.4.4 23.5 23.5.1 23.5.2 23.5.3 23.5.4 23.6 Introduction .................................................................................................................................................. 114 IOCTL ............................................................................................................................................................. 114 Description .................................................
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 29.3.2 29.3.3 29.3.4 30 31 Appendix E: Installation of Missing Generic Netlink Libraries ............................................. 138 Appendix F: Procedure to use latest supplicant with NL80211 interface ............................. 139 31.1 Bgscan and Roaming ................................................................................................................139 31.1.1 31.1.2 32 32.1 32.2 33 BT RF Type .........
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Table of Figures No table of figures entries found. Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Table of Tables No table of figures entries found. Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 Classic • Bluetooth Low Energy • ZigBee (Coordinator, Router and End device modes). The OneBox-Mobile Coexistence software supports the following combination of modes.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 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. • Operating system: Linux or Android • Nl80211 support • Hostapd Support • WIFI • BLUETOOTH • ZIGBEE 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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. Figure 3: Selection of NL80211 and Hostapd Support Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 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.z/source/host vim Makefile The DEF_KERNEL_DIR variable has to be assigned along with the compiled kernel path.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 For example, if the target platform is ARM and tool chain path is "/opt/freescale/usr/local/gcc-4.4.4-glibc-2.11.1multilib-1.0/arm-fsl-linux-gnueabi/bin/arm-none-linux-gnueabi-", then the command is issued as: make ARCH=arm CROSS_COMPILE=/opt/freescale/usr/local/gcc-4.4.4-glibc-2.11.1-multilib-1.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 • onebox_zb_gpl.ko • onebox_zb_nongpl.ko • wlan.ko • wlan_wep.ko • wlan_ccmp.ko • wlan_tkip.ko • wlan_acl.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 • If user selects only ZigBee in Menuconfig during the compilation of Driver, use the command below: sh zigb_enable.sh • If user selects both Wi-Fi and Bluetooth in Menuconfig during the compilation of Driver, use the command below : sh wlan_bt_insert.sh • If user selects both Wi-Fi and ZigBee in Menuconfig during the compilation of Driver, use the command below : sh wlan_zigb_insert.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 wep_key0=XXXXXXXXXXXXXXXXXXXXXXXXXX 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 User needs to make sure of the module detection w.r.t interface being used. If the module is not detected, user will end up with errors displayed on the console ! After issuing the above command, a virtual interface with the name "wifi0" will be created.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 DHCPREQUEST on wifi0 to 255.255.255.255 port 67 (xid=0x133cec16) DHCPOFFER from 192.168.43.1 DHCPACK from 192.168.43.1 (xid=0x133cec16) bound to 192.168.43.167 -- renewal in 1783 seconds 4.4.2 Installation in Access Point Mode (with BSD interface support) The steps for installing OneBox-Mobile software in Access Point Mode are as follows: 1. The "start_ap.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 All the above mentioned parameters can be modified in the respective configuration files by the user. The values provided in the above mentioned parameters are only for reference. The Access Point does not support WEP-Shared algorithm in the current release. 2. After running the "start_ap.sh" script a virtual interface with the name "wifi1" will be created.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 • DRIVER_MODE = 1 • COEX_MODE = 1 (For Station Mode only/WIFI-Direct) or • 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 . Ensure that in menuconfig, NL80211 support is enabled as mentioned in Figure 4. 3. Compile the driver.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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. Assuming the physical interface is detected as phy1, refer the below steps to create a virtual interface. 6. Add the wireless interface to the phy.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 • COEX_MODE = 3 (For Both Access Point and Station Modes) 3. Ensure that in menuconfig, NL80211 and HOSTAPD support is enabled. 4. Compile the driver. Make sure the following parameters are enabled in the hostapd configuration file (wlan/hostapd2.4/hostapd/.config) CONFIG_LIBNL32=y $ make Compilation of NL80211 requires libnl library files.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Make sure in hostapd_open.conf file, the AP netdevice name is set to wifi0 or wifi1 according to the interface obtained by following the above steps. For eg: • Interface = wifi0 Note: Refer section Appendix G: Considerations need to be made during hostapd usage for description of other configurable parameters of hostapd.conf file(s). 7. Run hostapd with following command $ ./hostapd hostapd_open.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 4.4.6 Installation in Wi-Fi Direct Mode (With NL80211 Support only for Kernel v3.8 or higher) The steps for installing OneBox-Mobile software in Wi-Fi Direct Mode are as follows: The "start_p2p_nl80211.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_nl80211.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 • P2P Devices can scan this Group Owner and can connect directly. Run following command to start receiving connect calls from P2P devices #. /wpa_cli –i wifi0 - > wps_pbc You will start getting ENROLEE detect 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 4.6 OneBox-Mobile in Wi-Fi + Bluetooth LE Coexistence Mode This section describes the installation of Wi-Fi and Bluetooth LE (BLE) modes. Please note that in case of using Coexistence mode, each protocol should be loaded individually one after the other. • Open the common_insert.sh file present in "release" folder.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 # hcitool -i lescan The above command displays the scan responses and advertising information. • Master Mode Connected State Ensure that the remote device is in Advertise mode and then issue the command given below: # 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 4. After the device is up, we can Advertise, Inquiry, Scan and Connect with other BT Classic and BLE devices. The device can be configured using hcitool or hciconfig applications. 5. After the device is up, we can pair it with the other devices or from other devices using the Bluetooth Manager application. The files can also be sent and received using Bluetooth Manager.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 4.8.1.1 About the Sample Application This is the ZigBee Home Automation-defined switch application using Host APIs. This application connects to the light parent and tries to match the simple descriptors by using Match Descriptor command. After exchanging the simple descriptors, it will send the toggle command to the light continuously. 4.8.1.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 <$id> Indicates Id of Wi-Fi device.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Set Channel/Frequency (only in Monitor mode) Required Usage # iwconfig txpower 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 maximum values the radio can support. So it is not guaranteed that the user defined value gets effected when these settings is done.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Set Short GI # iwpriv wifi0 get_short_gi Get Privacy Description 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Set Short GI Description This command is used to enable or disable 20/40 MHz Bandwidths in the n-Link® Module. Default Value - 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 Set DTIM Period Default Value 1 Input Parameters VAP Name (string like wifi0, wifi1, etc.) Integer value between 1 and 15 Output Parameter None Reset Required Yes. In order to set the DTIM period, the virtual interface has to be reset. Usage 1. 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Set DTIM Period Output Parameter None Reset Required No Usage # iwpriv maccmd Example The command given below enables the ACL Policy and allows traffic: # iwpriv wifi0 maccmd 1 The command given below enables the ACL Policy and denies traffic: # iwpriv wifi0 maccmd 2 Add MAC Address for Access Policy Description This command is used to add a MAC address for the Access Policy in the n-Link® Module.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Set DTIM Period Usage # iwpriv hide_ssid Example 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 Set DTIM Period nearest multiple of 15. # iwpriv wifi0 keep_alive 35 Table 3: iwpriv Usage for Access Point Mode 5.4 Private (Driver- Specific) Commands for Client Mode The table below lists the usage of the "iwpriv" command for setting and getting parameters common for the Client Mode. De authenticate while Roaming Description This command is used to de authenticate the n-Link® Module from "old" Access Point while roaming.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs Input Parameters Base Interface (string like rpine0) VAP Name (string like wifi0, wifi1, etc.) Operating Mode (string): ap – Access Point Mode sta – Station/Client Mode p2p – P2P Mode mon – Monitor Mode Refer to the section Monitor Mode for more details. Beacon Filtering after connecting to an Access Point (only for Client mode).
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs Reset Required No Usage # ./onebox_util print_vap_stats [-v] [-f filename] Example The command given below prints the statistics of the transmitted and received packets of the interface wifi0 into the file “stats”. # .
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs and will select RF_OUT_1 pin in the case of the module without 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs Example The command given below triggers background scan without waiting for periodicity timeout. # ./onebox_util rpine0 do_bgscan Note: The do_bgscan command has to be followed by set_bgscan_params command.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs Example The command below enables ULP Power Save Mode for a duration of 100 ms and with a listen_interval_duration of 100ms. # .
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs 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 50 and 1000 (other values will result in default value being assigned).
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs 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 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs 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 set_country Example The commands below reset the VAP and set the country to Singapore in Station mode. # sh remove_all.sh # sh wlan_enable.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs Default Value ant_path: 1 ant_type: 1 For ant_path • If value is 1, then it is considered as RF_OUT_2/Integrated Antenna • If value is 2, then it is considered as RF_OUT_1/U.FL Connector. For ant_type • If value is 1, then it is considered as Type 1 antenna. • If value is 2, then it is considered as Type 2 antenna. If value is 3, then it is considered as Type 3 antenna.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs Input Parameters The integer value mapping has been shown below: 0 – High power mode 1 – Medium power mode 2 – Low power mode Output Parameters None Reset Required No Usage # ./onebox_util set_rf_tx_rx_pwr_mode tx_value rx_value Example .
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Create a VAP The OneBox-Mobile software allows creation of 4 VAPs iwconfig command. Default Value - Input Parameters - Output Parameter None Reset Required No Usage # ./onebox_util get_txpwr Example ./onebox_util rpine0 get_txpwr Useonly rates Description This command is used set the supported rates in AP mode. This will be helpfull to control the transmit data rates of the clients connected.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 The sections below list down the steps for configuring WPS and setting up a connection in Access Point and Client modes using the methods listed above. 5.5.1.1 Access Point Mode The steps for configuring WPS in Access Point Mode are as follows: 1. Start the driver in Access Point mode. 2. Start the supplicant by entering the following command. #. /wpa_supplicant –i -D bsd –c -ddddt 3.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 5.5.1.2 Client Mode The steps for configuring WPS 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 -D bsd –c -ddddt 3. For Push Button method: • Push the button on the Access Point • Enter the command below for the n-Link® STA # .
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 Creating a virtual Interface $ 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'.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Creating a virtual Interface 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 iw dev $interface_name set power_save Example 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 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 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.pem #dh_file = ${certdir}/dh dh_file = /etc/certs/dh } To start the Radius server, run the flowing command in the terminal: $ radiusd -X 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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.sh script present in the “release” folder as per the instructions mentioned in Section 4.1.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Run the following command to start the device in the AP mode: $. /hostapd hostapd_eap.conf -ddddt $ sh dhcp_server.sh 7.2.2 >log & wifi1 , where wifi1 is the interface name 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 7.2.3 Configuring Station to connect to an EAP enabled AP. Go to Driver Folder and copy the certs folder to /etc/ in your system, as it contains all the certificates required. $ cp -rvf certs /etc/ Go to the driver folder and compile it, ensuring that the below options are enabled in wpa_supplicant.conf file. $ vim wlan/supplicant/linux/wpa_supplicant/.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 $ ./wpa_supplicant -i wifi0 -D nl802ll -c sta_settings.conf -ddddt > log & To connect using EAP-PEAP method, sta_settings.conf should be described as below: network={ ssid="Redpine_Signals" key_mgmt=WPA-EAP eap=PEAP anonymous_identity="peapuser" identity="test" password="password" } To connect using EAP-TTLS method, sta_settings.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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="auth=mschapv2" ca_cert="/etc/certs/wifiuser.pem" private_key_passwd="wifi" } EAP-LEAP has been used when Freeradius is the RADIUS Server. This has been verified with only Cisco AP. To connect using EAP-LEAP method, sta_settings.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 # 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 8.3.1 WPS AP-mode for WPS -push button 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 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.sh script present in the “release” folder as per the instructions mentioned in section 4.1 $ iw phy ; it will give phyXX number $ iw phy phyXX interface add wifi1 type __ap $ ./hostapd hostapd_ccmp.conf -ddddddt>log & $ sh dhcp_server.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 8.3.6 Set the AP pin $ hostapd_cli wps_ap_pin set [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 displays the current configuration of the AP mode Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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. Hostapd Conf File changes required for ACS: Set the correct interface and driver in hostapd.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 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.sh Create the virtual interface in monitor mode.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 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 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 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 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. In case AP is running and the STA is started, then the user has to give the host_scan command for the STA to move to this state. 3. AUTH: This is an intermediate state during connection.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 • • • • 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. However AP and client can operate in different security modes. If station disconnects then the AP mode would also not be operational [i.e the AP stops beaconing and disconnects all of the connected stations.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 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 • • d. Periodic UAPSD: This mode is enabled by the set_uapsd_params command only if the parameter is assigned with a non-zero value. For this mode, the wakeup period can be assigned with a value ranging between 10 and 100 milliseconds.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 • • • other sleep duration parameters that follow (, , ). The maximum duration for which the device supports sleep is 4095 times the duration of the beacon interval considering the listen interval parameters of the access point.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 USB mode. # echo 15 > /sys/bus/usb/devices/2-1/power/autosuspend_delay_ms Recommended delay is 15msec. Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 16 Compliance and Certification M7DB6 module is FCC/IC/CE certified. This section outlines the regulatory information for the M7DB6 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 16.2.1 Labeling and User Information Innovation, Science and Economic Development Canada ICES-003 Compliance Label: CAN ICES-3 (B)/NMB-3(B) The M7DB6 module has been labeled with its own IC ID number (8407A-M7DB6) and if the IC ID is not visible when the module is installed inside another device, then the outside of the finished product into which the module is installed must also display a label referring to the enclosed module.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 mcs1, mcs2, mcs3, mcs4, mcs5, mcs6 and mcs7. : Transmit packet length in bytes. Enter a value between 24 and 1536 when aggregation is not enabled and between 24 and 30000 when aggregation is enabled. : Transmit mode. Enter 0 for Burst mode and 1 for Continuous mode. : Transmit channel number On-air testing in DFS, the channels should be avoided till the module is certified for DFS. Cabled tests can be run in these channels..
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 transmitted packets. The table below explains the flags that can be enabled and disabled. Multiple flags can be set at a time.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.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 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. • Total number of packets received with incorrect CRC. • Total number of False CCA's received. .
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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: #. /onebox_util rpine0 cw_mode 6 2 2 The command used for starting transmission in 184(11J ) channel is outlined below: #.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 Configuring Using onebox_util for details on VAP creation.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 • Trigger wakeup 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 18.3 Suspend system Use below command to suspend the system. #systemctl suspend This step will suspend the system and system goes to power save mode. 18.4 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.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 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. It also provides provision for encryption with AES engine for two modes (ECB, CBC).
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 ./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 Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 21 Steps to connect 802.11R client to AP 1. 2. Use the following configuration in sta_settings.conf file to connect to 802.11R AP. network={ssid=""key_mgmt=FT-PSKpsk=proto=WPA2pairwise=CCMPgroup=CCMP} 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 22 Steps to configure 802.11W 22.1 Configuring and Compiling Driver for PMF in client mode: 1. 2. Enable CONFIG_11W in Driver Makefile Enable CONFIG_IEEE80211W=y in wpa_supplicant .config 3. Enable WPA-PSK-SHA256 as key_mgmt in network block in supplicant sta_settings.conf a. pmf=1/2, PMF is enabled/required correspondingly .
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 23 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 Reset Output Parameter None. Reset Required No. Usage hcitool -i cmd 0x01 0x01 Write Local Name Description This command is used to Set the local device name Default Value Input Parameters Name of the device. Output Parameter None. Reset Required No. Usage hcitool -i cmd 0x03 0x13 Table 12: Bluetooth hcitool and hciconfig usage 23.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Ensure that only Bluetooth is selected in menuconfig. Run the onebox_insert.sh script present in the "release" folder to install the Driver in Performance Test mode. Next, follow the instructions below to run the Transmit and Receive tests. 23.3 BT CLASSIC Transmit The "transmit" utility, present in the "release" folder requires configuring the following parameters to start transmitting packets.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 scrambler_seed: Initial seed to be used for whitening. It should be set to ‘0’ in order to disable whitening.In order to enable it he should give the scrambler seed value, which is used on the receive side. no_of_packets: Number of packets to be transmitted. presently this option not valid. payload_type: Type of payload to be transmitted.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Bad(GHz) Bandwidth(MHz) Channel Number Centre Freq(MHz) 2.4 1 22 2424 2.4 1 23 2425 2.4 1 24 2426 2.4 1 25 2427 2.4 1 26 2428 2.4 1 27 2429 2.4 1 28 2430 2.4 1 29 2431 2.4 1 30 2432 2.4 1 31 2433 2.4 1 32 2434 2.4 1 33 2435 2.4 1 34 2436 2.4 1 35 2437 2.4 1 36 2438 2.4 1 37 2439 2.4 1 38 2440 2.4 1 39 2441 2.4 1 40 2442 2.4 1 41 2443 2.4 1 42 2444 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Bad(GHz) Bandwidth(MHz) Channel Number Centre Freq(MHz) 2.4 1 62 2464 2.4 1 63 2465 2.4 1 64 2466 2.4 1 65 2467 2.4 1 66 2468 2.4 1 67 2469 2.4 1 68 2470 2.4 1 69 2471 2.4 1 70 2472 2.4 1 71 2473 2.4 1 72 2474 2.4 1 73 2475 2.4 1 74 2476 2.4 1 75 2477 2.4 1 76 2478 2.4 1 77 2479 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Packet Type br edr mode Packet length Link Type 2-EV3 6 2 1-60 2 2-EV5 12 2 1-360 * 2 3-EV3 7 3 1-90 2 3-EV5 13 3 1-540 * 2 '*' In eSCO (link type = 3), we have capability of maximum 90 bytes (Packet Length) only.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 ./bt_br_edr_receive After the receive starts, the following command can be given to stop the reception. . /bt_br_edr_receive 0 1. Stop the Reception first before starting of Receiving. 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 IOCTL Command: ./bt_br_edr_receive 111111111111 1 15 339 0 1 10 10 0 3 0 0 1 2 23.5 BLE/BLR Transmit 23.5.1 Introduction The "transmit" utility, present in the "release" folder requires configuring the following parameters to start transmitting packets. • Access address • packet length • ble rate • Receive channel index • Transmit_channel index • Scrambler seed • no.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 ‘2’ – Payload consists of all 0x55’s ‘3’ – Payload consists of all 0xF0’s ‘4’ – Payload consists of PN9 sequence. le_channel_type : advertising channel - 0 data channel - 1 tx_power : Transmit power value should be between 0 and 18 tx_mode : Burst mode - 0 Continuous mode - 1 hopping_type: no hopping -0 fixed hopping - 1 random hopping - 2 ant_sel : onchip antenna - 2 u.f.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Band(GHz) Bandwidth (MHz) Channel Centre Freq (MHz) 2.4 2 25 2452 2.4 2 26 2454 2.4 2 27 2456 2.4 2 28 2458 2.4 2 29 2460 2.4 2 30 2462 2.4 2 31 2464 2.4 2 32 2466 2.4 2 33 2468 2.4 2 34 2470 2.4 2 35 2472 2.4 2 36 2474 2.4 2 37 2476 2.4 2 38 2478 2.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 • • • • • • • • • • • ble_rate Receive channel index Transmit_channel index LE Channel type hopping type Antenna selection Loop_back_mode enable/disable pwrsave_options pll_mode rf_type rf_chain 23.6.2 IOCTL The following command can be given to start the reception .
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 For receiving a BLE-1Mbps Advertising packet with Access Address of 0x71764129 and packet length of 250bytes on 2478MHz with the following parameters scrambler_seed : 0 hopping_type: disable ant_sel : u.f.l loop_back_mode : Disabled 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 23.7 Hopping 23.7.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Classic_le_mode – 1 channel_bit_map –70000000000000000000 (here only upper 4 bits of bit map are set. So, transmission happens in 76,77 & 78 channels randomly) Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 24 ZigBee Performance Test Application Usage The steps for showing the usage of ZigBee Performance Test Application are as follows: Open the common_insert.sh file present in the “release” folder. Ensure that the DRIVER_MODE and COEX_MODE are set as below: DRIVER_MODE = 2 COEX_MODE = 16 (for ZigBee) Run the following command in order to install the Driver in Performance Test mode: # sh zigb_enable.sh or wlan_zigb_insert.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 /zb_transmit 0 The “zb_util” utility present in the “release” folder allows the configuration of the channel and also does the collection of the received statistics in that particular channel. Command Usage The “zb_util” command usage is explained below. It has to be issued twice – first to set the channel and then to start/stop the collection of statistics. The statistics are reported once in every second. .
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 0 – Start(starts the transmission) Antennal Select – 2(RF_OUT_1/U.FL) Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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. Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 5. In the new menu, press 'M' to modularize the following options: o o o 6. 7. MMC block device driver Secure Digital Host Controller Interface support SDHCI support on PCI bus Hit the Tab key to select Exit and hit Enter. Repeat this till you are asked whether you want to save the configuration. 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 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 • 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. Repeat this till you are asked whether you want to save the configuration. 7. Select "Yes" and hit Enter.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 DEF_KERNEL_DIR:= /lib/modules/linux-3.0.35_SOLOLITE_hw The "make" command for the i.MX6 is as follows, assuming the toolchain is present in the "/toolchain/opt/freescale" folder: make ARCH=arm CROSS_COMPILE=/toolchain/opt/freescale/FWIOCUA0R1M1P1/TOOLS/cross/bin/arm-mv5sftlinux-gnueabi- Next, plugin the SD/MMC card to the PC and copy the pre-built binaries or the binaries generated above to the SD/MMC card.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 27.3.4 Cross Compile and Copy OneBox-Mobile Software If the OneBox-Mobile software's source is available, follow the steps mentioned in the section Compiling the Driver in order to cross compile the OneBox-Mobile software for i.MX53. 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-2.6.35.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 27.4.4 Cross Compile and Copy OneBox-Mobile Software If the OneBox-Mobile software's source is available, follow the steps mentioned in the section Compiling the Driver in order to cross compile the OneBox-Mobile software for the Atmel processor. 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-2.6.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 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. Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 Redpine Signals, Inc.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 Example: ANT_SEL_VALUE=2 The above line selects the internal antenna. The Operation starts on this antenna. If antenna diversity selection feature is also enabled, initial operation will start on the antenna selected. Antenna diversity operation will continue as expected. This radio transmitter 8407A-M7DB6 has been approved by Industry Canada to operate with the antenna types listed below with the maximum permissible gain indicated.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 29.3.2 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.3 BLE_TX_PWR_INX This variable is used to select the BLE_TX _PWR index value.The following are the possible values.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 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 .config Make sure the following parameters are enabled in the supplicant configuration file (.
RS9116 n-Link Linux and Android Technical Reference Manual Version 2.0 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 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 33 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 Formatted the document as per Redpine document standard 3 v1.2 March 2018 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. 2. 3. 4. 5. 6.