Timesys Getting Started Guide for Intel Atom E3800

Getting Started Guide for Intel Atom E3800 Family (Baytrail)

Getting Started Guide for Intel Atom E3800 Family (Baytrail)

Timesys

Contents

Introduction

This document will describe in detail the procedures for booting a Linux kernel image and mounting a root file system from a hard disk on the Intel Atom E3800 Family (Baytrail).

This guide was tested with the Intel Atom E3800 Family (Baytrail) using the GRUB bootloader.

Please see the Additional Information section for instructions on using other bootloaders.

The following configurations are supported:

  • BIOS with Grub2 Bootloader (UEFI)

Prerequisites

Host Requirements

To properly boot a board using software from Timesys, your host machine must meet the following requirements:

  • Modern GNU/Linux Distribution. While you can use nearly any modern Linux distribution released in the last 24 months, Timesys recommends one of the following:
    • Ubuntu (Most recent release or LTS)
    • Fedora (Most recent release)
  • An internet connection on the Development Host.
  • Root or sudo permission on the Development Host.
  • A copy of the Linux Kernel (bzImage-5.15-ts-x86_64 ) and Root File System (rootfs.tar.gz) for the Target Board downloaded from Factory. These are found in the output directory of your online build, or in the directory build_x86_64-timesys-linux-<libc>/images/ on the command line.

Target Requirements

To boot the Intel Atom E3800 Family (Baytrail), you will need the following items:

  • Intel Atom E3800 Family (Baytrail) Board
  • USB key or SATA drive
  • USB keyboard
  • VGA/DVI monitor and cable

Once you have all of the necessary components, you should perform the following steps:

  1. Connect the board to the monitor.
  2. Connect the USB keyboard to one of the available USB ports on the board.
  3. Connect the power supply to your board.

Preparing the Target

Installing Boot Images to your Hard Disk

You must install the root file system, kernel image, and GRUB image to the hard disk.

If you are using an EFI-enabled BIOS, use the following guide:

/docs/engineering/wiki/HOWTO_Install_GRUB2_with_EFI_support

If you are using a non-EFI BIOS, use the following guide:

/docs/wiki/engineering/howto_install_grub_built_by_the_factory

NOTE: The default Timesys builds provide an EFI GRUB2 image by default. You must use the Desktop Factory to produce the non-EFI image.

Preparing the Host

No additional host setup is required to boot from hard disk.

Booting the Board

If you followed the instructions in /docs/wiki/engineering/howto_install_grub_built_by_the_factory, your board should boot to a Linux kernel automatically. However, you may wish to modify your boot process, or enable a serial console in the kernel. These instructions detail how to manually boot a kernel from GRUB. For more information on Grub, see http://www.gnu.org/software/grub/.

Set your Root Partition

Grub commands affect the active partition. In order to load your kernel, you must set your hard drive RFS partition as active. Non-EFI Grub:

grub>set root=(hd0,1)

EFI Grub:

grub>set root=(hd0,2)

Load The Kernel

You can use kernel command load the kernel that is on the hard disk.

Example

Non-EFI Grub:

grub> linux /boot/bzImage-5.15-ts-x86_64 root=/dev/sda1 rw root=/dev/sda1 rw rootwait console=tty0,115200

EFI Grub:

grub> linux /boot/bzImage-5.15-ts-x86_64 root=/dev/sda2 rw root=/dev/sda1 rw rootwait console=tty0,115200

Boot The Kernel

Use the boot command to boot the loaded kernel image.

grub> boot

Additional Information

Factory Documentation

Bootloaders

There are a number of supported bootloaders on this platform. Use the following guides to use them: