From ArchWiki
Revision as of 20:49, 4 September 2008 by Chochem (Talk | contribs) (creation)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

DSDT (Differentiated System Description Table) is a part of the ACPI specification and it supplies configuration information about a base system. ACPI capable computers come with a preinstalled DSDT from the manufacturer. A common linux problem is missing ACPI functionality (fans not runninng, screens not turning off when the lid is closed, etc.) stemming from DSDTs made with Windows specifically in mind. The solution that this article will try to detail is replacing the default DSDT with a 'fixed' version. Note that this fix can also be accomplished during installation but requires you to have a custom DSDT at hand.

Replacing the DSDT

Step one: Get hold of fixed DSDT

A DSDT file is originally written in ACPI Source language (an .asl/.dsl file). Using a compiler this can produce an 'ACPI Machine Language' file (.aml) or a hex table (.hex). To incorporate the file in your Arch install, you'll need to get hold of a compiled .aml file. - whether this means compiling it yourself or trusting 'some guy on the internet' is up to you.

"Compiling it yourself"

In short, you can use Intel's ASL compiler (in the repos) to turn your systems DSDT table (residing in /sys/firmware/acpi/tables/DSDT) into source code, locate and fix the errors (the compiled files will typically have been made using Microsoft's compiler rather than Intel's more stringent one... need we say more?), and recompile. This process is detailed far more comprehensively and better at the Gentoo wiki. It's well written and the process is a lot easier than it sounds and far faster than reading about it.

"Some guy on the internet"

  • There is a database of sorts of user produced fixes on sourceforge: http://acpi.sourceforge.net/dsdt/. Sadly, this is not very well maintained and more than half the entries are just weird noise spam. If you do download a file from there, it'll most likely be a compressed .asl file, so you'll need to unzip it and compile it. You should really read the Gentoo wiki for that but the upshot is: get iasl from the community repo, unzip the file into a directory of its own and run
iasl -tc ''.asl/.dsl file''

on it and if it says no errors and no warnings you should be good to go.

  • Arch users with the same laptop as you are a minority of a minority of a minority. Try browsing other distro/linux forums for talk about the same model. Likelihood is that they have the same problems and either because there is a lot of them (Ubuntu) or because they're overwhelmingly technical (Gentoo?) someone there has produced a working DSDT and maybe even provides a precompiled version (again, use at your own risk).
  • Google Is Your Friend: Try keeping it sweet and short - model name and dsdt will probably produce results.

Remember, regardless of how you get a file, you'll need a compiled ACPI Machine Language file for Arch.

Step Two: Get the file loaded at startup


This part is going to describe how to rebuild your startup image (kernel26.img) so that your custom DSDT file will get loaded instead of the maunfacturer's. This is fairly technical subject mattter (which I don't understand much of) so this is pretty much pure howto. See [[1]] for a more detailed description of the things at work here. If things go wrong this shifts the blame back to you.


  • Cp your compiled file to /lib/initcpio/custom.dsdt
  • The last line of /etc/mkinitcpio.conf (HOOKS="....") lists in standard arch style "the hooks that are executed on image creation and on runtime in the exact order they are listed". You'll need to add 'dsdt' to this list if it's not already there. Save the file.
  • mkinitcpio is the program that creates the startup image based on /etc/mkinitcpio.conf. Get it from the repos: pacman -Sy mkinitcpio.
  • Run mkinitcpio as root. Simply entering 'sudo mkinitcpio' will do a dry test run (mind you, a succes here is no guarantee that the generated image will actually work). 'mkinitcpio -p kernel26' will create both the standard and the fallback image - if you're feeling less adventurous, you might wish to first try 'mkinitcpio -g /boot/kernel26.img' which will only create the standard image (so you can.. well fall back on the other one in case things don't work).

Step three: Test your new image

If mkinitcpio succesfully created an image, you should be ready to reboot now. If things go well, you'll boot into your ordinary Arch setup, the only difference being a properly working fan, lid, whatever misbehaved. If they don't

  • Make a note of the error messages
  • Restart
  • Choose the fallback image option from GRUB
  • Read the other wiki articles (really) and try again.
  • Try forums (again)
  • Read/edit wiki
  • Leave distro in anger vowing revenge