1# Hi3516标准系统入门（命令行方式） 2 3>  **说明：** 4> 5> 从3.2版本起，标准系统不再针对Hi3516DV300进行适配验证，建议您使用RK3568进行标准系统的设备开发。 6> 7> 如您仍然需要使用Hi3516DV300进行标准系统相关开发操作，则可能会出现无法适配的现象，此时请联系芯片供应商获取相关适配指导，或自行完成适配。 8 9 10 11除小型系统外，Hi3516DV300开发板还支持标准系统。此章节简要介绍如何使用命令行在Hi3516DV300开发板上进行标准系统的开发。 12 13 14下方将展示如何在单板上运行第一个应用程序，其中包括新建应用程序、编译、烧写、运行等步骤，最终输出“Hello World！”。 15 16 17在进行开发之前，请首先完成[搭建开发环境](quickstart-pkg-prepare.md)。 18 19 20## 编写“Hello World”程序 21 22 23### 示例目录 24 25 26``` 27applications/sample/hello 28 │── BUILD.gn 29 │── include 30 │ └── helloworld.h 31 │── src 32 │ └── helloworld.c 33 ├── bundle.json 34 build 35 └── subsystem_config.json 36 vendor/hisilicon 37 └── Hi3516DV300 38 └── config.json 39``` 40 41 42### 开发步骤 43 44请在源码目录中通过以下步骤创建“Hello World”应用程序： 45 461. 创建目录，编写业务代码。 47 新建applications/sample/hello/src/helloworld.c目录及文件，代码如下所示，用户可以自定义修改打印内容（例如：修改World为OHOS）。其中helloworld.h包含字符串打印函数HelloPrint的声明。当前应用程序可支持标准C及C++的代码开发。 48 49 50 ``` 51 #include <stdio.h> 52 #include "helloworld.h" 53 int main(int argc, char **argv) 54 { 55 HelloPrint(); 56 return 0; 57 } 58 void HelloPrint() 59 { 60 printf("\n\n"); 61 printf("\n\t\tHello World!\n"); 62 printf("\n\n"); 63 } 64 ``` 65 66 再添加头文件applications/sample/hello/include/helloworld.h，代码如下所示。 67 68 69 ``` 70 #ifndef HELLOWORLD_H 71 #define HELLOWORLD_H 72 #ifdef __cplusplus 73 #if __cplusplus 74 extern "C" { 75 #endif 76 #endif 77 void HelloPrint(); 78 #ifdef __cplusplus 79 #if __cplusplus 80 } 81 #endif 82 #endif 83 #endif // HELLOWORLD_H 84 ``` 85 862. 新建编译组织文件。 87 1. 新建applications/sample/hello/BUILD.gn文件，内容如下所示： 88 89 ``` 90 import("//build/ohos.gni") # 导入编译模板 91 ohos_executable("helloworld") { # 可执行模块 92 sources = [ # 模块源码 93 "src/helloworld.c" 94 ] 95 include_dirs = [ # 模块依赖头文件目录 96 "include" 97 ] 98 cflags = [] 99 cflags_c = [] 100 cflags_cc = [] 101 ldflags = [] 102 configs = [] 103 deps =[] # 部件内部依赖 104 part_name = "hello" # 所属部件名称，必选 105 install_enable = true # 是否默认安装（缺省默认不安装），可选 106 } 107 ``` 108 2. 新建applications/sample/hello/bundle.json文件，添加sample部件描述，内容如下所示。 109 110 ``` 111 { 112 "name": "@ohos/hello", 113 "description": "Hello world example.", 114 "version": "3.1", 115 "license": "Apache License 2.0", 116 "publishAs": "code-segment", 117 "segment": { 118 "destPath": "applications/sample/hello" 119 }, 120 "dirs": {}, 121 "scripts": {}, 122 "component": { 123 "name": "hello", 124 "subsystem": "sample", 125 "syscap": [], 126 "features": [], 127 "adapted_system_type": [ "mini", "small", "standard" ], 128 "rom": "10KB", 129 "ram": "10KB", 130 "deps": { 131 "components": [], 132 "third_party": [] 133 }, 134 "build": { 135 "sub_component": [ 136 "//applications/sample/hello:helloworld" 137 ], 138 "inner_kits": [], 139 "test": [] 140 } 141 } 142 } 143 ``` 144 145 bundle.json文件包含两个部分，第一部分描述该部件所属子系统的信息，第二部分component则定义该部件构建相关配置。添加的时候需要指明该部件包含的模块sub_component，假如有提供给其它部件的接口，需要在inner_kits中说明，假如有测试用例，需要在test中说明，inner_kits与test没有也可以不添加。 146 1473. 修改子系统配置文件。 148 在build/subsystem_config.json中添加新建的子系统的配置。 149 150 151 ``` 152 "sample": { 153 "path": "applications/sample/hello", 154 "name": "sample" 155 }, 156 ``` 157 1584. 修改产品配置文件。 159 在vendor/hisilicon/Hi3516DV300/config.json中添加对应的hello部件，直接添加到原有部件后即可。 160 161 162 ``` 163 "usb:usb_manager_native":{}, 164 "applications:prebuilt_hap":{}, 165 "sample:hello":{}, 166 "wpa_supplicant-2.9:wpa_supplicant-2.9":{}, 167 ``` 168 169 170## 编译 171 172OpenHarmony支持hb和build.sh两种编译方式。此处介绍hb方式，build.sh脚本编译方式请参考[使用build.sh脚本编译源码](quickstart-pkg-common-build.md#使用buildsh脚本编译源码)。 173 174想要详细了解OpenHarmony编译构建模块功能的开发者可参考[编译构建指南](../subsystems/subsys-build-all.md)。 175 176 177### 前提条件 178 179- 已正确[安装库和工具集](quickstart-pkg-install-package.md)。 180 181- 已正确[安装编译工具](quickstart-pkg-install-tool.md)。 182 183- “Hello World”程序已编写完成。 184 185- 可正常登录Ubuntu环境。 186 187 188### 操作步骤 189 190请进入源码根目录，执行如下命令进行编译： 191 1921. 设置编译路径。 193 194 ``` 195 hb set 196 ``` 197 1982. 选择当前路径。 199 200 ``` 201 . 202 ``` 203 2043. 在hisilicon下选择hispark_taurus_standard并回车。 205 >  **说明：** 206 > 207 > 同样的开发板在适配不同的场景时，要采用的编译形态不同（即此处要选择的product不同），请参考[编译形态整体说明](quickstart-appendix-compiledform.md)。 208 209 **图1** Hi3516编译设置图例 210 211  212 2134. 执行编译。 214 >  **说明：** 215 > - 单独编译一个部件（例如hello），可使用“hb build -T _目标名称_”进行编译。 216 > 217 > - 增量编译整个产品，可使用“hb build”进行编译。 218 > 219 > - 完整编译整个产品，可使用“hb build -f”进行编译。 220 > 221 > 此处以完整编译整个产品为例进行说明。 222 223 224 ``` 225 hb build -f 226 ``` 227 2285. 编译结束后，出现“build success”字样，则证明构建成功。 229 >  **须知：** 230 > 编译结果文件及编译日志文件获取路径：out/hi3516dv300。 231 232 233## 烧录 234 235针对Hi3516DV300开发板，除了DevEco Device Tool（操作方法请参考[烧录](quickstart-appendix-hi3516-ide.md#烧录)）外，还可以使用HiTool进行烧录。 236 237 238### 前提条件 239 240- 开发板相关源码已编译完成，已形成烧录文件。 241 242- 客户端（操作平台，例如Windows系统）已下载并安装[HiTool工具](http://www.hihope.org/download/download.aspx)。 243 244- 客户端（操作平台，例如Windows系统）已安装USB驱动，可参考[Hi3516DV300开发板USB驱动安装指导](https://gitee.com/link?target=https%3A%2F%2Fdevice.harmonyos.com%2Fcn%2Fdocs%2Fdocumentation%2Fguide%2Fusb_driver-0000001058690393)。 245 246- 客户端已安装串口终端工具（例如IPOP）。 247 248- 使用USB线缆、串口线缆连接客户端与开发板。 249 250 251### 操作步骤 252 2531. 准备烧录相关文件。 254 1. 在客户端新建用于保存烧录文件的文件夹，例如D:\L2。 255 2. 将编译完成的源码包下载至客户端并解压，将烧录相关文件拷贝至步骤1中新建的文件夹。 256 257 Hi3516DV300开发板烧写所需文件为：boot.img、Hi3516DV300-emmc.xml、system.img、u-boot-hi3516dv300_emmc.bin、uImage、updater.img、userdata.img、vendor.img。 258 2592. 使用HiTool烧录。 260 1. 打开HiTool。 261 2. 设置HiTool参数。 262 263 传输方式选择USB口，烧写方式选择烧写eMMC（单板的存储介质为eMMC）。 264 3. 单击浏览在步骤1创建的文件夹中选择烧写配置文件（例如Hi3516DV300-emmc.xml）。 265 266  267 4. 单击烧写后，按住开发板上串口旁的按钮（Update键），并拔插USB线（上下电）。。 268 269 烧录开始后，可以在HiTool工具下方的控制台区域观察到烧录过程中的打印信息。 270 271 烧录完成后，HiTool弹出提示框显示烧写成功。 272 5. 单击确定。 273 2743. 导入启动参数。 275 1. 使用终端工具打开串口。 276 2. 拔插开发板电源使其重启，3s内在串口终端输入回车。 277 278 终端界面中出现hisilicon \#表示已连接开发板串口。 279 3. 在串口终端拷贝如下启动参数后，按回车完成配置。 280 281 ``` 282 setenv bootargs 'mem=640M console=ttyAMA0,115200 mmz=anonymous,0,0xA8000000,384M clk_ignore_unused androidboot.selinux=permissive rootdelay=10 hardware=Hi3516DV300 init=/init root=/dev/ram0 rw blkdevparts=mmcblk0:1M(boot),15M(kernel),20M(updater),2M(misc),3307M(system),256M(vendor),-(userdata)';setenv bootcmd 'mmc read 0x0 0x82000000 0x800 0x4800; bootm 0x82000000' 283 284 saveenv 285 286 reset 287 ``` 288 289 >  **须知：** 290 > 输入启动参数时，请勿自行删除其中的空行。 291 292 293## 运行 294 295系统启动成功后，取源码out目录下的helloworld可执行文件放入系统的bin目录，通过以下步骤运行“Hello World”。 296 297 298### 操作步骤 299 3001. 在启动界面进入bin目录。 301 302 ``` 303 cd bin 304 ``` 305 3062. 进入bin目录后可以看到helloworld文件，通过以下命令运行helloworld程序。 307 308 ``` 309 ./helloworld 310 ``` 311 312 界面打印“Hello World！”，程序运行成功。 313 314 315### 下一步学习 316 317恭喜！您已经完成了标准系统的快速入门，接下来可[开发一个小示例](../guide/device-clock-guide.md)，进一步熟悉OpenHarmony的开发。 318
