Caterpillar USB Wireless Adapter User Guide Version 1.
REVISION HISTORY Paper copies are valid only on the day they are printed. Contact the author if you are in any doubt about the accuracy of this document. Version Date Notes Author(s) V1.0 V1.1 12 Dec 2018 21 Feb 2019 Initial Release Added clarifications about software throughout Josh Reed Josh Reed REFERENCE DOCUMENTATION Please see the following documents for more information: Reference No.
TABLE OF CONTENTS 1 CHAPTER 1 GETTING STARTED ................................................................................................................ 4 1.1 LINUX DRIVER INSTALLATION.......................................................................................................................... 4 1.1.1 Before you begin ..................................................................................................................................... 4 1.1.2 Copy driver Modules ......
1 CHAPTER 1 GETTING STARTED 1.1 LINUX DRIVER INSTALLATION 1.1.1 BEFORE YOU BEGIN It is required that the user obtain and install the appropriate Linux driver to support the USB Wireless Adapter. The Linux driver details are for informational purposes and only the Caterpillar D6:Cx Display is configured to utilize the Adapter. The drivers are hardcoded into the Display software and that software is programmed into the Display at the manufacturer.
3. usbfwdnld.ko options: fw_name=mrvl/usbusb8997_combo_v4.bin req_fw_nowait=1 4. bt8xxx_usb 1.1.5 drv_mode=3 cal_cfg=mrvl/bt_cal_data.conf init_cfg=mrvl/bt_init_cfg.conf BUILD AND CONFIGURE BLUEZ 5.42 1. Visit bluez.org to get instructions on downloading the source code 2. Update tools/btgatt‐server.c with our 1.0 released version 3. Update tools/bgatt‐client.c with our 1.0 released version 4. Update tools/hcitool.c with our 1.0 released version 5.
2 LINUX WIRELESS CONFIGURATION 2.1 CONNECT TO ACCESS POINT The following is an example bash script that can be used to configure the wireless adapter to connect to an access point. Note the script must be executed within a shell environment with root privileges. #!/bin/bash # Script to configure mlan_usb0 according paramters specified in wpa_supplicant.conf file. # Bring up wpa_supplicant /sbin/wpa_supplicant ‐dd ‐B ‐imlan_usb0 ‐c/etc/wpa_supplicant/wpa_supplicant.
The following is the hostapd configuration file used to bring up the access point. Note this configuration has been tested and is functional with v2.4 of hostapd. interface=uap_usb0 bssid=86:04:07:D2:1A:06 driver=nl80211 ssid=00_Ubuntu hw_mode=g wpa=2 wpa_passphrase=Trymeout90210 wpa_key_mgmt=WPA‐PSK channel=1 wme_enabled=1 macaddr_acl=0 auth_algs=1 ignore_broadcast_ssid=0 wpa_pairwise=TKIP rsn_pairwise=CCMP country_code=US ieee80211d=1 ieee80211h=1 ieee80211n=1 wmm_enabled=1 # 802.
3 LINUX BLE CONFIGURATION The provided Bluetooth software package allows the user to configure the system to communicate with up to 6 supported BLE peripherals, and 3 BLE centrals at one time. This is intended to be used to demonstrate the ability of the chipset on the USB Wireless Adapter to operate simultaneously as a peripheral and a central in order to demonstrate the ability to form a scatternet.
2. Enable notifications. 3. Observe the notifications coming in. 3.4 ALTERNATIVE TO 3.1 TO 3.3 An alternative to manually configuring this. The user may start this all by executing the provided script: cat_start_syvp_test.sh, cat_start_syvp_test_0dbm.sh, or cat_start_syvp_test_0dbm.sh. Executing these scripts will clean up BLE from the last run then re‐initialize everything. The _0dbm.sh versions select a power level according to the name of the file. The cat_start_syvp_test.
4 TROUBLESHOOTING Logging data is printed on the console. This can be used to help determine the cause of any problem that may occur. 4.1 BLE 4.1.1 FAILURE TO CONNECT TO A UB1 PERIPHERAL ON THE ARRAY BOARD 1. Ensure the array board is functioning and the power jumpers are enabled for at least 6 of the peripherals on the board. A green LED will be illuminated for each module when it is powered. A red illuminated LED indicates a connection is established.
5 LIMITATIONS AND KNOWN ISSUES 5.1 5.1.1 USB FAILURE TO ENUMERATE AFTER A HOST REBOOT If the host is rebooted without cycling power to the USB device, it will fail to re‐enumerate and print logging messages similar to the following: usb 1‐1.2: device no response, device descriptor read/64, error ‐110 usb 1‐1.2: device no response, device descriptor read/64, error ‐110 usb 1‐1.2: new high‐speed USB device number 4 using ci_hdrc usb 1‐1.2: device no response, device descriptor read/64, error ‐110 usb 1‐1.
6 PRODUCT OVERVIEW The USB Wireless Adapter is a portable device that when installed in a machine, provides Wi‐Fi and local Bluetooth connectivity within the vicinity of the vehicle/machine. The Wi‐Fi connectivity enables local basic diagnostic and service functionality. The customer or service technician can monitor the health of the machine over WiFi with a smart device such as a mobile phone or tablet.
7 INSTALLATION PROCEDURE The USB Wireless Adapter is designed to be installed into the USB port of a Caterpillar D6:Cx Display. Proper installation is crucial for desired operation and to provide adequate environmental protection. 7.1 D6:CX DISPLAY The D6:Cx Display has a specially designed compartment for the USB Wireless Adapter.
8 GLOSSARY OF TERMS Term Meaning BLE BT RF RX SSID TBD TX USB LED Bluetooth Low Energy or Bluetooth SMART Bluetooth Radio Frequency Receive Service Set Identifier To be determined Transmit Universal Serial Bus Light Emitting Diode Page 14 of 16 Caterpillar: Confidential Green
9 COMPLIANCE STATEMENTS This device is manufactured for the global market but when labeled for marketing in North America the one‐time programmable (OTP) ROM is programmed at the factory to operate and actively scan only these specific channels: Channels 1‐11, 2412‐2462MHz 802.11b mode Channels 1‐11, 2412‐2462MHz 802.11g mode Channels 1‐11, 2412‐2462MHz 802.11n mode (20MHz channel) Channels 3‐9, 2422‐2452MHz 802.
‐ Consult the dealer or an experienced radio/TV technician for help. This portable transmitter with its antenna complies with FCC and Innovation Science and Economic Development Canada RF exposure limits for general population / uncontrolled exposure. This Device complies with Innovation, Science and Economic Development Canada License‐exempt RSS standard(s).