1 # ====================================================================
5 # Intel SA110/285 (EBSA285) HAL package configuration data
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.
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.
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
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.
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.
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.
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####
48 #####DESCRIPTIONEND####
50 # ====================================================================
51 cdl_package CYGPKG_HAL_ARM_EBSA285 {
52 display "Intel EBSA285 StrongARM evaluation boards"
54 define_header hal_arm_ebsa285.h
58 The EBSA285 HAL package provides the support needed to run
59 eCos on a Intel EBSA285 StrongARM eval board."
61 compile hal_diag.c ebsa285_misc.c mem285.S
63 implements CYGINT_HAL_DEBUG_GDB_STUBS
64 implements CYGINT_HAL_DEBUG_GDB_STUBS_BREAK
65 implements CYGINT_HAL_VIRTUAL_VECTOR_SUPPORT
66 implements CYGINT_HAL_ARM_MEM_REAL_REGION_TOP
67 implements CYGINT_HAL_ARM_ARCH_STRONGARM
70 puts $::cdl_system_header "#define CYGBLD_HAL_TARGET_H <pkgconf/hal_arm.h>"
71 puts $::cdl_system_header "#define CYGBLD_HAL_PLATFORM_H <pkgconf/hal_arm_ebsa285.h>"
72 puts $::cdl_header "#define HAL_PLATFORM_CPU \"StrongARM 110\""
73 puts $::cdl_header "#define HAL_PLATFORM_BOARD \"EBSA-285\""
74 puts $::cdl_header "#define HAL_PLATFORM_EXTRA \"\""
75 puts $::cdl_header "#define HAL_ARCH_PROGRAM_NEW_STACK ebsa285_program_new_stack"
77 puts $::cdl_header "#define CYGPRI_KERNEL_TESTS_DHRYSTONE_PASSES 1000000"
80 cdl_component CYG_HAL_STARTUP {
81 display "Startup type"
84 legal_values {"RAM" "ROM" "ROMRAM"}
86 define -file system.h CYG_HAL_STARTUP
88 When targetting the EBSA285 eval board it is possible to build
89 the system for either RAM bootstrap or ROM bootstrap(s). Select
90 'ram' when building programs to load into RAM using onboard
91 debug software such as Angel or eCos GDB stubs. Select 'rom'
92 when building a stand-alone application which will be put
93 into ROM. Using ROMRAM will allow the program to exist in
94 ROM, but be copied to RAM during startup."
97 cdl_option CYGHWR_HAL_ARM_EBSA285_PCI_MEM_MAP_BASE {
98 display "Base of memory accessible via PCI space"
100 legal_values { 0x200000 0x300000 0x400000 0x500000
101 0x600000 0x700000 0x800000 0x900000
102 0xa00000 0xb00000 0xc00000 0xd00000
105 default_value 0x00f00000
106 active_if CYGPKG_IO_PCI
108 This option determines the base of the EBSA memory which
109 can be accessed via the PCI bus. The default is to allow
110 access to the upper 1MB of a 16MB system.
111 NB: We advise *against* changing this option.
112 The value MUST match the base address of the section
113 'pci_window' in the Memory Layout Tool else this memory area
114 will be consumed by the malloc heap.
115 This error condition can only be detected at runtime in
116 current versions of the configuration tools.
117 CLI users can edit include/pkgconf/mlt_arm_ebsa285_*.h
118 and include/pkgconf/mlt_arm_ebsa285_*.ldi to achieve the
119 same effects as moving that region in the MLT."
122 cdl_option CYGHWR_HAL_ARM_EBSA285_PCI_MEM_MAP_SIZE {
123 display "Size of memory accessible via PCI space"
125 legal_values { 0x100000 0x200000 0x300000 0x400000
126 0x500000 0x600000 0x700000 0x800000
128 default_value 0x00100000
129 active_if CYGPKG_IO_PCI
131 This option determines the size of the EBSA memory which
132 can be accessed via the PCI bus. The default is to allow
133 access to the upper 1MB of a 16MB system.
134 NB: We advise *against* changing this option.
135 The value MUST match the size of the section 'pci_window' in the
136 Memory Layout Tool else this memory area will be consumed by the
138 Further caveats in the PCI base option."
141 cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_CONSOLE_CHANNEL_DEFAULT {
142 display "Default console channel."
147 cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_COMM_CHANNELS {
148 display "Number of communication channels on the board"
153 cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_DEBUG_CHANNEL {
154 display "Debug serial port"
155 active_if CYGPRI_HAL_VIRTUAL_VECTOR_DEBUG_CHANNEL_CONFIGURABLE
157 legal_values 0 to CYGNUM_HAL_VIRTUAL_VECTOR_COMM_CHANNELS-1
160 The EBSA285 board has only one serial port. This option
161 chooses which port will be used to connect to a host
165 cdl_option CYGNUM_HAL_VIRTUAL_VECTOR_CONSOLE_CHANNEL {
166 display "Diagnostic serial port"
167 active_if CYGPRI_HAL_VIRTUAL_VECTOR_CONSOLE_CHANNEL_CONFIGURABLE
169 legal_values 0 to CYGNUM_HAL_VIRTUAL_VECTOR_COMM_CHANNELS-1
170 default_value CYGNUM_HAL_VIRTUAL_VECTOR_CONSOLE_CHANNEL_DEFAULT
172 The EBSA285 board has only one serial port. This option
173 chooses which port will be used for diagnostic output."
176 # Real-time clock/counter specifics
177 cdl_component CYGNUM_HAL_RTC_CONSTANTS {
178 display "Real-time clock constants"
181 cdl_option CYGNUM_HAL_RTC_NUMERATOR {
182 display "Real-time clock numerator"
184 default_value 1000000000
186 cdl_option CYGNUM_HAL_RTC_DENOMINATOR {
187 display "Real-time clock denominator"
191 cdl_option CYGNUM_HAL_RTC_PERIOD {
192 display "Real-time clock period"
194 default_value 36800 ;# Timer3 clock is 3.68MHz
198 cdl_component CYGBLD_GLOBAL_OPTIONS {
199 display "Global build options"
202 Global build options including control over
203 compiler flags, linker flags and choice of toolchain."
208 cdl_option CYGBLD_GLOBAL_COMMAND_PREFIX {
209 display "Global command prefix"
212 default_value { "arm-elf" }
214 This option specifies the command prefix used when
215 invoking the build tools."
218 cdl_option CYGBLD_GLOBAL_CFLAGS {
219 display "Global compiler flags"
222 default_value { "-mcpu=strongarm -Wall -Wpointer-arith -Wstrict-prototypes -Winline -Wundef -Woverloaded-virtual -g -O2 -ffunction-sections -fdata-sections -fno-rtti -fno-exceptions -fvtable-gc -finit-priority" }
224 This option controls the global compiler flags which are used to
225 compile all packages by default. Individual packages may define
226 options which override these global flags."
229 cdl_option CYGBLD_GLOBAL_LDFLAGS {
230 display "Global linker flags"
233 default_value { "-Wl,--gc-sections -Wl,-static -g -O2 -nostdlib" }
235 This option controls the global linker flags. Individual
236 packages may define options which override these global flags."
239 cdl_option CYGBLD_BUILD_GDB_STUBS {
240 display "Build GDB stub ROM image"
242 requires { CYG_HAL_STARTUP == "ROM" }
243 requires CYGSEM_HAL_ROM_MONITOR
244 requires CYGBLD_BUILD_COMMON_GDB_STUBS
245 requires CYGDBG_HAL_DEBUG_GDB_INCLUDE_STUBS
246 requires CYGDBG_HAL_DEBUG_GDB_BREAK_SUPPORT
247 requires CYGDBG_HAL_DEBUG_GDB_THREAD_SUPPORT
248 requires ! CYGDBG_HAL_COMMON_INTERRUPTS_SAVE_MINIMUM_CONTEXT
249 requires ! CYGDBG_HAL_COMMON_CONTEXT_SAVE_MINIMUM
252 This option enables the building of the GDB stubs for the
253 board. The common HAL controls takes care of most of the
254 build process, but the final conversion from ELF image to
255 binary data is handled by the platform CDL, allowing
256 relocation of the data if necessary."
259 <PREFIX>/bin/gdb_module.bin : <PREFIX>/bin/gdb_module.img
260 $(OBJCOPY) -O binary $< $@
265 cdl_component CYGPKG_HAL_ARM_EBSA285_OPTIONS {
266 display "StrongARM EBSA285 build options"
269 Package specific build options including control over
270 compiler flags used only in building this package,
271 and details of which tests are built."
274 cdl_option CYGPKG_HAL_ARM_EBSA285_CFLAGS_ADD {
275 display "Additional compiler flags"
280 This option modifies the set of compiler flags for
281 building the StrongARM EBSA285 HAL. These flags are used in addition
282 to the set of global flags."
285 cdl_option CYGPKG_HAL_ARM_EBSA285_CFLAGS_REMOVE {
286 display "Suppressed compiler flags"
291 This option modifies the set of compiler flags for
292 building the StrongARM EBSA285 HAL. These flags are removed from
293 the set of global flags if present."
296 cdl_option CYGPKG_HAL_ARM_EBSA285_TESTS {
297 display "StrongARM EBSA285 tests"
300 calculated { "tests/sdram0" }
302 This option specifies the set of tests for the StrongARM EBSA285 HAL."
306 cdl_component CYGHWR_MEMORY_LAYOUT {
307 display "Memory layout"
310 calculated { (CYG_HAL_STARTUP == "RAM") ? "arm_ebsa285_ram" :
311 (CYG_HAL_STARTUP == "ROMRAM") ? "arm_ebsa285_romram" :
314 cdl_option CYGHWR_MEMORY_LAYOUT_LDI {
315 display "Memory layout linker script fragment"
318 define -file system.h CYGHWR_MEMORY_LAYOUT_LDI
319 calculated { (CYG_HAL_STARTUP == "RAM") ? "<pkgconf/mlt_arm_ebsa285_ram.ldi>" :
320 (CYG_HAL_STARTUP == "ROMRAM") ? "<pkgconf/mlt_arm_ebsa285_romram.ldi>" :
321 "<pkgconf/mlt_arm_ebsa285_rom.ldi>" }
324 cdl_option CYGHWR_MEMORY_LAYOUT_H {
325 display "Memory layout header file"
328 define -file system.h CYGHWR_MEMORY_LAYOUT_H
329 calculated { (CYG_HAL_STARTUP == "RAM") ? "<pkgconf/mlt_arm_ebsa285_ram.h>" :
330 (CYG_HAL_STARTUP == "ROMRAM") ? "<pkgconf/mlt_arm_ebsa285_romram.h>" :
331 "<pkgconf/mlt_arm_ebsa285_rom.h>" }
335 cdl_option CYGSEM_HAL_ROM_MONITOR {
336 display "Behave as a ROM monitor"
339 parent CYGPKG_HAL_ROM_MONITOR
340 requires { CYG_HAL_STARTUP == "ROM" || CYG_HAL_STARTUP == "ROMRAM" }
342 Enable this option if this program is to be used as a ROM monitor,
343 i.e. applications will be loaded into RAM on the board, and this
344 ROM monitor may process exceptions or interrupts generated from the
345 application. This enables features such as utilizing a separate
346 interrupt stack when exceptions are generated."
349 cdl_option CYGSEM_HAL_USE_ROM_MONITOR {
350 display "Work with a ROM monitor"
352 legal_values { "Generic" "GDB_stubs" }
353 default_value { CYG_HAL_STARTUP == "RAM" ? "GDB_stubs" : 0 }
354 parent CYGPKG_HAL_ROM_MONITOR
355 requires { CYG_HAL_STARTUP == "RAM" }
357 Support can be enabled for different varieties of ROM monitor.
358 This support changes various eCos semantics such as the encoding
359 of diagnostic output, or the overriding of hardware interrupt
361 Firstly there is \"Generic\" support which prevents the HAL
362 from overriding the hardware vectors that it does not use, to
363 instead allow an installed ROM monitor to handle them. This is
364 the most basic support which is likely to be common to most
365 implementations of ROM monitor.
366 \"GDB_stubs\" provides support when GDB stubs are included in
367 the ROM monitor or boot ROM."
370 cdl_component CYGPKG_REDBOOT_HAL_OPTIONS {
371 display "Redboot HAL options"
374 parent CYGPKG_REDBOOT
375 active_if CYGPKG_REDBOOT
377 This option lists the target's requirements for a valid Redboot
380 cdl_option CYGBLD_BUILD_REDBOOT_BIN {
381 display "Build Redboot ROM binary image"
382 active_if CYGBLD_BUILD_REDBOOT
385 description "This option enables the conversion of the Redboot ELF
386 image to a binary image suitable for ROM programming."
389 <PREFIX>/bin/redboot.bin : <PREFIX>/bin/redboot.elf
390 $(OBJCOPY) --strip-debug $< $(@:.bin=.img)
391 $(OBJCOPY) -O srec $< $(@:.bin=.srec)
392 $(OBJCOPY) -O binary $< $@