Comtrol eCos - Manual (Page 13)

10. Exception Handling ................................................................................................................................ 197
HAL Startup ....................................................................................................................................... 197
Vectors and VSRs ............................................................................................................................... 198
Default Synchronous Exception Handling ......................................................................................... 200
Default Interrupt Handling ................................................................................................................. 200
11. Porting Guide ......................................................................................................................................... 203
Introduction ........................................................................................................................................ 203
HAL Structure .................................................................................................................................... 203
HAL Classes ............................................................................................................................. 203
File Descriptions ....................................................................................................................... 204
Common HAL ................................................................................................................. 205
Architecture HAL ............................................................................................................ 205
Variant HAL .................................................................................................................... 206
Platform HAL .................................................................................................................. 207
Auxiliary HAL ................................................................................................................ 208
Virtual Vectors (eCos/ROM Monitor Calling Interface) .................................................................... 208
Virtual Vectors .......................................................................................................................... 208
Initialization (or Mechanism vs. Policy) ......................................................................... 208
Pros and Cons of Virtual Vectors .................................................................................... 209
Available services ............................................................................................................ 210
The COMMS channels ............................................................................................................. 210
Console and Debugging Channels .................................................................................. 210
Mangling ......................................................................................................................... 211
Controlling the Console Channel .................................................................................... 211
Footnote: Design Reasoning for Control of Console Channel ........................................ 212
The calling Interface API .......................................................................................................... 213
Implemented Services ..................................................................................................... 213
Compatibility ................................................................................................................... 214
Implementation details .................................................................................................... 215
New Platform Ports ......................................................................................................... 215
New architecture ports ..................................................................................................... 215
IO channels ............................................................................................................................... 215
Available Procedures ....................................................................................................... 216
Usage ............................................................................................................................... 217
Compatibility ................................................................................................................... 218
Implementation Details ................................................................................................... 218
New Platform Ports ......................................................................................................... 218
HAL Coding Conventions .................................................................................................................. 219
Implementation issues ............................................................................................................... 219
Source code details ................................................................................................................... 220
Nested Headers ......................................................................................................................... 221
Platform HAL Porting ........................................................................................................................ 221
HAL Platform Porting Process ................................................................................................. 222
Brief overview ................................................................................................................. 222
Step-by-step ..................................................................................................................... 222
Minimal requirements ............................................................................................ 223
Adding features ...................................................................................................... 224
Hints ................................................................................................................................ 225
xiii