ArmadeusWiki - User contributions [en]

User:XavierH

2009-05-19T20:59:35Z

XavierH: /* Intérêt Professionnel */

Bonjour à tous,
J'ai 25 ans, je suis ingénieur électronicien au CNRS pour la conception d'équipements scientifique destiné à être embarqué dans de engins spatiaux.
== Intérêt Professionnel ==
La carte AFP27 sera sûrement utilisé pour le test, le monitoring et la simulation des équipements de l'engin au sol. Cette fonction requière une haute connectivité (PC), une flexibilité accrue et de bonne performances. Par le passé une carte d'évaluation comprenant un FPGA était utilisé. Cette solution est loin d'être souple et devient vite complexe et difficile à debugguer. Un des développement nécessaire est d'implémenter un IP/driver pour gérer un lien série LVDS spécifique.
=== Projets Terminées ===
==== 1er projet ====
La carte apf27 + dev + carte analogique spécifique sont utilisées dans le cadre de l'asservissement et monitoring longue durée (1-2 mois non stop) d'une carte haute tension destiné à un satellite scientifique.

Coté hardware : l'ADC, plusieurs PWM et GPIO (module led) sont utilisées.

Coté software :

- Interface utilisateur : AJAX rudimentaire : Javascript avec [[Flot]], PHP (socket), boa.

- Coeur (daemon) : C : pthread, socket, mmap pour communiquer avec le fpga

== Intérêt Personnel ==
En deux mots, Je m'intéresse (moi aussi) à l'interface soft/hard existant dans un système embarqué. De plus l'esprit communautaire du libre me séduit.
TBC

Salutations

Xavier

Flot

2009-04-27T21:36:45Z

XavierH: /* Try it! on your computer */

== Introduction ==
This introduction is extracted from the Flot official website : http://code.google.com/p/flot/ :
<source lang="text">
"""Flot is a pure Javascript plotting library for jQuery. It produces graphical plots of arbitrary datasets on-the-fly client-side.
The focus is on simple usage (all settings are optional), attractive looks and interactive features like zooming and mouse tracking.
The plugin is known to work with Internet Explorer 6/7/8, Firefox 2.x+, Safari 3.0+, Opera 9.5+ and Konqueror 4.x+.[...]"""
</source>

== Try it! ==
Some examples are present at : http://people.iola.dk/olau/flot/examples/

== Try it! on your computer ==
Download the sources at : http://code.google.com/p/flot/downloads/list (April 2008 : flot-0.5.tar.bz).

Unpack all the archive in a folder of your choice (on you host). The "example" directory contain all previous examples (.html files), open a file with your webbrowser and enjoy!

== Make this works on apf board ==
To make this work on the apf board, a web server must be previously installed (see [[boa]] documentation).

All plotting scripts (.js) are present on the root of the archive, copy it to your apf web script directory (ex : /var/www/scripts/).
Create file plot "basic.html" in /var/www/ directory :
<source lang="html4strict">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Flot Examples</title>
<link href="layout.css" rel="stylesheet" type="text/css"></link>

<script language="javascript" type="text/javascript" src="./scripts/jquery.js"></script>
<script language="javascript" type="text/javascript" src="./scripts/jquery.flot.js"></script>
</head>
<body>
<h1>Flot Examples</h1>

<div id="placeholder" style="width:600px;height:300px;"></div>

<p>Simple example. You don't need to specify much to get an
attractive look. Put in a placeholder, make sure you set its
dimensions (otherwise the plot library will barf) and call the
plot function with the data. The axes are automatically
scaled.</p>

<script id="source" language="javascript" type="text/javascript">
$(function () {
var d1 = [];
for (var i = 0; i < 14; i += 0.5)
d1.push([i, Math.sin(i)]);

var d2 = [[0, 3], [4, 8], [8, 5], [9, 13]];

// a null signifies separate line segments
var d3 = [[0, 12], [7, 12], null, [7, 2.5], [12, 2.5]];

$.plot($("#placeholder"), [ d1, d2, d3 ]);
});
</script>

</body>
</html>
</source>
Note : only this lines differs from the basic.html file of the archive.
<source lang="html4strict">
<script language="javascript" type="text/javascript" src="./scripts/excanvas.pack.js"></script><![endif]-->
<script language="javascript" type="text/javascript" src="./scripts/jquery.js"></script>
<script language="javascript" type="text/javascript" src="./scripts/jquery.flot.js"></script>
</source>
Now you can test it with your web browser at : <source lang="text">"http://<board IP>/basic.html"</source>

Contributors : [[User:XavierH]]

Flot

2009-04-27T21:35:30Z

XavierH: /* Introduction */

== Introduction ==
This introduction is extracted from the Flot official website : http://code.google.com/p/flot/ :
<source lang="text">
"""Flot is a pure Javascript plotting library for jQuery. It produces graphical plots of arbitrary datasets on-the-fly client-side.
The focus is on simple usage (all settings are optional), attractive looks and interactive features like zooming and mouse tracking.
The plugin is known to work with Internet Explorer 6/7/8, Firefox 2.x+, Safari 3.0+, Opera 9.5+ and Konqueror 4.x+.[...]"""
</source>

== Try it! ==
Some examples are present at : http://people.iola.dk/olau/flot/examples/

== Try it! on your computer ==
Download the sources at : http://flot.googlecode.com/files/ (April 2008 : flot-0.5.tar.bz).

Unpack all the archive in a folder of your choice (on you host). The "example" directory contain all previous examples (.html files), open a file with your webbrowser and enjoy!

== Make this works on apf board ==
To make this work on the apf board, a web server must be previously installed (see [[boa]] documentation).

All plotting scripts (.js) are present on the root of the archive, copy it to your apf web script directory (ex : /var/www/scripts/).
Create file plot "basic.html" in /var/www/ directory :
<source lang="html4strict">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Flot Examples</title>
<link href="layout.css" rel="stylesheet" type="text/css"></link>

<script language="javascript" type="text/javascript" src="./scripts/jquery.js"></script>
<script language="javascript" type="text/javascript" src="./scripts/jquery.flot.js"></script>
</head>
<body>
<h1>Flot Examples</h1>

<div id="placeholder" style="width:600px;height:300px;"></div>

<p>Simple example. You don't need to specify much to get an
attractive look. Put in a placeholder, make sure you set its
dimensions (otherwise the plot library will barf) and call the
plot function with the data. The axes are automatically
scaled.</p>

<script id="source" language="javascript" type="text/javascript">
$(function () {
var d1 = [];
for (var i = 0; i < 14; i += 0.5)
d1.push([i, Math.sin(i)]);

var d2 = [[0, 3], [4, 8], [8, 5], [9, 13]];

// a null signifies separate line segments
var d3 = [[0, 12], [7, 12], null, [7, 2.5], [12, 2.5]];

$.plot($("#placeholder"), [ d1, d2, d3 ]);
});
</script>

</body>
</html>
</source>
Note : only this lines differs from the basic.html file of the archive.
<source lang="html4strict">
<script language="javascript" type="text/javascript" src="./scripts/excanvas.pack.js"></script><![endif]-->
<script language="javascript" type="text/javascript" src="./scripts/jquery.js"></script>
<script language="javascript" type="text/javascript" src="./scripts/jquery.flot.js"></script>
</source>
Now you can test it with your web browser at : <source lang="text">"http://<board IP>/basic.html"</source>

Contributors : [[User:XavierH]]

Flot

2009-04-27T20:52:51Z

XavierH: New page: == Introduction == This introduction is extracted from the Flot official website : http://code.google.com/p/flot/ : Flot is a pure Javascript plotting library for jQuery. It produces grap...

== Introduction ==
This introduction is extracted from the Flot official website : http://code.google.com/p/flot/ :

Flot is a pure Javascript plotting library for jQuery. It produces graphical plots of arbitrary datasets on-the-fly client-side.

The focus is on simple usage (all settings are optional), attractive looks and interactive features like zooming and mouse tracking.

The plugin is known to work with Internet Explorer 6/7/8, Firefox 2.x+, Safari 3.0+, Opera 9.5+ and Konqueror 4.x+. If you find a problem, please report it. Drawing is done with the canvas tag introduced by Safari and now available on all major browsers, except Internet Explorer where the excanvas Javascript emulation helper is used.

== Try it! ==
Some examples are present at : http://people.iola.dk/olau/flot/examples/

== Try it! on your computer ==
Download the sources at : http://flot.googlecode.com/files/ (April 2008 : flot-0.5.tar.bz).

Unpack all the archive in a folder of your choice (on you host). The "example" directory contain all previous examples (.html files), open a file with your webbrowser and enjoy!

== Make this works on apf board ==
To make this work on the apf board, a web server must be previously installed (see [[boa]] documentation).

All plotting scripts (.js) are present on the root of the archive, copy it to your apf web script directory (ex : /var/www/scripts/).
Create file plot "basic.html" in /var/www/ directory :
<source lang="html4strict">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Flot Examples</title>
<link href="layout.css" rel="stylesheet" type="text/css"></link>

<script language="javascript" type="text/javascript" src="./scripts/jquery.js"></script>
<script language="javascript" type="text/javascript" src="./scripts/jquery.flot.js"></script>
</head>
<body>
<h1>Flot Examples</h1>

<div id="placeholder" style="width:600px;height:300px;"></div>

<p>Simple example. You don't need to specify much to get an
attractive look. Put in a placeholder, make sure you set its
dimensions (otherwise the plot library will barf) and call the
plot function with the data. The axes are automatically
scaled.</p>

<script id="source" language="javascript" type="text/javascript">
$(function () {
var d1 = [];
for (var i = 0; i < 14; i += 0.5)
d1.push([i, Math.sin(i)]);

var d2 = [[0, 3], [4, 8], [8, 5], [9, 13]];

// a null signifies separate line segments
var d3 = [[0, 12], [7, 12], null, [7, 2.5], [12, 2.5]];

$.plot($("#placeholder"), [ d1, d2, d3 ]);
});
</script>

</body>
</html>
</source>
Note : only this lines differs from the basic.html file of the archive.
<source lang="html4strict">
<script language="javascript" type="text/javascript" src="./scripts/excanvas.pack.js"></script><![endif]-->
<script language="javascript" type="text/javascript" src="./scripts/jquery.js"></script>
<script language="javascript" type="text/javascript" src="./scripts/jquery.flot.js"></script>
</source>
Now you can test it with your web browser at : <source lang="text">"http://<board IP>/basic.html"</source>

Contributors : [[User:XavierH]]

POD Directories

2009-04-12T17:11:03Z

XavierH: /* Project directory */

= Directory structure =

All filenames must be written in lower case, the only one authorized special character is "_" and can be used as separator.

== POD Software directory ==

<source lang="dos">
pod/
|-- bin/
| |-- core/
| |-- utils/
| |-- code/
| | `-- vhdl/
| |-- commandline/
| `-- toolchain/
|-- busses/
| `-- wishbone16.xml
|-- library/
| |-- wrapper/
| | `-- imx27_wrapper/
| |-- others/
| |-- syscon/
| | `-- wb_syscon/
| `-- components/
| |-- wb_led/
| |-- i2c/
| `-- wb_button/
|-- platforms/
| |-- Ariane6/
| |-- apf27/
| `-- apf9328/
|-- templates/
| `-- headerVHDL.tpl
`-- toolchains/
|-- driver/
|-- synthesis/
`-- simulation/
</source>

Directory description:
* '''bin''' : binary files for POD.
* '''busses''' : contains the bus descriptions.
* '''library''': contains the available components.
* '''platforms''': contains the platform descriptions.
* '''templates''': code templates used by POD.
* '''toolchains''': contains the toolchain descriptions.

=== "components" directory ===

Each component in the library has a dedicated directory with one or more xml file descriptions and subdirectories.

<source lang="dos">
wb_led/
|-- drivers_templates/
| `-- linux/
| |-- Kconfig
| |-- Makefile
| |-- led.c
| `-- led.h
|-- doc/
| |-- TODO
| |-- ChangeLog
| `-- README
|-- hdl/
| `-- led.vhd
|-- ledwb16.xml
`-- ledwb8.xml
</source>

Subdirectories can be of type:
* '''drivers''': driver files required for the compilation of the driver.
* '''doc''': component documentation.
* '''hdl''': contains the hdl files for the synthesis.

=== "platforms" directory ===

A platform directory contains one xml file and some subdirectories :
* '''simulation''' : this directory contains the simulation files for this architecture.
* '''doc''' : documentation for the given platform.

<source lang="dos">
apf9228/
|-- apf9328.xml
|-- doc/
`-- simulation/
</source>

== Project directory ==

The root directory name is the project name.

<source lang="dos">
project1/
|-- binaries/
| |-- project1.bin
| `-- project1.bit
|-- components/
| |-- button01/
| `-- led01/
|-- objs/
|-- project1.xml
|-- drivers/
|-- synthesis/
`-- simulation/
`--projecttest.vhd
</source>

A XML file describes the project and the directories :
* '''binaries''': contains the FPGA bitstream.
* '''components''': contains one directory for each instance in project.
* '''obj''': contains the files generated by the third party tools (like ise files).
* '''simulation''': testbench for the project.
* '''synthesis''' : contains the synthesis files.
* '''drivers''' : contains the drivers for each Virtual Peripheral in a project.

<source lang="dos">
fpga/
|-- wb_led/
| `-- led.vhd
...
|-- wb_syscon/
| `-- syscon.vhd
|-- top_project.vhd
...
|-- project.ucf
`-- project.tcl
</source>

[[Category:POD]]

PWM

2009-03-31T08:55:23Z

XavierH: /* Linux driver installation */

On this page, you will find usefull informations to configure and use the Pulse Width Modulation (PWM) capabilities of your [[APF9328]] board.

The i.MXL processor is capable of driving 2 PWM signals:
* one is linked to the LCD controller and allow to control the [[BackLight | LCD backlight]]
* the other can be used to generate a PWM signal in several mode:
** audio playback
** real PWM

==Hardware==
i.MXL PWM module is using ''PWMO'' (PortA 2) pin as ouput.
* On [[APF9328DevFull|DevFull development boards]] this pin is connected to pin 4 (TIM2) of ''"Timers"'' connector (X21)

== Linux driver installation ==
i.MXL PWM driver is now installed by default in standard Armadeus rootfs. Following instructions are only given as reference (to uninstall it at rootfs generation for example):
*Launch Linux configuration:
$ make linux-menuconfig
And in '''Device Drivers ---> Armadeus specific drivers''' choose:<br>
[[Image:linux_config_pwm.png]]<br>
*rebuild your system:
$ make
* then, either copy generated module ''target/linux/modules/pwm/imx-pwm.ko'' to your system with TFTP or NFS or reflash the generated rootfs. [[Linux_drivers_generalities|For more informations.]]

== Usage ==
* Load the module:
# modprobe imx-pwm
Initializing PWM class.
Initializing PWM#0...PWM major number = 253
PWM driver v0.6
done.
* If you plan to use sound, create ''/dev/pwm'' device file if not already existing (Major is dynamically allocated)
# DEV=`cat /proc/devices | grep imx-pwm | cut -d " " -f 1`; mknod /dev/pwm c $DEV 0

=== PWM Mode ===

<strong>Remark:</strong>
* The pwm has a resolution of 1uS

After driver loading, you have access to ''/sys/class/pwm/...'' functionnalities:
* to change frequency (for example 500 Hz):
# echo 500 > /sys/class/pwm/pwm0/frequency
* to change period (for example 100us):
# echo 100 > /sys/class/pwm/pwm0/period
* to change duty cycle (for example 50.0%)
# echo 500 > /sys/class/pwm/pwm0/duty
* to activate PWM:
# echo 1 > /sys/class/pwm/pwm0/active
* to de-activate PWM:
# echo 0 > /sys/class/pwm/pwm0/active

=== Audio Mode ===
Audio playback mode is working since v0.5 of PWM driver (thanks to [[User:SebastienR]]).
You can play 8, 16 & 32 KHz 8bit linear RAW sound. It's recommended to play 8kHz one, as they use less CPU ressources.
To convert a sound to the right format we recommend to use SoX (on Linux).
For exemple:
[host]$ sox /usr/share/sounds/KDE_Chimes_1.ogg -r 8192 -b -u -c 1 Chimes.raw
-r -> sampling rate
-b -> byte/8bit signal
-u -> linear /not compressed
-c 1 -> Mono / 1 channel

Then you can test it using target/linux/modules/pwm/test/testplaymode:
[host:/.../armadeus]$ make -C target/linux/modules/pwm/test/
[host:/.../armadeus]$ cp target/linux/modules/pwm/test/testplaymode $NFS_DIR
[host:/.../armadeus]$ cp target/linux/modules/pwm/test/KDE_Startup_2.raw $NFS_DIR
on target do:
# testplaymode
or
# testplaymode KDE_Startup_2.raw

== Links ==
* [http://sox.sourceforge.net/Docs/FAQ SoX, sound format converter]
* http://en.wikipedia.org/wiki/Pulse-width_modulation

[[Category:Linux_drivers]]
[[Category:ExternalDeviceControl]]

IMX LED Driver TP

2009-03-30T18:57:31Z

XavierH:

{{Under_Construction}}
== Proposal ==
The goal of this tutorial is to build from scratch a simple led driver wire on GPIO of the iMX. This document will describes step by step how to implement a such driver

== Howto Load/unload modules : "hwmon" module ==
Loading a module is quite simple once it is compiled and is present in the rootfs of the apf board.
All the compiled driver modules are in the "/lib/modules/<kernel version>/kernel" in the apf rootfs. To list all the loadable modules by the kernel in the board type :
<pre class="apf">
# find /lib/modules/`uname -r`/kernel -name "*.ko"
/lib/modules/2.6.27.13/kernel/sound/arm/snd-imx-alsa-tsc2102.ko
/lib/modules/2.6.27.13/kernel/sound/arm/snd-mx2.ko
/lib/modules/2.6.27.13/kernel/sound/core/snd-page-alloc.ko
/lib/modules/2.6.27.13/kernel/sound/core/snd-timer.ko
/lib/modules/2.6.27.13/kernel/sound/core/snd.ko
/lib/modules/2.6.27.13/kernel/sound/core/snd-pcm.ko
/lib/modules/2.6.27.13/kernel/sound/soundcore.ko
/lib/modules/2.6.27.13/kernel/drivers/spi/tsc2102.ko
/lib/modules/2.6.27.13/kernel/drivers/scsi/scsi_wait_scan.ko
/lib/modules/2.6.27.13/kernel/drivers/hwmon/hwmon.ko
/lib/modules/2.6.27.13/kernel/drivers/input/touchscreen/tsc2102_ts.ko
/lib/modules/2.6.27.13/kernel/drivers/video/backlight/lcd.ko
/lib/modules/2.6.27.13/kernel/drivers/video/backlight/backlight.ko
/lib/modules/2.6.27.13/kernel/drivers/armadeus/max1027/max1027.ko
/lib/modules/2.6.27.13/kernel/drivers/armadeus/backlight/imx_bl.ko
</pre>
For example, I will load "/lib/modules/2.6.27.13/kernel/drivers/hwmon/hwmon.ko" module :
<pre class="apf">
# modprobe hwmon
#
</pre>
To list all mod loaded :
<pre class="apf">
# lsmod
Module Size Used by Not tainted
hwmon 2356 0
</pre>

To unload it just type :
<pre class="apf">
# rmmod hwmon
#
</pre>
TBC

== Howto Build a simple char module and load/unload it : the "Hello World" module ==
The "Hello World" module code is quite simple have only load and unload fonction.
=== Create required folder and files ===
Create a hello folder in <armadeus_directory>/target/linux/modules/. On the host computer type :

<pre class="host">
cd <armadeus_directory>/target/linux/modules/
mkdir hello
</pre>
==== Hello.c source file ====
<source lang="c">
#include <linux/module.h> /* Default module librairies TBC */
#include <linux/kernel.h>

/* Print "Hello, world\n" with KERN_ALERT level (stdio TBC) */
static int hello_init(void){
printk(KERN_ALERT "Hello, world\n");
return 0;
}

/* Print "Goodbye, cruel world\n" with KERN_ALERT level (stdio TBC) */
static void hello_exit(void){
printk(KERN_ALERT "Goodbye, cruel world\n");
}

module_init(hello_init); /* Set hello_init function as the module init one (called when module load) */
module_exit(hello_exit); /* Set hello_exit function as the module exit one (called when module unload) */

MODULE_LICENSE("GPL"); /* Set the license module */
</source>
==== Makefile file ====
<source lang="text">
# Part executed when called from kernel build system:
ifneq ($(KERNELRELEASE),)

obj-$(CONFIG_ARMADEUS_LED_XAV_DRIVER) += hello.o

#hello-objs := hello.o

# Part executed when called from standard make in this directory:
# (preferably use Makefile in parent directory)
else

ARMADEUS_BASE_DIR=../../../..
include $(ARMADEUS_BASE_DIR)/Makefile.in

KDIR := $(ARMADEUS_LINUX_DIR)
PWD := $(shell pwd)

# Armadeus custom drivers common targets:
include ../Makefile.in

endif
</source>
TBC
== Howto Provide read/write commands to the user though /dev/hello : "Hello World Read Write" module ==

== Howto Build a register use module : "iMX LED" module ==

IMX LED Driver TP

2009-03-17T17:43:40Z

XavierH: /* Howto Load/unload modules : "hwmon" module */

IMX LED Driver TP

2009-03-17T17:42:04Z

XavierH: /* Howto Load/unload modules */

IMX LED Driver TP

2009-03-17T17:17:13Z

XavierH:

{{Under_Construction}}
== Proposal ==
The goal of this tutorial is to build from scratch a simple led driver wire on GPIO of the iMX. This document will describes step by step how to implement a such driver

== Howto Load/unload modules ==

== Howto Build a simple module and load/unload it : the "Hello World" module ==

== Howto Provide read/write commands to the user though /dev/hello : "Hello World Read Write" module ==

== Howto Build a register use module : "iMX LED" module ==

IMX LED Driver TP

2009-03-17T17:08:16Z

XavierH: New page: {{Under_Construction}} == Proposal == The goal of this tutorial is to build from scratch a simple led driver wire on GPIO of the iMX. This document will describes step by step how to imple...

{{Under_Construction}}
== Proposal ==
The goal of this tutorial is to build from scratch a simple led driver wire on GPIO of the iMX. This document will describes step by step how to implement a such driver

== Howto Load/unload modules ==

== Howto Build module and load/unload it : the "Hello World" module ==

In a first time, a "hello word" driver will be built

User:XavierH

2009-03-17T10:16:58Z

XavierH: Description professionnelle/personnelle