Quick start with prebuilt Linux microPlatform (LmP) images
This guide shows you how to get started with Pelion Edge and Linux microPlatform (LmP) using prebuilt images. LmP is a Yocto-built distribution maintained by Foundries.io. At the end of this tutorial, you will have downloaded and flashed an LmP image and provisioned and run Pelion Edge.
You can use this guide to try Pelion Edge on one of these boards:
Note: The prebuilt images are intended only for development or testing purposes; they aren't for production use. To build production images, please follow the build instructions and factory provisioning process.
Download the image
- Raspberry Pi 3 Model B+ (sha256sum: ebee2d1de414e8f2d4210ad54826fbe1a4aa5143c8f92138c5487d1ed2f8aee7).
- Raspberry Pi 4 (sha256sum: eb3207ac77436e91d2904f4402d534ca338d4082ad2119c752ec51b098e980ba).
- NXP i.MX 8M Mini EVK (sha256sum: edff189470cf4bb1070a1512eae6e287288d35aedb446ea9ef56183a52ff08a0).
- Avnet UltraZed-EG AES-ZU3EG-1-SK-G (sha256sum: 783d7674168f961e389b0ba871f7efe6a4517827d440233ca53bcb320af3b947).
Flash the image
console-image-lmp-<MACHINE_NAME>.rootfs.wic.gz to an SD card:
Be sure to verify your device's path. This example assumes the SD card is enumerated as
Make sure the SD card drive and its partitions, if any, are unmounted. To unmount all partitions, run the following command:
ls /dev/diskX?* | xargs -n1 diskutil umount
gunzip -c console-image-lmp-<MACHINE_NAME>.rootfs.wic.gz | sudo dd bs=4m of=/dev/diskX conv=sync
Alternatively, you can use the Etcher app, which can result in significant time savings over using
- Choose the file to flash.
- Choose the destination SD card.
- Click Flash.
Make sure the SD card drive and its partitions, if any, are unmounted. You can use
lsblkto find the name of your SD card block device. To unmount all partitions, run:
ls /dev/mmcblkX?* | xargs -n1 umount -l
gunzip -c console-image-lmp-<MACHINE_NAME>.rootfs.wic.gz | sudo dd bs=4M of=/dev/mmcblkX conv=fsync status=progress iflag=fullblock oflag=direct
Provision and run Pelion Edge
After preparing the SD card, you are ready to run Pelion Edge:
Insert the prepared SD card.
Power on the device.
Use the serial connection of your board to communicate with the device. Please consult the user's guide of your board on how to do this.
Modify the login credentials:
The default login user for the system is
fio. The default password is set to
fio. The user has sudo-permissions. To modify the default password, use the
passwdcommand after login.
Create and download a developer certificate to allow the edge gateway to connect to your Pelion account:
Go to Pelion Device Management Portal for your region:
Go to Device Identity > Certificates.
Create a developer certificate.
Download the certificate
Note: The downloaded developer certificate is confidential to your account. Store it securely in a place where unauthorized users can't access or use it.
Create the corresponding
update_default_resources.cfile to apply firmware updates to the gateway device:
For more information, please refer to the manifest tool README.
Secure copy the above file to the gateway, and place it at
scp mbed_cloud_dev_credentials.c update_default_resources.c [email protected]<gw-ip-address>:~/ ssh [email protected]<gw-ip-address> sudo mv *.c /userdata/mbed/
The gateway is now connected to Pelion Device Management.
sudo infoon the gateway to validate the connection and find the
You can view and access your gateway through the Pelion Device Management Portal.