# Usage

To use the HAL library functions, the HAL library must be included via the project’s *.rteconfig file, under Libraries. Additionally, the rsl15.h header file must be included in the application source.

The HAL functions follow Sys_<hardware block>_<function> name syntax, with:

- <hardware block> indicating the system component being configured or acted upon
  - In some cases, the hardware block is prefixed by a standard operation such as Set_ or `Get_`
- <function> describing the functionality implemented by the HAL firmware

Simple wrapper macros, with the same names but capitalized, are also provided for many functions. These macros do not require a user application to provide a pointer to the block being configured or operated upon, as the macros default to the first instance available. For example, SYS_I2C_CONFIG is a macro that calls the Sys_I2C_Config function with I2C0 for the pointer parameter.

For the complete HAL library API, refer to Hardware Abstraction Layer Reference.