ConnectCore 6 Android/Yocto. Getting Started Guide

Size: px

Start display at page:

Download "ConnectCore 6 Android/Yocto. Getting Started Guide"

Beverley Gray
6 years ago
Views:

1 ConnectCore 6 Android/Yocto Getting Started Guide

2 Revision history 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 Digi International Inc. All rights reserved. Disclaimers Warranty 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. To view product warranty information, go to the following website: Send comments Documentation feedback: To provide feedback on this document, send your comments to techcomm@digi.com. 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 or visit us at ConnectCore 6 Android/Yocto Getting Started Guide 2

3 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

4 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: Hardware components and connections Powering your ConnectCore 6 device Creating a bootable MicroSD card from an image Boot from a MicroSD card Update emmc firmware What'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: ConectCore 6 module: An SMD module with CPU, SDRAM, emmc, and PMIC Adapter

5 Step 1: Identify ConnectCore 6 hardware components Identify the following components located in your ConnectCore 6 kit: ConectCore 6 module: An SMD module with CPU, SDRAM, emmc, and PMIC Adapter board: The board where the ConnectCore 6 module is soldered for connecting to a Digi development board Development 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.

6 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

7 Step 2: Connect your ConnectCore 6 hardware 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. ConnectCore 6 Android/Yocto Getting Started Guide 7

8 Step 3: Power-up your ConnectCore 6 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 ConnectCore 6 Android/Yocto Getting Started Guide 8

9 Step 3: Power-up your ConnectCore 6 Serial output Serial output Open a serial terminal at /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). ConnectCore 6 Android/Yocto Getting Started Guide 9

10 Step 4: Create a bootable microsd card from image Create a bootable microsd card using the Linux OS Step 4: Create a bootable microsd card from image To complete this step you need the following: Root/administrator permissions A 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 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 [ ] sd 41:0:0:0: [sdc] byte logical blocks: (3.96 GB/3.69 GiB) [ ] sd 41:0:0:0: [sdc] No Caching mode page present [ ] sd 41:0:0:0: [sdc] Assuming drive cache: write through [ ] sd 41:0:0:0: [sdc] No Caching mode page present [ ] sd 41:0:0:0: [sdc] Assuming drive cache: write through [ ] 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 ConnectCore 6 Android/Yocto Getting Started Guide 10

11 Step 4: Create a bootable microsd card from image Create a bootable microsd card using the Windows OS 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 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. ConnectCore 6 Android/Yocto Getting Started Guide 11

12 Step 5: Boot the ConnectCore 6 using a microsd card Create a bootable microsd card using the Windows OS 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. ConnectCore 6 Android/Yocto Getting Started Guide 12

Step 6: Update ConnectCore 6 firmware Create a bootable microsd card using the Windows OS Step 6: Update ConnectCore 6 firmware The internal emmc memory has preinstalled Android firmware images.

13 Step 6: Update ConnectCore 6 firmware Create a bootable microsd card using the Windows OS 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 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 DUB (Mar :43:50) CPU: CPU: Freescale i.mx6q rev1.2 at 792 MHz Temperature 25 C, calibration data: 0x53e4b569 ConnectCore 6 Android/Yocto Getting Started Guide 13

14 Step 6: Update ConnectCore 6 firmware Update emmc with Yocto firmware images 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 0x x00020fff "linux" attrs: 0x type: ebd0a0a2-b9e c0-68b6b72699c7 uuid: 43f1961b-ce4c-4e6c-8f c5d532bd 2 0x x00040fff "linux2" attrs: 0x type: ebd0a0a2-b9e c0-68b6b72699c7 uuid: f241b fd-b4de-ab5af832a0f6 3 0x x00240fff "rootfs" attrs: 0x type: ebd0a0a2-b9e c0-68b6b72699c7 uuid: 1c606ef5-f1ac-43b9-9bb5-d5c578580b6b 4 0x x00440fff "rootfs2" attrs: 0x type: ebd0a0a2-b9e c0-68b6b72699c7 uuid: c7d8648b-76f7-4e2b-b829-e95a83cc7b32 5 0x x0075ffde "userfs" attrs: 0x ConnectCore 6 Android/Yocto Getting Started Guide 14

15 Step 6: Update ConnectCore 6 firmware Update emmc with Android firmware images type: uuid: ebd0a0a2-b9e c0-68b6b72699c7 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 ConnectCore 6 Android/Yocto Getting Started Guide 15

16 Step 6: Update ConnectCore 6 firmware Update emmc with Android firmware images 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 0x x00020fff "android" attrs: type: uuid: 0x ebd0a0a2-b9e c0-68b6b72699c7 43f1961b-ce4c-4e6c-8f c5d532bd 2 0x x00040fff "android2" attrs: type: uuid: 0x ebd0a0a2-b9e c0-68b6b72699c7 f241b fd-b4de-ab5af832a0f6 3 0x x00140fff "system" attrs: type: uuid: 0x ebd0a0a2-b9e c0-68b6b72699c7 1c606ef5-f1ac-43b9-9bb5-d5c578580b6b 4 0x x00240fff "system2" attrs: type: uuid: 0x ebd0a0a2-b9e c0-68b6b72699c7 c7d8648b-76f7-4e2b-b829-e95a83cc7b32 5 0x x00250fff "cache" attrs: type: uuid: 0x ebd0a0a2-b9e c0-68b6b72699c7 ebae5694-6e56-497c-83c6-c4455e12d x x0075efff "data" attrs: type: uuid: 0x ebd0a0a2-b9e c0-68b6b72699c7 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. ConnectCore 6 Android/Yocto Getting Started Guide 16

17 Step 6: Update ConnectCore 6 firmware Update emmc with Android firmware images 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 ConnectCore 6 Android/Yocto Getting Started Guide 17

18 What's Next? Update emmc with Android firmware images 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 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 ConnectCore 6 Android/Yocto Getting Started Guide 18

19 What's Next? Android Android Yocto The software installation will leave a shortcut on your desktop called DigiESP TM 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. Go to the Product Support tab at to download the Digi Embedded Yocto First Steps document which will guide you through the installation and build of Yocto. ConnectCore 6 Android/Yocto Getting Started Guide 19

ConnectCore 6 U-Boot Customizations. Reference Manual

ConnectCore 6 U-Boot Customizations Reference Manual Revision history 90001422 Revision Date Description A August, 2014 Initial release B October, 2014 Added SBCv2 support; added carrier board version