SDK 下载

概述

Realtek Ameba-IoT 系列产品的 Zephyr SDK 采用多仓库管理方式,清单仓库(manifest)托管于 GitHub:https://github.com/Ameba-AIoT/nuwa

SDK 由多个 Git 仓库组成,通过 west 工具进行统一管理;清单仓库里的 west.yml 文件记录了每一个子仓库对应的提交版本。

安装 west 工具

要使用此仓库,必须先安装 west 工具。west 是用 Python 3 编写的,并通过 PyPI 分发。请使用 pip3 来安装或升级 west:

Linux:
$ pip3 install --user -U west

备注

以上方式会将 west 直接安装到系统 Python 环境中。如果希望将 west 及后续安装的 Python 依赖与系统环境隔离,可以参考 获取 Zephyr 并安装 Python 依赖 中基于虚拟环境的安装步骤。

下载 Ameba NUWA Project SDK

  1. 克隆清单仓库:

    mkdir nuwa && cd nuwa
    west init -m https://github.com/Ameba-AIoT/nuwa.git
    

备注

上面命令中使用 https 协议的 url 下载,不需要在 github 添加公钥。如果后续需要提交代码,需要添加公钥并切换到 ssh 协议的 url。

  1. 执行以下命令,即可下载并同步清单文件定义的全部项目仓库:

    west update
    
  2. 创建指向 nuwa.py 的快捷方式。该 Python 脚本封装了 west 命令,关于 west 命令的更多信息,可以参考 Zephyr 官方文档:West (Zephyr’s meta-tool)

    ln -sf tools/meta_tools/nuwa.py nuwa.py
    

备注

west update 只更新 west.yml 中列出的项目,而不会更新 west.yml 所在的清单仓库,如果希望全部更新,可以使用以下两种方法:

  • 进入清单仓库执行 git 操作进行更新,然后执行 west update 读取新版本的 west.yml 文件并以此来更新所有其他项目。

  • 使用封装命令 ./nuwa.py update