Difference between revisions of "CM-FX6: Android: Getting started"

From Compulab Mediawiki
Jump to: navigation, search
(Preconditions)
 
(Advanced installation options)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Preconditions ==
+
== Overview ==
* PC workstation
+
The following outlines the procedure necessary to install Android on the CompuLab CM-FX6 System-on-Module / Computer-on-Module.
* CM-FX6 evaluation kit [[Media:CM-FX6_Properly_Connected2.jpg|properly connected]]
 
* SD-Card with minimal capacity of 2GB, which will serve as the boot source
 
  
== Creating a bootable SD-Card ==
+
== Installation target media ==
* Download the compressed [http://compulab.co.il/products/computer-on-modules/cm-fx6/#devres SD-Card image].<br/>Ensure the integrity of the downloaded file by testing its MD5 summary.<br/>
+
CM-FX6 may use either SD card (P6) or SATA SSD as root file system.  
* Unzip the file in order to get the ''dd'' image.<br/>
 
* Copy the bootable image to the SD-Card following the [https://help.ubuntu.com/community/Installation/FromImgFiles instructions provided] for selection of operating systems.<br/>If you are running Linux, you might prefer the instructions below:<br/>
 
  # dd if=cmfx6-android.img of=/dev/sdc
 
  
== Boot ==
+
== Installation onto SD card ==
* Insert the bootable SD-Card into P6 SD-Card slot.
+
=== Preconditions ===
* Power on.<br/>Press '''RESET''' while '''BOOT SELECT''' is pressed.
+
* [[Media:CM-FX6_Properly_Connected2.jpg|Properly connected]] CM-FX6 evaluation kit with valid U-Boot.
* Within 3 seconds the device should start booting into Android.<br/>Within 60 seconds the HDMI display should start showing ''signs of life''.
+
* SD-Card with minimal capacity of 2GB, which will serve as boot medium and root file system.
===Advanced boot===
+
* PC workstation for creating bootable SD-Card.
By default CM-FX6 uses HDMI display with 1080p resolution.<br/>
 
This can be changed by providing alternate boot arguments to the Android/Linux kernel.
 
* Connect to the serial console as explained in the [[CM-FX6: Android: Serial console connection | Development]] section.
 
* Press ENTER to stop the countdown.
 
    setenv videomode video=mxcfb0:dev=ldb,if=RGB24,1280x720M@60 fbmem=28M      # DVI display with 720p resolution
 
    setenv videomode video=mxcfb0:dev=hdmi,if=RGB32,1920x1080M@60 fbmem=48M    # default video mode
 
* Type in '''boot''' to proceed to kernel boot overriding default video mode.
 
  
== Upon first boot ==
+
=== Prepare bootable SD-Card ===
* Any Android system performs ''first boot ceremony'' where it introduces its main controls - CompuLab's release is no different.
+
* Download prebuilt [http://compulab.co.il/products/computer-on-modules/cm-fx6/#devres Android image].
* With no delay, enable ''Settings->Developer options->Stay awake (...) while charging'' - this will prevent the device from entering ''not yet well managed'', ''hard to wake from'' sleep.
+
* Unzip the file in order to get ''dd'' image.<br/>
 +
* Flash the bootable image to the SD-Card following the [https://help.ubuntu.com/community/Installation/FromImgFiles directions].
 +
: On Linux, the instructions below may be used instead:
 +
<pre>
 +
# dd if=cmfx6-android.img of=/dev/sdc bs=4M
 +
</pre>
  
[[Category:Android|Getting started]]
+
=== Boot ===
[[Category:CM-FX6|Android: Getting started]]
+
* Insert bootable SD-Card into SD-Card slot (P6).
 +
* Power on.
 +
* Within 3 seconds the device should start booting into Android.
 +
: Within 60 seconds the HDMI display should start showing ''signs of life''.
 +
 
 +
== Installation onto SSD ==
 +
=== Preconditions ===
 +
* [[Media:CM-FX6_Properly_Connected2.jpg|Properly connected]] CM-FX6 evaluation kit with valid U-Boot.
 +
* SD-Card with minimal capacity of 2GB, which will serve as installer file system.
 +
* PC workstation for creating bootable SD-Card.
 +
 
 +
=== Prepare installer SD card ===
 +
* Download prebuilt [http://compulab.co.il/products/computer-on-modules/cm-fx6/#devres installer image].
 +
* Uncompress the file in order to get ''dd'' image.
 +
* Flash the bootable image to the SD-Card following the [https://help.ubuntu.com/community/Installation/FromImgFiles directions].
 +
: On Linux, the instructions below may be used instead:
 +
<pre>
 +
# dd if=cm-fx6_android-ssd-installer.img of=/dev/sdc bs=4M
 +
</pre>
 +
 
 +
=== Launch installer ===
 +
* Insert the bootable SD card into the CM-FX6 SD socket (P6) and turn the device on.
 +
* CM-FX6 will automatically boot into the installer LXDE desktop.
 +
* Double click on the CM-FX6 Image Installer icon to begin installation and follow the installation wizard directions.
 +
 
 +
=== Boot ===
 +
* After the installation is complete, shut down CM-FX6 and remove the installation SD card.
 +
* Restart CM-FX6.
 +
{{Note | If the installation SD card is not removed, CM-FX6 will boot into the installer once again.}}
 +
* Within 3 seconds the device should start booting into Android.
 +
: Within 60 seconds the HDMI display should start showing ''signs of life''.
 +
 
 +
=== Advanced installation options ===
 +
As CM-FX6 is developer-oriented device, the installation process and installer script itself can be customized, in order to fit customer's specific requirements.<br/>
 +
The following section provides an insight into interactive installation process and installer implementation.
 +
 
 +
==== Installation wizard GUI ====
 +
In the process of installation, the user is presented with a few dialogue windows.<br/>
 +
In the top part of each window a brief description is provided.<br/>
 +
The main stations in the installation process are:
 +
* Target device selection - currently, only SATA SSD may be presented.
 +
* Default partition size overriding - resizing the Android file system partitions, keep in mind:
 +
** ''userdata'' - is where user applications are installed, and where user content (such as downloaded files, recorded video or audio, etc.) is stored
 +
** resizing additional partitions can hardly be benefited
 +
* Default video mode setting - select LCD, HDMI or DVI video output and its resolution. It is possible to override this setting later, following the ''display configuration'' [[CM-FX6: Android: Operating instructions#Display configuration | directions]].
 +
 
 +
==== Installer script structure ====
 +
Below provided particular details about installer script structure:
 +
* The installer is located within installer file system, under<br/>
 +
:<code>/var/opt/utilite-installer/Android/cm-fx6-<release ID></code>
 +
* The interactive installer consists of 2 phases:
 +
** '''fs-inflate-gui:''' interactive GUI, that overrides default values in a configuration file
 +
** '''fs-inflate:''' non-interactive installer script, that follows the configuration file, partitions the destination medium, formats it and copies the OS files
 +
* For additional details on the Android installation process on CM-FX6, it is recommended to refer either to the installer script source code, or to the [[CM-FX6: Android: Building from source code | Building from source code]] page.
 +
 
 +
== See Also ==
 +
* [[CM-FX6: Android: Serial console connection]]
 +
* [[Android: ADB setup]]
 +
* [https://help.ubuntu.com/community/Installation/FromImgFiles Installing SD Card image]
 +
 
 +
[[Category:Android]]
 +
[[Category:CM-FX6]]

Latest revision as of 09:18, 17 December 2014

Overview

The following outlines the procedure necessary to install Android on the CompuLab CM-FX6 System-on-Module / Computer-on-Module.

Installation target media

CM-FX6 may use either SD card (P6) or SATA SSD as root file system.

Installation onto SD card

Preconditions

  • Properly connected CM-FX6 evaluation kit with valid U-Boot.
  • SD-Card with minimal capacity of 2GB, which will serve as boot medium and root file system.
  • PC workstation for creating bootable SD-Card.

Prepare bootable SD-Card

  • Download prebuilt Android image.
  • Unzip the file in order to get dd image.
  • Flash the bootable image to the SD-Card following the directions.
On Linux, the instructions below may be used instead:
# dd if=cmfx6-android.img of=/dev/sdc bs=4M

Boot

  • Insert bootable SD-Card into SD-Card slot (P6).
  • Power on.
  • Within 3 seconds the device should start booting into Android.
Within 60 seconds the HDMI display should start showing signs of life.

Installation onto SSD

Preconditions

  • Properly connected CM-FX6 evaluation kit with valid U-Boot.
  • SD-Card with minimal capacity of 2GB, which will serve as installer file system.
  • PC workstation for creating bootable SD-Card.

Prepare installer SD card

  • Download prebuilt installer image.
  • Uncompress the file in order to get dd image.
  • Flash the bootable image to the SD-Card following the directions.
On Linux, the instructions below may be used instead:
# dd if=cm-fx6_android-ssd-installer.img of=/dev/sdc bs=4M

Launch installer

  • Insert the bootable SD card into the CM-FX6 SD socket (P6) and turn the device on.
  • CM-FX6 will automatically boot into the installer LXDE desktop.
  • Double click on the CM-FX6 Image Installer icon to begin installation and follow the installation wizard directions.

Boot

  • After the installation is complete, shut down CM-FX6 and remove the installation SD card.
  • Restart CM-FX6.
Admolition note.png If the installation SD card is not removed, CM-FX6 will boot into the installer once again.
  • Within 3 seconds the device should start booting into Android.
Within 60 seconds the HDMI display should start showing signs of life.

Advanced installation options

As CM-FX6 is developer-oriented device, the installation process and installer script itself can be customized, in order to fit customer's specific requirements.
The following section provides an insight into interactive installation process and installer implementation.

Installation wizard GUI

In the process of installation, the user is presented with a few dialogue windows.
In the top part of each window a brief description is provided.
The main stations in the installation process are:

  • Target device selection - currently, only SATA SSD may be presented.
  • Default partition size overriding - resizing the Android file system partitions, keep in mind:
    • userdata - is where user applications are installed, and where user content (such as downloaded files, recorded video or audio, etc.) is stored
    • resizing additional partitions can hardly be benefited
  • Default video mode setting - select LCD, HDMI or DVI video output and its resolution. It is possible to override this setting later, following the display configuration directions.

Installer script structure

Below provided particular details about installer script structure:

  • The installer is located within installer file system, under
/var/opt/utilite-installer/Android/cm-fx6-<release ID>
  • The interactive installer consists of 2 phases:
    • fs-inflate-gui: interactive GUI, that overrides default values in a configuration file
    • fs-inflate: non-interactive installer script, that follows the configuration file, partitions the destination medium, formats it and copies the OS files
  • For additional details on the Android installation process on CM-FX6, it is recommended to refer either to the installer script source code, or to the Building from source code page.

See Also