NXP Semiconductors UM11490 User Manual
NXP Semiconductors UM11490 User Manual

NXP Semiconductors UM11490 User Manual

Nxp-based wireless modules on i.mx 8m quad evk
Table of Contents

Advertisement

UM11490
Feature Configuration Guide for NXP-based Wireless Modules
on i.MX 8M Quad EVK
Rev. 2 — 29 January 2021
Document information
Information
Content
Keywords
NXP-based wireless modules, Wi-Fi features, Bluetooth features, guidelines,
driver debug information
Abstract
Details the Wi-Fi and Bluetooth features and configurations for NXP-based
wireless modules on i.MX 8M Quad EVK
User manual

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for NXP Semiconductors UM11490

  • Page 1 UM11490 Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Rev. 2 — 29 January 2021 User manual Document information Information Content Keywords NXP-based wireless modules, Wi-Fi features, Bluetooth features, guidelines, driver debug information Abstract Details the Wi-Fi and Bluetooth features and configurations for NXP-based...
  • Page 2 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Revision history Date Description 20200929 Initial version 20210129 Modifications: • Extended the scope to 88W8997-based wireless modules • Section 1 "About this document": updated •...
  • Page 3: About This Document

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK About this document 1.1 Purpose and scope This document details the Wi-Fi and Bluetooth features and configurations for NXP- based wireless modules on i.MX 8M Quad EVK. The Wi-Fi features include scanning for nearby access points, connecting to an access point, configuring the device as an access point, Wi-Fi security, Wi-Fi Direct, and throughput testing using the iPerf utility.
  • Page 4: Wi-Fi Features And Configurations

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Wi-Fi features and configurations 2.1 Scan the visible Access Points This section describes the scanning of the visible Access Points using the NXP-based wireless module. Linux operating system provides the standard utilities to show/ manipulate wireless devices and their configuration.
  • Page 5 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK TX STBC RX STBC 1-stream Max AMSDU length: 3839 bytes DSSS/CCK HT40 Maximum RX AMPDU length 65535 bytes (exponent: 0x003) Minimum RX AMPDU time spacing: 4 usec (0x05)
  • Page 6: Using Wpa_Supplicant And Wpa_Cli

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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. Edit the configuration file: root@imx8mqevk:~# nano /etc/wpa_supplicant.conf...
  • Page 7: Configure And Start The Access Point

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Get the scan results: > scan_results Command output example showing one SSID: bssid / frequency / signal level / flags / ssid 2442 44:82:e5:10:2c:38 [WPA-PSK-CCMP+TKIP][WPA2-PSK-CCMP+TKIP][ESS] destin 2.2 Configure and start the Access Point...
  • Page 8: Configure The 5 Ghz Access Point

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.2.3 Configure the 5 GHz Access Point Edit the configuration file: root@imx8mqevk:~# nano /etc/hostapd-5g.conf Parameter values in the configuration file: interface=uap0 hw_mode=a channel=0 country_code=US ssid=NXP_Demo ieee80211n=1 2.2.4 Set up udhcp server...
  • Page 9: Start The Access Point

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.2.5 Start the Access Point Run the following command to start the Access Point: root@imx8mqevk:~# killall wpa_supplicant root@imx8mqevk:~# killall hostapd root@imx8mqevk:~# ifconfig uap0 192.168.1.2 netmask 255.255.255.0 up root@imx8mqevk:~# route add default gw 192.168.1.1...
  • Page 10: Connect With The Access Point

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Command to start the 5 GHz Access Point: root@imx8mqevk:~# hostapd /etc/hostapd-5g.conf Command output example: Configuration file: /etc/hostapd-5g.conf rfkill: Cannot open RFKILL control device uap0: interface state UNINITIALIZED->COUNTRY_UPDATE ACS: Automatic channel selection started, this may take a bit [ 9816.085716] wlan: SCAN COMPLETED: scanned AP count=0...
  • Page 11: Get Wpa_Supplicant Version

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.3.2 Get wpa_supplicant version Command to get wpa_supplicant version root@imx8mqevk:~# wpa_supplicant -v Command output example: wpa_supplicant v2.9 Copyright (c) 2003-2019, Jouni Malinen <j@w1.fi> and contributors 2.3.3 Use wpa_supplicant to connect with the AP...
  • Page 12: Wi-Fi Security

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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 13 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Start the Access Point root@imx8mqevk:~# killall wpa_supplicant root@imx8mqevk:~# killall hostapd root@imx8mqevk:~# ifconfig uap0 192.168.1.2 netmask 255.255.255.0 up root@imx8mqevk:~# route add default gw 192.168.1.1 root@imx8mqevk:~# hostapd /etc/hostapd-wpa.conf Command output example: Configuration file: /etc/hostapd-wpa.conf...
  • Page 14: Configure Wpa2 For The Ap Using Open Source Supplicant

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.4.2 Configure WPA2 for the AP using open source supplicant This section shows the hostapd configuration used to configure WPA2 security and start the Access Point using open source supplicant.
  • Page 15 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Start the Access Point Run the following command to start the Access Point: root@imx8mqevk:~# killall wpa_supplicant root@imx8mqevk:~# killall hostapd root@imx8mqevk:~# ifconfig uap0 192.168.1.2 netmask 255.255.255.0 up root@imx8mqevk:~# route add default gw 192.168.1.1...
  • Page 16: Wpa3 Security

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.4.3 WPA3 security 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 17 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Configure WPA3 SAE transition mode for the Access Point Create the configuration file: root@imx8mqevk:~# nano /etc/hostapd-wpa3-sae.conf Configuration file content: interface=uap0 driver=nl80211 ssid=NXP_Demo hw_mode=g channel=6 wmm_enabled=1...
  • Page 18 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Configure WPA3 SAE mode to connect with the AP configured with WPA3 SAE Create the configuration file root@imx8mqevk:~# nano /etc/wpa_supplicant.conf Configuration file content: ctrl_interface=/var/run/wpa_supplicant ctrl_interface_group=0...
  • Page 19: Configure Wpa To Connect With Ap Using The Open Source Supplicant

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.4.4 Configure WPA to connect with AP using the open source supplicant This section describes the configuration for wpa_supplicant to configure WPA security and connect with the Access Point.
  • Page 20: Configure Wpa2 To Connect With The Ap Using An Open Source Supplicant

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.4.5 Configure WPA2 to connect with the AP using an open source supplicant This section describes the configuration for wpa_supplicant to configure WPA2 security and connect with the Access Point.
  • Page 21: Configure Ieee 802.11A/B/G/N/Ac Standards

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.5 Configure IEEE 802.11a/b/g/n/ac standards This section describes the different IEEE 802.11 standard configurations for the Access Point. The standards use different bandwidths and network speed. The IEEE 802.11a and IEEE 802.11ac standards operate only at 5 GHz, IEEE 802.11b/g operate at 2.4 GHz...
  • Page 22: Configure Ieee 802.11N Standard

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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. Edit the configuration for 2.4 GHz root@imx8mqevk:~# nano /etc/hostapd.conf...
  • Page 23: Configure And Test Wi-Fi Direct

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.6 Configure and test Wi-Fi direct This section describes the Wi-Fi 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 24 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK • Start the wpa_supplicant on i.MX 8M Quad: root@imx8mqevk:~# killall wpa_supplicant root@imx8mqevk:~# killall hostapd root@imx8mqevk:~# wpa_supplicant -g/var/run/wpa_supplicant-global -D nl80211 –B & • Start the wpa_cli on i.MX 8M Quad:...
  • Page 25 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK • 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 26: Measure The Throughput With Iperf

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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 27 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 3 - Start iPerf on the server Use the following command to start iPerf on the Ubuntu station connected with the external Wi-Fi Router as a server.
  • Page 28 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 4 - Start iPerf on the client Iperf server is running and the system is connected to the external AP. Run the following command to start iPerf on i.MX 8M Quad station as a client. The command takes iPerf server IP address as an argument.
  • Page 29: Rf Test Mode

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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 30: Set The Rf Frequency Band

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.8.2 Set the RF frequency band This section shows how to set the RF frequency band to 2.4 GHz or 5 GHz. The test requires first to load the driver modules to bring-up the wireless module.
  • Page 31: Set The Rf Bandwidth

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.8.3 Set the RF bandwidth This section shows how to set the RF bandwidth to 20/40/80 MHz. The test requires first to load the driver modules to bring-up the NXP-based wireless module.
  • Page 32: Set Tx Power

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.8.5 Set Tx power This section shows how to set the Tx power. The commands only set power if caldata is already loaded in the firmware. The test also requires first to load the driver modules to bring-up NXP-based wireless module.
  • Page 33: Set Tx Continuous Mode

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.8.6 Set Tx continuous mode This section shows how to set Tx continuous mode. The test requires first to load the driver modules to bring-up NXP-based wireless module.
  • Page 34 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Where: Parameter Definition Start/stop enable • 0 = disable start/stop • 1 = enable Continuous wave mode enable continuous wave mode • 0 = disable •...
  • Page 35: Set Tx Frame

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.8.7 Set Tx frame This section shows how to set Tx frame. The test requires first to load the driver modules to bring-up NXP-based wireless module.
  • Page 36 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Parameter Definition Advanced coding adv coding • 0 = disable • 1 = enable Beamforming enable beamforming • 0 = disable • 1 = enable...
  • Page 37 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Table 2. Data rate parameter ...continued Data rate HT_MCS11 HT_MCS12 HT_MCS13 HT_MCS14 HT_MCS15 VHT_SS1_MCS0 VHT_SS1_MCS1 VHT_SS1_MCS2 VHT_SS1_MCS3 VHT_SS1_MCS4 VHT_SS1_MCS5 VHT_SS1_MCS6 VHT_SS1_MCS7 VHT_SS1_MCS8 VHT_SS1_MCS9 VHT_SS2_MCS0 VHT_SS2_MCS1 VHT_SS2_MCS2...
  • Page 38: Ed-Mac And Tx Power Enable

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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 39 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK For Linux operating systems, the directory is: /lib/firmware/nxp. Step 3 - Load ED-MAC configuration The ED-MAC configuration binary file is activated during the wireless driver load time.
  • Page 40: Transmit Power Enable

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.9.2 Transmit power enable This section provides the steps to enable 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 41 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 4 - Get Tx power configurations The command get the Tx power configurations uses mlanutl utility stored at the following location: /usr/share/nxp_wireless/bin_mxm_wifiex/ Syntax: mlanutl <ifname> <cmd> [...]...
  • Page 42: Set The Wi-Fi Device In Suspend State

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.10 Set the Wi-Fi device in suspend state This section explains how to capture the Wi-Fi driver logs even when the i.MX host processor is in suspend state. It also covers the steps to put the i.MX host processor in suspend state.
  • Page 43: Enable Dmesg Logs For Device In Supended State

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 2.10.1 Enable dmesg logs for device in supended state Step 1 - Boot the i.MX 8M Quad EVK to the U-boot console U-Boot > Step 2 - Enable dmesg logs while the device is in suspended state U-Boot >...
  • Page 44: Wi-Fi Driver Debugging

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Wi-Fi driver debugging This section explains how to enable driver debug logs and access debug information. Some debug logs can be enabled at runtime and driver load time. Other logs require to first rebuild the driver with a specific configuration.
  • Page 45: Driver Debug Log Types

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 3.2 Driver debug log types Table 3 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 46: Firmware Dump

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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. The driver also dumps the firmware memory in the dmesg logs when a fatal error occurs for example due to command timeout or Tx timeout.
  • Page 47: Bluetooth Classic/Bluetooth Le Features And Configurations

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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 NXP-based wireless module.
  • Page 48 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Start pairing Start pairing with the remote Bluetooth Classic/Bluetooth LE device. [bluetooth]# pair B4:F5:00:31:CB:4E Attempting to pair with B4:F5:00:31:CB:4E [CHG] Device B4:F5:00:31:CB:4E Connected: yes Request confirmation...
  • Page 49 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Connect with the remote Bluetooth Classic/Bluetooth LE device The remote Bluetooth Classic/Bluetooth LE device is not yet in the connected state. Run the following command to set the connected state.
  • Page 50: Advanced Audio Distribution Profile

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.2 Advanced audio distribution profile This section describes the configuration steps for i.MX 8M Quad board to act as an A2DP sink or source. The Pulseaudio and Bluetooth-player packages are used while configuring these profiles.
  • Page 51 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Check the available sink cards root@imx8mqevk:~# pacmd list-sinks | egrep '(index|name):' * index: 0 name: <alsa_output.platform-sound-bt-sco.mono-fallback> index: 1 name: <alsa_output.platform-sound-spdif.stereo-fallback> index: 2 name: <alsa_output.platform-sound-wm8524.stereo-fallback> root@imx8mqevk:~# Select wm8524 as default sink Select wm8524 as default sink to listen to music on the audio jack of the i.MX 8M Quad...
  • Page 52 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Play and pause the audio Use bluetooth-player to play and pause the audio. root@imx8mqevk:~# bluetooth-player [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 53: Configure A2Dp Source

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.2.2 Configure A2DP source Make sure the remote Bluetooth device supports the A2DP sink feature. Use the following steps to configure the i.MX 8M Quad board as an A2DP Source.
  • Page 54 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Copy the sample audio file to i.MX 8M Quad Use the following command to check the available sink cards: root@imx8mqevk:~# pacmd list-sinks | egrep '(index|name):' index: 0 name: <alsa_output.platform-sound-bt-sco.mono-fallback>...
  • Page 55: Hands-Free Profile (Hfp)

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.3 Hands-free profile (HFP) This section introduces the Ofono package used to dial, hang-up and answer telephone calls, and details the configuration for the hands-free profile.
  • Page 56 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 4 - Start pulseaudio on i.MX 8M Quad EVK root@imx8mqevk:~# pulseaudio & Command output: [1] 507 root@imx8mqevk:~# Step 5 - List the available sink devices...
  • Page 57 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 8 - Set external source device as default source root@imx8mqevk:~# pacmd set-default-source <index number of external source device> Step 9 - Enable the audio route root@imx8mqevk:~# pactl load-module module-loopback latency_msec=1 source=alsa_input.platform-sound-bt-sco.mono-fallback sink=<External sink...
  • Page 58 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 12 - Verify the Hands-free Audio Gateway Profile capability of the connected Bluetooth device root@imx8mqevk:~# bluetoothctl [GT-S7560M]# info 04:1B:BA:C7:92:36 Output command example: Device 04:1B:BA:C7:92:36 (public)
  • Page 59 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 14 - Write PCM settings root@imx8mqevk:~# hcitool -i hci0 cmd 0x3F 0x0007 0x00 Command output example: < HCI Command: ogf 0x3f, ocf 0x0007, plen 1 >...
  • Page 60 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 15 - Write PCM sync settings root@imx8mqevk:~# hcitool -i hci0 cmd 0x3F 0x0028 0x03 0x00 0x03 Command output example: < HCI Command: ogf 0x3f, ocf 0x0028, plen 3 03 00 03 >...
  • Page 61 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 16 - Write PCM Link settings root@imx8mqevk:~# hcitool -i hci0 cmd 0x3F 0x0029 0x04 0x00 Command output example: < HCI Command: ogf 0x3f, ocf 0x0029, plen 2 04 00 >...
  • Page 62 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 17 - Write the voice settings Use HCI_Write_Voice_Setting command defined in Bluetooth Core Specifications v5.2 to write the required voice settings. root@imx8mqevk:~# hcitool -i hci0 cmd 0x03 0x0026 0x60 0x00 Command output example: <...
  • Page 63 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Command output example: < HCI Command: ogf 0x3f, ocf 0x006f, plen 6 01 00 08 00 00 00 > HCI Event: 0x0e plen 4 01 6F FC 00...
  • Page 64 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Step 22 - Initialize PCM Refer to Step 19. Step 23 - Use Ofono test script to hang up an active call Ofono hangup-active script uses the AT command AT+CHUP to hang up an active call root@imx8mqevk:/usr/lib/ofono/test# python3 ./hangup-active...
  • Page 65: Object Push Profile

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.4 Object Push Profile This section explains how to send the file to a remote device over Bluetooth. BlueZ Stack provides the obexctl user space utility to send the files to a Bluetooth device.
  • Page 66 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Start Obex Control Use the following commands to start the Obex Control and connect to the remote Bluetooth device paired using Bluetooth Control. root@imx8mqevk:~# obexctl...
  • Page 67: Human Interface Device Profile

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.5 Human Interface Device Profile 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 68: Bluetooth Le Device As Gatt Server

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.6 Bluetooth LE device as GATT server This section shows how to configure the i.MX 8M Quad board as a Bluetooth LE GATT Server using the example of Battery Service registration.
  • Page 69 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Register the Battery Service [bluetooth]# register-application 0000180F-0000-1000-8000-00805f9b34fb [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: 00001200-0000-1000-8000-00805f9b34fb [CHG] Controller 00:50:43:24:34:F7 UUIDs:...
  • Page 70 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Check that the Battery Service was added successfully [bluetooth]# back Menu main: [bluetooth]# show Controller 00:50:43:24:34:F7 (public) Name: imx8mqevk Alias: imx8mqevk Class: 0x002c0000 Powered: yes...
  • Page 71 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Start Bluetooth LE advertising [bluetooth]# advertise on [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 Name: off...
  • Page 72: Bluetooth Le Device As Gatt Client

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.7 Bluetooth LE device as GATT client This section describes the procedure to configure the i.MX 8M Quad as a Bluetooth LE client. It also shows the options to list the attributes available in the Bluetooth LE server and access information.
  • Page 73: Human Interface Device Service

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.8 Human Interface Device Service This section describes the configuration steps to connect the NXP-based Bluetooth LE module with a Bluetooth Low Energy device that supports Human Interface Device Profile.
  • Page 74: Rf Test Mode

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.9 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 Quad EVK.
  • Page 75 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Parameter Length Definition TestScenario Test scenario • 0x01 = receiver test, 0–pattern • 0x02 = receiver test, 1–pattern • 0x03 = receiver test, 1010–pattern • 0x04 = receiver test, PRBS–pattern •...
  • Page 76: Set The Transmit Test Parameters

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.9.1.3 Set the transmit test parameters This command sets the transmit test parameters. An HCI Reset command is required after this test to resume normal Bluetooth operations.
  • Page 77 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Parameter Length Definition PacketType Transmit Packet Type • 0x03 = DM1 • 0x04 = DH1 • 0x0A = DM3 • 0x0B = DH3 • 0x0E = DM5 •...
  • Page 78: Bluetooth Low Energy (Le)

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.9.2 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 79: End Bluetooth Le Test

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 4.9.2.3 End Bluetooth LE test To stop any test which is in progress, use LE Test End command. For more details on the command please refer to Bluetooth Core Specification v5.2.
  • Page 80: Bluetooth Debugging

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Bluetooth debugging This section details the Bluetooth Protocol and Driver Debugging using hcidump, btmon and dmesg logs. 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 Quad EVK and NXP-...
  • Page 81: Capture The Hci Logs Using Btmon

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 5.1.2 Capture the HCI Logs using btmon Follow these steps to capture the HCI logs between the i.MX 8M Quad EVK and NXP- based wireless module using btmon utility.
  • Page 82: Extract The Link Key For Remote Bluetooth Classic/Bluetooth Le Devices

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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@imx8mqevk:~# cat /var/lib/bluetooth/<DUT BD Address>/<Remote BD...
  • Page 83: Bluetooth Driver Debugging

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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 root@imx8mqevk:~# dmesg | grep Bluetooth 0.225403] Bluetooth: Core ver 2.22...
  • Page 84: Contact Information

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK 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 iMX community: community.nxp.com/community/imx UM11490 All information provided in this document is subject to legal disclaimers.
  • Page 85: Acronyms And Abbreviations

    UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Acronyms and abbreviations Table 5. Acronyms and abbreviations Acronym Definition A2DP Advanced audio distribution profile Access point AXIHP Advanced extensible interface high performance Bluetooth device BSSID...
  • Page 86: Legal Information

    NXP Semiconductors products in order to avoid a default of the applications and the products or of the application or use by 8.2 Disclaimers...
  • Page 87 UM11490 NXP Semiconductors Feature Configuration Guide for NXP-based Wireless Modules on i.MX 8M Quad EVK Tables Tab. 1. References ............3 Tab. 4. Hands-free profile AT commands ....55 Tab. 2. Data rate parameter ........36 Tab. 5. Acronyms and abbreviations ......85 Tab.
  • Page 88: Table Of Contents

    'Legal information'. © NXP B.V. 2021. All rights reserved. For more information, please visit: http://www.nxp.com For sales office addresses, please send an email to: salesaddresses@nxp.com Date of release: 29 January 2021 Document identifier: UM11490...

Table of Contents

Save PDF