VIRTUTECH CONFIDENTIAL    Previous - Up - Next

ragexl

Provided by

ragexl

Class Hierarchy

conf-object → log-object → ragexl

Interfaces Implemented

log_object, io_memory, pci_device, event_poster

Description

The Rage XL device implements the Mach64 graphics chipset from ATI Interactive, Inc. The device supports accelerated 2D graphics in multiple resolutions and color depths.

Attributes

Attributes inherited from class conf-object

attributes, classname, component, iface, name, object_id, queue

Attributes inherited from class log-object

access_count, log_buffer, log_buffer_last, log_buffer_size, log_group_mask, log_groups, log_level, log_type_mask

Attribute List

attrib_next_index

Optional attribute; read/write access; type: unknown type.

Decides whether the next 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: unknown type.

The address of the attribute controller register designated for the next access.

attrib_regs

Optional attribute; read/write access; type: unknown type.

(Register-0 ... Register-20) is a list of attribute registers.

attrib_video_enable

Optional attribute; read/write access; type: unknown type.

Decides whether video is enabled or not.

clut

Optional attribute; read/write access; type: unknown type.

(i0, i1, ..., i511). The Color Lookup Table.

config_register_info

Pseudo attribute; read-only access; type: [[isii]*].

Register info for all registered configuration registers. The format for each entry is (offset, name, size, write-mask).

config_registers

Optional attribute; read/write access; type: [i{64}]; integer indexed; indexed type: Integer.

The 64 PCI configuration registers, each 32 bits in size.

console

Optional attribute; read/write access; type: unknown type.

Console object that must implement either gfx-console or both the serial-device and extended-serial interfaces.

crtc_next

Optional attribute; read/write access; type: unknown type.

Integer register representing the next CRTC address.

crtc_regs

Optional attribute; read/write access; type: unknown type.

(Register-0 ... Register-24) is a list of CRTC registers.

dump_charset

Pseudo attribute; read/write access; type: unknown type.

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.

expansion_rom

Optional attribute; read/write access; type: [oii].

ROM object, map size, and map function number for the Expansion ROM.

fbdump

Pseudo attribute; write-only access; type: [i{5}].

Frame buffer dump command. See command help for more info

frame_buffer

Pseudo attribute; write-only access; type: Data.

Legacy - dont't use

gfx_latch

Optional attribute; read/write access; type: unknown type.

(Latch-0 ... Latch-4) List of four graphics data controller latches.

gfx_next

Optional attribute; read/write access; type: unknown type.

Represents the address of the graphics controller register designated for the next read/write access.

gfx_regs

Optional attribute; read/write access; type: unknown type.

(Register-0 ... Register-8) is a list of the nine graphics controller registers found in an VGA adapter.

gregs

Optional attribute; read/write access; type: unknown type.

Rage setup and control registers.

h_cnt

Optional attribute; read/write access; type: unknown type.

Horizontal counter (used for generating retrace signals).

image

Required attribute; read/write access; type: Object.

Image object containing the VRAM.

interrupt_pin

Optional attribute; read/write access; type: [iiii].

State of the interrupt pin.

mappings

Optional attribute; read/write access; type: [[i{5:8}]|[iiiiiiiio|nii]*].

List of all current PCI IO and memory mappings.

memory_space

Required attribute; read/write access; type: unknown type.

Memory space to which the device is mapped. Needed for dynamic remapping.

misc_reg

Optional attribute; read/write access; type: unknown type.

Miscellaneous output register.

pci_bus

Optional attribute; read/write access; type: Object or Nil.

The PCI bus this device is connected to, implementing the pci-bus interface.

pel_addr

Optional attribute; read/write access; type: unknown type.

PEL address register.

pel_mask

Optional attribute; read/write access; type: unknown type.

PEL mask register.

pel_next_color

Optional attribute; read/write access; type: unknown type.

Next color in access to PEL data register (read, green, or blue).

pel_pal

Optional attribute; read/write access; type: unknown type.

((red, green, blue) ... (red, green, blue)) List of 256 colors, each a tuple of red, green, and blue.

print_greg

Pseudo attribute; read/write access; type: unknown type.

Print GUI register contents.

print_sreg

Pseudo attribute; read/write access; type: unknown type.

Print setup register contents.

ramdac_rw_state

Optional attribute; read/write access; type: unknown type.

RAMDAC read/write state.

redraw

Pseudo attribute; write-only access; type: a.

Forces a complete update when set.

refresh_rate

Optional attribute; read/write access; type: unknown type.

Refresh rate (in Hertz).

seq_next

Optional attribute; read/write access; type: unknown type.

Represents the address of the sequence register designated for the next read/write access.

seq_regs

Optional attribute; read/write access; type: unknown type.

(Register-0 ... Register-4) is a list of sequence registers found in the VGA adapter.

sregs

Optional attribute; read/write access; type: unknown type.

Rage setup and control registers.

status

Optional attribute; read/write access; type: [i{15}].

Rage internal status.

status_cmd

Pseudo attribute; write-only access; type: a.

Shows some status on the rage device.

text_page

Pseudo attribute; read-only access; type: [s*].

A list representation (one line per element) of the text mode contents.

v_cnt

Optional attribute; read/write access; type: unknown type.

Vertical counter (used for generating retrace signals).

vga_memory

Pseudo attribute; write-only access; type: unknown type.

Contains the VGA memory (256 KB of data).

view_size_x

Pseudo attribute; read-only access; type: Integer.

With of the internal cache.

view_size_y

Pseudo attribute; read-only access; type: Integer.

Height of the internal cache.

write_masks

Optional attribute; read/write access; type: [[ii]*].

Write masks for all registered configuration registers. The format for each entry is (offset, mask).

Command List

Commands defined by interface log_object

log, log-group, log-level, log-size, log-type

Commands

fbdump	show part of rage framebuffer
info	Print device status
pci-header	print PCI device header
pgreg	print gui register contents
psreg	print setup register contents
redraw	Redraw display
refresh-rate	Set rate at which ragexl updated display
status	show rage status
text-dump	Print text contents of display

Command Descriptions

<ragexl>.fbdump

Synopsis

<ragexl>.fbdump fboffs width height [bpp] [stride]

Description

Display part of the ragexl framebuffer in the console window. fboffs is the starting offset into the 16 MB rage framebuffer. width and height are the pixel dimensions of the area to be shown. bpp (bits per pixel) specifies the format of the pixel data and can be one of 8, 16, 24 or 32 (defaults to current desktop color depth). stride is the byte offset between adjacent lines (defaults to width * bpp / 8).

<ragexl>.info

Synopsis

<ragexl>.info

Description

Print information about the device registers.

<ragexl>.pci-header

Synopsis

<ragexl>.pci-header

Description

Print the PCI header, i.e the configuration registers.

<ragexl>.pgreg

Synopsis

<ragexl>.pgreg reg

Description

Print GUI register contents

<ragexl>.psreg

Synopsis

<ragexl>.psreg reg

Description

Print Setup register contents

<ragexl>.redraw

Synopsis

<ragexl>.redraw

Description

This command sends the current frame buffer contents of the simulated video device to the graphics console. If a simulated cursor is active, it is updated as well.

<ragexl>.refresh-rate

Synopsis

<ragexl>.refresh-rate [rate]

Description

Set the rate at which the ragexl device updates the display.
The default is 1000 Hz (simulated). NOTE: The rate is currently the same for all ragexl devices.

<ragexl>.status

Synopsis

<ragexl>.status [verbose]

Description

Show information about the current rage state, for example the current resolution, color depth, desktop image offset etc. Currently the verbose flag has no function.

<ragexl>.text-dump

Synopsis

<ragexl>.text-dump

Description

Print the contents of the display in text mode.

VIRTUTECH CONFIDENTIAL    Previous - Up - Next