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:
2:aadfd874279d
Add PLMN info for the BG96

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Osamu Koizumi 2:aadfd874279d 1 {
Osamu Koizumi 2:aadfd874279d 2 "macros": [
Osamu Koizumi 2:aadfd874279d 3 "MBEDTLS_USER_CONFIG_FILE=\"bootloader_mbedtls_user_config.h\"",
Osamu Koizumi 2:aadfd874279d 4 "SHOW_PROGRESS_BAR=0",
Osamu Koizumi 2:aadfd874279d 5 "MAX_COPY_RETRIES=1",
Osamu Koizumi 2:aadfd874279d 6 "MAX_BOOT_RETRIES=3",
Osamu Koizumi 2:aadfd874279d 7 "ARM_BOOTLOADER_USE_NVSTORE_ROT=1",
Osamu Koizumi 2:aadfd874279d 8 "ARM_UC_USE_PAL_CRYPTO=0",
Osamu Koizumi 2:aadfd874279d 9 "ARM_UC_USE_PAL_BLOCKDEVICE=1",
Osamu Koizumi 2:aadfd874279d 10 "ARM_UC_PAAL_TRACE_ENABLE=0",
Osamu Koizumi 2:aadfd874279d 11 "ARM_UC_PROFILE_MBED_CLOUD_CLIENT=1",
Osamu Koizumi 2:aadfd874279d 12 "ARM_UC_FEATURE_CRYPTO_PAL=0",
Osamu Koizumi 2:aadfd874279d 13 "ARM_UC_FEATURE_CRYPTO_MBEDTLS=1",
Osamu Koizumi 2:aadfd874279d 14 "MBED_CLOUD_CLIENT_UPDATE_STORAGE=ARM_UCP_FLASHIAP_BLOCKDEVICE",
Osamu Koizumi 2:aadfd874279d 15 "DEFAULT_MAX_APPLICATION_SIZE=(MBED_CONF_APP_FLASH_START_ADDRESS + MBED_CONF_APP_FLASH_SIZE - MBED_CONF_APP_APPLICATION_START_ADDRESS - NVSTORE_AREA_1_SIZE - NVSTORE_AREA_2_SIZE)",
Osamu Koizumi 2:aadfd874279d 16 "DISABLE_ERROR_DESCRIPTION=1",
Osamu Koizumi 2:aadfd874279d 17 "Mutex=PlatformMutex"
Osamu Koizumi 2:aadfd874279d 18 ],
Osamu Koizumi 2:aadfd874279d 19 "config": {
Osamu Koizumi 2:aadfd874279d 20 "application-start-address": {
Osamu Koizumi 2:aadfd874279d 21 "help": "Address to the beginning of the active application firmware in flash",
Osamu Koizumi 2:aadfd874279d 22 "value": null
Osamu Koizumi 2:aadfd874279d 23 },
Osamu Koizumi 2:aadfd874279d 24 "application-jump-address": {
Osamu Koizumi 2:aadfd874279d 25 "help": "Jump address for running the active application firmware",
Osamu Koizumi 2:aadfd874279d 26 "value": null
Osamu Koizumi 2:aadfd874279d 27 },
Osamu Koizumi 2:aadfd874279d 28 "max-application-size": {
Osamu Koizumi 2:aadfd874279d 29 "help": "Maximum size of the active application",
Osamu Koizumi 2:aadfd874279d 30 "value": null
Osamu Koizumi 2:aadfd874279d 31 },
Osamu Koizumi 2:aadfd874279d 32 "flash-start-address": {
Osamu Koizumi 2:aadfd874279d 33 "help": "Start address of internal flash. Only used in this config to help the definition of other macros.",
Osamu Koizumi 2:aadfd874279d 34 "value": null
Osamu Koizumi 2:aadfd874279d 35 },
Osamu Koizumi 2:aadfd874279d 36 "flash-size": {
Osamu Koizumi 2:aadfd874279d 37 "help": "Total size of internal flash. Only used in this config to help the definition of other macros.",
Osamu Koizumi 2:aadfd874279d 38 "value": null
Osamu Koizumi 2:aadfd874279d 39 }
Osamu Koizumi 2:aadfd874279d 40 },
Osamu Koizumi 2:aadfd874279d 41 "target_overrides": {
Osamu Koizumi 2:aadfd874279d 42 "*": {
Osamu Koizumi 2:aadfd874279d 43 "target.features_remove" : ["LWIP"],
Osamu Koizumi 2:aadfd874279d 44 "target.features_add" : ["COMMON_PAL"],
Osamu Koizumi 2:aadfd874279d 45 "target.extra_labels_remove" : ["PSA"],
Osamu Koizumi 2:aadfd874279d 46 "target.components_remove" : ["FLASHIAP"],
Osamu Koizumi 2:aadfd874279d 47 "platform.stdio-baud-rate" : 115200,
Osamu Koizumi 2:aadfd874279d 48 "platform.stdio-flush-at-exit" : false
Osamu Koizumi 2:aadfd874279d 49 },
Osamu Koizumi 2:aadfd874279d 50 "WIO_3G": {
Osamu Koizumi 2:aadfd874279d 51 "target.device_has_remove" : ["SERIAL_FC"],
Osamu Koizumi 2:aadfd874279d 52 "target.components_add" : ["SD"],
Osamu Koizumi 2:aadfd874279d 53 "flash-start-address" : "0x08000000",
Osamu Koizumi 2:aadfd874279d 54 "flash-size" : "(2048*1024)",
Osamu Koizumi 2:aadfd874279d 55 "nvstore.area_1_address" : "(MBED_CONF_APP_FLASH_START_ADDRESS + MBED_CONF_APP_FLASH_SIZE - 2*(128*1024))",
Osamu Koizumi 2:aadfd874279d 56 "nvstore.area_1_size" : "(128*1024)",
Osamu Koizumi 2:aadfd874279d 57 "nvstore.area_2_address" : "(MBED_CONF_APP_FLASH_START_ADDRESS + MBED_CONF_APP_FLASH_SIZE - 1*(128*1024))",
Osamu Koizumi 2:aadfd874279d 58 "nvstore.area_2_size" : "(128*1024)",
Osamu Koizumi 2:aadfd874279d 59 "update-client.application-details": "(MBED_CONF_APP_FLASH_START_ADDRESS + 64*1024)",
Osamu Koizumi 2:aadfd874279d 60 "update-client.storage-address" : "(1024*1024*64)",
Osamu Koizumi 2:aadfd874279d 61 "update-client.storage-size" : "(1024*1024*2)",
Osamu Koizumi 2:aadfd874279d 62 "update-client.storage-locations" : 1,
Osamu Koizumi 2:aadfd874279d 63 "update-client.firmware-header-version": "2",
Osamu Koizumi 2:aadfd874279d 64 "application-start-address" : "(MBED_CONF_APP_FLASH_START_ADDRESS + 65*1024)",
Osamu Koizumi 2:aadfd874279d 65 "max-application-size" : "DEFAULT_MAX_APPLICATION_SIZE",
Osamu Koizumi 2:aadfd874279d 66 "sd.SPI_MOSI" : "PC_12",
Osamu Koizumi 2:aadfd874279d 67 "sd.SPI_MISO" : "PC_11",
Osamu Koizumi 2:aadfd874279d 68 "sd.SPI_CLK" : "PC_10",
Osamu Koizumi 2:aadfd874279d 69 "sd.SPI_CS" : "PD_0"
Osamu Koizumi 2:aadfd874279d 70 }
Osamu Koizumi 2:aadfd874279d 71 }
Osamu Koizumi 2:aadfd874279d 72 }