Colibri Windows CE BSP 
=======================


This is the README for the board support package for Toradex' Colibri
module, supporting Windows CE 5.0.  The actual versio supports the following
devices on the Colibri and the Colibri evaluation board:
 - FFUART and BTUART serial interfaces
 - IRDA serial interface
 - Ethernet controller
 - USB host controller (2x)
 - USB device controller
 - Audio device
 - Touch Screen
 - Display Driver (Customizable via Registry. Preset to Evalboard VGA)
 - PS2 Mouse / Keyboard
 - CF Card Slot (not for Colibri PXA290 V1.0)
 - SD/MMC Card Slot

For a List of BUG fixes and Improvements see the ChangeLog in the http://www.toradex.com/colibri_downlaods/WinCE/Images folder

NOTE: This BSP allows to build Platforms without Battery component dependencies since all hard Battery Dependencies have been removed form Display Power management code.

NOTE: This BSP also allows you to override some settings form the platform.xxx files in your project.xxx files. (Normally it's not possible becuase the platform.xxx files are merged after the project.xx files). This allows to easily setup more diplay settings in each other project using always the same BSP for example.


NOTE: You need Microsoft Platform Builder 5.0 in order to use the BSP.
Evaluation versions are available from microsoft:
http://msdn.microsoft.com/embedded/
Install it. Don't forget to select the ARMV4I and XScale Components!

The board support package (BSP) can be downloaded from
http://www.toradex.com/colibri_downloads/WinCE/BSP/Colibri_BSP_1.2.msi

This is a MSI installer file, just download and intall it (double click on it).
Then open Platfrom Builder and create a new platfrom (File->New Platform)
Select Colibri as the BSP

Once the BSP wizard is completed you can start adding the Colibri Specific Drivers from the Catalog (View->Catalog)
You'll find them under Catalog->Third Party->Colibri->Device Drivers
Add at least a Display Driver (unless your platform is headless) and PS2 Keyboard/Mouse to be able to interact with the system.
All other Drivers are optional.

NOTE: To build a standalone realease version disable the KITL (Platform->Settings, Build Options, Uncheck "Enable KITL")


Once your're finished configuring you can Build your IMAGE with BuildOS->Sysgen


Important NOTE: Before you begin testing your newly created IMAGE be sure you clear the Registry in Flash! Otherwise your newly
added features may not work since the Toradex standard IMAGE will be loaded from flash on Boot.



To download the IMAGE to the platform over ethernet with Platform Builder do the following:

Connect a null-modem cable to the lower colibri evalboard serial port (this will be needed to configure the bootloader so that
it downloads the IMAGE instead of booting the one on the FLASH)

Open a Terminal Program (9600-8-N-1)
Press and hold space while resetting the evalbaord (a boot menu should appear)
Select "d" to downlaod IMAGE

NOTE: the first time you'll have to configure Platform Builder to communicate with your Device (and only your device)
To do this go to Target->Connectivity Options
Set Download and Transport to Ethernet and Debugger to KdStub
Go to Download Settings Dialog
If the colibri is still sending out Bootme Messages (check on the terminal, if not go to download mode again as described
above) you should now see a colibrixxx device appearing in the list, select it and close all dialogs with OK

Now you're ready to downlaod your IMAGE!
Select Target->Attach Device
The download should start

If you want to store your custom IMAGE in Flash instead of RAM (don't do that with debug IMAGEs!) use the "f" command
instead of the "d" mentioned above.
You can also configure the bootloader to always download at startup instead of booting the IMAGE, so you don't have to press
space at each boot. Got to Bootloader Menu, press "x" then at the command promt type:
setconfig boot.dl=1
saveconfig boot

and reset the Colibri. Now the bootloader will always download at boot. To restore normal behavior type:
setconfig boot.dl=0
saveconfig boot


For more Platform Builder specific support we offer our Support Packages (take a
look on our WebShop). By Buying one of the Support Packages you'll also get
the Workspace file to build the exact IMAGE 1.2 NK.bin. This can be used as a
startpoint for custom modifications.


For a documentation on how the various drivers can be customized (LCD Settings, GPIO Assignments, ...) please read the Colibri
Customization Guide available in the Documentation Folder.


If you have any further questions, please send e-mail to colibri@toradex.com.

Have fun
Windows CE support team at Toradex