NXP / Mbed OS mbed-cloud-connect-example-ethernet

Simple Mbed Cloud client application using features of K64 & K66 including Ethernet and SD Card

Fork of mbed-cloud-example_K64_K66 by Mac Lobdell

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/

README.md@0:e13a8a944e25, 2018-02-13 (annotated)

Committer:
MarceloSalazar
Date:
Tue Feb 13 10:07:23 2018 +0000
Revision:
0:e13a8a944e25
Child:
1:1ccf36276cd3
First version

Who changed what in which revision?

UserRevisionLine numberNew contents of line
MarceloSalazar 0:e13a8a944e25 1 # Simple Mbed Cloud Client application
MarceloSalazar 0:e13a8a944e25 2
MarceloSalazar 0:e13a8a944e25 3 ### Overview
MarceloSalazar 0:e13a8a944e25 4
MarceloSalazar 0:e13a8a944e25 5 This is a reference application for platform vendors. It demonstrates how to create a simple Mbed Cloud Client application that can connect to Mbed Cloud, register resources and get ready to receive a firmware update.
MarceloSalazar 0:e13a8a944e25 6
MarceloSalazar 0:e13a8a944e25 7 It's intenteded to be forked and customized to add platform specific features (sensors, actuators) and configure the connectivity and storage to work **out-of-the-box**.
MarceloSalazar 0:e13a8a944e25 8 The Simple Mbed Cloud Client application is intended to work in **developer mode** only. For production considerations, please read the following [document].
MarceloSalazar 0:e13a8a944e25 9
MarceloSalazar 0:e13a8a944e25 10 ### Setup process
MarceloSalazar 0:e13a8a944e25 11
MarceloSalazar 0:e13a8a944e25 12 This is a summary of the process for developers to get started and get a device connected to Mbed Cloud.
MarceloSalazar 0:e13a8a944e25 13
MarceloSalazar 0:e13a8a944e25 14 #### Mbed Online IDE
MarceloSalazar 0:e13a8a944e25 15
MarceloSalazar 0:e13a8a944e25 16 - Import application into the Online IDE
MarceloSalazar 0:e13a8a944e25 17 - Add API key to stablish connection to Mbed Cloud
MarceloSalazar 0:e13a8a944e25 18 - Install developer certificate
MarceloSalazar 0:e13a8a944e25 19 - Compile & program
MarceloSalazar 0:e13a8a944e25 20
MarceloSalazar 0:e13a8a944e25 21 #### Mbed CLI tools
MarceloSalazar 0:e13a8a944e25 22
MarceloSalazar 0:e13a8a944e25 23 - Import application in developer's desktop:
MarceloSalazar 0:e13a8a944e25 24
MarceloSalazar 0:e13a8a944e25 25 ```
MarceloSalazar 0:e13a8a944e25 26 mbed import https://github.com/ARMmbed/simple-mbed-cloud-client-example
MarceloSalazar 0:e13a8a944e25 27 cd simple-mbed-cloud-client-example
MarceloSalazar 0:e13a8a944e25 28 ```
MarceloSalazar 0:e13a8a944e25 29 - Download developer certificate from Mbed Cloud
MarceloSalazar 0:e13a8a944e25 30
MarceloSalazar 0:e13a8a944e25 31 - Compile & program
MarceloSalazar 0:e13a8a944e25 32
MarceloSalazar 0:e13a8a944e25 33 ```
MarceloSalazar 0:e13a8a944e25 34 mbed compile -t <toolchain> -m <target> -c -f
MarceloSalazar 0:e13a8a944e25 35 ```
MarceloSalazar 0:e13a8a944e25 36
MarceloSalazar 0:e13a8a944e25 37 ### Porting to a new platform
MarceloSalazar 0:e13a8a944e25 38
MarceloSalazar 0:e13a8a944e25 39 The hardware requirements for Mbed OS platforms to support Mbed Cloud Client as shown [here].
MarceloSalazar 0:e13a8a944e25 40 This template application works with the [FRDM-K64F](https://os.mbed.com/platforms/FRDM-K64F/) platform by default.
MarceloSalazar 0:e13a8a944e25 41
MarceloSalazar 0:e13a8a944e25 42 However, adding a new platform requires the following:
MarceloSalazar 0:e13a8a944e25 43
MarceloSalazar 0:e13a8a944e25 44 - Fork the template and create an example application for your platform in https://os.mbed.com
MarceloSalazar 0:e13a8a944e25 45 - Modify `mbed_app.json` with corresponding addresses to match your platform memory map.
MarceloSalazar 0:e13a8a944e25 46
MarceloSalazar 0:e13a8a944e25 47 ```
MarceloSalazar 0:e13a8a944e25 48 "K64F": {
MarceloSalazar 0:e13a8a944e25 49 "target.mbed_app_start": "0x00020400",
MarceloSalazar 0:e13a8a944e25 50 "update-client.application-details": "0x00020000",
MarceloSalazar 0:e13a8a944e25 51 "update-client.bootloader-details": "0x172e4"
MarceloSalazar 0:e13a8a944e25 52 }
MarceloSalazar 0:e13a8a944e25 53 ```
MarceloSalazar 0:e13a8a944e25 54 - [Optional] Change connectivity interface. By default uses Ethernet. See lines [xxx].
MarceloSalazar 0:e13a8a944e25 55 - [Optional] Change the filesystem and/or the block device for storage. By default uses FAT filesystem over SD card. See lines [xxx].
MarceloSalazar 0:e13a8a944e25 56 - Create a [bootloader binary](TBD) according to addresses specified in `mbed_app.json`. The booloader has to use the same storage configuration specified in the application.
MarceloSalazar 0:e13a8a944e25 57
MarceloSalazar 0:e13a8a944e25 58 ### Known issues
MarceloSalazar 0:e13a8a944e25 59
MarceloSalazar 0:e13a8a944e25 60 None.
MarceloSalazar 0:e13a8a944e25 61
MarceloSalazar 0:e13a8a944e25 62