ati

 

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

 

AMD 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 AMD 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 AMD 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 AMD 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 synchronization

                              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.

 

Uninstall options:

     --uninstall{=force|dryrun}

         dryrun tests uninstall but does not uninstall.

         force removes all installed files without verification.

         Uninstall without an option tries to perform the default uninstall procedure.

 

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.

 

PowerXpress options:

  --px-list-active-gpu

  --pxl

       List current activated GPU

  --px-dgpu

       Activate discrete GPU (High-Performance mode), must re-start X to take effect

  --px-igpu

       Activate integrated GPU (Power-Saving mode), must re-start X to take effect

 

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. 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.

  5. 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

  6. AMD 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

 

  7. 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 frequency 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.amd.com

addict@addict-desktop:~$ cls

No command 'cls' found, but there are 18 similar ones                                                              

cls: command not found                                                                                              

addict@addict-desktop:~$ clear                                                                                        

                                                                                                                     

                                                                                                                     

                                                                                                                       

                                                                                                                       

                                                                                                                       

                                                                                                                               

                                                                                                                               

                                                                                                                               

                                                                                                                               

                                                                                                                               

                                                                                                                               

                                                                                                                                 

                                                                                                                                 

                                                                                                                                   

addict@addict-desktop:~$ aticonfig --help

Usage: aticonfig [OPTION] ...

Parses an existing X-Server configuration file and modifies it to operate with

AMD products.

 

The following command-line options can be invoked as parameters:

 

AMD Initial Configuration:

  --initial

        Generate a default AMD 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.

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

 

AMD 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 AMD 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 AMD 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 AMD 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 synchronization

                              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.

 

Uninstall options:

     --uninstall{=force|dryrun}

         dryrun tests uninstall but does not uninstall.

         force removes all installed files without verification.

         Uninstall without an option tries to perform the default uninstall procedure.

 

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.

 

PowerXpress options:

  --px-list-active-gpu

  --pxl

       List current activated GPU

  --px-dgpu

       Activate discrete GPU (High-Performance mode), must re-start X to take effect

  --px-igpu

       Activate integrated GPU (Power-Saving mode), must re-start X to take effect

 

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. 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.

  5. 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

  6. AMD 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

 

  7. 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 frequency 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.amd.com

addict@addict-desktop:~$