Outils pour utilisateurs
Ceci est une ancienne révision du document !
Table des matières
Introduction
This article describes how to integrate Xenomai debian package build steps in a bash script. It is just an automatisation/scripting work. All commands are derivated from excellent Xenomai tutorials. I really recommend reading this tutorials to understand how Xenomai/Adeos work.
You can find script usage in the first chapter. The second chapter contains a sub-chapter by script function to give a more intrusive description of the script. Enjoy. ;)
Links
Hardware used :
- Roboard RB-100 : http://www.roboard.com/RB-100.htm
- USB Key or SD card with Ubuntu 10.04 for roboard
- A desktop PC running Ubuntu >=10.04
- An internet connection.
Downloads :
Usage
Running build_xeno_kernel.sh without any option, will retrieve the last stable Xenomai version, the last stable Adeos patch and the kernel corresponding to this patch. As there is no kernel configuration file specified in options, the kernel configuration menu will be displayed.
./build_xeno_kernel.sh
Adding ”-c <kernel_config_file>” will do the same steps than previous but it will not display kernel configuration menu. If the kernel configuration file provided is for an older kernel version, some questions could be asked due to new options not present in previous kernel :
./build_xeno_kernel.sh -c config-2.6.37.6.txt
You can also force the kernel version with option ”-k <kernel_version>”. The corresponding Adeos patch will then be downloaded :
./build_xeno_kernel.sh -k 2.6.37.6
And you can also mix options like apply a kernel configuration file to a choosen kernel :
./build_xeno_kernel.sh -k 2.6.37.6 -c config-2.6.37.6.txt
You can use the development version of Xenomai, directly cloned from Xenomai git repository, with option ”-d” :
./build_xeno_kernel.sh -d
Here is the usage for less important options :
$ ./build_xeno_kernel.sh -h This script build xenomai packages for debian/ubuntu distros. ./build_xeno_kernel [-a <arch>] [-h] [-c <kernel_config_file>] [-d] [-k <kernel_version>] Options: -a <arch> Wanted architecture -h Display this help message -c <kernel_config_file> Use this kernel configuration file to apply -d Download development version of Xenomai -k <kernel_version> Use this kernel version
Script functions
Each sub chapter describes important functions from the script. For each function, you will find its source code and new files created.
For new files created, consider we run the script with a valid configuration file for kernel 2.6.37.6. The command line is :
$ ./build_xeno_kernel.sh -k 2.6.37.6 -c config-2.6.37.6
The filesystem tree at the beginning just contains the script itself and the kernel configuration file :
. |-- build_xeno_kernel.sh `-- config-2.6.37.6 0 directories, 2 files
Get Xenomai
The start point is to get Xenomai. I decided to download the last stable release by default. But if the flag dev_version is set then the script download the development version from git. Choosing the stable version is in TODOs for now.
Two important variables are set here and will be used further :
- xenomai_version which is just the Xenomai version as its name implies. It will be used for debian package versioning.
- xenomai_directory which contains the xenomai sources path.
A the end of this function, xenomai sources are ready to be used.
get_xenomai() { if [ "1" = "${dev_version}" ]; then git clone http://git.xenomai.org/xenomai-head.git xenomai_version="head" else wget -q -nd -c -r -np -nc -A "LATEST-IS-v*.tar.bz2" http://download.gna.org/xenomai/stable/ # Untar xenomai xenomai_file=$(ls LATEST-IS-v*.tar.bz2 | sort | tail -1) xenomai_version=$(echo ${xenomai_file:11} | sed s/.tar.bz2//) tar xjpf LATEST-IS-v${xenomai_version}.tar.bz2 fi xenomai_directory=xenomai-${xenomai_version} }
Resulting filesystem :
. |-- build_xeno_kernel.sh |-- config-2.6.37.6 |-- LATEST-IS-v2.5.6.tar.bz2 `-- xenomai-2.5.6 136 directories, 2074 files
Get Adeos patch
If you do not know what is Adeos for, read this. If you do not see how it deals with Xenomai, read this one.
As the kernel version can be specified on script command line, there are two possibilities :
- The kernel version is specified in kernel_version variable. Then the script is looking for the last stable adeos patch that suits to this kernel and download it. If there is several patch available for a same kernel, it downloads the most recent.
- The kernel version is not specified then kernel_version variable is empty. The script downloads the last available Adeos patch. From the patch name, it determines the needed kernel and downloads it. The kernel version is set in kernel_version variable.
At the end of this function, Adeos patch is downloaded and kernel version is known through kernel_version variable.
get_adeos_patch() { if [ "" != "${kernel_version}" ]; then wget -nv -nd -c -r -np -nc -A "adeos-ipipe-${kernel_version}-${arch}-*.patch" http://download.gna.org/adeos/patches/v2.6/${arch}/ mv adeos-ipipe-*-${arch}-*.patch ${xenomai_directory}/ksrc/arch/${arch}/patches/ adeos_patch=$(ls -1 xenomai-${xenomai_directory}/ksrc/arch/${arch}/patches/ | grep "adeos-ipipe-${kernel_version}-${arch}-.*\.patch" | sort | tail -1) else wget -nv -nd -c -r -np -nc -A "adeos-ipipe-*-${arch}-*.patch" http://download.gna.org/adeos/patches/v2.6/${arch}/ mv adeos-ipipe-*-${arch}-*.patch ${xenomai_directory}/ksrc/arch/${arch}/patches/ adeos_patch=$(ls -1 ${xenomai_directory}/ksrc/arch/${arch}/patches/ | grep "adeos-ipipe-.*-${arch}-.*\.patch" | sort | tail -1) # Extract kernel version from patch file name if not specified kernel_version=$(echo ${adeos_patch} | cut -d'-' -f3) fi }
Resulting filesystem :
. |-- build_xeno_kernel.sh |-- config-2.6.37.6 |-- LATEST-IS-v2.5.6.tar.bz2 |-- tree.txt `-- xenomai-2.5.6 |-- ksrc | |-- arch | | `-- x86 | | |-- patches | | | |-- adeos-ipipe-2.6.37.6-x86-2.9-01.patch | | | |-- adeos-ipipe-2.6.37.6-x86-2.9-02.patch 136 directories, 2076 files
Get Linux kernel
It is the simpliest function from the script. With the variable kernel_version from the previous function get_adeos_patch, the script downloads the kernel from the official kernel repository.
get_kernel() { kernel_url="http://www.kernel.org/pub/linux/kernel/v2.6/linux-${kernel_version}.tar.bz2" wget -c -nc $kernel_url }
Resulting filesystem :
. |-- build_xeno_kernel.sh |-- config-2.6.37.6 |-- LATEST-IS-v2.5.6.tar.bz2 |-- linux-2.6.37.6.tar.bz2 |-- tree.txt `-- xenomai-2.5.6 |-- ksrc | |-- arch | | `-- x86 | | |-- patches | | | |-- adeos-ipipe-2.6.37.6-x86-2.9-01.patch | | | |-- adeos-ipipe-2.6.37.6-x86-2.9-02.patch 136 directories, 2077 files
Build the Kernel
This function has 4 steps :
- Untar the kernel archive the script has downloaded in get_kernel function.
- Patch the kernel with the Xenomai script using the Adeos patch we download with get_adeos_patch function.
- Configure the kernel. Here three cases are possible :
- A kernel config file is specified and suits to the downloaded kernel version. The kernel config file is copied into the linux kernel source directory and the kernel is ready to be built.
- A kernel config file is specified but its version is older than the downloaded kernel version. Some questions could be asked since it is an old configuration and some parameters could be missing.
- No configuration file is specified then it just launch the kernel configuration menu to create one.
- Once the kernel is configured, the build is launched.
Build is done with debian tools so it will result in a set of debian kernel packages.
build_kernel_package() { # Untar the kernel if [[ -d linux-${kernel_version} ]]; then echo "linux-${kernel_version} directory already exists, delete it." rm -Rf linux-${kernel_version} fi tar -xjpf linux-${kernel_version}.tar.bz2 # Patch the kernel (cd ${xenomai_directory} && scripts/prepare-kernel.sh --linux=../linux-${kernel_version}/ --adeos=ksrc/arch/${arch}/patches/${adeos_patch} --arch=${target}) # Configure kernel if [ "" != "${config_file}" ]; then cp -v ${config_file} linux-${kernel_version}/.config (cd linux-${kernel_version} && make silentoldconfig) else (cd linux-${kernel_version} && make menuconfig) fi # Build (cd linux-${kernel_version} && fakeroot make-kpkg --initrd --uc --us kernel_image kernel_headers) }
Resulting filesystem :
. |-- build_xeno_kernel.sh |-- config-2.6.37.6 |-- LATEST-IS-v2.5.6.tar.bz2 |-- linux-2.6.37.6 |-- linux-2.6.37.6.tar.bz2 |-- linux-headers-2.6.37.6_2.6.37.6-10.00.Custom_i386.deb |-- linux-image-2.6.37.6_2.6.37.6-10.00.Custom_i386.deb |-- tree.txt `-- xenomai-2.5.6 |-- ksrc | |-- arch | | `-- x86 | | |-- patches | | | |-- adeos-ipipe-2.6.37.6-x86-2.9-01.patch | | | |-- adeos-ipipe-2.6.37.6-x86-2.9-02.patch 4765 directories, 46682 files
Build Xenomai package
After preparing the package build by specifiying Xenomai versions, we launch the build with debian command debuild. It will build and package Xenomai libraries, kernel patches and more.
build_xenomai_package() { (cd ${xenomai_directory} && debchange -v ${xenomai_version} Release ${xenomai_version}) (cd ${xenomai_directory} && debuild -uc -us) }
Resulting filesystem :
. |-- build_xeno_kernel.sh |-- config-2.6.37.6 |-- LATEST-IS-v2.5.6.tar.bz2 |-- libxenomai1_2.5.6_i386.deb |-- libxenomai-dev_2.5.6_i386.deb |-- linux-2.6.37.6 |-- linux-2.6.37.6.tar.bz2 |-- linux-headers-2.6.37.6_2.6.37.6-10.00.Custom_i386.deb |-- linux-image-2.6.37.6_2.6.37.6-10.00.Custom_i386.deb |-- linux-patch-xenomai_2.5.6_all.deb |-- tree.txt `-- xenomai-2.5.6 |-- ksrc | |-- arch | | `-- x86 | | |-- patches | | | |-- adeos-ipipe-2.6.37.6-x86-2.9-01.patch | | | |-- adeos-ipipe-2.6.37.6-x86-2.9-02.patch |-- xenomai_2.5.6.dsc |-- xenomai_2.5.6_i386.build |-- xenomai_2.5.6_i386.changes |-- xenomai_2.5.6.tar.gz |-- xenomai-doc_2.5.6_all.deb `-- xenomai-runtime_2.5.6_i386.deb 5035 directories, 50457 files
