# XCORE SDK

###### tags: `xcore` `xmos`

### Upgrade CMake on Ubuntu 16.04
The default CMake version is 3.5.1 on Ubuntu 16.04.
CMake 3.21 above version is necessary for XCORE SDK.

pip install --upgrade cmake

### Install newer CMake on Ubuntu 20.04
Please refer to [Install cmake on Ubuntu](https://hackmd.io/@jw-sharing/BJLoYNd-j)

### Install package
* libusb-1.0

$ sudo apt-get install libusb-1.0-0-dev

* libtinfo.so.5

$ sudo apt install libtinfo5

* pkg-config (**if necessary**)

$ sudo apt install pkg-config

* libncurses.so.5 (**if necessary**)

$ sudo add-apt-repository universe
$ sudo apt-get install libncurses5 libncurses5:i386

### Installation

$ git clone --recurse-submodules https://github.com/xmos/xcore_sdk.git

$ cd xcore_sdk

$ cmake –B build_host
$ cd build_host
$ sudo make install

$ export PATH=$PATH:/opt/xmos/SDK/0.11.0/bin/

$ pip install -r tools/install/requirements.txt


/xcore_sdk$ pip install -r tools/install/requirements.txt
Requirement already satisfied: matplotlib in /home/julius/.local/lib/python3.8/site-packages (from -r tools/install/requirements.txt (line 1)) (3.6.0)
Requirement already satisfied: numpy in /home/julius/.local/lib/python3.8/site-packages (from -r tools/install/requirements.txt (line 2)) (1.23.3)
Requirement already satisfied: pillow>=6.2.0 in /usr/lib/python3/dist-packages (from matplotlib->-r tools/install/requirements.txt (line 1)) (7.0.0)
Requirement already satisfied: fonttools>=4.22.0 in /home/julius/.local/lib/python3.8/site-packages (from matplotlib->-r tools/install/requirements.txt (line 1)) (4.37.3)
Requirement already satisfied: python-dateutil>=2.7 in /home/julius/.local/lib/python3.8/site-packages (from matplotlib->-r tools/install/requirements.txt (line 1)) (2.8.2)
Requirement already satisfied: kiwisolver>=1.0.1 in /home/julius/.local/lib/python3.8/site-packages (from matplotlib->-r tools/install/requirements.txt (line 1)) (1.4.4)
Requirement already satisfied: pyparsing>=2.2.1 in /home/julius/.local/lib/python3.8/site-packages (from matplotlib->-r tools/install/requirements.txt (line 1)) (3.0.9)
Requirement already satisfied: cycler>=0.10 in /home/julius/.local/lib/python3.8/site-packages (from matplotlib->-r tools/install/requirements.txt (line 1)) (0.11.0)
Requirement already satisfied: packaging>=20.0 in /home/julius/.local/lib/python3.8/site-packages (from matplotlib->-r tools/install/requirements.txt (line 1)) (21.3)
Requirement already satisfied: contourpy>=1.0.1 in /home/julius/.local/lib/python3.8/site-packages (from matplotlib->-r tools/install/requirements.txt (line 1)) (1.0.5)
Requirement already satisfied: six>=1.5 in /usr/lib/python3/dist-packages (from python-dateutil>=2.7->matplotlib->-r tools/install/requirements.txt (line 1)) (1.14.0)


### Install pip (if necessary)

$ apt-get purge python3-pip
$ apt-get install -y python3-pip

$ python -m pip install --upgrade pip

### Build the firmware

$ cmake -B build -DCMAKE_TOOLCHAIN_FILE=xmos_cmake_toolchain/xs3a.cmake

$ cd build

$ make example_freertos_getting_started


### Run the firmware via XTAG4 (XGDB)

$ make run_example_freertos_getting_started

### Install XTC
https://www.xmos.ai/software-tools/

**Install XTC**

$ tar -xf Tools-15---Linux-64_15.1.4.tgz -C ~

$ cd ~/XMOS/XTC/15.1.4

$ source SetEnv

**Check XTC**

$ xcc --help

$ cat "$XMOS_TOOL_PATH"/doc/version.txt
15.1.4 (build: 454-77dc314)

$ xcc --version
xcc: Build 14-f1fa60c, Jan-13-2022
XTC version: 15.1.4
Copyright (C) XMOS Limited 2008-2021. All Rights Reserved.

### Connect XTAG4

$ cd ~/XMOS/XTC/15.1.4/scripts
$ sudo ./setup_xmos_devices.sh
$ ./check_xmos_devices.sh

**Check Target board**

$ xrun -l

Available XMOS Devices
----------------------

  ID	Name			Adapter ID	Devices
  --	----			----------	-------
  0 	XMOS XTAG-4         	RYBDMCC9	P[0]