Neptune w800初学 Ubuntu下程序编译与烧写

文档中心

- 一、hb学习
- - 1.1一些基本概念
  - 1.2构建流程
  - 1.3目录说明
  - 1.4使用说明
- 二、Neptune w800开发版实操
- - 2.1 准备工作
  - - 2.1.1 示例工程下载
    - 2.1.2 编译
    - - 1. 编译工具链配置
      - 2. WiFIOT环境配置
      - 3. 安装编译工具hb
      - 4.编译
  - 2.2 烧写镜像
  - - 2.2.1 Ubuntu 烧写工具
    - 2.2.2 烧写过程

一、hb学习

1.1一些基本概念

在开发编译构建前，应了解如下基本概念：

组件
可复用的软件单元，它可包含源码、配置文件、资源文件和编译脚本等。
gn
Generate ninja的缩写，一种元构建系统，用于产生ninja文件。
ninja
ninja是一个专注于速度的小型构建系统。
hb工具

hb是HarmonyOS2.0里新增加的编译构建命令行工具。需要Python 3.7.4及以上版本的支持，建议安装3.8.x。源码在~/build\lite\hb这个目录下。

1.2构建流程

编译构建流程如图1所示，主要包括设置和编译两步：

在这里插入图片描述

hb set: 设置OpenHarmony源码目录和要编译的产品。
hb build: 编译产品、开发板或者组件。解决方案编译实现如下：
- 读取开发板配置：主要包括开发板使用的编译工具链、编译链接命令和选项等。
- 调用gn: 调用gn gen命令，读取产品配置(主要包括开发板、内核、选择的组件等)生成解决方案out目录和ninja文件。
- 调用ninja：调用ninja -C out/company/product启动编译。
- 系统镜像打包：将组件编译产物打包，制作文件系统镜像。

1.3目录说明

build/lite # 编译构建主目录├── components    # 组件描述文件。├── hb     # hb pip安装包源码。├── make_rootfs   # 文件系统制作脚本。├── config # 编译相关的配置项│   ├── component # 组件相关的模板定义。包括：静态库、动态库、扩展组件、模拟器库等│   ├── kernel    # 内核的编译配置参数│   └── subsystem # 子系统模板├── ndk    # Native API相关编译脚本与配置参数├── product# 产品全量配置表，包括：配置单元、子系统列表、编译器等。└── toolchain     # 编译工具链相关，包括：编译器路径、编译选项、链接选项等。

1.4使用说明

前提条件
- Linux服务器，Ubuntu16.04及以上64位系统版本。
- Python 3.7.4及以上。
- OpenHarmony源码build_lite仓下载成功。

安装hb

在源码根目录下执行：

python3 -m pip install --user build/lite

执行hb -h有相关帮助信息，有打印信息即表示安装成功：

usage: hbOHOS build systempositional arguments:  {build,set,env,clean}    build Build source code    set   OHOS build settings    env   Show OHOS build env    clean Clean outputoptional arguments:  -h, --help     show this help message and exit

卸载方法：
```
python3 -m pip uninstall ohos-build
```

编译命令

hb set

hb set -husage: hb set [-h] [-root [ROOT_PATH]] [-p]optional arguments:  -h, --help     Show this help message and exit.  -root [ROOT_PATH], --root_path [ROOT_PATH]   Set OHOS root path.  -p, --product  Set OHOS board and kernel.

hb set 后无参数，进入默认设置流程
hb set -root [ROOT_PATH] 直接设置代码根目录
hb set -p --product 设置要编译的产品

hb env
查看当前设置信息

hb env[OHOS INFO] root path: xxx[OHOS INFO] board: hispark_taurus[OHOS INFO] kernel: liteos[OHOS INFO] product: ipcamera[OHOS INFO] product path: xxx/vendor/hisilicon/ipcamera[OHOS INFO] device path: xxx/device/hisilicon/hispark_taurus/sdk_linux_4.19

hb build

hb build -husage: hb build [-h] [-b BUILD_TYPE] [-c COMPILER] [-t [TEST [TEST ...]]]  [--dmverity] [-p PRODUCT] [-f] [-n]  [component [component ...]]positional arguments:  component      Name of the component.optional arguments:  -h, --help     Show this help message and exit.  -b BUILD_TYPE, --build_type BUILD_TYPE   Release or debug version.  -c COMPILER, --compiler COMPILER   Specify compiler.  -t [TEST [TEST ...]], --test [TEST [TEST ...]]   Compile test suit.  --dmverity     Enable dmverity.  -p PRODUCT, --product PRODUCT   Build a specified product with   {product_name}@{company}, eg: ipcamera@hisilcon.  -f, --full     Full code compilation.  -T [TARGET [TARGET ...]], --target [TARGET [TARGET ...]]   Compile single target

hb build后无参数，会按照设置好的代码路径、产品进行编译，编译选项使用与之前保持一致。
hb build component：基于设置好的产品对应的单板、内核，单独编译组件（e.g.：hb build kv_store)。
hb build -p PRODUCT：免set编译产品，该命令可以跳过set步骤，直接编译产品。
在device/device_company/board下单独执行hb build会进入内核选择界面，选择完成后会根据当前路径的单板、选择的内核编译出仅包含内核、驱动的镜像。

hb clean
清除out目录对应产品的编译产物，仅剩下args.gn、build.log。清除指定路径可输入路径参数：hb clean xxx/out/xxx，否则将清除hb set的产品对应out路径
```
hb cleanusage: hb clean [-h] [out_path]positional arguments:  out_path    Clean a specified path.optional arguments:  -h, --help  Show this help message and exit.
```

二、Neptune w800开发版实操

环境：

Ubuntu 20.04 LTS

python 3.8

Neptune w800芯片（该芯片使用的是c-sky指令集，所以需要配置交叉编译环境。）

2.1 准备工作

2.1.1 示例工程下载

直接进入这个gitee的网址下载zip压缩包也可以（因为我用的是git，懒得再修改git配置文件）

git clone git@gitee.com:hihopeorg_group/neptune-harmony-os1.1-iot.git

2.1.2 编译

1. 编译工具链配置

工具包名：csky-elfabiv2-tools-x86_64-minilibc-xxxxx.tar.gz

下载地址：https://occ.t-head.cn/community/download

选择工具 - 工具链-800 Series 中相应的版本

在这里插入图片描述

下载完成后将工具包拷贝到相应的目录下，我的是：~/HarmonyOS_Tool

解压、配置环境变量

操作命令：(注意你的压缩包名字)

tar xzvf csky-elfabiv2-tools-x86_64-minilibc-20210423.tar.gz

在~/.bashrc文件添加（根据你的路径来）：

sudo gedit ~/.bashrc

export PATH=~/HarmonyOS_Tool/csky-elfabiv2-tools-x86_64-minilibc-20210423/bin:$PATH

刷新环境变量：

source ~/.bashrc

2. WiFIOT环境配置

安装python3.7以上，我这里使用ubuntu自带的python3.8

下载gn/ninja包

URL_PREFIX=https://repo.huaweicloud.com/harmonyos/compilerDOWNLOAD_DIR=~/Downloads  # 下载目录，可自行修改TOOLCHAIN_DIR=~/HarmonyOS_Tool/toolchain     # 工具链存放目录，可自行修改[ -e $DOWNLOAD_DIR ] || mkdir $DOWNLOAD_DIR[ -e $TOOLCHAIN_DIR ] || mkdir -p $TOOLCHAIN_DIRwget -P $DOWNLOAD_DIR $URL_PREFIX/gn/1523/linux/gn.1523.tarwget -P $DOWNLOAD_DIR $URL_PREFIX/ninja/1.9.0/linux/ninja.1.9.0.tar

解压gn/ninja/包：

tar -C $TOOLCHAIN_DIR/ -xvf $DOWNLOAD_DIR/gn.1523.tartar -C $TOOLCHAIN_DIR/ -xvf $DOWNLOAD_DIR/ninja.1.9.0.tar

在~/.bashrc文件添加添加环境变量（根据你的路径填写）：

export PATH=~/HarmonyOS_Tool/toolchain/gn:$PATHexport PATH=~/HarmonyOS_Tool/toolchain/ninja:$PATH

刷新环境变量：

source ~/.bashrc

我的~/HarmonyOS_Tool目录结构：

jaychou@jaychou-TM1705:~/HarmonyOS_Tool$ tree -L 2.├── csky-elfabiv2-tools-x86_64-minilibc-20210423│   ├── bin│   ├── csky-elfabiv2│   ├── include│   ├── lib│   ├── lib64│   ├── libexec│   ├── share│   └── x86_64-linux└── toolchain    ├── gn    └── ninja

3. 安装编译工具hb

下载源码后进入终端，进入源码根目录，执行：

python3 -m pip install --user build/lite

在~/.bashrc文件添加添加环境变量：

export PATH=~/.local/bin:$PATH

刷新：

source ~/.bashrc# 生效环境变量

至此，我添加的环境变量为：

# Harmonyexport PATH=~/HarmonyOS_Tool/csky-elfabiv2-tools-x86_64-minilibc-20210423/bin:$PATHexport PATH=~/HarmonyOS_Tool/toolchain/gn:$PATHexport PATH=~/HarmonyOS_Tool/toolchain/ninja:$PATHexport PATH=~/.local/bin:$PATH # Harmony

4.编译

安装完毕后，执行hb -h，确认安装成功

在这里插入图片描述

在源码根目录，执行:

hb set

1、设置源码目录，因我们在源码根目录下执行命令，所以直接输入“.”，表示当前目录

2、选择“wifiiot_neptune@winnermicro”

部分展示：

aychou@jaychou-TM1705:~/neptune-harmony-os1.1-iot-master$ hb set[OHOS INFO] Input code path: .OHOS Which product do you need?  wifiiot_neptune@winnermicrojaychou@jaychou-TM1705:~/neptune-harmony-os1.1-iot-master$ hb build -f -c gcc[OHOS INFO] Done. Made 76 targets from 61 files in 92ms-------省略-------------------------[OHOS INFO] wifiiot_neptune build successjaychou@jaychou-TM1705:~/neptune-harmony-os1.1-iot-master$

使用hb命令指定gcc编译（默认是clang，我没有配置clang，所以使用gcc），执行 hb build -f -c gcc ，等待编译直到出现“wifiiot_neptune build success”表示编译成功，否则根据提示处理。

编译完毕后会生成w800.img文件，路径：~/neptune-harmony-os1.1-iot/device/winnermicro/neptune/sdk_liteos/bin/w800

在这里插入图片描述

2.2 烧写镜像

2.2.1 Ubuntu 烧写工具

串口通信工具：minicom

sudo apt-get install minicom

安装Xmodem协议：（串口通信中广泛使用到的异步文件传输协议）

sudo apt-get install lrzsz

工具使用：

安装后输入：（-s是setup即建立连接）

sudo minicom -s

在这里插入图片描述

使用方向键选择 Serial port setup，按Enter键，进入设置环境，如下图

在这里插入图片描述

输入a或者A，设置串口设备，我这里是/dev/ttyUSB0（输入a，光标就移动到A那一行了，然后键盘输入修改就行了，修改完成后回车，光标就回到了最下面，载输入E就可以编辑对应的选项了）；
按图配置波特率；
Hardware Flow Control一定要关闭（No），不然看不到升级进度；
都配置完后，按下Enter键返回上一界面，选择 save setup as dfl（即将其保存位默认配置）;
选择Exit，关闭minicom。
再次输入命令 sudo minicom，虚拟机上断开重新连接串口，即可看到开发板串口有输出。

至此，开发板和ubuntu串口连通成功。

2.2.2 烧写过程

在ubuntu 终端按住ESC，主板按下RST键（要多按住一会儿），工具界面输出ccccc时，则进入了刷机模式，按 ctrl+a，再按z
按下s，选择Send files
选择 xmodem，选择路径，用上下箭头键选择目录，双击空格键进入目录，找到w800.img文件

在这里插入图片描述

空格选中，左右方向键选择 [Okay] 按下回车即可，我这里编译出来的w800.img是581k，等待烧写完毕即可。

在这里插入图片描述

烧写成功后，工具界面依然出现ccccc，这时按下RST键，系统启动。

Neptune w800初学 Ubuntu下程序编译与烧写

一、hb学习

1.1一些基本概念

1.2构建流程

1.3目录说明

1.4使用说明

二、Neptune w800开发版实操

2.1 准备工作

2.1.1 示例工程下载

2.1.2 编译

1. 编译工具链配置

2. WiFIOT环境配置

3. 安装编译工具hb

4.编译

2.2 烧写镜像

2.2.1 Ubuntu 烧写工具

2.2.2 烧写过程

公告

标签

Neptune w800初学 Ubuntu下程序编译与烧写

一、hb学习

1.1一些基本概念

1.2构建流程

1.3目录说明

1.4使用说明

二、Neptune w800开发版实操

2.1 准备工作

2.1.1 示例工程下载

2.1.2 编译

1. 编译工具链配置

2. WiFIOT环境配置

3. 安装编译工具hb

4.编译

2.2 烧写镜像

2.2.1 Ubuntu 烧写工具

2.2.2 烧写过程

相关问题

公告

标签