diff options
| -rw-r--r-- | getting-started/machines/intel.md | 187 |
1 files changed, 187 insertions, 0 deletions
diff --git a/getting-started/machines/intel.md b/getting-started/machines/intel.md new file mode 100644 index 0000000..34604bf --- /dev/null +++ b/getting-started/machines/intel.md @@ -0,0 +1,187 @@ +# 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") |