background image

 

 

Redpine Signals, Inc. Proprietary and Confidential 

 
 
 

RS9113-n-Link-Module-Driver-

Installation-Guide 

 

 

V

V

e

e

r

r

s

s

i

i

o

o

n

n

 

 

3

3

.

.

0

0

 

 

 

 

October 2014 

 

 

Redpine Signals, Inc

2107 N. First Street, #680 

San Jose, CA 95131. 

Tel: (408) 748-3385 

Fax: (408) 705-2019  

Email: 

[email protected]

  

Website: 

www.redpinesignals.com

  

Summary of Contents for RS9113

Page 1: ...l RS9113 n Link Module Driver Installation Guide V Ve er rs si io on n 3 3 0 0 October 2014 Redpine Signals Inc 2107 N First Street 680 San Jose CA 95131 Tel 408 748 3385 Fax 408 705 2019 Email info redpinesignals com Website www redpinesignals com ...

Page 2: ...nformation 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 Redpine is not committed to updating this docum...

Page 3: ...Installation procedure in WiFi Direct mode 20 6 7 1 Autonomous GO mode 21 7 OneBox Mobile Coexistence Driver in WiFi BT Classic mode 22 7 1 Note The initialization procedure mentioned below will be applicable to both USB and SDIO interfaces Loading SDIO stack modules applicable only if SDIO interface is selected by user 22 7 2 Installation procedure 22 8 Installation and usage of Bluetooth manager...

Page 4: ... rs si io on n 3 3 0 0 5 Building and running the HA sample switch application 32 11 Driver Un installation Procedure 33 12 Driver Information 34 12 1 Driver statistics 34 12 2 Disabling prints in the driver 34 13 Starting DHCP Server Client 35 14 Appendix 36 14 1 Iperf cross compilation 36 14 2 Configuration of kernels from 3 13 to 3 16 to support the Driver 37 15 BT Porting for Android 39 ...

Page 5: ...1 1 Definitions Acronyms and Abbreviations The following terms and definitions are used in the document a WiFi Mode WiFi mode refers to the WLAN Protocol based on IEEE802 11 standard Whenever driver runs in WiFi Mode it supports one of the Access Point Client and WiFi Direct modes b BT Classic Mode BT Classic mode refers to the Core Bluetooth BR EDR Protocol defined by the trade organization Bluet...

Page 6: ...he following link below for more information on the Ricoh cards http www hwtools net cardreader SDCBA_C01 html 2 2 Software Requirements Linux 2 6 35 and above kernel version with open source SDIO stack patch applied DHCP server Iperf Bluetooth Manager Application Compatible Bluetooth Host stack Bluez stack For higher kernel versions i e 3 13 and above refer to the section Configuration of kernels...

Page 7: ...re provided then follow the below procedure mkdir p home rsi cp Binary_files release tgz home rsi cd home rsi tar xzvf release tgz Final driver binaries ko can be found in the home rsi release If source is provided then follow the below procedure cd Source Untar the driver source using the following command tar xzvf host tgz cd host Follow the compilation procedure mentioned in Compilation Procedu...

Page 8: ...om TA Enable Disable Aggregation Support Enable Disable Debugging Support Enable Disable Chip Enabled Enable Disable AutoRate Support Enable Disable EEPROM Read Enable Disable RSI_SDIO MultiBlock Support Enable Disable Security Support Enable Disable Peer to Peer Support Enable Disable AMPDU Age The Menuconfig utility will start automatically when user issues a make command in the driver source No...

Page 9: ...on options and the target platform on which the binaries has to be built For example if the target platform is ARM and tool chain path is opt freescale usr local gcc 4 4 4 glibc 2 11 1 multilib 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 0 arm fsl linux gnueabi bin arm none ...

Page 10: ...10 R RS S9 91 11 13 3 n n L Li in nk k M Mo od du ul le e D Dr ri iv ve er r I In ns st ta al ll la at ti io on n G Gu ui id de e V Ve er rs si io on n 3 3 0 0 Figure 2 Selecting the interface type to test the driver Figure 3 Save the changes before exiting ...

Page 11: ...reference of Jumper and DIP switch settings refer to the below pictures for SDIO and USB interfaces Run sh mbr_flash sh script present in the home rsi release Wait for the debug message FIRMWARE UPGRADED TO FLASH SUCCESSFULLY in dmesg logs Remove the driver modules by executing sh remove_all sh script Make sure that the driver modules are removed by issuing lsmod Poweroff the EVB and change the DI...

Page 12: ...and Confidential Page 12 R RS S9 91 11 13 3 n n L Li in nk k M Mo od du ul le e D Dr ri iv ve er r I In ns st ta al ll la at ti io on n G Gu ui id de e V Ve er rs si io on n 3 3 0 0 SDIO DIP switch settings before flashing Boot loader ...

Page 13: ...oftware Boot Loader Upgradation To upgrade an existing software bootloader present on the card follow the procedure mentioned below Ensure that proper RS9113_WC_BL rps file is present in the home rsi release firmware folder before running the script Run sbl_upgrade sh script present in home rsi release folder sh sbl_upgrade sh On successful upgradation you can see the print SWBL FLASHING THROUGH S...

Page 14: ...ease firmware folder of the driver package doesn t match software bootloader upgrades the image automatically 6 1 Loading SDIO stack modules applicable only if SDIO interface is selected by user In case if user needs to use the Onebox Mobile driver with SDIO interface make sure the SDIO stack related modules are already inserted in the kernel To check this use the following command lsmod Make sure...

Page 15: ...x X key_mgmt NONE Note In case of wep64 the key representation can be specified in ASCII Hex For example Hex format wep_key0 1234567890 Ascii format wep_key0 12345 To configure the station in WEP 128 mode enable the below configuration settings in the sta_settings conf file network ssid SSID of the AP to connect with wep_key0 XXXXXXXXXXXXXXXXXXXXXXXXXX wep_tx_keyidx X key_mgmt NONE Note In case of...

Page 16: ... format wep_key0 12345678901234567890123456 Ascii format wep_key0 1234567890123 Key index can vary from 0 to 3 To configure the station in TKIP mode enable the below configuration settings in the sta_settings conf file network ssid SSID of the AP to connect with key_mgmt WPA PSK psk Passphrase specified at AP side proto WPA pairwise TKIP group TKIP To configure the station in CCMP mode enable the ...

Page 17: ...s of the device If it is in connected state then the connected Access point SSID along with the mac address is displayed If it is not connected to an Access point a message Not Associated appears in the output of iwconfig 6 4 Deep sleep If we enable deep sleep the hardware components RF BBP and LMAC will be turned off and the TA will be switched to host clock After the completion of device initial...

Page 18: ... following configuration file settings The configuration files for different security modes as well as open mode can be found in the release folder 3 Use the start_ap sh script in the home rsi release folder with the required configuration file as input to start_ap sh to start driver in Access Point mode cd home rsi sh start_ap sh conf_file conf_file Depending on the security mode user can input t...

Page 19: ...of the AP onebox_wep 2 Frequency 2 4 GHz 2412 3 Security mode WEP 128 4 WEP key is 12345678901234567890123456 5 Key index is 0 d To start the Access point in TKIP WPA PSK security mode use the following command sh start_ap sh wpa_supplicant_tkip conf The Access point is configured with the following settings 1 SSID of the AP onebox_tkip 2 Frequency 2 4 GHz 2412 3 Security mode TKIP 4 Pass phrase 1...

Page 20: ... It displays the Access point SSID along with the mac address and frequency If Access point doesn t start properly message saying Exiting Driver Initialization not completed even after waiting for xxms is displayed 6 7 Installation procedure in WiFi Direct mode In case if SDIO interface is used make sure sdio stack modules are loaded refer Loading sdio stack modules above before starting the WiFi ...

Page 21: ...the list of p2p devices which are in the range appear To connect to P2P device run the following command 3 wpa_cli i wifi0 p2p_connect bssid_device pbc go_intent intent_value 6 7 1 Autonomous GO mode To create the p2p device in autonomous GO mode use the below commands wpa_cli i wifi0 p2p_group_add freq enter the frequency in which the autonomous GO should start wpa_cli i wifi0 p2p_group_add 2462 ...

Page 22: ...user Please refer to the section Loading SDIO stack modules 7 2 Installation procedure 1 Ensure that proper RS9113_WLAN_BT_CLASSIC rps file is placed in home rsi release firmware folder 2 To start WiFi Client mode please refer to the section Installation procedure in Client mode 3 Run bt_insert sh to start Bluetooth Classic mode This script inserts Bluetooth modules and common HAL modules if alrea...

Page 23: ...n ns st ta al ll la at ti io on n G Gu ui id de e V Ve er rs si io on n 3 3 0 0 After the device is up we can pair with other devices or from other devices using Bluetooth Manager application Files can also be sent and received using Bluetooth Manager Instead of Bluetooth Manager the device can be configured using hcitool or hciconfig ...

Page 24: ...t ta al ll la at ti io on n G Gu ui id de e V Ve er rs si io on n 3 3 0 0 8 Installation and usage of Bluetooth manager The required RPM can be downloaded and installed from the link ftp rpmfind net linux fedora linux updates 17 i386 blueman 1 23 5 fc17 i686 rpm Here are few images of Bluetooth Manager Figure 4 Bluetooth Manager basic window ...

Page 25: ...Page 25 R RS S9 91 11 13 3 n n L Li in nk k M Mo od du ul le e D Dr ri iv ve er r I In ns st ta al ll la at ti io on n G Gu ui id de e V Ve er rs si io on n 3 3 0 0 Figure 5 Select the appropriate bluetooth interface Figure 6 Click on Search to inquire ...

Page 26: ... od du ul le e D Dr ri iv ve er r I In ns st ta al ll la at ti io on n G Gu ui id de e V Ve er rs si io on n 3 3 0 0 Figure 7 Select particular device right click and select Pair to pair with that device Figure 8 Select particular device right click and select Send a file to send file to that device ...

Page 27: ...s applicable only if SDIO interface is selected by user Please refer to the section Loading SDIO stack modules 9 2 Installation procedure 1 Ensure that proper RS9113_WLAN_BT_LE rps file is placed in home rsi release firmware folder 2 To start WiFi Client mode please refer to the section Installation procedure in Client mode 3 Run bt_insert sh to start Bluetooth LE mode This script inserts Bluetoot...

Page 28: ... state Our device will act as a peripheral Ex hciconfig a hci0 leadv hciconfig a hciX noleadv It disables the advertising state 9 4 Scanning Mode hcitool i hciX lescan It will initiate scanning mode It displays Scan responses and Advertising information Ex hcitool i hci0 lescan Press Ctrl C to disable scanning 9 5 Master Mode Connected State To connect with other device 1 3rd party device should b...

Page 29: ...Page 29 R RS S9 91 11 13 3 n n L Li in nk k M Mo od du ul le e D Dr ri iv ve er r I In ns st ta al ll la at ti io on n G Gu ui id de e V Ve er rs si io on n 3 3 0 0 hcitool i hciX lecc REDPINE DEVICE BD Address ex hcitool i hci1 lecc 00 23 11 22 33 44 ...

Page 30: ... the firmware burned in flash and the latest firmware present in the release firmware folder doesn t match software bootloader upgrades the image automatically 5 To check if the device has started in Zigbee mode use the following command ifconfig a If the driver is loaded properly the above command displays a network adapter with name zigb0 10 2 Building and running the sample HA switch applicatio...

Page 31: ...ne h file for the defined states and the events The important sates in the state machine are 1 STATE_STACK_NOT_READY Stack is not initializez 2 STATE_NO_NETWORK Stack is initialized and the not joined any network or formed network 3 STATE_SCAN_ACTIVE_COMPLETE Active scan is compete and ready to join the network 4 STATE_NETWORK_JOINED Joined the network 4 Stack callbacks The application callbacks t...

Page 32: ...uld not call any of the API call that sends command data to the device from any of these callbacks 5 Building and running the HA sample switch application 1 Goto the folder host zigbee utils build 2 Clean the existing builds by giving the following command 3 make clean 4 To build Home automation switch app use the following command 5 make switch 6 Check for the binary switch after building complet...

Page 33: ... individual protocols as mentioned below a User can use wlan_remove sh script present in host release folder to remove WLAN modules alone without removing Common HAL and Zigbee modules b User can use zigb_remove sh script present in host release folder to remove Zigbee modules alone without removing Common HAL and WLAN modules 2 In case if the driver is operating in Coexistence mode i e WLAN BT mo...

Page 34: ...ommand cat proc onebox mobile stats This command prints the statistics related to total management packets total data packets with respect to a given access category sent to from the driver Buffer full status as well as semi buffer full status FSM states etc 12 2 Disabling prints in the driver User can disable the driver debug prints appearing on the console using the following command To use this...

Page 35: ...HCP client in station mode use the following command at the command line dhclient wifi0 The DHCP server assigns the IP address to the client interface in the same network it is operating in In case of AP mode to run DHCP server use the following command on an x86 machine Go to home rsi release cd home rsi release sh dhcp_server sh interface name Eg sh dhcp_server sh wifi0 In case of IMX53 platform...

Page 36: ...path 4 configure host arm linux prefix HOME install CC platfrom tool chain path gcc Example The below command is used to compile the iperf source with freescale tool chain configure host arm linux prefix work iperf 2 0 1 CC opt freescale usr local gcc 4 4 4 glibc 2 11 1 multilib 1 0 arm fsl linux gnueabi bin arm none linux gnueabi gcc Here the target platform is arm linux so host arm linux CC repr...

Page 37: ...o modularize the following in the MMC SD SDIO card support sub menu MMC block device driver Secure Digital Host Controller Interface Support SDHCI support on PCI bus o Press Exit button until you get back to the main menu Exit from there too and save the kernel configuration Selection of Wireless Extension Tools The wireless extension tools are required in the driver To check whether the required ...

Page 38: ... sub menu RFCOMM Protocol support feature and press enter to enable the RFCOMM TTY support feature BNEP Protocol support feature and press enter to enable both the Multicast filter support and Broadcast filter support features CMTP Protocol support feature HIDP Protocol support feature o Press Exit button until you get back to the main menu Exit from there too and save the kernel configuration Com...

Page 39: ...ease onebox_bt_nongpl ko Note Here DRIVERPATH should be filled with Redpine s Driver path define DRIVER_MODULE_BT_ONEBOX_NONGPL_REM onebox_bt_nongpl define DRIVER_MODULE_BT_ONEBOX_GPL_REM onebox_bt_gpl extern int init_module void unsigned long const char extern int delete_module const char unsigned int Add following functions static int insmod const char filename const char args void module unsign...

Page 40: ...le LOGV __FUNCTION__ int ret 1 int hci_sock 1 int attempt if rmmod DRIVER_MODULE_BT_ONEBOX_GPL_REM 0 usleep 500000 if rmmod DRIVER_MODULE_BT_ONEBOX_NONGPL_REM 0 usleep 500000 Inserting the driver insmod DRIVER_MODULE_BT_ONEBOX_NONGPL insmod DRIVER_MODULE_BT_ONEBOX_GPL if set_bluetooth_power 1 0 goto out LOGI Starting hciattach daemon if property_set ctl start hciattach 0 LOGE Failed to start hciat...

Page 41: ...hd 0 LOGE Failed to start bluetoothd goto out sleep HCID_START_DELAY_SEC ret 0 out if hci_sock 0 close hci_sock return ret In bt_disable comment the hciattach and instead remove Redpine s driver via rmmod int bt_disable LOGV __FUNCTION__ int ret 1 int hci_sock 1 LOGI Stopping bluetoothd deamon if property_set ctl stop bluetoothd 0 LOGE Error stopping bluetoothd goto out usleep HCID_STOP_DELAY_USEC...

Page 42: ...io on n 3 3 0 0 goto out ret 0 Removing driver if rmmod DRIVER_MODULE_BT_ONEBOX_GPL_REM 0 usleep 500000 if rmmod DRIVER_MODULE_BT_ONEBOX_NONGPL_REM 0 usleep 500000 out if hci_sock 0 close hci_sock return ret Before enabling BT First insert common_driver ko s then enable Bluetooth We have to specify the final modules ko s path Driverpath release in src system bluetooth bluedroid bluetooth c properl...

Reviews: