RuffOS 移植指南

Ruff，作为一个可移植的操作系统，本身是可以运行在不同的硬件上，硬件开发者可以将预编译好的 RuffOS 移植到自己的硬件上。

前提条件

  • 请确认你的硬件所用的工具链能够有对应版本的 RuffOS
  • 请确保你的硬件能够正常联网

第一步：下载和配置 Ruff SDK

  1. 下载 Ruff SDK 并解压
  2. 参考 SDK 安装 配置 SDK。

第二步：下载并安装 RuffOS

  • 在Ruff 下载页面 页面，根据你的硬件和所用的工具链，选择对应版本的 RuffOS。

  • 将下载的 RuffOS 传送到目标板上，比如，如果你的系统支持 SSH，可以通过如下命令：

    scp /path/to/ruffos-<target>-<version>.zip your_pi_user@your_pi_ip:/tmp

  • 登录到目标板上

    ssh your_user@your_board_ip

  • 解压并运行 RuffOS

    cd /tmp/
    unzip ruffos-<target>-<version>.zip
    cd ruffos-<target>-<version>
    ./run.sh

  • 验证 RuffOS 已正常启动。在你的PC上运行如下命令：

    rap system info <hostip>

    如果你看到有相应的 RuffOS 信息，则证明 RuffOS 已经正常启动。

第三步：定义板卡

板卡信息，描述了硬件板卡上存在哪些资源和外设，是 Ruff 应用运行的基础。

如果你的板卡信息已经添加到软件仓库，则可以跳过此步。

访问板卡起步走，了解添加板卡的详细过程。

第四步：创建项目

  • 新建项目文件夹（如 hello-ruff），进入文件夹后，使用 rap 初始化应用。（请尽量避免在 SDK 目录中新建项目）

    mkdir hello-ruff
    cd hello-ruff

    rap init --local-board /path/to/your_board_project

    这里需要指定目标板为你的板卡信息，以便参数能够正确的识别。

  • 根据提示，填写相应内容（可全部使用默认值），rap 会初始化项目并下载开发板的配置信息，生成默认的硬件配置文件。

第五步：起步走

参照起步走，编写你的 Ruff 应用，开启 Ruff 之旅吧！