User manual

107
4.25 Intercept bus address space (CHARON deep integration)
The operation of intercepting bus address space belongs to the class of operations called
“Bus adapter support requests”, Using this function could require Stromasys consulting.
Such an operation is initiated by the device instance. The CHARON core is defined as a
target of the operation. This operation is commonly used in bus adapter’s implementation
when it is necessary to intercept the whole address space of particular bus.
In order to perform the operation, the initiator invokes a routine identified by the
intercept_bus_address_space field of the chapi_in descriptor. The procedure is invoked as
follows:
const chapi_in * ci = …;
if (ci->intercept_bus_address_space) {
ci-> intercept_bus_address_space (ci);
}
The example above shows that the CHARON core is not obliged to support the indicated
operation. It also shows why the loadable component instance must retain the chapi_in
descriptor.
4.26 Release bus address space (CHARON deep integration)
The operation of releasing bus address space belongs to the class of operations called
“Bus adapter support requests”, Using this function could require Stromasys consulting.
Such an operation is initiated by the device instance. The CHARON core is defined as a
target of the operation. This operation is commonly used in bus adapter’s implementation
when it is necessary to release intercepted bus address space of particular bus.
In order to perform the operation, the initiator invokes a routine identified by the
release_bus_address_space field of the chapi_in descriptor. The procedure is invoked as
follows:
const chapi_in * ci = …;
if (ci->release_bus_address_space) {
ci->release_bus_address_space (ci);
}
The example above shows that the CHARON core is not obliged to support the indicated
operation. It also shows why the loadable component instance must retain the chapi_in
descriptor.
4.27 Get configured RAM size
The operation of getting configured RAM size belongs to the class of operations called
“Replacement hardware support requests”. Such an operation is initiated by the device
instance. The CHARON core is defined as a target of the operation. This operation is
used to define the size of configured memory in bytes.