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:
Thu May 16 07:16:24 2019 +0000
Revision:
4:d4caf0ec02d0
Parent:
0:91c16b1711c2
Add PLMN info for the BG96

Who changed what in which revision?

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