Datasheet

ARMulator Reference

4.4.9 read

This function enables a debugger to read a coprocessor register via RDI. The function

reads the coprocessor register numbered

reg

and transfers its value to the location

addressed by

value

If the requested coprocessor register does not exist, or the register cannot be read, the

function must return

ARMul_CP_CANT

Syntax

unsigned read(void *handle, int reg, ARMword instr, ARMword *value)

where:

handle

is the handle from

ARMulif_InstallCoprocessorV5

reg

is the register number of the coprocessor register to be read.

instr

is not used.

value

is a pointer to the location of the data to be read from the coprocessor.

Return

The function must return one of:

•

ARMul_CP_DONE

, to indicate that the coprocessor operation is complete

•

ARMul_CP_CANT

, to indicate that the register is not supported.

Usage

This function is called by the debugger via RDI.