TIOVX 学习笔记其三：concerto makefile

Reference:

1. TIOVX User Guide

1. Introduction

concerto 是一个基于 GNU 的搭建系统，被 PSDK RTOS 中的许多组件所使用。它是 make 规则和 make 宏的集合，可以跨多个代码生成工具、CPU arch、操作系统、SoC 进行流线编译和链接。

下面的部分使用了基于 concerto 的 PSDK RTOS 搭建系统：

• Ethernet firmware
• Remote Device
• Imaging
• Perception (PTK)
• TI OpenVX
• Video codec
• Vision apps

2. Concerto basic’s

concerto 从项目根文件夹开始和根文件夹中所有子目录，寻找文件 concerto.mak。

• 每个 <kbd>concerto.mak 搭建一个 library 或者一个可执行文件
• 要搜索的目录列在 /Makefile 中的 make 变量 DIRECTORIES 中

3. Common command line options to use when building

在 vision_apps 路径下的 Build 方式：

make command	Description
make all	Build everything
make clean	Clean everything
make targets	List all granular targets (libraries or executables) enabled in current build
make <maketarget>	Build a specific target listed during make targets(如TARGET := vx_app_tutorial，则命令为make vx_app_tutorial)

make targets 列出了所有已启用的 build targets，会有如下显示（可以看成类似 ls 的指令）：

CONCERTO_TARGETS+=targetname1
CONCERTO_TARGETS+=targetname2
CONCERTO_TARGETS+=targetname3
…

使用后面一个命令 make targetname1 就可以搭建叫做 targetname1 的 target 了。这样就可以只编译一个确切的 library 或者 executable，而不是所有的。

4. Anatomy of concerto.mak file

4.1 示例

以下示例为最小的 concerto.mak 文件内容，这将搭建此 concerto.mak 所在文件夹中的所有C文件。

include $(PRELUDE)

# all variable setup should be between PRELUDE and FINALE

TARGET      := my_lib_name
TARGETTYPE  := library  # 另一种可选的类型为exe
CSOURCES    := $(call all-c-files)

include $(FINALE)

4.2 变量

• 下面列出了预定义的和常用的变量：

Variable	Purpose
CSOURCES	列出要构建的C文件，显式地列出每个文件或使用宏 $(call all-c-files)
DEFS	定义在编译此taget文件时要应用的
IDIRS	在编译此target文件时请求的include的搜索路径
LDIRS	在链接此target文件时请求的library的搜索路径
STATIC_LIBS	在创建可执行文件时，链接的静态库(.a)
SYS_SHARED_LIBS	在创建可执行文件时，链接的共享库(.so)

• 通常，项目会把 concerto.mak 的内容放在如下所示的 ifeq 下:

ifeq ($(TARGET_CPU),$(filter $(TARGET_CPU), x86_64 A72))

这允许为特定的 CPU、OS或特定的SoC搭建特定的库，还有以下变量：

Variable	Purpose
TARGET_CPU	CPU architecture type
TARGET_OS	OS type
TARGET_PLATFORM	SoC or SoC family type
TARGET_BUILD	Build profile

$\cdot$ 使用 ifeq 和 $(filter) 来根据 make 变量有条件地选择文件，比如上面的示例，如果 CPU 是 A72 时，\$(filter $(TARGET_CPU), x86_64 A72) 会返回 A72，式子就变成了 ifeq ($(TARGET_CPU), A72，这样就能解决有多个可选变量的情况。

点击跳转：
TIOVX 学习笔记其一：OpenVX.
TIOVX 学习笔记其二：TIVOX.
TIOVX 学习笔记其四：Objects.