The file <cyg/hal/omap_l1xx.h> can be included from application and eCos package sources to provide definitions related to OMAP subsystems. These include register definitions for the interrupt controller, power management controller, PLL clocks, memory controller, external bus interface, GPIO, USART, MMC/SD, Ethernet, timers RTC, and SPI subsystems. This file will normally be included automatically if <cyg/hal/hal_io.h> is included, which is the preferred way of getting these definitions.
Initialization Helper Macros
The file <cyg/hal/omap_l1xx_init.inc> contains definitions of helper macros which may be used by OMAP L1xx platform HALs in order to initialise common subsystems without excessive duplication between the platform HALs. Typically this file will be included by the hal_platform_setup.h header in the platform HAL, in turn included from the architectural HAL file vectors.S.
This file is solely intended to be used by platform HALs. At the same time, it is only present to assist initialization, and platform HALs are not obliged to use it if their startup requirements vary. NOTE: At present, the only extant OMAP L1xx port relies on either the TI-supplied User Boot Loader, or the JTAG initialization script, to initialize the PLLs and memory controller, so these macros currently largely contain ARM9-generic setup only.