Digi recommends you program your images into the internal eMMC using the firmware update mechanism. You can also use U-Boot to program your device.

If your device is not booting U-Boot see Recover your device.

You can program the firmware from either TFTP or microSD:

Update firmware from TFTP

U-Boot bootloader allows you to update the firmware of your device over Ethernet. U-Boot uses the TFTP protocol to get the firmware images from a TFTP server running on your computer and programs them onto the eMMC of the device.

This update process requires a TFTP server running on your computer with a configured exposed folder. If you don’t have a running TFTP server, follow the installation instructions in Install Digi Embedded Yocto. The devices look for the firmware files in this folder when performing the update.

Once you have the TFTP server running on your computer, you can start the update process:

  1. Get the Yocto firmware images:

    • <u-boot-file>.imx for your hardware variant. See Hardware variants.

    • <boot-file>.boot.vfat

    • <recovery-file>.recovery.vfat

    • <rootfs-file>.rootfs.ext4

    1. After building the Yocto firmware, you can find the image files inside the project directory at:

      <project_folder>/tmp/deploy/images/<platform>

    2. You can download Digi provided pre-built images from:

  2. Copy the images in your TFTP server’s exposed folder (typically /tftpboot).

  3. Connect the board to your host computer. See Step 2 - Set up the hardware for instructions.

  4. Open a serial connection to the serial port to which the device is connected. Use the following settings:

    • Port: Serial port where your ConnectCore board is attached

    • Baud rate: 115200

    • Data Bits: 8

    • Parity: None

    • Stop Bits: 1

    • Flow control: None

  5. Reset the device (press the Reset button on the board) and immediately press a key in the serial terminal to stop the auto-boot process. You will be stopped at the U-Boot bootloader prompt:

U-Boot dub-2017.03-r2.1-git+g3e65181 (Nov 05 2018 - 03:53:30 +0000)

CPU:   Freescale i.MX6QP rev1.0 996 MHz (running at 792 MHz)
CPU:   Automotive temperature grade (-40C to 125C) at 44C
Reset cause: POR
I2C:   ready
DRAM:  2 GiB
MMC:   FSL_SDHC: 0 (eMMC), FSL_SDHC: 1
In:    serial
Out:   serial
Err:   serial
Model: Digi International ConnectCore 6 QuadPlus Single Board Computer.
ConnectCore 6 Plus SOM variant 0x01: Industrial QuadPlus-core 1GHz, 8GB eMMC, 2GB DDR3, -40/+85C, Wireless, Bluetooth, Kinetis
Board: ConnectCore 6 Plus SBC, version 3, ID 160
Boot device: MMC4
PMIC:  DA9063, Device: 0x61, Variant: 0x60, Customer: 0x00, Config: 0x56
Net:   FEC [PRIME]
Hit any key to stop autoboot:  0
=>
  1. Configure the network settings of the device by doing one of the following:

    • Get a dynamic IP address from a DHCP server by running the following commands:

      => setenv autoload no
      => dhcp
    • Configure a static IP address, where a.b.c.d is the IP address of your device:

      => setenv ipaddr a.b.c.d
  2. Configure the IP address of the machine where the TFTP server is running and save the configuration as follows, where w.x.y.z is your machine IP address where the TFTP server is running:

    => setenv serverip w.x.y.z
    => saveenv
  3. Update the U-Boot image (optional):

    1. Execute the following command to update the U-Boot image:

      => update uboot tftp <u-boot-file>.imx
    2. Reset the board to boot into the recently updated U-Boot, and press any key to stop the autoboot process.

    3. Reset the U-Boot environment to default values (this will not reset protected variables like the MAC address). To do so, issue this command:

      => env default -a
    4. Configure the network and TFTP settings on your device again and save the configuration.

  4. Configure the partition of the eMMC for holding Yocto images by running these commands:

    => setenv mmcdev 0
    => run partition_mmc_linux
  5. Update the boot image by executing this command:

    => update linux tftp <boot-file>.boot.vfat
  6. Update the root file system image by issuing this command:

    => update rootfs tftp <rootfs-file>.rootfs.ext4
  7. Update the recovery image by executing this command:

    => update recovery tftp <recovery-file>.recovery.vfat
  8. You can format the update partition or directly boot the new firmware:

    • To format the update partition, run the following commands. They boot in recovery mode to format the partition and then boots the device normally with the new firmware:

      => setenv recovery_command wipe_update
      => saveenv
      => run recoverycmd
    • If the update partition is already formatted or you want to preserve its contents, boot the device with the firmware you have just programmed:

      => boot

Update firmware from microSD

If you don’t have a TFTP server, you can still program Yocto in your device using a microSD card. The microSD card must be FAT formatted.

Your microSD card must have at least 2 GB of capacity.

To program Yocto from the microSD card:

  1. Power off the device.

  2. Change the boot source configuration to boot from the internal eMMC. To do so, set the boot mode micro-switches as follows:

    • BOOT.1 OFF

    • BOOT.2 OFF

      eMMC boot
  3. Get the Yocto firmware images:

    • <u-boot-file>.imx for your hardware variant. See Hardware variants.

    • <boot-file>.boot.vfat

    • <recovery-file>.recovery.vfat

    • <rootfs-file>.rootfs.ext4

    1. After building the Yocto firmware, you can find the image files inside the project directory at:

      <project_folder>/tmp/deploy/images/<platform>

    2. You can download Digi provided pre-built images from:

  4. Place the images in the root of the FAT formatted microSD card.

  5. Connect the board to your host computer. See Step 2 - Set up the hardware for instructions.

  6. Open a serial connection to the serial port the device is connected to. Use the following settings:

    • Port: Serial port where the device is attached

    • Baud rate: 115200

    • Data Bits: 8

    • Parity: None

    • Stop Bits: 1

    • Flow control: None

  7. Reset the device (press the Reset button on the board) and immediately press a key in the serial terminal to stop the auto-boot process. You will be stopped at the U-Boot bootloader prompt:

U-Boot dub-2017.03-r2.1-git+g3e65181 (Nov 05 2018 - 03:53:30 +0000)

CPU:   Freescale i.MX6QP rev1.0 996 MHz (running at 792 MHz)
CPU:   Automotive temperature grade (-40C to 125C) at 44C
Reset cause: POR
I2C:   ready
DRAM:  2 GiB
MMC:   FSL_SDHC: 0 (eMMC), FSL_SDHC: 1
In:    serial
Out:   serial
Err:   serial
Model: Digi International ConnectCore 6 QuadPlus Single Board Computer.
ConnectCore 6 Plus SOM variant 0x01: Industrial QuadPlus-core 1GHz, 8GB eMMC, 2GB DDR3, -40/+85C, Wireless, Bluetooth, Kinetis
Board: ConnectCore 6 Plus SBC, version 3, ID 160
Boot device: MMC4
PMIC:  DA9063, Device: 0x61, Variant: 0x60, Customer: 0x00, Config: 0x56
Net:   FEC [PRIME]
Hit any key to stop autoboot:  0
=>
  1. Optional. Update the U-Boot image:

    1. Execute the following command to update the U-Boot image:

      => update uboot mmc 1 fat <u-boot-file>.imx
    2. Reset the board to boot into the recently updated U-Boot, and press any key to stop the auto-boot process.

    3. Reset the U-Boot environment to default values (this will not reset protected variables like the MAC address). To do so, issue this command:

      => env default -a
    4. Save the U-Boot environment to apply the default configuration.

      => saveenv
  2. Configure the partition table of eMMC to hold Yocto images. To do so, execute these commands:

    => setenv mmcdev 0
    => run partition_mmc_linux
  3. Update the boot image by executing this command:

    => update linux mmc 1 fat <boot-file>.boot.vfat
  4. Wait until the process ends, then update the root file system image by issuing this command:

    => update rootfs mmc 1 fat <rootfs-file>.rootfs.ext4
  5. Wait until the process ends, then update the recovery image by executing this command:

    => update recovery mmc 1 fat <recovery-file>.recovery.vfat
  6. Change the default boot command in U-Boot to boot from the eMMC by issuing these commands:

    => setenv bootcmd dboot linux mmc
    => saveenv
  7. You can format the update partition or directly boot the new firmware:

    • To format the update partition, run the following commands. They boots in recovery mode to format the partition and then boots the device normally with the new firmware:

      => setenv recovery_command wipe_update
      => saveenv
      => run recoverycmd
    • If the update partition is already formatted or you want to preserve its contents, boot the device with the firmware you have just programmed:

      => boot