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

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.