Digi ConnectCore 6 User manual

ConnectCore® 6
Android/Yocto
Getting Started Guide

Revision history—90001397
Revision Date Description
A May, 2014 Initial release
B May, 2017 Updated branding and made editorial enhancements.
Trademarks and copyright
Digi, Digi International, and the Digi logo are trademarks or registered trademarks in the United
States and other countries worldwide. All other trademarks mentioned in this document are the
property of their respective owners.
© 2017 Digi International Inc. All rights reserved.
Disclaimers
Information in this document is subject to change without notice and does not represent a
commitment on the part of Digi International. Digi provides this document “as is,” without warranty of
any kind, expressed or implied, including, but not limited to, the implied warranties of fitness or
merchantability for a particular purpose. Digi may make improvements and/or changes in this manual
or in the product(s) and/or the program(s) described in this manual at any time.
Warranty
To view product warranty information, go to the following website:
www.digi.com/howtobuy/terms
Send comments
Documentation feedback: To provide feedback on this document, send your comments to
[e-mail].
Customer support
Digi Technical Support: Digi offers multiple technical support plans and service packages to help our
customers get the most out of their Digi product. For information on Technical Support plans and
pricing, contact us at +1 952.912.3444 or visit us at www.digi.com/support.
ConnectCore 6 Android/Yocto Getting Started Guide 2

Contents
Introduction
Step 1: Identify ConnectCore 6 hardware components
Step 2: Connect your ConnectCore 6 hardware
Step 3: Power-up your ConnectCore 6
Serial output 9
Video output 9
Step 4: Create a bootable microSD card from image
Create a bootable microSD card using the Linux OS 10
Create a bootable microSD card using the Windows OS 11
Step 5: Boot the ConnectCore 6 using a microSD card
Step 6: Update ConnectCore 6 firmware
Update eMMC with Yocto firmware images 14
Update eMMC with Android firmware images 15
What's Next?
Android 19
Yocto 19
ConnectCore 6 Android/Yocto Getting Started Guide 3

Introduction
This Getting Started Guide will help you through the procedure for booting your ConnectCore® 6 for the
very first time.
It covers the following topics:
nHardware components and connections
nPowering your ConnectCore 6 device
nCreating a bootable MicroSD card from an image
nBoot from a MicroSD card
nUpdate eMMC firmware
nWhat's next?
ConnectCore 6 Android/Yocto Getting Started Guide 4

Step 1: Identify ConnectCore 6 hardware
components
Identify the following components located in your ConnectCore 6 kit:
nConectCore 6 module: An SMD module with CPU, SDRAM, eMMC, and PMIC
nAdapter board: The board where the ConnectCore 6 module is soldered for connecting to a
Digi development board
nDevelopment board: A JSCCWMX53 development board with connectors
ConnectCore 6 Android/Yocto Getting Started Guide 5

Step 2: Connect your ConnectCore 6 hardware
Connect the hardware components of your ConnectCore 6:
1. Connect the serial cable to the UART port.
2. Connect the Ethernet cable to the Ethernet port on the adapter board.
3. Connect the LVDS cable from the LCD screen to the LVDS connector on the development board.
ConnectCore 6 Android/Yocto Getting Started Guide 6

Step 2: Connect your ConnectCore 6 hardware
ConnectCore 6 Android/Yocto Getting Started Guide 7
4. Connect the I2C cable from the LCD touch screen to the I2C connector on the development
board.
5. Connect the antenna to the primary connector (P14) on the development board.
6. (Optional) Connect the HDMI cable to a standard HDMI connector on the adapter board (J22).
7. Add the appropriate plug and connect the provided power supply (X24).
WARNING! Choose an HDMI cable with a low profile (or a 90 angle adapter) to
accomodate the nearby JTAG connector. Do not force the connection of the HDMI cable
to avoid breaking the connector.

Step 3: Power-up your ConnectCore 6
ConnectCore 6 Android/Yocto Getting Started Guide 8
Step 3: Power-up your ConnectCore 6
The ConnectCore 6 comes with Android OS pre-installed on the internal eMMC memory. Once you
switch on the board, it boots directly into the Android operating system.
Serial output 9
Video output 9

Step 3: Power-up your ConnectCore 6 Serial output
ConnectCore 6 Android/Yocto Getting Started Guide 9
Serial output
Open a serial terminal at 115200/8/N/1 to see the serial output and get the console terminal.
Video output
Android splash and desktop should appear on the LCD display. If you connected an HDMI monitor to
the adapter board, the image should appear cloned on the monitor (resolution scales to the resolution
of the connected LCD).

Step 4: Create a bootable microSD card from image Create a bootable microSD card using the Linux OS
ConnectCore 6 Android/Yocto Getting Started Guide 10
Step 4: Create a bootable microSD card from image
To complete this step you need the following:
nRoot/administrator permissions
nA MicroSD card with a minimum of 2 GB
WARNING! The following procedure will destroy existing data in the uSD card.
1. Download any bootable SD image (Android or Yocto) of your choice from the Product Support
tab at www.digi.com/cc6.
2. Extract the .sdcard file from the zip folder you downloaded, and place it in a folder of your
choice (this path will be referred to as [file_path] throughout the guide).
3. Write the image on the SD card.
Note The instructions you use to restore memory on your MicroSD card depends on your computer's
operating system. The following instructions explain how to restore your MicroSD card using Linux and
Windows OS.
Create a bootable microSD card using the Linux OS
To create a bootable MicroSD card using a Linux OS:
1. Insert the MicroSD card into your computer and check the node Linux assigns to it (/dev/
[sdcard]) using dmesg.
dmesg
[1413652.901270] sd 41:0:0:0: [sdc] 7744512 512-byte logical
blocks: (3.96 GB/3.69 GiB)
[1413652.903140] sd 41:0:0:0: [sdc] No Caching mode page
present
[1413652.903144] sd 41:0:0:0: [sdc] Assuming drive cache:
write through
[1413652.905638] sd 41:0:0:0: [sdc] No Caching mode page
present
[1413652.905642] sd 41:0:0:0: [sdc] Assuming drive cache:
write through
[1413652.915154] sdc: sdc1
Do not mount any partitions the card might contain (or unmount any partition if
automatically mounted) as you will be writing to the entire block device.
2. Write the image file to the MicroSD card with this command. Note that you must substitue
[file_path/filename.sdcard] with the path and filename to the SD card image. You also need to

Step 4: Create a bootable microSD card from image Create a bootable microSD card using the Windows OS
ConnectCore 6 Android/Yocto Getting Started Guide 11
substitute /dev/[sdcard] with the device node assigned by Linux to your SD card.
WARNING! An incorrect device node might destroy all data on your computer
hard drive.
sudo dd if=[file_path/filename.sdcard] of=/dev/[sdcard] bs=1M &&
sync
The MicroSD card is now ready for use.
Create a bootable microSD card using the Windows OS
To create a bootable MicroSD card using a Windows OS:
1. Download the Win32DiskImager software from
www.sourceforge.net/projects/win32diskimager/files/latest/download.
2. Uncompress the software and run it as Administrator.
3. Insert the MicroSD card into your computer.
4. In the software, select the drive that corresponds to the MicroSD card. Select the .sdcard
image file you want to program and click the Write button.
The MicroSD card is now ready to use.

Step 5: Boot the ConnectCore 6 using a microSD card Create a bootable microSD card using the Windows OS
ConnectCore 6 Android/Yocto Getting Started Guide 12
Step 5: Boot the ConnectCore 6 using a microSD card
To boot your ConnectCore 6 using your MicroSD card:
1. Insert the MicroSD card on the MicroSD card holder of the development board (X14).
2. On the Adapter board, change the boot configuration microswitches to boot from the MicroSD
card. The following image displays how the microswitches should be set: (from left to right)
OFF-ON | OFF-OFF-ON-OFF.
3. Power up the board.

Step 6: Update ConnectCore 6 firmware Create a bootable microSD card using the Windows OS
ConnectCore 6 Android/Yocto Getting Started Guide 13
Step 6: Update ConnectCore 6 firmware
The internal eMMC memory has preinstalled Android firmware images. To overwrite these with Yocto
or other Android images, follow these instructions:
1. Download any firmware images, (Android or Yocto) from the Product Support tab at
www.digi.com/cc6.
2. Extract the firmware image files from the zip file you downloaded into:
a. Use your TFTP server's exposed folder (typically /tftpboot) if you plan to update via
Ethernet TFTP.
b. Use a FAT formatted MicroSD card if you plan to update via MicroSD card on the
board.
3. On the Adapter board, change the boot configuration microswitches to boot from the internal
eMMC. The following image displays how the microswitches should be set: (from left to right)
OFF-ON | OFF-OFF-OFF-OFF.
4. Boot the device and immediately press a key in the serial terminal to stop the autoboot
process. You will be stopped at the U-boot bootloader prompt (shown below):
U-Boot 2013.04 - DUB-2.1.0.1 (Mar 14 2014 - 15:43:50)
CPU: Freescale i.MX6Q rev1.2 at 792 MHz
CPU: Temperature 25 C, calibration data: 0x53e4b569

Step 6: Update ConnectCore 6 firmware Update eMMC with Yocto firmware images
ConnectCore 6 Android/Yocto Getting Started Guide 14
Reset cause: WDOG
I2C: ready
DRAM: 1 GiB
MMC: FSL_SDHC: 0, FSL_SDHC: 1
In: serial
Out: serial
Err: serial
Board: ConnectCore 6 on the Adapter board
PMIC: DA9063, Device: 0x61, Variant: 0x50, Customer: 0x00,
Config: 0x56
Net: FEC [PRIME]
Hit any key to stop autoboot: 0
=>
Proceed with the following steps to update eMMC firmware with Yocto or Android firmware images.
Update eMMC with Yocto firmware images
1. Partition the eMMC for holding Yocto images by running:
=> setenv mmcdev 0
=> run partition_mmc_linux
2. Check the partition table created on the eMMC:
=> mmc part
Partition Map for MMC device 0 -- Partition Type: EFI
Part Start LBA End LBA Name
Attributes
Type UUID
Partition UUID
1 0x00001000 0x00020fff "linux"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: 43f1961b-ce4c-4e6c-8f22-2230c5d532bd
2 0x00021000 0x00040fff "linux2"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: f241b915-4241-47fd-b4de-ab5af832a0f6
3 0x00041000 0x00240fff "rootfs"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: 1c606ef5-f1ac-43b9-9bb5-d5c578580b6b
4 0x00241000 0x00440fff "rootfs2"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: c7d8648b-76f7-4e2b-b829-e95a83cc7b32
5 0x00441000 0x0075ffde "userfs"
attrs: 0x0000000000000000

Step 6: Update ConnectCore 6 firmware Update eMMC with Android firmware images
ConnectCore 6 Android/Yocto Getting Started Guide 15
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: ebae5694-6e56-497c-83c6-c4455e12d727
As shown above, five partitions are created in anticipation of holding a redundant system:
a. linux: To hold the kernel and device tree images.
b. linux2: To hold a copy (or alternative) kernel and device tree images.
c. rootfs: To hold the root file system.
d. rootfs2: To hold a copy (or alternative) root file system.
e. userfs: To hold user data.
Note The command only creates the partition table. Partitions are unformatted.
3. Write the desired file *.vfat to the eMMC Linux partition from one of the following:
a. From TFTP (assuming the file is on the TFTP server's exposed folder):
=> update linux tftp <filename>.vfat
b. Or from a FAT formatted MicroSD card (where you previously copied the file):
=> update linux mmc 1 fat <filename>.vfat
4. Write the desired file *.ext4 to the eMMC rootfs partition from one of the following:
a. From TFTP (assuming the file is on the TFTP server's exposed folder):
=> update rootfs tftp <filename>.ext4
a. Or from a FAT formatted MicroSD card (where you previously copied the file):
=> update linux mmc 1 fat <filename>.vfat
The new firmware is now ready on the eMMC. To boot it, simply type:
=> dboot linux mmc
Update eMMC with Android firmware images
The eMMC already comes with Android firmware preinstalled. Follow these instructions if you wish to
overwrite the eMMC with different Android firmware images.
1. Partition the eMMC for holding Android images by running:
=> setenv mmcdev 0
=> run partition_mmc_android

Step 6: Update ConnectCore 6 firmware Update eMMC with Android firmware images
ConnectCore 6 Android/Yocto Getting Started Guide 16
2. Check the partition table created on the eMMC:
=> mmc part
Partition Map for MMC device 0 -- Partition Type: EFI
Part Start LBA End LBA Name
Attributes
Type UUID
Partition UUID
1 0x00001000 0x00020fff "android"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: 43f1961b-ce4c-4e6c-8f22-2230c5d532bd
2 0x00021000 0x00040fff "android2"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: f241b915-4241-47fd-b4de-ab5af832a0f6
3 0x00041000 0x00140fff "system"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: 1c606ef5-f1ac-43b9-9bb5-d5c578580b6b
4 0x00141000 0x00240fff "system2"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: c7d8648b-76f7-4e2b-b829-e95a83cc7b32
5 0x00241000 0x00250fff "cache"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: ebae5694-6e56-497c-83c6-c4455e12d727
6 0x00251000 0x0075efff "data"
attrs: 0x0000000000000000
type: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
uuid: 3845c9fc-e581-49f3-999f-86c9bab515ef
As shown above, six partitions are created in anticipation of holding a redundant
system:
a. android: To hold kernel, device tree and Android init ramdisk images.
b. android2: To hold a copy (or alternative) kernel, device tree and Android init
ramdisk images.
c. system: To hold Android's root file system.

Step 6: Update ConnectCore 6 firmware Update eMMC with Android firmware images
ConnectCore 6 Android/Yocto Getting Started Guide 17
d. system2: To hold a copy (or alternative) Android's root file system.
e. cache: To hold Android cache.
f. data: To hold user data.
3. Write the file boot.img to the eMMC Android partition from one of the following:
a. From TFTP (assuming the file is on the TFTP server's exposed folder):
=> update android tftp boot.img
b. Or from a FAT formatted MicroSD card (where you previously copied the file):
=> update android mmc 1 fat boot.img
4. Write the file system.img to the eMMC system partition from one of the following:
a. From TFTP (assuming the file is on the TFTP server's exposed folder):
=> update system tftp system.img
b. Or from a FAT formatted MicroSD card (where you previously copied the file):
=> update system mmc 1 fat system.img
The new firmware is now ready on the eMMC. To boot it:
1. If the cache and data partitions are unformatted (or if you want existing data to be removed),
you need to force the format of these partitions with:
=> bootargs_once="androidboot.cache=format
androidboot.data=format"
Note If the cache and data partitions are already formatted and you wish to preserve
their contents, you can skip this command.
2. Boot it with the dboot command:
=> dboot android mmc

What's Next? Update eMMC with Android firmware images
ConnectCore 6 Android/Yocto Getting Started Guide 18
What's Next?
Now that you have successfully completed the steps to boot your ConnectCore 6, it's time to develop
your own system. Navigate to the Product Support tab at www.digi.com/cc6 to download and install
the latest version of Android or Yocto software for your ConnectCore 6 device. See the following
sections for further instructions on Android and Yocto development for your ConnectCore 6.
Android 19
Yocto 19

What's Next? Android
ConnectCore 6 Android/Yocto Getting Started Guide 19
Android
The software installation will leave a shortcut on your desktop called DigiESPTM for Android. Double
click the shortcut icon to start Eclipse IDE. On the Welcome page, click the First Steps link to guide
you through Android development with the ConnectCore 6.
Yocto
Go to the Product Support tab at www.digi.com/cc6 to download the Digi Embedded Yocto First
Steps document which will guide you through the installation and build of Yocto.