Variant hal – Comtrol eCos User Manual

Page 310

Advertising
background image

Chapter 11. Porting Guide

Note that many of the definitions in these files are only conditionally defined - if the equivalent variant or platform
headers provide the definitions, those override the generic architecture definitions.

File

Description

include/arch.inc

Various assembly macros used during system
initialization.

include/basetype.h

Endian, label, alignment, and type size definitions.
These override common defaults in CYGPKG_INFRA.

include/hal_arch.h

Saved register frame format, various thread, register and
stack related macros.

include/hal_cache.h

Cache definitions and cache control macros.

include/hal_intr.h

Exception and interrupt definitions. Macros for
configuring and controlling interrupts. eCos real-time
clock control macros.

include/hal_io.h

Macros for accessing IO devices.

include/

<

arch

>

_regs.h

Architecture register definitions.

include/

<

arch

>

_stub.h

Architecture stub definitions. In particular the register
frame layout used by GDB. This may differ from the
one used by eCos.

include/

<

arch

>

.inc

Architecture convenience assembly macros.

src/

<

arch

>

.ld

Linker macros.

src/context.S

Functions handling context switching and
setjmp/longjmp.

src/hal_misc.c

Exception and interrupt handlers in C. Various other
utility functions.

src/hal_mk_defs.c

Used to export definitions from C header files to
assembler header files.

src/hal_intr.c

Any necessary interrupt handling functions.

src/

<

arch

>

stub.c

Architecture stub code. Contains functions for
translating eCos exceptions to UNIX signals and
functions for single-stepping.

src/vectors.S

Exception, interrupt and early initialization code.

Variant HAL

Some variant HALs may add extra files for variant specific serial drivers, or for handling interrupts/exceptions if it
makes sense.

Note that these files may be mostly empty if the CPU variant can be controlled by the generic architecture macros.
The definitions present are only conditionally defined - if the equivalent platform headers provide the definitions,
those override the variant definitions.

File

Description

206

Advertising