A fast and easily customised operating system
for ARM devices
HAL_Reset
Hardware Abstraction Layer
HAL entry points from RISC OS
» HAL_Reset
HAL_Reset
(HAL entry #84)
void HAL_Reset(int type,void *l1pt)
| Entry | |
|---|---|
| type | Reset type: |
| 0 = Hard reset and turn the power off (i.e. just turn the power off) | |
| 1 = Hard reset and leave the power on | |
| >1 = Reserved | |
| l1pt | Pointer to level 1 page table |
| Exit | |
|---|---|
| - | This call does not return |
Use
This resets the board depending on the value in type. Asking HAL_PlatformInfo will tell you if the hardware allows the power to be turned off by software, if it doesn’t then behaviour is per type = 1.
A pointer to the level 1 page table is provided in order to allow platforms which lack software-accessible hardware reset (e.g. IOMD) to implement their own soft reset mechanism. E.g. by disabling the MMU and restarting the HAL/ROM image.
User software must always use SWI OS_Reset instead of calling this entry directly.