packages/hal/arm/sa11x0/sa1100mm/v2_0/cdl/hal_arm_sa11x0_sa1100mm.cdl

   1 # ====================================================================
   2 #
   3 #      hal_arm_sa11x0_sa1100mm.cdl
   4 #
   5 #      ARM SA1100/Multimedia platform HAL package configuration data
   6 #
   7 # ====================================================================
   8 #####ECOSGPLCOPYRIGHTBEGIN####
   9 ## -------------------------------------------
  10 ## This file is part of eCos, the Embedded Configurable Operating System.
  11 ## Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
  12 ##
  13 ## eCos is free software; you can redistribute it and/or modify it under
  14 ## the terms of the GNU General Public License as published by the Free
  15 ## Software Foundation; either version 2 or (at your option) any later version.
  16 ##
  17 ## eCos is distributed in the hope that it will be useful, but WITHOUT ANY
  18 ## WARRANTY; without even the implied warranty of MERCHANTABILITY or
  19 ## FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  20 ## for more details.
  21 ##
  22 ## You should have received a copy of the GNU General Public License along
  23 ## with eCos; if not, write to the Free Software Foundation, Inc.,
  24 ## 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
  25 ##
  26 ## As a special exception, if other files instantiate templates or use macros
  27 ## or inline functions from this file, or you compile this file and link it
  28 ## with other works to produce a work based on this file, this file does not
  29 ## by itself cause the resulting work to be covered by the GNU General Public
  30 ## License. However the source code for this file must still be made available
  31 ## in accordance with section (3) of the GNU General Public License.
  32 ##
  33 ## This exception does not invalidate any other reasons why a work based on
  34 ## this file might be covered by the GNU General Public License.
  35 ##
  36 ## Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
  37 ## at http://sources.redhat.com/ecos/ecos-license/
  38 ## -------------------------------------------
  39 #####ECOSGPLCOPYRIGHTEND####
  40 # ====================================================================
  41 ######DESCRIPTIONBEGIN####
  42 #
  43 # Author(s):      dmoseley
  44 # Original data:  gthomas
  45 # Contributors:
  46 # Date:           2000-10-25
  47 #
  48 #####DESCRIPTIONEND####
  49 #
  50 # ====================================================================
  51 cdl_package CYGPKG_HAL_ARM_SA11X0_SA1100MM {
  52     display       "ARM SA1100/Multimedia evaluation board"
  53     parent        CYGPKG_HAL_ARM_SA11X0
  54     hardware
  55     include_dir   cyg/hal
  56     define_header hal_arm_sa11x0_sa1100mm.h
  57     description   "
  58         This HAL platform package provides generic
  59         support for the Intel StrongARM SA1100 based evalation board,
  60         known as 'SA1100 Multimedia'."
  61
  62     compile       sa1100mm_misc.c
  63
  64     implements    CYGINT_HAL_DEBUG_GDB_STUBS
  65     implements    CYGINT_HAL_DEBUG_GDB_STUBS_BREAK
  66     implements    CYGINT_HAL_VIRTUAL_VECTOR_SUPPORT
  67
  68     implements    CYGHWR_HAL_ARM_SA11X0_UART1
  69     implements    CYGHWR_HAL_ARM_SA11X0_UART3
  70
  71     define_proc {
  72         puts $::cdl_system_header "#define CYGBLD_HAL_TARGET_H   <pkgconf/hal_arm.h>"
  73         puts $::cdl_system_header "#define CYGBLD_HAL_VARIANT_H  <pkgconf/hal_arm_sa11x0.h>"
  74         puts $::cdl_system_header "#define CYGBLD_HAL_PLATFORM_H <pkgconf/hal_arm_sa11x0_sa1100mm.h>"
  75         puts $::cdl_header "#define HAL_PLATFORM_CPU    \"StrongARM 1100\""
  76         puts $::cdl_header "#define HAL_PLATFORM_BOARD  \"Multimedia development system\""
  77         puts $::cdl_header "#define HAL_PLATFORM_EXTRA  \"\""
  78         puts $::cdl_header "#define HAL_ARCH_PROGRAM_NEW_STACK sa1100mm_program_new_stack"
  79     }
  80
  81     cdl_component CYG_HAL_STARTUP {
  82         display       "Startup type"
  83         flavor        data
  84         default_value {"RAM"}
  85         legal_values  {"RAM" "ROM"}
  86         no_define
  87         define -file system.h CYG_HAL_STARTUP
  88         description   "
  89            When targetting the SA1100 Multimedia eval board it is possible to build
  90            the system for either RAM bootstrap or ROM bootstrap(s). Select
  91            'ram' when building programs to load into RAM using eCos GDB
  92            stubs.  Select 'rom' when building a stand-alone application
  93            which will be put into ROM, or for the special case of
  94            building the eCos GDB stubs themselves."
  95     }
  96
  97     cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_CONSOLE_CHANNEL_BAUD {
  98         display       "Diagnostic serial port baud rate"
  99         flavor        data
 100         legal_values  9600 19200 38400 115200
 101         default_value 38400
 102         description   "
 103             This option selects the baud rate used for the diagnostic port.
 104             Note: this should match the value chosen for the GDB port if the
 105             diagnostic and GDB port are the same."
 106     }
 107
 108     cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_DEBUG_CHANNEL_BAUD {
 109         display       "GDB serial port baud rate"
 110         flavor        data
 111         legal_values  9600 19200 38400 115200
 112         default_value 38400
 113         description   "
 114             This option selects the baud rate used for the diagnostic port.
 115             Note: this should match the value chosen for the GDB port if the
 116             diagnostic and GDB port are the same."
 117     }
 118
 119     cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_COMM_CHANNELS {
 120         display      "Number of communication channels on the board"
 121         flavor       data
 122         calculated   2
 123     }
 124
 125     cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_CONSOLE_CHANNEL_DEFAULT {
 126         display      "Default console channel."
 127         active_if    CYGPRI_HAL_VIRTUAL_VECTOR_CONSOLE_CHANNEL_CONFIGURABLE
 128         flavor       data
 129         legal_values     0 to CYGNUM_HAL_VIRTUAL_VECTOR_COMM_CHANNELS-1
 130         calculated   1
 131     }
 132
 133     cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_DEBUG_CHANNEL {
 134         display          "Debug serial port"
 135         active_if        CYGPRI_HAL_VIRTUAL_VECTOR_DEBUG_CHANNEL_CONFIGURABLE
 136         flavor data
 137         legal_values     0 to CYGNUM_HAL_VIRTUAL_VECTOR_COMM_CHANNELS-1
 138         default_value    1
 139         description      "
 140             The multimedia board has two serial ports. This option
 141             chooses which port will be used to connect to a host
 142             running GDB."
 143      }
 144
 145      cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_CONSOLE_CHANNEL {
 146          display          "Diagnostic serial port"
 147          flavor data
 148          legal_values     0 to CYGNUM_HAL_VIRTUAL_VECTOR_COMM_CHANNELS-1
 149          default_value    CYGNUM_HAL_VIRTUAL_VECTOR_CONSOLE_CHANNEL_DEFAULTk
 150          description      "
 151             The multimedia board has two serial ports.  This option
 152             chooses which port will be used for diagnostic output."
 153      }
 154
 155     cdl_component CYGBLD_GLOBAL_OPTIONS {
 156         display "Global build options"
 157         flavor  none
 158         no_define
 159         description   "
 160             Global build options including control over
 161             compiler flags, linker flags and choice of toolchain."
 162
 163
 164         parent  CYGPKG_NONE
 165
 166         cdl_option CYGBLD_GLOBAL_COMMAND_PREFIX {
 167             display "Global command prefix"
 168             flavor  data
 169             no_define
 170             default_value { "arm-elf" }
 171             description "
 172                 This option specifies the command prefix used when
 173                 invoking the build tools."
 174         }
 175
 176         cdl_option CYGBLD_GLOBAL_CFLAGS {
 177             display "Global compiler flags"
 178             flavor  data
 179             no_define
 180             default_value { "-mcpu=strongarm1100 -Wall -Wpointer-arith -Wstrict-prototypes -Winline -Wundef -Woverloaded-virtual -g -O2 -ffunction-sections -fdata-sections -fno-rtti -fno-exceptions -fvtable-gc -finit-priority -mapcs-frame" }
 181             description   "
 182                 This option controls the global compiler flags which are used to
 183                 compile all packages by default. Individual packages may define
 184                 options which override these global flags."
 185         }
 186
 187         cdl_option CYGBLD_GLOBAL_LDFLAGS {
 188             display "Global linker flags"
 189             flavor  data
 190             no_define
 191             default_value { "-Wl,--gc-sections -Wl,-static -g -O2 -nostdlib" }
 192             description   "
 193                 This option controls the global linker flags. Individual
 194                 packages may define options which override these global flags."
 195         }
 196
 197         cdl_option CYGBLD_BUILD_GDB_STUBS {
 198             display "Build GDB stub ROM image"
 199             default_value 0
 200             requires { CYG_HAL_STARTUP == "ROM" }
 201             requires CYGSEM_HAL_ROM_MONITOR
 202             requires CYGBLD_BUILD_COMMON_GDB_STUBS
 203             requires CYGDBG_HAL_DEBUG_GDB_INCLUDE_STUBS
 204             requires CYGDBG_HAL_DEBUG_GDB_BREAK_SUPPORT
 205             requires CYGDBG_HAL_DEBUG_GDB_THREAD_SUPPORT
 206             requires ! CYGDBG_HAL_COMMON_INTERRUPTS_SAVE_MINIMUM_CONTEXT
 207             requires ! CYGDBG_HAL_COMMON_CONTEXT_SAVE_MINIMUM
 208             no_define
 209             description "
 210                 This option enables the building of the GDB stubs for the
 211                 board. The common HAL controls takes care of most of the
 212                 build process, but the final conversion from ELF image to
 213                 binary data is handled by the platform CDL, allowing
 214                 relocation of the data if necessary."
 215
 216             make -priority 320 {
 217                 <PREFIX>/bin/gdb_module.bin : <PREFIX>/bin/gdb_module.img
 218                 $(OBJCOPY) -O binary $< $@
 219             }
 220         }
 221     }
 222
 223
 224     cdl_option CYGSEM_HAL_USE_ROM_MONITOR {
 225          display       "Work with a ROM monitor"
 226          flavor        booldata
 227          legal_values  { "Generic" "GDB_stubs" }
 228          default_value { CYG_HAL_STARTUP == "RAM" ? "GDB_stubs" : 0 }
 229          parent        CYGPKG_HAL_ROM_MONITOR
 230          requires      { CYG_HAL_STARTUP == "RAM" }
 231          description   "
 232              Support can be enabled for different varieties of ROM monitor.
 233              This support changes various eCos semantics such as the encoding
 234              of diagnostic output, or the overriding of hardware interrupt
 235              vectors.
 236              Firstly there is \"Generic\" support which prevents the HAL
 237              from overriding the hardware vectors that it does not use, to
 238              instead allow an installed ROM monitor to handle them. This is
 239              the most basic support which is likely to be common to most
 240              implementations of ROM monitor.
 241              \"GDB_stubs\" provides support when GDB stubs are included in
 242              the ROM monitor or boot ROM."
 243     }
 244
 245     cdl_component CYGPKG_HAL_ARM_SA11X0_SA1100MM_OPTIONS {
 246         display "StrongARM SA1100/Multimedia build options"
 247         flavor  none
 248         no_define
 249         description   "
 250             Package specific build options including control over
 251             compiler flags used only in building this package,
 252             and details of which tests are built."
 253
 254
 255         cdl_option CYGPKG_HAL_ARM_SA11X0_SA1100MM_CFLAGS_ADD {
 256             display "Additional compiler flags"
 257             flavor  data
 258             no_define
 259             default_value { "" }
 260             description   "
 261                 This option modifies the set of compiler flags for
 262                 building the StrongARM SA1100 Multimedia HAL. These flags are used in addition
 263                 to the set of global flags."
 264         }
 265
 266         cdl_option CYGPKG_HAL_ARM_SA11X0_SA1100MM_CFLAGS_REMOVE {
 267             display "Suppressed compiler flags"
 268             flavor  data
 269             no_define
 270             default_value { "" }
 271             description   "
 272                 This option modifies the set of compiler flags for
 273                 building the StrongARM SA1100 Multimedia HAL. These flags are removed from
 274                 the set of global flags if present."
 275         }
 276
 277         cdl_option CYGPKG_HAL_ARM_SA11X0_SA1100MM_TESTS {
 278             display "StrongARM SA1100/Multimedia tests"
 279             flavor  data
 280             no_define
 281 #            calculated { "tests/dram-test" }
 282             calculated { "" }
 283             description   "
 284                 This option specifies the set of tests for the StrongARM SA1100 Multimedia HAL."
 285         }
 286     }
 287
 288     cdl_component CYGHWR_MEMORY_LAYOUT {
 289         display "Memory layout"
 290         flavor data
 291         no_define
 292         calculated { CYG_HAL_STARTUP == "RAM" ? "arm_sa11x0_sa1100mm_ram" : \
 293                                                 "arm_sa11x0_sa1100mm_rom" }
 294
 295         cdl_option CYGHWR_MEMORY_LAYOUT_LDI {
 296             display "Memory layout linker script fragment"
 297             flavor data
 298             no_define
 299             define -file system.h CYGHWR_MEMORY_LAYOUT_LDI
 300             calculated { CYG_HAL_STARTUP == "RAM" ? "<pkgconf/mlt_arm_sa11x0_sa1100mm_ram.ldi>" : \
 301                                                     "<pkgconf/mlt_arm_sa11x0_sa1100mm_rom.ldi>" }
 302         }
 303
 304         cdl_option CYGHWR_MEMORY_LAYOUT_H {
 305             display "Memory layout header file"
 306             flavor data
 307             no_define
 308             define -file system.h CYGHWR_MEMORY_LAYOUT_H
 309             calculated { CYG_HAL_STARTUP == "RAM" ? "<pkgconf/mlt_arm_sa11x0_sa1100mm_ram.h>" : \
 310                                                     "<pkgconf/mlt_arm_sa11x0_sa1100mm_rom.h>" }
 311         }
 312     }
 313
 314     cdl_option CYGSEM_HAL_ROM_MONITOR {
 315         display       "Behave as a ROM monitor"
 316         flavor        bool
 317         default_value 0
 318         parent        CYGPKG_HAL_ROM_MONITOR
 319         requires      { CYG_HAL_STARTUP == "ROM" }
 320         description   "
 321             Enable this option if this program is to be used as a ROM monitor,
 322             i.e. applications will be loaded into RAM on the board, and this
 323             ROM monitor may process exceptions or interrupts generated from the
 324             application. This enables features such as utilizing a separate
 325             interrupt stack when exceptions are generated."
 326     }
 327
 328     cdl_option CYGBLD_BUILD_REDBOOT_BIN {
 329         display       "Build Redboot ROM binary image"
 330         active_if     CYGBLD_BUILD_REDBOOT
 331         default_value 1
 332         no_define
 333         description "This option enables the conversion of the Redboot ELF
 334                      image to a binary image suitable for ROM programming."
 335
 336         make -priority 325 {
 337             <PREFIX>/bin/redboot.bin : <PREFIX>/bin/redboot.elf
 338             $(OBJCOPY) --strip-debug $< $(@:.bin=.img)
 339             $(OBJCOPY) -O srec $< $(@:.bin=.srec)
 340             $(OBJCOPY) -O binary $< $@
 341         }
 342     }
 343 }