Difference between revisions of "Xenomai"
From ArmadeusWiki
m (→Links) |
(→Installing Xenomai) |
||
| (66 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | ==What is Xenomai ?== | |
| + | Xenomai is a real time co-kernel which cooperates with Linux via Adeos. With its help, hard real time applications can be developed and run on the Armadeus boards.<br> | ||
| − | + | Thanks to Adeos, Xenomai will receive the interrupts first and decide to handle them or not. If not, they will then be transfered to the regular Linux kernel. Also, Xenomai provides a framework to develop applications which can be easily moved between the Real Time Xenomai environment and the regular Linux system.<br> | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | <br | + | |
| − | + | Moreover, Xenomai provides a set of APIs (called "skins") that emulate traditional RTOSes such as VxWorks and pSOS and implement other APIs such as POSIX. Thus, porting third party real time applications to Xenomai is a fairly simple process. | |
| − | Xenomai | + | ==Installing Xenomai== |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| + | {{Note|Xenomai has only be really tested on [[APF9328]] and [[APF27]] with 2.6.29 kernel. APF28 with 3.4 kernel and APF6/APF27 with 3.10 kernel are [[Talk:Xenomai|WiP]].}} | ||
| + | ===Lazy users=== | ||
| + | * Starting from armadeus-6.0, some configurations are available to build Xenomai without configuring anything: | ||
| + | <pre class="host"> | ||
| + | $ make apf9328xenomai_defconfig | ||
| + | or | ||
| + | $ make apf27xenomai_defconfig | ||
| + | or | ||
| + | $ make apf27xenomaimainline_defconfig | ||
| + | or | ||
| + | $ make apf6xenomai_defconfig | ||
| + | </pre> | ||
| − | == | + | ===Manual installation=== |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
The main steps are: | The main steps are: | ||
| − | * | + | * selection of Xenomai package on the Buildroot menuconfig, |
| − | * | + | * selection of Xenomai features in Kernel menuconfig, |
| − | + | * compilation of the new version, | |
| − | * | + | * validation of the Xenomai behaviour. |
| − | * | + | |
| − | + | ||
| − | + | ||
| + | {{Note|These steps must be done with a fresh view or, at least, after having deleted ''buildroot/output/build/linux-x.y.z'' directory.}} | ||
| − | + | ===Selecting Xenomai package=== | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | * First of all, you need to select Xenomai package and Adeos patch in Buildroot menuconfig: | |
| + | <pre class="host"> | ||
| + | $ make menuconfig | ||
| + | </pre> | ||
| + | <pre class="config"> | ||
| + | ... | ||
| + | Kernel ---> | ||
| + | Linux Kernel Extensions ---> | ||
| + | [*] Adeos/Xenomai Real-time patch | ||
| + | (ftp://ftp2.armadeus.com/armadeusw/adeos-ipipe-2.6.29-arm-1.13-05.patch) Path/url for Adeos patch file | ||
| − | + | Target packages ---> | |
| − | + | Real-Time ---> | |
| + | [*] Xenomai Userspace | ||
| + | (2.4.9) Custom Xenomai version for APF9328 & APF27 | ||
| + | (--enable-arm-mach=mx2) Additionnal configuration options for APF27, on APF9328 use --enable-arm-mach=imx | ||
| + | ... | ||
| + | </pre> | ||
| + | {{Note|It's possible to enable (or not) some skins in Real-Time menu.}} | ||
| + | * Exit and save your configuration | ||
| + | * If you plan to use ''xeno-test'' (Xenomai performance tool) then CONFIG_ASH_GETOPTS should be activated in Busybox: | ||
| + | <pre class="host"> | ||
| + | $ make busybox-menuconfig | ||
| + | </pre> | ||
| + | <pre class="config"> | ||
| + | Shells ---> | ||
| + | Choose your default shell (ash) ---> | ||
| + | --- ash | ||
| + | --- Ash Shell Options | ||
| + | ... | ||
| + | [*] Builtin getopt to parse positional parameters | ||
| + | </pre> | ||
| − | + | * Exit and save your configuration | |
| + | * rebuild Busybox & Buildroot: | ||
| + | <pre class="host"> | ||
| + | $ make busybox-clean && make | ||
| + | </pre> | ||
| − | + | ===Kernel greater than 2.6.29=== | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ====2.6.38==== | |
| − | + | <pre class="config"> | |
| − | + | Kernel ---> | |
| − | + | Linux Kernel Extensions ---> | |
| − | + | [*] Adeos/Xenomai Real-time patch | |
| − | + | (http://download.gna.org/adeos/patches/v2.6/$(BR2_ARCH)) Adeos patch URL | |
| − | + | (adeos-ipipe-2.6.38.8-arm-1.18-09.patch) Path for Adeos patch file | |
| − | + | </pre> | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | == | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| + | * If you plan to use a 2.6.38 kernel you have to delete the following patches : | ||
| + | $ cd patches/linux/2.6.38.8 | ||
| + | $ rm 401-armadeus-fix_clock_tree.patch | ||
| + | $ rm 419-armadeus-mx5fb-add_ipu_clock_polarity_support.patch | ||
===Xenomai kernel space support=== | ===Xenomai kernel space support=== | ||
| + | *At first time, to have Linux kernel patched with Xenomai and Adeos patches, you must type: | ||
| + | <pre class="host"> | ||
| + | $ make | ||
| + | </pre> | ||
| + | *If the script prepare-kernel.sh is missing, you can resolve this issue by: | ||
| + | $ make xenomai | ||
| + | Then resume the compilation: | ||
| + | $ make | ||
| + | '''kernel-2.6.38''' | ||
| + | * If the compilation stops, which is probably the case for the first time, apply the following patches in : buildroot/output/build/linux-2.6.38.8 | ||
| + | http://sourceforge.net/mailarchive/forum.php?thread_name=CAP%2B5e19GT6g%3Dx1zdTan7maz28qsJNRoNYpDz7w-BNWAgR5WO4w%40mail.gmail.com&forum_name=armadeus-forum | ||
| + | ** adeos-00-avoid_kernel_panic.patch : | ||
| + | --- a/arch/arm/plat-mxc/time.c 2012-09-01 16:06:04.000000000 +0200 | ||
| + | +++ b/arch/arm/plat-mxc/time.c 2012-09-01 16:01:17.000000000 +0200 | ||
| + | @@ -405,7 +405,8 @@ | ||
| + | |||
| + | if (timer_is_v1()) { | ||
| + | tsc_info.u.counter_paddr = phys + MX1_2_TCN; | ||
| + | - tsc_info.counter_vaddr =(unsigned long)(phys + MX1_2_TCN); | ||
| + | + //tsc_info.counter_vaddr =(unsigned long)(phys + MX1_2_TCN); | ||
| + | + tsc_info.counter_vaddr =(unsigned long)(timer_base + MX1_2_TCN); | ||
| + | } else { | ||
| + | tsc_info.u.counter_paddr = phys + V2_TCN; | ||
| + | tsc_info.counter_vaddr = (unsigned long)(timer_base + V2_TCN); | ||
| + | ** xenomai-00-move-irq_to_desc-export.patch : | ||
| + | diff -ru '--exclude-from=linux-2.6.38.8/Documentation/dontdiff' linux-2.6.38.8/kernel/irq/irqdesc.c linux-2.6.38.8.new/kernel/irq/irqdesc.c | ||
| + | --- a/kernel/irq/irqdesc.c 2012-08-25 14:44:30.000000000 +0200 | ||
| + | +++ b/kernel/irq/irqdesc.c 2012-08-25 12:17:44.000000000 +0200 | ||
| + | @@ -268,13 +268,13 @@ | ||
| + | } | ||
| + | return arch_early_irq_init(); | ||
| + | } | ||
| + | -EXPORT_SYMBOL_GPL(irq_to_desc); | ||
| + | |||
| + | #ifndef CONFIG_IPIPE | ||
| + | struct irq_desc *irq_to_desc(unsigned int irq) | ||
| + | { | ||
| + | return (irq < NR_IRQS) ? irq_desc + irq : NULL; | ||
| + | } | ||
| + | +EXPORT_SYMBOL_GPL(irq_to_desc); | ||
| + | #endif /* CONFIG_IPIPE */ | ||
| + | |||
| + | struct irq_desc *irq_to_desc_alloc_node(unsigned int irq, int node) | ||
| − | Xenomai | + | ==Configuring Xenomai== |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | * You can configure the Xenomai kernel options from Linux menuconfig: | |
| + | <pre class="host"> | ||
$ make linux-menuconfig | $ make linux-menuconfig | ||
| + | </pre> | ||
You should see the new entry : | You should see the new entry : | ||
| + | <pre class="config"> | ||
Real-time sub-system ---> | Real-time sub-system ---> | ||
| + | </pre> | ||
Enter in it and check the following to compile Xenomai as a part of the Linux kernel : | Enter in it and check the following to compile Xenomai as a part of the Linux kernel : | ||
| + | <pre class="config"> | ||
[*] Xenomai | [*] Xenomai | ||
<*> Nucleus | <*> Nucleus | ||
| Line 151: | Line 165: | ||
Interfaces ---> | Interfaces ---> | ||
Drivers ---> | Drivers ---> | ||
| + | </pre> | ||
| − | Additionaly, to enable / disable the different available skins, go into | + | Additionaly, to enable / disable the different available skins, go into <b>''Interfaces --->''</b> : |
| + | <pre class="config"> | ||
<*> Native API ---> | <*> Native API ---> | ||
<*> POSIX API ---> | <*> POSIX API ---> | ||
| Line 161: | Line 177: | ||
< > RTAI emulator ---> | < > RTAI emulator ---> | ||
<*> Real-Time Driver Model ---> | <*> Real-Time Driver Model ---> | ||
| + | </pre> | ||
| − | Finally, | + | Finally, to build your changes: |
| − | $ make | + | <pre class="host"> |
| − | + | $ make linux && make | |
| − | + | </pre> | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
==Deploy== | ==Deploy== | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
You can now [[Target_Software_Installation | transfer]] the rootfs and the kernel | You can now [[Target_Software_Installation | transfer]] the rootfs and the kernel | ||
| Line 216: | Line 191: | ||
==Validate the installation== | ==Validate the installation== | ||
| − | Boot the APF and logon as root. | + | * Boot the APF and logon as root. |
| − | + | * You can double check Xenomai is installed correctly: | |
| − | You can double check | + | <pre class="apf"> |
$ dmesg | grep Xenomai | $ dmesg | grep Xenomai | ||
I-pipe: Domain Xenomai registered. | I-pipe: Domain Xenomai registered. | ||
| Line 226: | Line 201: | ||
Xenomai: starting POSIX services. | Xenomai: starting POSIX services. | ||
Xenomai: starting RTDM services. | Xenomai: starting RTDM services. | ||
| + | </pre> | ||
| + | * Now we can run the overall+performance test provided by Xenomai: | ||
| + | <pre class="apf"> | ||
| + | # modprobe xeno_irqbench | ||
| + | # modprobe xeno_klat | ||
| + | # modprobe xeno_switchtest | ||
| + | # modprobe xeno_timerbench | ||
| + | # xeno-test | ||
| + | </pre> | ||
| + | * On APF27 you have to unlock access to debug registers before launching these tests: | ||
| + | <pre class="apf"> | ||
| + | BIOS> run unlock_regs | ||
| + | </pre> | ||
| − | + | ===Results=== | |
| − | + | * latency (Sampling period: 100 us, test mode: periodic user-mode task, all results in microseconds) | |
| − | + | {| border="1" cellspacing="0" cellpadding="10" | |
| + | ! Board ( Linux / xenomai ) | ||
| + | ! best | ||
| + | ! average | ||
| + | ! worst | ||
| + | |- | ||
| + | | [[APF27]] (2.6.29 / 2.4.9) | ||
| + | | 4.7 uS | ||
| + | | 52.4 uS | ||
| + | | 145.4 uS | ||
| + | |} | ||
| − | + | ==Deinstalling or disabling Xenomai== | |
| + | There are two parts needed for disabling Xenomai features | ||
| − | + | ===Kernel=== | |
| − | + | For disabling kernel part, two solutions are available | |
| − | == | + | * The first solution is to unselect kernel's features : |
| − | + | <pre class="host"> | |
| + | $ make linux-menuconfig | ||
| + | </pre> | ||
| + | And disable following options: | ||
| + | <pre class="config"> | ||
| + | Real-time sub-system ---> | ||
| + | [ ] Xenomai | ||
| + | and | ||
| + | |||
| + | Kernel Features ---> | ||
| + | [ ] Interrupt pipeline | ||
| + | </pre> | ||
| + | |||
| + | * The second solution is to destroy the kernel tree : | ||
| + | <pre class="host"> | ||
| + | $ make linux-dirclean | ||
| + | </pre> | ||
| + | |||
| + | ===Userspace / package=== | ||
| + | For disabling userspace/package part : | ||
| + | <pre class="host"> | ||
| + | $ make menuconfig | ||
| + | </pre> | ||
| + | and disable Xenomai | ||
| + | <pre class="config"> | ||
| + | Package Selection for the target ---> | ||
| + | [ ] Xenomai | ||
| + | </pre> | ||
| + | |||
| + | then use the dirclean command: | ||
| + | <pre class="host"> | ||
| + | $ make xenomai-dirclean | ||
| + | </pre> | ||
| + | |||
| + | ==Going further== | ||
| + | * [[Xenomai:examples usage | Using Armadeus Xenomai custom examples]] | ||
| + | * [[Xenomai:Blinking LEDs | Xenomai tutorial (blinking LED)]] | ||
| + | |||
| + | ==Links== | ||
| + | * [http://home.gna.org/adeos/ Adeos website] | ||
| + | * [http://www.xenomai.org Xenomai website] | ||
| + | * [[Adeos | Adeos installation]] | ||
| + | * [[Xenomai manual installation]] (for reference) | ||
| + | * [http://doc.fedora-fr.org/wiki/Mise_en_œuvre_de_Xenomai_pour_créer_un_noyau_Temps_Réel_dur Mise en œuvre de Xenomai pour créer un noyau Temps Réel dur - Fedora (french)] | ||
| + | * [http://lwn.net/images/conf/rtlws11/papers/proc/p11.pdf Latencies measurements on ARM platforms] | ||
[[Category:Software]] | [[Category:Software]] | ||
[[Category:Real-Time]] | [[Category:Real-Time]] | ||
Latest revision as of 13:41, 30 April 2014
Contents
What is Xenomai ?
Xenomai is a real time co-kernel which cooperates with Linux via Adeos. With its help, hard real time applications can be developed and run on the Armadeus boards.
Thanks to Adeos, Xenomai will receive the interrupts first and decide to handle them or not. If not, they will then be transfered to the regular Linux kernel. Also, Xenomai provides a framework to develop applications which can be easily moved between the Real Time Xenomai environment and the regular Linux system.
Moreover, Xenomai provides a set of APIs (called "skins") that emulate traditional RTOSes such as VxWorks and pSOS and implement other APIs such as POSIX. Thus, porting third party real time applications to Xenomai is a fairly simple process.
Installing Xenomai
 |
Note: Xenomai has only be really tested on APF9328 and APF27 with 2.6.29 kernel. APF28 with 3.4 kernel and APF6/APF27 with 3.10 kernel are WiP. |
Lazy users
- Starting from armadeus-6.0, some configurations are available to build Xenomai without configuring anything:
$ make apf9328xenomai_defconfig or $ make apf27xenomai_defconfig or $ make apf27xenomaimainline_defconfig or $ make apf6xenomai_defconfig
Manual installation
The main steps are:
- selection of Xenomai package on the Buildroot menuconfig,
- selection of Xenomai features in Kernel menuconfig,
- compilation of the new version,
- validation of the Xenomai behaviour.
| |
Note: These steps must be done with a fresh view or, at least, after having deleted buildroot/output/build/linux-x.y.z directory. |
Selecting Xenomai package
- First of all, you need to select Xenomai package and Adeos patch in Buildroot menuconfig:
$ make menuconfig
...
Kernel --->
Linux Kernel Extensions --->
[*] Adeos/Xenomai Real-time patch
(ftp://ftp2.armadeus.com/armadeusw/adeos-ipipe-2.6.29-arm-1.13-05.patch) Path/url for Adeos patch file
Target packages --->
Real-Time --->
[*] Xenomai Userspace
(2.4.9) Custom Xenomai version for APF9328 & APF27
(--enable-arm-mach=mx2) Additionnal configuration options for APF27, on APF9328 use --enable-arm-mach=imx
...
| |
Note: It's possible to enable (or not) some skins in Real-Time menu. |
- Exit and save your configuration
- If you plan to use xeno-test (Xenomai performance tool) then CONFIG_ASH_GETOPTS should be activated in Busybox:
$ make busybox-menuconfig
Shells --->
Choose your default shell (ash) --->
--- ash
--- Ash Shell Options
...
[*] Builtin getopt to parse positional parameters
- Exit and save your configuration
- rebuild Busybox & Buildroot:
$ make busybox-clean && make
Kernel greater than 2.6.29
2.6.38
Kernel --->
Linux Kernel Extensions --->
[*] Adeos/Xenomai Real-time patch
(http://download.gna.org/adeos/patches/v2.6/$(BR2_ARCH)) Adeos patch URL
(adeos-ipipe-2.6.38.8-arm-1.18-09.patch) Path for Adeos patch file
- If you plan to use a 2.6.38 kernel you have to delete the following patches :
$ cd patches/linux/2.6.38.8 $ rm 401-armadeus-fix_clock_tree.patch $ rm 419-armadeus-mx5fb-add_ipu_clock_polarity_support.patch
Xenomai kernel space support
- At first time, to have Linux kernel patched with Xenomai and Adeos patches, you must type:
$ make
- If the script prepare-kernel.sh is missing, you can resolve this issue by:
$ make xenomai
Then resume the compilation:
$ make
kernel-2.6.38
- If the compilation stops, which is probably the case for the first time, apply the following patches in : buildroot/output/build/linux-2.6.38.8
- adeos-00-avoid_kernel_panic.patch :
--- a/arch/arm/plat-mxc/time.c 2012-09-01 16:06:04.000000000 +0200
+++ b/arch/arm/plat-mxc/time.c 2012-09-01 16:01:17.000000000 +0200
@@ -405,7 +405,8 @@
if (timer_is_v1()) {
tsc_info.u.counter_paddr = phys + MX1_2_TCN;
- tsc_info.counter_vaddr =(unsigned long)(phys + MX1_2_TCN);
+ //tsc_info.counter_vaddr =(unsigned long)(phys + MX1_2_TCN);
+ tsc_info.counter_vaddr =(unsigned long)(timer_base + MX1_2_TCN);
} else {
tsc_info.u.counter_paddr = phys + V2_TCN;
tsc_info.counter_vaddr = (unsigned long)(timer_base + V2_TCN);
- xenomai-00-move-irq_to_desc-export.patch :
diff -ru '--exclude-from=linux-2.6.38.8/Documentation/dontdiff' linux-2.6.38.8/kernel/irq/irqdesc.c linux-2.6.38.8.new/kernel/irq/irqdesc.c
--- a/kernel/irq/irqdesc.c 2012-08-25 14:44:30.000000000 +0200
+++ b/kernel/irq/irqdesc.c 2012-08-25 12:17:44.000000000 +0200
@@ -268,13 +268,13 @@
}
return arch_early_irq_init();
}
-EXPORT_SYMBOL_GPL(irq_to_desc);
#ifndef CONFIG_IPIPE
struct irq_desc *irq_to_desc(unsigned int irq)
{
return (irq < NR_IRQS) ? irq_desc + irq : NULL;
}
+EXPORT_SYMBOL_GPL(irq_to_desc);
#endif /* CONFIG_IPIPE */
struct irq_desc *irq_to_desc_alloc_node(unsigned int irq, int node)
Configuring Xenomai
- You can configure the Xenomai kernel options from Linux menuconfig:
$ make linux-menuconfig
You should see the new entry :
Real-time sub-system --->
Enter in it and check the following to compile Xenomai as a part of the Linux kernel :
[*] Xenomai
<*> Nucleus
[*] Pervasive real-time support in user-space
[ ] Interrupt shield support
[*] Priority coupling support
[*] Optimize as pipeline head
(32) Number of pipe devices
(512) Number of registry slots
(128) Size of the system heap (Kb)
(32) Size of the private stack pool (Kb)
[*] Statistics collection
[ ] Debug support
[ ] Shared interrupts
Timing --->
Scalability --->
Machine --->
Interfaces --->
Drivers --->
Additionaly, to enable / disable the different available skins, go into Interfaces ---> :
<*> Native API ---> <*> POSIX API ---> < > pSOS+ emulator ---> < > uITRON API ---> < > VRTX emulator ---> < > VxWorks emulator ---> < > RTAI emulator ---> <*> Real-Time Driver Model --->
Finally, to build your changes:
$ make linux && make
Deploy
You can now transfer the rootfs and the kernel on the APF.
Validate the installation
- Boot the APF and logon as root.
- You can double check Xenomai is installed correctly:
$ dmesg | grep Xenomai I-pipe: Domain Xenomai registered. Xenomai: hal/arm started. Xenomai: real-time nucleus v2.4.3 (Back to Shalla-Bal) loaded. Xenomai: starting native API services. Xenomai: starting POSIX services. Xenomai: starting RTDM services.
- Now we can run the overall+performance test provided by Xenomai:
# modprobe xeno_irqbench # modprobe xeno_klat # modprobe xeno_switchtest # modprobe xeno_timerbench # xeno-test
- On APF27 you have to unlock access to debug registers before launching these tests:
BIOS> run unlock_regs
Results
- latency (Sampling period: 100 us, test mode: periodic user-mode task, all results in microseconds)
| Board ( Linux / xenomai ) | best | average | worst |
|---|---|---|---|
| APF27 (2.6.29 / 2.4.9) | 4.7 uS | 52.4 uS | 145.4 uS |
Deinstalling or disabling Xenomai
There are two parts needed for disabling Xenomai features
Kernel
For disabling kernel part, two solutions are available
- The first solution is to unselect kernel's features :
$ make linux-menuconfig
And disable following options:
Real-time sub-system --->
[ ] Xenomai
and
Kernel Features --->
[ ] Interrupt pipeline
- The second solution is to destroy the kernel tree :
$ make linux-dirclean
Userspace / package
For disabling userspace/package part :
$ make menuconfig
and disable Xenomai
Package Selection for the target --->
[ ] Xenomai
then use the dirclean command:
$ make xenomai-dirclean
