`
MOLY Make/Build Environment and
Procedures Design Document
© 2008-2012 MediaTek Inc.
This document contains information that is proprietary to MediaTek Inc.
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
Specifications are subject to change without notice.
loginid=lu.yunbo@gaophone.com,time=2013-05-10 12:03:20,ip=27.115.112.202,doctitle=MTK_MOLY_MakeBuild_Design_Customer.docx,company=Gaophone_WCX
FO
M
R
ED
lu.
yu IAT
nb E
o@ K
CO
ga
op NF
ho ID
ne EN
.co T
m IA
US L
EO
N
Version:
Release date:
Valid for WR8.W1231.DC.WG.MP and later release
2013-04-23
LY
FO
loginid=lu.yunbo@gaophone.com,time=2013-05-10 12:03:20,ip=27.115.112.202,doctitle=MTK_MOLY_MakeBuild_Design_Customer.docx,company=Gaophone_WCX
M
R
ED
lu.
yu IAT
nb E
o@ K
CO
ga
op NF
ho ID
ne EN
.co T
m IA
US L
EO
N
Legal Disclaimer
MediaTek Confidential
© 2012 - 2013 MediaTek Inc.
This document contains information that is proprietary to MediaTek Inc.
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
BY OPENING THIS FILE, RECEIVER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND
AGREES THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK
SOFTWARE") RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED
TO RECEIVER ON AN "AS-IS" BASIS ONLY.
MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
SUPPLIED WITH THE MEDIATEK SOFTWARE, AND RECEIVER AGREES TO LOOK ONLY TO
SUCH THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO.
RECEIVER EXPRESSLY ACKNOWLEDGES THAT IT IS RECEIVER’S SOLE RESPONSIBILITY TO
OBTAIN FROM ANY THIRD PARTY ALL PROPER LICENSES CONTAINED IN MEDIATEK
SOFTWARE. MEDIATEK SHALL ALSO NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE
RELEASES MADE TO RECEIVER'S SPECIFICATION OR TO CONFORM TO A PARTICULAR
STANDARD OR OPEN FORUM.
RECEIVER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE
LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL
BE,AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE,
OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY RECEIVER TO
MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE.
Page 2 of 37
LY
MOLY Make/Build Environment
and Procedures Design Document
FO
loginid=lu.yunbo@gaophone.com,time=2013-05-10 12:03:20,ip=27.115.112.202,doctitle=MTK_MOLY_MakeBuild_Design_Customer.docx,company=Gaophone_WCX
M
R
ED
lu.
yu IAT
nb E
o@ K
CO
ga
op NF
ho ID
ne EN
.co T
m IA
US L
EO
N
Table of Contents
1
1.1
1.2
1.3
2
2.1
2.2
3
3.1
3.2
3.3
3.4
3.5
3.6
4
5
5.1
6
6.1
6.2
6.3
6.4
6.5
7
7.1
Appendix1
1
2
2.1
2.2
MediaTek Confidential
© 2012 - 2013 MediaTek Inc.
This document contains information that is proprietary to MediaTek Inc.
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
Legal Disclaimer ..................................................................................................................................... 2
Table of Contents ................................................................................................................................... 3
Introduction................................................................................................................................... 5
Features ................................................................................................................................ 5
References ........................................................................................................................... 5
Terminology and Definition ................................................................................................... 5
Environment Requirements and Limitations ............................................................................. 6
Environment Requirements .................................................................................................. 6
Environment Limitations ....................................................................................................... 6
File Architecture and Directories ................................................................................................ 7
Directory Architecture ........................................................................................................... 7
3.1.1
Root Directory ...................................................................................................... 7
3.1.2
Make/Build Script Directory .................................................................................. 8
Build Scripts .......................................................................................................................... 9
Module Configuration Files ................................................................................................. 11
Intermediate Build Scripts and Log File .............................................................................. 13
Generated Objects, Libraries, Executable Binary and Log Files ........................................ 14
Associated Perl Files .......................................................................................................... 16
Procedures and Functionality ................................................................................................... 18
Description of Options ............................................................................................................... 22
Core Software ..................................................................................................................... 22
make.sh, m and make.pl – Main Build Script File .............................................................. 23
build.mak/Codegen.mak – Main Build Script ...................................................................... 23
Comp.mak – Component Module Build Script ................................................................... 29
Option.mak/Option_HAL.mak/MODEM.mak – Project common option, and macro
definition Build Script .......................................................................................................... 31
USER_SPECIFIC.mak – debug modules configuration script ........................................... 32
Design and Implementation ...................................................................................................... 23
How to Customize the Build Environment ............................................................................... 33
Add Modules to or Remove Modules from the Build Procedure ........................................ 33
7.1.1
Add a Source Module ......................................................................................... 33
7.1.2
Remove a Source Module .................................................................................. 34
7.1.3
Move a Source Module to a .lib Module ............................................................. 34
Install Software and Compilation Tool Chain ........................................................... 35
Install build relative packages .................................................................................................. 36
Install arm-none-eabi-gcc-4.6.2 ................................................................................................ 37
arm-none-eabi-gcc-4.6.2 Web Site..................................................................................... 37
MinGW Installation Procedure ............................................................................................ 37
Page 3 of 37
LY
MOLY Make/Build Environment
and Procedures Design Document
FO
loginid=lu.yunbo@gaophone.com,time=2013-05-10 12:03:20,ip=27.115.112.202,doctitle=MTK_MOLY_MakeBuild_Design_Customer.docx,company=Gaophone_WCX
M
R
ED
lu.
yu IAT
nb E
o@ K
CO
ga
op NF
ho ID
ne EN
.co T
m IA
US L
EO
N
Lists of Tables and Figures
MediaTek Confidential
© 2012 - 2013 MediaTek Inc.
This document contains information that is proprietary to MediaTek Inc.
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
Table 1: Core Software Options ............................................................................................................ 22
Figure 1: Architecture of MOLY Make/Build Script .................................................................................. 9
Page 4 of 37
LY
MOLY Make/Build Environment
and Procedures Design Document
FO
loginid=lu.yunbo@gaophone.com,time=2013-05-10 12:03:20,ip=27.115.112.202,doctitle=MTK_MOLY_MakeBuild_Design_Customer.docx,company=Gaophone_WCX
M
R
ED
lu.
yu IAT
nb E
o@ K
CO
ga
op NF
ho ID
ne EN
.co T
m IA
US L
EO
N
1
Introduction
1.1
MOLY make/build environment and procedures utilize GNU make for building project executable
binaries. The actions include
new, update, remake, check_dep, remake_dep, cleanall, cleanmod,
codegen, emigen, emiclean, sysgen, drv_feature_check, cmmgen, bootloader, genlog, etc.
Detailed terminology and features are described in the following sections.
Features
Ability to easily add or delete files from the build
Ability to build based on relative paths
Ability to handle include files included in other directories
Ability to build different projects which have private source trees.
Ability to clean dedicated modules or all.
Ability to debug easily.
Ability to allow modules to specify private options, in addition to public build options.
1.2
[1]
References
GNU Make Manual, Version 3.81
1.3
Terminology and Definition
Definition
Terminology
Action
Clean
Component/Module
Customer
New, Update, Remake
Project
Behaviors that can be executed by the build script.
Ability to clean generated objects, libraries, and logs.
A project decomposition unit which can be created as a library.
The customers who get the released software.
Ability to build all or rebuild only modified files based on generated
dependencies.
Combination of independent sources, header files, and created image
binaries, objects, libraries, etc. such as HSPA, GPRS.
MediaTek Confidential
© 2012 - 2013 MediaTek Inc.
Page 5 of 37
This document contains information that is proprietary to MediaTek Inc.
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
LY
MOLY Make/Build Environment
and Procedures Design Document
评论