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
Windows:
$ pip3 install -U west
备注
以上方式会将 west 直接安装到系统 Python 环境中。如果希望将 west 及后续安装的 Python 依赖与系统环境隔离,可以参考 获取 Zephyr 并安装 Python 依赖 中基于虚拟环境的安装步骤。
下载 Ameba NUWA Project SDK
克隆清单仓库:
mkdir nuwa && cd nuwa west init -m https://github.com/Ameba-AIoT/nuwa.git
备注
上面命令中使用 https 协议的 url 下载,不需要在 github 添加公钥。如果后续需要提交代码,需要添加公钥并切换到 ssh 协议的 url。
执行以下命令,即可下载并同步清单文件定义的全部项目仓库:
west update创建指向
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