Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 eb190501 编写于 作者: D duangavin123
浏览文件
操作

更新快速入门 

Signed-off-by: Nduangavin123 <duanxichao@huawei.com>
上级 28dcf451
显示空白变更内容
内联 并排
Showing with 1418 addition and 760 deletion
zh-cn/device-dev/driver/driver-peripherals-light-des.md
浏览文件 @ eb190501
......@@ -5,7 +5,7 @@
### 功能简介
​ Light驱动模型为上层Light硬件服务层提供稳定的灯控制能力接口，包括获取灯类型、配置点灯模式、配置灯闪烁效果、点灯、熄灯等。基于HDF（Hardware Driver Foundation）驱动框架开发的Light驱动模型，实现跨操作系统迁移，器件差异配置等功能。实现Light驱动“一次开发，多系统部署”的目标。Light驱动模型如[图1](#Light驱动模型图)所示：
​ Light驱动模型为上层Light硬件服务层提供稳定的灯控制能力接口，包括获取灯类型、配置点灯模式、配置灯闪烁效果、点灯、熄灯等。基于HDF（Hardware Driver Foundation）驱动框架开发的Light驱动模型，实现跨操作系统迁移，器件差异配置等功能。实现Light驱动“一次开发，多系统部署”的目标。Light驱动模型如图1示：
**图 1** Light驱动模型图
......@@ -13,7 +13,7 @@
### 运作机制
通过介绍Light驱动模型的加载以及运行流程，对模型内部关键组件以及关联组件之间的关系进行了划分，整体加载流程如[图2](#Light驱动运行图)所示：
通过介绍Light驱动模型的加载以及运行流程，对模型内部关键组件以及关联组件之间的关系进行了划分，整体加载流程如图2所示：
**图 2** Light驱动运行图
......@@ -36,7 +36,7 @@ Light驱动模型以标准系统Hi3516DV300为例，介绍整个驱动加载及
### 接口说明
Light驱动模型支持获取系统中所有灯的信息，动态配置闪烁模式和闪烁时间的能力。Light硬件服务调用GetLightInfo获取Light设备的基本信息；调用TurnOnLight接口启动配置的闪烁效果。Light驱动模型对外开放的API接口能力，参考[表1](#Light驱动模型对外API接口能力介绍)。
Light驱动模型支持获取系统中所有灯的信息，动态配置闪烁模式和闪烁时间的能力。Light硬件服务调用GetLightInfo获取Light设备的基本信息；调用TurnOnLight接口启动配置的闪烁效果。Light驱动模型对外开放的API接口能力，参考表1。
**表1** Light驱动模型对外API接口能力介绍
......@@ -148,7 +148,7 @@ Light驱动模型支持获取系统中所有灯的信息，动态配置闪烁模
HdfWorkDestroy(&drvData->work);
HdfWorkQueueDestroy(&drvData->workQueue);
(void)OsalMutexDestroy(&drvData->mutex);
(void)OsalMemFree(drvData);
OsalMemFree(drvData);
g_lightDrvData = NULL;
}
```
......
zh-cn/device-dev/quick-start/Readme-CN.md
浏览文件 @ eb190501
# 快速入门
- 轻量和小型系统入门
# quick-start
- 快速入门
- 轻量和小型系统入门
- 轻量和小型系统快速入门-安装包
- [轻量与小型系统入门概述](quickstart-lite-overview.md)
- [搭建轻量与小型系统环境](quickstart-lite-env-setup.md)
- 运行“Hello World”
- Hi3861开发板
- [安装Hi3861开发板环境](quickstart-lite-steps-hi3861-setting.md)
- [编写“Hello World”程序](quickstart-lite-steps-hi3861-application-framework.md)
- [编译](quickstart-lite-steps-hi3861-building.md)
- [烧录](quickstart-lite-steps-hi3861-burn.md)
- [联网](quickstart-lite-steps-hi3861-netconfig.md)
- [调试验证](quickstart-lite-steps-hi3861-debug.md)
- [运行](quickstart-lite-steps-hi3816-running.md)
- Hi3516开发板
- [安装Hi3516开发板环境](quickstart-lite-steps-hi3516-setting.md)
- [编写“Hello World”程序](quickstart-lite-steps-hi3516-application-framework.md)
- [编译](quickstart-lite-steps-hi3516-building.md)
- [烧录](quickstart-lite-steps-hi3516-burn.md)
- [运行](quickstart-lite-steps-hi3516-running.md)
- 常见问题
- [hb安装异常](quickstart-lite-faq-hb.md)
- [编译异常](quickstart-lite-faq-compose.md)
- [烧录异常](quickstart-lite-faq-burning.md)
- 附录
- 开发板介绍
- [Hi3861开发板介绍](quickstart-lite-introduction-hi3861.md)
- [Hi3516开发板介绍](quickstart-lite-introduction-hi3516.md)
- [参考信息](quickstart-lite-reference.md)
- 轻量和小型系统快速入门-IDE
- [轻量与小型系统入门概述](quickstart-ide-lite-overview.md)
- 准备轻量与小型系统环境
- [搭建系统环境](quickstart-ide-lite-env-system.md)
- [搭建Windows+Ubuntu混合开发环境](quickstart-ide-lite-env-setup-win-ubuntu.md)
- [获取源码](quickstart-ide-lite-sourcecode-acquire.md)
- [创建源码工程](quickstart-ide-lite-create-project.md)
- 运行Hello World
- 运行“Hello World”
- Hi3861开发板
- [编写“Hello World”程序](quickstart-ide-lite-steps-hi3861-application-framework.md)
- [编译](quickstart-ide-lite-steps-hi3861-building.md)
......@@ -22,10 +52,34 @@
- 开发板介绍
- [Hi3861开发板介绍](quickstart-ide-lite-introduction-hi3861.md)
- [Hi3516开发板介绍](quickstart-ide-lite-introduction-hi3516.md)
- 标准系统入门
- 标准系统入门
- 标准系统快速入门-安装包
- [标准系统入门概述](quickstart-standard-overview.md)
- [搭建标准系统环境](quickstart-standard-env-setup.md)
- 运行“Hello World”
- Hi3516开发板
- [编写“Hello World”程序](quickstart-standard-running-hi3516-create.md)
- [编译](quickstart-standard-running-hi3516-build.md)
- [烧录](quickstart-standard-running-hi3516-burning.md)
- [运行](quickstart-standard-running-hi3516-running.md)
- RK3568开发板
- [编写“Hello World”程序](quickstart-standard-running-rk3568-create.md)
- [编译](quickstart-standard-running-rk3568-build.md)
- [烧录](quickstart-standard-running-rk3568-burning.md)
- [运行](quickstart-standard-running-rk3568-running.md)
- 常见问题
- [hb安装异常](quickstart-standard-faq-hb.md)
- [编译异常](quickstart-standard-faq-compose.md)
- [烧录异常](quickstart-standard-faq-burning.md)
- 附录
- 开发板介绍
- [Hi3516开发板介绍](quickstart-standard-board-introduction-hi3516.md)
- [RK3568开发板介绍](quickstart-standard-board-introduction-rk3568.md)
- [参考信息](quickstart-standard-reference.md)
- 标准系统快速入门-IDE
- [标准系统入门概述](quickstart-ide-standard-overview.md)
- 准备标准系统环境
- [搭建系统环境](quickstart-ide-standard-env-system.md)
- [搭建Windows+Ubuntu混合开发环境](quickstart-ide-standard-env-setup-win-ubuntu.md)
- [获取源码](quickstart-ide-standard-sourcecode-acquire.md)
- [创建源码工程](quickstart-ide-standard-create-project.md)
- 运行“Hello World”
......
zh-cn/device-dev/quick-start/quickstart-ide-lite-create-project.md
浏览文件 @ eb190501
# 创建源码工程
在完成[搭建Windows+Ubuntu混合开发环境](../quick-start/quickstart-ide-lite-env-setup-win-ubuntu.md)和[获取源码](../quick-start/quickstart-ide-lite-sourcecode-acquire.md)后，您需要在Windows环境中按照如下步骤创建源码工程。
1. 打开DevEco Device Tool，进入Home页，点击**Import Project**打开工程。
![zh-cn_image_0000001171426014](figures/zh-cn_image_0000001171426014.png)
2. 选择待打开的工程目录，点击**Import**打开。
2. 选择要导入的源码目录，点击**Import**打开。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 工程存储路径不能包含中文字符、空格。如果工程存储路径包含中文字符或空格，可能导致编译失败。
![zh-cn_image_0000001260943159](figures/zh-cn_image_0000001260943159.png)
![zh-cn_image_0000001271477045](figures/zh-cn_image_0000001271477045.png)
3. 如果您打开的目录不是DevEco Device Tool工程，则会出现如下提示框，点击**Import**。
![zh-cn_image_0000001135394334](figures/zh-cn_image_0000001135394334.png)
......@@ -17,6 +20,11 @@
![zh-cn_image_0000001215743910](figures/zh-cn_image_0000001215743910.png)
5. 在Import Project界面，选择**Product**后，会自动填充对应的MCU、Board、company和kernel信息，然后**ohosVersion**选择对应的OpenHarmony源码版本。下图以导入wifiiot_hispark_pegasus为例进行说明。
![zh-cn_image_0000001260864961](figures/zh-cn_image_0000001260864961.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> Hi3861开发板Product选择“wifiiot_hispark_pegasus”。
>
> Hi3516DV300开发板Product选择“ipcamera_hispark_taurus”。
![zh-cn_image_0000001271237241](figures/zh-cn_image_0000001271237241.png)
6. 点击**Open**打开工程或源码。
zh-cn/device-dev/quick-start/quickstart-ide-lite-env-setup-win-ubuntu.md 0 → 100644
浏览文件 @ eb190501
# 搭建Windows+Ubuntu混合开发环境
通常在嵌入式开发中，很多开发者习惯于使用Windows进行代码的编辑，比如使用Windows的Visual Studio Code进行OpenHarmony代码的开发。但当前阶段，大部分的开发板源码还不支持在Windows环境下进行编译，如Hi3861、Hi3516系列开发板。因此，需要使用Ubuntu的编译环境对源码进行编译。
在以上的设备开发场景中，可以搭建一套Windows+Ubuntu混合开发的环境，其中使用Windows平台的DevEco Device Tool可视化界面进行相关操作，通过远程连接的方式对接Ubuntu下的DevEco Device Tool（可以不安装Visual Studio Code），然后对Ubuntu下的源码进行开发、编译、烧录等操作。
## 系统要求
- Windows系统要求：Windows10 64位系统。
- Ubuntu系统要求：Ubuntu20.04及以上版本，内存推荐16 GB及以上。
- Windows系统和Ubuntu系统的用户名不能包含中文字符。
- Windows和Ubuntu系统上安装的DevEco Device Tool为3.0 Release版本。
## 搭建Ubuntu环境
在Windows+Ubuntu混合开发环境场景中，在Ubuntu系统上可以不用安装Visual Studio Code，这种情况下，Ubuntu环境中就没有DevEco Device Tool的可视化操作界面。如果需要使用到Ubuntu下的DevEco Device Tool可视化操作界面，环境搭建请参考[搭建Ubuntu开发环境](https://device.harmonyos.com/cn/docs/documentation/guide/ide-install-ubuntu-0000001072959308)。
1. 将Ubuntu Shell环境修改为bash。
1. 执行如下命令，确认输出结果为bash。如果输出结果不是bash，请根据步骤2，将Ubuntu shell修改为bash。
```
ls -l /bin/sh
```
![zh-cn_image_0000001226764302](figures/zh-cn_image_0000001226764302.png)
2. 打开终端工具，执行如下命令，输入密码，然后选择**No**，将Ubuntu shell由dash修改为bash。
```
sudo dpkg-reconfigure dash
```
![zh-cn_image_0000001243641075](figures/zh-cn_image_0000001243641075.png)
2. 下载[DevEco Device Tool 3.0 Release](https://device.harmonyos.com/cn/ide#download)Linux版本。
3. 解压DevEco Device Tool软件包并对解压后的文件夹进行赋权。
1. 进入DevEco Device Tool软件包目录，执行如下命令解压软件包，其中devicetool-linux-tool-3.0.0.400.zip为软件包名称，请根据实际进行修改。
```
unzip devicetool-linux-tool-3.0.0.400.zip
```
2. 进入解压后的文件夹，执行如下命令，赋予安装文件可执行权限，其中devicetool-linux-tool-3.0.0.400.sh请根据实际进行修改。
```
chmod u+x devicetool-linux-tool-3.0.0.400.sh
```
4. 执行如下命令，安装DevEco Device Tool，其中devicetool-linux-tool-3.0.0.400.sh请根据实际进行修改。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 安装过程中，会自动检查Python是否安装，且要求Python为3.8~3.9版本。如果不满足，则安装过程中会自动安装，提示“Do you want to continue?”，请输入“Y”后继续安装。
```
sudo ./devicetool-linux-tool-3.0.0.300.sh
```
安装完成后，当界面输出“Deveco Device Tool successfully installed.”时，表示DevEco Device Tool安装成功。
![zh-cn_image_0000001198722374](figures/zh-cn_image_0000001198722374.png)
## 搭建Windows开发环境
通过Windows系统远程访问Ubuntu环境，需要先在Windows系统中安装DevEco Device Tool，以便使用Windows平台的DevEco Device Tool可视化界面进行相关操作。
1. 下载[DevEco Device Tool 3.0 Release](https://device.harmonyos.com/cn/ide#download)Windows版。
2. 解压DevEco Device Tool压缩包，双击安装包程序，点击Next进行安装。
3. 设置DevEco Device Tool的安装路径，建议安装到非系统盘符，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果您已安装DevEco Device Tool 3.0 Beta2及以前的版本，则在安装新版本时，会先卸载旧版本，卸载过程中出现如下错误提示时，请点击“Ignore”继续安装，该错误不影响新版本的安装。
>
> ![zh-cn_image_0000001239275843](figures/zh-cn_image_0000001239275843.png)
![zh-cn_image_0000001270076961](figures/zh-cn_image_0000001270076961.png)
4. 根据安装向导提示，勾选要自动安装的软件。
1. 在弹出VSCode installation confirm页面，勾选“Install VScode 1.62.2automatically”，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果检测到Visual Studio Code已安装，且版本为1.62及以上，则会跳过该步骤。
![zh-cn_image_0000001237801283](figures/zh-cn_image_0000001237801283.png)
2. 在弹出的Python select page选择“Download from Huawei mirror”，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果系统已安装可兼容的Python版本（Python 3.8~3.9版本），可选择“Use one of compatible on your PC”。
![zh-cn_image_0000001193983334](figures/zh-cn_image_0000001193983334.png)
5. 在以下界面点击**Next**，进行软件下载和安装。
![zh-cn_image_0000001239634067](figures/zh-cn_image_0000001239634067.png)
6. 继续等待DevEco Device Tool安装向导自动安装DevEco Device Tool插件，直至安装完成，点击**Finish**，关闭DevEco Device Tool安装向导。
![zh-cn_image_0000001239650137](figures/zh-cn_image_0000001239650137.png)
7. 打开Visual Studio Code，进入DevEco Device Tool工具界面。至此，DevEco Device Tool Windows开发环境安装完成。
![zh-cn_image_0000001225760456](figures/zh-cn_image_0000001225760456.png)
## 配置Windows远程访问Ubuntu环境
### 安装SSH服务并获取远程访问的IP地址
1. 在Ubuntu系统中，打开终端工具，执行如下命令安装SSH服务。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果执行该命令失败，提示openssh-server和openssh-client依赖版本不同，请根据CLI界面提示信息，安装openssh-client相应版本后（例如：sudo apt-get install openssh-client=1:8.2p1-4），再重新执行该命令安装openssh-server。
```
sudo apt-get install openssh-server
```
2. 执行如下命令，启动SSH服务。
```
sudo systemctl start ssh
```
3. 执行如下命令，获取当前用户的IP地址，用于Windows系统远程访问Ubuntu环境。
```
ifconfig
```
![zh-cn_image_0000001215737140](figures/zh-cn_image_0000001215737140.png)
### 安装Remote SSH
1. 打开Windows系统下的Visual Studio Code，点击![zh-cn_image_0000001239080359](figures/zh-cn_image_0000001239080359.png)，在插件市场的搜索输入框中输入“remote-ssh”。
![zh-cn_image_0000001193920448](figures/zh-cn_image_0000001193920448.png)
2. 点击Remote-SSH的**Install**按钮，安装Remote-SSH。安装成功后，在**INSTALLED**下可以看到已安装Remote-SSH。
![zh-cn_image_0000001238880335](figures/zh-cn_image_0000001238880335.png)
### 远程连接Ubuntu环境
1. 打开Windows系统的Visual Studio Code，点击![zh-cn_image_0000001238760373](figures/zh-cn_image_0000001238760373.png)，在REMOTE EXOPLORER页面点击+按钮。
![zh-cn_image_0000001215878922](figures/zh-cn_image_0000001215878922.png)
2. 在弹出的SSH连接命令输入框中输入“ssh _username_\@_ip_address_”，其中ip_address为要连接的远程计算机的IP地址，username为登录远程计算机的帐号。
![zh-cn_image_0000001215879750](figures/zh-cn_image_0000001215879750.png)
3. 在弹出的输入框中，选择SSH configuration文件，选择默认的第一选项即可。
![zh-cn_image_0000001260519729](figures/zh-cn_image_0000001260519729.png)
4. 在SSH TARGETS中，找到远程计算机，点击![zh-cn_image_0000001194080414](figures/zh-cn_image_0000001194080414.png)，打开远程计算机。
![zh-cn_image_0000001215720398](figures/zh-cn_image_0000001215720398.png)
5. 在弹出的输入框中，选择**Linux**，然后在选择**Continue**，然后输入登录远程计算机的密码，连接远程计算机 。
![zh-cn_image_0000001215897530](figures/zh-cn_image_0000001215897530.png)
连接成功后，等待在远程计算机.vscode-server文件夹下自动安装插件，安装完成后，根据界面提示在Windows系统下重新加载Visual Studio Code，便可以在Windows的DevEco Device Tool界面进行源码开发、编译、烧录等操作。
### 注册访问Ubuntu环境的公钥
在完成以上操作后，您就可以通过Windows远程连接Ubuntu环境进行开发了，但在使用过程中，需要您频繁的输入远程连接密码来进行连接。为解决该问题，您可以使用SSH公钥来进行设置。
1. 打开Git bash命令行窗口，执行如下命令，生成SSH公钥，请注意，在执行命令过程中，请根据界面提示进行操作。username和ip请填写连接Ubuntu系统时需要的参数。
```
ssh-keygen -t rsa
ssh-copy-id -i ~/.ssh/id_rsa.pub username@ip
```
![zh-cn_image_0000001271532317](figures/zh-cn_image_0000001271532317.png)
2. 在Visual Studio Code中，点击远程连接的设置按钮，并选择打开config文件。
![zh-cn_image_0000001226034634](figures/zh-cn_image_0000001226034634.png)
3. 在config配置文件中添加SSK Key文件信息，如下图所示，然后保存即可。
![zh-cn_image_0000001270356233](figures/zh-cn_image_0000001270356233.png)
zh-cn/device-dev/quick-start/quickstart-ide-lite-env-setup.md
浏览文件 @ eb190501
......@@ -2,6 +2,6 @@
- **[搭建系统环境](quickstart-ide-lite-env-system.md)**
- **[搭建Windows+Ubuntu混合开发环境](quickstart-ide-lite-env-setup-win-ubuntu.md)**
- **[获取源码](quickstart-ide-lite-sourcecode-acquire.md)**
\ No newline at end of file
zh-cn/device-dev/quick-start/quickstart-ide-lite-env-system.md 已删除 100644 → 0
浏览文件 @ 28dcf451
# 搭建系统环境
DevEco Device Tool Ubuntu版本是OpenHarmony的一站式开发工具，支持源码开发、编译、烧录，调测等。下文介绍如何在Ubuntu环境下安装DevEco Device Tool。
## 系统要求
- Ubuntu20.04及以上版本，内存推荐16 GB及以上。
- 系统的用户名不能含有中文字符。
## 安装DevEco Device Tool
DevEco Device Tool基于Visual Studio Code进行扩展，在Visual Studio Code上以插件方式运行，Visual Studio Code版本为1.62及以上。同时，DevEco Device Tool还依赖Python工具，并要求Python为3.8~3.9版本。
在安装过程中，DevEco Device Tool会自动检查Visual Studio Code和Python，如果检测到Visual Studio Code、Python未安装或版本不符合要求，安装程序会自动安装Visual Studio Code和Python。
1. 将Ubuntu Shell环境修改为bash。
1. 执行如下命令，确认输出结果为bash。如果输出结果不是bash，请根据步骤2，将Ubuntu shell修改为bash。
```
ls -l /bin/sh
```
![zh-cn_image_0000001226764302](figures/zh-cn_image_0000001226764302.png)
2. 打开终端工具，执行如下命令，输入密码，然后选择**No**，将Ubuntu shell由dash修改为bash。
```
sudo dpkg-reconfigure dash
```
![zh-cn_image_0000001243641075](figures/zh-cn_image_0000001243641075.png)
2. 下载[DevEco Device Tool 3.0 Release](https://device.harmonyos.com/cn/ide#download)Linux版本。
3. 解压DevEco Device Tool软件包并对解压后的文件夹进行赋权。
1. 进入DevEco Device Tool软件包目录，执行如下命令解压软件包，其中devicetool-linux-tool-3.0.0.400.zip为软件包名称，请根据实际进行修改。
```
unzip devicetool-linux-tool-3.0.0.400.zip
```
2. 进入解压后的文件夹，执行如下命令，赋予安装文件可执行权限，其中devicetool-linux-tool-3.0.0.400.sh请根据实际进行修改。
```
chmod u+x devicetool-linux-tool-3.0.0.400.sh
```
4. 执行如下命令，安装DevEco Device Tool，其中devicetool-linux-tool-3.0.0.300.sh请根据实际进行修改。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 安装过程中，会自动检查Visual Studio Code和Python是否安装，且版本符合要求，其中Visual Studio Code为1.62及以上版本，Python为3.8~3.9版本。如果不满足，则安装过程中会自动安装，提示“Do you want to continue?”，请输入“Y”后继续安装。
```
sudo ./devicetool-linux-tool-3.0.0.300.sh -- --install-plugins
```
安装完成后，当界面输出“Deveco Device Tool successfully installed.”时，表示DevEco Device Tool安装成功。
![zh-cn_image_0000001243282363](figures/zh-cn_image_0000001243282363.png)
5. 安装完成后，启动Visual Studio Code。
6. 打开Visual Studio Code，进入DevEco Device Tool工具界面。至此，DevEco Device Tool Ubuntu开发环境安装完成。
![zh-cn_image_0000001243284745](figures/zh-cn_image_0000001243284745.png)
zh-cn/device-dev/quick-start/quickstart-ide-lite-introduction-hi3516.md
浏览文件 @ eb190501
......@@ -7,7 +7,7 @@ Hi3516DV300作为新一代行业专用Smart HD IP摄像机SOC，集成新一代I
**图1** Hi3516单板正面外观图
![zh-cn_image_0000001221018920](figures/zh-cn_image_0000001221018920.png)
![zh-cn_image_0000001271234717](figures/zh-cn_image_0000001271234717.png)
## 开发板规格
......
zh-cn/device-dev/quick-start/quickstart-ide-lite-introduction-hi3861.md
浏览文件 @ eb190501
......@@ -6,13 +6,13 @@
Hi3861开发板是一片大约2cm\*5cm大小的开发板，是一款高度集成的2.4GHz WLAN SoC芯片，集成IEEE 802.11b/g/n基带和RF（Radio Frequency）电路。支持OpenHarmony，并配套提供开放、易用的开发和调试运行环境。
**图1** Hi3861开发板外观图
![zh-cn_image_0000001217775292](figures/zh-cn_image_0000001217775292.png)
![zh-cn_image_0000001226634692](figures/zh-cn_image_0000001226634692.png)
另外，Hi3861开发板还可以通过与Hi3861底板连接，扩充自身的外设能力，底板如下图所示。
**图2** Hi3861底板外观图
![zh-cn_image_0000001221338844](figures/zh-cn_image_0000001221338844.png)
![zh-cn_image_0000001226794660](figures/zh-cn_image_0000001226794660.png)
- RF电路包括功率放大器PA（Power Amplifier）、低噪声放大器LNA（Low Noise Amplifier）、RF Balun、天线开关以及电源管理等模块；支持20MHz标准带宽和5MHz/10MHz窄带宽，提供最大72.2Mbit/s物理层速率。
......@@ -23,7 +23,7 @@ Hi3861开发板是一片大约2cm\*5cm大小的开发板，是一款高度集成
- Hi3861芯片适用于智能家电等物联网智能终端领域。
**图3** Hi3861功能框图
![zh-cn_image_0000001217615308](figures/zh-cn_image_0000001217615308.png)
![zh-cn_image_0000001271234729](figures/zh-cn_image_0000001271234729.png)
## 资源和约束
......
zh-cn/device-dev/quick-start/quickstart-ide-lite-overview.md
浏览文件 @ eb190501
......@@ -7,22 +7,23 @@ OpenHarmony轻量和小型系统适用于内存较小的IOT设备（参考内存
考虑到开发者的开发习惯，OpenHarmony为开发者提供了以下两种入门指导：
- 完全采用IDE（Deveco Device Tool）进行一站式开发，编译依赖工具的安装及编译、烧录、运行都通过IDE进行操作。
- IDE方式：完全采用IDE（Deveco Device Tool）进行一站式开发，编译依赖工具的安装及编译、烧录、运行都通过IDE进行操作。
- 通过命令行进行编译依赖工具的下载安装，编译操作也通过命令实现。烧录、运行等操作使用IDE。
- 安装包方式：通过命令行进行编译依赖工具的下载安装，编译操作也通过命令实现。烧录、运行等操作使用IDE。
OpenHarmony还为开发者提供了[Docker环境](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/get-code/gettools-acquire.md)，在很大程度上简化了编译前的环境配置，习惯使用安装包方式的开发者也可以选择Docker环境进行编译 。
本文采用Deveco Device Tool进行一站式开发介绍，习惯使用命令行的开发者可参考[轻量和小型系统快速入门（命令行方式）](../quick-start/quickstart-lite-overview.md)。
本文采用Deveco Device Tool进行一站式开发介绍，习惯使用命令行的开发者可参考[轻量和小型系统快速入门（安装包方式）](../quick-start/quickstart-lite-overview.md)。
## 开发环境
因当前OpenHarmony不支持在Windows下进行编译，基于Deveco Device Tool的轻量和小型系统开发有以下两种方法，开发者可根据使用习惯进行选择：
开发者通常习惯采用Windows+Ubuntu环境进行OpenHarmony开发：
- 在Linux环境下进行开发、编译和烧录。
- Windows：用于源码开发、烧录等。
- 在indows环境下进行开发和烧录，在Linux环境下进行编译。
- Ubuntu：用于源码编译。
本文将介绍第一种方法，相关操作均在Linux环境下进行。使用第二种方式的开发者可参考[Deveco Device Tool使用指导](https://device.harmonyos.com/cn/docs/documentation/guide/service_introduction-0000001050166905)。
本文将介绍如何基于Windows+Ubuntu环境进行OpenHarmony的开发。
## 开发板
......@@ -35,4 +36,4 @@ OpenHarmony轻量和小型系统适用于内存较小的IOT设备（参考内存
轻量和小型系统快速入门流程如下图所示。
**图1** 轻量和小型系统快速入门开发流程
![zh-cn_image_0000001262860145](figures/zh-cn_image_0000001262860145.png)
![zh-cn_image_0000001226634676](figures/zh-cn_image_0000001226634676.png)
zh-cn/device-dev/quick-start/quickstart-ide-lite-sourcecode-acquire.md
浏览文件 @ eb190501
# 获取源码
在Ubuntu环境下通过以下步骤拉取OpenHarmony源码。
## 准备工作
1. 注册码云gitee帐号。
......@@ -31,7 +34,7 @@
5. 执行如下命令安装码云repo工具。
```
curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo #如果没有权限，可下载至其他目录，并将其配置到环境变量中
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o /usr/local/bin/repo #如果没有权限，可下载至其他目录，并将其配置到环境变量中
chmod a+x /usr/local/bin/repo
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests
```
......
zh-cn/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-application-framework.md
浏览文件 @ eb190501
......@@ -13,19 +13,8 @@
```
applications/sample/hello
│── BUILD.gn
│── include
│ └── helloworld.h
│── src
│ └── helloworld.c
├── bundle.json
│
│── test
│ └── moduletest
│ └── unittest
│
productdefine/common
└── products
└── Hi3516DV300.json
└── src
└── helloworld.c
```
......@@ -33,127 +22,114 @@ productdefine/common
请在源码目录中通过以下步骤创建“Hello World”应用程序：
1. 创建目录，编写业务代码。
新建applications/sample/hello/src/helloworld.c目录及文件，代码如下所示，用户可以自定义修改打印内容（例如：修改World为OH）。其中helloworld.h包含字符串打印函数HelloPrint的声明。当前应用程序可支持标准C及C++的代码开发。
1. 新建目录及源码。
新建**applications/sample/hello/src/helloworld.c**目录及文件，代码如下所示，用户可以自定义修改打印内容（例如：修改OHOS为World）。当前应用程序可支持标准C及C++的代码开发。
```
#include <stdio.h>
#include "helloworld.h"
int main(int argc, char **argv)
{
HelloPrint();
return 0;
}
void HelloPrint()
{
printf("\n\n");
printf("\n\t\tHello World!\n");
printf("\n\n");
printf("\n\t\tHello OHOS!\n");
printf("\n\n\n");
return 0;
}
```
再添加头文件applications/sample/hello/include/helloworld.h，代码如下所示。
2. 新建编译组织文件。
新建**applications/sample/hello/BUILD.gn**文件，内容如下所示：
```
#ifndef HELLOWORLD_H
#define HELLOWORLD_H
#ifdef __cplusplus
#if __cplusplus
extern "C" {
#endif
#endif
void HelloPrint();
#ifdef __cplusplus
#if __cplusplus
import("//build/lite/config/component/lite_component.gni")
lite_component("hello-OHOS") {
features = [ ":helloworld" ]
}
executable("helloworld") {
output_name = "helloworld"
sources = [ "src/helloworld.c" ]
}
#endif
#endif
#endif // HELLOWORLD_H
```
2. 新建编译组织文件。
1. 新建applications/sample/hello/BUILD.gn文件，内容如下所示：
3. 添加新组件。
修改文件**build/lite/components/applications.json**，添加组件hello_world_app的配置，如下所示为applications.json文件片段，"\#\#start\#\#"和"\#\#end\#\#"之间为新增配置（"\#\#start\#\#"和"\#\#end\#\#"仅用来标识位置，添加完配置后删除这两行）：
```
import("//build/ohos.gni") # 导入编译模板
ohos_executable("helloworld") { # 可执行模块
sources = [ # 模块源码
"src/helloworld.c"
]
include_dirs = [ # 模块依赖头文件目录
"include"
]
cflags = []
cflags_c = []
cflags_cc = []
ldflags = []
configs = []
deps =[] # 部件内部依赖
part_name = "sample" # 所属部件名称，必选
install_enable = true # 是否默认安装（缺省默认不安装），可选
}
```
2. 新建applications/sample/bundle.json文件，添加sample部件描述，内容如下所示。
```
{
"name": "@ohos/hello",
"description": "Hello world example.",
"version": "3.1",
"license": "Apache License 2.0",
"publishAs": "code-segment",
"segment": {
"destPath": "applications/sample/hello"
},
"dirs": {},
"scripts": {},
"component": {
"name": "hello",
"subsystem": "applications",
"syscap": [],
"features": [],
"adapted_system_type": [
"mini",
"small",
"standard"
"components": [
{
"component": "camera_sample_communication",
"description": "Communication related samples.",
"optional": "true",
"dirs": [
"applications/sample/camera/communication"
],
"rom": "10KB",
"ram": "10KB",
"targets": [
"//applications/sample/camera/communication:sample"
],
"rom": "",
"ram": "",
"output": [],
"adapted_kernel": [ "liteos_a" ],
"features": [],
"deps": {
"components": [],
"third_party": []
}
},
"build": {
"sub_component": [
"//applications/sample/hello:helloworld"
##start##
{
"component": "hello_world_app",
"description": "hello world samples.",
"optional": "true",
"dirs": [
"applications/sample/hello"
],
"inner_kits": [],
"test": [
"//applications/sample/hello/test:moduletest",
"//applications/sample/hello/test:unittest"
]
}
}
"targets": [
"//applications/sample/hello:hello-OHOS"
],
"rom": "",
"ram": "",
"output": [],
"adapted_kernel": [ "liteos_a" ],
"features": [],
"deps": {
"components": [],
"third_party": []
}
},
##end##
{
"component": "camera_sample_app",
"description": "Camera related samples.",
"optional": "true",
"dirs": [
"applications/sample/camera/launcher",
"applications/sample/camera/cameraApp",
"applications/sample/camera/setting",
"applications/sample/camera/gallery",
"applications/sample/camera/media"
],
```
bundle.json文件包含两个部分，第一部分说明该子系统的名称，component定义该子系统包含的部件，要添加一个部件，需要把该部件对应的内容添加进component中去。添加的时候需要指明该部件包含的模块sub_component，假如有提供给其它部件的接口，需要在inner_kits中说明，假如有测试用例，需要在test中说明，inner_kits与test没有也可以不添加。
3. 修改产品配置文件。
在productdefine\common\products\Hi3516DV300.json中添加对应的hello部件，直接添加到原有部件后即可。
4. 修改单板配置文件。
修改文件**vendor/hisilicon/hispark_taurus/config.json**，新增hello_world_app组件的条目，如下所示代码片段为applications子系统配置，"\#\#start\#\#"和"\#\#end\#\#"之间为新增条目（"\#\#start\#\#"和"\#\#end\#\#"仅用来标识位置，添加完配置后删除这两行）：
```
"usb:usb_manager_native":{},
"applications:prebuilt_hap":{},
"applications:hello":{},
"wpa_supplicant-2.9:wpa_supplicant-2.9":{},
{
"subsystem": "applications",
"components": [
{ "component": "camera_sample_app", "features":[] },
{ "component": "camera_sample_ai", "features":[] },
##start##
{ "component": "hello_world_app", "features":[] },
##end##
{ "component": "camera_screensaver_app", "features":[] }
]
},
```
zh-cn/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-burn.md
浏览文件 @ eb190501
# 烧录
Hi3516DV300支持USB烧录、网口烧录和串口烧录三种方式，本文以Linux下的网口烧录方式为例进行介绍。
Hi3516DV300支持USB烧录、网口烧录和串口烧录三种方式，本文采用USB方式进行烧录。相关操作在Windows环境下进行 。
1. 请连接好电脑和待烧录开发板，需要同时连接串口、网口和电源，具体可参考[Hi3516DV300开发板介绍](https://device.harmonyos.com/cn/docs/documentation/guide/quickstart-lite-introduction-hi3516-0000001152041033)。
1. 请连接好电脑和待烧录开发板，需要同时连接串口和USB口，具体可参考[Hi3516DV300开发板介绍](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-lite-introduction-hi3516.md)。
2. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
2. 在DevEco Device Tool中，选择REMOTE DEVELOPMENT &gt; Local PC，查看远程计算机（Ubuntu开发环境）与本地计算机（Windows开发环境）的连接状态。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261315939](figures/zh-cn_image_0000001261315939.png)，则远程计算机与本地计算机为已连接状态，不需要执行其他操作。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261515989](figures/zh-cn_image_0000001261515989.png)，则点击绿色连接进行按钮。
![zh-cn_image_0000001261395999](figures/zh-cn_image_0000001261395999.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 该操作仅在远程模式（Windows+Ubuntu混合开发环境）中需要设置，如果采用本地模式（Windows开发环境或Ubuntu开发环境），则请跳过该步骤。
3. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
![zh-cn_image_0000001216516128](figures/zh-cn_image_0000001216516128.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果对应的串口异常，请根据[Hi3516DV300/Hi3518EV300开发板串口驱动安装指导](https://device.harmonyos.com/cn/docs/documentation/guide/hi3516_hi3518-drivers-0000001050743695)安装USB转串口的驱动程序。
3. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001198567426](figures/zh-cn_image_0000001198567426.png)
4. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001198566364](figures/zh-cn_image_0000001198566364.png)
4. 在“hi3516dv300”页签，设置烧录选项，包括upload_partitions、upload_port和upload_protocol。
5. 在“hi3516dv300”页签，设置烧录选项，包括upload_partitions、upload_port和upload_protocol。
- upload_partitions：选择待烧录的文件，默认情况下会同时烧录fastboot、kernel、rootfs和userfs。
- upload_port：选择已查询的串口号。
- upload_protocol：选择烧录协议，固定选择“hiburn-net”。
![zh-cn_image_0000001243568557](figures/zh-cn_image_0000001243568557.png)
- upload_port：选择已查询到的串口号。
- upload_protocol：选择烧录协议，固定选择“hiburn-usb”。
5. 检查和设置连接开发板后的网络适配器的IP地址信息，设置方法请参考[设置Hi3516DV300网口烧录的IP地址信息](https://device.harmonyos.com/cn/docs/documentation/guide/set_ipaddress-0000001141825075)。
![zh-cn_image_0000001223190441](figures/zh-cn_image_0000001223190441.png)
6. 设置网口烧录的IP地址信息，设置如下选项：
- upload_net_server_ip：选择步骤6中设置的IP地址信息。例如192.168.1.2
- upload_net_client_mask：设置开发板的子网掩码，工具会自动根据选择的upload_net_server_ip进行设置。例如255.255.255.0
- upload_net_client_gw：设置开发板的网关，工具会自动根据选择的upload_net_server_ip进行设置。例如192.168.1.1
- upload_net_client_ip：设置开发板的IP地址，工具会自动根据选择的upload_net_server_ip进行设置。例如192.168.1.3
![zh-cn_image_0000001153577284](figures/zh-cn_image_0000001153577284.png)
7. 分别检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。待烧录文件包括：fastboot、kernel、rootfs和userfs。
6. 分别检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。待烧录文件包括：fastboot、kernel、rootfs和userfs。
1. 在“hi3516dv300_fastboot”页签，在New Option选项中选择需要修改的项，例如partition_bin（烧录文件路径）、partition_addr（烧录文件起始地址）、partition_length（烧录文件分区长度）等。
![zh-cn_image_0000001198889702](figures/zh-cn_image_0000001198889702.png)
2. 然后在Partition Options中，分别修改上述步骤中选择的修改项。
......@@ -42,15 +41,19 @@ Hi3516DV300支持USB烧录、网口烧录和串口烧录三种方式，本文以
![zh-cn_image_0000001243290907](figures/zh-cn_image_0000001243290907.png)
3. 按照相同的方法修改kernel、rootfs和userfs的烧录文件信息。
8. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
7. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
8. 点击hi3516dv300下的**Upload**按钮，启动烧录。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果您是第一次在工作台烧录Hi3516DV300/Hi3518EV300开发板，可能烧录失败，提示“not find the Devices”，然后根据[Hi3516DV300/Hi3518EV300开发板USB驱动安装](https://device.harmonyos.com/cn/docs/documentation/guide/usb_driver-0000001058690393)进行处理后再重新烧录。
![zh-cn_image_0000001267231481](figures/zh-cn_image_0000001267231481.png)
9. 点击**Open**打开工程文件，然后在“PROJECT TASKS”中，点击hi3516dv300下的**Upload**按钮，启动烧录。
![zh-cn_image_0000001211275515](figures/zh-cn_image_0000001211275515.png)
9. 在终端窗口显示如下提示信息时，按住复位键，插拔USB线，最后松开复位键启动烧录。
![zh-cn_image_0000001114129426](figures/zh-cn_image_0000001114129426.png)
10. 启动烧录后，显示如下提示信息时，请插拔USB线。
![zh-cn_image_0000001166193504](figures/zh-cn_image_0000001166193504.png)
启动烧录后，界面提示如下信息时，表示烧录成功。
11. 重新上电后，界面提示如下信息时，表示烧录成功。
![zh-cn_image_0000001165701218](figures/zh-cn_image_0000001165701218.png)
![zh-cn_image_0000001160649343](figures/zh-cn_image_0000001160649343.png)
12. 烧录成功后，请根据镜像运行章节进行操作，启动系统。
10. 烧录成功后，请根据镜像运行章节进行操作，启动系统。
zh-cn/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-running.md
浏览文件 @ eb190501
......@@ -9,16 +9,16 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> DevEco Device Tool针对Hi3516DV300开发板的BootLoader设置进行了适配，无需开发者手动修改。
![zh-cn_image_0000001262855083](figures/zh-cn_image_0000001262855083.png)
![zh-cn_image_0000001226794644](figures/zh-cn_image_0000001226794644.png)
2. 提示如下图中的重启开发板的提示信息时，重启开发板，然后在控制台输出“SUCCESS”表示设置成功。
![zh-cn_image_0000001262735093](figures/zh-cn_image_0000001262735093.png)
![zh-cn_image_0000001227114584](figures/zh-cn_image_0000001227114584.png)
3. 在任务栏点击**Monitor**按钮，启动串口工具。
![zh-cn_image_0000001262575147](figures/zh-cn_image_0000001262575147.png)
![zh-cn_image_0000001271234705](figures/zh-cn_image_0000001271234705.png)
4. 当界面打印回显信息，点击Enter按钮，直到界面显示OHOS \#信息，表示系统启动成功。
![zh-cn_image_0000001218095242](figures/zh-cn_image_0000001218095242.png)
![zh-cn_image_0000001271594709](figures/zh-cn_image_0000001271594709.png)
## 运行“Hello World”
......@@ -39,7 +39,7 @@
界面打印“Hello World！”，程序运行成功。
![zh-cn_image_0000001218341058](figures/zh-cn_image_0000001218341058.png)
![zh-cn_image_0000001271354693](figures/zh-cn_image_0000001271354693.png)
## 下一步学习
......
zh-cn/device-dev/quick-start/quickstart-ide-lite-steps-hi3816-running.md
浏览文件 @ eb190501
......@@ -16,4 +16,4 @@ wifi init success!
## 下一步学习
恭喜，您已完成Hi3861开发板快速上手！建议您下一步进入[WLAN产品开发](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/guide/device-wlan.md)的学习 。
恭喜，您已完成Hi3861 WLAN模组快速上手！建议您下一步进入[WLAN产品开发](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/guide/device-wlan.md)的学习 。
zh-cn/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-application-framework.md
浏览文件 @ eb190501
# 编写“Hello World”程序
下方将展示如何在单板上运行第一个应用程序，其中包括新建应用程序、编译、烧写、运行等步骤，最终输出“Hello World！”。
下方将通过修改源码的方式展示如何编写简单程序，输出“Hello world”。请在下载的源码目录中进行下述操作。
## 示例目录
1. 确定目录结构。
开发者编写业务时，务必先在./applications/sample/wifi-iot/app路径下新建一个目录（或一套目录结构），用于存放业务源码文件。
示例完整目录如下：
例如：在app下新增业务my_first_app，其中hello_world.c为业务代码，BUILD.gn为编译脚本，具体规划目录结构如下：
```
applications/sample/hello
│── BUILD.gn
│── include
│ └── helloworld.h
│── src
│ └── helloworld.c
├── bundle.json
│
│── test
│ └── moduletest
│ └── unittest
│
productdefine/common
└── products
└── wifi-iot.json
```
## 开发步骤
请在源码目录中通过以下步骤创建“Hello World”应用程序：
1. 创建目录，编写业务代码。
新建applications/sample/hello/src/helloworld.c目录及文件，代码如下所示，用户可以自定义修改打印内容（例如：修改World为OH）。其中helloworld.h包含字符串打印函数HelloPrint的声明。当前应用程序可支持标准C及C++的代码开发。
```
.
└── applications
└── sample
└── wifi-iot
└── app
└── my_first_app
│── hello_world.c
└── BUILD.gn
```
2. 编写业务代码。
新建./applications/sample/wifi-iot/app/my_first_app下的hello_world.c文件，在hello_world.c中新建业务入口函数HelloWorld，并实现业务逻辑。并在代码最下方，使用OpenHarmony启动恢复模块接口SYS_RUN()启动业务。（SYS_RUN定义在ohos_init.h文件中）
```
#include <stdio.h>
#include "helloworld.h"
#include "ohos_init.h"
#include "ohos_types.h"
int main(int argc, char **argv)
void HelloWorld(void)
{
HelloPrint();
return 0;
}
void HelloPrint()
{
printf("\n\n");
printf("\n\t\tHello World!\n");
printf("\n\n");
printf("[DEMO] Hello world.\n");
}
SYS_RUN(HelloWorld);
```
再添加头文件applications/sample/hello/include/helloworld.h，代码如下所示。
3. 编写用于将业务构建成静态库的BUILD.gn文件。
新建./applications/sample/wifi-iot/app/my_first_app下的BUILD.gn文件，并完成如下配置。
如[ERROR:Invalid link:zh-cn_topic_0000001226954584.xml#xref7209204195912,link:#li5479332115116](#li5479332115116)所述，BUILD.gn文件由三部分内容（目标、源文件、头文件路径）构成，需由开发者完成填写。
```
#ifndef HELLOWORLD_H
#define HELLOWORLD_H
#ifdef __cplusplus
#if __cplusplus
extern "C" {
#endif
#endif
void HelloPrint();
#ifdef __cplusplus
#if __cplusplus
}
#endif
#endif
#endif // HELLOWORLD_H
```
2. 新建编译组织文件。
1. 新建applications/sample/hello/BUILD.gn文件，内容如下所示：
```
import("//build/ohos.gni") # 导入编译模板
ohos_executable("helloworld") { # 可执行模块
sources = [ # 模块源码
"src/helloworld.c"
static_library("myapp") {
sources = [
"hello_world.c"
]
include_dirs = [ # 模块依赖头文件目录
"include"
include_dirs = [
"//utils/native/lite/include"
]
cflags = []
cflags_c = []
cflags_cc = []
ldflags = []
configs = []
deps =[] # 部件内部依赖
part_name = "sample" # 所属部件名称，必选
install_enable = true # 是否默认安装（缺省默认不安装），可选
}
```
2. 新建applications/sample/bundle.json文件，添加sample部件描述，内容如下所示。
- static_library中指定业务模块的编译结果，为静态库文件libmyapp.a，开发者根据实际情况完成填写。
- sources中指定静态库.a所依赖的.c文件及其路径，若路径中包含"//"则表示绝对路径（此处为代码根路径），若不包含"//"则表示相对路径。
- include_dirs中指定source所需要依赖的.h文件路径。
4. 添加新组件。
修改文件**build/lite/components/applications.json**，添加组件hello_world_app的配置，如下所示为applications.json文件片段，"\#\#start\#\#"和"\#\#end\#\#"之间为新增配置（"\#\#start\#\#"和"\#\#end\#\#"仅用来标识位置，添加完配置后删除这两行）：
```
{
"name": "@ohos/hello",
"description": "Hello world example.",
"version": "3.1",
"license": "Apache License 2.0",
"publishAs": "code-segment",
"segment": {
"destPath": "applications/sample/hello"
},
"dirs": {},
"scripts": {},
"component": {
"name": "hello",
"subsystem": "applications",
"syscap": [],
"features": [],
"adapted_system_type": [
"mini",
"small",
"standard"
"components": [
{
"component": "camera_sample_communication",
"description": "Communication related samples.",
"optional": "true",
"dirs": [
"applications/sample/camera/communication"
],
"rom": "10KB",
"ram": "10KB",
"targets": [
"//applications/sample/camera/communication:sample"
],
"rom": "",
"ram": "",
"output": [],
"adapted_kernel": [ "liteos_a" ],
"features": [],
"deps": {
"components": [],
"third_party": []
}
},
"build": {
"sub_component": [
"//applications/sample/hello:helloworld"
##start##
{
"component": "hello_world_app",
"description": "hello world samples.",
"optional": "true",
"dirs": [
"applications/sample/wifi-iot/app/my_first_app"
],
"inner_kits": [],
"test": [
"//applications/sample/hello/test:moduletest",
"//applications/sample/hello/test:unittest"
]
}
}
"targets": [
"//applications/sample/wifi-iot/app/my_first_app:myapp"
],
"rom": "",
"ram": "",
"output": [],
"adapted_kernel": [ "liteos_m" ],
"features": [],
"deps": {
"components": [],
"third_party": []
}
},
##end##
{
"component": "camera_sample_app",
"description": "Camera related samples.",
"optional": "true",
"dirs": [
"applications/sample/camera/launcher",
"applications/sample/camera/cameraApp",
"applications/sample/camera/setting",
"applications/sample/camera/gallery",
"applications/sample/camera/media"
],
```
bundle.json文件包含两个部分，第一部分说明该子系统的名称，component定义该子系统包含的部件，要添加一个部件，需要把该部件对应的内容添加进component中去。添加的时候需要指明该部件包含的模块sub_component，假如有提供给其它部件的接口，需要在inner_kits中说明，假如有测试用例，需要在test中说明，inner_kits与test没有也可以不添加。
3. 修改产品配置文件。
在productdefine\common\products\wifi-iot.json中添加对应的hello部件，直接添加到原有部件后即可。
5. 修改单板配置文件。
修改文件**vendor/hisilicon/hispark_pegasus/config.json**，新增hello_world_app组件的条目，如下所示代码片段为applications子系统配置，"\#\#start\#\#"和"\#\#end\#\#"之间为新增条目（"\#\#start\#\#"和"\#\#end\#\#"仅用来标识位置，添加完配置后删除这两行）：
```
"usb:usb_manager_native":{},
"applications:prebuilt_hap":{},
"applications:hello":{},
"wpa_supplicant-2.9:wpa_supplicant-2.9":{},
{
"subsystem": "applications",
"components": [
##start##
{ "component": "hello_world_app", "features":[] },
##end##
{ "component": "wifi_iot_sample_app", "features":[] }
]
},
```
zh-cn/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-burn.md
浏览文件 @ eb190501
# 烧录
Hi3861V100开发板支持串口烧录方式，以下是具体操作步骤：
Hi3861V100开发板支持串口烧录方式，在Windows下通过以下步骤进行烧录：
1. 请连接好电脑和待烧录开发板，需要连接USB口，具体可参考[Hi3861V100开发板介绍](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-lite-introduction-hi3861.md)。
2. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
2. 在DevEco Device Tool中，选择REMOTE DEVELOPMENT &gt; Local PC，查看远程计算机（Ubuntu开发环境）与本地计算机（Windows开发环境）的连接状态。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261315939](figures/zh-cn_image_0000001261315939.png)，则远程计算机与本地计算机为已连接状态，不需要执行其他操作。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261515989](figures/zh-cn_image_0000001261515989.png)，则点击绿色连接进行按钮。
![zh-cn_image_0000001261395999](figures/zh-cn_image_0000001261395999.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 该操作仅在远程模式（Windows+Ubuntu混合开发环境）中需要设置，如果采用本地模式（Windows开发环境或Ubuntu开发环境），则请跳过该步骤。
3. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
![zh-cn_image_0000001216274840](figures/zh-cn_image_0000001216274840.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果对应的串口异常，请根据[Hi3861V100开发板串口驱动安装](https://device.harmonyos.com/cn/docs/documentation/guide/hi3861-drivers-0000001058153433)安装USB转串口的驱动程序。
3. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
4. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001198943768](figures/zh-cn_image_0000001198943768.png)
4. 在“hi3861”页签，设置烧录选项，包括upload_port、upload_protocol和upload_partitions。
5. 在“hi3861”页签，设置烧录选项，包括upload_port、upload_protocol和upload_partitions。
- upload_port：选择已查询的串口号。
- upload_protocol：选择烧录协议，选择“hiburn-serial”。
- upload_partitions：选择待烧录的文件，默认选择hi3861_app。
![zh-cn_image_0000001243704061](figures/zh-cn_image_0000001243704061.png)
5. 检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。
6. 检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。
在“hi3861_app”页签，在New Option选项中选择partition_bin（烧录文件路径），然后设置待烧录文件的地址。
![zh-cn_image_0000001260919759](figures/zh-cn_image_0000001260919759.png)
6. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
7. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
7. 点击**Open**打开工程文件，然后在“PROJECT TASKS”中，点击hi3861下的**Upload**按钮，启动烧录。
8. 点击**Open**打开工程文件，然后在“PROJECT TASKS”中，点击hi3861下的**Upload**按钮，启动烧录。
![zh-cn_image_0000001216440138](figures/zh-cn_image_0000001216440138.png)
8. 启动烧录后，显示如下提示信息时，请按开发板上的RST按钮重启开发板。
9. 启动烧录后，显示如下提示信息时，请按开发板上的RST按钮重启开发板。
![zh-cn_image_0000001198466090](figures/zh-cn_image_0000001198466090.png)
9. 重新上电后，界面提示如下信息时，表示烧录成功。
10. 重新上电后，界面提示如下信息时，表示烧录成功。
![zh-cn_image_0000001216761476](figures/zh-cn_image_0000001216761476.png)
zh-cn/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-debug.md
浏览文件 @ eb190501
......@@ -59,6 +59,6 @@ Call Stack end***
```
3. 根据以上调用栈信息，可以定位WadRecvCB函数中出现了异常。
![zh-cn_image_0000001262855071](figures/zh-cn_image_0000001262855071.png)
![zh-cn_image_0000001226634668](figures/zh-cn_image_0000001226634668.png)
4. 完成代码排查及修改。
zh-cn/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-netconfig.md
浏览文件 @ eb190501
# 联网
完成版本编译及烧录后，下面开始介绍如何在串口终端上执行AT命令，使WLAN模组联网。
完成版本编译及烧录后，下面开始介绍如何在串口终端上执行AT命令，使Hi3861 WLAN模组联网。
1. 保持Windows工作台和WLAN模组的连接状态，在DevEco工具最下方，点击“DevEco:Serial Monitor”按钮。
1. 保持Windows工作台和Hi3861 WLAN模组的连接状态，在DevEco工具最下方，点击“DevEco:Serial Monitor”按钮。
**图1** 打开DevEco串口终端示意图
![zh-cn_image_0000001262455143](figures/zh-cn_image_0000001262455143.png)
![zh-cn_image_0000001226634700](figures/zh-cn_image_0000001226634700.png)
2. 复位WLAN模组，终端界面显示“ready to OS start”，则启动成功。
**图2** WLAN复位成功示意图
![zh-cn_image_0000001217775302](figures/zh-cn_image_0000001217775302.png)
2. 复位Hi3861 WLAN模组，终端界面显示“ready to OS start”，则启动成功。
**图2** Hi3861 WLAN模组复位成功示意图
![zh-cn_image_0000001271594733](figures/zh-cn_image_0000001271594733.png)
3. 在DevEco的串口终端中，依次执行如下AT命令，启动STA模式，连接指定AP热点，并开启DHCP功能。
......@@ -23,12 +23,12 @@
AT+DHCP=wlan0,1 # 通过DHCP向AP请求wlan0的IP地址
```
4. 查看WLAN模组与网关联通是否正常，如下图所示。
4. 查看Hi3861 WLAN模组与网关联通是否正常，如下图所示。
```
AT+IFCFG # 查看模组接口IP
AT+PING=X.X.X.X # 检查模组与网关的联通性，其中X.X.X.X需替换为实际的网关地址
```
**图3** WLAN模组联网成功示意图
![zh-cn_image_0000001218095246](figures/zh-cn_image_0000001218095246.png)
**图3** Hi3861 WLAN模组联网成功示意图
![zh-cn_image_0000001227114612](figures/zh-cn_image_0000001227114612.png)
zh-cn/device-dev/quick-start/quickstart-ide-standard-board-introduction-hi3516.md
浏览文件 @ eb190501
......@@ -6,7 +6,7 @@
Hi3516DV300是新一代行业专用Smart HD IP摄像机SOC，集成新一代ISP(Image Signal Processor)、H.265视频压缩编码器、高性能NNIE引擎，在低码率、高画质、智能处理和分析、低功耗等方面引领行业水平。
**图1** Hi3516单板正面外观图
![zh-cn_image_0000001265939121](figures/zh-cn_image_0000001265939121.png)
![zh-cn_image_0000001227082182](figures/zh-cn_image_0000001227082182.png)
## 开发板规格
......
zh-cn/device-dev/quick-start/quickstart-ide-standard-board-introduction-rk3568.md
浏览文件 @ eb190501
......@@ -6,10 +6,10 @@
RK3568开发板基于Rockchip RK3568芯片，集成双核心架构GPU以及高效能NPU；搭载四核64位Cortex-A55处理器，采用22nm先进工艺，主频高达2.0GHz；支持蓝牙、Wi-Fi、音频、视频和摄像头等功能，拥有丰富的扩展接口，支持多种视频输入输出接口；配置双千兆自适应RJ45以太网口，可满足NVR、工业网关等多网口产品需求。
**图1** RK3568开发板正面
![zh-cn_image_0000001217812442](figures/zh-cn_image_0000001217812442.png)
![zh-cn_image_0000001271442129](figures/zh-cn_image_0000001271442129.png)
**图2** RK3568开发板背面
![zh-cn_image_0000001217652468](figures/zh-cn_image_0000001217652468.png)
![zh-cn_image_0000001271322293](figures/zh-cn_image_0000001271322293.png)
## 开发板规格
......
zh-cn/device-dev/quick-start/quickstart-ide-standard-create-project.md
浏览文件 @ eb190501
# 创建源码工程
Import Project适用于打开DevEco Device Tool创建的工程项目和[获取的OpenHarmony源码](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/get-code/sourcecode-acquire.md)。如果是打开OpenHarmony源码，在打开工程时，点击**Import**，然后配置开发板类型和项目结构类型即可。
在完成[搭建Windows+Ubuntu混合开发环境](../quick-start/quickstart-ide-standard-env-setup-win-ubuntu.md)和[获取源码](../quick-start/quickstart-ide-standard-sourcecode-acquire.md)后，您需要在Windows环境中按照如下步骤创建源码工程。
1. 打开DevEco Device Tool，进入Home页，点击**Import Project**打开工程。
![zh-cn_image_0000001171426014](figures/zh-cn_image_0000001171426014.png)
2. 选择待打开的工程目录，点击**Import**打开。
2. 选择要导入的源码目录，点击**Import**打开。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 工程存储路径不能包含中文字符、空格。如果工程存储路径包含中文字符或空格，可能导致编译失败。
![zh-cn_image_0000001260943159](figures/zh-cn_image_0000001260943159.png)
![zh-cn_image_0000001271562277](figures/zh-cn_image_0000001271562277.png)
3. 如果您打开的目录不是DevEco Device Tool工程，则会出现如下提示框，点击**Import**。
![zh-cn_image_0000001135394334](figures/zh-cn_image_0000001135394334.png)
......@@ -19,7 +19,12 @@ Import Project适用于打开DevEco Device Tool创建的工程项目和[获取
4. 在Select Project type界面，选择**Import from OpenHarmony Source**。
![zh-cn_image_0000001215743910](figures/zh-cn_image_0000001215743910.png)
5. 在Import Project界面，选择**Product**后，会自动填充对应的MCU、Board、company和kernel信息，然后**ohosVersion**选择对应的OpenHarmony源码版本。下图以导入wifiiot_hispark_pegasus为例进行说明。
![zh-cn_image_0000001260864961](figures/zh-cn_image_0000001260864961.png)
5. 在Import Project界面，选择**Product**后，会自动填充对应的MCU、Board、company和kernel信息，然后**ohosVersion**选择对应的OpenHarmony源码版本。下图以导入Hi3516DV300为例进行展示 。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> Hi3516DV300开发板Product选择“Hi3516DV300”。
>
> RK3568开发板Product选择“rk3568”。
![zh-cn_image_0000001271448821](figures/zh-cn_image_0000001271448821.png)
6. 点击**Open**打开工程或源码。
zh-cn/device-dev/quick-start/quickstart-ide-standard-env-setup-win-ubuntu.md 0 → 100644
浏览文件 @ eb190501
# 搭建Windows+Ubuntu混合开发环境
通常在嵌入式开发中，很多开发者习惯于使用Windows进行代码的编辑，比如使用Windows的Visual Studio Code进行OpenHarmony代码的开发。但当前阶段，大部分的开发板源码还不支持在Windows环境下进行编译，如Hi3861、Hi3516系列开发板。因此，需要使用Ubuntu的编译环境对源码进行编译。
在以上的设备开发场景中，可以搭建一套Windows+Ubuntu混合开发的环境，其中使用Windows平台的DevEco Device Tool可视化界面进行相关操作，通过远程连接的方式对接Ubuntu下的DevEco Device Tool（可以不安装Visual Studio Code），然后对Ubuntu下的源码进行开发、编译、烧录等操作。
## 系统要求
- Windows系统要求：Windows10 64位系统。
- Ubuntu系统要求：Ubuntu20.04及以上版本，内存推荐16 GB及以上。
- Windows系统和Ubuntu系统的用户名不能包含中文字符。
- Windows和Ubuntu系统上安装的DevEco Device Tool为3.0 Release版本。
## 搭建Ubuntu环境
在Windows+Ubuntu混合开发环境场景中，在Ubuntu系统上可以不用安装Visual Studio Code，这种情况下，Ubuntu环境中就没有DevEco Device Tool的可视化操作界面。如果需要使用到Ubuntu下的DevEco Device Tool可视化操作界面，环境搭建请参考[搭建Ubuntu开发环境](https://device.harmonyos.com/cn/docs/documentation/guide/ide-install-ubuntu-0000001072959308)。
1. 将Ubuntu Shell环境修改为bash。
1. 执行如下命令，确认输出结果为bash。如果输出结果不是bash，请根据步骤2，将Ubuntu shell修改为bash。
```
ls -l /bin/sh
```
![zh-cn_image_0000001226764302](figures/zh-cn_image_0000001226764302.png)
2. 打开终端工具，执行如下命令，输入密码，然后选择**No**，将Ubuntu shell由dash修改为bash。
```
sudo dpkg-reconfigure dash
```
![zh-cn_image_0000001243641075](figures/zh-cn_image_0000001243641075.png)
2. 下载[DevEco Device Tool 3.0 Release](https://device.harmonyos.com/cn/ide#download)Linux版本。
3. 解压DevEco Device Tool软件包并对解压后的文件夹进行赋权。
1. 进入DevEco Device Tool软件包目录，执行如下命令解压软件包，其中devicetool-linux-tool-3.0.0.400.zip为软件包名称，请根据实际进行修改。
```
unzip devicetool-linux-tool-3.0.0.400.zip
```
2. 进入解压后的文件夹，执行如下命令，赋予安装文件可执行权限，其中devicetool-linux-tool-3.0.0.400.sh请根据实际进行修改。
```
chmod u+x devicetool-linux-tool-3.0.0.400.sh
```
4. 执行如下命令，安装DevEco Device Tool，其中devicetool-linux-tool-3.0.0.400.sh请根据实际进行修改。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 安装过程中，会自动检查Python是否安装，且要求Python为3.8~3.9版本。如果不满足，则安装过程中会自动安装，提示“Do you want to continue?”，请输入“Y”后继续安装。
```
sudo ./devicetool-linux-tool-3.0.0.300.sh
```
安装完成后，当界面输出“Deveco Device Tool successfully installed.”时，表示DevEco Device Tool安装成功。
![zh-cn_image_0000001198722374](figures/zh-cn_image_0000001198722374.png)
## 搭建Windows开发环境
通过Windows系统远程访问Ubuntu环境，需要先在Windows系统中安装DevEco Device Tool，以便使用Windows平台的DevEco Device Tool可视化界面进行相关操作。
1. 下载[DevEco Device Tool 3.0 Release](https://device.harmonyos.com/cn/ide#download)Windows版。
2. 解压DevEco Device Tool压缩包，双击安装包程序，点击Next进行安装。
3. 设置DevEco Device Tool的安装路径，建议安装到非系统盘符，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果您已安装DevEco Device Tool 3.0 Beta2及以前的版本，则在安装新版本时，会先卸载旧版本，卸载过程中出现如下错误提示时，请点击“Ignore”继续安装，该错误不影响新版本的安装。
>
> ![zh-cn_image_0000001239275843](figures/zh-cn_image_0000001239275843.png)
![zh-cn_image_0000001270076961](figures/zh-cn_image_0000001270076961.png)
4. 根据安装向导提示，勾选要自动安装的软件。
1. 在弹出VSCode installation confirm页面，勾选“Install VScode 1.62.2automatically”，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果检测到Visual Studio Code已安装，且版本为1.62及以上，则会跳过该步骤。
![zh-cn_image_0000001237801283](figures/zh-cn_image_0000001237801283.png)
2. 在弹出的Python select page选择“Download from Huawei mirror”，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果系统已安装可兼容的Python版本（Python 3.8~3.9版本），可选择“Use one of compatible on your PC”。
![zh-cn_image_0000001193983334](figures/zh-cn_image_0000001193983334.png)
5. 在以下界面点击**Next**，进行软件下载和安装。
![zh-cn_image_0000001239634067](figures/zh-cn_image_0000001239634067.png)
6. 继续等待DevEco Device Tool安装向导自动安装DevEco Device Tool插件，直至安装完成，点击**Finish**，关闭DevEco Device Tool安装向导。
![zh-cn_image_0000001239650137](figures/zh-cn_image_0000001239650137.png)
7. 打开Visual Studio Code，进入DevEco Device Tool工具界面。至此，DevEco Device Tool Windows开发环境安装完成。
![zh-cn_image_0000001225760456](figures/zh-cn_image_0000001225760456.png)
## 配置Windows远程访问Ubuntu环境
### 安装SSH服务并获取远程访问的IP地址
1. 在Ubuntu系统中，打开终端工具，执行如下命令安装SSH服务。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果执行该命令失败，提示openssh-server和openssh-client依赖版本不同，请根据CLI界面提示信息，安装openssh-client相应版本后（例如：sudo apt-get install openssh-client=1:8.2p1-4），再重新执行该命令安装openssh-server。
```
sudo apt-get install openssh-server
```
2. 执行如下命令，启动SSH服务。
```
sudo systemctl start ssh
```
3. 执行如下命令，获取当前用户的IP地址，用于Windows系统远程访问Ubuntu环境。
```
ifconfig
```
![zh-cn_image_0000001215737140](figures/zh-cn_image_0000001215737140.png)
### 安装Remote SSH
1. 打开Windows系统下的Visual Studio Code，点击![zh-cn_image_0000001239080359](figures/zh-cn_image_0000001239080359.png)，在插件市场的搜索输入框中输入“remote-ssh”。
![zh-cn_image_0000001193920448](figures/zh-cn_image_0000001193920448.png)
2. 点击Remote-SSH的**Install**按钮，安装Remote-SSH。安装成功后，在**INSTALLED**下可以看到已安装Remote-SSH。
![zh-cn_image_0000001238880335](figures/zh-cn_image_0000001238880335.png)
### 远程连接Ubuntu环境
1. 打开Windows系统的Visual Studio Code，点击![zh-cn_image_0000001238760373](figures/zh-cn_image_0000001238760373.png)，在REMOTE EXOPLORER页面点击+按钮。
![zh-cn_image_0000001215878922](figures/zh-cn_image_0000001215878922.png)
2. 在弹出的SSH连接命令输入框中输入“ssh _username_\@_ip_address_”，其中ip_address为要连接的远程计算机的IP地址，username为登录远程计算机的帐号。
![zh-cn_image_0000001215879750](figures/zh-cn_image_0000001215879750.png)
3. 在弹出的输入框中，选择SSH configuration文件，选择默认的第一选项即可。
![zh-cn_image_0000001260519729](figures/zh-cn_image_0000001260519729.png)
4. 在SSH TARGETS中，找到远程计算机，点击![zh-cn_image_0000001194080414](figures/zh-cn_image_0000001194080414.png)，打开远程计算机。
![zh-cn_image_0000001215720398](figures/zh-cn_image_0000001215720398.png)
5. 在弹出的输入框中，选择**Linux**，然后在选择**Continue**，然后输入登录远程计算机的密码，连接远程计算机 。
![zh-cn_image_0000001215897530](figures/zh-cn_image_0000001215897530.png)
连接成功后，等待在远程计算机.vscode-server文件夹下自动安装插件，安装完成后，根据界面提示在Windows系统下重新加载Visual Studio Code，便可以在Windows的DevEco Device Tool界面进行源码开发、编译、烧录等操作。
### 注册访问Ubuntu环境的公钥
在完成以上操作后，您就可以通过Windows远程连接Ubuntu环境进行开发了，但在使用过程中，需要您频繁的输入远程连接密码来进行连接。为解决该问题，您可以使用SSH公钥来进行设置。
1. 打开Git bash命令行窗口，执行如下命令，生成SSH公钥，请注意，在执行命令过程中，请根据界面提示进行操作。username和ip请填写连接Ubuntu系统时需要的参数。
```
ssh-keygen -t rsa
ssh-copy-id -i ~/.ssh/id_rsa.pub username@ip
```
![zh-cn_image_0000001271532317](figures/zh-cn_image_0000001271532317.png)
2. 在Visual Studio Code中，点击远程连接的设置按钮，并选择打开config文件。
![zh-cn_image_0000001226034634](figures/zh-cn_image_0000001226034634.png)
3. 在config配置文件中添加SSK Key文件信息，如下图所示，然后保存即可。
![zh-cn_image_0000001270356233](figures/zh-cn_image_0000001270356233.png)
zh-cn/device-dev/quick-start/quickstart-ide-standard-env-setup.md
浏览文件 @ eb190501
......@@ -2,6 +2,6 @@
- **[搭建系统环境](quickstart-ide-standard-env-system.md)**
- **[搭建Windows+Ubuntu混合开发环境](quickstart-ide-standard-env-setup-win-ubuntu.md)**
- **[获取源码](quickstart-ide-standard-sourcecode-acquire.md)**
\ No newline at end of file
zh-cn/device-dev/quick-start/quickstart-ide-standard-env-system.md 已删除 100644 → 0
浏览文件 @ 28dcf451
# 搭建系统环境
DevEco Device Tool Ubuntu版本支持OpenHarmony源码开发、编译、烧录的一站式开发环境。本章节为您介绍在Ubuntu环境下，如何搭建一套完整的可视化开发环境。
## 系统要求
- Ubuntu20.04及以上版本，内存推荐16 GB及以上。
- 系统的用户名不能含有中文字符。
## 安装DevEco Device Tool
DevEco Device Tool基于Visual Studio Code进行扩展，在Visual Studio Code上以插件方式运行，Visual Studio Code版本为1.62及以上。同时，DevEco Device Tool还依赖Python工具，并要求Python为3.8~3.9版本。
在安装过程中，DevEco Device Tool会自动检查Visual Studio Code和Python，如果检测到Visual Studio Code、Python未安装或版本不符合要求，安装程序会自动安装Visual Studio Code和Python。
1. 将Ubuntu Shell环境修改为bash。
1. 执行如下命令，确认输出结果为bash。如果输出结果不是bash，请根据步骤2，将Ubuntu shell修改为bash。
```
ls -l /bin/sh
```
![zh-cn_image_0000001226764302](figures/zh-cn_image_0000001226764302.png)
2. 打开终端工具，执行如下命令，输入密码，然后选择**No**，将Ubuntu shell由dash修改为bash。
```
sudo dpkg-reconfigure dash
```
![zh-cn_image_0000001243641075](figures/zh-cn_image_0000001243641075.png)
2. 下载[DevEco Device Tool 3.0 Release](https://device.harmonyos.com/cn/ide#download)Linux版本。
3. 解压DevEco Device Tool软件包并对解压后的文件夹进行赋权。
1. 进入DevEco Device Tool软件包目录，执行如下命令解压软件包，其中devicetool-linux-tool-3.0.0.400.zip为软件包名称，请根据实际进行修改。
```
unzip devicetool-linux-tool-3.0.0.400.zip
```
2. 进入解压后的文件夹，执行如下命令，赋予安装文件可执行权限，其中devicetool-linux-tool-3.0.0.400.sh请根据实际进行修改。
```
chmod u+x devicetool-linux-tool-3.0.0.400.sh
```
4. 执行如下命令，安装DevEco Device Tool，其中devicetool-linux-tool-3.0.0.300.sh请根据实际进行修改。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 安装过程中，会自动检查Visual Studio Code和Python是否安装，且版本符合要求，其中Visual Studio Code为1.62及以上版本，Python为3.8~3.9版本。如果不满足，则安装过程中会自动安装，提示“Do you want to continue?”，请输入“Y”后继续安装。
```
sudo ./devicetool-linux-tool-3.0.0.300.sh -- --install-plugins
```
安装完成后，当界面输出“Deveco Device Tool successfully installed.”时，表示DevEco Device Tool安装成功。
![zh-cn_image_0000001243282363](figures/zh-cn_image_0000001243282363.png)
5. 安装完成后，启动Visual Studio Code。
6. 打开Visual Studio Code，进入DevEco Device Tool工具界面。至此，DevEco Device Tool Ubuntu开发环境安装完成。
![zh-cn_image_0000001243284745](figures/zh-cn_image_0000001243284745.png)
zh-cn/device-dev/quick-start/quickstart-ide-standard-overview.md
浏览文件 @ eb190501
......@@ -7,22 +7,23 @@ OpenHarmony标准系统适用于参考内存≥128MiB的设备。通过本文，
考虑到开发者的开发习惯，OpenHarmony为开发者提供了以下两种入门指导：
- 完全采用IDE（Deveco Device Tool）进行一站式开发，编译依赖工具的安装及编译、烧录、运行都通过IDE进行操作。
- IDE方式：完全采用IDE（Deveco Device Tool）进行一站式开发，编译依赖工具的安装及编译、烧录、运行都通过IDE进行操作。
- 通过命令行进行编译依赖工具的下载安装，编译操作也通过命令实现。烧录、运行等操作使用IDE。
- 安装包方式：通过命令行进行编译依赖工具的下载安装，编译操作也通过命令实现。烧录、运行等操作使用IDE。
OpenHarmony还为开发者提供了[Docker环境](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/get-code/gettools-acquire.md)，在很大程度上简化了编译前的环境配置，习惯使用安装包方式的开发者也可以选择Docker环境进行编译 。
本文采用Deveco Device Tool进行一站式开发介绍，习惯使用命令行的开发者可参考[标准系统快速入门（命令行方式）](../quick-start/quickstart-standard-overview.md)。
本文采用Deveco Device Tool进行一站式开发介绍，习惯使用命令行的开发者可参考[ERROR:Invalid link:zh-cn_topic_0000001226602226.xml#xref218584416405,link:zh-cn_topic_0000001260903187.xml](zh-cn_topic_0000001260903187.xml)。
## 开发环境
因当前OpenHarmony不支持在Windows下进行编译，标准系统的开发有以下两种方法，开发者可根据使用习惯进行选择：
开发者通常习惯采用Windows+Ubuntu环境进行OpenHarmony开发：
- 用Linux环境进行开发、编译和烧录。
- Windows：用于源码开发、烧录等。
- 用Windows环境进行开发和烧录，使用Linux环境进行编译。
- Ubuntu：用于源码编译。
本文将介绍第一种方法，相关操作均在Linux环境下进行。使用第二种方式的开发者可参考[Deveco Device Tool使用指导](https://device.harmonyos.com/cn/docs/documentation/guide/service_introduction-0000001050166905)。
本文将介绍如何基于Windows+Ubuntu环境进行OpenHarmony的开发。
## 开发板
......@@ -35,4 +36,4 @@ OpenHarmony标准系统适用于参考内存≥128MiB的设备。通过本文，
标准系统快速入门流程如下图所示：
**图1** 标准系统快速入门开发流程
![zh-cn_image_0000001262773229](figures/zh-cn_image_0000001262773229.png)
![zh-cn_image_0000001271562257](figures/zh-cn_image_0000001271562257.png)
zh-cn/device-dev/quick-start/quickstart-ide-standard-running-hi3516-build.md
浏览文件 @ eb190501
......@@ -8,11 +8,11 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果出现安装pip组件失败，可参考[修改Python源的方法](https://device.harmonyos.com/cn/docs/documentation/guide/ide-set-python-source-0000001227639986)进行修改，完成尝试重新安装。
![zh-cn_image_0000001265652869](figures/zh-cn_image_0000001265652869.png)
![zh-cn_image_0000001227277128](figures/zh-cn_image_0000001227277128.png)
工具链自动安装完成后如下图所示。
![zh-cn_image_0000001220852754](figures/zh-cn_image_0000001220852754.png)
![zh-cn_image_0000001227757036](figures/zh-cn_image_0000001227757036.png)
3. 在“hi3516dv300”配置页签中，设置源码的编译类型**build_type**，默认为“debug“类型，请根据需要进行修改。然后点击**Save**按钮进行保存。
![zh-cn_image_0000001221172710](figures/zh-cn_image_0000001221172710.png)
......
zh-cn/device-dev/quick-start/quickstart-ide-standard-running-hi3516-burning.md
浏览文件 @ eb190501
# 烧录
标准系统烧录，在V2.2 Beta1及以上版本支持。
在Windows下采用USB烧录方式进行Hi3516DV300的烧录。
Hi3516DV300支持烧录标准系统，其烧录方式包括USB烧录、网口烧录和串口烧录三种方式。
下方以Linux系统网口烧录方式为例进行标准系统烧录，其他两种烧录方式请参照[Hi3516DV300烧录指导](https://device.harmonyos.com/cn/docs/documentation/guide/ide-hi3516-upload-0000001052148681)。
1. 请连接好电脑和待烧录开发板，需要同时连接串口、网口和电源，具体可参考[Hi3516DV300开发板介绍](https://device.harmonyos.com/cn/docs/documentation/guide/quickstart-lite-introduction-hi3516-0000001152041033)。
1. 请连接好电脑和待烧录开发板，需要同时连接串口和USB口，具体可参考[Hi3516DV300开发板介绍](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-lite-introduction-hi3516.md)。
2. 在DevEco Device Tool中，选择REMOTE DEVELOPMENT &gt; Local PC，查看远程计算机（Ubuntu开发环境）与本地计算机（Windows开发环境）的连接状态。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261315939](figures/zh-cn_image_0000001261315939.png)，则远程计算机与本地计算机为已连接状态，不需要执行其他操作。
......@@ -28,44 +22,38 @@ Hi3516DV300支持烧录标准系统，其烧录方式包括USB烧录、网口烧
> 如果对应的串口异常，请根据[Hi3516DV300/Hi3518EV300开发板串口驱动安装指导](https://device.harmonyos.com/cn/docs/documentation/guide/hi3516_hi3518-drivers-0000001050743695)安装USB转串口的驱动程序。
4. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001198567426](figures/zh-cn_image_0000001198567426.png)
![zh-cn_image_0000001198566364](figures/zh-cn_image_0000001198566364.png)
5. 在“hi3516dv300”页签，设置烧录选项，包括upload_partitions、upload_port和upload_protocol。
- upload_partitions：选择待烧录的文件，默认情况下会同时烧录fastboot、boot、updater、misc、system、vendor和userdata。
- upload_port：选择已查询的串口号。
- upload_protocol：选择烧录协议，固定选择“hiburn-net”。
![zh-cn_image_0000001198578174](figures/zh-cn_image_0000001198578174.png)
- upload_partitions：选择待烧录的文件，默认情况下会同时烧录fastboot、kernel、rootfs和userfs。
- upload_port：选择已查询到的串口号。
- upload_protocol：选择烧录协议，固定选择“hiburn-usb”。
6. 检查和设置连接开发板后的网络适配器的IP地址信息，设置方法请参考[设置Hi3516DV300网口烧录的IP地址信息](https://device.harmonyos.com/cn/docs/documentation/guide/set_ipaddress-0000001141825075)。
![zh-cn_image_0000001223190441](figures/zh-cn_image_0000001223190441.png)
7. 设置网口烧录的IP地址信息，设置如下选项：
- upload_net_server_ip：选择步骤5中设置的IP地址信息。例如192.168.1.2
- upload_net_client_mask：设置开发板的子网掩码，工具会自动根据选择的upload_net_server_ip进行设置。例如255.255.255.0
- upload_net_client_gw：设置开发板的网关，工具会自动根据选择的upload_net_server_ip进行设置。例如192.168.1.1
- upload_net_client_ip：设置开发板的IP地址，工具会自动根据选择的upload_net_server_ip进行设置。例如192.168.1.3
![zh-cn_image_0000001169942834](figures/zh-cn_image_0000001169942834.png)
8. 分别检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。待烧录文件包括：fastboot、boot、updater、misc、system、vendor和userdata。
6. 分别检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。待烧录文件包括：fastboot、kernel、rootfs和userfs。
1. 在“hi3516dv300_fastboot”页签，在New Option选项中选择需要修改的项，例如partition_bin（烧录文件路径）、partition_addr（烧录文件起始地址）、partition_length（烧录文件分区长度）等。
![zh-cn_image_0000001198898420](figures/zh-cn_image_0000001198898420.png)
![zh-cn_image_0000001198889702](figures/zh-cn_image_0000001198889702.png)
2. 然后在Partition Options中，分别修改上述步骤中选择的修改项。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 在设置烧录分区起始地址和分区长度时，应根据实际待烧录文件的大小进行设置，要求设置的烧录分区大小，要大于待烧录文件的大小；同时，各烧录文件的分区地址设置不能出现重叠。
![zh-cn_image_0000001243418457](figures/zh-cn_image_0000001243418457.png)
3. 按照相同的方法修改boot、updater和misc的烧录文件信息。
![zh-cn_image_0000001243290907](figures/zh-cn_image_0000001243290907.png)
3. 按照相同的方法修改kernel、rootfs和userfs的烧录文件信息。
7. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
8. 点击hi3516dv300下的**Upload**按钮，启动烧录。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果您是第一次在工作台烧录Hi3516DV300/Hi3518EV300开发板，可能烧录失败，提示“not find the Devices”，然后根据[Hi3516DV300/Hi3518EV300开发板USB驱动安装](https://device.harmonyos.com/cn/docs/documentation/guide/usb_driver-0000001058690393)进行处理后再重新烧录。
9. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
![zh-cn_image_0000001267231481](figures/zh-cn_image_0000001267231481.png)
10. 点击**Open**打开工程文件，然后在“PROJECT TASKS”中，点击hi3516dv300下的**Upload**按钮，启动烧录。
![zh-cn_image_0000001198619522](figures/zh-cn_image_0000001198619522.png)
9. 在终端窗口显示如下提示信息时，按住复位键，插拔USB线，最后松开复位键启动烧录。
![zh-cn_image_0000001114129426](figures/zh-cn_image_0000001114129426.png)
11. 启动烧录后，显示如下提示信息时，请插拔USB线。
![zh-cn_image_0000001166193504](figures/zh-cn_image_0000001166193504.png)
启动烧录后，界面提示如下信息时，表示烧录成功。
12. 重新上电后，界面提示如下信息时，表示烧录成功。
![zh-cn_image_0000001165701218](figures/zh-cn_image_0000001165701218.png)
![zh-cn_image_0000001160649343](figures/zh-cn_image_0000001160649343.png)
13. 烧录完成后，请根据标准系统镜像运行进行下一步操作，完成系统启动。
10. 烧录成功后，请根据镜像运行章节进行操作，启动系统。
zh-cn/device-dev/quick-start/quickstart-ide-standard-running-hi3516-running.md
浏览文件 @ eb190501
......@@ -9,10 +9,10 @@
> 初次烧写标准系统，需要完成以下配置，后续烧写或者启动，可以跳过以下操作。
1. 在DevEco Device Tool中，点击Monitor，打开串口工具。
![zh-cn_image_0000001262772247](figures/zh-cn_image_0000001262772247.png)
![zh-cn_image_0000001227082162](figures/zh-cn_image_0000001227082162.png)
2. 重启开发板，在倒计时结束前，按任意键进入系统。
![zh-cn_image_0000001226448542](figures/zh-cn_image_0000001226448542.gif)
![zh-cn_image_0000001271202289](figures/zh-cn_image_0000001271202289.gif)
3. 通过以下两条命令设置启动参数。
......@@ -25,7 +25,7 @@
setenv bootcmd 'mmc read 0x0 0x82000000 0x800 0x4800; bootm 0x82000000'
```
![zh-cn_image_0000001262492295](figures/zh-cn_image_0000001262492295.png)
![zh-cn_image_0000001271562269](figures/zh-cn_image_0000001271562269.png)
4. 保存参数设置。
......@@ -33,7 +33,7 @@
save
```
![zh-cn_image_0000001262892233](figures/zh-cn_image_0000001262892233.png)
![zh-cn_image_0000001226762210](figures/zh-cn_image_0000001226762210.png)
5. 重启开发板，完成系统启动。
......@@ -41,14 +41,14 @@
reset
```
![zh-cn_image_0000001262492297](figures/zh-cn_image_0000001262492297.png)
![zh-cn_image_0000001226602238](figures/zh-cn_image_0000001226602238.png)
## 运行“Hello World”
设备启动后打开串口工具，在任意目录下输入命令helloworld后回车，界面打印“Hello World！”，程序运行成功。
![zh-cn_image_0000001263340273](figures/zh-cn_image_0000001263340273.png)
![zh-cn_image_0000001271322277](figures/zh-cn_image_0000001271322277.png)
## 下一步
......
zh-cn/device-dev/quick-start/quickstart-ide-standard-running-rk3568-build.md
浏览文件 @ eb190501
......@@ -21,6 +21,6 @@
![zh-cn_image_0000001265516901](figures/zh-cn_image_0000001265516901.png)
5. 等待编译完成，在**TERMINAL**窗口输出“SUCCESS”，编译完成。
![zh-cn_image_0000001221946522](figures/zh-cn_image_0000001221946522.png)
![zh-cn_image_0000001222361042](figures/zh-cn_image_0000001222361042.png)
编译完成后，可以在工程的**out**目录下，查看编译生成的文件，用于后续的[RK3568开发板烧录](../quick-start/quickstart-ide-standard-running-rk3568-burning.md)。
编译完成后，可以在工程的**out**目录下，查看编译生成的文件，用于后续的[RK3568开发板烧录](https://device.harmonyos.com/cn/docs/documentation/guide/ide-rk3568-upload-0000001239220669)。
zh-cn/device-dev/quick-start/quickstart-ide-standard-running-rk3568-burning.md
浏览文件 @ eb190501
# 烧录
当前DevEco Device Tool Ubuntu版本尚不支持，需要采用Windows版本的DevEco Device Tool进行烧录。具体操作如下：
1. [下载](https://gitee.com/hihope_iot/docs/blob/master/HiHope_DAYU200/%E7%83%A7%E5%86%99%E5%B7%A5%E5%85%B7%E5%8F%8A%E6%8C%87%E5%8D%97/windows/DriverAssitant_v5.1.1.zip)并安装驱动DriverInstall.exe，双击DriverInstall.exe打开安装程序，点击“驱动安装”按钮，按提示安装USB驱动。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果已经安装旧版本的烧写工具，请先点击"驱动卸载"按钮卸载驱动，然后再点击"驱动安装"按钮安装驱动。
2. 请连接好电脑和待烧录开发板，连接USB接口。
1. 安装DevEco Device Tool Windows版本，详细操作请参考[DevEco Device Tool Windows版本安装](https://device.harmonyos.com/cn/docs/documentation/guide/ide-install-windows-0000001050164976)。
3. 在DevEco Device Tool中，选择REMOTE DEVELOPMENT &gt; Local PC，查看远程计算机（Ubuntu开发环境）与本地计算机（Windows开发环境）的连接状态。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261315939](figures/zh-cn_image_0000001261315939.png)，则远程计算机与本地计算机为已连接状态，不需要执行其他操作。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261515989](figures/zh-cn_image_0000001261515989.png)，则点击绿色连接进行按钮。
2. [下载](https://gitee.com/hihope_iot/docs/blob/master/HiHope_DAYU200/%E7%83%A7%E5%86%99%E5%B7%A5%E5%85%B7%E5%8F%8A%E6%8C%87%E5%8D%97/windows/DriverAssitant_v5.1.1.zip)并安装驱动DriverInstall.exe，双击DriverInstall.exe打开安装程序，点击“驱动安装”按钮，按提示安装USB驱动。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果已经安装旧版本的烧写工具，请先点击"驱动卸载"按钮卸载驱动，然后再点击"驱动安装"按钮安装驱动。
![zh-cn_image_0000001261395999](figures/zh-cn_image_0000001261395999.png)
3. 请连接好电脑和待烧录开发板，连接USB接口。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 该操作仅在远程模式（Windows+Ubuntu混合开发环境）中需要设置，如果采用本地模式（Windows开发环境或Ubuntu开发环境），则请跳过该步骤。
4. 打开DevEco Device Tool，在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001239661509](figures/zh-cn_image_0000001239661509.png)
......
zh-cn/device-dev/quick-start/quickstart-ide-standard-running-rk3568-running.md
浏览文件 @ eb190501
......@@ -6,13 +6,13 @@
镜像烧录完成重启开发板后，系统将会自动启动。开发板附带的屏幕呈现以下界面，表明系统已运行成功。
**图1** 系统启动效果图
![zh-cn_image_0000001262772249](figures/zh-cn_image_0000001262772249.jpg)
![zh-cn_image_0000001226762222](figures/zh-cn_image_0000001226762222.jpg)
## 运行“Hello World”
1. 设备启动后打开串口工具（以putty为例），波特率设置为1500000，连接设备。
![zh-cn_image_0000001263341883](figures/zh-cn_image_0000001263341883.png)
![zh-cn_image_0000001226602250](figures/zh-cn_image_0000001226602250.png)
2. 打开串口后，在任意目录（以设备根目录为例）下输入命令helloworld后回车，界面打印“Hello World！”，程序运行成功。
![zh-cn_image_0000001263141841](figures/zh-cn_image_0000001263141841.png)
![zh-cn_image_0000001226922154](figures/zh-cn_image_0000001226922154.png)
zh-cn/device-dev/quick-start/quickstart-ide-standard-sourcecode-acquire.md
浏览文件 @ eb190501
# 获取源码
在Ubuntu环境下通过以下步骤拉取OpenHarmony源码。
## 前提条件
1. 注册码云gitee帐号。
......@@ -31,7 +34,7 @@
5. 安装码云repo工具，可以执行如下命令。
```
curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo #如果没有权限，可下载至其他目录，并将其配置到环境变量中
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o /usr/local/bin/repo #如果没有权限，可下载至其他目录，并将其配置到环境变量中
chmod a+x /usr/local/bin/repo
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests
```
......
zh-cn/device-dev/quick-start/quickstart-lite-env-setup.md
浏览文件 @ eb190501
......@@ -3,15 +3,21 @@
## 系统要求
- Ubuntu18及以上版本，内存推荐16GB及以上。
- Windows系统要求：Windows10 64位系统。
- 系统的用户名不能含有中文字符。
- Ubuntu系统要求：Ubuntu18.04及以上版本，内存推荐16 GB及以上。
- Ubuntu下只能使用普通用户角色安装DevEco Device Tool。
- Windows系统和Ubuntu系统的用户名不能包含中文字符。
- Windows和Ubuntu上安装的DevEco Device Tool为3.0 Release版本。
## 安装必要的库和工具
编译OpenHarmony需要一些库和工具，可以通过以下步骤进行安装。
相应操作在Ubuntu环境中进行。
1. 使用如下apt-get命令安装后续操作所需的库和工具：
```
......@@ -23,7 +29,7 @@
>
> - Python要求安装Python 3.8及以上版本，此处以Python 3.8为例。
>
> - java要求java8及以上版本，此处以java8为例。
> - Java要求java8及以上版本，此处以java8为例。
2. 将python 3.8设置为默认python版本。
查看python 3.8的位置：
......@@ -43,14 +49,49 @@
## 安装DevEco Device Tool
DevEco Device Tool Ubuntu版本是OpenHarmony的一站式开发工具，支持源码开发、编译、烧录，调测等，本文主要用其进行烧录和运行。下文介绍如何安装DevEco Device Tool。
通过Windows系统远程访问Ubuntu环境进行烧录等操作，需要先在Windows和Ubuntu下分别安装DevEco Device Tool。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> DevEco Device Tool基于Visual Studio Code进行扩展，在Visual Studio Code上以插件方式运行，Visual Studio Code版本为1.62及以上。同时，DevEco Device Tool还依赖Python工具，并要求Python为3.8~3.9版本。
>
> 在安装过程中，DevEco Device Tool会自动检查Visual Studio Code和Python，如果检测到Visual Studio Code、Python未安装或版本不符合要求，安装程序会自动安装Visual Studio Code和Python。
> DevEco Device Tool是OpenHarmony的一站式开发工具，支持源码开发、编译、烧录，调测等，本文主要用其远端连接Ubuntu环境进行烧录和运行。
### 安装Window版本DevEco Device Tool
1. 下载[DevEco Device Tool 3.0 Release](https://device.harmonyos.com/cn/ide#download)Windows版。
2. 解压DevEco Device Tool压缩包，双击安装包程序，点击Next进行安装。
3. 设置DevEco Device Tool的安装路径，建议安装到非系统盘符，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果您已安装DevEco Device Tool 3.0 Beta2及以前的版本，则在安装新版本时，会先卸载旧版本，卸载过程中出现如下错误提示时，请点击“Ignore”继续安装，该错误不影响新版本的安装。
>
> ![zh-cn_image_0000001239275843](figures/zh-cn_image_0000001239275843.png)
![zh-cn_image_0000001270076961](figures/zh-cn_image_0000001270076961.png)
4. 根据安装向导提示，勾选要自动安装的软件。
1. 在弹出VSCode installation confirm页面，勾选“Install VScode 1.62.2automatically”，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果检测到Visual Studio Code已安装，且版本为1.62及以上，则会跳过该步骤。
![zh-cn_image_0000001237801283](figures/zh-cn_image_0000001237801283.png)
2. 在弹出的Python select page选择“Download from Huawei mirror”，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果系统已安装可兼容的Python版本（Python 3.8~3.9版本），可选择“Use one of compatible on your PC”。
![zh-cn_image_0000001193983334](figures/zh-cn_image_0000001193983334.png)
5. 在以下界面点击**Next**，进行软件下载和安装。
![zh-cn_image_0000001239634067](figures/zh-cn_image_0000001239634067.png)
6. 继续等待DevEco Device Tool安装向导自动安装DevEco Device Tool插件，直至安装完成，点击**Finish**，关闭DevEco Device Tool安装向导。
![zh-cn_image_0000001239650137](figures/zh-cn_image_0000001239650137.png)
7. 打开Visual Studio Code，进入DevEco Device Tool工具界面。至此，DevEco Device Tool Windows开发环境安装完成。
![zh-cn_image_0000001225760456](figures/zh-cn_image_0000001225760456.png)
### 安装Ubuntu版本DevEco Device Tool
1. 将Ubuntu Shell环境修改为bash。
1. 执行如下命令，确认输出结果为bash。如果输出结果不是bash，请根据步骤2，将Ubuntu shell修改为bash。
......@@ -82,27 +123,102 @@ DevEco Device Tool Ubuntu版本是OpenHarmony的一站式开发工具，支持
chmod u+x devicetool-linux-tool-3.0.0.400.sh
```
4. 执行如下命令，安装DevEco Device Tool，其中devicetool-linux-tool-3.0.0.300.sh请根据实际进行修改。
4. 执行如下命令，安装DevEco Device Tool，其中devicetool-linux-tool-3.0.0.400.sh请根据实际进行修改。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 安装过程中，会自动检查Visual Studio Code和Python是否安装，且版本符合要求，其中Visual Studio Code为1.62及以上版本，Python为3.8~3.9版本。如果不满足，则安装过程中会自动安装，提示“Do you want to continue?”，请输入“Y”后继续安装。
> 安装过程中，会自动检查Python是否安装，且要求Python为3.8~3.9版本。如果不满足，则安装过程中会自动安装，提示“Do you want to continue?”，请输入“Y”后继续安装。
```
sudo ./devicetool-linux-tool-3.0.0.300.sh -- --install-plugins
sudo ./devicetool-linux-tool-3.0.0.300.sh
```
安装完成后，当界面输出“Deveco Device Tool successfully installed.”时，表示DevEco Device Tool安装成功。
![zh-cn_image_0000001243282363](figures/zh-cn_image_0000001243282363.png)
![zh-cn_image_0000001198722374](figures/zh-cn_image_0000001198722374.png)
## 配置Windows远程访问Ubuntu环境
5. 安装完成后，启动Visual Studio Code。
6. 打开Visual Studio Code，进入DevEco Device Tool工具界面。至此，DevEco Device Tool Ubuntu开发环境安装完成。
![zh-cn_image_0000001243284745](figures/zh-cn_image_0000001243284745.png)
### 安装SSH服务并获取远程访问的IP地址
1. 在Ubuntu系统中，打开终端工具，执行如下命令安装SSH服务。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果执行该命令失败，提示openssh-server和openssh-client依赖版本不同，请根据CLI界面提示信息，安装openssh-client相应版本后（例如：sudo apt-get install openssh-client=1:8.2p1-4），再重新执行该命令安装openssh-server。
```
sudo apt-get install openssh-server
```
2. 执行如下命令，启动SSH服务。
```
sudo systemctl start ssh
```
3. 执行如下命令，获取当前用户的IP地址，用于Windows系统远程访问Ubuntu环境。
```
ifconfig
```
![zh-cn_image_0000001215737140](figures/zh-cn_image_0000001215737140.png)
### 安装Remote SSH
1. 打开Windows系统下的Visual Studio Code，点击![zh-cn_image_0000001239080359](figures/zh-cn_image_0000001239080359.png)，在插件市场的搜索输入框中输入“remote-ssh”。
![zh-cn_image_0000001193920448](figures/zh-cn_image_0000001193920448.png)
2. 点击Remote-SSH的**Install**按钮，安装Remote-SSH。安装成功后，在**INSTALLED**下可以看到已安装Remote-SSH。
![zh-cn_image_0000001238880335](figures/zh-cn_image_0000001238880335.png)
### 远程连接Ubuntu环境
1. 打开Windows系统的Visual Studio Code，点击![zh-cn_image_0000001238760373](figures/zh-cn_image_0000001238760373.png)，在REMOTE EXOPLORER页面点击+按钮。
![zh-cn_image_0000001215878922](figures/zh-cn_image_0000001215878922.png)
2. 在弹出的SSH连接命令输入框中输入“ssh _username_\@_ip_address_”，其中ip_address为要连接的远程计算机的IP地址，username为登录远程计算机的帐号。
![zh-cn_image_0000001215879750](figures/zh-cn_image_0000001215879750.png)
3. 在弹出的输入框中，选择SSH configuration文件，选择默认的第一选项即可。
![zh-cn_image_0000001260519729](figures/zh-cn_image_0000001260519729.png)
4. 在SSH TARGETS中，找到远程计算机，点击![zh-cn_image_0000001194080414](figures/zh-cn_image_0000001194080414.png)，打开远程计算机。
![zh-cn_image_0000001215720398](figures/zh-cn_image_0000001215720398.png)
5. 在弹出的输入框中，选择**Linux**，然后在选择**Continue**，然后输入登录远程计算机的密码，连接远程计算机 。
![zh-cn_image_0000001215897530](figures/zh-cn_image_0000001215897530.png)
连接成功后，等待在远程计算机.vscode-server文件夹下自动安装插件，安装完成后，根据界面提示在Windows系统下重新加载Visual Studio Code，便可以在Windows的DevEco Device Tool界面进行源码开发、编译、烧录等操作。
### 注册访问Ubuntu环境的公钥
在完成以上操作后，您就可以通过Windows远程连接Ubuntu环境进行开发了，但在使用过程中，需要您频繁的输入远程连接密码来进行连接。为解决该问题，您可以使用SSH公钥来进行设置。
1. 打开Git bash命令行窗口，执行如下命令，生成SSH公钥，请注意，在执行命令过程中，请根据界面提示进行操作。username和ip请填写连接Ubuntu系统时需要的参数。
```
ssh-keygen -t rsa
ssh-copy-id -i ~/.ssh/id_rsa.pub username@ip
```
![zh-cn_image_0000001271532317](figures/zh-cn_image_0000001271532317.png)
2. 在Visual Studio Code中，点击远程连接的设置按钮，并选择打开config文件。
![zh-cn_image_0000001226034634](figures/zh-cn_image_0000001226034634.png)
3. 在config配置文件中添加SSK Key文件信息，如下图所示，然后保存即可。
![zh-cn_image_0000001270356233](figures/zh-cn_image_0000001270356233.png)
## 获取源码
在Ubuntu环境下通过以下步骤拉取OpenHarmony源码。
### 准备工作
......@@ -180,6 +296,8 @@ bash build/prebuilts_download.sh
想要详细了解OpenHarmony编译构建模块功能的开发者可参考[编译构建指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-build.md)。
相关操作在Ubuntu环境下进行。
### 安装hb
......
zh-cn/device-dev/quick-start/quickstart-lite-faq-burning.md
浏览文件 @ eb190501
......@@ -7,7 +7,7 @@
点击烧写并选择串口后，出现Error: Opening COMxx: Access denied。
**图1** 打开串口失败图
![zh-cn_image_0000001261257243](figures/zh-cn_image_0000001261257243.png)
![zh-cn_image_0000001226634728](figures/zh-cn_image_0000001226634728.png)
- **可能原因**
串口已经被占用。
......@@ -16,15 +16,15 @@
1. 按图依次选择下拉框，查找带有serial-xx的终端。
**图2** 查找是否存在占用串口的终端
![zh-cn_image_0000001261017289](figures/zh-cn_image_0000001261017289.png)
![zh-cn_image_0000001226954644](figures/zh-cn_image_0000001226954644.png)
2. 点击标号中的垃圾桶图标，关闭串口。
**图3** 关闭串口终端
![zh-cn_image_0000001261337297](figures/zh-cn_image_0000001261337297.png)
![zh-cn_image_0000001271234761](figures/zh-cn_image_0000001271234761.png)
3. 重新点击烧写，选择串口并开始烧写程序。
**图4** 重新启动烧写任务
![zh-cn_image_0000001216457428](figures/zh-cn_image_0000001216457428.png)
![zh-cn_image_0000001271594765](figures/zh-cn_image_0000001271594765.png)
## Windows电脑与单板网络连接失败
......@@ -33,7 +33,7 @@
点击烧写并选择串口后，无法获取文件。
**图5** 网络不通，单板无法获取文件图
![zh-cn_image_0000001261137233](figures/zh-cn_image_0000001261137233.png)
![zh-cn_image_0000001271234757](figures/zh-cn_image_0000001271234757.png)
- **可能原因**
单板网络与Windows电脑不联通。
......@@ -46,19 +46,19 @@
2. 点击Windows防火墙。
**图6** 网络防火墙设置图
![zh-cn_image_0000001216297444](figures/zh-cn_image_0000001216297444.png)
![zh-cn_image_0000001226634732](figures/zh-cn_image_0000001226634732.png)
3. 点击“允许应用通过防火墙”。
**图7** 防火墙和网络保护界面图
![zh-cn_image_0000001216617412](figures/zh-cn_image_0000001216617412.png)
![zh-cn_image_0000001271354749](figures/zh-cn_image_0000001271354749.png)
4. 查找Visual Studio Code应用。
**图8** 查找Visual Studio Code应用图
![zh-cn_image_0000001216777374](figures/zh-cn_image_0000001216777374.png)
![zh-cn_image_0000001271234765](figures/zh-cn_image_0000001271234765.png)
5. 勾选Visual Studio Code的专用和公用网络的访问权限。
**图9** 允许Visual Studio Code应用访问网络
![zh-cn_image_0000001261257245](figures/zh-cn_image_0000001261257245.png)
![zh-cn_image_0000001271474585](figures/zh-cn_image_0000001271474585.png)
## 烧写失败
......@@ -107,4 +107,4 @@
3. 烧写完成后，登录串口如下图所示。
**图10** U-boot烧写完成串口显示图
![zh-cn_image_0000001261337591](figures/zh-cn_image_0000001261337591.png)
![zh-cn_image_0000001271234753](figures/zh-cn_image_0000001271234753.png)
zh-cn/device-dev/quick-start/quickstart-lite-faq-compose.md
浏览文件 @ eb190501
......@@ -43,7 +43,7 @@
- **可能原因2**
usr/bin目录下没有python软链接
![zh-cn_image_0000001216297084](figures/zh-cn_image_0000001216297084.png)
![zh-cn_image_0000001271354745](figures/zh-cn_image_0000001271354745.png)
- **解决办法**
请运行以下命令添加软链接：
......@@ -58,13 +58,13 @@
例：
![zh-cn_image_0000001216617056](figures/zh-cn_image_0000001216617056.png)
![zh-cn_image_0000001227114636](figures/zh-cn_image_0000001227114636.png)
## 编译构建过程中，提示找不到“python3”
- **现象描述**
![zh-cn_image_0000001216777016](figures/zh-cn_image_0000001216777016.png)
![zh-cn_image_0000001227114640](figures/zh-cn_image_0000001227114640.png)
- **可能原因**
没有装python3。
......@@ -152,7 +152,7 @@
通过网页[https://pypi.org/project/pycrypto/#files](https://pypi.org/project/pycrypto/#files)，下载源码。
![zh-cn_image_0000001261256889](figures/zh-cn_image_0000001261256889.png)
![zh-cn_image_0000001226794696](figures/zh-cn_image_0000001226794696.png)
将源码放置在Linux服务器中，解压，并安装“python3 setup.py install”。
......@@ -179,7 +179,7 @@
通过网页[https://pypi.org/project/ecdsa/#files](https://pypi.org/project/ecdsa/#files)，下载安装包。
![zh-cn_image_0000001261016931](figures/zh-cn_image_0000001261016931.png)
![zh-cn_image_0000001271594753](figures/zh-cn_image_0000001271594753.png)
将安装包放置Linux服务器中，并安装“pip3 install ecdsa-0.15-py2.py3-none-any.whl”。
......@@ -206,7 +206,7 @@
通过网页[https://pypi.org/project/six/#files](https://pypi.org/project/six/#files)，下载安装包。
![zh-cn_image_0000001261336945](figures/zh-cn_image_0000001261336945.png)
![zh-cn_image_0000001271474573](figures/zh-cn_image_0000001271474573.png)
将源码放置在Linux服务器中，并安装“pip3 install six-1.14.0-py2.py3-none-any.whl”。
......
zh-cn/device-dev/quick-start/quickstart-lite-introduction-hi3516.md
浏览文件 @ eb190501
......@@ -7,7 +7,7 @@ Hi3516DV300作为新一代行业专用Smart HD IP摄像机SOC，集成新一代I
**图1** Hi3516单板正面外观图
![zh-cn_image_0000001221018668](figures/zh-cn_image_0000001221018668.png)
![zh-cn_image_0000001271234773](figures/zh-cn_image_0000001271234773.png)
## 开发板规格
......
zh-cn/device-dev/quick-start/quickstart-lite-introduction-hi3861.md
浏览文件 @ eb190501
......@@ -6,13 +6,13 @@
Hi3861开发板是一片大约2cm\*5cm大小的开发板，是一款高度集成的2.4GHz WLAN SoC芯片，集成IEEE 802.11b/g/n基带和RF（Radio Frequency）电路。支持OpenHarmony，并配套提供开放、易用的开发和调试运行环境。
**图1** Hi3861开发板外观图
![zh-cn_image_0000001216224132](figures/zh-cn_image_0000001216224132.png)
![zh-cn_image_0000001271474569](figures/zh-cn_image_0000001271474569.png)
另外，Hi3861开发板还可以通过与Hi3861底板连接，扩充自身的外设能力，底板如下图所示。
**图2** Hi3861底板外观图
![zh-cn_image_0000001265778805](figures/zh-cn_image_0000001265778805.png)
![zh-cn_image_0000001226954632](figures/zh-cn_image_0000001226954632.png)
- RF电路包括功率放大器PA（Power Amplifier）、低噪声放大器LNA（Low Noise Amplifier）、RF Balun、天线开关以及电源管理等模块；支持20MHz标准带宽和5MHz/10MHz窄带宽，提供最大72.2Mbit/s物理层速率。
......@@ -23,7 +23,7 @@ Hi3861开发板是一片大约2cm\*5cm大小的开发板，是一款高度集成
- Hi3861芯片适用于智能家电等物联网智能终端领域。
**图3** Hi3861功能框图
![zh-cn_image_0000001260864075](figures/zh-cn_image_0000001260864075.png)
![zh-cn_image_0000001226794688](figures/zh-cn_image_0000001226794688.png)
## 资源和约束
......
zh-cn/device-dev/quick-start/quickstart-lite-overview.md
浏览文件 @ eb190501
......@@ -3,18 +3,30 @@
## 简介
OpenHarmony轻量和小型系统适用于内存较小的IOT设备。本文通过运行一个“Hello World”，可以让开发者快速熟悉OpenHarmony轻量和小型系统的环境搭建、编译、烧录、调测以及运行等。
OpenHarmony轻量和小型系统适用于内存较小的IOT设备（参考内存≥128KiB）。通过本文，开发者可以快速熟悉OpenHarmony标准系统的环境搭建、编译、烧录、调测以及运行“Hello World”等。
考虑到开发者的开发习惯，OpenHarmony为开发者提供了以下两种入门指导：
- IDE方式：完全采用IDE（Deveco Device Tool）进行一站式开发，编译依赖工具的安装及编译、烧录、运行都通过IDE进行操作。
- 安装包方式：通过命令行进行编译依赖工具的下载安装，编译操作也通过命令实现。烧录、运行等操作使用IDE。OpenHarmony还为开发者提供了[Docker环境](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/get-code/gettools-acquire.md)，在很大程度上简化了编译前的环境配置，习惯使用安装包方式的开发者也可以选择Docker环境进行编译 。
本文采用安装包方式进行介绍，习惯使用Deveco Device Tool的开发者可参考[标准系统快速入门（IDE方式）](../quick-start/quickstart-ide-standard-overview.md)。
## 开发环境
因当前OpenHarmony不支持在Windows下进行编译，标准系统的开发有以下两种方法，开发者可根据使用习惯进行选择：
开发者通常习惯采用Windows+Ubuntu环境进行OpenHarmony开发：
- 用Linux环境进行开发、编译和烧录。
- Windows：用于源码开发、烧录等。
- 用Windows环境进行开发和烧录，使用Linux环境进行编译。
- Ubuntu：用于源码编译。
本文将介绍第一种方法，相关操作均在Linux环境下进行。使用第二种方式的开发者可参考[Deveco Device Tool使用指导](https://device.harmonyos.com/cn/docs/documentation/guide/service_introduction-0000001050166905)。
本文将介绍如何基于Windows+Ubuntu环境进行OpenHarmony的开发。
## 开发板
......@@ -27,4 +39,4 @@ OpenHarmony轻量和小型系统适用于内存较小的IOT设备。本文通过
轻量和小型系统快速入门流程如下图所示。
**图1** 轻量和小型系统快速入门开发流程
![zh-cn_image_0000001218438670](figures/zh-cn_image_0000001218438670.png)
![zh-cn_image_0000001227114628](figures/zh-cn_image_0000001227114628.png)
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3516-building.md
浏览文件 @ eb190501
......@@ -38,7 +38,7 @@ OpenHarmony支持hb和build.sh两种编译方式。此处介绍hb方式，build.
**图1** Hi3516编译设置图例
![zh-cn_image_0000001215744208](figures/zh-cn_image_0000001215744208.png)
![zh-cn_image_0000001271594749](figures/zh-cn_image_0000001271594749.png)
5. 编译结束后，出现“build success”字样，则证明构建成功。
> ![icon-notice.gif](public_sys-resources/icon-notice.gif) **须知：**
......@@ -46,4 +46,4 @@ OpenHarmony支持hb和build.sh两种编译方式。此处介绍hb方式，build.
>
> - 编译结果文件及日志文件：out/hispark_taurus/ipcamera_hispark_taurus。
>
> - U-boot文件：device/hisilicon/hispark_taurus/sdk_liteos/uboot/out/boot/u-boot-hi3516dv300.bin。
> - U-boot文件：device/board/hisilicon/hispark_taurus/uboot/out/boot/u-boot-hi3516dv300.bin。
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3516-burn.md
浏览文件 @ eb190501
# 烧录
Hi3516DV300支持USB烧录、网口烧录和串口烧录三种方式，本文以Linux下的网口烧录方式为例进行介绍。
Hi3516DV300支持USB烧录、网口烧录和串口烧录三种方式，本文采用USB方式进行烧录。相关操作在Windows环境下进行 。
1. 请连接好电脑和待烧录开发板，需要同时连接串口、网口和电源，具体可参考[Hi3516DV300开发板介绍](https://device.harmonyos.com/cn/docs/documentation/guide/quickstart-lite-introduction-hi3516-0000001152041033)。
### 导入源码
2. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
![zh-cn_image_0000001216516128](figures/zh-cn_image_0000001216516128.png)
在编译完成后，[保证Windows系统可以远程访问Ubuntu环境](../quick-start/quickstart-lite-env-setup.md#安装deveco-device-tool)的情况下，您还需要通过以下步骤导入源码后，方可进行烧录。
1. 打开DevEco Device Tool，进入Home页，点击**Import Project**打开工程。
![zh-cn_image_0000001171426014](figures/zh-cn_image_0000001171426014.png)
2. 选择要导入的源码目录（需要访问Ubuntu下的源码目录），点击**Import**打开。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果对应的串口异常，请根据[Hi3516DV300/Hi3518EV300开发板串口驱动安装指导](https://device.harmonyos.com/cn/docs/documentation/guide/hi3516_hi3518-drivers-0000001050743695)安装USB转串口的驱动程序。
> 工程存储路径不能包含中文字符、空格。如果工程存储路径包含中文字符或空格，可能导致编译失败。
3. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001198567426](figures/zh-cn_image_0000001198567426.png)
![zh-cn_image_0000001271791385](figures/zh-cn_image_0000001271791385.png)
4. 在“hi3516dv300”页签，设置烧录选项，包括upload_partitions、upload_port和upload_protocol。
- upload_partitions：选择待烧录的文件，默认情况下会同时烧录fastboot、kernel、rootfs和userfs。
- upload_port：选择已查询的串口号。
- upload_protocol：选择烧录协议，固定选择“hiburn-net”。
3. 如果您打开的目录不是DevEco Device Tool工程，则会出现如下提示框，点击**Import**。
![zh-cn_image_0000001135394334](figures/zh-cn_image_0000001135394334.png)
4. 在Select Project type界面，选择**Import from OpenHarmony Source**。
![zh-cn_image_0000001215743910](figures/zh-cn_image_0000001215743910.png)
5. 在Import Project界面，选择**Product**后，会自动填充对应的MCU、Board、company和kernel信息，然后**ohosVersion**选择对应的OpenHarmony源码版本。此处选择ipcamera_hispark_taurus。
![zh-cn_image_0000001227711014](figures/zh-cn_image_0000001227711014.png)
![zh-cn_image_0000001243568557](figures/zh-cn_image_0000001243568557.png)
6. 点击**Open**打开工程或源码。
5. 检查和设置连接开发板后的网络适配器的IP地址信息，设置方法请参考[设置Hi3516DV300网口烧录的IP地址信息](https://device.harmonyos.com/cn/docs/documentation/guide/set_ipaddress-0000001141825075)。
6. 设置网口烧录的IP地址信息，设置如下选项：
- upload_net_server_ip：选择步骤6中设置的IP地址信息。例如192.168.1.2
- upload_net_client_mask：设置开发板的子网掩码，工具会自动根据选择的upload_net_server_ip进行设置。例如255.255.255.0
- upload_net_client_gw：设置开发板的网关，工具会自动根据选择的upload_net_server_ip进行设置。例如192.168.1.1
- upload_net_client_ip：设置开发板的IP地址，工具会自动根据选择的upload_net_server_ip进行设置。例如192.168.1.3
### 烧录
![zh-cn_image_0000001153577284](figures/zh-cn_image_0000001153577284.png)
完成源码导入后，通过以下步骤进行烧录：
7. 分别检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。待烧录文件包括：fastboot、kernel、rootfs和userfs。
1. 请连接好电脑和待烧录开发板，需要同时连接串口和USB口，具体可参考[Hi3516DV300开发板介绍](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-lite-introduction-hi3516.md)。
2. 在DevEco Device Tool中，选择REMOTE DEVELOPMENT &gt; Local PC，查看远程计算机（Ubuntu开发环境）与本地计算机（Windows开发环境）的连接状态。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261315939](figures/zh-cn_image_0000001261315939.png)，则远程计算机与本地计算机为已连接状态，不需要执行其他操作。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261515989](figures/zh-cn_image_0000001261515989.png)，则点击绿色连接进行按钮。
![zh-cn_image_0000001261395999](figures/zh-cn_image_0000001261395999.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 该操作仅在远程模式（Windows+Ubuntu混合开发环境）中需要设置，如果采用本地模式（Windows开发环境或Ubuntu开发环境），则请跳过该步骤。
3. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
![zh-cn_image_0000001216516128](figures/zh-cn_image_0000001216516128.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果对应的串口异常，请根据[Hi3516DV300/Hi3518EV300开发板串口驱动安装指导](https://device.harmonyos.com/cn/docs/documentation/guide/hi3516_hi3518-drivers-0000001050743695)安装USB转串口的驱动程序。
4. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001198566364](figures/zh-cn_image_0000001198566364.png)
5. 在“hi3516dv300”页签，设置烧录选项，包括upload_partitions、upload_port和upload_protocol。
- upload_partitions：选择待烧录的文件，默认情况下会同时烧录fastboot、kernel、rootfs和userfs。
- upload_port：选择已查询到的串口号。
- upload_protocol：选择烧录协议，固定选择“hiburn-usb”。
![zh-cn_image_0000001223190441](figures/zh-cn_image_0000001223190441.png)
6. 分别检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。待烧录文件包括：fastboot、kernel、rootfs和userfs。
1. 在“hi3516dv300_fastboot”页签，在New Option选项中选择需要修改的项，例如partition_bin（烧录文件路径）、partition_addr（烧录文件起始地址）、partition_length（烧录文件分区长度）等。
![zh-cn_image_0000001198889702](figures/zh-cn_image_0000001198889702.png)
2. 然后在Partition Options中，分别修改上述步骤中选择的修改项。
......@@ -42,15 +70,19 @@ Hi3516DV300支持USB烧录、网口烧录和串口烧录三种方式，本文以
![zh-cn_image_0000001243290907](figures/zh-cn_image_0000001243290907.png)
3. 按照相同的方法修改kernel、rootfs和userfs的烧录文件信息。
8. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
7. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
8. 点击hi3516dv300下的**Upload**按钮，启动烧录。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果您是第一次在工作台烧录Hi3516DV300/Hi3518EV300开发板，可能烧录失败，提示“not find the Devices”，然后根据[Hi3516DV300/Hi3518EV300开发板USB驱动安装](https://device.harmonyos.com/cn/docs/documentation/guide/usb_driver-0000001058690393)进行处理后再重新烧录。
![zh-cn_image_0000001267231481](figures/zh-cn_image_0000001267231481.png)
9. 点击**Open**打开工程文件，然后在“PROJECT TASKS”中，点击hi3516dv300下的**Upload**按钮，启动烧录。
![zh-cn_image_0000001211275515](figures/zh-cn_image_0000001211275515.png)
9. 在终端窗口显示如下提示信息时，按住复位键，插拔USB线，最后松开复位键启动烧录。
![zh-cn_image_0000001114129426](figures/zh-cn_image_0000001114129426.png)
10. 启动烧录后，显示如下提示信息时，请插拔USB线。
![zh-cn_image_0000001166193504](figures/zh-cn_image_0000001166193504.png)
启动烧录后，界面提示如下信息时，表示烧录成功。
11. 重新上电后，界面提示如下信息时，表示烧录成功。
![zh-cn_image_0000001165701218](figures/zh-cn_image_0000001165701218.png)
![zh-cn_image_0000001160649343](figures/zh-cn_image_0000001160649343.png)
12. 烧录成功后，请根据镜像运行章节进行操作，启动系统。
10. 烧录成功后，请根据镜像运行章节进行操作，启动系统。
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3516-running.md
浏览文件 @ eb190501
......@@ -9,21 +9,21 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> DevEco Device Tool针对Hi3516DV300开发板的BootLoader设置进行了适配，无需开发者手动修改。
![zh-cn_image_0000001215904204](figures/zh-cn_image_0000001215904204.png)
![zh-cn_image_0000001209906547](figures/zh-cn_image_0000001209906547.png)
2. 提示如下图中的重启开发板的提示信息时，重启开发板，然后在控制台输出“SUCCESS”表示设置成功。
![zh-cn_image_0000001260664037](figures/zh-cn_image_0000001260664037.png)
![zh-cn_image_0000001210385161](figures/zh-cn_image_0000001210385161.png)
3. 在任务栏点击**Monitor**按钮，启动串口工具。
![zh-cn_image_0000001260944077](figures/zh-cn_image_0000001260944077.png)
![zh-cn_image_0000001164506870](figures/zh-cn_image_0000001164506870.png)
4. 当界面打印回显信息，点击Enter按钮，直到界面显示OHOS \#信息，表示系统启动成功。
![zh-cn_image_0000001260864089](figures/zh-cn_image_0000001260864089.png)
![zh-cn_image_0000001198626874](figures/zh-cn_image_0000001198626874.png)
## 运行“Hello World”
系统启动成功后，取out目录下的helloworld可执行文件放入系统的bin目录，通过以下步骤运行“Hello World”。
系统启动成功后，取源码out目录下的helloworld可执行文件放入系统的bin目录，通过以下步骤运行“Hello World”。
1. 在启动界面进入bin目录。
......@@ -39,9 +39,9 @@
界面打印“Hello World！”，程序运行成功。
![zh-cn_image_0000001263174047](figures/zh-cn_image_0000001263174047.png)
![zh-cn_image_0000001271234769](figures/zh-cn_image_0000001271234769.png)
## 下一步学习
恭喜您，已完成Hi3516的快速上手！建议您下一步进入[带屏摄像头产品开发](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/guide/device-camera.md)的学习 。
恭喜您，已完成Hi3516DV300的快速上手！建议您下一步进入[带屏摄像头产品开发](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/guide/device-camera.md)的学习 。
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3516-setting.md
浏览文件 @ eb190501
......@@ -27,4 +27,4 @@ Hi3516DV300开发板对Linux服务器通用环境配置需要的工具及其用
Hi3516DV300依赖以下工具：dosfstools、mtools、mtd-utils、Java运行时环境（JRE）和Java sdk 开发工具包。
上述工具已在[ERROR:Invalid link:zh-cn_topic_0000001260864065.xml#xref126711502449,link:zh-cn_topic_0000001215745332.xml#section69901514104616](zh-cn_topic_0000001215745332.xml#section69901514104616)环节完成安装，此处无需再进行安装。
上述工具已在[ERROR:Invalid link:zh-cn_topic_0000001226794684.xml#xref126711502449,link:zh-cn_topic_0000001215745332.xml#section69901514104616](zh-cn_topic_0000001215745332.xml#section69901514104616)环节完成安装，此处无需再进行安装。
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3816-running.md
浏览文件 @ eb190501
......@@ -16,4 +16,4 @@ wifi init success!
## 下一步学习
恭喜，您已完成Hi3861开发板快速上手！建议您下一步进入[WLAN产品开发](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/guide/device-wlan.md)的学习 。
恭喜，您已完成Hi3861 WLAN模组快速上手！建议您下一步进入[WLAN产品开发](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/guide/device-wlan.md)的学习 。
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3861-application-framework.md
浏览文件 @ eb190501
......@@ -39,7 +39,7 @@
3. 编写用于将业务构建成静态库的BUILD.gn文件。
新建./applications/sample/wifi-iot/app/my_first_app下的BUILD.gn文件，并完成如下配置。
如[ERROR:Invalid link:zh-cn_topic_0000001260944049.xml#xref7209204195912,link:#li5479332115116](#li5479332115116)所述，BUILD.gn文件由三部分内容（目标、源文件、头文件路径）构成，需由开发者完成填写。
如[ERROR:Invalid link:zh-cn_topic_0000001226794672.xml#xref7209204195912,link:#li5479332115116](#li5479332115116)所述，BUILD.gn文件由三部分内容（目标、源文件、头文件路径）构成，需由开发者完成填写。
```
......
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3861-building.md
浏览文件 @ eb190501
......@@ -4,7 +4,7 @@
OpenHarmony支持hb和build.sh两种编译方式。此处介绍hb方式，build.sh脚本编译方式请参考[使用build.sh脚本编译源码](../quick-start/quickstart-lite-reference.md#使用buildsh脚本编译源码)。
请进入源码根目录，执行如下命令进行编译：
在Ubuntu环境下进入源码根目录，执行如下命令进行编译：
1. 设置编译路径。
......@@ -37,7 +37,7 @@ OpenHarmony支持hb和build.sh两种编译方式。此处介绍hb方式，build.
```
**图1** Hi3861编译设置图例
![zh-cn_image_0000001260944057](figures/zh-cn_image_0000001260944057.png)
![zh-cn_image_0000001226634716](figures/zh-cn_image_0000001226634716.png)
5. 编译结束后，出现“build success”字样，则证明构建成功。
> ![icon-notice.gif](public_sys-resources/icon-notice.gif) **须知：**
......
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3861-burn.md
浏览文件 @ eb190501
# 烧录
Hi3861V100开发板支持串口烧录方式，以下是具体操作步骤：
在Windows下通过串口烧录Hi3861 WLAN模组。
### 导入源码
在编译完成后，[保证Windows系统可以远程访问Ubuntu环境](../quick-start/quickstart-lite-env-setup.md#安装deveco-device-tool)的情况下，您还需要通过以下步骤导入源码后，方可进行烧录。
1. 打开DevEco Device Tool，进入Home页，点击**Import Project**打开工程。
![zh-cn_image_0000001171426014](figures/zh-cn_image_0000001171426014.png)
2. 选择要导入的源码目录（需要访问Ubuntu下的源码目录），点击**Import**打开。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 工程存储路径不能包含中文字符、空格。如果工程存储路径包含中文字符或空格，可能导致编译失败。
![zh-cn_image_0000001227549226](figures/zh-cn_image_0000001227549226.png)
3. 如果您打开的目录不是DevEco Device Tool工程，则会出现如下提示框，点击**Import**。
![zh-cn_image_0000001135394334](figures/zh-cn_image_0000001135394334.png)
4. 在Select Project type界面，选择**Import from OpenHarmony Source**。
![zh-cn_image_0000001215743910](figures/zh-cn_image_0000001215743910.png)
5. 在Import Project界面，选择**Product**后，会自动填充对应的MCU、Board、company和kernel信息，然后**ohosVersion**选择对应的OpenHarmony源码版本。此处选择wifiiot_hispark_pegasus。
![zh-cn_image_0000001272109325](figures/zh-cn_image_0000001272109325.png)
6. 点击**Open**打开工程或源码。
### 烧录
完成源码导入后，通过以下步骤进行烧录：
1. 请连接好电脑和待烧录开发板，需要连接USB口，具体可参考[Hi3861V100开发板介绍](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-lite-introduction-hi3861.md)。
2. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
2. 在DevEco Device Tool中，选择REMOTE DEVELOPMENT &gt; Local PC，查看远程计算机（Ubuntu开发环境）与本地计算机（Windows开发环境）的连接状态。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261315939](figures/zh-cn_image_0000001261315939.png)，则远程计算机与本地计算机为已连接状态，不需要执行其他操作。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261515989](figures/zh-cn_image_0000001261515989.png)，则点击绿色连接进行按钮。
![zh-cn_image_0000001261395999](figures/zh-cn_image_0000001261395999.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 该操作仅在远程模式（Windows+Ubuntu混合开发环境）中需要设置，如果采用本地模式（Windows开发环境或Ubuntu开发环境），则请跳过该步骤。
3. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
![zh-cn_image_0000001216274840](figures/zh-cn_image_0000001216274840.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果对应的串口异常，请根据[Hi3861V100开发板串口驱动安装](https://device.harmonyos.com/cn/docs/documentation/guide/hi3861-drivers-0000001058153433)安装USB转串口的驱动程序。
3. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
4. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001198943768](figures/zh-cn_image_0000001198943768.png)
4. 在“hi3861”页签，设置烧录选项，包括upload_port、upload_protocol和upload_partitions。
5. 在“hi3861”页签，设置烧录选项，包括upload_port、upload_protocol和upload_partitions。
- upload_port：选择已查询的串口号。
- upload_protocol：选择烧录协议，选择“hiburn-serial”。
- upload_partitions：选择待烧录的文件，默认选择hi3861_app。
![zh-cn_image_0000001243704061](figures/zh-cn_image_0000001243704061.png)
5. 检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。
6. 检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。
在“hi3861_app”页签，在New Option选项中选择partition_bin（烧录文件路径），然后设置待烧录文件的地址。
![zh-cn_image_0000001260919759](figures/zh-cn_image_0000001260919759.png)
6. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
7. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
7. 点击**Open**打开工程文件，然后在“PROJECT TASKS”中，点击hi3861下的**Upload**按钮，启动烧录。
8. 点击**Open**打开工程文件，然后在“PROJECT TASKS”中，点击hi3861下的**Upload**按钮，启动烧录。
![zh-cn_image_0000001216440138](figures/zh-cn_image_0000001216440138.png)
8. 启动烧录后，显示如下提示信息时，请按开发板上的RST按钮重启开发板。
9. 启动烧录后，显示如下提示信息时，请按开发板上的RST按钮重启开发板。
![zh-cn_image_0000001198466090](figures/zh-cn_image_0000001198466090.png)
9. 重新上电后，界面提示如下信息时，表示烧录成功。
10. 重新上电后，界面提示如下信息时，表示烧录成功。
![zh-cn_image_0000001216761476](figures/zh-cn_image_0000001216761476.png)
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3861-debug.md
浏览文件 @ eb190501
......@@ -59,6 +59,6 @@ Call Stack end***
```
3. 根据以上调用栈信息，可以定位WadRecvCB函数中出现了异常。
![zh-cn_image_0000001215904184](figures/zh-cn_image_0000001215904184.png)
![zh-cn_image_0000001271354733](figures/zh-cn_image_0000001271354733.png)
4. 完成代码排查及修改。
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3861-netconfig.md
浏览文件 @ eb190501
# 联网
完成版本编译及烧录后，下面开始介绍如何在串口终端上执行AT命令，使WLAN模组联网。
完成版本编译及烧录后，下面开始介绍如何在串口终端上执行AT命令，使Hi3861 WLAN模组联网。
1. 保持Windows工作台和WLAN模组的连接状态，在DevEco工具最下方，点击“DevEco:Serial Monitor”按钮。
**图1** 打开DevEco串口终端示意图
![zh-cn_image_0000001260864081](figures/zh-cn_image_0000001260864081.png)
1. 保持Windows工作台和WLAN模组的连接状态，在DevEco Device Tool最下方，点击“DevEco:Serial Monitor”按钮。
**图1** 打开DevEco Device Tool串口终端示意图
![zh-cn_image_0000001227114644](figures/zh-cn_image_0000001227114644.png)
2. 复位Hi3861 WLAN模组，终端界面显示“ready to OS start”，则启动成功。
**图2** Hi3861 WLAN模组复位成功示意图
![zh-cn_image_0000001226794704](figures/zh-cn_image_0000001226794704.png)
3. 在串口终端中，依次执行如下AT命令，启动STA模式，连接指定AP热点，并开启DHCP功能。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 开发板启动后，串口会打印测试用例信息，待测试用例信息打印完成后再执行AT指令，否则AT指令会被测试用例信息覆盖。
2. 复位WLAN模组，终端界面显示“ready to OS start”，则启动成功。
**图2** WLAN复位成功示意图
![zh-cn_image_0000001215744204](figures/zh-cn_image_0000001215744204.png)
3. 在DevEco的串口终端中，依次执行如下AT命令，启动STA模式，连接指定AP热点，并开启DHCP功能。
```
AT+STARTSTA # 启动STA模式
......@@ -23,12 +27,12 @@
AT+DHCP=wlan0,1 # 通过DHCP向AP请求wlan0的IP地址
```
4. 查看WLAN模组与网关联通是否正常，如下图所示。
4. 查看Hi3861 WLAN模组与网关联通是否正常，如下图所示。
```
AT+IFCFG # 查看模组接口IP
AT+PING=X.X.X.X # 检查模组与网关的联通性，其中X.X.X.X需替换为实际的网关地址
```
**图3** WLAN模组联网成功示意图
![zh-cn_image_0000001260664029](figures/zh-cn_image_0000001260664029.png)
**图3** Hi3861 WLAN模组联网成功示意图
![zh-cn_image_0000001226954648](figures/zh-cn_image_0000001226954648.png)
zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3861-setting.md
浏览文件 @ eb190501
......@@ -30,7 +30,7 @@ Hi3861 WLAN模组需要的工具如下表所示。
## 安装编译工具
在Linux下安装以下编译构建工具。
编译Hi3861 WLAN模组需要一些特定的编译工具，在Ubuntu下通过以下步骤安装。
### 安装Scons
......@@ -48,7 +48,7 @@ Hi3861 WLAN模组需要的工具如下表所示。
```
**图1** SCons安装成功界面，版本要求3.0.4以上
![zh-cn_image_0000001216224128](figures/zh-cn_image_0000001216224128.png)
![zh-cn_image_0000001271234749](figures/zh-cn_image_0000001271234749.png)
### 安装python模块
......
zh-cn/device-dev/quick-start/quickstart-standard-board-introduction-hi3516.md
浏览文件 @ eb190501
......@@ -6,7 +6,7 @@
Hi3516DV300是新一代行业专用Smart HD IP摄像机SOC，集成新一代ISP(Image Signal Processor)、H.265视频压缩编码器、高性能NNIE引擎，在低码率、高画质、智能处理和分析、低功耗等方面引领行业水平。
**图1** Hi3516单板正面外观图
![zh-cn_image_0000001265778941](figures/zh-cn_image_0000001265778941.png)
![zh-cn_image_0000001226922318](figures/zh-cn_image_0000001226922318.png)
## 开发板规格
......
zh-cn/device-dev/quick-start/quickstart-standard-board-introduction-rk3568.md
浏览文件 @ eb190501
......@@ -6,10 +6,10 @@
RK3568开发板基于Rockchip RK3568芯片，集成双核心架构GPU以及高效能NPU；搭载四核64位Cortex-A55处理器，采用22nm先进工艺，主频高达2.0GHz；支持蓝牙、Wi-Fi、音频、视频和摄像头等功能，拥有丰富的扩展接口，支持多种视频输入输出接口；配置双千兆自适应RJ45以太网口，可满足NVR、工业网关等多网口产品需求。
**图1** RK3568开发板正面
![zh-cn_image_0000001260983187](figures/zh-cn_image_0000001260983187.png)
![zh-cn_image_0000001271442261](figures/zh-cn_image_0000001271442261.png)
**图2** RK3568开发板背面
![zh-cn_image_0000001216743266](figures/zh-cn_image_0000001216743266.png)
![zh-cn_image_0000001226602394](figures/zh-cn_image_0000001226602394.png)
## 开发板规格
......
zh-cn/device-dev/quick-start/quickstart-standard-env-setup.md
浏览文件 @ eb190501
......@@ -3,15 +3,21 @@
## 系统要求
- Ubuntu18及以上版本，内存推荐16GB及以上。
- Windows系统要求：Windows10 64位系统。
- 系统的用户名不能含有中文字符。
- Ubuntu系统要求：Ubuntu18.04及以上版本，内存推荐16 GB及以上。
- Ubuntu下只能使用普通用户角色安装DevEco Device Tool。
- Windows系统和Ubuntu系统的用户名不能包含中文字符。
- Windows和Ubuntu上安装的DevEco Device Tool为3.0 Release版本。
## 安装必要的库和工具
编译OpenHarmony需要一些库和工具，可以通过以下步骤进行安装。
相应操作在Ubuntu环境中进行。
1. 使用如下apt-get命令安装后续操作所需的库和工具：
```
......@@ -43,12 +49,49 @@
## 安装DevEco Device Tool
DevEco Device Tool Ubuntu版本是OpenHarmony的一站式开发工具，支持源码开发、编译、烧录，调测等，本文主要用其进行烧录和运行。下文介绍如何安装DevEco Device Tool。
通过Windows系统远程访问Ubuntu环境进行烧录等操作，需要先在Windows和Ubuntu下分别安装DevEco Device Tool。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> DevEco Device Tool基于Visual Studio Code进行扩展，在Visual Studio Code上以插件方式运行，Visual Studio Code版本为1.62及以上。同时，DevEco Device Tool还依赖Python工具，并要求Python为3.8~3.9版本。
>
> 在安装过程中，DevEco Device Tool会自动检查Visual Studio Code和Python，如果检测到Visual Studio Code、Python未安装或版本不符合要求，安装程序会自动安装Visual Studio Code和Python。
> DevEco Device Tool 是OpenHarmony的一站式开发工具，支持源码开发、编译、烧录，调测等，本文主要用其远端链接Ubuntu环境进行烧录和运行。
### 安装Window版本DevEco Device Tool
1. 下载[DevEco Device Tool 3.0 Release](https://device.harmonyos.com/cn/ide#download)Windows版。
2. 解压DevEco Device Tool压缩包，双击安装包程序，点击Next进行安装。
3. 设置DevEco Device Tool的安装路径，建议安装到非系统盘符，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果您已安装DevEco Device Tool 3.0 Beta2及以前的版本，则在安装新版本时，会先卸载旧版本，卸载过程中出现如下错误提示时，请点击“Ignore”继续安装，该错误不影响新版本的安装。
>
> ![zh-cn_image_0000001239275843](figures/zh-cn_image_0000001239275843.png)
![zh-cn_image_0000001270076961](figures/zh-cn_image_0000001270076961.png)
4. 根据安装向导提示，勾选要自动安装的软件。
1. 在弹出VSCode installation confirm页面，勾选“Install VScode 1.62.2automatically”，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果检测到Visual Studio Code已安装，且版本为1.62及以上，则会跳过该步骤。
![zh-cn_image_0000001237801283](figures/zh-cn_image_0000001237801283.png)
2. 在弹出的Python select page选择“Download from Huawei mirror”，点击**Next**。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果系统已安装可兼容的Python版本（Python 3.8~3.9版本），可选择“Use one of compatible on your PC”。
![zh-cn_image_0000001193983334](figures/zh-cn_image_0000001193983334.png)
5. 在以下界面点击**Next**，进行软件下载和安装。
![zh-cn_image_0000001239634067](figures/zh-cn_image_0000001239634067.png)
6. 继续等待DevEco Device Tool安装向导自动安装DevEco Device Tool插件，直至安装完成，点击**Finish**，关闭DevEco Device Tool安装向导。
![zh-cn_image_0000001239650137](figures/zh-cn_image_0000001239650137.png)
7. 打开Visual Studio Code，进入DevEco Device Tool工具界面。至此，DevEco Device Tool Windows开发环境安装完成。
![zh-cn_image_0000001225760456](figures/zh-cn_image_0000001225760456.png)
### 安装Ubuntu版本DevEco Device Tool
1. 将Ubuntu Shell环境修改为bash。
1. 执行如下命令，确认输出结果为bash。如果输出结果不是bash，请根据步骤2，将Ubuntu shell修改为bash。
......@@ -80,27 +123,102 @@ DevEco Device Tool Ubuntu版本是OpenHarmony的一站式开发工具，支持
chmod u+x devicetool-linux-tool-3.0.0.400.sh
```
4. 执行如下命令，安装DevEco Device Tool，其中devicetool-linux-tool-3.0.0.300.sh请根据实际进行修改。
4. 执行如下命令，安装DevEco Device Tool，其中devicetool-linux-tool-3.0.0.400.sh请根据实际进行修改。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 安装过程中，会自动检查Visual Studio Code和Python是否安装，且版本符合要求，其中Visual Studio Code为1.62及以上版本，Python为3.8~3.9版本。如果不满足，则安装过程中会自动安装，提示“Do you want to continue?”，请输入“Y”后继续安装。
> 安装过程中，会自动检查Python是否安装，且要求Python为3.8~3.9版本。如果不满足，则安装过程中会自动安装，提示“Do you want to continue?”，请输入“Y”后继续安装。
```
sudo ./devicetool-linux-tool-3.0.0.300.sh -- --install-plugins
sudo ./devicetool-linux-tool-3.0.0.300.sh
```
安装完成后，当界面输出“Deveco Device Tool successfully installed.”时，表示DevEco Device Tool安装成功。
![zh-cn_image_0000001243282363](figures/zh-cn_image_0000001243282363.png)
![zh-cn_image_0000001198722374](figures/zh-cn_image_0000001198722374.png)
## 配置Windows远程访问Ubuntu环境
### 安装SSH服务并获取远程访问的IP地址
1. 在Ubuntu系统中，打开终端工具，执行如下命令安装SSH服务。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果执行该命令失败，提示openssh-server和openssh-client依赖版本不同，请根据CLI界面提示信息，安装openssh-client相应版本后（例如：sudo apt-get install openssh-client=1:8.2p1-4），再重新执行该命令安装openssh-server。
```
sudo apt-get install openssh-server
```
2. 执行如下命令，启动SSH服务。
```
sudo systemctl start ssh
```
3. 执行如下命令，获取当前用户的IP地址，用于Windows系统远程访问Ubuntu环境。
```
ifconfig
```
![zh-cn_image_0000001215737140](figures/zh-cn_image_0000001215737140.png)
### 安装Remote SSH
1. 打开Windows系统下的Visual Studio Code，点击![zh-cn_image_0000001239080359](figures/zh-cn_image_0000001239080359.png)，在插件市场的搜索输入框中输入“remote-ssh”。
![zh-cn_image_0000001193920448](figures/zh-cn_image_0000001193920448.png)
2. 点击Remote-SSH的**Install**按钮，安装Remote-SSH。安装成功后，在**INSTALLED**下可以看到已安装Remote-SSH。
![zh-cn_image_0000001238880335](figures/zh-cn_image_0000001238880335.png)
### 远程连接Ubuntu环境
5. 安装完成后，启动Visual Studio Code。
1. 打开Windows系统的Visual Studio Code，点击![zh-cn_image_0000001238760373](figures/zh-cn_image_0000001238760373.png)，在REMOTE EXOPLORER页面点击+按钮。
![zh-cn_image_0000001215878922](figures/zh-cn_image_0000001215878922.png)
6. 打开Visual Studio Code，进入DevEco Device Tool工具界面。至此，DevEco Device Tool Ubuntu开发环境安装完成。
![zh-cn_image_0000001243284745](figures/zh-cn_image_0000001243284745.png)
2. 在弹出的SSH连接命令输入框中输入“ssh _username_\@_ip_address_”，其中ip_address为要连接的远程计算机的IP地址，username为登录远程计算机的帐号。
![zh-cn_image_0000001215879750](figures/zh-cn_image_0000001215879750.png)
3. 在弹出的输入框中，选择SSH configuration文件，选择默认的第一选项即可。
![zh-cn_image_0000001260519729](figures/zh-cn_image_0000001260519729.png)
4. 在SSH TARGETS中，找到远程计算机，点击![zh-cn_image_0000001194080414](figures/zh-cn_image_0000001194080414.png)，打开远程计算机。
![zh-cn_image_0000001215720398](figures/zh-cn_image_0000001215720398.png)
5. 在弹出的输入框中，选择**Linux**，然后在选择**Continue**，然后输入登录远程计算机的密码，连接远程计算机 。
![zh-cn_image_0000001215897530](figures/zh-cn_image_0000001215897530.png)
连接成功后，等待在远程计算机.vscode-server文件夹下自动安装插件，安装完成后，根据界面提示在Windows系统下重新加载Visual Studio Code，便可以在Windows的DevEco Device Tool界面进行源码开发、编译、烧录等操作。
### 注册访问Ubuntu环境的公钥
在完成以上操作后，您就可以通过Windows远程连接Ubuntu环境进行开发了，但在使用过程中，需要您频繁的输入远程连接密码来进行连接。为解决该问题，您可以使用SSH公钥来进行设置。
1. 打开Git bash命令行窗口，执行如下命令，生成SSH公钥，请注意，在执行命令过程中，请根据界面提示进行操作。username和ip请填写连接Ubuntu系统时需要的参数。
```
ssh-keygen -t rsa
ssh-copy-id -i ~/.ssh/id_rsa.pub username@ip
```
![zh-cn_image_0000001271532317](figures/zh-cn_image_0000001271532317.png)
2. 在Visual Studio Code中，点击远程连接的设置按钮，并选择打开config文件。
![zh-cn_image_0000001226034634](figures/zh-cn_image_0000001226034634.png)
3. 在config配置文件中添加SSK Key文件信息，如下图所示，然后保存即可。
![zh-cn_image_0000001270356233](figures/zh-cn_image_0000001270356233.png)
## 获取源码
在Ubuntu环境下通过以下步骤拉取OpenHarmony源码。
### 准备工作
......@@ -176,7 +294,7 @@ bash build/prebuilts_download.sh
## 安装编译工具
hb是OpenHarmony的编译工具，可通过以下步骤进行安装。想要详细了解OpenHarmony编译构建模块功能的开发者可参考[编译构建指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-build.md)。
hb是OpenHarmony的编译工具，可通过以下步骤在Ubuntu下进行安装。想要详细了解OpenHarmony编译构建模块功能的开发者可参考[编译构建指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-build.md)。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
......@@ -233,4 +351,4 @@ hb是OpenHarmony的编译工具，可通过以下步骤进行安装。想要详
> pip3 uninstall ohos-build
> ```
>
> - 若安装hb的过程中遇到问题，请参见下文[常见问题](../quick-start/quickstart-lite-faq-hb.md)进行解决。
> - 若安装hb的过程中遇到问题，请参见下文[常见问题](../quick-start/quickstart-standard-faq-hb.md)进行解决。
zh-cn/device-dev/quick-start/quickstart-standard-faq-burning.md
浏览文件 @ eb190501
......@@ -7,7 +7,7 @@
点击烧写并选择串口后，出现Error: Opening COMxx: Access denied。
**图1** 打开串口失败图
![zh-cn_image_0000001261257243](figures/zh-cn_image_0000001261257243.png)
![zh-cn_image_0000001271202461](figures/zh-cn_image_0000001271202461.png)
- **可能原因**
串口已经被占用。
......@@ -16,15 +16,15 @@
1. 按图依次选择下拉框，查找带有serial-xx的终端。
**图2** 查找是否存在占用串口的终端
![zh-cn_image_0000001261017289](figures/zh-cn_image_0000001261017289.png)
![zh-cn_image_0000001271202473](figures/zh-cn_image_0000001271202473.png)
2. 点击标号中的垃圾桶图标，关闭串口。
**图3** 关闭串口终端
![zh-cn_image_0000001261337297](figures/zh-cn_image_0000001261337297.png)
![zh-cn_image_0000001271202469](figures/zh-cn_image_0000001271202469.png)
3. 重新点击烧写，选择串口并开始烧写程序。
**图4** 重新启动烧写任务
![zh-cn_image_0000001216457428](figures/zh-cn_image_0000001216457428.png)
![zh-cn_image_0000001271562449](figures/zh-cn_image_0000001271562449.png)
## Windows电脑与单板网络连接失败
......@@ -33,7 +33,7 @@
点击烧写并选择串口后，无法获取文件。
**图5** 网络不通，单板无法获取文件图
![zh-cn_image_0000001261137233](figures/zh-cn_image_0000001261137233.png)
![zh-cn_image_0000001226922306](figures/zh-cn_image_0000001226922306.png)
- **可能原因**
单板网络与Windows电脑不联通。
......@@ -46,19 +46,19 @@
2. 点击Windows防火墙。
**图6** 网络防火墙设置图
![zh-cn_image_0000001216297444](figures/zh-cn_image_0000001216297444.png)
![zh-cn_image_0000001227082322](figures/zh-cn_image_0000001227082322.png)
3. 点击“允许应用通过防火墙”。
**图7** 防火墙和网络保护界面图
![zh-cn_image_0000001216617412](figures/zh-cn_image_0000001216617412.png)
![zh-cn_image_0000001271202457](figures/zh-cn_image_0000001271202457.png)
4. 查找Visual Studio Code应用。
**图8** 查找Visual Studio Code应用图
![zh-cn_image_0000001216777374](figures/zh-cn_image_0000001216777374.png)
![zh-cn_image_0000001271562445](figures/zh-cn_image_0000001271562445.png)
5. 勾选Visual Studio Code的专用和公用网络的访问权限。
**图9** 允许Visual Studio Code应用访问网络
![zh-cn_image_0000001261257245](figures/zh-cn_image_0000001261257245.png)
![zh-cn_image_0000001271442273](figures/zh-cn_image_0000001271442273.png)
## 烧写失败
......
zh-cn/device-dev/quick-start/quickstart-standard-faq-compose.md
浏览文件 @ eb190501
......@@ -43,7 +43,7 @@
- **可能原因2**
usr/bin目录下没有python软链接
![zh-cn_image_0000001216297084](figures/zh-cn_image_0000001216297084.png)
![zh-cn_image_0000001226922322](figures/zh-cn_image_0000001226922322.png)
- **解决办法**
请运行以下命令添加软链接：
......@@ -58,13 +58,13 @@
例：
![zh-cn_image_0000001216617056](figures/zh-cn_image_0000001216617056.png)
![zh-cn_image_0000001271562453](figures/zh-cn_image_0000001271562453.png)
## 编译构建过程中，提示找不到“python3”
- **现象描述**
![zh-cn_image_0000001216777016](figures/zh-cn_image_0000001216777016.png)
![zh-cn_image_0000001226602414](figures/zh-cn_image_0000001226602414.png)
- **可能原因**
没有装python3。
......@@ -152,7 +152,7 @@
通过网页[https://pypi.org/project/pycrypto/#files](https://pypi.org/project/pycrypto/#files)，下载源码。
![zh-cn_image_0000001261256889](figures/zh-cn_image_0000001261256889.png)
![zh-cn_image_0000001227082334](figures/zh-cn_image_0000001227082334.png)
将源码放置在Linux服务器中，解压，并安装“python3 setup.py install”。
......
zh-cn/device-dev/quick-start/quickstart-standard-overview.md
浏览文件 @ eb190501
......@@ -5,16 +5,25 @@
OpenHarmony标准系统适用于参考内存≥128MiB的设备。通过本文，开发者可以快速熟悉OpenHarmony标准系统的环境搭建、编译、烧录、调测以及运行“Hello World”等。
考虑到开发者的开发习惯，OpenHarmony为开发者提供了以下两种入门指导：
- IDE方式：完全采用IDE（Deveco Device Tool）进行一站式开发，编译依赖工具的安装及编译、烧录、运行都通过IDE进行操作。
- 安装包方式：通过命令行进行编译依赖工具的下载安装，编译操作也通过命令实现。烧录、运行等操作使用IDE。
OpenHarmony还为开发者提供了[Docker环境](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/get-code/gettools-acquire.md)，在很大程度上简化了编译前的环境配置，习惯使用安装包方式的开发者也可以选择Docker环境进行编译 。
本文采用安装包方式进行介绍，习惯使用Deveco Device Tool的开发者可参考[标准系统快速入门（IDE方式）](../quick-start/quickstart-ide-standard-overview.md)。
## 开发环境
因当前OpenHarmony不支持在Windows下进行编译，标准系统的开发有以下两种方法，开发者可根据使用习惯进行选择：
开发者通常习惯采用Windows+Ubuntu环境进行OpenHarmony开发：
- 用Linux环境进行开发、编译和烧录。
- Windows：用于源码开发、烧录等。
- 用Windows环境进行开发和烧录，使用Linux环境进行编译。
- Ubuntu：用于源码编译。
本文将介绍第一种方法，相关操作均在Linux环境下进行。使用第二种方式的开发者可参考[Deveco Device Tool使用指导](https://device.harmonyos.com/cn/docs/documentation/guide/service_introduction-0000001050166905)。
本文将介绍如何基于Windows+Ubuntu环境进行OpenHarmony的开发。
## 开发板
......@@ -27,4 +36,4 @@ OpenHarmony标准系统适用于参考内存≥128MiB的设备。通过本文，
标准系统快速入门流程如下图所示。
**图1** 标准系统快速入门开发流程
![zh-cn_image_0000001218442216](figures/zh-cn_image_0000001218442216.png)
![zh-cn_image_0000001227082314](figures/zh-cn_image_0000001227082314.png)
zh-cn/device-dev/quick-start/quickstart-standard-running-hi3516-build.md
浏览文件 @ eb190501
......@@ -4,7 +4,7 @@
OpenHarmony支持hb和build.sh两种编译方式。此处介绍hb方式，build.sh脚本编译方式请参考[使用build.sh脚本编译源码](../quick-start/quickstart-standard-reference.md#使用buildsh脚本编译源码)。
请进入源码根目录，执行如下命令进行编译：
在Ubuntu环境下进入源码根目录，执行如下命令进行编译：
1. 设置编译路径。
......@@ -38,7 +38,7 @@ OpenHarmony支持hb和build.sh两种编译方式。此处介绍hb方式，build.
**图1** Hi3516编译设置图例
![zh-cn_image_0000001218586756](figures/zh-cn_image_0000001218586756.png)
![zh-cn_image_0000001271562433](figures/zh-cn_image_0000001271562433.png)
5. 编译结束后，出现“build success”字样，则证明构建成功。
> ![icon-notice.gif](public_sys-resources/icon-notice.gif) **须知：**
......
zh-cn/device-dev/quick-start/quickstart-standard-running-hi3516-burning.md
浏览文件 @ eb190501
# 烧录
标准系统烧录，在DevEco Device Tool V2.2 Beta1及以上版本支持，下方烧录操作均在DevEco Device Tool中进行。
在Windows下采用USB烧录方式进行Hi3516DV300的烧录，具体步骤如下：
Hi3516DV300支持烧录标准系统，其烧录方式包括USB烧录、网口烧录和串口烧录三种方式。
### 导入源码
在编译完成后，[保证Windows系统可以远程访问Ubuntu环境](../quick-start/quickstart-standard-env-setup.md#安装deveco-device-tool)的情况下，您还需要通过以下步骤导入源码后，方可进行烧录。
下方以Linux系统网口烧录方式为例进行操作，其他两种烧录方式请参照[Hi3516DV300烧录指导](https://device.harmonyos.com/cn/docs/documentation/guide/ide-hi3516-upload-0000001052148681)。
1. 打开DevEco Device Tool，进入Home页，点击**Import Project**打开工程。
![zh-cn_image_0000001171426014](figures/zh-cn_image_0000001171426014.png)
2. 选择要导入的源码目录（需要访问Ubuntu下的源码目录），点击**Import**打开。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 工程存储路径不能包含中文字符、空格。如果工程存储路径包含中文字符或空格，可能导致编译失败。
![zh-cn_image_0000001227711882](figures/zh-cn_image_0000001227711882.png)
3. 如果您打开的目录不是DevEco Device Tool工程，则会出现如下提示框，点击**Import**。
![zh-cn_image_0000001135394334](figures/zh-cn_image_0000001135394334.png)
4. 在Select Project type界面，选择**Import from OpenHarmony Source**。
![zh-cn_image_0000001215743910](figures/zh-cn_image_0000001215743910.png)
5. 在Import Project界面，选择**Product**后，会自动填充对应的MCU、Board、company和kernel信息，然后**ohosVersion**选择对应的OpenHarmony源码版本。此处选择Hi3516DV300。
![zh-cn_image_0000001271912277](figures/zh-cn_image_0000001271912277.png)
6. 点击**Open**打开工程或源码。
### 烧录
完成源码导入后，通过以下步骤进行烧录：
1. 请连接好电脑和待烧录开发板，需要同时连接串口和USB口，具体可参考[Hi3516DV300开发板介绍](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-lite-introduction-hi3516.md)。
1. 请连接好电脑和待烧录开发板，需要同时连接串口、网口和电源，具体可参考[Hi3516DV300开发板介绍](https://device.harmonyos.com/cn/docs/documentation/guide/quickstart-lite-introduction-hi3516-0000001152041033)。
2. 在DevEco Device Tool中，选择REMOTE DEVELOPMENT &gt; Local PC，查看远程计算机（Ubuntu开发环境）与本地计算机（Windows开发环境）的连接状态。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261315939](figures/zh-cn_image_0000001261315939.png)，则远程计算机与本地计算机为已连接状态，不需要执行其他操作。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261515989](figures/zh-cn_image_0000001261515989.png)，则点击绿色连接进行按钮。
2. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
![zh-cn_image_0000001261395999](figures/zh-cn_image_0000001261395999.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 该操作仅在远程模式（Windows+Ubuntu混合开发环境）中需要设置，如果采用本地模式（Windows开发环境或Ubuntu开发环境），则请跳过该步骤。
3. 在DevEco Device Tool中，点击QUICK ACCESS &gt; DevEco Home &gt; Device，查看并记录对应的串口号。
![zh-cn_image_0000001216516128](figures/zh-cn_image_0000001216516128.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果对应的串口异常，请根据[Hi3516DV300/Hi3518EV300开发板串口驱动安装指导](https://device.harmonyos.com/cn/docs/documentation/guide/hi3516_hi3518-drivers-0000001050743695)安装USB转串口的驱动程序。
3. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001261703507](figures/zh-cn_image_0000001261703507.png)
4. 在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001198566364](figures/zh-cn_image_0000001198566364.png)
4. 在“hi3516dv300”页签，设置烧录选项，包括upload_partitions、upload_port和upload_protocol。
5. 在“hi3516dv300”页签，设置烧录选项，包括upload_partitions、upload_port和upload_protocol。
- upload_partitions：选择待烧录的文件，默认情况下会同时烧录fastboot、kernel、rootfs和userfs。
- upload_port：选择已查询的串口号。
- upload_protocol：选择烧录协议，固定选择“hiburn-net”。
![zh-cn_image_0000001217103686](figures/zh-cn_image_0000001217103686.png)
5. 检查和设置连接开发板后的网络适配器的IP地址信息，设置方法请参考[设置Hi3516DV300网口烧录的IP地址信息](https://device.harmonyos.com/cn/docs/documentation/guide/set_ipaddress-0000001141825075)。
- upload_port：选择已查询到的串口号。
- upload_protocol：选择烧录协议，固定选择“hiburn-usb”。
6. 设置网口烧录的IP地址信息，设置如下选项：
- upload_net_server_ip：选择步骤6中设置的IP地址信息。例如192.168.1.2
- upload_net_client_mask：设置开发板的子网掩码，工具会自动根据选择的upload_net_server_ip进行设置。例如255.255.255.0
- upload_net_client_gw：设置开发板的网关，工具会自动根据选择的upload_net_server_ip进行设置。例如192.168.1.1
- upload_net_client_ip：设置开发板的IP地址，工具会自动根据选择的upload_net_server_ip进行设置。例如192.168.1.3
![zh-cn_image_0000001223190441](figures/zh-cn_image_0000001223190441.png)
![zh-cn_image_0000001261823487](figures/zh-cn_image_0000001261823487.png)
7. 分别检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。待烧录文件包括：fastboot、kernel、rootfs和userfs。
6. 分别检查待烧录文件的烧录信息，DevEco Device Tool已预置默认的烧录文件信息，可根据实际情况进行调整。待烧录文件包括：fastboot、kernel、rootfs和userfs。
1. 在“hi3516dv300_fastboot”页签，在New Option选项中选择需要修改的项，例如partition_bin（烧录文件路径）、partition_addr（烧录文件起始地址）、partition_length（烧录文件分区长度）等。
![zh-cn_image_0000001198889702](figures/zh-cn_image_0000001198889702.png)
2. 然后在Partition Options中，分别修改上述步骤中选择的修改项。
......@@ -48,15 +70,19 @@ Hi3516DV300支持烧录标准系统，其烧录方式包括USB烧录、网口烧
![zh-cn_image_0000001243290907](figures/zh-cn_image_0000001243290907.png)
3. 按照相同的方法修改kernel、rootfs和userfs的烧录文件信息。
8. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
7. 所有的配置都修改完成后，在工程配置页签的顶部，点击**Save**进行保存。
8. 点击hi3516dv300下的**Upload**按钮，启动烧录。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果您是第一次在工作台烧录Hi3516DV300/Hi3518EV300开发板，可能烧录失败，提示“not find the Devices”，然后根据[Hi3516DV300/Hi3518EV300开发板USB驱动安装](https://device.harmonyos.com/cn/docs/documentation/guide/usb_driver-0000001058690393)进行处理后再重新烧录。
![zh-cn_image_0000001267231481](figures/zh-cn_image_0000001267231481.png)
9. 点击**Open**打开工程文件，然后在“PROJECT TASKS”中，点击hi3516dv300下的**Upload**按钮，启动烧录。
![zh-cn_image_0000001216943710](figures/zh-cn_image_0000001216943710.png)
9. 在终端窗口显示如下提示信息时，按住复位键，插拔USB线，最后松开复位键启动烧录。
![zh-cn_image_0000001114129426](figures/zh-cn_image_0000001114129426.png)
10. 启动烧录后，显示如下提示信息时，请重启开发板（下电再上电）。
![zh-cn_image_0000001217263670](figures/zh-cn_image_0000001217263670.png)
启动烧录后，界面提示如下信息时，表示烧录成功。
11. 重新上电后，界面提示如下信息时，表示烧录成功。
![zh-cn_image_0000001217423642](figures/zh-cn_image_0000001217423642.png)
![zh-cn_image_0000001160649343](figures/zh-cn_image_0000001160649343.png)
12. 烧录成功后，请根据[镜像运行](../quick-start/quickstart-standard-running-hi3516-running.md#启动系统)章节进行操作，启动系统。
10. 烧录成功后，请根据镜像运行章节进行操作，启动系统。
zh-cn/device-dev/quick-start/quickstart-standard-running-hi3516-running.md
浏览文件 @ eb190501
......@@ -3,16 +3,16 @@
## 启动系统
烧录完成后通过以下步骤启动系统：
烧录完成后在Windows下通过以下步骤启动系统：
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 初次烧写标准系统，需要完成以下配置，后续烧写或者启动，可以跳过以下操作。
1. 在DevEco Device Tool中，点击Monitor，打开串口工具。
![zh-cn_image_0000001216423310](figures/zh-cn_image_0000001216423310.png)
![zh-cn_image_0000001226762374](figures/zh-cn_image_0000001226762374.png)
2. 重启开发板，在倒计时结束前，按任意键进入系统。
![zh-cn_image_0000001270808457](figures/zh-cn_image_0000001270808457.gif)
![zh-cn_image_0000001271442265](figures/zh-cn_image_0000001271442265.gif)
3. 通过以下两条命令设置启动参数。
......@@ -25,7 +25,7 @@
setenv bootcmd 'mmc read 0x0 0x82000000 0x800 0x4800; bootm 0x82000000'
```
![zh-cn_image_0000001216263338](figures/zh-cn_image_0000001216263338.png)
![zh-cn_image_0000001271322437](figures/zh-cn_image_0000001271322437.png)
4. 保存参数设置。
......@@ -33,7 +33,7 @@
save
```
![zh-cn_image_0000001261103121](figures/zh-cn_image_0000001261103121.png)
![zh-cn_image_0000001271562437](figures/zh-cn_image_0000001271562437.png)
5. 重启开发板，完成系统启动。
......@@ -41,14 +41,14 @@
reset
```
![zh-cn_image_0000001216423308](figures/zh-cn_image_0000001216423308.png)
![zh-cn_image_0000001226762378](figures/zh-cn_image_0000001226762378.png)
## 运行“Hello World”
设备启动后打开串口工具，在任意目录下输入命令helloworld后回车，界面打印“Hello World！”，程序运行成功。
![zh-cn_image_0000001263341577](figures/zh-cn_image_0000001263341577.png)
![zh-cn_image_0000001226602398](figures/zh-cn_image_0000001226602398.png)
## 下一步
......
zh-cn/device-dev/quick-start/quickstart-standard-running-rk3568-build.md
浏览文件 @ eb190501
......@@ -4,7 +4,7 @@
OpenHarmony支持hb和build.sh两种编译方式。此处介绍hb方式，build.sh脚本编译方式请参考[使用build.sh脚本编译源码](../quick-start/quickstart-standard-reference.md#使用buildsh脚本编译源码)。
请进入源码根目录，执行如下命令进行编译：
在Ubuntu环境下进入源码根目录，执行如下命令进行编译：
1. 设置编译路径。
......@@ -38,7 +38,7 @@ OpenHarmony支持hb和build.sh两种编译方式。此处介绍hb方式，build.
**图1** RK3568编译设置图例
![zh-cn_image_0000001216583294](figures/zh-cn_image_0000001216583294.png)
![zh-cn_image_0000001226922302](figures/zh-cn_image_0000001226922302.png)
5. 编译结束后，出现“rk3568 build success”字样，则证明构建成功。
> ![icon-notice.gif](public_sys-resources/icon-notice.gif) **须知：**
......
zh-cn/device-dev/quick-start/quickstart-standard-running-rk3568-burning.md
浏览文件 @ eb190501
# 烧录
当前DevEco Device Tool Ubuntu版本尚不支持，需要采用Windows版本的DevEco Device Tool进行烧录。具体操作如下：
在Windows环境下通过以下步骤进行RK3568的烧录：
1. 安装DevEco Device Tool Windows版本，详细操作请参考[DevEco Device Tool Windows版本安装](https://device.harmonyos.com/cn/docs/documentation/guide/ide-install-windows-0000001050164976)。
### 导入源码
2. [下载](https://gitee.com/hihope_iot/docs/blob/master/HiHope_DAYU200/%E7%83%A7%E5%86%99%E5%B7%A5%E5%85%B7%E5%8F%8A%E6%8C%87%E5%8D%97/windows/DriverAssitant_v5.1.1.zip)并安装驱动DriverInstall.exe，双击DriverInstall.exe打开安装程序，点击“驱动安装”按钮，按提示安装USB驱动。
在编译完成后，[保证Windows系统可以远程访问Ubuntu环境](../quick-start/quickstart-standard-env-setup.md#安装deveco-device-tool)的情况下，您还需要通过以下步骤导入源码后，方可进行烧录。
1. 打开DevEco Device Tool，进入Home页，点击**Import Project**打开工程。
![zh-cn_image_0000001171426014](figures/zh-cn_image_0000001171426014.png)
2. 选择要导入的源码目录（需要访问Ubuntu下的源码目录），点击**Import**打开。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 工程存储路径不能包含中文字符、空格。如果工程存储路径包含中文字符或空格，可能导致编译失败。
![zh-cn_image_0000001272032361](figures/zh-cn_image_0000001272032361.png)
3. 如果您打开的目录不是DevEco Device Tool工程，则会出现如下提示框，点击**Import**。
![zh-cn_image_0000001135394334](figures/zh-cn_image_0000001135394334.png)
4. 在Select Project type界面，选择**Import from OpenHarmony Source**。
![zh-cn_image_0000001215743910](figures/zh-cn_image_0000001215743910.png)
5. 在Import Project界面，选择**Product**后，会自动填充对应的MCU、Board、company和kernel信息，然后**ohosVersion**选择对应的OpenHarmony源码版本。此处选择rk3568。
![zh-cn_image_0000001227712350](figures/zh-cn_image_0000001227712350.png)
6. 点击**Open**打开工程或源码。
### 烧录
完成源码导入后，通过以下步骤进行烧录：
1. [下载](https://gitee.com/hihope_iot/docs/blob/master/HiHope_DAYU200/%E7%83%A7%E5%86%99%E5%B7%A5%E5%85%B7%E5%8F%8A%E6%8C%87%E5%8D%97/windows/DriverAssitant_v5.1.1.zip)并安装驱动DriverInstall.exe，双击DriverInstall.exe打开安装程序，点击“驱动安装”按钮，按提示安装USB驱动。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 如果已经安装旧版本的烧写工具，请先点击"驱动卸载"按钮卸载驱动，然后再点击"驱动安装"按钮安装驱动。
3. 请连接好电脑和待烧录开发板，连接USB接口。
2. 请连接好电脑和待烧录开发板，连接USB接口。
3. 在DevEco Device Tool中，选择REMOTE DEVELOPMENT &gt; Local PC，查看远程计算机（Ubuntu开发环境）与本地计算机（Windows开发环境）的连接状态。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261315939](figures/zh-cn_image_0000001261315939.png)，则远程计算机与本地计算机为已连接状态，不需要执行其他操作。
- 如果Local PC右边连接按钮为![zh-cn_image_0000001261515989](figures/zh-cn_image_0000001261515989.png)，则点击绿色连接进行按钮。
![zh-cn_image_0000001261395999](figures/zh-cn_image_0000001261395999.png)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 该操作仅在远程模式（Windows+Ubuntu混合开发环境）中需要设置，如果采用本地模式（Windows开发环境或Ubuntu开发环境），则请跳过该步骤。
4. 打开DevEco Device Tool，在QUICK ACCESS &gt; DevEco Home &gt; Projects中，点击**Settings**打开工程配置界面。
![zh-cn_image_0000001239661509](figures/zh-cn_image_0000001239661509.png)
......
zh-cn/device-dev/quick-start/quickstart-standard-running-rk3568-running.md
浏览文件 @ eb190501
......@@ -6,13 +6,13 @@
镜像烧录完成重启开发板后，系统将会自动启动。开发板附带的屏幕呈现以下界面，表明系统已运行成功。
**图1** 系统启动效果图
![zh-cn_image_0000001261103119](figures/zh-cn_image_0000001261103119.jpg)
![zh-cn_image_0000001226602406](figures/zh-cn_image_0000001226602406.jpg)
## 运行“Hello World”
1. 设备启动后打开串口工具（以putty为例），波特率设置为1500000，连接设备。
![zh-cn_image_0000001260903193](figures/zh-cn_image_0000001260903193.png)
![zh-cn_image_0000001226922310](figures/zh-cn_image_0000001226922310.png)
2. 打开串口后，在任意目录（以设备根目录为例）下输入命令helloworld后回车，界面打印“Hello World！”，程序运行成功。
![zh-cn_image_0000001263021817](figures/zh-cn_image_0000001263021817.png)
![zh-cn_image_0000001271202465](figures/zh-cn_image_0000001271202465.png)
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或