Common hal, Architecture hal – Comtrol eCos User Manual

Page 309

Advertising
background image

Chapter 11. Porting Guide

please try to follow it as closely as possible. Still, no two targets are the same, so sometimes it makes sense to use
additional files.

Common HAL

File

Description

include/dbg-thread-syscall.h

Defines the thread debugging syscall function. This is
used by the ROM monitor to access the thread
debugging API in the RAM application. .

include/dbg-threads-api.h

Defines the thread debugging API. .

include/drv_api.h

Defines the driver API.

include/generic-stub.h

Defines the generic stub features.

include/hal_if.h

Defines the ROM/RAM calling interface API.

include/hal_misc.h

Defines miscellaneous helper functions shared by all
HALs.

include/hal_stub.h

Defines eCos mappings of GDB stub features.

src/dbg-threads-syscall.c

Thread debugging implementation.

src/drv_api.c

Driver API implementation. Depending on
configuration this provides either wrappers for the
kernel API, or a minimal implementation of these
features. This allows drivers to be written relying only
on HAL features.

src/dummy.c

Empty dummy file ensuring creation of libtarget.a.

src/generic-stub.c

Generic GDB stub implementation. This provides the
communication protocol used to communicate with
GDB over a serial device or via the network.

src/hal_if.c

ROM/RAM calling interface implementation. Provides
wrappers from the calling interface API to the eCos
features used for the implementation.

src/hal_misc.c

Various helper functions shared by all platforms and
architectures.

src/hal_stub.c

Wrappers from eCos HAL features to the features
required by the generic GDB stub.

src/stubrom/stubrom.c

The file used to build eCos GDB stub images. Basically
a cyg_start function with a hard coded breakpoint.

src/thread-packets.c

More thread debugging related functions.

src/thread-pkts.h

Defines more thread debugging related function.

Architecture HAL

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

205

Advertising