Board:apple/macbook21

From coreboot
Jump to navigation Jump to search

The wiki is being retired!

Documentation is now handled by the same processes we use for code: Add something to the Documentation/ directory in the coreboot repo, and it will be rendered to https://doc.coreboot.org/. Contributions welcome!

  • Tested on a MacBook2,1 (Mid 2007) 2.0 GHz Core 2 Duo, Model No: A1181 (EMC 2139) with GRUB2 payload. The tested machine is as described here: [1] with the one difference that the vendor's EFI architecture in fact is 32-Bit.
  • Tested on a MacBook2,1 (Mid 2007) 2.16 GHz Core 2 Duo, Model No: A1181 (EMC 2139) with GRUB2 payload. Hardware description here: [2]
  • The port might work as well, but is not yet tested on MacBook2,1 (Late 2006) and MacBook1,1. The latter might require small code modifications, e.g. for DMI machine identification.

Wifi chipsets

By default, these machines typically come with an ath5k chipset which works fully without any blobs in the kernel. Some might come with an Intel chipset which requires blobs (firmware) in the Linux kernel. In any case, these machines only support 802.11g wifi.

After installing coreboot, you can replace the wifi chipset with an 802.11n chipset that works fully with free software, without needing proprietary software of any kind (in the kernel or otherwise).

Recommended wifi chipsets

Hardware

Status

Payload:

  • GRUB2 works
  • no other payload tested yet

Operating System:

  • GNU/Linux-libre works
  • GNU/Linux works
  • Windows works (tested with Windows 8.1 x86 [x86 because mine has only 1GiB of RAM])
  • FreeBSD works (not a lot of tests were done though)
  • OS X is untested

Issues under GNU/Linux-libre and GNU/Linux:

  • The machine's one and only led lights up during boot which is fine. At some point during or after boot it should turn off though. At the moment it just stays turned on for ever. During suspend to RAM, the led blinks which is just nice. After resume from suspend to RAM the led turn off. This is what should happen after a normal boot too.
  • "00:07.0 Performance counters [1101]: Intel Corporation Device [8086:27a3] (rev 03)" is hidden under coreboot. What's its function anyway?
  • No CPU temperature indicator
  • Idle power consumption is higher than with vendor firmware (no C-states)
  • Suspend to disk aka hibernate works. Although:
    • While it goes into hibernate state the screen turns off but then turns on again for just about a few seconds before it finaly turns off.
    • When resuming/powering on, the keyboard is dead in the payload/GRUB2. Since my GRUB2 image is configured to boot a default menu entry after a few seconds of no user input, it then starts GNU/Linux-libre nicely. That is, the keyboard works to enter for example the LUKS passphrase which then unlocks the swap partition and the machine's state from before hibernate gets restored.
    • Since I never used hibernate before, I can not say if the described behaviour is just normal or an issue.

Issues under Windows:

  • no hotkeys
  • no sound (Apple driver fails to install)
  • backlight occasionally drops to 0 after suspend
  • no backlight control
  • CD untested
  • no webcam (not even with Apple drivers)
  • bluetooth untested
  • no restart

Apple-specific drivers needed in Windows:

  • Webcam
  • Touchpad (to get right click)
  • Keyboard (for some Fn combinations)
  • Sound

Tested and works on both GNU/Linux and Windows unless otherwise specified in previous section:

  • RAM 3 GB (1x2 GB + 1x1 GB), 1GB (2 x 512M)
  • Keyboard
  • Touchpad
  • Screen
  • Ethernet
  • Wifi
  • Sound (internal speakers, headphones, microphone, external microphone)
  • External USB connectors
  • Fan
  • Suspend to RAM
  • Decrease and increase the screen backlight works
  • Optical drive
  • Webcam (needs non-free driver, so it does not work with Linux-libre)
  • Internal HDD
  • Bluetooth
  • wake on LID in S3

Not tested:

  • External Firewire connector
  • External monitor connector
  • Infrared receiver

Proprietary components

Configure coreboot

When starting without any .config file you might want to configure coreboot by

make menuconfig

At a minimum make the following selections:

Mainboard  --->
  Mainboard vendor  --->
    Apple
  Mainboard model  --->
    MacBook1,1 or MacBook2,1 (choose the right one)
Devices  --->
  [*] Use native graphics initialization
Payload  --->
  Add a payload  --->
    An ELF executable payload
  Payload path and filename # Insert the path and filename to
                            # the standalone GRUB2 image to be used

Moreover, you might want to disable the usage of CPU microcode:

Chipset  --->
  *** CPU ***
  Include CPU microcode in CBFS  ---> 
    Do not include microcode updates

Flashing

Flashing is easy with the vendor BIOS version MB21.00A5.B07 (EFI 1.1) installed. Maybe see also this page for a more recent verion: EFI and SMC firmware updates for Intel-based Macs.

Identify the flash chip

Make sure flashrom can identify the flash chip:

# flashrom --verbose --programmer internal:laptop=force_I_want_a_brick >flashrom_info.log

The output should involve:

...
DMI string system-manufacturer: "Apple Inc."
DMI string system-product-name: "MacBook2,1"
DMI string system-version: "1.0"
DMI string baseboard-manufacturer: "Apple Inc."
DMI string baseboard-product-name: "Mac-F4208CAA"
DMI string baseboard-version: "PVT"
DMI string chassis-type: "Notebook"
Laptop detected via DMI.
Found chipset "Intel ICH7M" with PCI ID 8086:27b9. Enabling flash write... 
...
Probing for SST SST25VF016B, 2048 kB: probe_spi_rdid_generic: id1 0xbf, id2 0x2541
Found SST flash chip "SST25VF016B" (2048 kB, SPI) at physical address 0xffe00000.
Chip status register is 0x1c.
Chip status register: Block Protect Write Disable (BPL) is not set
Chip status register: Auto Address Increment Programming (AAI) is not set
Chip status register: Block Protect 3 (BP3) is not set
Chip status register: Block Protect 2 (BP2) is set
Chip status register: Block Protect 1 (BP1) is set
Chip status register: Block Protect 0 (BP0) is set
Chip status register: Write Enable Latch (WEL) is not set
Chip status register: Write In Progress (WIP/BUSY) is not set
Resulting block protection : all
...
Found SST flash chip "SST25VF016B" (2048 kB, SPI).
No operations were specified.
...

If it does not find this very same chip but rather finds a different chip or none at all: stop here and think twice.

Read the vendor BIOS

Read the vendor BIOS and store it in a safe place (possibly at two different places outside the MacBook).

# flashrom --verbose --programmer internal:laptop=force_I_want_a_brick --chip SST25VF016B \
  --read rom.bin >flashrom_read.log 2>&1

The output should involve:

...
Found SST flash chip "SST25VF016B" (2048 kB, SPI) at physical address 0xffe00000.
...
Resulting block protection : none
Reading flash... done.
...

Write coreboot

Note, the following won't work on the Macbook1,1 (external flashing required). disassembly guides here

# flashrom --verbose --programmer internal:laptop=force_I_want_a_brick --chip SST25VF016B \
  --write coreboot.rom >flashrom_write.log 2>&1

The output should involve:

...
Found SST flash chip "SST25VF016B" (2048 kB, SPI) at physical address 0xffe00000.
...
Resulting block protection : none
coreboot last image size (not ROM size) is 2097152 bytes.
Manufacturer: Apple
Mainboard ID: MacBook2,1
Reading old flash chip contents... done.
Erasing and writing flash chip... Trying erase function 0... 0x000000-0x000fff:ETransaction error!
Running OPCODE 0x20 failed at address 0x000000 (payload length was 0).
spi_block_erase_20 failed during command execution at address 0x0
Reading current flash chip contents... done. Looking for another erase function.
Trying erase function 1... 0x000000-0x007fff:ETransaction error!
Running OPCODE 0x52 failed at address 0x000000 (payload length was 0).
spi_block_erase_52 failed during command execution at address 0x0
Reading current flash chip contents... done. Looking for another erase function.
Trying erase function 2... 0x000000-0x00ffff:ETransaction error!
Running OPCODE 0xd8 failed at address 0x000000 (payload length was 0).
spi_block_erase_d8 failed during command execution at address 0x0
Reading current flash chip contents... done. Looking for another erase function.
Trying erase function 3... 0x000000-0x1fffff:EW
Erase/write done.
Verifying flash... VERIFIED.
...

Update coreboot

Once coreboot is installed, flashing an update coreboot version or reverting back to the vendor BIOS works with and without the laptop=force_I_want_a_brick switch.