快速入门

软件要求

• CMake（最低版本 3.21）
• Git（最低版本 2.25）
• XTC 工具（最低版本 15.2.1）

设置

注意： 目前 XCommon CMake 还未与 XMOS XTC 工具一起发布（正确的版本为 15.2.1）。一旦集成，这一步骤可以省略。

在使用 XCommon CMake 前，需要设置环境变量 XMOS_CMAKE_PATH，指向 xcommon_cmake 目录的位置。例如：

# MacOS 和 Linux
export XMOS_CMAKE_PATH=/home/user/xcommon_cmake

# Windows
set XMOS_CMAKE_PATH=C:\Users\user\xcommon_cmake

HelloWorld 示例

此示例展示了一个简单的“Hello world”应用程序，用于演示使用 XCommon CMake 的最小项目。创建以下文件结构，内容如下：

app_hello_world/
├── CMakeLists.txt
└── src
    └── main.c

app_hello_world/CMakeLists.txt

cmake_minimum_required(VERSION 3.21)
include($ENV{XMOS_CMAKE_PATH}/xcommon.cmake)
project(hello_world)

set(APP_HW_TARGET XCORE-AI-EXPLORER)

XMOS_REGISTER_APP()

app_hello_world/src/main.c

#include<stdio.h>

int main(){
    printf("Hello world!\n");
    return 0;
}

构建可执行文件并使用模拟器运行：

cmake -G "Unix Makefiles" -B build
cd build
xmake
cd ..
xsim bin/hello_world.xe

显示消息：“Hello world!”。

注意： xmake 是一个为方便使用而随 XMOS XTC 工具提供的 GNU Make 的构建版本。

注意： xsim 提供了一个接近周期精确的 xcore 设备系统模型，这个模型随 XMOS XTC 工具提供。