Bare Metal programming A13

2013-05-11T11:17:31Z

Scott: /* Setup Eclipse */

Programming with no OS, development tools and poor documentation isn't easy therefore this page is currently a work in progress. It will be updated as the author works out more about the process

== Stand alone program running with uboot==
The linux operating systems shown in the wiki runs on an SD card however it is booted using u-boot. U-boot sets up the CPU, memory and a few other things then starts Linux executing. 
The following method outlines how to create a program that replaces linux but still relies on u-boot for setup.

=== Tools===
- Computer for cross compiling the program and uboot, such as a linux computer 
- SD card and SD card reader / writer 
- A13 olinuxino board 
- Serial adapter for the A13 olinuxino board (Only way to work with uboot as no screen is configured in uboot) 

=== Setup computer for cross compiling and compiling uboot===

You should make sure you have the tools for building the Linux Kernel and install them if you don’t have them. To install new software you should be with super user rights so do this type in a terminal.

$ sudo su

you will be asked for your password and then your prompt will change to # which means you are now the super user, all future commands should be run in this mode

First update apt-get links by typing

<nowiki>#apt-get update</nowiki>

Install the toolchain by typing the following.

<nowiki># apt-get install gcc-4.6-arm-linux-gnueabi ncurses-dev uboot-mkimage build-essential git</nowiki>

with this line you make sure you have all tools necessary for the A13 kernel and uboot build:

* GCC compiler used to compile the kernal
* The kernel config menu
* uboot make image which is required to allow the SD card to book into the linux image
* Git which allows you to download from the github which holds source code for some of the system
* Some other tools for building the kernel

after the installation you now have all tools to make your very own A13 kernel image

===Building Uboot===

The Allwinner community uboot is maintained by Henrik Nordström aka hno on #freenode irc channel.

First let’s make the directory where we will build the A13-OLinuXino Linux:

<nowiki># mkdir olinuxino
# cd olinuxino</nowiki>

Then let’s download the uboot sources from GitHub repository, note there are lot of branches but you have to use sunxi branch, the files are about 70 MB

<nowiki># git clone -b sunxi https://github.com/linux-sunxi/u-boot-sunxi.git</nowiki>

After the download you should have a new directory

<nowiki># cd u-boot-sunxi/</nowiki>

With the following command you can start the uboot build:

<nowiki># make a13_olinuxino CROSS_COMPILE=arm-linux-gnueabi-</nowiki>

If errors come up that suggest its unable to find arm-4.6-linux-gnueabi-gcc its likely the compilation is expecting the files in a different place or to be named differently to how they were installed. 
To resolve this you can use symbolic links
example

ln -s /usr/bin/arm-linux-gnueabi-gcc-4.6 /usr/bin/arm-4.6-linux-gnueabi-gcc

Once you have compiled you can see A13-OLinuXino already has support configuration in Allwinner community uboot

At the end of the process you can check if everything is OK by

<nowiki># ls u-boot.bin spl/sunxi-spl.bin</nowiki>

If you got these two files everything is complete, well done so far

===Format and setup the SD-card===

First we have to make the correct card partitions, this is done with fdisk.

Plug SD card into your SD card reader and enter in the terminal

<nowiki># ls /dev/sd</nowiki>

Then press two times <TAB> you will see a list of your sd devices like sda sdb sdc note that some of these devices may be your hard disk so make sure you know which one is your sd card before you proceed as you can damage your HDD if you choose the wrong sd-device. You can do this by unplugging your sd card reader and identify which "sd" devices remove from the list.

Once you know which device is your sdcard like sda use this text instead of the sdX name in the references below:

<nowiki># fdisk -u=sectors /dev/sdX</nowiki>

then do these steps:

1. p

will list your partitions

if there are already partitions on your card do:

2. d 1

to delete them all

3. n p 1

create the first partition, starting from 2048

4. beginning 2048

then list the created partitions:

6. p

then write the partitions to the card

7. w

now we have to format the file system on the card:

the first partition should be vfat as this is FS which U-boot understands

<nowiki># mkfs.vfat /dev/sdX1</nowiki>

===Copying u boot to SD card===
Now the SD card is formatted and uboot has been compiled we can copy the files to the SD card.

write Uboot

<nowiki>
# cd uboot-allwinner/
</nowiki>

<nowiki>
# dd if=spl/sunxi-spl.bin of=/dev/sdX bs=1024 seek=8
</nowiki>

<nowiki>
# dd if=u-boot.bin of=/dev/sdX bs=1024 seek=32
</nowiki>

<nowiki>
# sync
</nowiki>

<nowiki>
# umount /mnt
</nowiki>

===The hello world program compilation===
The compilation performed in a previous step compiled uboot but it also compiled a few stand alone programs which is the name u boot uses for programs that can be executed by uboot. One stand alone program is the hello world program

The hello world program code will be located in the directory previously created and in the following sub directories olinuxino/examples/standalone/hello_world.c

The compiled hello world program will be located in directory the git repository was downloaded to and in the following path

u-boot-sunxi/examples/standalone 
The file is named: hello_world.bin

copy this to a computer with a serial connection to the A13 olinuxino

===Using uboot on the A13olinuxino===
Take the created SD card and with the power disconnected from the olinuxino board plug the SD card into the board.

Connect the computer to the A13 olinuxino serial port with an appropriate level translator (the olinuxino serial levels are 0-3v3 they must be increased to RS232 levels)

Setup your computer to look at the serial port. If a windows XP computer is used do this by starting hyperterminal. 
The serial settings are 115200 baud, 8 bits, 1 stop

Turn the power on.

Immediately data will be sent out the serial port, This is uboot starting up, after a few seconds data will stop sending and u boot is ready to use.

typing in the terminal "help" will list the available commands

The use of U boot is explained in [http://www.denx.de/wiki/DULG/Manual U boot manual] look for the section "u-boot command line interface"

type "loadb" 
at this point uboot is waiting for the computer to send the binary file to it, it will not respond to commands until the binary is sent. 
To do this using hyperterminal click on tools -> send file -> locate the hello_world.bin and click send. After some time this will indicate its sent

If no errors came up the terminal will report the file was loaded to 0x50000000 which is a location in RAM so now the file is in the ram of the A13olinuxino ready to be executed.

To execute type "go 0x50000000"

If the terminal writes a few lines and says "Hit any key to exit ... ". You have executed your first program without linux on the A13olinuxino.

===Run the hello world program from the SD card===
Nobody wants to run their code with a serial console forever here is how to load it from the SD card.

At the moment a bug exists in the uboot code for the sunxi branch, this bug happens to overwrite sections of memory at 0x50000000 when the SD card is accessed. This wouldn't normally be a problem however the code is compiled to only operate from 0x50000000 the exact same location in RAM. 
This issue was reported to Henrik Nordström one of the developers for the sunxi branch of uboot, He quickly responded noting it was a bug and promptly fixed it in the development branch. 
A work around until this change is committed to the main branch is to change the make file setting of where the program is compiled to execute from.
In the file 
u-boot-sunxi/include/configs/sunxi-common.h

Change the line 129 from

#define CONFIG-STANDALONE_LOAD_ADDR 0x50000000 
to 
#define CONFIG-STANDALONE_LOAD_ADDR 0x48000000

0x48000000 is the area that was going to hold the kernel so we know its free.

To recompile go to the directory

<nowiki># cd uboot-allwinner/</nowiki>

With the following command you can start the uboot build:

<nowiki># make a13_olinuxino CROSS_COMPILE=arm-linux-gnueabi-</nowiki>

Now the hello_world.bin can be copied to the SD card

Move the SD card to the olinuxino board, power it on with the serial connection connected.

If you type "help" you will notice the command fatls

We are using a fat file system and fat ls will list the files available. To do this type the following in the terminal

fatls mmc 0 0x48000000 hello_world.bin

it will say something like "read 566 bytes" number of bytes may be different. If it says this the load was successful and the binary file is in ram at 0x48000000 as specified

To execute again type

go 0x48000000

You may be thinking im still using the computer to execute this so what is the advantage. All of the commands sent can be scripted so that the stand alone program will load from the SD card and execute once the power is turned on.

===Setup Eclipse tool chain===
Eclipse is an IDE (Integrated Development Environment). Its a program that allows for one click building as well as making it easier to navigate code across files.

To install Eclipse follow the instructions here

==== Install eclipse ====

Eclipse is a GUI which enables easy compilation and debugging when the appropriate tools have been installed.

This may be able to be installed using the package manager on your linux system.

'''Manual eclipes install''' 
To manually install the most up to date eclipse perform the following

Go to the eclipse download section

[http://www.eclipse.org/downloads/ Eclipse download] Download to your linux machine the suitable eclipse version.

Decompress the downloaded file into any directory you like by moving the downloaded file to your desired directory.
Open a terminal, go to the directory and decompress with the command

tar -xzvf FILENAME.

This will create a directory in this location called eclipse
Within this directory is the executable eclipse.exe

It is recommended to create a launcher on your desktop which points to this executable file to make it easier to start.

'''Manual Java runtime install''' 
As eclipse is written in java the jave runtime is required as well.

Download the java runtime.

[http://java.com/en/download/manual.jsp Java download page] Download the java RPM file that your eclipse version requires.

Follow the instructions on the java download page beside the download to install

Your eclipse installation should now start up.

==== Setup Eclipse====

To setup eclipse to create the hello world program complete the following steps

- Start eclipse

- Create a new project by clicking File -> New -> Makefile project with existing code 
- Enter a project name 
- locate the folder with the source code previously downloaded - the folder should be named olinuxino/u-boot-sunxi 
- Select Cross gcc 
- Press OK, it may take some time to index 

[[File:EclipseBuild.png|thumb| Eclipse Build Setup]]
To setup the build command 
- wait for the project to stop indexing 
- when ready press project then Properties this will bring up a window 
- Within the properties window click on C/C++ Build 
- Beside build command enter in the box 
make a13_olinuxino CROSS_COMPILE=arm-linux-gnueabi- 

Once you click Ok the system will be ready to build when build is pressed.

===Do something useful, Modify the hello world to set GPIO===
COMING SOON

2013-04-30T14:31:37Z

Scott: /* Projects */

[[File:A13-OLinuXino-MAXI-WIFI-1.jpg|thumb| A13-OlinuXino-WIFI]]

[[File:A13-OLinuXino-MICRO.jpg|thumb| A13-OlinuXino-MICRO]]

The A13 processor from Allwinner runs at 1GHz with a Mali400 GPU. It was designed for integration into tablets. Olimex has made several development board designs based around this chip. This wiki page contains information about hardware and software to help make use of these development boards.

The A13 based boards currently available are 
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino-WIFI/ A13-OLinuXino-WIFI] - Recommended if your developing software for the A13 for the first time as its the only one with network connectivity.
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino/ A13-OLinuXino] - This is the same as the WIFI version but without WIFI module and NAND flash. Note: Android requires NAND flash to run, so this board can't run Android.
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino-MICRO/ A13-OLinuXino-MICRO] - Similar to the A13-OlinuXino but with less extras

== Projects ==
Projects people from the olinuxino community are working on or have finished and how they did it.

'''LINUX:''' 
[[Build Bootable SD Card with Debian]] Run Debian and u-boot, Step by step instructions how to make SD card image. 
[[Prebuilt SD card images running debian]]

[http://olimex.wordpress.com/2012/10/23/a13-olinuxino-playing-with-gpios/ Change GPIOs using scripts in linux]

[https://www.olimex.com/forum/index.php?topic=436.msg4066#msg4066 A13 OLinuXino fast GPIO with /dev/mem now achieve up to 2 Mhz toggle]

[https://www.olimex.com/forum/index.php?topic=899.0 A13 kernel module for direct support of UEXT MOD-IO board, adding ADC, relays etc, cool project can be used as reference how to make your own kernel modules]

[https://docs.google.com/open?id=0B7WHuNCASY8cWnRrQ0tGVFMybFk Instructions how to run MOD-BT with A13-OLinuXino]

[http://olimex.wordpress.com/2013/04/18/a13-olinuxino-wifi-and-opencv-face-detection-project/ A13-Olinuxino-WIFI and opencv face detection]

[http://olimex.wordpress.com/2013/04/02/scratch-control-for-mod-io/ Controlling Relays, Switching ON/OFF of 220V appliances and home automation]

[http://olimex.wordpress.com/2013/03/28/make-door-security-logger-with-a13-olinuxino-wifi-opencv/ Door security logger, image capture]

[http://olimex.wordpress.com/2013/03/08/gps-logger-with-google-maps-viewer-made-with-a13-olinuxino-and-mod-gps/ GPS logger with google maps viewer, MOD-GPS module on UEXT]

[http://olimex.wordpress.com/2013/02/25/a13-olinuxino-web-server-with-mod-rgb-controlling-rgb-led-stripe-over-internet/ Web server with MOD-RGB controlling RGB LED strip]

'''ANDROID:''' 
[http://olimex.wordpress.com/2012/10/24/a13-olinuxino-project-control-relays-and-read-adcs-and-ios-with-android/ Interface MOD-IO board with I2C under Android ]

[http://olimex.wordpress.com/2013/03/13/mame4droid-is-running-on-a13-olinuxino/ Run old games on android mame4droid]

'''No OS''' 
[[Bare Metal programming A13]] Programming directly for the chip without an OS

'''FreedomBox:''' 
[https://wiki.debian.org/FreedomBox/UniLeipzigPractical FreedomBox/UniLeipzigPractical is the documentation of a freedom box related practical course at the AKSW Research Group at the University of Leipzig]

==Hardware==

Schematics and board designs can be found here

[https://github.com/OLIMEX/OLINUXINO/tree/master/HARDWARE Olimex Hardware]

Designs were created with Eagle

A limited functionality freeware version of Eagle can be downloaded here

[http://www.cadsoftusa.com/download-eagle/freeware/?language=en Eagle Freeware]

There is very limited information about the A13 processor. The only detailed data found is an A10 datasheet which has some errors in it apparently. As this is the best source of low level information it is linked here

[http://dl.linux-sunxi.org/A10/ A10 datasheet]

A serial connection can be made to the A13 board, which can help with debugging and is a booting option

[[Serial connection to A13]] Description of how to connect a computer to the A13 board over serial.

===Power===

The A13-OLinuXino can be partially powered over Micro USB, but to power all peripherals, a 6+ watt DC power supply between 6 and 16 volts can be used. The connector is a positive-center 2.5mm barrel plug. There is also an on-board connector for a Li-PO battery.

==Software==

[http://linux-sunxi.org/Main_Page A generic wiki for the allwinner devices is here. It contains some great detailed info]

=== Bare Metal programming - no OS ===

It is possible to program and debug code written directly on the chip without an OS such as linux or android. 
The advantage is no kernel overhead and tighter control of the CPU operation.

[[Bare Metal programming A13]]

=== Using an operating system - Nand flash ===

The Wifi version of the A13 board comes preprogrammed with android, which is held in the Nand flash.

The image in the Nand flash can be updated using the tools found at the following links:

[https://docs.google.com/file/d/0B7WHuNCASY8cWlZ2djh4X0QtV0U/edit?usp=sharing LiveSuit for Windows]

[http://linux-sunxi.org/LiveSuit LiveSuit for loading images]

to the NAND flash; to activate A13 bootloader do as follows: run Livesuit, disconnect the power supply and USB cable, then press HOME button, apply power supply, attach USB cable and release the button, Livesuit will detect the bootloader and will ask which file to program to the NAND flash.

Prebuilt images that can be programmed into the Nand flash can be found here.

[https://docs.google.com/open?id=0B-bAEPML8fwlR3hSS0R5aHpoVmM Andoroid 4.0.3 NAND flash prebuild image for VGA 800x600 resolution (default shipped with A13-OLinuXino-WIFI)]

[https://docs.google.com/open?id=0B-bAEPML8fwleXBMellGdWJ3RUk Andoroid 4.0.3 NAND flash prebuild image for LCD 800x480 resolution ]

[https://docs.google.com/file/d/0B-bAEPML8fwlbWVBN2RWVXBhTXc/edit?usp=sharing Android 4.1 NAND flash prebuild image for LCD480x272]

[https://docs.google.com/file/d/0B-bAEPML8fwlcHFOcUxtQ1N5RDQ/edit A13-LCD43 script.bin]

=== Using an operating system - SD card ===
The A13 board can boot from an SD card. Just plug it in an imaged uSD card and connect power.

Note: The SD card can easily be corrupted if power is removed while the system is booting or writing to system files.
To avoid this do not remove power while it is booting and shut the system down properly before disconnecting power.

==== Prebuilt images ====

Some prebuilt images have been created, follow the link below for details.

[[Prebuilt SD card images running debian]]

==== Build your own kernel and image onto SD card ====

Some developers want more control over the kernel and modules that are included. The link below shows directions to build your own kernel and image it onto an SD card.

[[Build Bootable SD Card with Debian]] Step by step instructions how to make SD card image with above Kernel and U-boot

====Setup and configure the installed debian image====

There are several settings that can be made for a particular hardware configuration in the script file.

The following link explains the script file as well as wifi or ethernet setup and GPIO settings

[[Configuration of hardware in the debian image]]

====Installing UsbVideoClass(UVC) on A13-OLinuXino board====

To work with USB Video Cameras you have to enable the UVC support in the kernel. The link below explains how to do it.

[[UVC support]]

====Setup VLC player for video streaming on A13-OLinuXino board====

To setup video streaming you should first have installed UVC support so you can connect USB cameras to A13-OLinuXino.

[[VLC streaming]]

=== Creating a program to run on the A13-OlinuXino board ===

[[Programming for A13 in debian]] Step by step instructions to make your first hello world program run on the A13 board running debian.

=== Software Links ===

[http://linux-sunxi.org/Sunxi-tools Tools to hack A13-OLinuXino]

[http://olimex.wordpress.com/2012/11/23/running-debian-with-xfce4-on-a13-olinuxino/ Installing Xfce4 graphical interface on Debian] How to install XFCE4 on A13-OLinuXino

=== A13-SDK Android 4.0.3 ICS ===

A13-SDK contain everything you need to build Android ACS 4.0.3 NAND image for A13-OLinuXino-WIFI. Both mirrors contain same image a13.tar.gz which you should unpack and follow the instructions inside. Builds on Debian 64bit as on Ubuntu have some problems with Java which we never managed to solve.

[https://mega.co.nz/#!CgYGRQZL!BJXNQSQcRxLYswtsPI-EsjNTV0kk381Qzfs96Dx0Sn4 Mega upload mirror]

[https://docs.google.com/open?id=0B-bAEPML8fwldWIzY29GNDJ2ZW8 Gdrive mirror]

=== A13-SDK Android 4.1 JB ===

This is version 1.5 of A13-SDK which builds Android 4.1 Jelly Beans image. It works slower than 4.0.3 and we personally do not see any advantage to use 4.1 vs 4.0.3

[http://emicrotec.at/public/ Andreas Auer kindly offered to host this 4GB image]

== FAQ ==
Under construction

== List of Contributors ==

'''Henrik Nordstrom''' - a.k.a. hno, uboot for A13 development, A1X guru, Linux-Sunxi maintainer

'''Dimitar Gamishev''' - a.k.a. HEHOPMAJIEH, Linux kernel configuration for OLinuXino, Android images, LCD touchscreen

'''Alexandro Mery''' - a.k.a. mnemoc, Linux-Sunxi maintainer

'''Davide Fabbri''' - Linaro kernel and lubuntu image

'''Scott Anderson''' - A13 wiki maintainer

'''Jeffrey Wischkaemper''' - a.k.a. jwischka, A13-OLinuXino Debian image with X

'''Maxime Ripard''' - ARM Linux patches

'''Jason Plum''' - Arch Linux support

[[Category:A13]]

A13-OLinuXino

2013-04-30T14:16:04Z

Scott: /* Projects */

[[File:A13-OLinuXino-MAXI-WIFI-1.jpg|thumb| A13-OlinuXino-WIFI]]

[[File:A13-OLinuXino-MICRO.jpg|thumb| A13-OlinuXino-MICRO]]

The A13 processor from Allwinner runs at 1GHz with a Mali400 GPU. It was designed for integration into tablets. Olimex has made several development board designs based around this chip. This wiki page contains information about hardware and software to help make use of these development boards.

The A13 based boards currently available are 
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino-WIFI/ A13-OLinuXino-WIFI] - Recommended if your developing software for the A13 for the first time as its the only one with network connectivity.
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino/ A13-OLinuXino] - This is the same as the WIFI version but without WIFI module and NAND flash. Note: Android requires NAND flash to run, so this board can't run Android.
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino-MICRO/ A13-OLinuXino-MICRO] - Similar to the A13-OlinuXino but with less extras

== Projects ==
Projects people from the olinuxino community are working on or have finished and how they did it.

'''LINUX:''' 
[[Build Bootable SD Card with Debian]] Run Debian and u-boot, Step by step instructions how to make SD card image. 
[[Prebuilt SD card images running debian]]

[http://olimex.wordpress.com/2012/10/23/a13-olinuxino-playing-with-gpios/ Change GPIOs using scripts in linux]

[https://www.olimex.com/forum/index.php?topic=436.msg4066#msg4066 A13 OLinuXino fast GPIO with /dev/mem now achieve up to 2 Mhz toggle]

[https://www.olimex.com/forum/index.php?topic=899.0 A13 kernel module for direct support of UEXT MOD-IO board, adding ADC, relays etc, cool project can be used as reference how to make your own kernel modules]

[https://docs.google.com/open?id=0B7WHuNCASY8cWnRrQ0tGVFMybFk Instructions how to run MOD-BT with A13-OLinuXino]

[http://olimex.wordpress.com/2013/04/18/a13-olinuxino-wifi-and-opencv-face-detection-project/ A13-Olinuxino-WIFI and opencv face detection]

'''ANDROID:''' 
[http://olimex.wordpress.com/2012/10/24/a13-olinuxino-project-control-relays-and-read-adcs-and-ios-with-android/ Interface MOD-IO board with I2C under Android ]

'''No OS''' 
[[Bare Metal programming A13]] Programming directly for the chip without an OS

'''FreedomBox:''' 
[https://wiki.debian.org/FreedomBox/UniLeipzigPractical FreedomBox/UniLeipzigPractical is the documentation of a freedom box related practical course at the AKSW Research Group at the University of Leipzig]

==Hardware==

Schematics and board designs can be found here

[https://github.com/OLIMEX/OLINUXINO/tree/master/HARDWARE Olimex Hardware]

Designs were created with Eagle

A limited functionality freeware version of Eagle can be downloaded here

[http://www.cadsoftusa.com/download-eagle/freeware/?language=en Eagle Freeware]

There is very limited information about the A13 processor. The only detailed data found is an A10 datasheet which has some errors in it apparently. As this is the best source of low level information it is linked here

[http://dl.linux-sunxi.org/A10/ A10 datasheet]

A serial connection can be made to the A13 board, which can help with debugging and is a booting option

[[Serial connection to A13]] Description of how to connect a computer to the A13 board over serial.

===Power===

The A13-OLinuXino can be partially powered over Micro USB, but to power all peripherals, a 6+ watt DC power supply between 6 and 16 volts can be used. The connector is a positive-center 2.5mm barrel plug. There is also an on-board connector for a Li-PO battery.

==Software==

[http://linux-sunxi.org/Main_Page A generic wiki for the allwinner devices is here. It contains some great detailed info]

=== Bare Metal programming - no OS ===

It is possible to program and debug code written directly on the chip without an OS such as linux or android. 
The advantage is no kernel overhead and tighter control of the CPU operation.

[[Bare Metal programming A13]]

=== Using an operating system - Nand flash ===

The Wifi version of the A13 board comes preprogrammed with android, which is held in the Nand flash.

The image in the Nand flash can be updated using the tools found at the following links:

[https://docs.google.com/file/d/0B7WHuNCASY8cWlZ2djh4X0QtV0U/edit?usp=sharing LiveSuit for Windows]

[http://linux-sunxi.org/LiveSuit LiveSuit for loading images]

to the NAND flash; to activate A13 bootloader do as follows: run Livesuit, disconnect the power supply and USB cable, then press HOME button, apply power supply, attach USB cable and release the button, Livesuit will detect the bootloader and will ask which file to program to the NAND flash.

Prebuilt images that can be programmed into the Nand flash can be found here.

[https://docs.google.com/open?id=0B-bAEPML8fwlR3hSS0R5aHpoVmM Andoroid 4.0.3 NAND flash prebuild image for VGA 800x600 resolution (default shipped with A13-OLinuXino-WIFI)]

[https://docs.google.com/open?id=0B-bAEPML8fwleXBMellGdWJ3RUk Andoroid 4.0.3 NAND flash prebuild image for LCD 800x480 resolution ]

[https://docs.google.com/file/d/0B-bAEPML8fwlbWVBN2RWVXBhTXc/edit?usp=sharing Android 4.1 NAND flash prebuild image for LCD480x272]

[https://docs.google.com/file/d/0B-bAEPML8fwlcHFOcUxtQ1N5RDQ/edit A13-LCD43 script.bin]

=== Using an operating system - SD card ===
The A13 board can boot from an SD card. Just plug it in an imaged uSD card and connect power.

Note: The SD card can easily be corrupted if power is removed while the system is booting or writing to system files.
To avoid this do not remove power while it is booting and shut the system down properly before disconnecting power.

==== Prebuilt images ====

Some prebuilt images have been created, follow the link below for details.

[[Prebuilt SD card images running debian]]

==== Build your own kernel and image onto SD card ====

Some developers want more control over the kernel and modules that are included. The link below shows directions to build your own kernel and image it onto an SD card.

[[Build Bootable SD Card with Debian]] Step by step instructions how to make SD card image with above Kernel and U-boot

====Setup and configure the installed debian image====

There are several settings that can be made for a particular hardware configuration in the script file.

The following link explains the script file as well as wifi or ethernet setup and GPIO settings

[[Configuration of hardware in the debian image]]

====Installing UsbVideoClass(UVC) on A13-OLinuXino board====

To work with USB Video Cameras you have to enable the UVC support in the kernel. The link below explains how to do it.

[[UVC support]]

====Setup VLC player for video streaming on A13-OLinuXino board====

To setup video streaming you should first have installed UVC support so you can connect USB cameras to A13-OLinuXino.

[[VLC streaming]]

=== Creating a program to run on the A13-OlinuXino board ===

[[Programming for A13 in debian]] Step by step instructions to make your first hello world program run on the A13 board running debian.

=== Software Links ===

[http://linux-sunxi.org/Sunxi-tools Tools to hack A13-OLinuXino]

[http://olimex.wordpress.com/2012/11/23/running-debian-with-xfce4-on-a13-olinuxino/ Installing Xfce4 graphical interface on Debian] How to install XFCE4 on A13-OLinuXino

=== A13-SDK Android 4.0.3 ICS ===

A13-SDK contain everything you need to build Android ACS 4.0.3 NAND image for A13-OLinuXino-WIFI. Both mirrors contain same image a13.tar.gz which you should unpack and follow the instructions inside. Builds on Debian 64bit as on Ubuntu have some problems with Java which we never managed to solve.

[https://mega.co.nz/#!CgYGRQZL!BJXNQSQcRxLYswtsPI-EsjNTV0kk381Qzfs96Dx0Sn4 Mega upload mirror]

[https://docs.google.com/open?id=0B-bAEPML8fwldWIzY29GNDJ2ZW8 Gdrive mirror]

=== A13-SDK Android 4.1 JB ===

This is version 1.5 of A13-SDK which builds Android 4.1 Jelly Beans image. It works slower than 4.0.3 and we personally do not see any advantage to use 4.1 vs 4.0.3

[http://emicrotec.at/public/ Andreas Auer kindly offered to host this 4GB image]

== FAQ ==
Under construction

== List of Contributors ==

'''Henrik Nordstrom''' - a.k.a. hno, uboot for A13 development, A1X guru, Linux-Sunxi maintainer

'''Dimitar Gamishev''' - a.k.a. HEHOPMAJIEH, Linux kernel configuration for OLinuXino, Android images, LCD touchscreen

'''Alexandro Mery''' - a.k.a. mnemoc, Linux-Sunxi maintainer

'''Davide Fabbri''' - Linaro kernel and lubuntu image

'''Scott Anderson''' - A13 wiki maintainer

'''Jeffrey Wischkaemper''' - a.k.a. jwischka, A13-OLinuXino Debian image with X

'''Maxime Ripard''' - ARM Linux patches

'''Jason Plum''' - Arch Linux support

[[Category:A13]]

A13-OLinuXino

2013-04-30T14:12:30Z

Scott: /* Projects */

[[File:A13-OLinuXino-MAXI-WIFI-1.jpg|thumb| A13-OlinuXino-WIFI]]

[[File:A13-OLinuXino-MICRO.jpg|thumb| A13-OlinuXino-MICRO]]

The A13 processor from Allwinner runs at 1GHz with a Mali400 GPU. It was designed for integration into tablets. Olimex has made several development board designs based around this chip. This wiki page contains information about hardware and software to help make use of these development boards.

The A13 based boards currently available are 
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino-WIFI/ A13-OLinuXino-WIFI] - Recommended if your developing software for the A13 for the first time as its the only one with network connectivity.
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino/ A13-OLinuXino] - This is the same as the WIFI version but without WIFI module and NAND flash. Note: Android requires NAND flash to run, so this board can't run Android.
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino-MICRO/ A13-OLinuXino-MICRO] - Similar to the A13-OlinuXino but with less extras

== Projects ==
Projects people from the olinuxino community are working on or have finished and how they did it.

'''LINUX:''' 
[[Build Bootable SD Card with Debian]] Run Debian and u-boot, Step by step instructions how to make SD card image. 
[[Prebuilt SD card images running debian]]

[http://olimex.wordpress.com/2012/10/23/a13-olinuxino-playing-with-gpios/ Change GPIOs using scripts in linux]

[https://www.olimex.com/forum/index.php?topic=436.msg4066#msg4066 A13 OLinuXino fast GPIO with /dev/mem now achieve up to 2 Mhz toggle]

[https://www.olimex.com/forum/index.php?topic=899.0 A13 kernel module for direct support of UEXT MOD-IO board, adding ADC, relays etc, cool project can be used as reference how to make your own kernel modules]

[https://docs.google.com/open?id=0B7WHuNCASY8cWnRrQ0tGVFMybFk Instructions how to run MOD-BT with A13-OLinuXino]

'''ANDROID:''' 
[http://olimex.wordpress.com/2012/10/24/a13-olinuxino-project-control-relays-and-read-adcs-and-ios-with-android/ Interface MOD-IO board with I2C under Android ]

'''No OS''' 
[[Bare Metal programming A13]] Programming directly for the chip without an OS

'''FreedomBox:''' 
[https://wiki.debian.org/FreedomBox/UniLeipzigPractical FreedomBox/UniLeipzigPractical is the documentation of a freedom box related practical course at the AKSW Research Group at the University of Leipzig]

==Hardware==

Schematics and board designs can be found here

[https://github.com/OLIMEX/OLINUXINO/tree/master/HARDWARE Olimex Hardware]

Designs were created with Eagle

A limited functionality freeware version of Eagle can be downloaded here

[http://www.cadsoftusa.com/download-eagle/freeware/?language=en Eagle Freeware]

There is very limited information about the A13 processor. The only detailed data found is an A10 datasheet which has some errors in it apparently. As this is the best source of low level information it is linked here

[http://dl.linux-sunxi.org/A10/ A10 datasheet]

A serial connection can be made to the A13 board, which can help with debugging and is a booting option

[[Serial connection to A13]] Description of how to connect a computer to the A13 board over serial.

===Power===

The A13-OLinuXino can be partially powered over Micro USB, but to power all peripherals, a 6+ watt DC power supply between 6 and 16 volts can be used. The connector is a positive-center 2.5mm barrel plug. There is also an on-board connector for a Li-PO battery.

==Software==

[http://linux-sunxi.org/Main_Page A generic wiki for the allwinner devices is here. It contains some great detailed info]

=== Bare Metal programming - no OS ===

It is possible to program and debug code written directly on the chip without an OS such as linux or android. 
The advantage is no kernel overhead and tighter control of the CPU operation.

[[Bare Metal programming A13]]

=== Using an operating system - Nand flash ===

The Wifi version of the A13 board comes preprogrammed with android, which is held in the Nand flash.

The image in the Nand flash can be updated using the tools found at the following links:

[https://docs.google.com/file/d/0B7WHuNCASY8cWlZ2djh4X0QtV0U/edit?usp=sharing LiveSuit for Windows]

[http://linux-sunxi.org/LiveSuit LiveSuit for loading images]

to the NAND flash; to activate A13 bootloader do as follows: run Livesuit, disconnect the power supply and USB cable, then press HOME button, apply power supply, attach USB cable and release the button, Livesuit will detect the bootloader and will ask which file to program to the NAND flash.

Prebuilt images that can be programmed into the Nand flash can be found here.

[https://docs.google.com/open?id=0B-bAEPML8fwlR3hSS0R5aHpoVmM Andoroid 4.0.3 NAND flash prebuild image for VGA 800x600 resolution (default shipped with A13-OLinuXino-WIFI)]

[https://docs.google.com/open?id=0B-bAEPML8fwleXBMellGdWJ3RUk Andoroid 4.0.3 NAND flash prebuild image for LCD 800x480 resolution ]

[https://docs.google.com/file/d/0B-bAEPML8fwlbWVBN2RWVXBhTXc/edit?usp=sharing Android 4.1 NAND flash prebuild image for LCD480x272]

[https://docs.google.com/file/d/0B-bAEPML8fwlcHFOcUxtQ1N5RDQ/edit A13-LCD43 script.bin]

=== Using an operating system - SD card ===
The A13 board can boot from an SD card. Just plug it in an imaged uSD card and connect power.

Note: The SD card can easily be corrupted if power is removed while the system is booting or writing to system files.
To avoid this do not remove power while it is booting and shut the system down properly before disconnecting power.

==== Prebuilt images ====

Some prebuilt images have been created, follow the link below for details.

[[Prebuilt SD card images running debian]]

==== Build your own kernel and image onto SD card ====

Some developers want more control over the kernel and modules that are included. The link below shows directions to build your own kernel and image it onto an SD card.

[[Build Bootable SD Card with Debian]] Step by step instructions how to make SD card image with above Kernel and U-boot

====Setup and configure the installed debian image====

There are several settings that can be made for a particular hardware configuration in the script file.

The following link explains the script file as well as wifi or ethernet setup and GPIO settings

[[Configuration of hardware in the debian image]]

====Installing UsbVideoClass(UVC) on A13-OLinuXino board====

To work with USB Video Cameras you have to enable the UVC support in the kernel. The link below explains how to do it.

[[UVC support]]

====Setup VLC player for video streaming on A13-OLinuXino board====

To setup video streaming you should first have installed UVC support so you can connect USB cameras to A13-OLinuXino.

[[VLC streaming]]

=== Creating a program to run on the A13-OlinuXino board ===

[[Programming for A13 in debian]] Step by step instructions to make your first hello world program run on the A13 board running debian.

=== Software Links ===

[http://linux-sunxi.org/Sunxi-tools Tools to hack A13-OLinuXino]

[http://olimex.wordpress.com/2012/11/23/running-debian-with-xfce4-on-a13-olinuxino/ Installing Xfce4 graphical interface on Debian] How to install XFCE4 on A13-OLinuXino

=== A13-SDK Android 4.0.3 ICS ===

A13-SDK contain everything you need to build Android ACS 4.0.3 NAND image for A13-OLinuXino-WIFI. Both mirrors contain same image a13.tar.gz which you should unpack and follow the instructions inside. Builds on Debian 64bit as on Ubuntu have some problems with Java which we never managed to solve.

[https://mega.co.nz/#!CgYGRQZL!BJXNQSQcRxLYswtsPI-EsjNTV0kk381Qzfs96Dx0Sn4 Mega upload mirror]

[https://docs.google.com/open?id=0B-bAEPML8fwldWIzY29GNDJ2ZW8 Gdrive mirror]

=== A13-SDK Android 4.1 JB ===

This is version 1.5 of A13-SDK which builds Android 4.1 Jelly Beans image. It works slower than 4.0.3 and we personally do not see any advantage to use 4.1 vs 4.0.3

[http://emicrotec.at/public/ Andreas Auer kindly offered to host this 4GB image]

== FAQ ==
Under construction

== List of Contributors ==

'''Henrik Nordstrom''' - a.k.a. hno, uboot for A13 development, A1X guru, Linux-Sunxi maintainer

'''Dimitar Gamishev''' - a.k.a. HEHOPMAJIEH, Linux kernel configuration for OLinuXino, Android images, LCD touchscreen

'''Alexandro Mery''' - a.k.a. mnemoc, Linux-Sunxi maintainer

'''Davide Fabbri''' - Linaro kernel and lubuntu image

'''Scott Anderson''' - A13 wiki maintainer

'''Jeffrey Wischkaemper''' - a.k.a. jwischka, A13-OLinuXino Debian image with X

'''Maxime Ripard''' - ARM Linux patches

'''Jason Plum''' - Arch Linux support

[[Category:A13]]

A13-OLinuXino

2013-04-30T13:49:05Z

Scott: /* Bare Metal programming - no OS */

[[File:A13-OLinuXino-MAXI-WIFI-1.jpg|thumb| A13-OlinuXino-WIFI]]

[[File:A13-OLinuXino-MICRO.jpg|thumb| A13-OlinuXino-MICRO]]

The A13 processor from Allwinner runs at 1GHz with a Mali400 GPU. It was designed for integration into tablets. Olimex has made several development board designs based around this chip. This wiki page contains information about hardware and software to help make use of these development boards.

The A13 based boards currently available are 
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino-WIFI/ A13-OLinuXino-WIFI] - Recommended if your developing software for the A13 for the first time as its the only one with network connectivity.
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino/ A13-OLinuXino] - This is the same as the WIFI version but without WIFI module and NAND flash. Note: Android requires NAND flash to run, so this board can't run Android.
*[https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino-MICRO/ A13-OLinuXino-MICRO] - Similar to the A13-OlinuXino but with less extras

== Projects ==
Projects people from the olinuxino community are working on or have finished and how they did it.

'''LINUX:'''

[[Build Bootable SD Card with Debian]] Run Debian and u-boot, Step by step instructions how to make SD card image. 
[[Prebuilt SD card images running debian]]

[http://olimex.wordpress.com/2012/10/23/a13-olinuxino-playing-with-gpios/ Change GPIOs using scripts in linux]

[https://www.olimex.com/forum/index.php?topic=436.msg4066#msg4066 A13 OLinuXino fast GPIO with /dev/mem now achieve up to 2 Mhz toggle]

[https://www.olimex.com/forum/index.php?topic=899.0 A13 kernel module for direct support of UEXT MOD-IO board, adding ADC, relays etc, cool project can be used as reference how to make your own kernel modules]

[https://docs.google.com/open?id=0B7WHuNCASY8cWnRrQ0tGVFMybFk Instructions how to run MOD-BT with A13-OLinuXino]

'''ANDROID:'''

[http://olimex.wordpress.com/2012/10/24/a13-olinuxino-project-control-relays-and-read-adcs-and-ios-with-android/ Interface MOD-IO board with I2C under Android ]

'''FreedomBox:'''

[https://wiki.debian.org/FreedomBox/UniLeipzigPractical FreedomBox/UniLeipzigPractical is the documentation of a freedom box related practical course at the AKSW Research Group at the University of Leipzig]

==Hardware==

Schematics and board designs can be found here

[https://github.com/OLIMEX/OLINUXINO/tree/master/HARDWARE Olimex Hardware]

Designs were created with Eagle

A limited functionality freeware version of Eagle can be downloaded here

[http://www.cadsoftusa.com/download-eagle/freeware/?language=en Eagle Freeware]

There is very limited information about the A13 processor. The only detailed data found is an A10 datasheet which has some errors in it apparently. As this is the best source of low level information it is linked here

[http://dl.linux-sunxi.org/A10/ A10 datasheet]

A serial connection can be made to the A13 board, which can help with debugging and is a booting option

[[Serial connection to A13]] Description of how to connect a computer to the A13 board over serial.

===Power===

The A13-OLinuXino can be partially powered over Micro USB, but to power all peripherals, a 6+ watt DC power supply between 6 and 16 volts can be used. The connector is a positive-center 2.5mm barrel plug. There is also an on-board connector for a Li-PO battery.

==Software==

[http://linux-sunxi.org/Main_Page A generic wiki for the allwinner devices is here. It contains some great detailed info]

=== Bare Metal programming - no OS ===

It is possible to program and debug code written directly on the chip without an OS such as linux or android. 
The advantage is no kernel overhead and tighter control of the CPU operation.

[[Bare Metal programming A13]]

=== Using an operating system - Nand flash ===

The Wifi version of the A13 board comes preprogrammed with android, which is held in the Nand flash.

The image in the Nand flash can be updated using the tools found at the following links:

[https://docs.google.com/file/d/0B7WHuNCASY8cWlZ2djh4X0QtV0U/edit?usp=sharing LiveSuit for Windows]

[http://linux-sunxi.org/LiveSuit LiveSuit for loading images]

to the NAND flash; to activate A13 bootloader do as follows: run Livesuit, disconnect the power supply and USB cable, then press HOME button, apply power supply, attach USB cable and release the button, Livesuit will detect the bootloader and will ask which file to program to the NAND flash.

Prebuilt images that can be programmed into the Nand flash can be found here.

[https://docs.google.com/open?id=0B-bAEPML8fwlR3hSS0R5aHpoVmM Andoroid 4.0.3 NAND flash prebuild image for VGA 800x600 resolution (default shipped with A13-OLinuXino-WIFI)]

[https://docs.google.com/open?id=0B-bAEPML8fwleXBMellGdWJ3RUk Andoroid 4.0.3 NAND flash prebuild image for LCD 800x480 resolution ]

[https://docs.google.com/file/d/0B-bAEPML8fwlbWVBN2RWVXBhTXc/edit?usp=sharing Android 4.1 NAND flash prebuild image for LCD480x272]

[https://docs.google.com/file/d/0B-bAEPML8fwlcHFOcUxtQ1N5RDQ/edit A13-LCD43 script.bin]

=== Using an operating system - SD card ===
The A13 board can boot from an SD card. Just plug it in an imaged uSD card and connect power.

Note: The SD card can easily be corrupted if power is removed while the system is booting or writing to system files.
To avoid this do not remove power while it is booting and shut the system down properly before disconnecting power.

==== Prebuilt images ====

Some prebuilt images have been created, follow the link below for details.

[[Prebuilt SD card images running debian]]

==== Build your own kernel and image onto SD card ====

Some developers want more control over the kernel and modules that are included. The link below shows directions to build your own kernel and image it onto an SD card.

[[Build Bootable SD Card with Debian]] Step by step instructions how to make SD card image with above Kernel and U-boot

====Setup and configure the installed debian image====

There are several settings that can be made for a particular hardware configuration in the script file.

The following link explains the script file as well as wifi or ethernet setup and GPIO settings

[[Configuration of hardware in the debian image]]

====Installing UsbVideoClass(UVC) on A13-OLinuXino board====

To work with USB Video Cameras you have to enable the UVC support in the kernel. The link below explains how to do it.

[[UVC support]]

====Setup VLC player for video streaming on A13-OLinuXino board====

To setup video streaming you should first have installed UVC support so you can connect USB cameras to A13-OLinuXino.

[[VLC streaming]]

=== Creating a program to run on the A13-OlinuXino board ===

[[Programming for A13 in debian]] Step by step instructions to make your first hello world program run on the A13 board running debian.

=== Software Links ===

[http://linux-sunxi.org/Sunxi-tools Tools to hack A13-OLinuXino]

[http://olimex.wordpress.com/2012/11/23/running-debian-with-xfce4-on-a13-olinuxino/ Installing Xfce4 graphical interface on Debian] How to install XFCE4 on A13-OLinuXino

=== A13-SDK Android 4.0.3 ICS ===

A13-SDK contain everything you need to build Android ACS 4.0.3 NAND image for A13-OLinuXino-WIFI. Both mirrors contain same image a13.tar.gz which you should unpack and follow the instructions inside. Builds on Debian 64bit as on Ubuntu have some problems with Java which we never managed to solve.

[https://mega.co.nz/#!CgYGRQZL!BJXNQSQcRxLYswtsPI-EsjNTV0kk381Qzfs96Dx0Sn4 Mega upload mirror]

[https://docs.google.com/open?id=0B-bAEPML8fwldWIzY29GNDJ2ZW8 Gdrive mirror]

=== A13-SDK Android 4.1 JB ===

This is version 1.5 of A13-SDK which builds Android 4.1 Jelly Beans image. It works slower than 4.0.3 and we personally do not see any advantage to use 4.1 vs 4.0.3

[http://emicrotec.at/public/ Andreas Auer kindly offered to host this 4GB image]

== FAQ ==
Under construction

== List of Contributors ==

'''Henrik Nordstrom''' - a.k.a. hno, uboot for A13 development, A1X guru, Linux-Sunxi maintainer

'''Dimitar Gamishev''' - a.k.a. HEHOPMAJIEH, Linux kernel configuration for OLinuXino, Android images, LCD touchscreen

'''Alexandro Mery''' - a.k.a. mnemoc, Linux-Sunxi maintainer

'''Davide Fabbri''' - Linaro kernel and lubuntu image

'''Scott Anderson''' - A13 wiki maintainer

'''Jeffrey Wischkaemper''' - a.k.a. jwischka, A13-OLinuXino Debian image with X

'''Maxime Ripard''' - ARM Linux patches

'''Jason Plum''' - Arch Linux support

[[Category:A13]]

Bare Metal programming A13

2013-04-30T13:38:41Z

Scott:

Bare Metal programming A13

2013-04-30T12:51:48Z

Scott:

2013-01-12T15:53:25Z

Scott: /* Programming on the A13 board */

'''THIS IS A WORK IN PROGRESS'''

== Programming for A13 in debian==

There are 2 main methods to create programs for your A13 board.
* Cross compiling - Setting up a tool chain to compile on another system, which is typically faster and easier to manage.
* Programming on board - installing a compiler to compile directly on the board

The sections below contain instructions for these 2 methods

== Cross Compiling ==
Cross compiling is usually performed on another linux machine, it seems the most common for doing this is ubuntu.

If you have compiled the kernel and setup the SD card you will already have most of the tool chain setup on your machine

=== Setting up the tool chain ===

The following instructions are to be performed on a linux machine which is not the A13 board.

Complete the following steps to setup the tool chain.

These instructions have been tested on ubuntu only however they may work for other distributions.

==== Install eclipse ====

Eclipse is a GUI which enables easy compilation and debugging when the appropriate tools have been installed.

This may be able to be installed using the package manager on your linux system.

'''Manual eclipes install''' 
To manually install the most up to date eclipse perform the following

Go to the eclipse download section

[http://www.eclipse.org/downloads/ Eclipse download] Download to your linux machine the suitable eclipse version.

Decompress the downloaded file into any directory you like by moving the downloaded file to your desired directory.
Open a terminal, go to the directory and decompress with the command

tar -xzvf FILENAME.

This will create a directory in this location called eclipse
Within this directory is the executable eclipse.exe

It is recommended to create a launcher on your desktop which points to this executable file to make it easier to start.

'''Manual Java runtime install''' 
As eclipse is written in java the jave runtime is required as well.

Download the java runtime.

[http://java.com/en/download/manual.jsp Java download page] Download the java RPM file that your eclipse version requires.

Follow the instructions on the java download page beside the download to install

Your eclipse installation should now start up.

==== Install the tool chain ====

The instructions contained in this wiki were originally sourced from this page [http://www.agilart.com/blog/debugging-on-embedded-using-opensource-tools-part-1 Debugging on embedded using opensource tools]

To compile code for the A13 the ArmV5 tool chain is required.

Change to super user 
<nowiki># sudo su</nowiki>

Install compilers, libs and make
<nowiki># apt-get install gcc g++ make libncurses5-dev</nowiki>

Open the repository file 
/etc/apt/sources.list

Add the following line 
deb http://www.emdebian.org/debian/ squeeze main

update the repository info 
<nowiki># apt-get update</nowiki>

install some packages 
<nowiki># apt-get install linux-libc-dev-armel-cross </nowiki> 
<nowiki># apt-get install libc6-armel-cross </nowiki> 
<nowiki># apt-get install libc6-dev-armel-cross </nowiki> 
<nowiki># apt-get install binutils-arm-linux-gnueabi </nowiki> 
<nowiki># apt-get install gcc-4.4-arm-linux-gnueabi </nowiki> 
<nowiki># apt-get install g++-4.4-arm-linux-gnueabi </nowiki> 
<nowiki># apt-get install uboot-mkimage </nowiki> 

The tool chain should now be installed

==== Creating a hello world program using eclipse ====

Follow this tutorial to create a hello world program
[http://www.agilart.com/blog/debugging-on-embedded-using-opensource-tools-part-1 Debugging on embedded using opensource tools]

Some issues found for some users:

'''- Issue :''' After having installed eclipse and the toolchain the path and prefix for the compiler as listed in the example could not be found.

Solution : Look for the same prefix in a different path, /usr/bin is likely to hold the files.

'''- Issue :''' Having built the program and copied it to the A13 board it will not run resulting in "permission denied"

Solution: Check the permissions for the file are set to allow execution by typing #ls -l . if you dont see a lot of x's (3) in the first column its likely your cause. To change the permissions type #chmod ugo+x FileName

'''- Issue :''' executing the file returns "command not found"

Solution: A library file can not be found this is either /lib/ld-linux.so.3 or /lib/ld-linux-armhf.so.3 . To find the specific one your file is looking for open the executable in a text editor on the first line or 2 you will find the file name its looking for ld-linux.so.3 .

== Programming on the A13 board ==

Below is a way to create a hello world program on your A13 olinuxino board

in a suitable folder create your code file by typing 
nano hello.c

type the following into the program
-----------------------

<nowiki>#include <stdio.h></nowiki>

main () 
{ 
printf("hello world\n"); 
} 

-----------------------

save by pressing ctrl o 
exit by pressing ctrl x 

compile the program in the command line by typing 
gcc -o hello hello.c 
or 
gcc-4.6 -o hello hello.c

make the file executable by typing 
chmod z+x hello

Execute the binary file 
./hello

this should print out hello world

if it has this means you have created a program on your A13 olinuxino board

Prebuilt SD card images running debian

2013-01-09T06:11:11Z

Scott: /* Debian with GUI (X) */

The A13 board can boot from the SD card. There are some ready made SD card images that are suitable. Some of these images can be found in this wiki section.

Once a suitable SD card is imaged with these files, place it into the board then power the board on, it should boot.

All images will have been generated for a specific SD card size. To use these images you must use a SD card that is the specified size or larger.

When the image is downloaded the SD card will only have partitions set up for the originally specified size for the image. If a larger SD card was used you can access the extra memory by using resize2fs.

Note: Some SD cards will list a size on them however the exact number of usable bytes can vary either through bad sectors or different manufacturers. The consequence of this is that an image from a particular size SD card may not fit on another of the same size. If this is the case an error will come up when imaging the card "No space left on device" or a windows error depending on the tool being used. If this issue comes up use a larger SD card size.

== Download Method==
These images can be downloaded using the methods below

'''Windows:'''
* Download [http://sourceforge.net/projects/win32diskimager/ Win32 Disk Imager]
* Insert card
* Start program
* Select file
* Click "write"

'''Linux:'''
*transfer to card
For example an image with the file name of "debian_2g.img" would be downloaded to the SD card connected to a linux machine using one of the following commands:

<code># dd bs=4M oflag=sync if=debian_2g.img of=/dev/sdX</code> 
or 
<code># cp debian_2g.img /dev/sdX</code>

where X is the uSD card.

==Images==

===Debian image===

[https://docs.google.com/open?id=0B-bAEPML8fwlU1NBQ015V2Naa2s A13 Debian Linux Image]

Configuration
* 2g SD card image
* without X
* includes Mplayer CLI, GCC
* The default user/password are '''root'''/'''password'''

Extract it and write the image (A13_Micro_Debian_first_preliminary_release.img) on SD card

Note: as this comes in a tar.bz2 file this is best imaged using linux

===Debian with GUI (X)===
Created by jwischka

[https://dl.dropbox.com/u/26179254/olinuxino_xfce.zip A13 Debian Image with X V2]

[http://files.wisch.org/olinuxino_xfce-20130108.zip A13 Debian Image with X V3]

Configuration 
V2
* 4g SD card image
* wpa-supplicant (change /etc/network/interfaces to enter your ssid/key)
* xfce4
* tightvncserver (starts on boot)
* various dev tools (python, gcc, etc)
* sudo
* 500mb swap file
* custom (non-debug) kernel
* default user name and password: olinuxino and olinuxino

V3
* Updated kernel to 3.0.57.
* Changed FS to ext4, but left journaling intact. Journaling is fairly important when you may lose power at any point in time.
* Updated all packages to latest version.

once logged in to start the user interface type "startx"

[https://www.olimex.com/forum/index.php?topic=537.0 Forum thread link for this image]

===Linaro Image===
[https://docs.google.com/open?id=0B-bAEPML8fwlRm5ZSmZtUXQyMTg Linaro ALIP image]

Configuration
* 4gb SD card image
* Linaro alip ( lubuntu 12.04 widh lxde desktop environment, minimal )
* kernel 3.4.19
* to setup networking you can edit /etc/network/interfaces
* Password is linaro

[https://www.olimex.com/forum/index.php?topic=581.0 Forum thread link for this image]