OLIMEX IMX233-OLinuXino-MAXI User manual

IMX233-OLinuXino-MAXI
an open-source embedded Linux board
USER’S MANUAL
Revision M, January 2015
Designed by OLIMEX Ltd, 2012
All boards produced by Olimex LTD are ROHS compliant

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
DIS LAIMER
© 015 Olimex Ltd. Olimex®, logo and combinations thereof, are registered trademarks of Olimex Ltd. Other product
names may be trademarks of others and the rights belong to their respective owners.
The in ormation in this document is provided in connection with Olimex products. No license, express or implied
or otherwise, to any intellectual property right is granted by this document or in connection with the sale o
Olimex products.
This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License. To view a copy of
this license, visit http://www.creativecommons.org/licenses/by-sa/3.0/.
This hardware design by Olimex LTD is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported
License.
The software is released under GPL.
It is possible that the pictures in this manual differ from the latest revision of the board.
The product described in this document is subject to continuous development and improvements. All particulars of the
product and its use contained in this document are given by OLIMEX in good faith. However all warranties implied or
expressed including but not limited to implied warranties of merchantability or fitness for purpose are excluded. This
document is intended only to assist the reader in the use of the product. OLIMEX Ltd. shall not be liable for any loss or
damage arising from the use of any information in this document or any error or omission in such information or any
incorrect use of the product.
This evaluation board/kit is intended for use for engineering development, demonstration, or evaluation purposes only
and is not considered by OLIMEX to be a finished end-product fit for general consumer use. Persons handling the
product must have electronics training and observe good engineering practice standards. As such, the goods being
provided are not intended to be complete in terms of required design-, marketing-, and/or manufacturing-related
protective considerations, including product safety and environmental measures typically found in end products that
incorporate such semiconductor components or circuit boards.
Olimex currently deals with a variety of customers for products, and therefore our arrangement with the user is not
exclusive. Olimex assumes no liability for applications assistance, customer product design, software performance, or
infringement of patents or services described herein.
THERE IS NO WARRANTY FOR THE DESIGN MATERIALS AND THE COMPONENTS USED TO
CREATE OLINUXINO. THEY ARE CONSIDERED SUITABLE ONLY FOR OLINUXINO.
Page of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
Table of Contents
DISCLAIMER ......................................................................................................................................
CHAPTER 1: OVERVIEW .................................................................................................................. 5
1. Introduction to the chapter ........................................................................................................... 5
1.1 Features ...................................................................................................................................... 5
1. The OLinuXino family .............................................................................................................. 6
1.3 Target market and purpose of the board ..................................................................................... 7
1.4 Organization ............................................................................................................................... 7
CHAPTER : SETTING UP THE OLINUXINO BOARD ................................................................. 8
. Introduction to the chapter ........................................................................................................... 8
.1 Electrostatic warning ................................................................................................................. 8
.3 Requirements ............................................................................................................................. 8
.4 Powering the board .................................................................................................................... 9
.5 Prebuilt software ...................................................................................................................... 10
.6 Using BitBurner ....................................................................................................................... 10
.7 Building the Linux image ........................................................................................................ 1
.8 How to blink the LED .............................................................................................................. 14
.9 How setup the I C, SPI, UART ............................................................................................... 15
.10 How to setup Arch-Linux distribution ................................................................................... 15
.11 How to use a USB WiFi dongle based on RealTek RTL8188CUS and ................................. 19
RTL819 CU under ARCH Linux .................................................................................................. 19
3. Introduction to the chapter ......................................................................................................... 4
3.1 Layout (top view) ..................................................................................................................... 4
CHAPTER 4: THE iMX 33 MICROCONTROLLER ...................................................................... 5
4. Introduction to the chapter ......................................................................................................... 5
4.1 The microcontroller ................................................................................................................. 5
CHAPTER 5: CONTROL CIRCUITY .............................................................................................. 8
5. Introduction to the chapter ......................................................................................................... 8
5.1 Reset ......................................................................................................................................... 8
5. Clocks ...................................................................................................................................... 8
5.3 Power supply circuit ................................................................................................................ 8
CHAPTER 6: CONNECTORS AND PINOUT ................................................................................. 31
6. Introduction to the chapter ......................................................................................................... 31
6.1 Debugging interfaces ............................................................................................................... 31
6.1.1 UART debug ......................................................................................................................... 3
6.1. SJTAG debug ........................................................................................................................ 3
6.1.3 Classic JTAG debug .............................................................................................................. 33
6. SD/MMC slot ........................................................................................................................... 35
6.3 UEXT module .......................................................................................................................... 36
Page 3 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
6.4 GPIO (General Purpose Input/Output) 40pin connector ......................................................... 37
6.5 USB HOSTs ............................................................................................................................. 41
6.6 LAN connector ........................................................................................................................ 4
6.7 PWR Jack ................................................................................................................................. 4
6.8 Headphones and line-in connector ........................................................................................... 43
6.9 Battery connector ..................................................................................................................... 43
6.10 Composite video connector ................................................................................................... 44
6.11 Boot mode positions .............................................................................................................. 44
6.1 Jumper description ................................................................................................................. 45
6.1 .1 SCL_SW/SCL_HW and SDA_SW/SDA_HW .................................................................. 45
6.1 . 5V_E ................................................................................................................................... 46
6.1 .3 3.3V_E and 3.3VIO_E jumpers .......................................................................................... 46
6.1 .4 Boot mode selecting jumpers .............................................................................................. 46
6.13 Additional hardware components .......................................................................................... 46
6.14 Accessories ............................................................................................................................. 47
6.14.1 USB-SERIAL-CABLE-F ................................................................................................... 47
CHAPTER 7: BLOCK DIAGRAM AND MEMORY ....................................................................... 48
7. Introduction to the chapter ......................................................................................................... 48
7.1 Memory addresses ................................................................................................................... 48
7. Processor block diagram .......................................................................................................... 49
7.3 Physical memory map .............................................................................................................. 50
CHAPTER 8: SCHEMATICS ............................................................................................................ 51
8. Introduction to the chapter ......................................................................................................... 51
8.1 Eagle schematic ....................................................................................................................... 51
8. Physical dimensions ................................................................................................................. 53
CHAPTER 9: REVISION HISTORY AND SUPPORT .................................................................... 54
9. Introduction to the chapter ......................................................................................................... 54
9.1 Document revision ................................................................................................................... 54
9. Board revision .......................................................................................................................... 57
9.3 Useful web links and purchase codes ...................................................................................... 58
9.4 Product support ........................................................................................................................ 59
Page 4 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
HAPTER 1: OVERVIEW
1. Introduction to the chapter
Thank you for choosing the OLinuXino single board computer from Olimex! This document
provides a user’s guide for the Olimex OLinuXino board. As an overview, this chapter gives the
scope of this document and lists the board’s features. The differences between the members of the
OLinuXino family are mentioned. The document’s organization is then detailed.
The OLinuXino development board enables code development of applications running on the
microcontroller i.MX 33, manufactured by FreeScale Semiconductor.
OLinuXino is an open-source, open-hardware project and all documentation is available to the
customer.
1.1 Features
•iMX 33 ARM9 6J processor at 454Mhz
•64 MB RAM
•SD-card connector for booting the Linux image
•TV PAL/NTSC video output
•3 USB High Speed Host
•optional WIFI RTL8188CU module
•Stereo Audio Input
•Stereo Headphones Audio Output
•two Buttons
•UEXT connector for connection of different peripherial modules
•40 pin GPIO for connection of other hardware
•Board is in shape for fit inside Pactec JM4 plastic box
http://www.pactecenclosures.com/pdfs/drw_JM-4 .pdf
•Power supply input 6-16VDC
•PCB dimensions: 3.70'' x .15'' (94.0mm x 54.6mm)
•Nominal dimensions: 3.70'' x .65'' (94.0mm x 67.3mm)
Page 5 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
1.2 The OLinuXino family
Table of comparison
OLinuXino-NANO OLinuXino-MICRO OLinuXino-MINI OLinuXino-MAXI
Processor iMX233 @ 454Mhz iMX233 @ 454Mhz iMX233 @ 454Mhz iMX233 @ 454Mhz
Ram [MB] 64 64 64 64
# SB hosts 1 1 3 2
100/150 Mbit
Ethernet*
No/WIFI
option**
No/WIFI option** No/WIFI
option***
Yes/WIFI
option**
GPIO connector 40pins 60pins 40pins 40pins
# of buttons 3 3 2 2
Reset button Yes Yes Yes Yes
DC power supply 5V 5V 6V-16V 6V-16V
Dimensions 3.00'' 0.80'' 3.40'' 1.70'' 3.70'' 2.65'' 3.70'' 2.65''
Breadboarding Yes Yes No No
Audio IN
connector
No No Yes Yes
Audio O T
connector
No No Yes Yes
EXT connector Yes No Yes Yes
Power jack No**** Yes Yes Yes
VGA connector No Yes Yes Yes
* 100Mbit Ethernet for the wired network of OLinuXino-MAXI. 150Mbit for the WIFI following
811.0 n standard.
** All three boards have the option to work with MOD-WIFI_RTL8188, which is USB WIFI
modem with RTL8188CU chip and can be purchased separately. MOD-WIFI_RTL8188 can be
connected to any of the OLinuXino boards via the USB.
*** OlinuXino-MINI has additional option of having RTL8188CU hardware mounted! If you wish
RTL8188CU embedded in the device you should purchase OLinuXino-MINI-WIFI. Choosing the
embedded WIFI option will leave your USB-HOSTs available for use.
**** There is an easy access to the power pin holes, however. Especially, if you use a breadboard.
Page 6 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
1.3 Target market and purpose of the board
The boards from the OLinuXino family are ready to use, easy to setup and are suitable for
embedded programming enthusiasts, Linux hobbyists, gadget fans and also professionals (since its
low cost makes it very good solution for application orientated embedded systems). The main usage
of the board is software embedded development without the urge of understanding perfectly the
hardware.
The strong points of the boards are the processor speed, the mobility of the board and the low price.
Customers have full access to the technical documentation of the board. The software is released
under General Purpose License and the board is considered open-hardware.
1.4 Organization
Each section in this document covers a separate topic, organized as follow:
–Chapter 1 is an overview of the board usage and features
–Chapter provides a guide for quickly setting up the board and software notes
–Chapter 3 contains the general board diagram and layout
–Chapter 4 describes the component that is the heart of the board: the iMX 33
microcontroller
–Chapter 5 is an explanation of the control circuitry associated with the microcontroller to
reset. Also shows the clocks on the board
–Chapter 6 covers the connector pinout, peripherals and jumper description
–Chapter 7 shows the memory map
–Chapter 8 provides the schematics
–Chapter 9 contains the revision history, useful links and support information
Page 7 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
HAPTER 2: SETTING UP THE OLINUXINO BOARD
2. Introduction to the chapter
This section helps you set up the OLinuXino development board for the first time. Please consider
first the electrostatic warning to avoid damaging the board, then discover the hardware and software
required to operate the board.
The procedure to power up the board is given, and a description of the default board behavior is
detailed.
2.1 Electrostatic warning
OLinuXino is shipped in a protective anti-static package. The board must not be exposed to high
electrostatic potentials. A grounding strap or similar protective device should be worn when
handling the board. Avoid touching the component pins or any other metallic element.
2.3 Requirements
In order to set up the OLinuXino optimally, the following items are required:
- 6V to 16V source of power with 1A maximum amperage.
- SJTAG interface programmer
- USB keyboard
- Monitor with composite interface or Personal Computer + USB-SERIAL-CABLE
- SD card with Linux image
Note that the board arrives without SD card or Linux image. You can purchase a card with Linux
separately. It is recommended that the user has basic Linux experience.
Some of the suggested items can be purchased by Olimex, for instance:
iMX233-OLinuXino-SD – SD card with the Linux image
USB-SERIAL-CABLE-F – USB serial console cable female (check “6.1.1 UART Debug” for info
how to connect it to the board)
SY0612E – power supply adapter 1 V/0.5A for iMX 33-OLinuXino-Maxi
Page 8 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
2.4 Powering the board
The board is powered either via the PWR jack or via a battery. It should be supplied from a 6V to
16V source with maximum current of 1A from the power jack.
All measures below are taken at 10V.
If measuring the current consumption it should be around 0.06A before initializing all the
peripherals. The consumption raises to 0.1 A without LAN and USB hosts initialized and Linux
running. The consumption goes up 0.15A with the Linux running when LAN and both USB hosts
initialized.
If you have a standard USB flash drive attached to a USB host, Linux and LAN running the typical
consumption is around 0. 0A.
When powered by the typical 3.7V battery the LAN and USB-hosts will be powered-off if you use
the external 3.3V DC-DC (they will stil work if using the internal in the processor DC-DC). The
consumption from the battery when Linux is running is around 0.75A.
IMPORTANT! We discovered a situation which might leave some o the SD cards (iMX233-
OLinuXino-SD) in unrecoverable state when powering OLinuXino-MICRO. The problem
might occur i two speci ic conditions are met simultaneously:
1)Plugged iMX233-OLinuXino-SD micro SD card with holographic sticker on its back side
(some o the cards we have distributed are rom a brand that places holographic sticker on
their backs, the other hal lack such a sticker)
2)Plugged USB-SERIAL-CABLE-F at the moment when powering the board
I you happen to have received SD card with holographic sticker on its back side and you use
it with OLinuXino-MICRO and you plug USB-SERIAL-CABLE and then you power the
board there is a chance o mal unction o the SD card.
There are two possible workarounds to protect the SD card. The irst one is simpler and the
second one requires some soldering experience.
Workaround 1: First insert the iMX233-OLinuXino-SD card and then power the board (and
i powering the board rom a battery also press the PWR button). Wait 4-5 seconds and then
connect the USB-SERIAL-CABLE-F. A ter the initial power-up it is sa e to use the reset
button.
Workaround 2: You will need a Shottky diode. The Shottky should be soldered on the USB-
SERIAL-CABLE-F TX line/wire (RED cable) with anode towards the board.
Page 9 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
When you power the board by battery you have to press the PWR_BUT to start the board.
I you start Linux and it is already running no matter which powering method you use
(PWR_JACK or BAT) pressing the PWR_BUT will put the Linux in power-save mode.
When you power the board by battery you have to press the PWR_BUT to start the board.
I you start Linux and it is already running no matter which powering method you use
(PWR_JACK or BAT) pressing the PWR_BUT will put the Linux in power-save mode.
For the European customers we sell a power supply adapter 1 V/0.5A – SY061 E.
2.5 Prebuilt software
Note that the boards arrive without Linux or SD card. The Linux image can be purchased
separately on a SD card or you can built and adjust it yoursel .
When we program the boards we change the default position of the following HW_OCOTP_ROM0
fuses of the processor:
SD_MBR_BOOT(3) - Blown
SD_POWER_GATE_GPIO( 1: 0) – 10-PWM3
For burning the fuse position we use the BitBurner software. This operation is discussed in details
before. Proceed with great caution when burning fuses since it is irreversible operation.
The first batches of the board and the SD-card used the Debian Linux image. After that we switched
over to ArchLinux for the ease of the package manager. Instructions how to build the ArchLinux
can be found at the gitHub address of OLinuXino.
2.6 Using BitBurner
IMPORTANT! MODIFYING THE FUSES IS IRREVERSIBLE PROCESS! BURNING THE
WRONG FUSES MIGHT DAMAGE OLINUXINO IRREVERSIBLY! BURNING WRONG
FUSES MIGHT CAUSE BOOT PROBLEMS!
BURN FUSES AT OWN RISK!
The bit burning is done via the USB of the computer connected to the OLINUXINO board and the
BitBurner software. To be able to burn the fuses you will need to make a custom cable that connects
a USB with the 3 pin holes found at the bottom of the board named “GND”, “DP”, “DM” (check
the picture below for a better view how the three wires must be connected.
Page 10 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
After soldering the three wires you can place a marker on each of them or use colored wires to be
able to distinguish them. You can also use some gel to keep them tight on the USB connector. On
the opposite side of the cables you might place 50mil (1. 7mm) male connector following the order
of the signals. Please also restrain from using wires longer than 0 cm since that might make the
connection unreliable.
Download BitBurner from https://www.olimex.com/dev/OLINUXINO/iMX 33-
OLINUXINO/BitBurner.v1.0.4.6.zip. Extract it and start the .exe. If you connect everything you
should see and choose HID-compilant device from the “Select device” drop-down menu.
Page 11 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
2.7 Building the Linux image
Note that building the Linux image from scratch is a time-consuming task. Even with powerful
machine and fast internet connection it might take few hours compiling. Some Linux distributions
might lack the tools required to compile/build/execute scripts/download from repository – how to
get those is not discussed below.
The Linux image is created and downloaded from https://github.com/Freescale/fsl-community-bsp-
platform. For the test here we used Debian 6.0 with GNOME visual libraries. The steps we did:
1) From the terminal created folder “bin” in home folder:
user@dist$: mkdir bin
user@dist$: cd bin
Add bin directory to PATH in order to do the next steps easier. Else navigate to the right folders.
) Installed `repo` utility needed for the bitbake file fetching from the repository:
user@dist$: curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > ~/bin/repo
user@dist$: chmod a+x ~/bin/repo
Page 1 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
3) Created directory for the project and download the BSP source from the git repository:
user@dist$: mkdir fsl-community-bsp
user@dist$: cd fsl-community-bsp
~/fsl-community-bsp$: repo init -u https://github.com/Freescale/fsl-community-bsp-platform -b
denzil
~/fsl-community-bsp$: repo sync
4) You can change the settings for the build if you want at fsl-community-bsp/build/conf/local.conf.
I changed the “machine” name to “imx 33-olinuxino-maxi”.
For Linux kernel configurations and settings you can do (of course you can use also the default
settings):
~/fsl-community-bsp$:. ./setup-environment build
~/fsl-community-bsp/build$:bitbake linux-imx -c menuconfig
Check the image below:
5) Now to start building the image:
~fsl-community-bsp$:. ./setup-environment build
~fsl-community-bsp/build $: bitbake core-image-minimal
Note: on different Linux distributions you might have different tools installed and you will probably
need to install dependencies needed for the compile/build scripts. Here are some (but not all) of the
Page 13 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
mandatory ones: G++; diffstat; texi html; chrpath; gawk; texinfo; some git client.
To ensure you have the latest version supported with all the updates visit
https://github.com/OLIMEX/OLINUXINO and https://github.com/Freescale/fsl-community-bsp-
platform.
2.8 How to blink the LED
In this sub-chapter you will find a way to achieve the most basic task in electronics – the “Hello
World” of electronics – blinking the LED.
First we set the pin responsible for the LED as an output and we can set its value manually to high
or low position – make it blink manually. The LED mounted on the board uses GPIO65. You can
use external diode instead of the one mounted – you have to look at the table “The Linux
implementation of pins” in the hardware section to get the correct linux name for the GPIO pin.
echo out > /sys/class/gpio/gpio65/direction
echo 1 > /sys/class/gpio/gpio65/value
If you want to set the blink off you should change the value on the second line to:
echo 0 > /sys/class/gpio/gpio65/value
To show the info for all GPIOs:
ls /sys/class/gpio
To make it turn on – turn off automatically (e.g. blink) we use the text redactor VI to write the
Linux script:
echo out > /sys/class/gpio/gpio65/direction
while true
do
echo 1 > /sys/class/gpio/gpio65/value
sleep 1
echo 0 > /sys/class/gpio/gpio65/value
sleep 1
done
We save it as as “gpio” and we make it executable with
chmod + gpio
then we execut the script with:
Page 14 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
./gpio
The LED should start blinking with 0.5Hz.
2.9 How setup the I2 , SPI, UART
There are number of examples with our extension module board to achieve those connections on the
UEXT. The examples might be used as an example for I C, SPI or UART communication. You can
find them at our GitHub page:
https://github.com/OLIMEX/OLINUXINO/tree/master/SOFTWARE/iMX 33
NOTE that to use software I C you have to set the SMD jumpers to the proper side. By default the
board uses hardware I C.
2.10 How to setup Arch-Linux distribution
This is a step-by-step guide for building the Archlinux image for Olimex OLinuXino-MAXI. The
second and the third part of the document explain how to setup the internet connection on the board
and how to use the GCC compiler to compile „HelloWorld“ example on the OLinuXino.
Two important preparations:
1)You have to download the latest software package from the GitHub of iMX 33-OLinuXino,
down in the code you will meet “xxxxxxx” which you will have to replace with the correct
locations in the package.
)When trying I C examples I C jumpers has to be configured for hardware I C mode.
I. How to create SD-card with Archlinux image
1. Download the image files from: xxxxxxx . Put the files in desired folder, for example
/home/User/Archlinux.
. Insert the card-reader into the Linux host machine.
IMPORTANT NOTE – this example is given with "sdb1 and sdb " devices but it could enumerate
differently on your host, so confirm what it enumerates as before running fdisk!
3. Unmount the card-reader:
& sudo umounth /dev/sdb1
4. Format the SD-card using fdisk:
& sudo fdisk /dev/sdb
5. With the help of the menu create two partitions. The steps are the following:
5.1. Type “p” to view existing partitions on the SD-card
5. . Type “d” to delete all partitions
Page 15 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
5.3. Type “n” to create new one
5.4. Set “1” as partition number
5.5. Type “p” to select primary partition
5.6. Press Enter to select default beginning sector
5.7. Type “+32M” to create 3 MB partition
5.8. Type “t” to change partition type
5.9. Type “53”
5.10. Type “n” to create another partition
5.11. Set “2” as partition number
5.1 . Type “p” to set partition as primary
5.13. Press Enter to set default size of the partition
5.14. Type “w” to write partitions to the SD-card
6. Create the second partition with ext3 file system:
& sudo mkfs.ext3 /dev/sdb
7. Mount the second partition:
& sudo mount /dev/sdb /mnt/mmc
If you don't have mountpoint you should create one. Just type:
sudo mkdir /mnt/dir
8. Login as root for the next operations:
& sudo su
IMPORTANT NOTE: It is necessary to log-in as root, not as super-user!
9. Extract the downloaded tarball into the second partitions:
& tar -xzf /home/User/Archlinux/xxxxx.tar.gz
10. The next step is to to write the bootloader and kernel image to the first partition.
& dd if=/Archlinux/xxxxx.img of=/dev/sdb1 ibs=51 seek=4 conv=sync,notrunc
11. Unmount the SD-card, it should be ready for use.
& cd
& umount /dev/sdb
1 . Download the new kernel patch from: xxxxxxxxxxxxxxxxxxxx
13. Put the file in USB flash drive. Insert the flash drive into OLinuXino board.
& mount /dev/sdc1 /mnt/usb
& cp -fv /home/User/Downloads/<file> /mnt/usb
& umount /mnt/usb
Again this is example. You should correct this commands with your paths and corresponding
devices.
Page 16 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
IMPORTANT NOTE: The following commands are entered into OLinuXino terminal.
14. Mount the flash drive
& mount /dev/sdb1 /mnt/usb
15. Run pacman to update the kernel:
& pacman -S /mnt/usb/kernel 6-olinuxino- .6.35.3-6-arm.pkg.tar.xz
16. Follow the instructions. Just type “y” when promted.
17. Reboot
IMPORTANT NOTE: If you are connected to internet, you can use the following command:
& pacman -U http:// xxxxxxx .tar.xz.
Using this you can skip the part with the USB flash drive. Using the same command you could
download different packages:
& pacman -Sy <package name>
II. Set up the internet
This is a working example, but you might wish to read some additional information, if this
doesn't work for you.
With every reboot the device is assigned with different MAC address. To change this use
the commands:
& ip link set dev usb0 down
& ip link set dev usb0 address aa:bb:cc:dd:ee:ff
& ip link set dev usb0 up
To set an IP address enter:
& ifconfig usb0 19 .168.0. 49
or whatever address you want.
After that add default gateway:
route add default gw 19 .168.0.1 usb0
Finally you should add DNS-server. You should modify /etc/resolv.con with vi, or other
program. For example:
& vi /etc/resolv.conf
Press d several times to remove all lines. Press I to enter insert mode. Type:
& nameserver 19 .168.0.1
(Again this is example. You should add you DNS-server.)
After you finish entering this press Esc. This will set the program in command mode. In
command mode press:
Page 17 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
& :wq
This should do the work. To check connection use ping. If it doesn't check your
configuration again and router settings. You can use i con ig to see OLinuXino settings.
III. Using GCC to make Hello_World
In the home folder there are some examples
& cd /home/examples
& ls
And you should see all files and folders. You can create new folder (if you want) with the
command:
& mkdir <some dir>
To see our HelloWorld program go to /HelloWorld folder
& cd /home/examples/HelloWorld
& ls
In this folder are two files:
- hello
- hello_world.c
The C file is the sourse code. Actually this is text file with .c extention. Type vi or cat
hello_world.c to view the source. You could modify the source whatever you want. After
the source is ready to compile the file use:
& gcc -o hello_world.c hello
For more complicated compiling type:
& man gcc
To execute the program:
& ./hello <some name>
The result of the execution should be:
Hello <some name>.
In the other directory /home/i c are three examples for hardware I C. You could compile
them using the same command:
& gcc -o <file>.c <file>
After execution you could see the I C working using osciloscope connected to the
corresponding GPIOs.
You can see that the LED1 on the board is blinking. This is a backgrond shell process.
Again in the /home you can see a third folder led_blink. In this one there is a file
led_blink. Type:
& cat led_blink
You can see that this is shell script. To execute this script every time the linux is loaded the
Page 18 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
path should be added to the file rc.local.
& vi /etc/rc.local
Add the path to the script file:
/home/examples/led_blink/led_blink &
The "&" means that the script will be running in background.
2.11 How to use a USB WiFi dongle based on RealTek RTL8188 US and
RTL8192 U under AR H Linux
This procedure was done on the Olinuxino-Maxi. It was connected with a wired ethernet during the
procedure. Once the WiFi is functional, the wired ethernet can be removed. The microSD card can
then be moved to another Olinuxino board such as the Micro.
Log into the Olinuxino board.
upgrade the system:
pacman -Syu
Then install development tools
pacman -S base-devel
Delete empty directories:
rmdir /usr/lib/modules/ .6.35-6-ARCH+/build
rmdir /usr/lib/modules/ .6.35-6-ARCH+/source
Install kernel source:
pacman -S kernel 6-headers-olinuxino
Get the Realtek drivers from the Realtek web site:
http://www.realtek.com.tw/downloads/downloadsView.aspx?
Langid=1&PFid=48&Level=5&Conn=4&ProdID= 77&DownTypeID=3&GetDown=false&Downl
oads=true
I downloaded RTL8188CUS (the one showing up on lsusb)
If you choose RTL819 CU you get the same file
The file comes as a zip file:
RTL819xCU _USB_linux_v3.4.3_4369. 01 06 .zip
Page 19 of 59

OLIMEX© 015 IMX 33-OLinuXino-MAXI user's manual
Assume you downloaded it to your workstation.
Unzip the file.
Inside there is a folder called driver with a file inside called:
rtl8188C_819 C_usb_linux_v3.4.3_4369. 01 06 .tar.gz
Copy that file to the Olinuxino target:
scp rtl8188C_819 C_usb_linux_v3.4.3_4369. 01 06 .tar.gz root@ip_addr_of_Olinuxino:/root
log into Olinuxino
cd /root
mkdir driver
mv rtl8188C_819 C_usb_linux_v3.4.3_4369. 01 06 .tar.gz driver
cd driver
tar xzf rtl8188C_819 C_usb_linux_v3.4.3_4369. 01 06 .tar.gz
cd rtl8188C_819 C_usb_linux_v3.4.3_4369. 01 06
vi Makefile
Change the line:
CONFIG_PLATFORM_I386_PC = y
to
CONFIG_PLATFORM_I386_PC = n
Below it add the line:
CONFIG_PLATFORM_ARM_iMX 33 = y
find the block:
---------------------------------------------------------
ifeq ($(CONFIG_PLATFORM_ARM_PXA XX), y)
EXTRA_CFLAGS += -DCONFIG_LITTLE_ENDIAN
ARCH := arm
CROSS_COMPILE := arm-none-linux-gnueabi-
KVER := .6.34.1
KSRC ?= /usr/src/linux- .6.34.1
endif
---------------------------------------------------------
Below it adds the block:
---------------------------------------------------------
ifeq ($(CONFIG_PLATFORM_ARM_iMX 33), y)
EXTRA_CFLAGS += -DCONFIG_LITTLE_ENDIAN
Page 0 of 59