User manual

113
4.34.2 Getting running hardware model string
The operation of getting running hardware model string belongs to the class of operations
called “Versioning information support requests”. Such an operation is initiated by the
device instance. The CHARON core is defined as a target of the operation. This operation
can be used when CHAPI device need to use running hardware model string somehow,
e.g. to check that the running model is accepted for emulated device.
In order to perform the operation, the initiator invokes a routine identified by the
get_hardware_model field of the chapi_in descriptor. The procedure should be invoked like
follows from device instance:
char *hw_model_str;
…
if(ci && ci->get_hardware_model) {
hw_model_str = ci->get_hardware_model(ci);
}
else {
// No valid communication context – issue error message if necessary
hw_model_str = 0;
}
4.34.3 Getting running hardware name string
The operation of getting running hardware name string belongs to the class of operations
called “Versioning information support requests”. Such an operation is initiated by the
device instance. The CHARON core is defined as a target of the operation. This operation
can be used when CHAPI device need to use running hardware name string somehow.
In order to perform the operation, the initiator invokes a routine identified by the
get_hardware_name field of the chapi_in descriptor. The procedure should be invoked like
follows from device instance:
char *hw_name_str;
…
if(ci && ci->get_hardware_name) {
hw_name_str = ci->get_hardware_name(ci);
}
else {
// No valid communication context – issue error message if necessary
hw_name_str = 0;
}
4.34.4 Getting product copyright string
The operation of getting product copyright string belongs to the class of operations called
“Versioning information support requests”. Such an operation is initiated by the device
instance. The CHARON core is defined as a target of the operation. This operation can be
used when CHAPI device need to use product copyright string somehow, e.g. to make
combined copyright string for developed CHAPI device.