同步操作将从 QuecPython/HeliosSDK 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
.mk
作为后缀的Makefile
文件进行管理。开发者可在其中添加期望被编译的源文件、仅被本组件内部访问的头文件路径、可被所有组件访问的头文件路径、仅被本组件内部使用的宏定义、可被所有组件使用的宏定义,以及本组件需要依赖的其他组件。
开发者可以在该SDK下添加多个不同的应用代码文件夹,如app
、app2
等。应用代码目录的存放位置可放在SDK根目录下的任何位置,为了规范起见,建议直接放在根目录下。如果在某个组件中需要添加相应的组件测试demo
,该demo
应用建议放在该组件的目录下。
启动helios
命令,可以将指定应用目录下的代码和SDK一起编译,也可以调用helios clean
命令,清除编译生成的output
文件夹。
.mk
文件进行组件的管理
任何一个组件的根目录下必须存在一个和当前文件夹同名的.mk
文件。该Makefile文件中可以添加以下脚本代码:
NAME = component_name # 组件名称,建议和所在目录名称一致
GLOBAL_INCS = public/inc # 允许外部引用的头文件路径,不在此列的头文件路径,其他组件无法直接引用
GLOBAL_DEFINE = PUBLIC_MACRO # 当前组件内定义的、允许外部组件引用的宏。
$(NAME)_CFLAGS = -Wno-error=incompatible-pointer-types # 仅当前组件内部可引用的编译选项
$(NAME)_ARCHIVES := src/archive.a # 当前组件内参与编译的库文件
$(NAME)_SRCS := src/source.c asm.s # 当前组件内参与编译的源码文件,包括c和汇编
$(NAME)_INCS := local/Inc # 仅当前组件内部可引用的头文件路径,在此列的头文件路径,其他组件无法直接引用
$(NAME)_DEFINE := LOCAL_MACRO # 当前组件内定义的、仅组件内部可引用的宏,不允许外部组件引用。
$(NAME)_COMPONENTS := third_party/LinkSDK \
system/protocols/ftp # 当前组件依赖的其他组件的相对路径(相对于根目录)
编译命令格式:<cmd> <action> [<app>] [<at>] [<fw_name>]
<cmd>
:编译命令,即helios
<action>
:脚本的行为,取值如下:
help
:打印编译脚本的用法。
menuconfig
:编译配置菜单。
后跟模块型号名称,eg: helios menuconfig EC600NCN_LA
make
:构建编译目标。
private_clean
:清除应用层内部在编译前生成的私有的目标文件,比如python服务需要提前生成_frozen_mpy.c和相关头文件,该命令可清除之。
clean
:清除编译目标(即output目录)。
<app>
:可选项,当<action>
取值为make时,必选。
指定应用入口的相对位置(即编译或烧录哪一个应用固件,相对于根目录)。
<at>
:可选项,当<action>
取值为make时生效。
参数格式:@
分隔的多个单词,目前限定于模块型号
和编译命令回显开关
。例如EC200UCN_AA@verbose
,表示编译EC200UCN_AA的模块,打开编译命令回显开关。该参数的首尾也可以添加@
。
当只有一个单词时,务必在首或尾,或首尾同时,添加@
。
默认:编译EC200UCN_AA模块,并且不开启编译命令回显。
<fw_name>
:可选项,当<action>
取值为make时生效。
用来指定固件版本号,默认值为应用根目录名称。
【注意】
- 通过应用配置脚本指定的全局宏定义,在每一次变更宏定义时,会自动删除编译目录,以期全部重新编译所有代码,从而让变更后的全局宏定义能够起作用,否则,由于源文件没变化过,引用该宏定义的源码将不会被编译,导致宏定义无效。
- 通过
.mk
文件定义的宏,在宏定义有变动后,一定要先执行clean
命令,原因同上。<at>
和<fw_name>
两个参数顺序可互换。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。