AppleGmuxBacklight

Differences between revisions 11 and 12
Revision 11 as of 2012-02-08 15:29:19
Size: 4013
Editor: cpe-76-179-183-161
Comment:
Revision 12 as of 2012-02-08 15:29:45
Size: 4014
Editor: cpe-76-179-183-161
Comment:
Deletions are marked like this. Additions are marked like this.
Line 57: Line 57:
||Macbook Pro 7,1|N/A||N||N/A|| ||Macbook Pro 7,1||N/A||N||N/A||

Details

On some models of Apple computers the ACPI-standard interfaces for backlight adjustment have no effect on the screen brightness. Another interface has been identified to adjust the backlight via the gmux ACPI device. Various patched drivers are available to use the gmux for brightness adjustments, but we'd like to get support included in Ubuntu by default.

We are therefore providing a patched version of the apple_bl driver which includes support for the gmux backlight interface for testing on a wide variety of Apple hardware. If you have an Apple model with a built-in display (e.g. MacBook or iMac), please follow the instructions below to install the patched driver, then add your test results to the table at the bottom of this page.

Note that if brightness adjustments already work for your machine then the gmux backlight interface probably is not going to work. Testing on these machines would still be appreciated, however.

Thanks for your help!

Driver Installation

The patched driver is available via PPA if you are running Oneiric or Precise. If you've installed another driver for your backlight, you should temporarily remove this driver before installing this driver for testing.

Use the following commands to subscribe to the PPA and install the driver.

  • sudo add-apt-repository ppa:sforshee/apple-bl-gmux
    sudo apt-get update
    sudo apt-get install apple-bl-gmux-dkms

Then to start using the driver you can either reboot, or else use the following commands to reload the driver.

  • sudo modprobe -r apple_bl
    sudo modprobe apple_bl

Testing

Once the driver is installed, please use the steps below to test both the ACPI-standard and gmux backlight interfaces, then add your results to the table at the bottom of this page. If you are booting with the acpi_backlight=vendor option, you will need to temporarily remove this option in order to test the standard ACPI backlight interfaces.

After you've started using the test driver, run the following command to see which backlight interfaces have been detected.

  • ls /sys/class/backlight

You should see at a minimum a directory named acpi_video0. You may also see a directory named gmux_backlight; if you do not see this directory then your machine does not have the gmux device in ACPI. Perform the following steps on each of the acpi_video0, gmux_backlight, and apple_backlight interfaces.

  1. Run cd /sys/class/backlight/<interface> for the backlight interface you are testing.

  2. Run cat max_brightness to get the maximum brightness value supported by the interface. Your range of valid brightness levels is 0 to max_brightness. Note: It's suggested that you do not set your brightness to lower than 5% of max_brightness, as it is possible to set the brightness so low that you can not longer see what is displayed on the screen.

  3. Run cat brightness to see the current brightness level.

  4. Select a new brightness value. This should be significantly different than the current value so that you can see whether or not the brightness changes, but again not lower than 5% of max_brightness. Once you've selected a value, run echo <value> | sudo tee brightness to write the value to the driver. Note whether or not the backlight level changes. If desired, you can then write the original value back to restore the brightness level.

Results

Please add your results to the following table, keeping the table sorted alphabetically by machine name. If you don't know your machine name, it can be obtained by running sudo dmidecode -s system-product-name.

Machine

acpi_video0 works?

apple_backlight works?

gmux_backlight works?

MacBook Air 4,1

Y

N/A

N/A

MacBook Pro 5,1

N

Y

Y

MacBook Pro 5,5

N/A

?

N

Macbook Pro 7,1

N/A

N

N/A

MacBook Pro 8,1

Y

N/A

N

MacBook Pro 8,2

N

N/A

Y

Kernel/AppleGmuxBacklight (last edited 2012-10-20 09:45:34 by vdvegt)