vga

Description

The VGA device implements a standard VGA graphics adapter. Most graphics modes are supported, but non-standard graphics settings may not work as on a real adapter. Modes known to work fairly well are: 0x0, 0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0xd, 0xe, 0xf, 0x10, 0x11, 0x12, 0x13 and modeX. Limitations: Not all possible video modes are tested. Read Mode 1 is not yet implemented. Panning is not supported. Split Screen is not supported. Blinking text is not supported. Blinking color in video mode 0xf is not supported. Underlining in MDA compatibility mode is not supported. Extend ninth bit in text mode is not implemented.

Interfaces Implemented

conf_object, log_object, video, io_memory, vga_text, vga_update, vga_text_info

Notifiers

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.

Commands for this class

info – print information about the object
redraw – redraw display
refresh-rate – set refresh rate for the display
status – print status of the object
text-dump – print text contents of display
wait-for-string – wait for substring in text mode

Attributes

memory_space: Required attribute; read/write access; type: o
Memory space to which the device is mapped. Needed for dynamic remapping.
console: Optional attribute; read/write access; type: o|n
Console object that must implement either gfx_con or gfx_console or both the serial_device and extended_serial interfaces.
crtc_regs: Optional attribute; read/write access; type: [i*]
(Register-0 ... Register-24) is a list of CRTC registers.
crtc_next: Optional attribute; read/write access; type: i
Integer register representing the next CRTC address.
attrib_regs: Optional attribute; read/write access; type: [i*]
(Register-0 ... Register-20) is a list of attribute registers.
attrib_next_index: Optional attribute; read/write access; type: i
Decides whether the next access to an attribute controller register (through port 0x3C0) will contain an address or data.
attrib_next_reg: Optional attribute; read/write access; type: i
The address of the attribute controller register designated for the next access.
attrib_video_enable: Optional attribute; read/write access; type: i
Decides whether video is enabled or not.
seq_regs: Optional attribute; read/write access; type: [i*]
(Register-0 ... Register-4) is a list of sequence registers found in the VGA adapter.
seq_next: Optional attribute; read/write access; type: i
Represents the address of the sequence register designated for the next read/write access.
gfx_regs: Optional attribute; read/write access; type: [i*]
(Register-0 ... Register-8) is a list of the nine graphics controller registers found in an VGA adapter.
gfx_next: Optional attribute; read/write access; type: i
Represents the address of the graphics controller register designated for the next read/write access.
gfx_latch: Optional attribute; read/write access; type: [iiii]
(Latch-0 ... Latch-4) List of four graphics data controller latches.
pel_mask: Optional attribute; read/write access; type: i
PEL mask register.
ramdac_rw_state: Optional attribute; read/write access; type: i
RAMDAC read/write state.
pel_addr: Optional attribute; read/write access; type: i
PEL address register.
pel_next_color: Optional attribute; read/write access; type: i
Next color in access to PEL data register (read, green, or blue).
pel_pal: Optional attribute; read/write access; type: [[iii]{256}]
((red, green, blue) ... (red, green, blue)) List of 256 colors, each a tuple of red, green, and blue.
misc_reg: Optional attribute; read/write access; type: i
Miscellaneous output register.
h_cnt: Optional attribute; read/write access; type: i
Horizontal counter (used for generating retrace signals).
v_cnt: Optional attribute; read/write access; type: i
Vertical counter (used for generating retrace signals).
refresh_rate: Optional attribute; read/write access; type: i
Refresh rate (in hertz). Set to 0 to disable screen refresh
text_refresh_rate: Optional attribute; read/write access; type: i
Rate (in hertz) of virtual time that VGA text data is sent to the console. Set to 0 to disable text refresh
refresh_based_on_virtual_time: Optional attribute; read/write access; type: b
If TRUE, then the refresh rate will refresh the screen based on virtual time, otherwise the refresh will be based on real time. Real time is the default.
image: Required attribute; read/write access; type: o
Image object containing the VRAM.
redraw: Pseudo attribute; write-only access; type: a
Forces a complete update when set.
text_page: Pseudo attribute; read-only access; type: n|[s*]
A list representation (one line per element) of the text mode contents.
view_size_x: Pseudo attribute; read-only access; type: i
With of the internal cache.
view_size_y: Pseudo attribute; read-only access; type: i
Height of the internal cache.
dump_charset: Pseudo attribute; read/write access; type: i
Write-only pseudo attribute. A write operation will print the current character map to the console if the vga device is in alpha-numeric mode.
vga_memory: Pseudo attribute; write-only access; type: d
Contains the VGA memory (256 KB of data).

Provided By

vga