This interface is implemented by devices that can be mapped into address spaces (including port spaces). The map() function is called for an object when it initially is mapped into the address space, and operation() is called when the object is accessed through an address space.
The obj argument is a pointer to the mapped object and map_info contains information about how and where the device is mapped into memory. The memory_or_io argument to map() identifies the type of the address space where the device is mapped. The mem_op argument to operate() contains information about the access.
The offset into the device mapping for the access is typically calculated in the following way:
offset = mem_op->physical_address - map_info.base + map_info.start
The return value from map() is currently not used and should be always be 0.
The exception_type_t type, that is the same as pseudo_exception_t, returned by the operation() function may be used to signal errors to Simics, but should in most cases be Sim_PE_No_Exception. If the device does not support inquiry accesses, it should return Sim_PE_Inquiry_Unhandled if mem_op->inqury is 1.
typedef enum {
Sim_Addr_Space_Conf,
Sim_Addr_Space_IO,
Sim_Addr_Space_Memory
} addr_space_t;
typedef int (*map_func_t)(conf_object_t *NOTNULL obj,
addr_space_t memory_or_io,
map_info_t map_info);
typedef exception_type_t (*operation_func_t)(
conf_object_t *NOTNULL obj,
generic_transaction_t *NOTNULL mem_op,
map_info_t map_info);
typedef struct io_memory_interface {
map_func_t map;
operation_func_t operation;
} io_memory_interface_t;
#define IO_MEMORY_INTERFACE "io_memory"