PACKAGE: xmos_uart.1v1

VERSION: 1v1 (build c9900acbc950f0056f37aabe39c17eaf2a165a35)

DESCRIPTION:

This package contains modules and example code for comminicating using
the UART serial protocol on Xcore.

REQUIRED TOOLS:

Xmos Desktop Development Tools 9.9.2 or above.

INCLUDED MODULES AND APPLICATIONS:

The following modules are provided in this package, these can be
used in your applications:

   module_uart:
      Simple UART with separate threads for TXD and RXD.

   module_uart_1thread:
      UART implemented in a single thread.

   module_xmos_common:
      Common build framework for applications using xmos modules.

In addition the follow example applications are provided:

   app_uart_example:
      Simple example of using a UART connection.

It transmits a short message, then loops all received characters back to the transmitter.

   app_uart_1thread_example:
      Simple example of using a single thread UART connection.

It transmits a short message, then loops all received characters back to the transmitter.
INSTALLATION (XDE):

To install, open the XDE Eclipse IDE and perform the following steps:

   * Select the "Import" item from the "File" menu
   * Select "General" -> "Existing Projects into Workspace" and click "Next"
   * Click on "Browse" next to "Select archive file" and select the
     xmos_uart.1v1.zip file.
   * Make sure the projects you want to import are ticked in the
     "Projects:" list. Import all the components and whichever
     applications you are interested in. 
   * Click on "Finish"

To build, select the application you wish to build in the Project
Explorer window and click on build icon. To run an application: select
the .xe file in the bin/ directory of that application project, right
click and select "Run As..."

INSTALLATION (COMMAND LINE):

To install, unzip the package zip. To build an application change into
that application directory and execute the command:

   xmake all

The generated executable will be placed in the bin/ sub-directory. To
run, execute the command:

   xrun bin/[binary file].xe