diff options
Diffstat (limited to 'getting-started')
| -rw-r--r-- | getting-started/machines/intel.md | 108 |
1 files changed, 47 insertions, 61 deletions
diff --git a/getting-started/machines/intel.md b/getting-started/machines/intel.md index 310654c..9c71d87 100644 --- a/getting-started/machines/intel.md +++ b/getting-started/machines/intel.md @@ -2,88 +2,76 @@ ## 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> +Linux (AGL) on an Intel Hardware (HW). +While the reference HW used by AGL project is the Open Source Minnowboard. +This documentation [MinnowBoard wiki](http://wiki.minnowboard.org/MinnowBoard\_Wiki\_Home) +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. 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) +**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. +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) +[`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). +**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"). +see chapter 2 of [Porter QuickStart](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") +tools [ to RepoDocumentation](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 + mkdir -p ~/bin; + export PATH=~/bin:$PATH; + curl 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 + cd AGL-2.0.4; + repo init -u 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)\ + cd AGL-master; + repo init -u 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) +**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) + cd AGL-master-next; + repo init -b morty -u 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. +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 + repo sync; ``` #### Building the AGL distro -You are now ready to initialise your Yocto build. When running the -command +You are now ready to initialise your Yocto build. +When running the command: ```bash source meta-agl/scripts/aglsetup.sh -h @@ -109,34 +97,31 @@ internet connection and will required several GB on /tmp as well as on your buil ```bash bitbake agl-demo-platform ``` -** Your newly baked disk image (.hddimg) will be located at ** +** 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). +The Continuous Integration (CI) process from AGL creates and publish daily and stable builds. +Pointers to both can be found in [ AGL supported HW](https://wiki.automotivelinux.org/agl-distro) (see Reference BSP/Intel). -Once you have validated your process you can start to play/work with the -snapshot pointer. +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 +Follow the directory: ` intel-corei7-64/deploy/images/intel-corei7-64/` -and download the file +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. +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. @@ -147,16 +132,16 @@ sudo or root password. # 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 +### 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) +[https://github.com/dominig/mkefi-agl.sh](https://github.com/dominig/mkefi-agl.sh) ### check the available option ```bash - sh mkefi-agl.sh -v + sh mkefi-agl.sh -v; ``` ### create your media with the command ajusted to your configuration @@ -177,8 +162,9 @@ This script is present in the directory meta-agl/scripts from blowfish 2.0.4, al 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> +**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. By default the serial console is configured and activated at the rate of 115200 bps. ## How to create your 1st AGL application |