This is the documentation for the latest (main) development branch of mcuxpresso sdk. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

Middleware

RTOS

The MCUXpresso SDK is integrated with the FreeRTOS OS.

Parent topic:Middleware

Wireless connectivity middleware summary

Bluetooth LE host stack and applications

The Bluetooth LE Host Stack component provides an implementation for a Bluetooth 5.3 mandatory and some optional, proprietary, and experimental features. The Bluetooth LE Host Stack component provides application examples, services, and profiles.

Main features supported:

  • Automotive Compliance

  • MISRA Compliance

  • HIS CCM <= 20

  • Advanced Secure Mode

  • Enhanced ATT

  • GATT Caching

  • GCC Libraries

  • IAR Libraries

  • Bluetooth LE Peripheral Libraries

  • Bluetooth LE Central Libraries

  • Bluetooth LE Full Host Features Libraries

  • Bluetooth LE Host Optional Features Libraries

  • Bluetooth LE Host Mandatory Features Libraries

  • BareMetal and FreeRTOS Support

  • Full Privacy Support

  • NCP Mode - FSCI Application

  • Enhanced Notifications

  • Dynamic Database

  • OTA Support - Sample Applications

  • Decision based Advertising Filtering - Experimental feature

  • Advertising Coding Selection - Experimental feature

  • Channel Sounding - Experimental feature with controlled access (contact your NXP representative for access)

  • Bluetooth LE Controller main and experimental features and capabilities described below are supported by the Bluetooth LE Host.

    Note: For evaluating experimental features, replace the Bluetooth LE Host default example projects libraries with the libraries from the SDK folder ..\middleware\wireless\bluetooth\host\lib_exp and enable the features in the application. The Radio Subsystem (NBU) Firmware with experimental features is required.

Parent topic:Wireless connectivity middleware summary

Bluetooth LE controller

  • Main features supported:

    • Peripheral Role

    • Central Role

    • Multiple PHYs (1 Mbps, 2 Mbps, Coded PHY)

    • Asymmetric Connections

    • Public/Random/Static Addresses

    • Network/Device Privacy Modes

    • Extended Advertising

    • Extended Scanning

    • Passive/Active Scanning

    • LE Encryption

    • LE Ping Procedure

    • HCI Test Interface

    • UART Test Interface

    • Randomized Advertising Channel Indexing

    • Sleep Clock Accuracy Update - Mechanism

    • ADI Field in Scan Response Data

    • HCI Support for Debug Keys in LE - Secure Connections

  • Main capabilities supported:

    • Simultaneous Scanning 1 Mbps and Long Range

    • Scanning and Advertising in parallel

    • 24 connections as central role

    • 24 connections as peripheral role

    • Any combination of central and peripheral roles (24 connections maximum)

    • Eight connections with 7.5 ms connection interval

    • Two advertising sets in parallel

    • 26 Accept List entries

    • 36 Resolvable Private Address (RPA) entries

    • Up to six Chain Packets per Extended Advertising set

    • Enhanced Notification on end of - Scanning/Advertising/Connection events

    • Connection event counter associated to Bluetooth LE packet reception

    • Timestamp associated to Bluetooth LE packet reception

    • RF channel info associated to Bluetooth LE packet reception

    • NXP proprietary Bluetooth LE Handover feature

    • Support experimental features Advertising Coding Selection and Decision Based Advertising Filtering (DBAF). See Note below.

Note: Project configurations that require usage of the Bluetooth LE Controller including all Bluetooth LE examples and Matter over Thread configurations require the Radio Subsystem (NBU) Firmware to be re-programmed with the firmware provided in the SDK under middleware\wireless\ble_controller\bin (Bluetooth LE only) or middleware\wireless\ieee-802.15.4\bin\k32w1 (Bluetooth LE and IEEE 802.15.4 multiprotocol targeting Matter). For NBU programming steps, see the EVK Quick Start Guide and Secure Provisioning SDK (SPSDK) documentation.

Note: Project configuration enabling Experimental features requires the Radio Subsystem (NBU) Firmware to be reprogrammed with the firmware provided in the SDK under \middleware\wireless\ble_controller\bin\experimental\. For NBU programming steps, see the EVK Quick Start Guide and Secure Provisioning SDK (SPSDK) documentation.

Parent topic:Wireless connectivity middleware summary

IEEE 802.15.4 features

The IEEE 802.15.4 software includes:

  • The IEEE 802.15.4 PHY supporting Thread 1.3.x and Thread 1.4.0 with OpenThread, and Matter over Thread

  • IEEE 802.15.4 MAC supporting Zigbee

  • Simple MAC (SMAC)

  • Low-level IEEE 802.15.4 radio mode test software

  • Multiprotocol support (Bluetooth LE and IEEE 802.15.4)

  • Experimental support for dual PAN mode (two IEEE 802.15.4 networks on a single channel or two channels)

The IEEE 802.15.4 PHY and MAC software implementation is based on IEEE Standard 802.15.4-2015.

Parent topic:Wireless connectivity middleware summary

XCVR

The XCVR component provides a base Transceiver Driver for the 2.4 GHz narrowband radio.

Parent topic:Wireless connectivity middleware summary

Low-power reference design applications (central and peripheral)

The Low-Power Reference Design Applications provide reference design source code and projects showcasing how to implement optimized low power functionality based on a Bluetooth LE application. For additional details, see the README.md in the boards\frdmmcxw7x\wireless_examples\reference_design\bluetooth folder.

Parent topic:Wireless connectivity middleware summary

Connectivity framework

The Connectivity Framework is a software component that provides hardware abstraction modules to the upper layer connectivity stacks and components. It also provides a list of services and APIs, such as, Low power, Over the Air (OTA) Firmware update, File System, Security, Sensors, Serial Connectivity Interface (FSCI), and others. The Connectivity Framework modules are located in the middleware\wireless\framework SDK folder.

Parent topic:Wireless connectivity middleware summary

Zigbee

This release of the NXP Zigbee stack supports the following generic Zigbee protocol features:

  • Zigbee Pro R22

  • Zigbee 3.0

  • Zigbee Green Power – Proxy and Combo

  • Base Device Behavior (BDB) 3.1

  • Zigbee Cluster Library (ZCL) 8

The SDK includes the following sample Zigbee 3.0 applications that allow the end user to get quickly up to speed with the development of Zigbee applications on NXP platforms:

  • Zigbee Coordinator

  • Zigbee Router

  • Zigbee End Device

Parent topic:Wireless connectivity middleware summary

Matter and OpenThread

This SDK version provides the base support for Matter 1.x over Thread and OpenThread integration.

To begin development with Matter over Thread, go to https://github.com/NXP/matter and navigate to examples, such as, examples/lighting-app/nxp/.

To begin development with OpenThread, go to https://github.com/NXP/ot-nxp.

Parent topic:Wireless connectivity middleware summary

Parent topic:Middleware

Wireless connectivity middleware overview

Component versions:

Wireless connectivity component

Version

middleware/​wireless/​bluetooth

1.10.3

middleware/​wireless/​ble_​controller

1.9.18.0

middleware/wireless/ieee-802.15.4

1.0.21b

middleware/​wireless/​xcvr

​2.​1.4

middleware/​wireless/​genfsk

4.0.22

middleware/wireless/framework

7.0.0b

middleware/wireless/zigbee

1.0.16b

The following connectivity-supporting documentation is included with this release:

  • Bluetooth Low Energy Quick Start Guide

  • Bluetooth Low Energy Demo Applications User’s Guide

  • Bluetooth Low Energy Application Developer’s Guide

  • Bluetooth Low Energy Host Stack API Reference Manual

  • Bluetooth Low Energy Host Stack FSCI Application Programming

  • Bluetooth Low Energy Host Stack FSCI Reference Manual

  • Generic FSK Link Layer Quick Start Guide

  • Generic FSK Link Layer API Reference Manual

  • IEEE 802.15.4 Connectivity Test Application Getting Started Guide

  • IEEE 802.15.4 Connectivity Test Application Command Line Interface User Guide

  • Zigbee Demo Applications User Guide

  • ZigBee 3.0 Stack User Guide

  • ZigBee Cluster Library User Guide

  • ZigBee 3.0 Devices User Guide

  • Zigbee Green Power User Guide

  • Zigbee Core Utilities User Guide

  • Connectivity Framework Reference Manual

  • Connectivity Framework API Documentation

  • Low Power Connectivity Reference Design User’s Guide

Parent topic:Middleware

Other middleware

Optional middleware packages can be included in the release based on the user selection. See <install_dir>/SW-Content-Register.txt for a list of components and associated licenses.

Parent topic:Middleware

Parent topic:MCUXpresso SDK release package