Quick and dirty guide for Ubuntu 10.10 on MacBook Air 2010 (3,1)

Much of this is by now done in the ppa:mactel-support - try using it before proceeding to the steps after "End installation"

To resolve the broken keyboard error, install hid-apple-dkms

Soon after receiving my latest toy I started tinkering with it. Mac OS X is awesome and all, but the power of Linux is really needed for me to be as productive as possible.

Anyhow, this is how I managed to create a (very!) nice Ubuntu install alongside of my OS X.
Disclaimer: This guide is written with the intent of being read by someone with both Linux and Mac OS X experience. You should also be able to think a bit for yourself if I forgot to mention some minor detail - but please leave a comment if you think you have tried your best and I will probably help you :-)
Needed: Ethernet adapter
Quirks: Only tested with one partition - no swap.

Step 1 Download rEFIt. This is going to be your new bootloader. It is quite ugly by default, but after some configuration tweaking and new icons it is really slick!
[caption id="attachment_41" align="alignnone" width="150" caption="rEFIt"][/caption]

Step 2 Create a partition. Resize your OS X partition and create a new one to fill the space. I created a new partition with ExFat as filesystem.

Step 3 Create Ubuntu 10.10 netboot USB:
Step 3.1 Download boot.img.gz and uncompress.
Step 3.2 Insert a USB memory. Unmount (do not eject) the partitions if any. Run diskutil list to find what diskX it is.
Step 3.3 Run
sudo dd if=boot.img of=/dev/rdiskX bs=1m

Note: Use rdisk instead of disk to dramatically speed up the copy process
Step 3.4 sync and eject drive

Step 4 Reboot into rEFIt (it may take a couple of restarts and/or runs of /efi/refit/enable.sh). The menu is accessed by holding Option, which means that you will need to hold it through the normal EFI, click on rEFIt and continue to hold it to get to the menu. If you cannot manage this, run /efi/refit/enable-always.sh (I think it's nice to always have the menu at boot).

Step 4.1 Select the Linux icon with a USB memory on it

If you have done everything correctly you should be created by the Ubuntu installation program. The installation is very straight forward until it is time to install GRUB.
DO NOT INSTALL GRUB TO YOUR MBR. It probably will refuse to install to a GPT "MBR" but please do not try :-). Instead, install to the PBR of your Linux installation (/dev/sda3 for me).

Step 5 Reboot. Linux needs reboot=p as cmdline in order to reboot correctly, which means that the installation program will not be able to reboot your computer. Just let it display "Restarting ..." and then hold down the power key (then turn it back on).

Step 6 (Hold Option key if you did not run enable-always.sh). You should now see a new Linux icon in rEFIt which is your new permanent installation. The USB memory stick is not needed anymore so go ahead and eject it to easy any confusion about which instance to boot. Boot your new Linux but press 'e' when you get to grub.
Step 6.1 Go down to the line that reads "kernel .........." and press Ctrl-E to get to the end of the line. Add 'nomodeset reboot=p' (otherwise the screen will be blank, possibly until X starts - and reboot=p is obviously for enabling rebooting).
Step 6.2 Press Ctrl+X to boot. Hopefully you will reach a terminal or some sort of login (depending of what tasksel you selected during install).
Step 6.3
sudo vim /etc/default/grub 
Step 6.4
sudo update-grub

Step 7 You should now have a sort of working Ubuntu installation. What is not working at this point is graphic drivers, wifi, bluetooth, multitouch and hotkeys. I have managed to solve them all expect for hotkeys, which probably is a configuration issue at my part. Anyhow, let's finetune!

End installation

Graphic drivers and WiFi
Just launch "Hardware Drivers" and enable the proprietary drivers. Simple as that

Thanks to Apples rebranding of, among other things, the bluetooth module we need to add the USB product IDs to the kernel modules in order for them to detect the devices.

You will need to get your hands on btusb-dkms_0.0.1_all.deb.gz - it should be floating around on the Ubuntu forums. Install it, it will fail - but it have by then extracted the build files we need.

cd /usr/src/btusb-0.0.1
sudo wget http://korta.nu/a785 -O btusb.c

Now add the following in btusb_table:

/* Apple MacBookAir3,1 */
{ USB_DEVICE(0x05ac, 0x821b) },

Now run:

sudo dkms remove -m btusb -v 0.0.1 --all
sudo dkms add -m btusb -v 0.0.1
sudo dkms build -m btusb -v 0.0.1
sudo dkms install -m btusb -v 0.0.1
sudo rmmod btusb
sudo depmod -a
sudo modprobe btusb

You should now see a bluetooth icon in your taskbar (or dmesg should at least say something like):

[ 314.319085] Bluetooth: Generic Bluetooth USB driver ver 0.6 (HACKED)
[ 314.326435] usbcore: registered new interface driver btusb
[ 314.357761] Bluetooth: L2CAP ver 2.14
[ 314.357764] Bluetooth: L2CAP socket layer initialized
[ 314.364215] Bluetooth: BNEP (Ethernet Emulation) ver 1.3
[ 314.364219] Bluetooth: BNEP filters: protocol multicast
[ 314.372463] Bluetooth: SCO (Voice Link) ver 0.6
[ 314.372467] Bluetooth: SCO socket layer initialized
[ 314.398916] usb 3-5.1: USB disconnect, address 4
[ 314.511223] Bluetooth: RFCOMM TTY layer initialized
[ 314.511229] Bluetooth: RFCOMM socket layer initialized
[ 314.511232] Bluetooth: RFCOMM ver 1.11

I have removed my old btusb module from /lib/modules all together to prevent mix ups, but that should not be necessary.


sudo add-apt-repository ppa:mactel-support
sudo apt-get update
sudo apt-get install bcm5974-dkms xserver-xorg-input-synaptics
cd /usr/src/bcm5974-1.1.5

(I should probably provide a patch for this, perhaps later :P).
Add the following:


/* Add the following three lines */

#define BCM5974_DEVICE(prod) { \

/* Add this line */
/* Terminating entry */

{ DIM_X, DIM_X / SN_COORD, -4460, 5166 },
{ DIM_Y, DIM_Y / SN_COORD, -75, 6700 }
/* Add this block */
0x84, sizeof(struct bt_data),
{ DIM_X, DIM_X / SN_COORD, -4460, 5166 },
{ DIM_Y, DIM_Y / SN_COORD, -75, 6700 }

Now run:

sudo dkms remove -m bcm5974 -v 1.1.5 --all
sudo dkms add -m bcm5974 -v 1.1.5
sudo dkms build -m bcm5974 -v 1.1.5
sudo dkms install -m bcm5974 -v 1.1.5
sudo rmmod bcm5794
sudo depmod -a
sudo modprobe bcm5974

As I wrote above for bluetooth you might need to remove the old kernel module to prevent confusion. Restart X and you should be able to right click by pressing with two fingers. Configure to your hearts wishes in the Mouse preferences (click the Touchpad tab).

I have not successfully managed to get this working, but pommed should be able to handle MacBookAir3,1 accordingly to the git commit logs.
Install from their git repos, not much to say really except that I chose to install the Ubuntu package and then replace the binary with my own in order to get a pre-configured configuration file (which sort of worked (i.e. started) after a few tweaks).
I have not played around enough to call this a success or failure, you're on your own here.

Anyway, I hope this "guide" is helpful to someone with a totally awesome computer.


Popular posts from this blog

Open Datacenter Hardware - What is OCP?

Open Datacenter Hardware - Leopard Server