--- INFORMATION ABOUT THE PACKAGE ---

NOTE: This is the compact version of the Olimex OpenOCD Development suite. This package does not contain a
full development environment ready to use to develop your applications but only the uniquie software compoments needed to create your IDE. Quick starters are advised to download the complete development suite that comes with a user friendly installer, the rest may at least have a look at the manuals section :)

*** Package Contents
 root
	/manuals		- manual for configuring the OpenOCD server (Eclipse, IAR, standalone mode)
	/examples		- some example projects gathered in a workspace
	/DRIVERS/		- drivers for supported JTAG adapters 
	/OpenOCD/		- the server executable and JTAG adapter configuration scripsts
	/OpenOCD/tcl/		- sample configuration scripts for different processors
	/README.txt		- this help file

*** Demo projects included in the package
 - LPC-2378_blink_FLASH - blinking LED demo, configured to run in FLASH
 - LPC-P212X_blink_FLASH - blinking LED demo, configured to run in FLASH
 - LPC-P212X_blink_RAM - blinking LED demo, configured to run in RAM
 - LPC-P2106_blink_FLASH - blinking LED demo, configured to run in FLASH
 - LPC-P2106_blink_RAM - blinking LED demo, configured to run in RAM
 - LPC-P2919_ram - LED sequence flashing demo, configured to run in RAM
 - SAM7-EX256_FLASH - USB to RS232 converter, configured to run in FLASH
 - SAM9-L9260_blink_RAM - blinking LED demo, configured to run in RAM
 - SAM9261-LCD_blink_RAM - blinking LED demo, configured to run in RAM
 - STM32-H107_blink_FLASH - blinking LED demo, configured to run in FLASH
 - STM32-H107_blink_RAM - blinking LED demo, configured to run in RAM
 - STM32-P103_blink_FLASH - blinking LED demo, configured to run in FLASH
 - STM32-P103_blink_RAM - blinking LED demo, configured to run in RAM
     
*** The package is compatible with the following products
 - ARM-USB-OCD
 - ARM-USB-OCD-H
 - ARM-USB-TINY
 - ARM-USB-TINY-H
 - ARM-JTAG-EW
  
*** Supported OS:
 - Windows XP x86, x64
 - Windows Vista x86, x64
 - Windows 7 x86, x64

*** Driver version
	version 1.2.2.0, http://sourceforge.net/projects/libusb-win32/files/
 
*** OpenOCD version
	version 0.4.0 http://openocd.berlios.de/web/

*** How to use ?
	First of all you have to install drivers for your device. Please use the instructions in the README.txt in the drivers folder.
	
	You then have 3 main configurations in order to use the OpenOCD server:
	
	1) Standalone mode
	2) Use an open source SDK consisting of Eclipse IDE and Yagarto tools
	3) Use of an commercial IDE that supports GNU Debugger (GDB), for example IAR Embedded Workbench 5.50
	
	*Note: Any other configuration that uses GDB may be used if reasonable and needed.
	
	Please read any relevant documents in the 'manuals' folder for further information. The included OpenOCD user's guide may also be a pretty helpful in some situations.
	
*** Troubleshooting
	- Driver installation issues are covered in the README.txt in the drivers folder.
	- OpenOCD configuration and runtime issues should be addresses in the OpenOCD user's manual and in the many online discussion boards including the OpenOCD official website.	

*** Information, updates and support:
	http://www.olimex.com/
	email: support@olimex.com
	
*** Last edit
	30 May 2011

Enjoy :)