Specific Pelion ready example using features of Seeed Wio boards including cellular and SD Card

Dependencies:   WS2812 PixelArray

Fork of simple-mbed-cloud-example-wio_3g by Toyomasa Watarai

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:
Seeed Wio 3G and Seeed Wio LTE-M1/NB1(BG96) over cellular and using SD card.

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

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

Example functionality

This example showcases the following device functionality:

  • Allow the user to change the state of the board LED from Pelion LWM2M led_state resource and PUT request.

Instructions to use this program with mbed CLI

1. Import the application into your desktop:

mbed import https://os.mbed.com/teams/Seeed/code/pelion-example-common/

cd pelion-example-common

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.

  • Set APN name, username and password in the mbed_app.json.

            "nsapi.default-cellular-plmn"      : "\"00000\"",
            "nsapi.default-cellular-sim-pin"   : "\"0000\"",
            "nsapi.default-cellular-apn"       : "\"apn\"",
            "nsapi.default-cellular-username"  : "\"username\"",
            "nsapi.default-cellular-password"  : "\"password\""

Information

For the Wio LTE-M1/NB1(BG96) target, PLMN (Public land mobile network) should be specified to get quick connection to the network. This is usually found first 5 digit from your SIM card IMSI (International Mobile Subscriber Identity) number. e.g. 44052

4. Compile and program:

mbed compile -t <toolchain> -m WIO_3G

(supported toolchains : GCC_ARM / ARM / IAR)

Troubleshooting

  • Make sure the fields nsapi.default-cellular-sim-pin, nsapi.default-cellular-apn, nsapi.default-cellular-username and nsapi.default-cellular-password from the mbed_app.json file are filled in correctly. The correct values should appear in the user manual in the details of the SIM card.
  • Enable trace flag to have access to debug information "mbed-trace.enable": true.
  • Try both TCP and UDP socket types.
  • Try both "lwip.ppp-enabled": true and "lwip.ppp-enabled": false.
  • The modem and network may only support IPv6 in which case "lwip.ipv6-enabled": true shall be defined.
  • The SIM and modem must have compatible cellular technology (3G, 4G, NB-IoT, ...) supported and cellular network available.
Committer:
MACRUM
Date:
Sat Nov 10 20:27:36 2018 +0900
Revision:
0:91c16b1711c2
Initial commit

Who changed what in which revision?

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