The magic-character-capture class is used to capture an output character instead of sending it further, done by using a magic instruction. This class serves as an user example.
conf_object, log_object
- cell-change
- Notifier that is triggered after the object's cell was changed.
- object-delete
- Notifier that is triggered just before Simics object is deleted.
- queue-change
- Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.
-
info
– print information about the object
-
status
– print status of the object
-
magic_number
-
Optional attribute;
read/write access; type:
i
Magic number to use
-
chars
-
Pseudo attribute;
read-only access; type:
i
Number of captured characters
-
enabled
-
Optional attribute;
read/write access; type:
b
If the capture is enabled or not, even if the callback is installed
-
add_carriage_return
-
Optional attribute;
read/write access; type:
b
Add a carriage return for each new line character when output is redirected to a serial console. Default is true.
-
config
-
Optional attribute;
read/write access; type:
[[oso]*]
Configure information for the CPUs that can execute the magic instruction. It is a list of a list of three elements. Each sublist consists of the CPU, the communication register for the CPU, and a serial console to connect the captured output to. The registered name must be accessible through the int_register interface in the CPU.
magic-character-capture