Seeed / Mbed OS pelion-example-common Featured

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.

mbed_cloud_dev_credentials.c@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?

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__