Contiki‐NG的构建系统

Contiki-NG构建系统旨在为方便地各种硬件平台构建完整的系统映像,编译生成二进制文件同时包含应用程序代码和Contiki-NG操作系统代码。

一个简单的示例项目Makefile可以在examples/hello-world/中找到:

CONTIKI_PROJECT = hello-world
all: $(CONTIKI_PROJECT)
CONTIKI = ../..
include $(CONTIKI)/Makefile.include

定义项目名称和Contiki-NG路径后,将简单地包含公共makefile。 通过从该目录运行make hello-world系统将针对默认目标:本机(原生)构建。 本机目标是一个特殊的平台,该平台将Contiki-NG构建为能够在开发系统(例如Linux)上运行的程序。 编译后只需运行文件hello-world.native即可。

要为其他平台编译hello-world应用程序,请使用标志TARGET,例如 与TARGET = zoul。 在某些平台上,需要额外的BOARD来进一步指定目标。

建立系统的输出结构

生成系统将生成许多文件,这些文件将放置在许多位置。 本指南使用hello-world示例作为用例,但所有其他示例的输出将相同。

构建系统将始终将最终的构建输出文件(固件)放在示例.目标平台。 这是用于编程设备(嵌入式目标)或执行(本机平台)的固件。 对于hello-world示例,这将称为hello-world.$(TARGET)(例如hello-world.nativehello-world.zoul

生成系统还将生成一个build/目录,并在其中生成各个子目录,并在其中放置中间文件。 逻辑如下:

  • 一定会创建一个名为build/$(TARGET)的目录(例如build/nativebuild/zoul)。
  • 如果平台支持make变量BOARD,那么还将在build/$(TARGET)下创建特定于板子的目录。例如build/zoul/remote-revabuild/ srf06-cc26xx/launchpad/cc2650
  • 构建示例时,您可能希望在不同的配置之间切换。例如,您可能希望有一个用于调试和测试的构建,以及一个单独的用于部署的构建。 Contiki-NG通过make变量BUILD_DIR_CONFIG对此提供支持,您可以为您的不同构建分配不同的值。如果确实选择使用BUILD_DIR_CONFIG,则构建系统将在build/(TARGET)/[(BOARD)]/下创建另一个名为$(BUILD_DIR_CONFIG)/的子目录。例如,如果运行make BUILD_DIR_CONFIG = deploy,则为build/zoul/remote-reva/deploy`。
  • 最后,将在build/$(TARGET)/[$(BOARD)]/[$(BUILD_DIR_CONFIG)]下创建另一个名为obj的子目录。例如build/srf06-cc26xx/launchpad/cc2650/debug/obj

考虑到上述子目录结构,构建系统将输出以下文件:

  • 所有编译输出文件(.o)和依赖文件(.d)将放置在obj/dir下。
  • 所有链接和后期处理文件(例如hello-world.elfhello-world.hexhello-world.bin)都将放置在build/$(TARGET)/[$(BOARD)]/[$(BUILD_DIR_CONFIG)]。 在同一目录中,您通常还会归档一个.map文件。 最后,该目录还将始终托管hello-world.$(TARGET)文件的副本。

清除目标(clean)

要清除以前构建的目标,请使用:

  • clean:删除TARGET的所有构建输出文件,包括整个build/$(TARGET)目录。 当前没有办法只清除为--特定BOARD--构建的文件。
  • distclean:清除所有Contiki-NG目标的--所有构建输出文件--,并删除整个build/目录。 它基本上为所有支持Contiki-NG的平台调用make TARGET = xyz clean,一旦完成,它将强制删除build/目录。

更多操作

支持以下make目标:

  • viewconf:显示重要的Make和C常量的值,用于检查Contiki-NG配置
  • targets:显示受支持的TARGET列表
  • board:显示当前TARGET支持的BOARD列表
  • savetarget:将当前的TARGET和BOARD保存在Makefile.target下,以用于后续的make运行
  • savedefines:保存当前的DEFINES标志以供后续运行make
  • %.o:从给定的源文件生成目标文件
  • %.e:生成给定源文件的预处理版本
  • %.s:从给定的源文件生成一个程序集文件
  • %.ramprof:显示给定固件的RAM配置文件
  • %.flashprof:显示给定固件的Flash / ROM配置文件
  • login:查看连接到PORT的设备的串行输出
  • serialview:与login相同,但是在串行输出前加上unix时间戳
  • serialdump:与serialview相同,但还将输出保存到文件中
  • motelist-all:打印已连接设备的列表
  • usagehelp:显示简短的帮助

Makefiles的使用

Contiki-NG构建系统由许多Makefile组成。 他们是:

  • Makefile:项目的makefile,位于项目目录中。 这个Makefile可以定义MODULES变量,即应包含的模块列表。 它还可以配置Contiki-NG网络堆栈(请参阅doc:configuration)以及任何其他标准的Makefile规则和标志。
  • 顶级Makefile,位于Contiki-NG的源代码树的根目录中:
    • Makefile.include:系统范围内的makefile。 运行make时,Makefile.include包括Makefile.$(TARGET)以及MODULES列表中模块的所有makefile(由项目的Makefile指定)。
    • Makefile.help:包含帮助和使用目标的定义。
    • Makefile.tools:一些内部版本依赖于工具目录下的实用程序。 这个Makefile确保在需要时可以构建那些依赖关系。
    • Makefile.embedded:包含适用于Contiki-NG所有嵌入式平台的其他Makefile逻辑,也就是除nativecooja之外的所有平台。
    • Makefile.identify-target:此Makefile可用于识别用于特定构建的所选TARGET。 它可以包含在示例Makefile中,这些文件需要根据TARGET make变量的值进行决策。
  • Makefile.$(TARGET)(其中$(TARGET)是平台的名称):特定平台的规则,位于arch/platform的子目录中。它包含平台添加到Contiki-NG系统的C文件列表(CONTIKI_TARGET_SOURCEFILES)Makefile.$(TARGET)还包括来自arch/cpu/$(CPU)/目录的Makefile.$(CPU)
  • Makefile.$(CPU)(其中$(CPU)CPU/MCU的名称):CPU体系结构的规则,位于arch/cpu/中CPU体系结构的子目录中。
  • Makefile.$(MODULE)(其中$(MODULE)是os目录中模块的名称):可选的,特定于模块的Makefile规则。
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,525评论 6 507
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,203评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,862评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,728评论 1 294
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,743评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,590评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,330评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,244评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,693评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,885评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,001评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,723评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,343评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,919评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,042评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,191评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,955评论 2 355

推荐阅读更多精彩内容