展讯平台开发说明

Build环境使用手册

Version: 0.2.5

2010-10-14

修订历史

重要声明

版权声明

本文档中的任何内容受《中华人民共和国著作权法》的保护，版权所有© 2006, 展讯通信有限公司，保留所有权利，但注明引用其他方的内容除外。

商标声明

本文档中展讯通信有限公司的产品的所有商标是展讯通信有限公司专有，但注明属于其他公司拥有的商标除外。在提及其他公司及其产品时将使用各自公司所拥有的商标，这种使用的目的仅限于引用。

不作保证声明

展讯通信有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保证，而且不对特定目的的适销性及适用性或者任何间接、特殊或连带的损失承担任何责任。

保密声明

本文档（包括任何附件）包含的信息是保密信息。接收人了解其获得的本文档是保密的，除用于规定的目的外不得用于任何目的，也不得将本文档泄露给任何第三方。

目录

1说明 (6)

2编译环境及相关软件 (7)

3Source Code目录结构 (8)

4基本编译命令 (10)

4.1全新编译整个项目[new] (10)

4.2更新项目[update] (11)

4.3单独编译模块 (11)

4.4清除模块编译结果 (11)

4.5清除所有编译结果[cleanall] (11)

4.6生成可执行文件 (11)

4.7编译FDL/bootloader (11)

4.8编译NV (11)

4.9编译MMI Resource 文件 (12)

4.10编译PC模拟器工程 (12)

5其它编译命令 (15)

5.1编译Logel工具 (15)

5.2pclint 扫描 (15)

5.3编译完成net send提醒功能 (15)

5.4编译命令的简写 (15)

5.5多线程编译 (15)

5.6分布式编译 (16)

5.7编译出错暂停 (16)

5.8生成编译选项 (16)

6Makefile 工作流程 (17)

6.1重要脚本 (17)

6.2Makefile 执行流程 (18)

6.3两种编译方式 (19)

7模块修改及项目定制 (21)

7.1添加或删除模块 (21)

7.2修改模块 (21)

7.3创建新项目 (22)

7.4修改项目Feature Options (23)

8第三方编译选项说明 (24)

9相关使用技巧 (25)

9.1查看log文件 (25)

9.2makefile 报错：No rule to make target ` XXX ', needed by `yyy'. (25)

9.3makefile 报错：Can't return outside a subroutine at ./make/perl_script/sprd_macro_check.pl line XXX (25)

9.4Source Insight和ClearCase配置 (25)

9.5鼠标右键命令行快捷方式设置 (28)

9.6DOS下输入命令时用Tab键进行命令自动填充 (28)

1 说明

Build环境中实现了项目开发和维护使用的GNU标准应用脚本，基于这些应用脚本和相关make工具，Build环境可以完成项目全部代码的编译和二进制文件的生成，同时在此环境中可以通过脚本执行的方式产生其他软件以及开发工具，如fdl, bootloader, nv_parameter，resource等。

Build环境的相关命令脚本需要在Windows Command环境下进行，因为每个项目工程编译出来的中间依赖文件都独立存放，所以可以通过开启多个Windows Command窗口对多个不同的项目进行同时编译。

2 编译环境及相关软件

操作系统：建议Windows 2000 professional 或windows XP SP3 版本

编译工具：ADS V1.2 (ARM Developer Suite) patch848 is fully ready

RVDS V3.1(Realview Devloper Suite) is under evaluation

Microsoft Visual C++ 6.0 SP6

ADS patch版本的查看方法见下图：

其他工具：Microsoft Excel 2000 或者Microsoft Excel 2003 或者WPS 2005及以上版本

3 Source Code目录结构

Build环境目录结构

└─MS_Code

├─build 编译结果的输出总目录，此目录下内容在编译过程中生成

│├─8801h_s3b_builddir 与具体项目名称对应，自动生成的输出目录

││├─dep 编译依赖文件存放目录

││├─img编译最终结果存放目录，包括arm bin,fdl,bootloader,

│││resource,nv等

││├─lib 客户编译模块.a存放目录

││├─log 编译log文件目录，包括编译出错信息、告警信息等

││├─fdl_bootloader 编译生成的fdl bootloader文件目录

││├─res 编译生成的resource文件目录

││├─pclint 编译生成的pclint文件目录

││├─tmp 编译生成的临时文件目录

││└─obj 模块目标文件存放目录

││└─win 自动生成模拟器工程存放目录

│└─sc6600l_sp6601l_builddir

├─chip_drv Source Code

├─MS_Ref Source Code

├─PS

├─atc

├─common

│├─nv_parameters 统一NV project存放目录

│└─source 目标统一main.c存放目录

├─make 依据编译选项文件，makefile将自动搜寻该目录并循环|

对模块进行编译

│└─aac

│└─aac.mk 对应模块的编译脚本

| …

|

├─MS_Customize

│├─config

│├─custom

│└─product 区分不同产品驱动配置文件

├─version 目标统一版本version.c

├─MS_MMI

├─Third-party 第三方软件库文件和头文件存放位置

│└─bt_csr

│├─include

│└─lib

├─lib 展讯开放库文件目录存放地和build目录分开

├─fdl_bootloader fdl bootloader 存放目录