• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# BearPi-HM_Nano开发板第一个示例程序<a name="ZH-CN_TOPIC_0000001053183925"></a>
2
3本示例将演示如何编写简单业务，输出“Hello World”。
4
5## 修改源码<a name="section9360141181414"></a>
6
7bugfix和新增业务两种情况，涉及源码修改。下面以新增业务举例，向开发者介绍如何进行源码修改。
8
91.  <a name="li5479332115116"></a>确定目录结构。
10
11    开发者编写业务时，务必先在./device/bearpi/bearpi_hm_nano/app路径下新建一个目录（或一套目录结构），用于存放业务源码文件。
12
13    例如：在app下新增业务my\_first\_app，其中hello\_world.c为业务代码，BUILD.gn为编译脚本，具体规划目录结构如下：
14
15    ```
16    .
17    └── device
18        └── bearpi
19            └── bearpi_hm_nano
20                └── app
21                    │── my_first_app
22                    │  │── hello_world.c
23                    │  └── BUILD.gn
24                    └── BUILD.gn
25    ```
26
272.  编写业务代码。
28
29    在hello\_world.c中新建业务入口函数HelloWorld，并实现业务逻辑。并在代码最下方，使用OpenHarmony启动恢复模块接口SYS\_RUN\(\)启动业务。（SYS\_RUN定义在ohos\_init.h文件中）
30
31    ```
32    #include "ohos_init.h"
33    #include "ohos_types.h"
34
35    void HelloWorld(void)
36    {
37        printf("[DEMO] Hello world.\n");
38    }
39    SYS_RUN(HelloWorld);
40    ```
41
423.  编写用于将业务构建成静态库的BUILD.gn文件。
43
44    如[步骤1](#li5479332115116)所述，BUILD.gn文件由三部分内容（目标、源文件、头文件路径）构成，需由开发者完成填写。以my\_first\_app为例，需要创建./device/bearpi/bearpi_hm_nano/app/my\_first\_app/BUILD.gn，并完如下配置。
45    ```
46    static_library("myapp") {
47        sources = [
48            "hello_world.c"
49        ]
50        include_dirs = [
51            "//utils/native/liteos/include"
52        ]
53    }
54    ```
55
56    -   static\_library中指定业务模块的编译结果，为静态库文件libmyapp.a，开发者根据实际情况完成填写。
57    -   sources中指定静态库.a所依赖的.c文件及其路径，若路径中包含"//"则表示绝对路径（此处为代码根路径），若不包含"//"则表示相对路径。
58    -   include\_dirs中指定source所需要依赖的.h文件路径。
59
604.  编写模块BUILD.gn文件，指定需参与构建的特性模块。
61
62    配置`./device/bearpi/bearpi_hm_nano/app/BUILD.gn`文件，在features字段中增加索引`"my_first_app:myapp"`，使目标模块参与编译。并屏蔽其余模块。
63
64    ```
65        #"D1_iot_wifi_scan:wifi_scan",
66        #"D2_iot_wifi_connect:wifi_connect",
67        #"D3_iot_udp_client:udp_client",
68        #"D4_iot_tcp_server:tcp_server",
69        #"D5_iot_mqtt:iot_mqtt",
70        #"D6_iot_cloud_oc:oc_mqtt",
71        #"D7_iot_cloud_onenet:onenet_mqtt",
72
73        "my_first_app:myapp"
74    ```
75
76    -   my\_first\_app是相对路径，指向`./device/bearpi/bearpi_hm_nano/app/my_first_app/BUILD.gn`。
77    -   myapp是目标，指向 `./device/bearpi/bearpi_hm_nano/app/my_first_app/BUILD.gn` 中的static\_library\("myapp"\)。
78
79
80## 运行结果<a name="section18115713118"></a>
81
82示例代码编译、烧录、运行、调测后，会显示如下结果：
83
84```
85ready to OS start
86FileSystem mount ok.
87wifi init success!
88[DEMO] Hello world.
89```
90
91## 下一步学习<a name="section9712145420182"></a>
92
93恭喜，您已完成BearPi-HM_Nano开发板快速上手,可以进行[BearPi-HM_Nano案例开发](../../app/README.md)了。