ARMmbed / mbed-os-5-docs

Full documentation for Mbed OS 5 and 6
http://os.mbed.com/docs
98 stars 170 forks source link

Pelion Device Management Client required for mbed dm functionality #707

Closed dhwalters423 closed 6 years ago

dhwalters423 commented 6 years ago

The current documentation for the mbed dm command makes no mention of Pelion Device Management Client (PDMC).

https://github.com/ARMmbed/mbed-os-5-docs/blob/development/docs/tools/offline/cli-device-management.md

In order for someone to use the mbed dm command to update a device,their device must be running an application with PDMC and a supported managed or unmanaged bootloader.

Documentation needs to mention that this command only works for devices running Pelion Device Management Client and the application is combined with a bootloader. Additionally, you may want to have a line similar to:

"To test this feature, you can run the Pelion Device Management Client Example on one of our reference platforms."

dhwalters423 commented 6 years ago

Additionally, we want to mention WHICH binary is needed to flash the device first that contains the bootloader, and which binary is used for an update.

The following output from an ls in the BUILD directory:

davwal04@MbedBuildCentre:~/workspace/Pelion-ethernet-fw-update$ ls ./BUILD/K64F/GCC_ARM/
main.d                        mbed_config.h                              Pelion-ethernet-fw-update_application.map.old  Pelion-ethernet-fw-update_map.html    update_default_resources.d
main.o                        mbed-os                                    Pelion-ethernet-fw-update.bin                  Pelion-ethernet-fw-update_map.json    update_default_resources.o
mbed_cloud_dev_credentials.d  Pelion-ethernet-fw-update_application.bin  Pelion-ethernet-fw-update_header.hex           Pelion-ethernet-fw-update_update.bin
mbed_cloud_dev_credentials.o  Pelion-ethernet-fw-update_application.elf  Pelion-ethernet-fw-update_map.csv              simple-mbed-cloud-client

Which one should I flash that contains the bootloader? Which one is then used for an update?

Need better tutorial/instructions.

ashok-rao commented 6 years ago

@kegilbert / @AnotherButler : Could you please address this? Thanks.

kegilbert commented 6 years ago

I'm double checking with some cloud/pelion people, I can update the docs accordingly.

AnotherButler commented 6 years ago

PR up: https://github.com/ARMmbed/mbed-os-5-docs/pull/736

AnotherButler commented 6 years ago

Could someone please recommend a Pelion engineer to help with the content specifying which binary?

oliverjharper commented 6 years ago

@teetak01 - any chance you could help with @AnotherButler question above?

teetak01 commented 6 years ago

@oliverjharper already reviewed the PR earlier.

AnotherButler commented 6 years ago

@teetak01 Do you agree with @dhwalters423 that we need to specify which binary one uses to flash the device first that contains the bootloader, and which binary one uses for an update? If so, could you please help me clarify that?

teetak01 commented 6 years ago

The "default" binary should be flashed to the board. Then the "_update.bin" is automatically used by mbed-cli for firmware update, but if customer wants to provide the bin explicitly, it should be the _update.bin.