学习本文后,你将可以:
选择你正在使用的操作系统。
支持 Ubuntu 18.04 LTS 及更新的版本。
通常,为了保证软件源的时效性,推荐你在进入下一步之前先执行以下命令
sudo apt update
sudo apt upgrade
支持 Windows 10 及以上。若你的 Windows 版本未能满足要求,可参考 Windows 客户端升级路径 进行升级。
支持 macOS Yosemite (10.10) 版本及以上。若你的 macOS 版本未能满足要求,请参考 Apple 支持的此文章 进行升级。
选择你正在使用的操作系统。
使用 apt
安装必要的依赖:
sudo apt install --no-install-recommends git wget
请在终端运行以下命令确定是否已经安装开发者工具:
xcode-select --install
接着,安装 lisa zep 工具,并初始化 CSK6 SDK 所需的开发环境。
对于Ubuntu平台的开发者,你可以选用以下方式之一进行搭建:
方式1、通过脚本在线安装
在 用户权限 下执行:
curl -o- https://cdn.iflyos.cn/public/cskTools/lisa-zephyr-install.sh | bash
wget -qO- https://cdn.iflyos.cn/public/cskTools/lisa-zephyr-install.sh | bash
该命令会在
~/.listenai
目录下,安装 CSK6 的集成开发环境以及 CSK SDK 的拉取,执行完毕后开发者能快速进行 CSK6 的应用开发。
方式2、通过离线安装包
下载Ubuntu 离线安装包,建议使用 Ubuntu 18.04 版本及以上。
解压后执行:
./install.sh
方式3、在Linux下docker环境中安装csk6集成环境
我们基于Linux下的docker环境提供了csk6的容器化编译环境。
操作步骤:
docker pull listenai/csk6
启动docker csk6集成开发环境:
docker run --privileged -v /dev:/dev -v /run/udev:/run/udev -it listenaiofficial/csk6:版本tag bash
下载 CSK6一键安装包 并运行,根据安装引导进行安装。
CSK6一键安装包 是面向 Windows 操作系统的 CSK6 开发环境集成安装包,本安装包会完成CSK6开发环境搭建、SDK部署等一系列操作,方便您快速拥有一个可以即刻进入业务开发阶段的环境。
TIP
1.windows 下安装CSK6开发环境可能会遇到杀毒软件阻止的情况,可尝试通过以下FAQ指引解决:
csk6一键安装包-时被杀毒软件阻止的解决方案。2.如果在安装过程中弹出此错误,请尝试重启电脑并再次执行安装程序。
在 用户权限 下执行:
curl -o- https://cdn.iflyos.cn/public/cskTools/lisa-zephyr-install.sh | bash
wget -qO- https://cdn.iflyos.cn/public/cskTools/lisa-zephyr-install.sh | bash
该命令会在
~/.listenai
目录下,安装 CSK6 的集成开发环境以及 以及完成 CSK6 SDK 的拉取,执行完毕后开发者即可开始进行 CSK6 的应用开发。
完成环境的安装后,打开终端,执行你的第一个lisa命令,检查当前开发环境吧~
lisa info zep
该指令将输出当前开发环境的安装情况,如图:
lisa info zep
指令用于查看当前 Zephyr 的环境。在后续的开发上,该命令也可作为环境自检的一个方式。若在环境检测过中存在工具缺失的情况,请参照安装过程疑难解答进行解决或查阅环境搭建常见问题。
选择一个目录用于存放我们即将创建的项目,在这个目录下执行以下命令
警告
不支持一个带有空格的路径中构建 Zephyr 或创建应用。因此形如C:\Users\YourName\app
的路径可用,但C:\Users\Your Name\app
则不可用。
lisa zep create
该命令会列出当前 CSK6 适配的项目 sample ,我们可选择任意一个作为我们的工程模板,创建在当前目录中。此处我们选择 [hello_world]
进行创建。
在命令行中进入刚创建的 hello_world 项目目录,执行编译命令。
cd hello_world
lisa zep build -b csk6011a_nano
当您需要重新编译所有链接(如更换版型)时,可选择Rebuild整个项目工程,可在上述编译命令> 中增加 -p 参数,即
lisa zep build -b csk6011a_nano -p
更多编译参数的使用,详见 命令行工具-编译。
以使用 CSK6011-NanoKit 开发板 为例,使用 Type-C 数据线连接开发板的 DAPLINK USB 。
执行以下指令:
$ lisa zep flash
若烧录成功你将看到
通过串口调试工具找到开发板对应的串口,以 115200 的波特率进行连接(在下图示例中使用 screen
工具连接串口)。对开发板复位后,可看到串口输出:
如果你需要了解关于可用开发板的更多说明,可参考 NanoKit 开发套件。
这里提供一些进阶的建议,帮助你了解更多如何在 CSK6 上进行开发:
尝试其他的使用示例
学习有关 应用开发 和 学习有关 lisa zep 工具使用
这里包含一些关于与安装过程相关的问题如何解决的议题。
当需要检查 SDK 环境是否有问题时,通常先执行以下命令
lisa info zep
正常情况下你将看到列出结果类似下图
当 SDK 环境 不完整 时,可能会出现某些项显示为「未设置」,例如
../开发实践/images/start_1.png)
若遇到类似上图中显示的「未设置」的提示,请运行下述命令,工具会尝试修复当前 SDK 环境
lisa zep doctor
你可以在聆思维护的代码仓库托管站点 LSCloud 中反馈你所遇到的问题或提交特性适配请求。
注意
在你提交一个新工单之前,请先尝试在已有的工单中搜索你的问题。你的问题可能在此之前已经有对应的答案了。
当你新建工单时,应当按照模板要求填写对应描述。并且,当你进行描述时请尽量注意,不要只是含糊地说例如「这个跑不起来」或者询问「这个功能能不能用?」之类的问题。你应当尽可能描述这些内容:
反馈问题时,请对文本信息进行 复制/粘贴 ,而不是对它拍照或截图。这里的文本信息指代用于描述问题的源代码、终端命令或他们的输出。
这样做可以使得帮我们在尝试帮你解决问题时更容易看清楚问题,也更便于其他的用户搜索到相关的内容。