OS_ReadSysInfo 11 (changes)
Showing changes from revision #1 to #2:
Added | Removed | Changed
Programmer's OS Reference SWI Manuals Calls
» Part OS_ReadSysInfo 15 - SWI Calls
» OS_ReadSysInfo 11OS
» OS_ReadSysInfo
» OS_ReadSysInfo 11
OS_ReadSysInfo 11
(SWI &58)
| Entry | |
|---|---|
| R0 | 11 |
| Exit | |
|---|---|
| R0 | Pointer to debug character output function |
| R1 | Pointer to debug character input function |
Use
The purpose of this call is to obtain the addresses of functions that can be used to send and receive bytes to an external debugger. The two calls operate as follows:
Debug character output
| Entry | |
|---|---|
| R0 | Character to transmit |
| Exit | |
|---|---|
| R0-R3, PSR flags | Corrupted |
Debug character input
| Entry | |
|---|---|
| - | - |
| Exit | |
|---|---|
| R0 | Character received, or -1 if none available |
| R1-R3, PSR flags | Corrupted |
The functions are expected to be called from a privileged mode, with a valid stack pointer.
Notes
On RISC OS 5 this call returns pointers to code that wraps the HAL_DebugTX and HAL_DebugRX HAL calls. If either of the calls are unavailable OS_ReadSysInfo will return with an error.
On RISC OS Select, the call will return pointers to the debug input/output code managed by the SystemInit system.
For RISC OS 5, this call first became available in RISC OS 5.17.
See also
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.