NXP Semiconductors 88W8987 User Manual
  1. Manuals
  2. Brands
  3. NXP Semiconductors Manuals
  4. Wireless modules
  5. 88W8987
  6. User manual
NXP Semiconductors 88W8987 User Manual

NXP Semiconductors 88W8987 User Manual

Wireless feature configuration guide for i.mx 8m nano evk with based wireless module
Hide thumbs Also See for 88W8987:
Table of Contents

Advertisement

Quick Links

UM11512
Wireless Feature Configuration Guide for i.MX 8M Nano EVK
with 88W8987-based Wireless Module
Rev. 1 — 3 December 2020
Document information
Information
Content
Keywords
88W8987-based wireless modules, Wi-Fi features, Bluetooth features,
guidelines, driver debug information
Abstract
Describes Wi-Fi/Bluetooth features and configurations for i.MX 8M Nano EVK
User manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the 88W8987 and is the answer not in the manual?

Questions and answers

Related Manuals for NXP Semiconductors 88W8987

Summary of Contents for NXP Semiconductors 88W8987

  • Page 1 Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Rev. 1 — 3 December 2020 User manual Document information Information Content Keywords 88W8987-based wireless modules, Wi-Fi features, Bluetooth features, guidelines, driver debug information Abstract Describes Wi-Fi/Bluetooth features and configurations for i.MX 8M Nano EVK...
  • Page 2 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Revision history Date Description 20201203 Initial version UM11512 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2020. All rights reserved.

  • Page 3: About This Document

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module About this document 1.1 Purpose This document details the Wi-Fi/Bluetooth features and configurations for i.MX 8M Nano evaluation kit (EVK). The Wi-Fi features include scanning and configuring the access points, connecting to the access point, Wi-Fi security, Wi-Fi direct and the iPerf test.

  • Page 4: References

    Reference type Description Datasheet NXP - DS - 88W8987 2.4/5 GHz Dual-Band 1x1 Wi-Fi 5 and Bluetooth 5 Solution (link) User manual NXP - UM11513 - Getting Started with 88W8987-based Wireless Module on i.MX 8M Nano EVK Running Linux OS Explains how to bring up the Wi-Fi and Bluetooth interfaces of 88W8987-based wireless module on i.MX 8M Nano EVK (link).

  • Page 5: Wi-Fi Features And Considerations

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Wi-Fi features and considerations 2.1 Scan for visible Access Points This section describes the scanning for visible Access Points using 88W8987-based wireless module. Linux operating system provides the standard utilities iw and wpa_cli to view and edit the wireless module configurations.
  • Page 6 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Max AMSDU length: 3839 bytes DSSS/CCK HT40 Maximum RX AMPDU length 65535 bytes (exponent: 0x003) Minimum RX AMPDU time spacing: 4 usec (0x05) HT TX/RX MCS rate indexes supported: 0-15...

  • Page 7: Using Wpa_Supplicant And Wpa_Cli

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.1.2 Using wpa_supplicant and wpa_cli commands You can also use wpa_supplicant and wpa_cli to scan the visible access points. To edit the configuration file: root@imx8mnevk:~# nano /etc/wpa_supplicant.conf...

  • Page 8: Configure And Start The Access Point

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module To get the scan results: > scan_results Command output example showing one SSID: bssid / frequency / signal level / flags / ssid 44:82:e5:10:2c:38...

  • Page 9: Configure The Access Point

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.2.2 Configure the Access Point To edit the configuration file for the 2.4 GHz Access Point: root@imx8mnevk:~# nano /etc/hostapd-2.4g.conf Parameters in the configuration file:...

  • Page 10: Start The Access Point

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.2.3 Start the Access Point Commands to run prior to starting the Access Point: root@imx8mnevk:~# killall wpa_supplicant root@imx8mnevk:~# killall hostapd root@imx8mnevk:~# ifconfig uap0 192.168.1.2 netmask 255.255.255.0 up root@imx8mnevk:~# route add default gw 192.168.1.1...

  • Page 11: Connect With The Access Point

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module The following shows an example for the 5 GHz Access Point. Command to start the 5 GHz Access Point: root@imx8mnevk:~# hostapd /etc/hostapd-5g.conf Command output example: Configuration file: /etc/hostapd-5g.conf...

  • Page 12: Use Wpa_Supplicant To Connect With The Ap

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.3.2 Use wpa_supplicant to connect with the AP Connect wpa_supplicant with the Access Point root@imx8mnevk:~# killall wpa_supplicant root@imx8mnevk:~# killall hostapd root@imx8mnevk:~# wpa_supplicant -i mlan0 -Dnl80211 –c /etc/ wpa_supplicant.conf...

  • Page 13: Wi-Fi Security

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.4 Wi-Fi security This section describe the Wi-Fi security features including the WPA, WPA2 and WPA3 SAE security modes. Both the configuration and setup use the open source supplicants.
  • Page 14 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Start the Access Point root@imx8mnevk:~# killall wpa_supplicant root@imx8mnevk:~# killall hostapd root@imx8mnevk:~# ifconfig uap0 192.168.1.2 netmask 255.255.255.0 up root@imx8mnevk:~# route add default gw 192.168.1.1 root@imx8mnevk:~# hostapd /etc/hostapd-wpa.conf Command output example Configuration file: /etc/hostapd-wpa.conf...

  • Page 15: Configure Wpa2 For The Ap Using Open Source Supplicant

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.4.2 Configure WPA2 for the AP using open source supplicant This section shows the hostapd configurations used to configure WPA2 security and start the Access Point using open source supplicant.
  • Page 16 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Start the Access Point root@imx8mnevk:~# killall wpa_supplicant root@imx8mnevk:~# killall hostapd root@imx8mnevk:~# ifconfig uap0 192.168.1.2 netmask 255.255.255.0 up root@imx8mnevk:~# route add default gw 192.168.1.1 root@imx8mnevk:~# hostapd /etc/hostapd-wpa2.conf Command output example Configuration file: /etc/hostapd-wpa2.conf...

  • Page 17: Configure Wpa3 For The Access Point

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.4.3 Configure WPA3 for the Access Point WPA3 is the next generation of Wi-Fi security with new capabilities that enhance the Wi- Fi protection in personal and enterprise networks. Built on the widely adopted WPA2, WPA3 adds new features to simplify Wi-Fi security, enable more robust authentication, and deliver increased cryptographic strength for highly sensitive data markets.

  • Page 18: Set Wpa3 Sae Transition Mode For The Access Point

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.4.3.2 Set WPA3 SAE transition mode for the Access Point Create the configuration file root@imx8mnevk:~# nano /etc/hostapd-wpa3-sae.conf Content of the configuration file: interface=uap0 driver=nl80211...

  • Page 19: Set Wpa3 Sae Mode To Connect With The Access Point Configured With Wpa3 Sae

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.4.3.3 Set WPA3 SAE mode to connect with the Access Point configured with WPA3 SAE Create the configuration file root@imx8mnevk:~# nano /etc/wpa_supplicant.conf Content of the configuration file:...

  • Page 20: Configure Wpa To Connect With Ap Using The Open Source Supplicant

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.4.4 Configure WPA to connect with AP using the open source supplicant This section shows the configurations for wpa_supplicant to configure WPA security and connect with the Access Point using open source supplicant.

  • Page 21: Configure Wpa2 To Connect With The Ap Using An Open Source Supplicant

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.4.5 Configure WPA2 to connect with the AP using an open source supplicant This section describes the configurations for wpa_supplicant to configure WPA2 security and connect with the Access Point using open source supplicant.

  • Page 22: Configure Ieee 802.11A/B/G/N/Ac Standards

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.5 Configure IEEE 802.11a/b/g/n/ac standards This section describes the different IEEE 802.11 standard configurations for the Access Points. The standards use different bandwidths and network speed. The IEEE 802.11a and 802.11ac standards operate only at 5 GHz, IEEE 802.11b and 802.11g operate at...

  • Page 23: Configure Ieee 802.11N Standard

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.5.4 Configure IEEE 802.11n standard Use the following to configure the Access Point configuration for IEEE 802.11n standard for 2.4 GHz and 5 GHz.

  • Page 24: Test Wi-Fi Direct

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.6 Test Wi-Fi direct This section describes the WiFi direct feature which is used to establish a connection that allows for device-to-device or peer-to-peer communication, linking devices together without a nearby centralized network.
  • Page 25 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Command output example: [ 2896.073550] wlan: Loading MWLAN driver [ 2896.178399] vendor=0x02DF device=0x9149 class=0 function=1 [ 2896.183972] Attach moal handle ops, card interface type: 0x105 [ 2896.189935] SD8987: init module param from usr cfg...
  • Page 26 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Output example 59.511943] wlan: p2p0 START SCAN <3>CTRL-EVENT-SCAN-STARTED > [ 59.643151] wlan: SCAN COMPLETED: scanned AP count=0 59.979884] wlan: p2p0 START SCAN <3>CTRL-EVENT-SCAN-STARTED > [ 60.111610] wlan: SCAN COMPLETED: scanned AP count=1...
  • Page 27 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module • Accept the Wi-Fi Direct connection request on the peer or on the mobile device 91.756563] wlan: RX P2P Group Owner Negotiation Req Frame, channel=11 91.763402] wlan: TX P2P Group Owner Negotiation Rsp Frame,...
  • Page 28 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module • Close the wpa_cli prompt > quit UM11512 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2020. All rights reserved.

  • Page 29: Measure The Throughput With Iperf

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.7 Measure the throughput with iPerf This section describes the throughput test using the iPerf tool. iPerf is an open source tool used for network throughput measurements. The tool can test either TCP or UDP throughput.
  • Page 30 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Step 1 - Connect the device with the Access point Follow the instructions given in Section 2.3 "Connect with the Access Point" to connect the device i.MX 8M Nano EVK with the Access Point (External WiFi router).
  • Page 31 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Step 3 - Start iPerf as server on the Linux Host On the Linux Host, run iPerf with the options: • -s - server mode •...
  • Page 32 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Step 4 - Start iPerf as client on i.MX 8MNano EVK On the i.MX 8MNano EVK, run iPerf with options: • -c <IP address of the iperf server on the local network>: client mode, connect to Linux host IP address •...

  • Page 33: Rf Test Mode

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.8 RF test mode This section shows how to use RF test mode to set the Tx/Rx antenna configuration and the RF band. Read more in the README_MLAN located in /usr/share/nxp_wireless/bin_mxm_wifiex/ directory.

  • Page 34: Set Rf Band

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.8.2 Set RF band This section shows how to set the RF band to 2.4 GHz or 5 GHz. The test requires first to load the driver modules to bring-up 88W8987-based wireless module.

  • Page 35: Ed-Mac And Tx Power Enable

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.9 ED-MAC and Tx power enable This section provides the guidelines to enable energy detection (ED) for the adaptivity test and to load the converted Tx power table.
  • Page 36 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Example root@imx8mnevk:~# ./mlanutl mlan0 hostcmd config/ ed_mac_ctrl_V3_8987.conf generate_raw ed_mac.bin Copy the newly generated binary file ed_mac.bin and paste into the wireless firmware directory. For Linux operating systems, the directory is: /lib/firmware/nxp.
  • Page 37 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Command output example: [ 3388.551010] wlan: Loading MWLAN driver [ 3388.654788] vendor=0x02DF device=0x9149 class=0 function=1 [ 3388.660674] Attach moal handle ops, card interface type: 0x105 [ 3388.666654] SD8987: init module param from usr cfg...

  • Page 38: Configure The Maximum Transmit Power

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.9.2 Configure the maximum transmit power This section provides the steps to configure the maximum transmit (Tx) power. Step 1 - Edit the configuration file The Tx power levels are set with txpwrlimit_2g_cfg_set and txpwrlimit_5g_cfg _set data structures defined in txpwrlimit_cfg.conf configuration...
  • Page 39 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Run the following command to load the modules: root@imx8mnevk:~# modprobe moal mod_para=nxp/wifi_mod_para_sd8987.conf Step 4 - Get Tx power configurations The command get the Tx power configurations uses mlanutl utility stored at the following...

  • Page 40: Configure Low Power Modes

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 2.9.3 Configure low power modes Step 1 - Verify and update the module parameters Verify and update the module parameters in wifi_mod_para_sd8987.conf file. root@imx8mnevk:~# nano /lib/firmware/nxp/wifi_mod_para_sd8987.conf...

  • Page 41: Enable Dmesg Logs

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Step 4 - Enable WoWLan root@imx8mnevk:~# iw phy#0 wowlan enable any Step 5 - Set the device in low power mode root@imx8mnevk:~# echo mem >> /sys/power/state 2.9.3.1 Enable dmesg logs...

  • Page 42: Wi-Fi Driver Debugging

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Wi-Fi driver debugging This section explains how to retrieve different driver debug logs and access debug information. Some debug logs can be enabled at runtime and at driver load time. Other logs require to first rebuild the driver with a specific configuration.

  • Page 43: Driver Debug Log Types

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 3.2 Driver debug log types Table 2 lists the debug logs types exposed by the NXP driver for drvdbg parameter. The debug information can be enabled or disabled using either the module parameter (Section 3.1.1...

  • Page 44: Firmware Dump

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 3.3 Firmware dump This section shows how to retrieve the firmware memory from the device and dump it into a file for debugging purposes. A firmware dump can be triggered from the /proc method.

  • Page 45: Bluetooth Classic/Bluetooth Le Features And Configurations

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Bluetooth classic/Bluetooth LE features and configurations 4.1 Scan, pair and connect to Bluetooth classic/Bluetooth LE This section describes the configuration steps to scan, pair and connect with a Remote Bluetooth device from the Bluetooth of 88W8987-based module.
  • Page 46 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Stop the scanning [bluetooth]# scan off Command output example: Discovery stopped [CHG] Controller 00:50:43:24:34:F7 Discovering: no Check the devices available for pairing [bluetooth]# devices...
  • Page 47 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Confirm the pairing Type 'yes' if the passkey matches and the connection can be formed: [agent] Confirm passkey 666330 (yes/no): yes Command output example:...
  • Page 48 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Connect with the remote Bluetooth Classic/Bluetooth LE device The remote Bluetooth Classic/Bluetooth LE device is not yet in connected state. Run the following command to reverse the state.

  • Page 49: Advanced Audio Distribution Profile

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.2 Advanced audio distribution profile This section describes the configuration steps for i.MX 8M Nano EVK to act as A2DP Sink and Source. The Pulseaudio and Bluetooth-player packages are used while configuring these profiles.
  • Page 50 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module UUID: Generic Access Profile (00001800-0000-1000-8000-00805f9b34fb) UUID: Generic Attribute Profile (00001801-0000-1000-8000-00805f9b34fb) Modalias: bluetooth:v001Dp1200d1436 [c8ca22c1]# Exit from bluetoothctl command line interface [c8ca22c1]# quit Command output: root@imx8mnevk:~#...
  • Page 51 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Play and pause the audio Use bluetooth-player to play the audio. root@imx8mnevk:~# bluetooth-player Command output example: [NEW] Player /org/bluez/hci0/dev_B4_F5_00_31_CB_4E/player0 [default] [NEW] Folder /org/bluez/hci0/dev_B4_F5_00_31_CB_4E/player0 [NEW] Item /org/bluez/hci0/dev_B4_F5_00_31_CB_4E/player0/...
  • Page 52 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Disconnect the device using bluetoothctl command line interface root@imx8mnevk:~# bluetoothctl [Moto E]# disconnect B4:F5:00:31:CB:4E Command output example: Attempting to disconnect from B4:F5:00:31:CB:4E [CHG] Device B4:F5:00:31:CB:4E ServicesResolved: no...

  • Page 53: Set As A2Dp Source

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.2.2 Set as A2DP source Make sure the remote Bluetooth device supports A2DP Sink Profile feature. Use the following steps to configure the i.MX 8M Nano board as an A2DP Source.
  • Page 54 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Copy the sample audio file to i.MX 8M Nano EVK Use the following command to check the available sink cards: root@imx8mnevk:~# pacmd list-sinks | egrep '(index|name):'...

  • Page 55: Object Push Profile

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Disconnect the device using bluetoothctl command line interface root@imx8mnevk:~# bluetoothctl Agent registered [Office speaker 1]# disconnect 7C:2E:BD:48:15:FC Command output example: Attempting to disconnect from 7C:2E:BD:48:15:FC...
  • Page 56 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Connect with a remote Bluetooth device that supports Object Push Profile Refer to Section 4.1 "Scan, pair and connect to Bluetooth classic/Bluetooth LE" Verify the Object Push Profile capability of the connected Bluetooth device using...
  • Page 57 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Start Obex Control root@imx8mnevk:~# obexctl Command output: [NEW] Client /org/bluez/obex Connect to the remote Bluetooth device paired using Bluetooth Control [obex]# connect B4:F5:00:31:CB:4E Command output example:...
  • Page 58 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Disconnect [B4:F5:00:31:CB:4E]# disconnect Command output example: Attempting to disconnect to /org/bluez/obex/client/session2 [DEL] Session /org/bluez/obex/client/session2 [default] [DEL] ObjectPush /org/bluez/obex/client/session2 Disconnection successful Exit from the obexctl...

  • Page 59: Human Interface Device Profile (Hid)

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.4 Human Interface Device Profile (HID) This section provides the configuration steps to connect a Bluetooth keyboard and/or mouse. The Human Interface Device Profile is used to establish the connection.

  • Page 60: Bluetooth Le Device As Gatt Server

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.5 Bluetooth LE device as GATT server This section shows how to configure the i.MX 8M Nano board as a Bluetooth LE GATT Server using the example of Battery Service registration.
  • Page 61 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Register the Battery Service [bluetooth]# register-application 0000180F-0000-1000-8000-00805f9b34fb Command output example: [CHG] Controller 00:50:43:24:34:F7 UUIDs: 00001112-0000-1000-8000-00805f9b34fb [CHG] Controller 00:50:43:24:34:F7 UUIDs: 0000110a-0000-1000-8000-00805f9b34fb [CHG] Controller 00:50:43:24:34:F7 UUIDs:...
  • Page 62 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Check that the Battery Service was added successfully To go back to the main menu: [bluetooth]# back Command output: Menu main: To view details about the battery service:...
  • Page 63 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Start Bluetooth LE advertising [bluetooth]# advertise on Command output example: [CHG] Controller 00:50:43:24:34:F7 SupportedInstances: 0x04 [CHG] Controller 00:50:43:24:34:F7 ActiveInstances: 0x01 Advertising object registered Tx Power: off...

  • Page 64: Bluetooth Le Device As Gatt Client

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.6 Bluetooth LE device as GATT client This section describes the procedure to configure the i.MX 8M Nano EVK as a Bluetooth LE client. It also shows the options to list the attributes available in the Bluetooth LE server and access information.

  • Page 65: Human Interface Device Service

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.7 Human Interface Device Service This section describes the configuration steps to connect the 88W8987-based Bluetooth LE module with a Bluetooth Low Energy device that supports Human Interface Device Profile.

  • Page 66: Rf Test Mode

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.8 RF test mode This section describes the commands to perform the RF Test for Bluetooth Classic and Bluetooth Low Energy on the i.MX 8M Nano.

  • Page 67: Bluetooth Classic

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.8.2 Bluetooth Classic Two commands are used to test the RF for Bluetooth Classic: HCI_CMD_RX_TEST and HCI_CMD_TX_TEST . 4.8.2.1 Set the receive test parameters...

  • Page 68: Bluetooth Low Energy (Le)

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.8.3 Bluetooth Low Energy (LE) Two commands are used to test the RF for Bluetooth Low Energy (LE): LE Receiver Test and LE Transmitter Test. And one command is used to end the test.

  • Page 69: Bluetooth Le Transmitter Test

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 4.8.3.2 Bluetooth LE transmitter test To start a test where the DUT generates test reference packets at a fixed interval, use LE Transmitter Test command. For more details on the command please refer to Bluetooth Core Specification v5.2 Volume-4 Part-E section 7.8.29 referenced in...

  • Page 70: Bluetooth Debugging

    5.1 Bluetooth protocol debugging 5.1.1 Capture the HCI logs using hcidump Follow these steps to capture the HCI logs between the i.MX 8M Nano and 88W8987- based module using hcidump utility. Start capturing HCI logs Use the following command to start the HCI logs and store these in the file. Use...

  • Page 71: Capture The Hci Logs Using Btmon

    Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 5.1.2 Capture the HCI Logs using btmon Follow these steps to capture the HCI logs between the i.MX 8M Nano and 88W8987- based module using btmon utility.
  • Page 72 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Connect with a Bluetooth Classic/LE device Refer to Section 4.1 "Scan, pair and connect to Bluetooth classic/Bluetooth LE" Stop capturing HCI logs root@imx8mnevk:~# killall btmon...

  • Page 73: Extract The Link Key For Remote Bluetooth Classic/Bluetooth Le Devices

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 5.1.3 Extract the Link Key for remote Bluetooth Classic/Bluetooth LE devices Follow these steps to get the link key for paired Bluetooth Classic/Bluetooth LE devices: Get the information for Bluetooth Classic and/or Bluetooth LE devices root@imx8mnevk:~# cat /var/lib/bluetooth/<DUT BD Address>/<Remote BD...

  • Page 74: Bluetooth Driver Debugging

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module 5.2 Bluetooth driver debugging Run the following command to get and analyze the Bluetooth logs using dmesg utility. Use Dmesg utility to display the driver logs...

  • Page 75: Contact Information

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Contact information Use the following links for more details, queries and support. • Website homepage: nxp.com • Web support: nxp.com/support • NXP community: community.nxp.com •...

  • Page 76: Legal Information

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Legal information the application or use by customer’s third party customer(s). Customer is responsible for doing all necessary testing for the customer’s applications 8.1 Definitions...
  • Page 77 UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Tables Tab. 1. References ............4 Tab. 3. Acronyms and abbreviations ......75 Tab. 2. NXP driver debug log types ......43 Figures Fig. 1.

  • Page 78: Table Of Contents

    UM11512 NXP Semiconductors Wireless Feature Configuration Guide for i.MX 8M Nano EVK with 88W8987-based Wireless Module Contents About this document .......... 3 Driver debug log types ........43 Purpose ..............3 Firmware dump ..........44 Bluetooth classic/Bluetooth LE features Scope ..............3 Considerations ........... 3 and configurations ..........45...

Table of Contents