#============================================================================
#  Name:
#    ADS12.MIN
#
#  Description:
#    An includable component of the makefile to build the DMSS software for 
#    the SURF (Subscriber Unit Reference Design) using the MSM6025 (ARM) ASIC.
#
#    This file specifies the items necessary to build the DMSS using the 
#    ARM ADS 1.2 Arm Development Suite
#
#
# Assumptions:
#   1. The ARM ADS tools are in your path before any other versions of the 
#      ARM tools
#   2. Perl is available either locally or via the environment path.
#
# Copyright (c) 2003       by QUALCOMM, Incorporated.  All Rights Reserved.
#----------------------------------------------------------------------------
#============================================================================
#
#                        EDIT HISTORY FOR MODULE
#
# $Header: //depot/asic/msm6025/build/ms/ads12.min#1 $ $DateTime: 2003/07/07 18:01:27 $ $Author: jackl $
#
# when       who     what, where, why
# -------    ---     --------------------------------------------------------
# 07/07/03   jkl     Initial version created for MSM6025.
#============================================================================


#-------------------------------------------------------------------------------
# Build process output type
#-------------------------------------------------------------------------------

EXETYPE    = elf#               # Target image file format

#===============================================================================
#                             TOOL DEFINITIONS
#===============================================================================
# The following environment variables must be defined prior to using this make
# file: ARMBIN, ARMLIB, and ARMINC. In addition the PATH must be updated for
# the ARM tools.

#-------------------------------------------------------------------------------
# Software tool and environment definitions
#-------------------------------------------------------------------------------
CC         = tcc#               # ARM SDT Thumb 16-bit inst. set ANSI C compiler
ARMCC      = armcc#             # ARM SDT ARM 32-bit inst. set ANSI C compiler
CPPC       = tcpp#              # ARM ADS Thumb 16-bit ints. set C++ compiler
ASM        = armasm#            # ARM SDT assembler
ARMAR      = armar#             # ARM SDT library archiver
LD         = armlink#           # ARM SDT linker
HEXTOOL    = fromelf#           # ARM SDT utility to create hex file from image

OBJ_CMD    = -o#                # Command line option to specify output filename
DIRTCC     = perl dirtcc.pl#    # Utility to include directory name in mobile.o
ASM_SCRIPT = asm.pl#            # Perl script to include .h files in assembly
CAT_SCRIPT = cat.pl#            # Perl script to print output for assembly files

#-------------------------------------------------------------------------------
# Processor architecture options
#-------------------------------------------------------------------------------

CPU = -cpu ARM7TDMI#            # ARM7TDMI target processor

#-------------------------------------------------------------------------------
# ARM Procedure Call Standard (APCS) options
#-------------------------------------------------------------------------------

PCSZ     = 32bit#               # Program counter (PC) size
STACKCHK = noswst#              # No software stack checking support
FRAMEPTR = nofp#                # No frame pointer
FLOATPNT = softfp#              # Use software floating point library
INTRWORK = interwork#           # ARM/Thumb interworking support
NARROW   = narrow#              # Use caller parameter narrowing
REENTRNT = nonreentrant#        # No support for re-entrancy

APCS = -apcs /$(STACKCHK)/$(INTRWORK)

# NOTE:
# If software stack checking support is enabled, FEATURE_STACK_CHECK must be
# #defined in the cust*.h file to enable the required common services support.
#
# The following APCS options are obsolete in the ARM SDT 2.50 tools:
#   PCSZ
#   FRAMEPTR
#   REENTRNT

#-------------------------------------------------------------------------------
# Compiler output options
#-------------------------------------------------------------------------------

OUT = -c#                       # Object file output only

#-------------------------------------------------------------------------------
# Compiler/assembler debug options
#-------------------------------------------------------------------------------

DBG = -g -dwarf2#               # Enable DWARF2 format debug tables

#-------------------------------------------------------------------------------
# Compiler optimization options
#-------------------------------------------------------------------------------

OPT = -Ospace -O2#              # Full compiler optimization for space

#-------------------------------------------------------------------------------
# Compiler code generation options
#-------------------------------------------------------------------------------

END = -littleend#               # Compile for little endian memory architecture
ZA  = -za1#                     # LDR may only access 32-bit aligned addresses
ZAS = -zas4#                    # Min byte alignment for structures
ZAP = -zap0#                    # Struct ptrs NOT assumed to be aligned per -zas
ZAT = -zat1#                    # Min byte alignment for top-level static objects
ZZT = -zzt0#                    # Force uninitialized variables to ZI data area

CODE = $(END)

# NOTE:
# The -zap0 option is required due to a known ARM 2.50 compiler bug with
# pointers to struct sub-fields within __packed structs

#-------------------------------------------------------------------------------
# Include file search path options
#-------------------------------------------------------------------------------

INC = -I. -I"$(ARMINC)"#          # Search local dir, then ARM SDT \include dir

# NOTE:
# The -I. option allows memory.h to be found in the current directory when
# included using #include <memory.h>

#-------------------------------------------------------------------------------
# Compiler pragma emulation options
#-------------------------------------------------------------------------------

#PRAGMA = -zpcontinue_after_hash_error

# NOTE:
# The -zpcontinue_after_hash_error allows the compiler to continue when a
# #error statement is encountered.  This option also allows the compiler to
# continue when any other Error condition is encountered at compile time.
#        ** This option should be removed as soon as possible **

#-------------------------------------------------------------------------------
# Compiler error and warning message control options
#-------------------------------------------------------------------------------

MSG = -Wb#                      # No warnings for bit fields
NO_MSG = -W#                    # No warnings

#-------------------------------------------------------------------------------
# Additional compile time error checking options
#-------------------------------------------------------------------------------

CHK = -fa#                      # Check for data flow anomolies

#-------------------------------------------------------------------------------
# Linker options
#-------------------------------------------------------------------------------

MAP  = -map#                            # Memory map of all object file areas
INFO = -info sizes,totals,veneers#      # Info on object size and veneers
XREF = -xref#                           # List cross-references between files
VERB = -verbose#                        # Print verbose output messages
LIST = -list $(TARGET).map#             # Direct map and info output to file
SYM  = -symbols -symdefs $(TARGET).sym# # Direct symbol table to file
ifeq ($(USES_JAVA), yes)
SCLFILE    = msm6025j_4mb.scl#          # Target scatter load file if having Java
endif
LINK = -scatter $(SCLFILE)#             # Use scatter load description file



#-------------------------------------------------------------------------------
# Linker library options
#-------------------------------------------------------------------------------

CLIB  = "$(ARMLIB)"/armlib/c_t__un.l#           # ARM embedded ANSI C library
ifeq ($(USES_JAVA), yes)
CLIB = 
endif
ifeq ($(USES_MPEG4), yes)
CLIB = 
endif
LIBS = $(CLIB)

#-------------------------------------------------------------------------------
# Compiler flag definitions
#-------------------------------------------------------------------------------

CFLAGS0 = $(OUT) $(INC) $(CPU) $(APCS) $(CODE) $(PRAGMA) $(CHK) $(DBG) $(MSG)
CFLAGS  = $(CFLAGS0) $(OPT)

#-------------------------------------------------------------------------------
# Assembler flag definitions
#-------------------------------------------------------------------------------

AFLAGS = $(CPU) $(APCS) $(DBG)

#-------------------------------------------------------------------------------
# Linker flag definitions
#-------------------------------------------------------------------------------

LFLAGS = $(MAP) $(INFO) $(LIST) $(SYM) $(LINK) -noremove


#-------------------------------------------------------------------------------
# Hex file flag definitions
#-------------------------------------------------------------------------------
# Modifeid by JGX */
#HEXCMD = $(HEXTOOL) -i32 -o $(TARGET).hex $(TARGET).$(EXETYPE)
HEXCMD = $(HEXTOOL) -bin -o $(TARGET).bin $(TARGET).$(EXETYPE)

#-------------------------------------------------------------------------------
# Tools target definitions (used to echo tool information)
#-------------------------------------------------------------------------------

ARM_VERSION_BANNER = ARM TOOL VERSIONS
VER_FLAG = -vsn