# Running AGL on Intel Minnowboard (and most Intel 64 bits HW)

## Scope
This documentation is aiming at people who want to run Automotive Grade
Linux (AGL) on an Intel Hardware (HW). While the reference HW used by
AGL project is the Open Source Minnowboard.<br>
(http://wiki.minnowboard.org/MinnowBoard\_Wiki\_Home) this documentation
can be used to enable most of 64 bits Intel Architecture (IA) using UEFI
as boot loader. You need to run the 64 bits version of the UEFI boot.<br>
Minnowbaord Max and Turbo are both 64 bits capable.

**Note** this page is more focused on please willing to create
        bespoke AGL image and BSP. If you are more interested by Apps
        creation, please visit [ Developing
        Apps for AGL](https://wiki.automotivelinux.org/agl-distro/developer_resources_intel_apps)

UEFI has evolved a lot recently and you likely want to check that your
HW firmware is up-to-date, this is particularly important for the
Minnowboard.

` `[`https://firmware.intel.com/projects/minnowboard-max`](https://firmware.intel.com/projects/minnowboard-max)

## Where to find an AGL bootable image

### Building an AGL image from scratch using Yocto.

**Note:** An alternative method for building an image is to use
        the AGL SDK delivered in a Docker container. There is currently no SDK dedicated to IA 
        but the SDK provided for the Porter Board can build
        an IA image without changes (just aglsetup.sh needs to call for Intel).

see chapter 2 of [Porter Quick
Start](http://iot.bzh/download/public/2016/sdk/AGL-Kickstart-on-Renesas-Porter-board.pdf "wikilink").

#### Download AGL source code
Downloading the AGL sources from the various Git repositories is automated with the repo
tools [ to Repo
Documentation](https://source.android.com/source/using-repo.html "wikilink")

To install the repo tool.

```bash
  mkdir -p ~/bin
  export PATH=~/bin:$PATH\
  curl [https://storage.googleapis.com/git-repo-downloads/repo](https://storage.googleapis.com/git-repo-downloads/repo) > ~/bin/repo\
  chmod a+x ~/bin/repo
```



#### Configuring for the current *(older)* stable (blowfish\_2.0.4) (BB)

```bash
  cd AGL-2.0.4\
  repo init -u \
  [https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo](https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo) \
  -b blowfish \
  -m default_blowfish_2.0.4.xml
```
#### Configuring for master (CC)

```bash
  cd AGL-master\
  repo init -u [`https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo`](https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo)\
```

#### Only for developer working on virtualisation
**Note :** this is WIP and most likely to fail most of the time)
```bash
  cd AGL-master-next\
  repo init -b morty \
  -u `[`https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo`](https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo)
```

Once that you repo is initialised either with the stable or WIP, you
need to sync the repo to fetch the various git trees.

#### Downloading the configured AGL source code

```bash
  repo sync
```

#### Building the AGL distro
You are now ready to initialise your Yocto build. When running the
command

```bash
  source meta-agl/scripts/aglsetup.sh -h
```

You will notice the Intel entry

```bash
  intel-corei7-64
```
Simply select that entry to replace porter in the -m option.

```bash
  source meta-agl/scripts/aglsetup.sh \
  -m intel-corei7-64 \
  -b build \
  agl-devel agl-demo agl-appfw-smack agl-netboot
```

Start the build **This can take several hours depending of your CPU and
internet connection and will required several GB on /tmp as well as on your build directory**

```bash
  bitbake agl-demo-platform
```
** Your newly baked disk image (.hddimg) will be located at **
  `tmp/deploy/images/intel-corei7-64/`

##### Alternative: Download a *ready made* image from AGL web site

The Continuous Integration (CI) process from AGL creates and publish
daily and stable builds. Pointers to both can be found in [ AGL
supported HW](agl-distro: "wikilink") (see Reference BSP/Intel).

Once you have validated your process you can start to play/work with the
snapshot pointer.

Note that snapshot build may not work.

Follow the directory

` intel-corei7-64/deploy/images/intel-corei7-64/`

and download the file

` agl-demo-platform-intel-corei7-64.hddimg`

## Create a bootable media

Depending your target HW you will use an USB stick, an SD card or a
HDD/SDD. The creation process remains the same independently of the
selected support. It does require to have access to a Linux machine with
sudo or root password.

### Insert you removable media in the corresponding interface.

### Check the device name where the media can be accessed with the command

```bash
  lsblk\
  # Note that you want the name of the raw device not of a partition on the media \
  #(eg. /dev/sdc or /dev/mmcblk0)
```
### Download the script mkefi-agl.sh 
This script is present in the directory meta-agl/scripts from blowfish 2.0.4, alternatively you can download it from the following Git repo

` `[`https://github.com/dominig/mkefi-agl.sh`](https://github.com/dominig/mkefi-agl.sh)


### check the available option

```bash
  sh mkefi-agl.sh -v
```
### create your media with the command ajusted to your configuration

```bash
  sudo sh mkefi-agl.sh MyAglImage.hdd /dev/sdX
```
/dev/sdX is common for USB stick, /dev/mmcblk0 for lpatop integrated SD card reader

## Boot the image on the target device

1. Insert the created media with the AGL image in the target device

1. Power on the device

1. Select Change one off boot option (generally F12 key during power up)

1. Select your removable device

1. Let AGL boot

**Note:** depending on the speed of the removable media, the first boot
may not complete, in that case simply reboot the device. This is quite common with USB2 sticks.<br>
By default the serial console is configured and activated at the rate of 115200 bps.

## How to create your 1st AGL application

[ Apps development documentation
link](agl-distro:developer_resources_intel_apps "wikilink")