README.md

nRFx HAL

The HAL provided with this models is a modified version of the real nRFx HAL Its main purpose is to allow unmodified Zephyr code to run directly using this repository HW models.

There is two main differences in this HAL compared to the real one:

• The peripherals base addresses point to the HW models register IF instead of to hardcoded HW addresses.
  For example NRF_PPI_BASE is defined as (&NRF_PPI_regs), where NRF_PPI_regs is the HW models structure containing the PPI model registers

• When a HW register with sideeffects is written, the appropriate HW model function is called to trigger that sideeffect.
  
  A sideeffect should be understood as some activity beyond the modification of the register itself. For example, in real HW, writting a 1 to NRF_RNG->TASKS_START will start the random number generation. When using the HW models, doing this write in itself would only change that memory location content. To trigger the actual sideeffect the function nrf_rng_regw_sideeffects_TASK_START() needs to be called. This replacement HAL functions take care of that.

Note that this HAL version should be, wherever possible, a copy of the official nRFx HAL, with only minor differences due to what is described above. And normally most differences between the official version and this one will be simply due to this not having been updated yet.

Note that, so far, this replacement HAL only provides a small subset of the whole nRFx API: Mostly the functions and types used by the current Zephyr BLE controller and necessary drivers, and only for the peripherals which are part of these models. It is certainly possible to expand it to cover the whole API.