= Port status =

You may find more information about the status of the port on the [wiki:Arch/Simple/Sam7 Sam7 port page].

= Prerequisites =

We will use the sam7_ex256_demo application. It runs on a Olimex SAM7-EX256 development board.

We'll assume you have
 * a working sam7-ex256 board,
 * a running OpenOCD daemon connected to it,
 * the MutekH source-tree in `/path/to/mutekh`,
 * working gcc & binutils for ARM. Using `arm-unknown-elf` target is the default, but you may [wiki:Config/ToolChain#Useyourowntoolchain use your own toolchain]

= Using a demo application =

Demo application is located in [source:/trunk/mutekh/examples/sam7_ex256_demo] directory.

To compile this application, go to a new directory and type:
{{{
$ make \
	   -f /path/to/mutekh/Makefile \
	   CONF=/path/to/mutekh/examples/sam7_ex256_demo/config_sam7 \
	   BUILD_DIR=$PWD \
	   SRC_DIR=/path/to/mutekh
}}}

For more information about the meaning of the arguments, see BuildSystem.

= Got the kernel =

You should now have a tree of built objects on `obj-simple-arm` and two versions of the kernel:
 `kernel-simple-arm.out`::
   The ELF binary kernel, it can be used for GDB or other debugging purposes
 `kernel-simple-arm.bin`::
   This is the file you may flash to the Sam7 through openocd.

= Testing =

You may connect to the board through the first UART, 38400,8,n,1, and see:
 * A lua prompt asking for commands
 * Some messages when you touch the buttons or the joystick

On the lua prompt, you may try:
 `lcd_reblit()`::
   Will blit a default image to the LCD
 `lcd_blit_block(lba, x, y)`::
   Blits a 18x18 block from SD/MMC to the LCD at x,y. it is 18x18 because it fits in a 512-byte block of SD/MMC. Encoding is packed 12-bit RGB-444.
 `lcd_backlight(bool)`::
   Sets the backlight value (0/1)
 `lcd_invert(bool)`::
   Sets the backlight inversion mode (0/1)
 `lcd_set_contrast(n)`::
   Sets the contrast of LCD
 `block_hexdump(lba)`::
   Hexdump the SD/MMC block at lba
 `sd_mmc_rehash()`::
   Reinitialize the SD/MMC card, this can be used when switching cards

You may find other commands pressing the <TAB> key (yes, there is completion).