The command line tool is useful for debugging purpose, and to create automatic scripts.
We won't present everything you can do with ddccontrol, if you want more information, type:
# ddccontrol -h
This example explains how to list all available controls and then change the brightness parameter.
To list available controls, type:
# ddccontrol -p
This probes for available monitors, then takes the first probed monitor and lists controls supported by it. This should give you an output like this (this example uses a Samsung Syncmaster 173P and a nVidia GeForce FX 5700):
ddccontrol version 0.1 Copyright 2004 Oleg I. Vdovikin (oleg-at-cs.msu.su) Copyright 2004 Nicolas Boichat (nicolas-at-boichat.ch) This program comes with ABSOLUTELY NO WARRANTY. You may redistribute copies of this program under the terms of the GNU General Public License. Device : pci:01:00.0-0 Error while reading write message answer: Bad message Reading EDID 0x50 failed. Device : pci:01:00.0-1 Device : pci:01:00.0-2 Detected monitors : - Device : pci:01:00.0-1 DDC/CI supported : Yes Monitor Name : Samsung SyncMaster 173P (DVI) Input type : Digital (Automatically selected) - Device : pci:01:00.0-2 DDC/CI supported : Yes Monitor Name : NEC Multisync 2080UX+ Input type : Analog Reading EDID and initializing DDC/CI at bus pci:01:00.0-1... Device : pci:01:00.0-1 EDID readings: Plug and Play ID: SAM00E2 [Samsung SyncMaster 173P (DVI)] Input type: Digital = Samsung SyncMaster 173P (DVI) > Color settings > Brightness and Contrast > id=brightness, name=Brightness, address=0x10, delay=-1ms, type=0 supported, value=55, maximum=100 > id=contrast, name=Contrast, address=0x12, delay=-1ms, type=0 supported, value=60, maximum=100 > id=magicbright, name=Magic Bright Mode, address=0xdc, delay=-1ms, type=2 Possible values: > id=text - name=Text, value=1 > id=internet - name=Internet, value=2 > id=entertain - name=Entertain, value=3 > id=custom - name=Custom, value=4 supported, value=4, maximum=4 > Others > Restore defaults > id=defaults, name=Restore Factory Defaults, address=0x4, delay=-1ms, type=1 Possible values: > id=default - name=Restore Factory Defaults, value=1 supported, value=0, maximum=1 > id=defaultluma, name=Restore Brightness and Contrast, address=0x5, delay=-1ms, type=1 Possible values: > id=default - name=Restore Brightness and Contrast, value=1 supported, value=0, maximum=1 > id=settings, name=Settings, address=0xb0, delay=-1ms, type=1 Possible values: > id=store - name=Save Current Settings, value=1 > id=restorefactory - name=Restore Factory Settings, value=2 supported, value=0, maximum=2 > Input settings > id=inputsource, name=Input Source Select, address=0x60, delay=-1ms, type=2 Possible values: > id=analog - name=Analog, value=1 > id=digital - name=Digital, value=3 supported, value=3, maximum=3 > Power control > id=dpms, name=DPMS Control, address=0xd6, delay=-1ms, type=2 Possible values: > id=on - name=On, value=1 > id=standby - name=Standby, value=4 supported, value=1, maximum=4 The lines concerning brightness in the available controls list are:
> id=brightness, name=Brightness, address=0x10, delay=-1ms, type=0 supported, value=55, maximum=100
The important elements are address (here: 0x10), current value (55) and maximum value (100).
To change the brightness value to 70/100, type:
ddccontrol -p -rThe last lines of the output should be:0x10-w70
Writing 0x10, 0x46(70)... Control 0x10: +/70/100 [Brightness]