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:
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 /*
MACRUM 0:91c16b1711c2 2 * Copyright (c) 2017 ARM Limited. All rights reserved.
MACRUM 0:91c16b1711c2 3 * SPDX-License-Identifier: Apache-2.0
MACRUM 0:91c16b1711c2 4 * Licensed under the Apache License, Version 2.0 (the License); you may
MACRUM 0:91c16b1711c2 5 * not use this file except in compliance with the License.
MACRUM 0:91c16b1711c2 6 * You may obtain a copy of the License at
MACRUM 0:91c16b1711c2 7 *
MACRUM 0:91c16b1711c2 8 * http://www.apache.org/licenses/LICENSE-2.0
MACRUM 0:91c16b1711c2 9 *
MACRUM 0:91c16b1711c2 10 * Unless required by applicable law or agreed to in writing, software
MACRUM 0:91c16b1711c2 11 * distributed under the License is distributed on an AS IS BASIS, WITHOUT
MACRUM 0:91c16b1711c2 12 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
MACRUM 0:91c16b1711c2 13 * See the License for the specific language governing permissions and
MACRUM 0:91c16b1711c2 14 * limitations under the License.
MACRUM 0:91c16b1711c2 15 */
MACRUM 0:91c16b1711c2 16 #ifndef __MBED_CLOUD_DEV_CREDENTIALS_H__
MACRUM 0:91c16b1711c2 17 #define __MBED_CLOUD_DEV_CREDENTIALS_H__
MACRUM 0:91c16b1711c2 18
MACRUM 0:91c16b1711c2 19 #if MBED_CONF_APP_DEVELOPER_MODE == 1
MACRUM 0:91c16b1711c2 20 #error "Replace mbed_cloud_dev_credentials.c with your own developer cert."
MACRUM 0:91c16b1711c2 21 #endif
MACRUM 0:91c16b1711c2 22
MACRUM 0:91c16b1711c2 23 #include <inttypes.h>
MACRUM 0:91c16b1711c2 24
MACRUM 0:91c16b1711c2 25 const char MBED_CLOUD_DEV_BOOTSTRAP_ENDPOINT_NAME[] = "";
MACRUM 0:91c16b1711c2 26 const char MBED_CLOUD_DEV_ACCOUNT_ID[] = "";
MACRUM 0:91c16b1711c2 27 const char MBED_CLOUD_DEV_BOOTSTRAP_SERVER_URI[] = "";
MACRUM 0:91c16b1711c2 28
MACRUM 0:91c16b1711c2 29 const uint8_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_CERTIFICATE[] =
MACRUM 0:91c16b1711c2 30 { 0x0 };
MACRUM 0:91c16b1711c2 31
MACRUM 0:91c16b1711c2 32 const uint8_t MBED_CLOUD_DEV_BOOTSTRAP_SERVER_ROOT_CA_CERTIFICATE[] =
MACRUM 0:91c16b1711c2 33 { 0x0 };
MACRUM 0:91c16b1711c2 34
MACRUM 0:91c16b1711c2 35 const uint8_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_PRIVATE_KEY[] =
MACRUM 0:91c16b1711c2 36 { 0x0 };
MACRUM 0:91c16b1711c2 37
MACRUM 0:91c16b1711c2 38 const char MBED_CLOUD_DEV_MANUFACTURER[] = "dev_manufacturer";
MACRUM 0:91c16b1711c2 39
MACRUM 0:91c16b1711c2 40 const char MBED_CLOUD_DEV_MODEL_NUMBER[] = "dev_model_num";
MACRUM 0:91c16b1711c2 41
MACRUM 0:91c16b1711c2 42 const char MBED_CLOUD_DEV_SERIAL_NUMBER[] = "0";
MACRUM 0:91c16b1711c2 43
MACRUM 0:91c16b1711c2 44 const char MBED_CLOUD_DEV_DEVICE_TYPE[] = "dev_device_type";
MACRUM 0:91c16b1711c2 45
MACRUM 0:91c16b1711c2 46 const char MBED_CLOUD_DEV_HARDWARE_VERSION[] = "dev_hardware_version";
MACRUM 0:91c16b1711c2 47
MACRUM 0:91c16b1711c2 48 const uint32_t MBED_CLOUD_DEV_MEMORY_TOTAL_KB = 0;
MACRUM 0:91c16b1711c2 49 const uint32_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_CERTIFICATE_SIZE = sizeof(MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_CERTIFICATE);
MACRUM 0:91c16b1711c2 50 const uint32_t MBED_CLOUD_DEV_BOOTSTRAP_SERVER_ROOT_CA_CERTIFICATE_SIZE = sizeof(MBED_CLOUD_DEV_BOOTSTRAP_SERVER_ROOT_CA_CERTIFICATE);
MACRUM 0:91c16b1711c2 51 const uint32_t MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_PRIVATE_KEY_SIZE = sizeof(MBED_CLOUD_DEV_BOOTSTRAP_DEVICE_PRIVATE_KEY);
MACRUM 0:91c16b1711c2 52
MACRUM 0:91c16b1711c2 53 #endif //__MBED_CLOUD_DEV_CREDENTIALS_H__