pelion-example-rhombio-l476dmw1k - Mbed OS and Pelion Device Management example over…

rhomb.io » Code » pelion-example-rhombio-l476dmw1k

rhomb.io / Mbed OS pelion-example-rhombio-l476dmw1k

Mbed OS and Pelion Device Management example over WIFI for RHOMBIO_L476DMW1K IoT kit

DEPRECATED

This example application is not maintained and not recommended. It uses an old version of Mbed OS, Pelion DM, and Arm toolchain. It doesn't work with Mbed Studio.

Please use: https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-pelion/

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

RHOMBIO_L476DMW1K over WiFI and using onboard QSPI flash.

/media/uploads/galonso/rhombio_l476dmw1k_kit_assembled.png

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

Example functionality

This example showcases the following device functionality:

Read onboard MCU ADC temperature and MCU ADC voltage reference, and report them as Pelion LWM2M resources (see image below).
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.
External sensors can be easily added to the kit and then sensor readings reported as Pelion LWM2M resources.

/media/uploads/galonso/temperature_-_sensor_value_-_pelion_device_management_portal.png

Use this example with Mbed CLI

1. Import the application into your desktop:

mbed import https://os.mbed.com/teams/Rhombio/code/pelion-example-rhombio-l476dmw1k

cd pelion-example-rhombio-l476dmw1k

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.8.x or above.

4. Compile and program:

mbed compile -t <toolchain> -m RHOMBIO_L476DMW1K -f

(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: 0000000000000000000000000000000000000000
[BOOT] OEM: 0000000000000000000000000000000000000000
[BOOT] Layout: 0 800D24C
[BOOT] Active firmware integrity check:
[BOOT] SHA256: 9036E19F1414720659B2C2FAC8855F621AF533BA211D930119720E7A2BD60BF2
[BOOT] Version: 1558516039
[BOOT] Slot 0 is empty
[BOOT] Active firmware up-to-date
[BOOT] Application's start address: 0x8010400
[BOOT] Application's jump address: 0x8010889
[BOOT] Application's stack address: 0x20018000
[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.

Connecting to the network using Wifi...
Connected to the network successfully. IP address: 192.168.1.201
Initializing Pelion Device Management Client...
Initialized Pelion Client. Registering...
Registered to Pelion Device Management. Endpoint Name: 016a***********************10006d
                                                             
ADC temp: 23.1746 C,  vref: 0.3665 V         
                                                             
ADC temp: 23.2234 C,  vref: 0.3663 V

LICENSE.txt@4:2aee28e71add, 2019-05-22 (annotated)

Committer:: galonso@rhomb.io
Date:: Wed May 22 11:17:54 2019 +0200
Revision:: 4:2aee28e71add
Parent:: 0:9ff56a0e4c0d

new bootloader added

Who changed what in which revision?

User	Revision	Line number	New contents of line
galonso@rhomb.io	0:9ff56a0e4c0d	1	Apache License
galonso@rhomb.io	0:9ff56a0e4c0d	2	Version 2.0, January 2004
galonso@rhomb.io	0:9ff56a0e4c0d	3	http://www.apache.org/licenses/
galonso@rhomb.io	0:9ff56a0e4c0d	4
galonso@rhomb.io	0:9ff56a0e4c0d	5	TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
galonso@rhomb.io	0:9ff56a0e4c0d	6
galonso@rhomb.io	0:9ff56a0e4c0d	7	1. Definitions.
galonso@rhomb.io	0:9ff56a0e4c0d	8
galonso@rhomb.io	0:9ff56a0e4c0d	9	"License" shall mean the terms and conditions for use, reproduction, and
galonso@rhomb.io	0:9ff56a0e4c0d	10	distribution as defined by Sections 1 through 9 of this document.
galonso@rhomb.io	0:9ff56a0e4c0d	11
galonso@rhomb.io	0:9ff56a0e4c0d	12	"Licensor" shall mean the copyright owner or entity authorized by the copyright
galonso@rhomb.io	0:9ff56a0e4c0d	13	owner that is granting the License.
galonso@rhomb.io	0:9ff56a0e4c0d	14
galonso@rhomb.io	0:9ff56a0e4c0d	15	"Legal Entity" shall mean the union of the acting entity and all other entities
galonso@rhomb.io	0:9ff56a0e4c0d	16	that control, are controlled by, or are under common control with that entity.
galonso@rhomb.io	0:9ff56a0e4c0d	17	For the purposes of this definition, "control" means (i) the power, direct or
galonso@rhomb.io	0:9ff56a0e4c0d	18	indirect, to cause the direction or management of such entity, whether by
galonso@rhomb.io	0:9ff56a0e4c0d	19	contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
galonso@rhomb.io	0:9ff56a0e4c0d	20	outstanding shares, or (iii) beneficial ownership of such entity.
galonso@rhomb.io	0:9ff56a0e4c0d	21
galonso@rhomb.io	0:9ff56a0e4c0d	22	"You" (or "Your") shall mean an individual or Legal Entity exercising
galonso@rhomb.io	0:9ff56a0e4c0d	23	permissions granted by this License.
galonso@rhomb.io	0:9ff56a0e4c0d	24
galonso@rhomb.io	0:9ff56a0e4c0d	25	"Source" form shall mean the preferred form for making modifications, including
galonso@rhomb.io	0:9ff56a0e4c0d	26	but not limited to software source code, documentation source, and configuration
galonso@rhomb.io	0:9ff56a0e4c0d	27	files.
galonso@rhomb.io	0:9ff56a0e4c0d	28
galonso@rhomb.io	0:9ff56a0e4c0d	29	"Object" form shall mean any form resulting from mechanical transformation or
galonso@rhomb.io	0:9ff56a0e4c0d	30	translation of a Source form, including but not limited to compiled object code,
galonso@rhomb.io	0:9ff56a0e4c0d	31	generated documentation, and conversions to other media types.
galonso@rhomb.io	0:9ff56a0e4c0d	32
galonso@rhomb.io	0:9ff56a0e4c0d	33	"Work" shall mean the work of authorship, whether in Source or Object form, made
galonso@rhomb.io	0:9ff56a0e4c0d	34	available under the License, as indicated by a copyright notice that is included
galonso@rhomb.io	0:9ff56a0e4c0d	35	in or attached to the work (an example is provided in the Appendix below).
galonso@rhomb.io	0:9ff56a0e4c0d	36
galonso@rhomb.io	0:9ff56a0e4c0d	37	"Derivative Works" shall mean any work, whether in Source or Object form, that
galonso@rhomb.io	0:9ff56a0e4c0d	38	is based on (or derived from) the Work and for which the editorial revisions,
galonso@rhomb.io	0:9ff56a0e4c0d	39	annotations, elaborations, or other modifications represent, as a whole, an
galonso@rhomb.io	0:9ff56a0e4c0d	40	original work of authorship. For the purposes of this License, Derivative Works
galonso@rhomb.io	0:9ff56a0e4c0d	41	shall not include works that remain separable from, or merely link (or bind by
galonso@rhomb.io	0:9ff56a0e4c0d	42	name) to the interfaces of, the Work and Derivative Works thereof.
galonso@rhomb.io	0:9ff56a0e4c0d	43
galonso@rhomb.io	0:9ff56a0e4c0d	44	"Contribution" shall mean any work of authorship, including the original version
galonso@rhomb.io	0:9ff56a0e4c0d	45	of the Work and any modifications or additions to that Work or Derivative Works
galonso@rhomb.io	0:9ff56a0e4c0d	46	thereof, that is intentionally submitted to Licensor for inclusion in the Work
galonso@rhomb.io	0:9ff56a0e4c0d	47	by the copyright owner or by an individual or Legal Entity authorized to submit
galonso@rhomb.io	0:9ff56a0e4c0d	48	on behalf of the copyright owner. For the purposes of this definition,
galonso@rhomb.io	0:9ff56a0e4c0d	49	"submitted" means any form of electronic, verbal, or written communication sent
galonso@rhomb.io	0:9ff56a0e4c0d	50	to the Licensor or its representatives, including but not limited to
galonso@rhomb.io	0:9ff56a0e4c0d	51	communication on electronic mailing lists, source code control systems, and
galonso@rhomb.io	0:9ff56a0e4c0d	52	issue tracking systems that are managed by, or on behalf of, the Licensor for
galonso@rhomb.io	0:9ff56a0e4c0d	53	the purpose of discussing and improving the Work, but excluding communication
galonso@rhomb.io	0:9ff56a0e4c0d	54	that is conspicuously marked or otherwise designated in writing by the copyright
galonso@rhomb.io	0:9ff56a0e4c0d	55	owner as "Not a Contribution."
galonso@rhomb.io	0:9ff56a0e4c0d	56
galonso@rhomb.io	0:9ff56a0e4c0d	57	"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
galonso@rhomb.io	0:9ff56a0e4c0d	58	of whom a Contribution has been received by Licensor and subsequently
galonso@rhomb.io	0:9ff56a0e4c0d	59	incorporated within the Work.
galonso@rhomb.io	0:9ff56a0e4c0d	60
galonso@rhomb.io	0:9ff56a0e4c0d	61	2. Grant of Copyright License.
galonso@rhomb.io	0:9ff56a0e4c0d	62
galonso@rhomb.io	0:9ff56a0e4c0d	63	Subject to the terms and conditions of this License, each Contributor hereby
galonso@rhomb.io	0:9ff56a0e4c0d	64	grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
galonso@rhomb.io	0:9ff56a0e4c0d	65	irrevocable copyright license to reproduce, prepare Derivative Works of,
galonso@rhomb.io	0:9ff56a0e4c0d	66	publicly display, publicly perform, sublicense, and distribute the Work and such
galonso@rhomb.io	0:9ff56a0e4c0d	67	Derivative Works in Source or Object form.
galonso@rhomb.io	0:9ff56a0e4c0d	68
galonso@rhomb.io	0:9ff56a0e4c0d	69	3. Grant of Patent License.
galonso@rhomb.io	0:9ff56a0e4c0d	70
galonso@rhomb.io	0:9ff56a0e4c0d	71	Subject to the terms and conditions of this License, each Contributor hereby
galonso@rhomb.io	0:9ff56a0e4c0d	72	grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
galonso@rhomb.io	0:9ff56a0e4c0d	73	irrevocable (except as stated in this section) patent license to make, have
galonso@rhomb.io	0:9ff56a0e4c0d	74	made, use, offer to sell, sell, import, and otherwise transfer the Work, where
galonso@rhomb.io	0:9ff56a0e4c0d	75	such license applies only to those patent claims licensable by such Contributor
galonso@rhomb.io	0:9ff56a0e4c0d	76	that are necessarily infringed by their Contribution(s) alone or by combination
galonso@rhomb.io	0:9ff56a0e4c0d	77	of their Contribution(s) with the Work to which such Contribution(s) was
galonso@rhomb.io	0:9ff56a0e4c0d	78	submitted. If You institute patent litigation against any entity (including a
galonso@rhomb.io	0:9ff56a0e4c0d	79	cross-claim or counterclaim in a lawsuit) alleging that the Work or a
galonso@rhomb.io	0:9ff56a0e4c0d	80	Contribution incorporated within the Work constitutes direct or contributory
galonso@rhomb.io	0:9ff56a0e4c0d	81	patent infringement, then any patent licenses granted to You under this License
galonso@rhomb.io	0:9ff56a0e4c0d	82	for that Work shall terminate as of the date such litigation is filed.
galonso@rhomb.io	0:9ff56a0e4c0d	83
galonso@rhomb.io	0:9ff56a0e4c0d	84	4. Redistribution.
galonso@rhomb.io	0:9ff56a0e4c0d	85
galonso@rhomb.io	0:9ff56a0e4c0d	86	You may reproduce and distribute copies of the Work or Derivative Works thereof
galonso@rhomb.io	0:9ff56a0e4c0d	87	in any medium, with or without modifications, and in Source or Object form,
galonso@rhomb.io	0:9ff56a0e4c0d	88	provided that You meet the following conditions:
galonso@rhomb.io	0:9ff56a0e4c0d	89
galonso@rhomb.io	0:9ff56a0e4c0d	90	You must give any other recipients of the Work or Derivative Works a copy of
galonso@rhomb.io	0:9ff56a0e4c0d	91	this License; and
galonso@rhomb.io	0:9ff56a0e4c0d	92	You must cause any modified files to carry prominent notices stating that You
galonso@rhomb.io	0:9ff56a0e4c0d	93	changed the files; and
galonso@rhomb.io	0:9ff56a0e4c0d	94	You must retain, in the Source form of any Derivative Works that You distribute,
galonso@rhomb.io	0:9ff56a0e4c0d	95	all copyright, patent, trademark, and attribution notices from the Source form
galonso@rhomb.io	0:9ff56a0e4c0d	96	of the Work, excluding those notices that do not pertain to any part of the
galonso@rhomb.io	0:9ff56a0e4c0d	97	Derivative Works; and
galonso@rhomb.io	0:9ff56a0e4c0d	98	If the Work includes a "NOTICE" text file as part of its distribution, then any
galonso@rhomb.io	0:9ff56a0e4c0d	99	Derivative Works that You distribute must include a readable copy of the
galonso@rhomb.io	0:9ff56a0e4c0d	100	attribution notices contained within such NOTICE file, excluding those notices
galonso@rhomb.io	0:9ff56a0e4c0d	101	that do not pertain to any part of the Derivative Works, in at least one of the
galonso@rhomb.io	0:9ff56a0e4c0d	102	following places: within a NOTICE text file distributed as part of the
galonso@rhomb.io	0:9ff56a0e4c0d	103	Derivative Works; within the Source form or documentation, if provided along
galonso@rhomb.io	0:9ff56a0e4c0d	104	with the Derivative Works; or, within a display generated by the Derivative
galonso@rhomb.io	0:9ff56a0e4c0d	105	Works, if and wherever such third-party notices normally appear. The contents of
galonso@rhomb.io	0:9ff56a0e4c0d	106	the NOTICE file are for informational purposes only and do not modify the
galonso@rhomb.io	0:9ff56a0e4c0d	107	License. You may add Your own attribution notices within Derivative Works that
galonso@rhomb.io	0:9ff56a0e4c0d	108	You distribute, alongside or as an addendum to the NOTICE text from the Work,
galonso@rhomb.io	0:9ff56a0e4c0d	109	provided that such additional attribution notices cannot be construed as
galonso@rhomb.io	0:9ff56a0e4c0d	110	modifying the License.
galonso@rhomb.io	0:9ff56a0e4c0d	111	You may add Your own copyright statement to Your modifications and may provide
galonso@rhomb.io	0:9ff56a0e4c0d	112	additional or different license terms and conditions for use, reproduction, or
galonso@rhomb.io	0:9ff56a0e4c0d	113	distribution of Your modifications, or for any such Derivative Works as a whole,
galonso@rhomb.io	0:9ff56a0e4c0d	114	provided Your use, reproduction, and distribution of the Work otherwise complies
galonso@rhomb.io	0:9ff56a0e4c0d	115	with the conditions stated in this License.
galonso@rhomb.io	0:9ff56a0e4c0d	116
galonso@rhomb.io	0:9ff56a0e4c0d	117	5. Submission of Contributions.
galonso@rhomb.io	0:9ff56a0e4c0d	118
galonso@rhomb.io	0:9ff56a0e4c0d	119	Unless You explicitly state otherwise, any Contribution intentionally submitted
galonso@rhomb.io	0:9ff56a0e4c0d	120	for inclusion in the Work by You to the Licensor shall be under the terms and
galonso@rhomb.io	0:9ff56a0e4c0d	121	conditions of this License, without any additional terms or conditions.
galonso@rhomb.io	0:9ff56a0e4c0d	122	Notwithstanding the above, nothing herein shall supersede or modify the terms of
galonso@rhomb.io	0:9ff56a0e4c0d	123	any separate license agreement you may have executed with Licensor regarding
galonso@rhomb.io	0:9ff56a0e4c0d	124	such Contributions.
galonso@rhomb.io	0:9ff56a0e4c0d	125
galonso@rhomb.io	0:9ff56a0e4c0d	126	6. Trademarks.
galonso@rhomb.io	0:9ff56a0e4c0d	127
galonso@rhomb.io	0:9ff56a0e4c0d	128	This License does not grant permission to use the trade names, trademarks,
galonso@rhomb.io	0:9ff56a0e4c0d	129	service marks, or product names of the Licensor, except as required for
galonso@rhomb.io	0:9ff56a0e4c0d	130	reasonable and customary use in describing the origin of the Work and
galonso@rhomb.io	0:9ff56a0e4c0d	131	reproducing the content of the NOTICE file.
galonso@rhomb.io	0:9ff56a0e4c0d	132
galonso@rhomb.io	0:9ff56a0e4c0d	133	7. Disclaimer of Warranty.
galonso@rhomb.io	0:9ff56a0e4c0d	134
galonso@rhomb.io	0:9ff56a0e4c0d	135	Unless required by applicable law or agreed to in writing, Licensor provides the
galonso@rhomb.io	0:9ff56a0e4c0d	136	Work (and each Contributor provides its Contributions) on an "AS IS" BASIS,
galonso@rhomb.io	0:9ff56a0e4c0d	137	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied,
galonso@rhomb.io	0:9ff56a0e4c0d	138	including, without limitation, any warranties or conditions of TITLE,
galonso@rhomb.io	0:9ff56a0e4c0d	139	NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are
galonso@rhomb.io	0:9ff56a0e4c0d	140	solely responsible for determining the appropriateness of using or
galonso@rhomb.io	0:9ff56a0e4c0d	141	redistributing the Work and assume any risks associated with Your exercise of
galonso@rhomb.io	0:9ff56a0e4c0d	142	permissions under this License.
galonso@rhomb.io	0:9ff56a0e4c0d	143
galonso@rhomb.io	0:9ff56a0e4c0d	144	8. Limitation of Liability.
galonso@rhomb.io	0:9ff56a0e4c0d	145
galonso@rhomb.io	0:9ff56a0e4c0d	146	In no event and under no legal theory, whether in tort (including negligence),
galonso@rhomb.io	0:9ff56a0e4c0d	147	contract, or otherwise, unless required by applicable law (such as deliberate
galonso@rhomb.io	0:9ff56a0e4c0d	148	and grossly negligent acts) or agreed to in writing, shall any Contributor be
galonso@rhomb.io	0:9ff56a0e4c0d	149	liable to You for damages, including any direct, indirect, special, incidental,
galonso@rhomb.io	0:9ff56a0e4c0d	150	or consequential damages of any character arising as a result of this License or
galonso@rhomb.io	0:9ff56a0e4c0d	151	out of the use or inability to use the Work (including but not limited to
galonso@rhomb.io	0:9ff56a0e4c0d	152	damages for loss of goodwill, work stoppage, computer failure or malfunction, or
galonso@rhomb.io	0:9ff56a0e4c0d	153	any and all other commercial damages or losses), even if such Contributor has
galonso@rhomb.io	0:9ff56a0e4c0d	154	been advised of the possibility of such damages.
galonso@rhomb.io	0:9ff56a0e4c0d	155
galonso@rhomb.io	0:9ff56a0e4c0d	156	9. Accepting Warranty or Additional Liability.
galonso@rhomb.io	0:9ff56a0e4c0d	157
galonso@rhomb.io	0:9ff56a0e4c0d	158	While redistributing the Work or Derivative Works thereof, You may choose to
galonso@rhomb.io	0:9ff56a0e4c0d	159	offer, and charge a fee for, acceptance of support, warranty, indemnity, or
galonso@rhomb.io	0:9ff56a0e4c0d	160	other liability obligations and/or rights consistent with this License. However,
galonso@rhomb.io	0:9ff56a0e4c0d	161	in accepting such obligations, You may act only on Your own behalf and on Your
galonso@rhomb.io	0:9ff56a0e4c0d	162	sole responsibility, not on behalf of any other Contributor, and only if You
galonso@rhomb.io	0:9ff56a0e4c0d	163	agree to indemnify, defend, and hold each Contributor harmless for any liability
galonso@rhomb.io	0:9ff56a0e4c0d	164	incurred by, or claims asserted against, such Contributor by reason of your
galonso@rhomb.io	0:9ff56a0e4c0d	165	accepting any such warranty or additional liability.