eCos User Guide eCos User Guide Copyright © 2001, 2002, 2003, 2004, 2009 Free Software Foundation, Inc. Documentation licensing terms This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). Distribution of the work or derivative of the work in any standard (paper) book form is prohibited unless prior permission is obtained from the copyright holder. Trademarks Altera® and Excalibur™ are trademarks of Altera Corporation. AMD® is a registered trademark of Advanced Micro Devices, Inc. ARM®, StrongARM®, Thumb®, ARM7™, ARM9™ is a registered trademark of Advanced RISC Machines, Ltd. Cirrus Logic® and Maverick™ are registered trademarks of Cirrus Logic, Inc. Cogent™ is a trademark of Cogent Computer Systems, Inc. Compaq® is a registered trademark of the Compaq Computer Corporation. Fujitsu® is a registered trademark of Fujitsu Limited. IBM®, and PowerPC™ are trademarks of International Business Machines Corporation. IDT® is a registered trademark of Integrated Device Technology Inc. Intel®, i386™, Pentium®, StrataFlash® and XScale™ are trademarks of Intel Corporation. Intrinsyc® and Cerf™ are trademarks of Intrinsyc Software, Inc. Linux® is a registered trademark of Linus Torvalds. Matsushita™ and Panasonic® are trademarks of the Matsushita Electric Industrial Corporation. Microsoft®, Windows®, Windows NT® and Windows XP® are registered trademarks of Microsoft Corporation, Inc. MIPS®, MIPS32™ MIPS64™, 4K™, 5K™ Atlas™ and Malta™ are trademarks of MIPS Technologies, Inc. Motorola®, ColdFire® is a trademark of Motorola, Inc. NEC® V800™, V850™, V850/SA1™, V850/SB1™, VR4300™, and VRC4375™ are trademarks of NEC Corporation. PMC-Sierra® RM7000™ and Ocelot™ are trademarks of PMC-Sierra Incorporated. Red Hat, eCos™, RedBoot™, GNUPro®, and Insight™ are trademarks of Red Hat, Inc. Samsung® and CalmRISC™ are trademarks or registered trademarks of Samsung, Inc. Sharp® is a registered trademark of Sharp Electronics Corp. SPARC® is a registered trademark of SPARC International, Inc., and is used under license by Sun Microsystems, Inc. Sun Microsystems® and Solaris® are registered trademarks of Sun Microsystems, Inc. SuperH™ and Renesas™ are trademarks owned by Renesas Technology Corp. Texas Instruments®, OMAP™ and Innovator™ are trademarks of Texas Instruments Incorporated. Toshiba® is a registered trademark of the Toshiba Corporation. UNIX® is a registered trademark of The Open Group. All other brand and product names, trademarks, and copyrights are the property of their respective owners. Table of Contents I. Introduction ................................................................................................................................................ xiii 1. Key Features.......................................................................................................................................... 1 2. eCos Overview ...................................................................................................................................... 3 3. eCos Licence Overview ........................................................................................................................ 5 Questions and answers .................................................................................................................... 5 Previous License.............................................................................................................................. 6 4. Notation and Conventions..................................................................................................................... 7 GDB and GCC Command Notation................................................................................................ 7 Directory and File System Conventions.......................................................................................... 7 Version Conventions........................................................................................................................ 7 5. Documentation Roadmap...................................................................................................................... 9 II. Installing eCos............................................................................................................................................ 11 6. System Requirements.......................................................................................................................... 13 7. Installation on Linux ........................................................................................................................... 15 8. Installation on Windows...................................................................................................................... 17 9. Target Setup......................................................................................................................................... 19 Connecting Via Serial Line ........................................................................................................... 19 Connecting Via Ethernet................................................................................................................ 19 Using A Simulator Target.............................................................................................................. 19 Using A Synthetic Target .............................................................................................................. 20 III. Programming With eCos......................................................................................................................... 21 10. Programming With eCos................................................................................................................... 23 The Development Process ............................................................................................................. 23 eCos Configuration .............................................................................................................. 23 Integrity check of the eCos configuration............................................................................ 23 Application Development - Target Neutral Part .................................................................. 23 Application Development - Target Specific Part.................................................................. 24 11. Configuring and Building eCos from Source.................................................................................... 25 eCos Start-up Configurations ........................................................................................................ 25 Configuration Tool on Windows and Linux Quick Start............................................................... 26 Ecosconfig on Windows and Linux Quick Start............................................................................ 29 Selecting a Target................................................................................................................. 31 12. Running an eCos Test Case............................................................................................................... 33 Using the Configuration Tool ........................................................................................................ 33 Using the command line................................................................................................................ 34 Testing Filters ................................................................................................................................ 36 13. Building and Running Sample Applications..................................................................................... 37 eCos Hello World .......................................................................................................................... 37 eCos hello world program listing......................................................................................... 37 A Sample Program with Two Threads .......................................................................................... 38 eCos two-threaded program listing...................................................................................... 38 14. More Features — Clocks and Alarm Handlers................................................................................. 41 A Sample Program with Alarms.................................................................................................... 41 iii IV. The eCos Configuration Tool................................................................................................................... 45 15. Getting Started .................................................................................................................................. 47 Introduction ................................................................................................................................... 47 Invoking the eCos Configuration Tool........................................................................................... 47 On Linux .............................................................................................................................. 47 On Windows......................................................................................................................... 47 The Component Repository..........................................................................................................