Mbed OS example of Pelion device management client

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

https://os.mbed.com/media/cache/platforms/M46B_mbed.png.250x250_q85.jpg

To use this example, connect ESP8266 Wi-Fi module (Grove UART WiFi) to the AdBun-M46B board as below:

ESP8266 Wi-FiAdBun-M46B
TXPL1 (CN4-22)
RXPL2 (CN4-24)
VINVCC3.3 (CN11-5)
GNDGND (CN11-6)

https://dl.dropboxusercontent.com/s/5j4glkwhjg5m5ay/IMG_7457.jpg

Example functionality

  • Initialize, connect and register to Pelion DM
  • Interact with the user through the serial port (115200 bauds)
    • Press enter through putty/minicom to simulate button
    • Press i to print endpoint name
    • Press Ctrl-C to to unregister
    • Press r to reset storage and reboot (warning: it generates a new device ID!)

Instructions to use this program with Mbed CLI


1. Import the application into your desktop:

mbed import https://os.mbed.com/teams/Toshiba/code/mbed-os-example-pelion/
cd mbed-os-example-pelion


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. Connect Pins used with Wifi shield (ESP8266) and SD card shield:

5. Edit mbed_app.json to specify Wi-Fi access point information

            "nsapi.default-wifi-ssid"                   : "\"SSID\"",
            "nsapi.default-wifi-password"               : "\"PASSWORD\""

6. Compile and program:

mbed compile -t <toolchain> -m TMPM46B

(supported toolchains : GCC_ARM / ARM / IAR)

Committer:
MACRUM
Date:
Thu Dec 12 10:26:06 2019 +0900
Revision:
0:9f917a7bf2da
Initial commit.

Who changed what in which revision?

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