Mbed OS and Pelion Device Management example for FRDM-K64F and FRDM-K66F boards

Dependencies:   FXAS21002 FXOS8700Q

This example is known to work great on the following platforms:

  • FRDM-K64F - onboard Ethernet and onboard SD card holder.
  • FRDM-K66F - onboard Ethernet and onboard SD card holder.

Follow the Quick-Start instructions: https://cloud.mbed.com/quick-start

FRDM-K64F FRDM-K66F

Example functionality

This example showcases the following device functionality:

  • Read onboard FXOS8700Q accelerometer and magnetometer, and report the values as Pelion LWM2M resources (see image below).
  • (FRDM-K66F only) Read onboard FXAS21002 gyroscope and report the values as Pelion LWM2M resources.
  • On user button click, increment Pelion LWM2M button resource.
  • Allow the user to change the state of the board LED from Pelion LWM2M led_state resource and PUT request.

/media/uploads/screamer/pelion_st_humidity_reading.png?v=2

Use this example with Mbed CLI

1. Import the application into your desktop:

mbed import https://os.mbed.com/teams/NXP/code/pelion-example-frdm

cd pelion-example-frdm

2. Install the CLOUD_SDK_API_KEY

mbed config -G CLOUD_SDK_API_KEY <PELION_DM_API_KEY>

For instructions on how to generate your API key, please see the documentation.

3. Initialize firmware credentials (done once per repository). You can use the following command:

mbed dm init -d "<your company name in Pelion DM>" --model-name "<product model identifier>" -q --force

If above command do not work for your Mbed CLI, please consider upgrading Mbed CLI to version 1.9.x or above.

4. Compile and program:

mbed compile -t <toolchain> -m <TARGET_BOARD>

(supported toolchains : GCC_ARM / ARM / IAR)

5. You can connect on a virtual terminal/COM port to the platform using:

mbed sterm -b 115200

This should give you an output similar to:

[BOOT] Mbed Bootloader
[BOOT] ARM: 00000000000000000000
[BOOT] OEM: 00000000000000000000
[BOOT] Layout: 0 8374
[BOOT] Active firmware integrity check:
[BOOT] SHA256: 411F422DE8FF545E2D3C373E87D5328162A129314A655AEC32B9A167DE29177E
[BOOT] Version: 1553606618
[BOOT] Slot 0 is empty
[BOOT] Active firmware up-to-date
[BOOT] Application's start address: 0x10400
[BOOT] Application's jump address: 0x112C1
[BOOT] Application's stack address: 0x20030000
[BOOT] Forwarding to application...


Starting Simple Pelion Device Management Client example
You can hold the user button during boot to format the storage and change the device identity.

Sensors configuration:
FXOS8700Q accelerometer = 0xC7
FXOS8700Q magnetometer  = 0xC7
FXAS21002 gyroscope     = 0xB7

Connecting to the network using the default network interface...
Connected to the network successfully. IP address: 10.2.202.65
Initializing Pelion Device Management Client...
Initialized Pelion Device Management Client. Registering...
Press the user button to increment the LwM2M resource value...

FXOS8700Q mag:    0.312 x,   0.039 y,  -1.625 z [gauss]
FXOS8700Q acc:    0.139 x,  -0.123 y,   4.260 z [g]
FXAS21002 gryo:  13.089 x,  13.089 y,  13.089 z [dps]
Committer:
screamer
Date:
Wed Mar 27 17:49:40 2019 +0000
Revision:
5:f2123dc31d30
Parent:
0:a9d53048f0b6
Improve inline documentation

Who changed what in which revision?

UserRevisionLine numberNew contents of line
screamer 0:a9d53048f0b6 1 Permissive Binary License
screamer 0:a9d53048f0b6 2
screamer 0:a9d53048f0b6 3 Version 1.0, September 2015
screamer 0:a9d53048f0b6 4
screamer 0:a9d53048f0b6 5 Redistribution. Redistribution and use in binary form, without
screamer 0:a9d53048f0b6 6 modification, are permitted provided that the following conditions are
screamer 0:a9d53048f0b6 7 met:
screamer 0:a9d53048f0b6 8
screamer 0:a9d53048f0b6 9 1) Redistributions must reproduce the above copyright notice and the
screamer 0:a9d53048f0b6 10 following disclaimer in the documentation and/or other materials
screamer 0:a9d53048f0b6 11 provided with the distribution.
screamer 0:a9d53048f0b6 12
screamer 0:a9d53048f0b6 13 2) Unless to the extent explicitly permitted by law, no reverse
screamer 0:a9d53048f0b6 14 engineering, decompilation, or disassembly of this software is
screamer 0:a9d53048f0b6 15 permitted.
screamer 0:a9d53048f0b6 16
screamer 0:a9d53048f0b6 17 3) Redistribution as part of a software development kit must include the
screamer 0:a9d53048f0b6 18 accompanying file named "DEPENDENCIES" and any dependencies listed in
screamer 0:a9d53048f0b6 19 that file.
screamer 0:a9d53048f0b6 20
screamer 0:a9d53048f0b6 21 4) Neither the name of the copyright holder nor the names of its
screamer 0:a9d53048f0b6 22 contributors may be used to endorse or promote products derived from
screamer 0:a9d53048f0b6 23 this software without specific prior written permission.
screamer 0:a9d53048f0b6 24
screamer 0:a9d53048f0b6 25 Limited patent license. The copyright holders (and contributors) grant a
screamer 0:a9d53048f0b6 26 worldwide, non-exclusive, no-charge, royalty-free patent license to
screamer 0:a9d53048f0b6 27 make, have made, use, offer to sell, sell, import, and otherwise
screamer 0:a9d53048f0b6 28 transfer this software, where such license applies only to those patent
screamer 0:a9d53048f0b6 29 claims licensable by the copyright holders (and contributors) that are
screamer 0:a9d53048f0b6 30 necessarily infringed by this software. This patent license shall not
screamer 0:a9d53048f0b6 31 apply to any combinations that include this software. No hardware is
screamer 0:a9d53048f0b6 32 licensed hereunder.
screamer 0:a9d53048f0b6 33
screamer 0:a9d53048f0b6 34 If you institute patent litigation against any entity (including a
screamer 0:a9d53048f0b6 35 cross-claim or counterclaim in a lawsuit) alleging that the software
screamer 0:a9d53048f0b6 36 itself infringes your patent(s), then your rights granted under this
screamer 0:a9d53048f0b6 37 license shall terminate as of the date such litigation is filed.
screamer 0:a9d53048f0b6 38
screamer 0:a9d53048f0b6 39 DISCLAIMER. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
screamer 0:a9d53048f0b6 40 CONTRIBUTORS "AS IS." ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
screamer 0:a9d53048f0b6 41 NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
screamer 0:a9d53048f0b6 42 FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
screamer 0:a9d53048f0b6 43 HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
screamer 0:a9d53048f0b6 44 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
screamer 0:a9d53048f0b6 45 TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
screamer 0:a9d53048f0b6 46 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
screamer 0:a9d53048f0b6 47 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
screamer 0:a9d53048f0b6 48 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
screamer 0:a9d53048f0b6 49 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.