Contents

Getting Started with eCos ™ 1

Copying terms 2

Trademarks 2

Foreword 7

Documentation Roadmap 11

Getting Started with eCos 11

eCos User's Guide 11

eCos Reference Manual 12

Part I: Release Notes 13

Notation and Conventions 14

GDB and GCC Command Notation 14

Directory and File System Conventions 14

Overview of the Release 16

Hardware Abstraction 16

Embedded Kernel 17

Configurability 17

µ ITRON and Other Operating Systems 18

ISO C Library 18

Serial Device Drivers 19

ROM Monitor Image 19

Tests and Examples 19

GNU Tools and their Documentation 20

eCos Documentation 20

Package Contents 21

eCos Net Release 21

eCos Developers' Kit 21

System Requirements 23

Required 23

Recommended 24

Reporting Problems 25

How to Report Problems 25

Part II: Installation Guide 29

Software Installation 30

Software Installation on Windows 30

Software Installation on UNIX 31

Target Setup 34

Connecting To A Target Via Serial 34

Connecting To A Target Via Ethernet 35

Connecting To A Simulator Target 35

Connecting To A Synthetic Target 36

MN10300 stdeval1 Hardware Setup 36

MN10300 Architectural Simulator Setup 36

AM33 STB Hardware Setup 37

i386/Linux Synthetic Target Setup 39

Running Applications on the Target 41

Part III: Programming Tutorial 43

Programming with eCos 44

Configuring and Building eCos from Source 47

eCos Start-up Configurations 47

Using the Configuration Tool on Windows 48

Using ecosconfig on UNIX 54

Architectural Notes 59

Test Suites 60

Using the Configuration Tool 61

Using the command line 61

Testing Filters 62

Building and Running Sample Applications 63

eCos Hello World 63

A Sample Program with Two Threads 64

More Features -- Clocks and Alarm Handlers 68

A Sample Program with Alarms 68

Appendixes 73

Appendix 1: Real-time characterization 74

Sample numbers: 74

Appendix 2: eCos Licensing 77

RED HAT ECOS PUBLIC LICENSE
Version 1.1 77

Appendix 3: The eCos Copyright Assignment Form, Revision 1.1 84

Index 90