Guides for using the Baserock GENIVI Baseline
- How to run GENIVI Baseline for x86_64
- How to build GENIVI Baseline for x86_64
- How to run GENIVI Baseline for NVIDIA Jetson
- How to run GENIVI Baseline for ARMv7-versatile using QEMU with ARM emulation
- How to build GENIVI Baseline for ARMv-7
- How to run Weston in Baserock GENIVI Baseline
- How to run Weston ivi-shell in Baserock GENIVI Baseline
How to run GENIVI Baseline for x86_64
Run the system:
1. Download the system image
wget http://download.baserock.org/baserock/baserock-current-genivi-baseline-system-x86_64-generic.img.gz
2. Decompress the system image
gunzip -c baserock-current-genivi-baseline-x86_64.img.gz > baserock-current-genivi-baseline-x86_64.img
3. Configure a virtual machine
Once you have the image, you can set up a Virtual Machine in which to run Baserock GENIVI Baseline x86_64.
How to build GENIVI Baseline for x86_64
To build the GENIVI Baseline system for x86_64 you will need a Baserock Development system running. See quick-start for notes of how to create a Baserock Development Virtual Machine.
Building the x86_64 baseline
Note: The next steps should be performed within the development VM.
0. Login as root in the VM.
1. Configure Morph to use the latest version
To be able to build the system, you have to use the latest Morph.
2. Clone the definitions
git clone git://git.baserock.org/baserock/baserock/definitions --branch master
3. Build the system
cd master
morph build systems/genivi-baseline-system-x86_64-generic.morph
Testing the x86_64 baseline
To use the built system, it must first be turned into a useful format by deploying it.
1. Deploy the rootfs
Run this command, in the same directory that you ran morph build
, to deploy
to a raw disk image:
morph deploy clusters/release.morph genivi-baseline-system-x86_64-generic.morph
2. Copy the rootfs to your host machine
After it has been deployed, you can copy it out of your virtual machine. The simplest way would be with scp:
scp genivi-baseline-system-x86_64-generic.img <USER>@<HOST-SYSTEM>:<PATH-TO-ROOTFS.img>
3. Boot your built system
Once you have the image copied in your system you can set up a Virtual Machine in which to run your built system.
How to run GENIVI Baseline for NVIDIA Jetson
How to run GENIVI Baseline for ARMv7-versatile using QEMU with ARM emulation
Run the system:
1. Download the rootfs and the kernel for the development system
wget http://download.baserock.org/baserock/baserock-current-genivi-baseline-armv7-versatile.img.gz
wget http://download.baserock.org/baserock/baserock-current-genivi-baseline-armv7-versatile.zImage
2. Extract the rootfs
gunzip -c baserock-current-genivi-baseline-armv7-versatile.img.gz > baserock-current-genivi-baseline-armv7-versatile.img
3. Clone the script to boot the .img files
git clone git://trove.baserock.org/baserock/baserock/genivi-initial-setup
4. Use the script to boot your image
This script will boot the baserock-current-genivi-baseline-armv7-versatile system.
cd genivi-initial-setup
./run-built-arm-image.sh ../baserock-current-genivi-baseline-armv7-versatile.zImage ../baserock-current-genivi-baseline-armv7-versatile.img
After this, you should see a QEMU window open and boot the ARM Baserock Genivi Baseline image.
How to build GENIVI Baseline for ARMv-7
Note: Support for Baserock ARM systems was not provided for F-1.0.
Setting up am ARMv7-versatile development system
Note: This step is to be executed on an x86 host machine that has QEMU with ARM emulation support, and 'tap' installed.
In order to create a Baserock development VM, you'll need about 35GB of free space on your host. It makes sense to start in a new, empty directory.
1. Download the rootfs and the kernel for the development system
wget http://download.baserock.org/baserock/baserock-11-devel-system-armv7-versatile.img.gz
wget http://download.baserock.org/baserock/baserock-11-devel-system-armv7-versatile.zImage
2. Extract the rootfs
gunzip -c baserock-11-devel-system-armv7-versatile.img.gz > baserock-11-devel-system-armv7-versatile.img
3. Clone the script to boot the .img files
git clone git://trove.baserock.org/baserock/baserock/genivi-initial-setup
4. Use the script to boot your image
This script will check out the Foton 1.2 version of the script and boot the baserock-11-devel-armv7-versatile system.
cd genivi-initial-setup
git checkout F-1.2
./run-built-arm-image.sh ../baserock-11-devel-system-armv7-versatile.zImage ../baserock-11-devel-system-armv7-versatile.img
After this, you should see a QEMU window open and boot the ARM Baserock development image.
Building the ARMv7-versatile baseline
Note: The next steps should be performed within the development VM.
0. Login as root in the VM.
1. Configure Morph to use the latest version
To be able to build the system, you have to use the latest Morph.
2. Setup network
For the network work properly, you may need to remove the eth0 configuration from the interfaces file and write your own resolv.conf
sed -i '3,$d' /etc/network/interfaces
cat >/etc/resolv.conf <<EOF
nameserver 8.8.8.8
EOF
Now close the QEMU window and start the VM again.
3. Clone the definitions
git clone git://git.baserock.org/baserock/baserock/definitions --branch master
4. Build the system
cd definitions
morph build systems/genivi-baseline-system-armv7-versatile.morph
Testing the ARMv7-versatile baseline
To use the built system, it must first be turned into a useful format by deploying it.
1. Deploy the rootfs
Run this command, in the same directory that you ran morph build
, to deploy
to a raw disk image:
morph deploy clusters/release.morph genivi-baseline-system-x86_64-armv7lhf-versatile
2. Copy the rootfs to your host machine
After it has been deployed, you can copy it out of your virtual machine. The simplest way would be with scp:
scp genivi-baseline-system-x86_64-armv7lhf-versatile.img <USER>@<HOST-SYSTEM>:<PATH-TO-ROOTFS.img>
3. Copy the kernel to your host machine
The built kernel can be found by performing:
ls -t /src/cache/artifacts/*kernel | head -1
Copy that file out however is most convenient, e.g. with scp:
scp `ls -t /src/cache/artifacts/*kernel | head -1` <USER>@<HOST-SYSTEM>:<PATH-TO-KERNEL.zImage>
4. Boot your built system
Note: This step is to be executed on an x86 host machine that has QEMU with ARM emulation support, and 'tap' installed
Boot the new system in the exact same way as the old one:
./run-built-arm-image.sh <PATH-TO-KERNEL.zImage> <PATH-TO-ROOTFS.img>
How to run Weston in Baserock GENIVI Baseline
weston
How to run Weston ivi-shell in Baserock GENIVI Baseline
To try out the weston ivi-shell:
mkdir .config
cp /usr/share/doc/weston/ivi-shell-weston.ini .config/weston.ini
and run weston as above.