Rapid IoT

The Rapid IoT Prototyping Kit is a development kit from NXP Semiconductors based on the Kinetis K64F Core 32-bit microcontroller for application processing, and features a Kinetis KW41Z wireless controller for BLE, Thread, and ZigBee connectivity. The Rapid IoT comes standard with a variety of onboard peripherals, featuring sensors for temperature and humidity, air quality, ambient light, barometric pressure, inertia, and touch control.

The Rapid IoT also offers the ability to expand its peripheral controls using the MikroElektronika Hexiwear Docking Station, which also includes slots to connect up to three Click boards at a time.

Project Specifics

Rapid IoT projects start with the following sensor elements imported from the Element Library:

AMSCCS811Element icon for the element library

AMS CCS811

AMSENS210Element icon for the element library

AMS ENS210

AMSTSL2572Element icon for the element library

AMS TSL2572

NXPFXAS21002Element icon for the element library

NXP FXAS21002

NXPFXOS8700Element icon for the element library

NXP FXOS8700

NXPMPL3115Element icon for the element library

NXP MPL3115

SemtechSX9500Element icon for the element library

Semtech SX9500

The Rapid IoT also includes a collection of elements exclusive to its project type:

BacklightElement icon for the element library

Backlight

BuzzerElement icon for the element library

Buzzer

DisplayPageControllerElement icon for the element library

Display Page Controller

LabeledIconPageElement icon for the element library

Labeled Icon Page

RGBLEDElement icon for the element library

RGB LED

SelectionPageElement icon for the element library

Selection Page

SystemStatusPageElement icon for the element library

System Status Page

TextIconPageElement icon for the element library

Text Icon Page

TextPageElement icon for the element library

Text Page

UserButtonsElement icon for the element library

User Buttons

VolansysThreadElement icon for the element library

Volansys Thread

Hardware Specifics

Some devices may have limitations or design restrictions that cause unexpected behavior when used with Atmosphere. Specific information and details pertaining to the Rapid IoT and its performance on Atmosphere is noted below.

  • UART2 and UART3 are not accessible
  • The KW41Z is limited to a maximum of 10 characteristics per service

Default Pin Mapping

Atmosphere configures each peripheral to a default pin for every supported device, based on ideal pairing of pins and their usage. The default pin configuration is set for convenience and enables each peripheral to work naturally without needing to be modified.

All pins can be used as general purpose input/output (GPIO) unless otherwise specified.

Rapid IoT projects start with the following pin configuration:

Pin Table

Pin Description Notes
MB1_PWM Docking station slot 1 PWM Pin Maps to PTA10
MB1_RST Docking station slot 1 RST Pin Maps to PTB11
MB1_INT Docking station slot 1 INT Pin Maps to PTB4
MB1_CS Docking station slot 1 CS Pin Maps to PTC4
MB1_SCK Docking station slot 1 SCK Pin Maps to PTC5
MB1_MOSI Docking station slot 1 MOSI Pin Maps to PTC6
MB1_SCL Docking station slot 1 SCL Pin Maps to PTB2
MB1_SDA Docking station slot 1 SDA Pin Maps to PTB3
MB1_RX Docking station slot 1 UART RX Pin Maps to PTB16
MB1_TX Docking station slot 1 UART TX Pin Maps to PTB17
MB1_AN Docking station slot 1 Analog Pin Cannot be used as GPIO, only as an analog pin
MB2_PWM Docking station slot 2 PWM Pin Maps to PTA11
MB2_RST Docking station slot 2 RST Pin Maps to PTA26
MB2_INT Docking station slot 2 INT Pin Maps to PTB8
MB2_CS Docking station slot 2 CS Pin Maps to PTC3
MB2_SCK Docking station slot 2 SCK Pin Maps to PTC5
MB2_MOSI Docking station slot 2 MOSI Pin Maps to PTC6
MB2_SCL Docking station slot 2 SCL Pin Maps to PTB2
MB2_SDA Docking station slot 2 SDA Pin Maps to PTB3
MB2_RX Docking station slot 2 UART RX Pin Maps to PTD2
MB2_TX Docking station slot 2 UART TX Pin Maps to PTD3
MB2_AN Docking station slot 2 Analog Pin Cannot be used as GPIO, only as an analog pin
MB3_PWM Docking station slot 3 PWM Pin Maps to PTB1
MB3_RST Docking station slot 3 RST Pin Maps to PTB10
MB3_INT Docking station slot 3 INT Pin Maps to PTB7
MB3_CS Docking station slot 3 CS Pin Maps to PTC2
MB3_SCK Docking station slot 3 SCK Pin Maps to PTC5
MB3_MOSI Docking station slot 3 MOSI Pin Maps to PTC6
MB3_SCL Docking station slot 3 SCL Pin Maps to PTB2
MB3_SDA Docking station slot 3 SDA Pin Maps to PTB3
MB3_RX Docking station slot 3 UART RX Pin Maps to PTC16
MB3_TX Docking station slot 3 UART TX Pin Maps to PTC17
MB3_AN Docking station slot 3 Analog Pin Maps to PTB6

The default pin for any peripheral can be changed within an element's properties, from an element that references that particular peripheral.

Internal K64 Pins

All internal pins can be accessed using the following nomenclature: PT[PORT][PIN]. For example, port A pin 12 is referred to as PTA12.

For more detailed information on Rapid IoT pin information, download the Rapid IoT Raw Pin Mapping file in the Resources section of this page.

Peripherals

Below is information regarding the Rapid IoT’s exposed peripherals.

I2C

I2C1 (Docking Station)

This I2C bus is exposed on the docking station and is not used internally. All three slots on the docking station are connected to this I2C bus.

I2C2 (Internal Sensors)

This I2C bus is used to communicate with the internal sensors of the Rapid IoT. It is not exposed on the docking station.

SPI

SPI1 (Docking Station)

This SPI bus is exposed on the docking station and is not used internally. All three slots on the docking station are connected to this SPI bus.

UART

UART1 (USB Debug Console)

This UART is exposed via the micro-USB connector on the Docking Station.

UART4 (Docking Station Slot 3)

This UART is exposed via the MB3_TX and MB3_RX pins on Docking Station slot three.

ADC

MB1_AN, MB2_AN, and MB3_AN can all be used as analog inputs. The input range is from 0 to 3.3v.

PWM

MB1_PWM, MB2_PWM, and MB3_PWM can all be used as PWM outputs.

Programming Method

Programming the Rapid IoT involves downloading its project firmware from Atmosphere Studio and directly transferring it to the device over USB.

Setup Configuration

Prior to programming a Rapid IoT, ensure you have the following setup configuration:

  • The device is connected to the computer via USB.
  • The project to be programmed has been compiled.
  • The Rapid IoT is in programming mode.

Rapid IoT Programming Mode

To put the Rapid IoT into programming mode, perform the following steps:

  1. Connect the Rapid IoT to the computer via USB.
  2. Simultaneously hold the top-left and bottom-right side buttons for five seconds until the screen goes black. Continue holding the buttons while the screen goes black.
  3. The green LED will turn on and start blinking, indicating the device is now in programming mode. The side buttons can be released. While in programming mode, the Rapid IoT displays as a mass storage device on your computer.

Programming Instructions

With setup complete, you can program the Rapid IoT:

  1. From Atmosphere Studio’s Embedded tab, click the Program Firmware button from the tab’s toolbar. This downloads a .bin file containing the project’s compiled firmware.
  2. Locate the downloaded file on your computer, and move it into the Rapid IoT mass storage device. This initiates programming of the Rapid IoT, which is represented by a series of blinking lights on the device.

When the lights stop blinking, programming is complete and the Rapid IoT is programmed with the project’s embedded firmware. The Rapid IoT will reboot itself and no longer display as a mass storage device, and upon startup the project is loaded on the device.

Guides and Tutorials

Get started using the Rapid IoT with Atmosphere by walking through the following guides:

Rapid IoT Guides
Getting Started with Rapid IoT
NXP Display Elements Guide
Rapid IoT Display Page Guide

Demo Projects

Atmosphere includes a variety of Rapid IoT demo projects for users of all levels. Check them out by clicking the demo’s name to open the project in Atmosphere.

Name Description
Blinking an LED Demo Set the device’s onboard LED to different colors over time by setting a regular interval to change the color.
Building Monitor Demo A complete demo that reads a number of smart building sensors, including temperature, humidity, pressure, ambient light, and air quality. Also demonstrates basic BLE characteristic writing and reading and cloud storage.
Comparison Element Demo Learn how to setup the comparison element that performs a simple value comparison. When the accelerometer’s X value is greater than zero, the LED lights up blue. Otherwise, the LED lights up red.
Control LED over BLE Demo Control the device’s onboard LED by pressing a button in the app to toggle the color over BLE.
Data Type Conversion Element Demo Learn how to use the data type conversion element with a demo that converts a floating point temperature reading to an integer before displaying on the device’s screen.
Debug Print Demo Learn how to use the debug print element with a simple demo that prints temperature data on the device’s UART console.
Dual H-Bridge Click Demo Use the Dual H-bridge Click board with the Rapid IoT to interact with the board’s motor. With the click board inserted into slot three of the Rapid IoT docking station, press the kit’s top-right button to start the motor and the bottom-right button to stop it.
IrThermo Click Demo Use the IrThermo Click board with the Rapid IoT to read temperature and display it on the device’s display. This demo runs on I2C0 and expects the IrThermo Click to be inserted into slot one of the Rapid IoT docking station.
LED 8x8 Click Demo Use the 8x8 Click board with the Rapid IoT to display a marquee. With the click board inserted into slot three of the Rapid IoT docking station, temperature is read every 30 seconds and displayed as a marquee on the click board.
Mathematical Operation Element Demo Learn how to use the operation element with a demo that converts a temperature reading from the ENS210 sensor from Celsius to Fahrenheit.
Motion Click Demo Use the Motion Click board with the Rapid IoT to detect motion events. With the click board inserted into slot three of the Rapid IoT docking station, whenever motion is detected, the device will beep.
NFC Click Demo Use the NFC Click board with the Rapid IoT to read text, URL, and MIME type records. If the tag contains a MIME record with type “app/mycustomapp” and a hex RGB value (e.g. 0xFF0000), the LED is set to that color.
NFC Element Demo Learn how to use the NFC elements across Embedded View and Application View. This demo writes temperature and humidity values to two different types of NDEF records, which the app then reads the records and displays them when NFC tags are tapped to the device.
Nano GPS Click Demo Use the Nano GPS Click board with the Rapid IoT to geolocate. With the click board inserted into slot three of the Rapid IoT docking station, the demo displays latitude and longitude on the device’s display once the GPS receives a lock. Note that the Nano GPS Click may take a several minutes to lock to a position if used indoors.
Out-of-Box Demo A complete demo that showcases the range of capabilities of the Rapid IoT, including reading each of the kit’s onboard sensors, and demonstrating BLE and Thread support.
Relay Click Demo Use the Relay Click board with the Rapid IoT to toggle relays. With the click board inserted into slot one of the Rapid IoT docking station, press the kit’s top-right button to toggle relay one and the bottom-right button to toggle relay two.
Sigfox Click Demo Use the Sigfox Click board with the Rapid IoT to send data over the Sigfox network. With the click board inserted into slot three of the Rapid IoT docking station, temperature data is sent every five minutes. In the project, adjust the Network Standard property of the Sigfox element depending on your location. If using the Sigfox Network Emulator, set the element’s Public Key to “true.”
Variable Element Demo Learn how to use the variable element to display set values. In this demo, the temperature is read from the ENS210 sensor every second and sent over BLE, then every 10 seconds the stored temperature value is read and displayed on the device’s display.
Weather Station Demo A complete demo that reads a number of sensors for weather applications, including temperature, humidity, pressure, ambient light, and air quality. Also demonstrates basic BLE characteristic writing and reading and cloud storage.

Videos

The Atmosphere video library contains the following videos on the Rapid IoT:

Resources

The following additional resources and downloadable files are available for the Rapid IoT: