Seeed
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.
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-usernameandnsapi.default-cellular-passwordfrom 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": trueand"lwip.ppp-enabled": false. - The modem and network may only support IPv6 in which case
"lwip.ipv6-enabled": trueshall be defined. - The SIM and modem must have compatible cellular technology (3G, 4G, NB-IoT, ...) supported and cellular network available.
bootloader/LICENSE@4:d4caf0ec02d0, 2019-05-16 (annotated)
- 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?
| User | Revision | Line number | New 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. |