Getting started with XMOS development tools

You can develop code and deploy applications to your SOMANET device using XMOS xTIMEcomposer and XMOS Command Line Tools. This article will help you setting the XMOS tools on your machine.

TODO: Add Windows and Mac tutorials

Installing Java SE Runtime Environment

Before starting to set up xTIMEcomposer, make sure you have a JRE version 1.5 or later installed. In case you don’t, follow the instructions described for your platform at the Java installation guide.

Note

Installing OpenJDK is a also a option for Linux users. It can be installed by typing on a command line:

$ sudo apt-get install openjdk-8-jre

Installing XMOS xTIMEcomposer

  1. Download the latest xTIMEcomposer version compatible with your operative system here.
  2. Follow the installation instructions available at xTIMEcomposer User Guide.

Note

To set the right environment variables at startup, put in your .bashrc file inside your home directory:

source /path/to/your/XMOS/installation/SetEnv

Additonally you have to change the XMOS_TOOL_PATH in your SetEnv file residing in xTIMEcomposer install directory:

export XMOS_TOOL_PATH=/path/to/your/XMOS/installation/
  1. Start xTIMEcomposer by executing the following command:

    $ xtimecomposer
    

Important

Linux users, additionally, will need to enable USB drivers to get their XTAG recognized. Just follow these instructions:

Create a file: /etc/udev/rules.d/99-xmos.rules with the following contents:

SUBSYSTEM!="usb|usb_device", GOTO="xmos_rules_end"
ACTION!="add", GOTO="xmos_rules_end"
# 20b1:f7d1 for xmos xtag2
ATTRS{idVendor}=="20b1", ATTRS{idProduct}=="f7d1", MODE="0666", SYMLINK+="xtag2-%n"
# 20b1:f7d4 for xmos xtag3
ATTRS{idVendor}=="20b1", ATTRS{idProduct}=="f7d4", MODE="0666", SYMLINK+="xtag3-%n"
# 0403:6010 for XC-1 with FTDI dual-uart chip
ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6010", MODE="0666", SYMLINK+="xc1-%n"
LABEL="xmos_rules_end"

Enter the following command:

$ service udev reload

Unplug and re-plug the USB cable. This allows udev to recognise the device with the new rules.

Important

On Ubuntu 16.04 or later xTIMEcomposer has problems rendering characters correctly. To fix this problem edit the “xtimecomposer” file in the “bin/” directory inside xTIMEcomposer installation directory by commenting out the following line (arround line 144): “$ENV{LD_LIBRARY_PATH} = “$installpath/xtimecomposer_bin/swtbrowserlibs:$ENV{LD_LIBRARY_PATH}”;” with a hash “#”. Now try starting xtimecomposer again.

Congratulations! At this point you are ready to start using your XMOS development tools.

See also

In the xTIMEcomposer User Guide you will find information about how to start xTIMEcomposer Studio and the Command-Line Tools.