Hi3861开发板第二个示例程序

    bugfix和新增业务两种情况，涉及源码修改。下面以新增业务举例，向开发者介绍如何进行源码修改。

    1. 确定目录结构。

      开发者编写业务时，务必先在./applications/sample/wifi-iot/app路径下新建一个目录（或一套目录结构），用于存放业务源码文件。

      例如：在app下新增业务my_first_app，其中hello_world.c为业务代码，BUILD.gn为编译脚本，具体规划目录结构如下：

    2. 编写业务代码。

      在hello_world.c中新建业务入口函数HelloWorld，并实现业务逻辑。并在代码最下方，使用OpenHarmony启动恢复模块接口SYS_RUN()启动业务。（SYS_RUN定义在ohos_init.h文件中）

      2. #include "ohos_types.h"
      4. void HelloWorld(void)
      5. {
      6.     printf("[DEMO] Hello world.\n");
      7. }

    3. 如所述，BUILD.gn文件由三部分内容（目标、源文件、头文件路径）构成，需由开发者完成填写。以my_first_app为例，需要创建./applications/sample/wifi-iot/app/my_first_app/BUILD.gn，并完如下配置。

      • static_library中指定业务模块的编译结果，为静态库文件libmyapp.a，开发者根据实际情况完成填写。
      • sources中指定静态库.a所依赖的.c文件及其路径，若路径中包含”//“则表示绝对路径（此处为代码根路径），若不包含”//“则表示相对路径。
      • include_dirs中指定source所需要依赖的.h文件路径。

    4. 编写模块BUILD.gn文件，指定需参与构建的特性模块。

      配置./applications/sample/wifi-iot/app/BUILD.gn文件，在features字段中增加索引，使目标模块参与编译。features字段指定业务模块的路径和目标，以my_first_app举例，features字段配置如下。

      1. import("//build/lite/config/component/lite_component.gni")
      3. lite_component("app") {
      4.     features = [
      5.         "my_first_app:myapp",
      6.     ]
      7. }
      • my_first_app是相对路径，指向./applications/sample/wifi-iot/app/my_first_app/BUILD.gn。
      • myapp是目标，指向./applications/sample/wifi-iot/app/my_first_app/BUILD.gn中的static_library(“myapp”)。

    调测验证

    目前调试验证的方法有两种，分别为通过printf打印日志、通过asm文件定位panic问题，开发者可以根据具体业务情况选择。

    由于本示例业务简单，采用printf打印日志的调试方式即可。下面开始介绍这两种调试手段的使用方法。

    代码中增加printf维测，信息会直接打印到串口上。开发者可在业务关键路径或业务异常位置增加日志打印，如下所示。

    根据asm文件进行问题定位

    1. =======KERNEL PANIC=======
    2. Call Stack 0 -- 4860d8 addr:f784c
    4. Call Stack 2 -- 3e562c addr:f789c
    5. Call Stack 3 -- 4101de addr:f78ac
    6. Call Stack 4 -- 3e5f32 addr:f78cc
    7. Call Stack 5 -- 3f78c0 addr:f78ec
    8. Call Stack 6 -- 3f5e24 addr:f78fc
    9. ********************Call Stack end*******************

    为解析上述调用栈信息，需要使用到Hi3861_wifiiot_app.asm文件，该文件记录了代码中函数在Flash上的符号地址以及反汇编信息。asm文件会随版本大包一同构建输出，存放在./out/wifiiot/路径下。

    1. 将调用栈CallStack信息保存到txt文档中，以便于编辑。（可选）

    2. 打开asm文件，并搜索CallStack中的地址，列出对应的函数名 信息。通常只需找出前几个栈信息对应的函数，就可明确异常代码方向。

    3. 根据以上调用栈信息，可以定位WadRecvCB函数中出现了异常。

    4. 完成代码排查及修改。

    示例代码编译、烧录、运行、调测后，会显示如下结果：

    1. ready to OS start
    2. FileSystem mount ok.

    下一步学习