background image

NXP Semiconductors

UM11483

Getting Started with NXP-based Wireless Modules on i.MX 8M Quad EVK Running Linux OS

Figure 9. AzureWave AW-CM358-uSD module header positions

UM11483

All information provided in this document is subject to legal disclaimers.

© NXP B.V. 2021. All rights reserved.

User manual

Rev. 2 — 21 January 2021

14 / 41

Summary of Contents for UM11483

Page 1: ... January 2021 User manual Document information Information Content Keywords i MX 8M Quad Evaluation Kit EVK 88W8987 based wireless module 88W8997 based wireless module Abstract Details the bring up of Wi Fi and Bluetooth on NXP based wirelesss modules connected with i MX 8M Quad EVK running on Linux OS ...

Page 2: ...01015 Initial version v 2 20210121 Modifications Extended the scope to 88W8987 and 88W8997 based wireless modules Updated the document title and overall document structure Revision history UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 2 41 ...

Page 3: ...ed description of the i MX 8M Quad BSP nor how to generate an image and rootfs as these are covered in i MX Yocto Project User s Guide 1 2 References Reference type Description Datasheet NXP DS 88W8987 2 4 5 GHz Dual Band 1x1 Wi Fi 5 and Bluetooth 5 Solution link Datasheet AzureWave AW CM358SM IEEE 802 11a b g n ac WLAN with Bluetooth 5 Combo Stamp LGA Module link Datasheet AzureWave AW CM276MA PU...

Page 4: ...en source Linux kernel to the i MX 8M Quad hardware The i MX 8M Quad BSP is based on the latest long term stable LTS version of the Linux kernel which is enhanced with the features provided by NXP and can be accommodate customized Linux kernel configurations 2 2 i MX 8M Quad evaluation board The i MX 8M Quad evaluation board is based on the NXP i MX 8M Quad application processor The i MX 8M Quad p...

Page 5: ...oth PCIe USB UART I2C and I2S 3 GB 32 bit LPDDR4 with 1 6 GHz clock USB3 0 Type A connector eMMC 5 0 16 GB HDMI2 0a Type A connector 32 MB Octal SPI NOR flash 1 Gbit s Ethernet Micro SD card connector Mini SAS MIPI DSI connector USB3 0 Type C connector with PD support 2x mini SAS MIPI CSI connectors for Camera USB to serial converter for debug Infrared receiver LEDs for power indication and genera...

Page 6: ...luation board interfaces Figure 2 shows the front view of i MX 8M Quad evaluation board with pointers to the interfaces Figure 2 i MX 8M Quad evaluation board interfaces Front view UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 6 41 ...

Page 7: ...OS Figure 3 shows the back view of i MX 8M Quad evaluation board with pointers to the interfaces Figure 3 i MX 8M Quad evaluation board interfaces Back view UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 7 41 ...

Page 8: ...ode Figure 4 Boot device switch and boot mode switch on i MX 8M Quad evaluation board Table 3 shows the settings of the boot mode switch D1 D2 Boot mode 0 1 Serial downloader 1 0 Internal boot Table 3 Boot mode switch settings Table 4 shows the settings of the boot device switch to boot from eMMC D1 D2 D3 D4 OFF OFF ON OFF Table 4 Switch settings to boot from eMMC UM11483 All information provided ...

Page 9: ... and 88W8997 product overview on NXP website 3 1 Interface with i MX 8M Quad application processor Figure 5 shows the high level block diagram of i MX 8M Quad application processor with the Wi Fi SDIO PCIe and Bluetooth UART hardware interfaces used to communicate with NXP based wireless module Figure 5 Interface between the i MX 8M Quad application processor and NXP based wireless module UM11483 ...

Page 10: ...r and the network stack from the cfg80211 subsystem in the kernel NXP kernel driver includes a set of controls and configurations to communicate with the user space through one of the following interfaces Input output control IOCTL Wireless Extension Wext CFG80211 The IOCTL provides a path to the user space applications iwconfig and iwpriv whereas cfg80211 interface provides a different path to th...

Page 11: ... NXP based wireless module requires a kernel driver loaded on the i MX 8M Quad host system and a firmware running on NXP SoC The Wi Fi driver loads the combo firmware The hci_uart driver provides the HCI interface between the firmware and user application Figure 7 Bluetooth layer interface UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights res...

Page 12: ...ransfer modes Special interrupt register for information exchange 3 4 1 Recommended antenna part MAG LAYERS MSA 4008 25GC1 A2 3 4 2 Supported I O signal level SDIO 3 0 2 0 supports 1 8V for I O signal 3 4 3 Supported RF standard I O voltage level Wi Fi Bluetooth AW CM358 uSD 1x1 Wi Fi 5 2 4 5 GHz 5 0 Table 5 Supported RF standard 3 4 4 Supported Wi Fi features AW CM358 uSD and AW CM358MA modules s...

Page 13: ...wer supply This section provides the jumper settings to configure the module with 1 8V SDIO voltage level for Wi Fi Connect the jumper J2 between the 1 and 2 header pins to select the SDIO module power source and connect the jumper J4 between the 1 and 2 header pins for 1 8V SDIO voltage as shown in Figure 9 UM11483 All information provided in this document is subject to legal disclaimers NXP B V ...

Page 14: ...reless Modules on i MX 8M Quad EVK Running Linux OS Figure 9 AzureWave AW CM358 uSD module header positions UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 14 41 ...

Page 15: ...8M Quad board 3632 632050 mmc1 new ultra high speed SDR104 SDIO card at address 0001 Connect the antenna Use a Micro USB to USB cable to connect i MX 8M Quad EVK to the host computer running on Linux OS Figure 10 AzureWave AZ CM358 uSD module and i MX 8M Quad EVK setup UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev...

Page 16: ...tor board that features SDIO 3 0 standard On chip memory used for CIS 1 bit SDIO and 4 bit SDIO transfer modes A special interrupt register for information exchange 3 5 1 Recommended antenna part MAG LAYERS MSA 4008 25GC1 A2 3 5 2 Supported RF standards Part number Wi Fi Bluetooth AW CM358MA 1x1 Wi Fi 5 2 4 5GHz 5 0 Table 6 AW CM358MA supported RF standards 3 5 3 Supported Wi Fi features Refer to ...

Page 17: ... Modules on i MX 8M Quad EVK Running Linux OS 3 5 5 AW CM358MA module view Figure 11 AzureWave AW CM358MA module UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 17 41 ...

Page 18: ...ons reroute the SDIO interface from the SD card connector to the M 2 connector A software change is also required to enable the rerouted SDIO interface Please refer to Section 4 5 3 Enabling SDIO on M 2 AW CM358MA module only to enable the SDIO interface on the M 2 connector using a DTB file Note that the SDIO on the Micro SD card slot will be disabled after the rework Silkscreen of PCBA SCH 38820...

Page 19: ... 12 MicroSD Card J1601 resistors Install the following 0Ω 0402 resistors R1429 R1430 R1431 R1432 R1433 R1434 R1435 and R1436 M 2 J1401 Figure 13 M 2 J1401 resistors UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 19 41 ...

Page 20: ...ith iMX 8M Quad Connect AW CM358MA module into the M 2 connector of the i MX 8M Quad board and screw Figure 14 Azurewave AW CM358MA module plugged into i MX 8M Quad bottom side M 2 connector UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 20 41 ...

Page 21: ...antenna and use a Micro USB to USB cable to connect i MX 8M Quad EVK to the host computer running on Linux OS Figure 15 Azurewave AW CM358MA module and i MX 8M Quad setup UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 21 41 ...

Page 22: ...odule top and bottom views 3 6 1 Recommended antenna part MAG LAYERS MSA 4008 25GC1 A2 3 6 2 Supported RF standards Part number Wi Fi Bluetooth AW CM276MA 2x2 Wi Fi 5 2 4 GHz 5 GHz 5 0 Table 7 AW CM276MA supported RF standards 3 6 3 Supported Wi Fi features Refer to AzureWave AW CM276MA PUR Datasheet 3 6 4 Supported Bluetooth features Refer to AzureWave AW CM276MA PUR Datasheet UM11483 All informa...

Page 23: ...fs for the specific Linux image Read more in section 4 1 of i MX Linux User s Guide document number IMXLUG 4 1 Using the pre built image This section describes the steps to prepare eMMC to boot up an i MX 8M Quad EVK using a Linux host machine The pre built image can be downloaded from the page Embedded Linux for I MX Application Processors on NXP website Accept NXP software license agreement when...

Page 24: ...imx8mq evk pcie1 m2 dtb imx8mq evk pcie ep dtb imx8mq evk pdm dtb imx8mq evk root dtb imx8mq evk rpmsg dtb imx8mq evk usdhc2 m2 dtb imx8mq evk usd wifi dtb imx boot imx8mqevk sd bin flash_dp_evk imx boot imx8mqevk sd bin flash_evk imx boot imx8mqevk sd bin flash_evk_no_hdmi imx image full imx8mqevk manifest imx image full imx8mqevk tar bz2 imx image full imx8mqevk wic imx image multimedia imx8mqev...

Page 25: ...nfiguration tool uses the default version of grep that is on your build machine 4 2 2 Setting up Repo utility Repo is a tool built on top of Git that makes it easier to manage projects that contain multiple repositories which do not need to be on the same server Follow these steps to install the repo utility Create a bin folder in the home directory ubuntu ubuntu desktop mkdir bin this step may no...

Page 26: ...sp ubuntu ubuntu desktop cd imx yocto bsp ubuntu ubuntu desktop repo init u https source codeaurora org external imx imx manifest b imx linux zeus m imx 5 4 47 2 2 0 xml Refer to i MX Release Manifest for the list of all manifest files supported in this release ubuntu ubuntu desktop repo sync When this process is completed the source code is checked out into the directory imx yocto bsp sources Use...

Page 27: ...f inside each build folder and the EULA acceptance query is no longer displayed for that build folder 4 3 2 Command to build an image The Yocto Project build uses the bitbake command For example bitbake component builds the named component Each component build has multiple tasks such as fetching configuring compiling packaging and deploying to the target rootfs The bitbake image build gathers all ...

Page 28: ...mqevk wic Follow these instructions to use UUU for i MX 8M Quad Connect a USB cable from a computer to the USB OTG TYPE C port on the board Connect a USB cable from the OTG to UART port to the computer for console output Open a Terminal emulator program for example minicom Set the boot pin to serial download mode refer to Section 2 4 i MX 8M Quad switch settings UUU usage ubuntu ubuntu desktop sud...

Page 29: ...oot There is no password 4 5 3 Enabling SDIO on M 2 AW CM358MA module only The command below sets as default the DTB file that enables the SDIO interface on the M 2 connector and reboots the EVK to load the updated DTB file root imx8mqevk mv run media mmcblk0p1 imx8mq evk usdhc2 m2 dtb run media mmcblk0p1 imx8mq evk dtb root imx8mqevk reboot Note This section only applies to AW CM358MA module base...

Page 30: ...ess module Use the nano editor included in the pre built image to edit and verify the module parameters in wifi_mod_para conf configuration file root imx8mqevk nano lib firmware nxp wifi_mod_para conf Content of the configuration file SD8987 cfg80211_wext 0xf wfd_name p2p max_vir_bss 1 cal_data_cfg none drv_mode 7 ps_mode 2 auto_ds 2 fw_name nxp sdiouart8987_combo_v0 bin Load the modules in the ke...

Page 31: ..._v0 bin 2896 225747 SDIO max_segs 128 max_seg_size 65535 2896 230505 rx_work 1 cpu_num 4 2896 233724 Attach mlan adapter operations card_type is 0x105 2896 240142 wlan Enable TX SG mode 2896 243666 wlan Enable RX SG mode 2896 251307 Request firmware nxp sdiouart8987_combo_v0 bin 2896 667066 Wlan FW download over firmwarelen 526996 downloaded 526996 2897 601246 WLAN FW is active 2897 604233 on_time...

Page 32: ...rors 0 dropped 0 overruns 0 carrier 0 collisions 0 txqueuelen 1000 RX bytes 0 0 0 B TX bytes 0 0 0 B p2p0 Link encap Ethernet HWaddr 02 50 43 24 83 c4 BROADCAST MULTICAST MTU 1500 Metric 1 RX packets 0 errors 0 dropped 0 overruns 0 frame 0 TX packets 0 errors 0 dropped 0 overruns 0 carrier 0 collisions 0 txqueuelen 1000 RX bytes 0 0 0 B TX bytes 0 0 0 B uap0 Link encap Ethernet HWaddr 00 50 43 24 ...

Page 33: ...ug messages in the command output 139 999861 wlan Loading MWLAN driver 140 004586 wlan_pcie 0000 01 00 0 enabling device 0000 0002 140 010904 Attach moal handle ops card interface type 0x204 140 016763 No module param cfg file specified 140 021239 rx_work 1 cpu_num 4 140 024418 Attach mlan adapter operations card_type is 0x204 140 034659 Request firmware mrvl pcieuart8997_combo_v4 bin 140 993340 F...

Page 34: ...kets 0 errors 0 dropped 0 overruns 0 frame 0 TX packets 0 errors 0 dropped 0 overruns 0 carrier 0 collisions 0 txqueuelen 1000 RX bytes 0 0 0 B TX bytes 0 0 0 B p2p0 Link encap Ethernet HWaddr 72 66 55 9b 3a 95 BROADCAST MULTICAST MTU 1500 Metric 1 RX packets 0 errors 0 dropped 0 overruns 0 frame 0 TX packets 0 errors 0 dropped 0 overruns 0 carrier 0 collisions 0 txqueuelen 1000 RX bytes 0 0 0 B T...

Page 35: ... frame 0 TX packets 0 errors 0 dropped 0 overruns 0 carrier 0 collisions 0 txqueuelen 1000 RX bytes 0 0 0 B TX bytes 0 0 0 B Invoke the command to initialize the uap0 interface root imx8mqevk ifconfig uap0 up root imx8mqevk ifconfig uap0 uap0 Link encap Ethernet HWaddr 00 50 43 24 84 c4 UP BROADCAST MULTICAST MTU 1500 Metric 1 RX packets 0 errors 0 dropped 0 overruns 0 frame 0 TX packets 0 errors ...

Page 36: ...Setting TTY to N_HCI line discipline Device setup complete root imx8mqevk hciconfig hci0 up root imx8mqevk hciconfig hci0 Type Primary Bus UART BD Address 00 50 43 24 83 B7 ACL MTU 1021 7 SCO MTU 120 6 UP RUNNING RX bytes 1451 acl 0 sco 0 events 84 errors 0 TX bytes 789 acl 0 sco 0 commands 84 errors 0 Invoke the HCI command to change the speed where device is dev ttymxc2 root imx8mqevk hcitool i ...

Page 37: ...following links for more product details queries and support Home page www nxp com Web support nxp com support NXP community community nxp com iMX community community nxp com community imx UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 37 41 ...

Page 38: ... point BSP Board support package BT Bluetooth DTB Device tree blob EVK Evaluation kit FW Firmware STA Station uSD Micro SD WLAN Wireless local area network WPA Wi Fi protected access Table 8 Acronyms and abbreviations UM11483 All information provided in this document is subject to legal disclaimers NXP B V 2021 All rights reserved User manual Rev 2 21 January 2021 38 41 ...

Page 39: ...tions or customer product design It is customer s sole responsibility to determine whether the NXP Semiconductors product is suitable and fit for the customer s applications and products planned as well as for the planned application and use of customer s third party customer s Customers should provide appropriate design and operating safeguards to minimize the risks associated with their applicat...

Page 40: ...X 8M Quad evaluation board 8 Fig 5 Interface between the i MX 8M Quad application processor and NXP based wireless module 9 Fig 6 Wi Fi layer interface 10 Fig 7 Bluetooth layer interface 11 Fig 8 AzureWave AW CM358 uSD module interface 13 Fig 9 AzureWave AW CM358 uSD module header positions 14 Fig 10 AzureWave AZ CM358 uSD module and i MX 8M Quad EVK setup 15 Fig 11 AzureWave AW CM358MA module 17 ...

Page 41: ... 20 3 6 88W8997 based AzureWave AW CM276MA module 22 3 6 1 Recommended antenna part 22 3 6 2 Supported RF standards 22 3 6 3 Supported Wi Fi features 22 3 6 4 Supported Bluetooth features 22 4 i MX 8M EVK Linux image setup 23 4 1 Using the pre built image 23 4 2 Setting up the host 25 4 2 1 Installing the host packages 25 4 2 2 Setting up Repo utility 25 4 2 3 Setting up Yocto project 26 4 3 Build...

Reviews: