想了解更多内容,请访问:
51CTO和华为官方合作共建的鸿蒙技术社区
https://harmonyos.51cto.com/#zz
第3章 Hi3681开发
目录:
3.1 编写一个简单的hello world程序
3.2 Hi3861相关代码结构
3.2 Hi3861启动流程
3.1 编写一个简单的hello world程序
编写一个hello world程序比较简单,可以参考官网:
https://device.harmonyos.com/cn/docs/start/introduce/oem_wifi_start-0000001050168544
本文在这里做下总结:
(1)确定目录结构。
开发者编写业务时,务必先在./applications/sample/wifi-iot/app路径下新建一个目录(或一套目录结构),用于存放业务源码文件。
例如:在app下新增业务my_first_app,其中hello_world.c为业务代码,BUILD.gn为编译脚本,具体规划目录结构如下:
- .
- └── applications
- └── sample
- └── wifi-iot
- └── app
- │── my_first_app
- │ │── hello_world.c
- │ └── BUILD.gn
- └── BUILD.gn
(2)编写业务代码。
在hello_world.c中新建业务入口函数HelloWorld,并实现业务逻辑。并在代码最下方,使用 HarmonyOS启动恢复模块接口SYS_RUN()启动业务。(SYS_RUN定义在ohos_init.h文件中)
- #include "ohos_init.h"
- #include "ohos_types.h"
- void HelloWorld(void)
- {
- printf("[DEMO] Hello world.\n");
- }
- SYS_RUN(HelloWorld);
(3)编写用于将业务构建成静态库的BUILD.gn文件。
如步骤1所述,BUILD.gn文件由三部分内容(目标、源文件、头文件路径)构成,需由开发者完成填写。以my_first_app为例,需要创建./applications/sample/wifi-iot/app/my_first_app/BUILD.gn,并完如下配置。
- static_library("myapp") {
- sources = [
- "hello_world.c"
- ]
- include_dirs = [
- "//utils/native/liteos/include"
- ]
- }
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字段配置如下。
- import("//build/lite/config/component/lite_component.gni")
- lite_component("app") {
- features = [
- "my_first_app:myapp",
- ]
- }
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")。
3.2 Hi3861相关代码结构
目前hi3861用的是liteos-m内核,但是目前hi3681的liteos-m被芯片rom化了,固化在芯片内部了。所以在harmonyOS代码是找不到hi3861的内核部分。
但是这样不妨碍我们去理清hi3861的其他代码结构。
hi3861平台配置文件
build\lite\platform\hi3861v100_liteos_riscv\platform.json
该文件描述了hi3681平台相关的代码路径,例如application、startup等。
这里我列举出来几个比较重要的:
子系统:applications :
路径:applications/sample/wifi-iot/app
作用:这个路径下存放了hi3681编写的应用程序代码,例如我们刚刚写得hello world 代码就放在这个路径下。
子系统:iot_hardware :
路径:base/iot_hardware/frameworks/wifiiot_lite
作用:存放了 hi3681 芯片相关的驱动、例如spi、gpio、uart等。
子系统:vendor
路径:vendor/hisi/hi3861/hi3861
作用:存放了 hi3681 相关的厂商SDK之类的文件。其中最重要的是
vendor\hisi\hi3861\hi3861\app\wifiiot_app\init\app_io_init.c
vendor\hisi\hi3861\hi3861\app\wifiiot_app\src\app_main.c
其中,app_io_init.c 是hi3681内核启动后的io口相关设置,用户需根据应用场景,合理选择各外设的IO复用配置。
app_main.c 是内核启动进入的应用程序入口。
3.2 Hi3861启动流程
由于hi3681的liteos-m被芯片rom化了,固化在芯片内部了。所以我们主要看内核启动后的第一个入口函数。
代码路径:
vendor\hisi\hi3861\hi3861\app\wifiiot_app\src\app_main.c
- hi_void app_main(hi_void)
- {
- #ifdef CONFIG_FACTORY_TEST_MODE
- printf("factory test mode!\r\n");
- #endif
- const hi_char* sdk_ver = hi_get_sdk_version();
- printf("sdk ver:%s\r\n", sdk_ver);
- hi_flash_partition_table *ptable = HI_NULL;
- peripheral_init();
- …..中间省略代码
- HOS_SystemInit();
- }
app_main一开始打印了 SDK版本号,最后一行会调用HOS_SystemInit(); 函数进行鸿蒙系统的初始化。我们进去看下初始化做了哪些动作。
路径:base/startup/services/bootstrap_lite/source/system_init.c
- void HOS_SystemInit(void)
- {
- MODULE_INIT(bsp);
- MODULE_INIT(device);
- MODULE_INIT(core);
- SYS_INIT(service);
- SYS_INIT(feature);
- MODULE_INIT(run);
- SAMGR_Bootstrap();
- }
我们可以看到主要是初始化了 一些相关模块、系统,包括有bsp、device(设备)。其中最终的是MODULE_INIT(run);
它负责调用了,所有run段的代码,那么run段的代码是哪些呢?
事实上就是我们前面application中使用SYS_RUN() 宏设置的函数名。
还记得我们前面写的hello world应用程序吗?
- #include "ohos_init.h"
- #include "ohos_types.h"
- void HelloWorld(void)
- {
- printf("[DEMO] Hello world.\n");
- }
- SYS_RUN(HelloWorld);
也就是说所有用SYS_RUN() 宏设置的函数都会在使用MODULE_INIT(run); 的时候被调用。
为了验证这一点,我们可以加一些打印信息,如下:
我们重新编译后烧录。打开串口查看打印信息,如下:
可以看到在35行之后,就打印 hello world的信息。符合预期。
想了解更多内容,请访问:
51CTO和华为官方合作共建的鸿蒙技术社区
https://harmonyos.51cto.com/#zz