MIPS32 HAL Port — Implementation Details
This documentation explains how the eCos HAL specification has been mapped onto the MIPS hardware and should be read in conjunction with the manuals for the processor in use. It should be noted that the variant HAL is usually complemented by an architecture HAL and a platform HAL, and those may affect or redefine some parts of the implementation.
The variant HAL provides header
header files export the functionality of this HAL to the
architecture HAL, and are included automatically by the
architecture HAL where needed.
Additionally, the variant HAL provides
header, which is included into the architecture assembly code and
redefines some macros used there, to configure the architecture
to the MIPS32 variant.
The MIPS32 HAL does no additional initialization beyond the redefined assembly macros mentioned above. As a purely CPU-based variant there are no additional variant-specific devices to be initialized.
Interrupts and Exceptions
The MIPS32 HAL defines some additional exception vectors that are present in MIPS32 variants. Otherwise it takes no part in interrupt or exception delivery.
The MIPS32 HAL provides replacement implementations of the
HAL_MSBIT_INDEX macros that use inline
assembly CLZ instructions.
The main contribution that the MIPS32 HAL makes is in cache handling. It provides cache handling macros that extend and modify those supplied in the architecture HAL. It also implements cache enable and disable support via the K0 field of the Config0 register. It also provides default cache dimension declarations, as well as a mechanism for these to be defined by the platform HAL.
The MIPS32 HAL provides the main linker script for use by all platforms.
The MIPS32 HAL will generate the linker script for eCos
applications. This involves the file
src/mips_mips32.ld and a
.ldi memory layout file, typically provided
by the platform HAL. It is the
which places code and data in the appropriate places for the
startup type, but most of the hard work is done via macros in the
|2023-08-15||eCosPro Non-Commercial Public License|