Aticonfighelp: Difference between revisions
From cchtml.com
(Updated with Catalyst 10.6 aticonfig output) |
(No difference)
|
Latest revision as of 04:07, 20 June 2010
Usage: aticonfig [OPTION] ... Parses an existing X-Server configuration file and modifies it to operate with ATI products.
The following command-line options can be invoked as parameters:
ATI Initial Configuration:
--initial
Generate a default ATI device section in the configuration file which
is capable of loading the fglrx driver.
--initial=dual-head
Same as '--initial' but generate a basic dual head configuration file.
--initial=check
Identifies if the fglrx driver is present in configuration file.
TV Options:
--tvf, --tv-format-type=STRING
Change the TV signal format. STRING can be one of:
NTSC-M
NTSC-JPN
NTSC-N
PAL-B
PAL-COMB-N
PAL-D
PAL-G
PAL-H
PAL-I
PAL-K
PAL-K1
PAL-L
PAL-M
PAL-N
PAL-SECAM-D
PAL-SECAM-K
PAL-SECAM-K1
PAL-SECAM-L
Note: Not all graphics cards support every mode. Regional
settings are applicable.
--tvs, --tv-standard-type=STRING
Change the TV standard for TV output. STRING can be one of:
VIDEO
SCART
YUV
--tv-overscan={on|off}
Enable or disable overscan mode for TVout
Note, not all tv-formats support overscan. Try to
toggle overscan off before changing tv-format if
and error occurs.
--tv-info
Print out the current tv geometry, tv format, and if the
tv is physically connected.
--tv-geometry=WIDTHxHEIGHT{+|-}X{+|-}Y
=WIDTHxHEIGHT
Change the size and position of the TVout display.
WIDTH and HEIGHT are in percentage units. Please note
that the valid range for WIDTH and HEIGHT depends on
the tv-format selected. However, as a rule of thumb
WIDTH and HEIGHT are valid in the range [1,100]
X and Y are pixels offsets from centre
of the screen. X and Y are have variable ranges dependant
on ASIC. Use tv-info to get valid X and Y ranges
If tv-geometry is invoked with just width and height
then X and Y are assumed to be 0
See example 5 below for a sample usage.
FireGL Workstation Board Features:
--app, --use-app-profile=STRING
Change the application profile for a FireGL workstation board.
STRING can be one of:
default
maya
softimage-xsi
softimage-3d
houdini4.0
houdini5.0
houdini5.5
Screen-Related Options:
--ovt, --overlay-type=STRING
Change the overlay for the X server. STRING can be one of:
opengl
disable
--ovon, --overlay-on={0|1}
Choose which head the hardware overlay should be visible on. The
hardware overlay can be used for either OpenGL, video, pseudo-color
or stereo.
--lcd, --lcd-mode=STRING
Change the LCD mode. STRING can be one of:
center
full
--dtop, --desktop-setup=STRING
Change the desktop setup for multiple display adapters.
STRING can be one of:
single 1 screen, second dark
mirror 2 screens - same content, identical
refresh rate/resolution
Note: This option is NOT supported with Avivo
clone 2 screens - same content, allows for
different refresh rates/resolutions
horizontal 2 screens - one framebuffer,
screen 1 right of screen 0
horizontal,reverse 2 screens - one framebuffer,
screen 1 left of screen 0
vertical 2 screens - one framebuffer,
screen 1 above of screen 0
vertical,reverse 2 screens - one framebuffer,
screen 1 below of screen 0
Note: This option is not valid if '--initial=dual-head' is specified.
--vs, --sync-vsync={on|off}
Enable/disable sync buffer swaps with vsync. Enable this option to
prevent tearing during 3D rendering.
--psc, --pseudo-color={on|off}
Enable/disable pseudo-color visuals. Enable this option to get 16-bit
color support.
--sm, --stereo-mode={active | passive | passiveInvertHorz | passiveInvertVert | horizontalInterleave | verticalInterleave | off}
Enable/disable stereo support. Enable active option only for
applications that support the use of hardware 3D shutter glasses.
For the use of passive, passiveInvertHorz, passiveInvertVert, horizontalInterleave and verticalInterleave modes
specialized monitor equipment is required.
--resolution=Screen#,W1xH1,W2xH2,W3xH3,...
Set the modes for the specified screen. You may specify several
resolutions separated by commas.
Screens start at 0. You can use 1 for dual-head
--hsync=Screen#,LOW-HIGH
Change the horizontal sync range of the specified monitor. Make sure
you know the capabilities of your monitor before changing this option.
Screens start at 0. You can use 1 for dual-head
--vrefresh=Screen#,LOW-HIGH
Change the vertical refresh range of the specified monitor. Make sure
you know the capabilities of your monitor before changing this option.
Screens start at 0. You can use 1 for dual-head
--hsync2=LOW-HIGH
Change the horizontal sync range of the second display. Make sure you
know the capabilities of your monitor before changing this option.
--vrefresh2=LOW-HIGH
Change the vertical refresh range of the second display. Make sure you
know the capabilities of your monitor before changing this option.
--mode2=W1xH1,W2XH2,W3xH3,...
Change the modes for the second display. You may specify several
resolutions separated by commas. Only valid for clone and big desktop
settings.
--screen-layout={left|right|above|below}
Set the secondary screen position for dual head.
--screen-overlap=NUM
Set the screen overlap region in big desktop mode to be NUM pixels.
--force-monitor=STRING[,STRING...]
Describe all displays that are to be enabled and/or disabled regardless
of physical connection. STRING can be one or more of the following
set, separated by commas:
crt1
crt2
lvds
tv
cv
tmds1
tmds2
tmds2i
dfp3
dfp4
dfp5
dfp6
nocrt1
nocrt2
nolvds
notv
nocv
notmds1
notmds2
notmds2i
nodfp3
nodfp4
nodfp5
nodfp6
Advanced Options:
--sync-video={on|off}
Enable/disable sync to vsync for AVIVO video.
This option is enabled by default and is used to prevent
video tearing. By disabling this option video is free to
render as fast as the 3D engine can handle. In the case of
choppy video try to disable sync-video.
--tls={on|off}
Enable/disable fast thread local storage. Disable this option when
virtual machines or WineX fail to work properly.
--sb, --signal-block={on|off}
Enable/disable signal blocking. Disable this option when debugging a
multi-threaded OpenGL application.
--locked-userpages={on|off}
Enable/disable locked user pages. Disable this option if the system
hangs when running fgl_glxgears.
User page lock is no longer available on AGP system now.
--max-gart-size=VALUE1,VALUE2
Set user-defined max total GART size(VALUE1) and cacheable gart
size(VALUE2) for non-AGP systems.
This option can combined with --adapter option to set the gart size
for individual card.
Dynamic Display Management Options:
Following options will not change the config file. They are
used for querying driver, controller and adaptor information.
These options will be effective immediately. Other options on
the same command line will be ignored.
--enable-monitor=STRING,STRING
Setting current monitor to be enabled. Only 2 displays
can be enabled at the same time. Any displays
that are not on the list will be disabled.
STRING can be one of the following set, separated
by commas:
none
crt1
crt2
lvds
tv
cv
tmds1
tmds2
tmds2i
dfp3
dfp4
dfp5
dfp6
auto -- use default policy to enable the displays.
--query-monitor
This will return connected and enabled monitor information
--swap-monitor
This only works for big desktop setup. This will swap the
contents on the two monitors.
--swap-screens={on|off}
Enable/disable swap heads in dual-head mode.
This option works only in dual-head mode.
Pair mode options:
Following options are used for query add and remove pair modes.
These options will be effective immediately. Other options on
the same command line will be ignored.
--list-pairmode
list all the current existing pair modes the driver can use.
--add-pairmode=width0xheight0+width1xheight1
Add one pair mode to the list. width0 and height0 are the
size of primary display and width1 and height1 for the
secondary display.
--remove-pairmode=index
Remove one pair mode from the list. User can get index by
list-pairmode.
External Events Daemon Options:
Following options will not change the config file. They are
used to send commands to the atieventsd external events daemon.
--set-policy=STRING
Sets the event policy for the daemon to be STRING.
See the atieventsd(8) manpage for further details.
Display attribute options:
Following options are used for query and set adjustment of
specific attribute for specific display. These options will be
effective immediately. Other options on the same command line
will be ignored.
The DISPLAYTYPE in options can be one of the following strings:
crt1, lvds, tv, cv, tmds1, crt2,
tmds2, tmds2i, dfp3, dfp4, dfp5, dfp6 .
The ATTRIBTYPE in options can be one of the following strings:
brightness, contrast, saturation, hue, positionX,
positionY, sizeX, sizeY, overscan, videoStandard
--query-dispattrib=DISPLAYTYPE,ATTRIBTYPE
query the specific adjustment info of the specific display.
if ATTRIBTYPE is not specified, all supported attribute
information will be printed out.
--set-dispattrib=DISPLAYTYPE,ATTRIBTYPE:VALUE
set the attribute value of the specific display.
Connector type options:
Following options are used for query connector type
for specific display. These options will be
effective immediately. Other options on the same command line
will be ignored.
The DISPLAYTYPE in options can be one of the following strings:
crt1, lvds, tv, cv, tmds1, crt2,
tmds2, tmds2i, dfp3, dfp4, dfp5, dfp6 .
--query-connectortype=DISPLAYTYPE
query the connector type of the specific display.
Component video dongle options:
Following options are used for query and set dongles for a
component video. These options will be effective immediately.
Other options on the same command line will be ignored.
--query-cvdongle
query dongle setting informations of the component video.
--set-cvdongle=VALUE
set the custom override value of the CV dongle.
--reset-cvdongle
reset the custom override setting(to zero)of the CV dongle.
Component video customized mode options:
Following options are used for query and set customized mode for
component video. These options will be effective immediately.
Other options on the same command line will be ignored.
--query-cvmode
query customized modes for component video.
--add-cvmode=WIDTH,HEIGHT,FLAGS,BASEWIDTH,BASEDHEIGHT,REFRESH.
add a customized mode for component video.
--validate-cvmode=WIDTH,HEIGHT,FLAGS,BASEWIDTH,BASEHEIGHT,REFRESH.
validate a customized mode for component video.
--delete-cvmode=INDEX
delete one customized mode for component video.
Persistent Configuration Store (PCS) Options:
Following options will not change the config file. They are
used to manipulate the PCS database. Due to their nature, these.
commands may only be run by the root user. Note that the prefix
and key names are not case-sensitive.
--get-pcs-key=PREFIX,KEY
Prints out the specified prefix and key from the PCS
database. The type of data will be shown along with
the contents.
--set-pcs-u32=PREFIX,KEY,VALUE
--set-pcs-val=PREFIX,KEY,VALUE (deprecated)
Sets an integer value at the specified prefix and key in
the PCS database. The value may be specified in hex by
prefixing it with 0x or in octal by prefixing it with 0,
otherwise the value is assumed to be in decimal. Note
that --set-pcs-val is deprecated and --set-pcs-u32 should
be used instead. --set-pcs-val will be removed soon.
--set-pcs-u32array=PREFIX,KEY,VALUE[,VALUE]...
Sets an array of integer values at the specified prefix
and key in the PCS database. The values may be specified
in hex by prefixing it with 0x or in octal by prefixing
it with 0, otherwise the value is assumed to be in decimal.
(e.g. --set-pcs-u32array="TestSection,TestData,1,0x2,3")
--set-pcs-str=PREFIX,KEY,STRING
Sets a string value at the specified prefix and key in
the PCS database.
--set-pcs-raw=PREFIX,KEY,HEXSTRING
Sets a raw binary value at the specified prefix and key in
the PCS database. The value is specified as a series of
hex bytes with no 0x or spaces.
(e.g. --set-pcs-raw="TestSection,TestData,E84C0E" sets 3 bytes)
--set-pcs-bool=PREFIX,KEY,VALUE
Sets a boolean value at the specified prefix and key in
the PCS database. The value may be specified as either
"true", "yes", "on", "enable" or "1" meaning boolean TRUE or
"false", "no", "off", "disable" or "0" meaning boolean FALSE.
--del-pcs-key=PREFIX,KEY
Deletes the specified prefix and key from the PCS database.
Multiple display adapter options:
Following options are used for querying and setting up multiple
display adapters that are installed for multihead or Crossfire
configurations.
--lsa, --list-adapters
Lists all detected and supported display adapters.
The default adapter (used when --adapter is not specified)
will be indicated with a "*" next to it.
--adapter=ADAPTERLIST
Selects which adapters returned by --list-adapters should
be affected by other aticonfig options. ADAPTERLIST contains
either a comma-seperated sequence of the index numbers of the
adapters to be affected or else contains the keyword "all" to
select all the adapters. If --adapter is missing, only the
default adapter will be affected.
--lscc, --list-crossfire-candidates
Queries the driver to determine the pool of available devices that can
can be chained together for CrossFire.
--lscs, --list-crossfire-status
List current Crossfire status (enabled or disabled) along with diagnostics
information indicates the status of your system
--lsch, --list-crossfire-chains
Lists the CrossFire chains that are currently defined along with their
enabled state
--cfa, --add-crossfire-chain
Defines a new CrossFire chain. --adapter should contain the adapter
chain definition, with the master adapter being the first entry and
the slave adapters being the subsequent entries in order of priority.
--cfd, --delete-crossfire-chain
Delete and existing defined CrossFire chain. --adapter should list the
master adapters of the chains to be deleted. --adapter=all will delete
all chain definitions.
--cf, --crossfire={on|off}
Enables/disables CrossFire support on the currently defined CrossFire
chains. --adapter should list the master adapters to be enabled or
disabled.
--cfl, --crossfire-logo={on|off}
Enables/disables the appearance of the CrossFire Logo when rendering
in CrossFire mode
ATI Overdrive (TM) options:
The following options are used to get and set current and peak, core
and memory clock information as well as read the current temperature of
adapters. By using the "--adapter=" argument the ATI Overdrive (TM)
options can be targeted to a particular adapter in a multi-adapter scenario.
If no adapter is explicitly targeted the commands will be run on the Default
adapter as indicated by the "--list-adapters" command
--od-enable
Unlocks the ability to change core or memory clock values by
acknowledging that you have read and understood the ATI Overdrive (TM)
disclaimer and accept responsibility for and recognize the potential
dangers posed to your hardware by changing the default core or memory
clocks
--od-disable
Disables ATI Overdrive(TM) set related aticonfig options. Previously
commited core and memory clock values will remain, but will not be set
on X Server restart.
--odgc, --od-getclocks
Lists various information regarding current core and memory clock
settings.
Including: current and peak clocks
the theoretical range clocks can be set to
the current load on the GPU
--odsc, --od-setclocks={NewCoreClock|0,NewMemoryClock|0}
Sets the core and memory clock to the values specified in MHz
The new clock values must be within the theoretical ranges provided
by --od-getclocks. If a 0 is passed as either the NewCoreClock or
NewMemoryClock it will retain the previous value and not be changed.
There is no guarantee that the attempted clock values will succeed
even if they lay inside the theoretical range. These newly set
clock values will revert to the default values if they are not
committed using the "--od-commitclocks" command before X is
restarted
--odrd, --od-restoredefaultclocks
Sets the core and memory clock to the default values.
Warning X needs to be restarted before these clock changes will take
effect
--odcc, --od-commitclocks
Once the stability of a new set of custom clocks has been proven this
command will ensure that the Adapter will attempt to run at these new
values whenever X is restarted
--odgt, --od-gettemperature
Returns the temperature reported by any thermal sensors available on
the adapter.
ACPI Options:
--acpi-services=on|off
Enable/disable ACPI services. In the case of BIOS or kernel ACPI issues,
ACPI services in the driver can be disabled through this option.
The ACPI services are enabled by default.
--acpi-display-switch=on|off
Enable/disable display switching with ACPI methods on mobile platforms.
This option is enabled by default.
Genlock/Framelock options:
The following options are used to control operation with GLSYNC module
in the system. By using the "--adapter=" argument --glsync-getconfig,
--glsync-setconfig, --glsync-getgenlock, --glsync-setgenlock options
can be targeted to a particular adapter in a multi-adapter scenario.
If no adapter is explicitly targeted the commands will be run on the Default
adapter as indicated by the "--list-adapters" command
--glsync-getport={RJ45_1 | RJ45_2 | BNC}
Get configuration state for specified GLSync port.
Including: Number of LEDs
Scanned frequency
Signal Source for RJ45 port if it is configured as output
Port state (Input or Output) for RJ45 port
Signal type for BNC port
--glsync-setport=port_type,cntl,sig_src
Set configuration for specified GLSync port
Parameters: port_type - RJ45_1 or RJ45_2
only RJ45 ports can be configured
cntl - 0 if port is configured as input or
1 if port is configured as output
sig_src - signal source for GL Sync port
if 0-3 - GPU port index
if RJ45_1, RJ45_2 or BNC - another GL Sync port
if -1 - signal source is undefined
--glsync-getconfig
Get timing configuration for particular GL Sync connector
Including: Sync Delay in ms
Signal Source
Sample Rate
Sync field
Trigger Edge
Scan Rate multiplier
GPU port index this adapter connected to
--glsync-setconfig=delay,fr_cntl,sig_src,smpl_rate,fld,edge,coef
Set timing configuration for GL Sync connector
Parameters: delay - Sync Delay in ms
fr_cntl - Enable/Disable framlock control
0 Disable Framelock
1 Enable Framelock
sig_src - Signal Source for this adapter.
if 0-3 - GPU port index.
It can not be GPU port index of this adapter
if RJ45_1, RJ45_2 or BNC - GL Sync port
if -1 - signal source is undefined
smpl_rate - Sample Rate for sampled sync signal.
0 for no sampling
fld - Sync field for interlaced sync signal.
0 if sync field is undefined
1 if synced to both field
2 if synced to field 1
edge - it is defined which signal edge
should trigger syncronization
0 if edge is undefined
1 if it is triggered by raising edge
2 if it is triggered by falling edge
3 if it is triggered by both edges
coef - Scan Rate multiplier applied to sync signal
0 if coef is undefined
1 if coef is 5
2 if coef is 4
3 if coef is 3
4 if coef is 2.5
5 if coef is 2
6 if coef is 1.33
7 if coef is 1.25
8 if coef is 1.
9 if coef is 0.8
10 if coef is 0.67
11 if coef is 0,5
12 if coef is 0.4
13 if coef is 0.33
14 if coef is 0.25
15 if coef is 0.2
Note: Some parameters may not be valid for manual configuration.
Please use --glsync-getconfig command to verify.
--glsync-getgenlock=disp_type
Get genlock mode for particular display
disp_type - Display Type. When RandR 1.2 and above is enabled
can be query by using xrandr -q command.
If RandR 1.2 is not enabled
aticonfig --query-monitor command should be used
to query this parameter
--glsync-setgenlock=disp_type,mode,timing_server
Set genlock mode for particular display
Parameters: disp_type - Display Type.
When RandR 1.2 and above is enabled
can be query by using xrandr -q command.
If RandR 1.2 is not enabled
aticonfig --query-monitor command
should be used to query this parameter.
mode - Enable/Disable Genlock
0 Disable Genlock
1 Enable Genlock
timing_server - Enable/Disable timing server
0 to configure display as free run
1 to configure display as a timing server
--glsync-restart
Reinitialized all genlock settings after power down system
X Server Options:
--xinerama={on|off}
Enable/disable Xinerama (MultiView) in the X Server configuration file.
MultiView allows for the merging of independent desktop heads into a
unified workspace allowing windows to freely cross X Screen boundaries.
Miscellaneous Options:
-v, --verbose
Show what aticonfig is doing.
-q, --quiet
Disable all information output except for errors.
--effective={now,startup}
Choose when the requested changes should take effect.
now: Immediately. This change will affect the running X
session if applicable. Only 'set-powerstate' and
'overlay-on' are applicable for now.
startup: On future X server startups. This change will modify the
X server configuration file if applicable.
The default is 'now,startup', i.e., do both as applicable.
--nobackup
Do not make an automatic backup of the configuration file.
-i, --input=FILE
Select a FILE to input as the configuration file. Set FILE to '-' to
pipe from standard input. Without this option, aticonfig will search
/etc/X11 for the default configuration file.
-o, --output=FILE
Select a FILE to output the new configuration file to. Set FILE to '-'
to print to standard output. Without this option, aticonfig will
replace the input file with the newly generated file.
-h, --help
Display this help screen.
-f, --force
Only valid with 'initial' option. Force aticonfig to generate default
Monitor, Device, and Screen sections even if the original configuration
file has invalid settings in these sections.
Composite options:
--xv-pixmap-buffer-type=gartcacheable
Allocate pixmap buffer from GART cacheable heap.
--xv-pixmap-buffer-type=lfb
Allocate pixmap buffer from local framebuffer.
--xv-pixmap-buffer-type=gartuswc
Allocate pixmap buffer from GART USWC heap.
Examples:
1. Setting up fglrx for the first time.
Single head : aticonfig --initial --input=/etc/X11/xorg.conf
Dual head : aticonfig --initial=dual-head --screen-layout=above
This command will generate a dual head configuration
file with the second screen located above the first
screen.
Multi head : aticonfig --initial --heads=4 --adapter=1
This command will generate 4 adjacent X Screens
on adapter 1. Use with -f to reduce previously configured heads.
2. Setting up big desktop to horizontal and set overlay on secondary display.
aticonfig --dtop=horizontal --overlay-on=1
3. Setting up modes for primary display.
aticonfig --resolution=0,1600x1200,1280x1024,1024x768
4. Force primary CRT on and TV-out off.
aticonfig --force-monitor=crt1,notv
5. Change tv geometry
aticonfig --tv-geometry=85x90+10-10
This will set tv to 85% width (where 100% ==
overscan) 90% height and shift 10 pixels right of centre
and 10 pixels down of centre.
6. Multiple display adapters.
List adapters : aticonfig --list-adapters
Init 0 and 2 : aticonfig --adapter=0,2 --initial
Init all : aticonfig --adapter=all --initial
MultiView : aticonfig --xinerama=on
7. ATI Overdrive (TM).
List adapters : aticonfig --list-adapters
Get Clocks of 0 : aticonfig --adapter=0 --od-getclocks
Set new Clocks for 0 : aticonfig --adapter=0 --od-setclocks=770,1126
Test out 3D : atiode -P60 -H localhost:0; echo $?
Check Temperature of 0 : aticonfig --adapter=0 --od-gettemperature
Commit changes for 0 : aticonfig --adapter=0 --od-commitclocks
***note***
atiode is a stress application you start with a required
parameter -P which specifies the test duration and the optional
-H parameter to target a specific display to use. For example
atiode -P 600 -H localhost:0 would test display 0 for 10 minutes
the return code from the application is the test result
0: Test successfully completed.
1: Invalid command-line parameters.
2: Test failed because of rendering errors.
3: Target adapter not found.
4: Test aborted due to unknown reason
8. Framelock/Genlock with GL Sync module
Set GL Sync connector parameters for particular adapter:
aticonfig --glsync-setconfig=0,0,2,0.0,3,8 --adapter=1
Enable Genlock for particular display:
aticonfig --glsync-setgenlock=lvds,1,0 --adapter=1
Enable Timing Master:
aticonfig --glsync-setgenlock=dfp3,0,1 --adapter=1
Verify if the frequiency is locked for particular display:
aticonfig --glsync-getgenlock=crt1 --adapter=1
Set GL Sync output port RJ45_1:
aticonfig --glsync-setport=RJ45_1,1,BNC
Reinitialize all genlock settings for all displays and adapters:
aticonfig --glsync-restart
Please report bugs to http://support.ati.com
