X86/Yocto BSP/QSG v1.1 - Revision history

Winston.huang: Created page with " {{DISPLAYTITLE:x86 Yocto BSP v1.1 Quick Start Guide}}

2022-07-12T07:29:50Z

Created page with " {{DISPLAYTITLE:x86 Yocto BSP v1.1 Quick Start Guide}} <div style="float:right; position:fixed; margin:0 1em 0 0; top5100px; right:10px; max-height: 400px; overflow: aut..."

New page

{{DISPLAYTITLE:x86 Yocto BSP v1.1 Quick Start Guide}}
<div style="float:right; position:fixed; margin:0 1em 0 0; top5100px; right:10px; max-height: 400px; overflow: auto">TOC</div>
== <span style="color:#0070c0">Host Machine</span> ==

It is recommended to use Ubuntu 18.04 LTS (Bionic Beaver) or Ubuntu 20.04 LTS (Focal Fosa) as host system, and CPU is Intel i5 degree or higher, memory size ≥ 16GB, free disk space ≥ 500GB.

=== Install docker ===
<syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker.io
systemctl status docker ## check if docker serivce is active
sudo usermod -aG docker $USER
sudo reboot
</syntaxhighlight>

<syntaxhighlight lang="bash">
docker version ## check docker version
</syntaxhighlight>

:Please refer to [https://docs.docker.com/engine/installation/ Docker Installation Guide] for details

=== Install pre-built docker image ===

If you want to build docker image from scratch, please skip this section.

Please refer to [[X86/Yocto_BSP/downloads|this page]] to get the '''pre-built docker image''' tarball(password is ProvidedByAdvantech).

Then do the following command.(Remember to replace the [[X86/Yocto_BSP/downloads#Yocto_3.1|<span style="color:#ff0000">${DATE}</span>]] with the exact date code)

<syntaxhighlight lang="bash">
docker load --input adv-x86-yocto-1.1-docker-image_${DATE}.tar.gz
</syntaxhighlight>

== <span style="color:#0070c0">Unpack Yocto BSP</span> ==

You should replace the following <span style="color:#ff0000">${BSP_TARBALL}</span> with the exact tarball name.
<syntaxhighlight lang="bash">
tar xvf ${BSP_TARBALL} -C ~/
</syntaxhighlight>

== <span style="color:#0070c0">Build Docker Image</span> ==

(The alternative way is to [[#Install_pre-built_docker_image|install the pre-built docker image]].)

<syntaxhighlight lang="bash">
cd ~/adv-x86-yocto-1.1
scripts/build_docker_image.sh
</syntaxhighlight>

== <span style="color:#0070c0">Put Download Files (optional)</span> ==

Please refer to [[X86/Yocto_BSP/downloads|this page]] to get '''downloads''' tarball(password is ProvidedByAdvantech).

Then do the following command to restore '''downloads''' to the specific directory.(Remember to replace the [[X86/Yocto_BSP/downloads#Yocto_3.1|<span style="color:#ff0000">${DATE}</span>]] with the exact date code)
<syntaxhighlight lang="bash">
tar xvf adv-x86-yocto-1.1-downloads_${DATE}.tar -C ~/adv-x86-yocto-1.1/yocto/build/
</syntaxhighlight>

== <span style="color:#0070c0">Build Yocto Image</span> ==

=== Start docker container ===
<syntaxhighlight lang="bash">
cd ~/adv-x86-yocto-1.1
./scripts/docker_run.sh
</syntaxhighlight>

=== Start building yocto image ===
<syntaxhighlight lang="bash">
cd yocto/build
source ../intel-embedded-system-enabling/oe-init-build-env ./
echo 'PARALLEL_MAKE = "-j 4"' >> conf/local.conf
bitbake -k mc:x86-adv-gui:advantech-image-gui
</syntaxhighlight>
:Please refer to [[X86/Yocto_BSP/FAQ_v1.1|FAQ]].

=== Stop docker container ===
<syntaxhighlight lang="bash">
exit ## or logout
</syntaxhighlight>

You can get the below files from the directory, '''~/adv-x86-yocto-1.1/yocto/build/tmp-x86-adv-gui-glibc/deploy/images/intel-corei7-64/'''.

:advantech-image-gui-intel-corei7-64.wic
:advantech-image-gui-intel-corei7-64.wic.bz2
:advantech-image-gui-intel-corei7-64.wic.bmap

== <span style="color:#0070c0">Create Install Image</span> ==

Get the [https://www.dropbox.com/sh/8hy4wxpah64t7ar/AAAqbDrkBjd61y0I5_o7qrNAa?dl=0 Create_Install_Image.sh](password is ProvidedByAdvantech), put it to the home directory and do the following commands

<syntaxhighlight lang="bash">
chmod +x ~/Create_Install_Image.sh
~/Create_Install_Image.sh
</syntaxhighlight>

And you will get the compressed install image.

:advantech-image-gui-intel-corei7-64_install.wic.bz2

== <span style="color:#0070c0">Create USB installer</span> ==

# Put the '''advantech-image-gui-intel-corei7-64_install.wic.bz2''' to windows computer.
# Extract advantech-image-gui-intel-corei7-64_install.wic.bz2 to '''advantech-image-gui-intel-corei7-64_install.wic'''.
# Plug USB drive to your computer.
# Download [https://www.balena.io/etcher/ balenaEtcher].
# Execute balenaEtcher, click “Flash from file“ to select the wic file, '''advantech-image-gui-intel-corei7-64_install.wic'''. <br/> [[File:flash_usb_s5-1.png]]<br/><br/>[[File:flash_usb_s5-2.png|800px]]
# Click “Change“ to select the USB drive which you want to flash, then click “Select(X)“<br/>[[File:flash_usb_s6-1.png]]<br/><br/>[[File:flash_usb_s6-2.png]]
# Click “Flash!“<br/>[[File:flash_usb_s7.png|800px]]
# While the “Flash Complete!” shows up, click “X” to close balenaEtcher.<br/>[[File:flash_usb_s8.png|800px]]

== <span style="color:#0070c0">Install to Target Device</span> ==
# Plug USB installer to this system and boot from USB drive.
# Open the '''Install_to_Target_Device.txt''' on desktop for easily copy&paste command to "Terminal".<br/>[[File:install_to_target_s2.png|800px]]<br/><br/>[[File:install_to_target_s2-2.png|700px]]
# Click "Terminal Emulator".<br/>[[File:install_to_target_s3.png]]
# Input the following command to show all disks .<syntaxhighlight lang="bash">
lsblk -ndo name,size,type
</syntaxhighlight>
# Input the following command to set which disk you would like to install.<syntaxhighlight lang="bash">
TARGET=XXX ## XXX means exact disk you would like to install, e.g. sda
</syntaxhighlight>
# Input the following command to flash image to target disk.<syntaxhighlight lang="bash">
sudo bmaptool copy --bmap advantech-image-gui-intel-corei7-64.wic.bmap advantech-image-gui-intel-corei7-64.wic.bz2 /dev/$TARGET
</syntaxhighlight><br/>[[File:install_to_target_s6.png|960px]]
# While system shows "bmaptool: info : 100% copied", turn off target device and remove USB drive.<br/>[[File:install_to_target_s7.png|960px]]
# After reboot, system boot into Yocto.

== <span style="color:#0070c0">Enable secure boot</span> ==
# Boot to BIOS, go to “Security-> Secure Boot-> Key Management”.<br>Check all “Secure Boot variable” is “No Keys”. If all of them are not “No Keys”.<br>Select “Reset To Setup Mode-> Yes”, system will auto reboot and clear all keys.<br/>[[File:secure_boot_1-1.png]]<br/><br/>[[File:secure_boot_1-2.png]]
# Reboot system to OS, during boot menu, select “chainload efi-secure-boot-lockdown” then press enter.<br/>[[File:secure_boot_2.png]]
# After sytem created Cert, it will reboot automactically.<br/>[[File:secure_boot_3.png]]
# Boot to BIOS again, go to “Security-> Secure Boot” enable “Secure Boot.”<br>Go to “Save & Exit” select “Save Changes and Exit”, system will auto reboot.<br/>[[File:secure_boot_4.png]]
# Reboot system to OS, open Terminal and use command “sudo mokutil –sb-state”. You will see “SecureBoot enabled”.<br/>[[File:secure_boot_5.png]]