eCos on xCORE
=============

.. appnote:: AN00112

.. version:: 1.0.1

Summary
-------

Running eCos RTOS on xCORE enables you to use your existing or any third party RTOS application stack on an xCORE. You can select from a wide range of XMOS IP libraries and add additional peripherals to suit your application needs and reduce time to market dramatically. 

This application note uses a ported version of eCos RTOS running on an xCORE and demonstrates a simple eCos application that context switches between two eCos threads.


Required tools and libraries
............................

* xTIMEcomposer Tools - Version 13.1.0

Required hardware
.................

This application note is designed to run on an XMOS xCORE General Purpose (L-series) device.

The example code provided with the application has been implemented and tested
on the xCORE L-series sliceKIT core board 1V2 (XP-SKC-L2) but there is no dependency on 
this board and it can be modified to run on any development board which uses an
xCORE General Purpose (L-series), xCORE-USB series or xCORE-Analog series device.

Prerequisites
.............

  - This document assumes familiarity with the XMOS xCORE architecture, the XMOS tool chain and the xC language. Documentation that is not specific to this application note is listed in the references appendix.

  - For descriptions of XMOS related terms found in this document please see the XMOS Glossary [#]_.

  - For information on eCos RTOS please see the eCos home page [#]_.

.. [#] http://www.xmos.com/published/glossary

.. [#] http://ecos.sourceware.org/

.. [#] This is an illustrative block diagram depicting eCos task communicating with other tasks; however the application example uses only the eCos task
