XTC安装指南

下载XTC工具

XTC工具和相关驱动程序以单个平台特定的可下载文件的形式提供。默认情况下，可以从以下位置获取该文件，您需要根据自己的操作系统下载对应的XTC工具：

https://www.xmos.ai/software-tools

在某些情况下，可能会指示您从其他位置下载特定版本的工具。

安装XTC工具

要在您的 PC 上安装XTC工具，请按照以下步骤操作：

Linux

将存档解压缩到您选择的安装目录。下面的示例将安装到您的主目录：

tar -xf archive.tgz -C ~

在此示例中，工具将安装到 ~/XMOS/XTC/*version*。此位置将被称为您的工具安装位置。

Windows

运行安装程序。当询问是否允许安装程序对您的计算机进行更改时，单击“是”。

安装程序的图形界面将指导您完成安装。对于默认安装，只需在每个页面上单击“下一步”，然后单击“安装”。

建议：安装一个“bash”命令行环境和常用的Linux工具。这是推荐的，因为为了简洁起见，本文档提供的所有示例都假定使用了bash环境。

在Windows机器上安装一个基本的bash环境的一种方法是安装Git for Windows。按照标准的安装说明进行操作，当被询问时，做出如下选择：

Mac OSX

• 双击下载的安装程序打开它，然后将“X”图标拖到应用程序文件夹中。

• 删除安装程序。

检查您的安装

安装后，请按照 配置命令行环境 中的说明进行检查。

配置 XTAG USB 驱动程序

工具通过 XTAG 适配器通过 USB 与开发板进行接口。大多数开发板需要外部 XTAG 适配器，该适配器通过 XSYS 或 XSYS2 连接器连接到开发板。一些开发板包括集成的 XTAG 适配器。

与 xCORE 开发板一起使用的 XTAG 适配器配置

Linux

Linux下的XTAG驱动程序在正常的安装过程中会自动安装。但是，为了让所有用户都能使用它们，还需要一个需要root权限的额外步骤。这个步骤可能只需要在一台开发机上执行一次，或者当XMOS发布新的XTAG设备时执行一次。

您需要切换到你的XTC工具安装目录下的scripts文件夹（通常是XMOS/XTC/xx.x.x/scripts），然后运行以下脚本：

sudo ./setup_xmos_devices.sh

重新连接任何当前连接的XTAG设备，以使更改生效。

要检查XTAG设备是否可用并且可以访问，请在同一个目录下运行以下脚本：

./check_xmos_devices.sh

如上面的所示命令，这个脚本应该以普通用户身份运行，而不是root。

如果可以访问，脚本应当会打印出当前连接的XTAG信息。

Windows

XTAG驱动程序由XTC工具安装程序安装。在安装完成后，你需要插入XTAG，以加载驱动程序。

部分情况下，由于XTAG驱动以服务的形式保留在Windows后台，您需要重启电脑或进入服务中以加载驱动。

Mac OSX

OS X系统提供了原生的XTAG USB驱动程序支持。

在虚拟机中使用XTAG

如果你在虚拟机中使用XTC工具，你需要将主机上的XTAG调试器透传到虚拟机，然后您应当根据您在虚拟机中安装的操作系统，执行与之前说明相同的XTAG驱动安装步骤。请注意，XTAG驱动在预安装的系统中已经提供。

VirtualBox

在Oracle VM VirtualBox Manager中所需的USB设置如下所示：

将您的USB过滤器细节“添加”或“编辑”为如下所示。请确保“产品ID”字段为空。这一点很重要。

VMware

将XTAG连接到电脑后，VMware Workstation Pro会弹出如下提示，选择连接到虚拟机：

WSL2

由于WSL2并没有原生的USB支持，为了在WSL2中使用XTAG，您需要借助开源项目 usbipd-win。我们提供了以下简单的安装说明：

1. 首先，在Windows下载并安装 WSL-usb-gui，它是usbipd-win的图形化版本，usbipd-win的项目信息可以在这里找到。

2. 完成安装后，您需要打开该软件（您应当可以在"开始"菜单中找到它），并安装相关依赖。

3. 在WSL2中安装 USB/IP client tools

   sudo apt install linux-tools-virtual hwdata
   sudo update-alternatives --install /usr/local/bin/usbip usbip `ls /usr/lib/linux-tools/*/usbip | tail -n1` 20

   如果你使用了我们提供的预构建系统，可以跳过此步。

4. 重启电脑，以启动WSL USB的服务

5. 打开WSL USB，

   • 当您使用XTAG3时：

     1. 由于XTAG3需要通过xgdb初始化上电，您需要在**Windows版本的XTC工具中**，运行xrun -l

        提示

        

        安装Windows XTC后，会自动生成一个XTC Tools 15.x.x Command Prompt快捷方式

     2. 在WSL USB中，选中XMOS XTAG3，点击Attach↓，即可将XTAG3附加至WSL2中。

   • 当您使用XMOS XTAG-4时：

     1. 在WSL USB中，选中XMOS XTAG4

     2. 点击 Auto-Attach Device，并在弹出的窗口中选中Device，即可在XTAG4连接时，将设备自动透传至WSL2

检查能否访问 XTAG

在操作前，请配置环境. 如果需要，请通过XTAG适配器将开发板连接到主机。确保开发板有电源。

使用xrun -l 命令列出可用于调试的设备。第一次执行此命令时，可能需要几秒钟才能下载XTAG固件。预期的结果示例为：

$ xrun -l

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

  ID    Name                    Adapter ID      Devices
  --    ----                    ----------      -------
  0     XMOS XTAG-3             NJ2L2H4T        P[0]

如果 Devices 列显示 None，则表示XTAG本身无法访问开发板。请检查开发板是否有电源，并且XSYS/XSYS2连接是否牢固。