Jump to content
  • 0
Sign in to follow this  

AsereBLN Booter - Based on Chameleon RC4 / PCEFI10.5


Happy new year to everyone!

I have a little gift for you :) I was quite inactive here in the last weeks... but not dormant at all. I'm done the first major changes to Chameleon. I'm really disappointed regarding the code quality of Chameleon. It's full of possible buffer overflows, quick & dirty hacks... you can notice that there is no one behind, who is supervising the development, who has and keeps the whole picture in mind. The code quality is really bad :( One example is the use of the boolean datatype. You can find boolean_t, bool, BOOL, int, char... used with 0, 1, TRUE, FALSE, true, false, 0, 1, YES or NO, and this even mixed! So I started to cleanup this mess, fixed some bugs and also added new cool features.


  1. First of all I fixed the stupid bug with the fixed Platform UUID.
  2. Fixed a bug regarding PCI-Root-UID different than 0
  3. Fixed a bug regarding the detection of the CPU
  4. Fixed dozens of possible buffer overflows
  5. and all the bugs I forgot to mention

New Features:

  1. You can build Chameleon with GUI-support without the need of an embedded theme (Never understood why this should be necessary). The Booter is a lot smaller now. Only 160 kBytes.
  2. Platform UUID is taken from the BIOS (UUID from SMBIOS Table 1). You can remove PlatformUUID.kext, SMUUID from smbios.plist and also System-ID from com.apple.Boot.plist.
  3. Dynamic memory parameter detecting and injecting like Frequency, Type (DDR2, DDR3), Manufactor, Partnumber, Serialnumber. You can remove all memory related stuff from smbios.plist.
  4. Dynamic PCI-Root-UID detection from PCEFI 10.5
  5. Duvell300's FACP Restart Fix added (from here)


  1. Filenames configured in com.apple.Boot.plist (DSDT=..., SMBIOS=...) must be given with the full path. The Booter does not check automatically the Extra Folder. So if you used DSDT=mydsdt.aml and the mydsdt.aml file is in the Extra folder, then you must use now DSDT=/Extra/mydsdt.aml.
  2. ATI and nVidia Video-ROM-Files must be renamed to <vendorid>_<deviceid>.rom and must be put into the Extra folder. vendorid and deviceid as 4-digit hex values without a leading 0x. For instance, a nVidia 9400 GT (55nm) has the vendorid "0x10DE" and the deviceid "0x0641", so the filename must be "10de_0641.rom". To enable nVidia VGA BIOS File Loading use: UseNvidiaROM=Yes in com.apple.Boot.plist. To enable ATI VGA BIOS File Loading use: UseAtiROM=Yes in com.apple.Boot.plist.

If you use the Booter without the embedded theme, then you must supply a Theme in Extra/Themes/ to have GUI support. The default theme name is "Default". You can configure the theme to be used with Theme="Name" in com.apple.Boot.plist.

Platform UUID is setup by injecting /efi/platform/system-id property. The UUID value from SMBIOS table 1 is used as system-id. If your BIOS does not provide an UUID, then you can configure the UUID with SMUUID in smbios.plist. If you set system-id=No in com.apple.Boot.plist, then the system-id is not injected into the IORegistry. Use this if you want/need to use PlatformUUID.kext or something similar.

The memory parameter detecting should work with P35/X38/X48/P45 memory controllers and the builtin memory controllers of the Core i5/i7 CPU's. Reading of memory SPD (Serial Presence Detect EEPROM) data should work on P55, ICH10? and ICH9. You must remove all memory related keys from smbios.plist (SMmemmanufacter_X, SMmempart_X, SMmemserial_X, SMmemspeed & SMmemtype).

Dynamic PCI-Root-UID should work if your DSDT defines the UID like this: Name (UID, <value>). Default PCI-Root-UID is 0. You can configure the PCI-Root-UID to be used with PCIRootUID=<value> in com.apple.Boot.plist (-pci0, -pci1, PciRoot... does not work anymore).

You should also update boot0 (with fdisk) and boot1h with (dd), because the Chameleon team fixed some bugs there.

The archive contains:

  1. boot - the Booter without debugs, without an embedded theme
  2. boot_with_embedded_theme - the Booter without debugs and with an embedded theme
  3. boot_with_debugs - the Booter with some debug messages
  4. boot0 - the fist stage bootloader (goes into the MBR)
  5. boot1h - the second stage bootloader (goes to the beginning of the Chameleon Booter partition)

I ask everyone to use at least one time the Booter with Debugs and to take photos at every "(Press a key to continue...)" stop (PCI-Bus, CPU, Memory-Controller, SPD) to help me to improve Chameleon further. If you have a running Windows on your Hackintosh, then a TXT-Report made with the CPU-Z programm would be very helpful too. If you encounter problems, then use the Booter with debugs. Do not forget to rename it to boot.

Patch against Chameleon-RC4 is included, but without the memory detection stuff. I'll release it after a grace period. You know... ASEM is also reading here ;)

Any feedback is welcome!

Update Version 1.1.1:

  1. FACP RestartFix is enabled by default if you have an Intel CPU
  2. Memory Manufactor Code Lookup for some common Vendors (OCZ, G.Skill, GeIL, Crossair, Kingston)

Update Version 1.1.2:

  1. Fixed a bug with Memory Manufactor Code Lookup (DDR3: ManufactorID, Parity-Bit)

Update Version 1.1.3:

  1. Added Patriot, Crucial, A-DATA Memory Manufactor
  2. Support for 945 northbridge and ICH8, ICH7 southbridges
  3. SMBus Device Enable for systems there the controller is disabled (Tip from iNDi)
  4. printout a message if theme fails to load due to a missing file
  5. removed a print in non verbose mode to keep the Booter quiet

Update Version 1.1.4:

  1. You can supply a system-id with system-id=<value> in com.apple.Boot.plist
  2. You can prevent the system-id injection with system-id=No in com.apple.Boot.plist
  3. system-type is now supported. Default is 1 (Desktop). Use system-type=2 in com.apple.Boot.plist if you have laptop. (Link)
  4. Removed the setVideoMode(TEXT) in resume.c to make Hibernation work.
  5. Support for 946GZ/PZ, Q963/Q965a and P965 northbridge memory controllers.

Update Version 1.1.6:

  1. Improved system-type injection. ACPI V2 FACP PM_Profile is patched to match system-type.
  2. Fixed a bug with system-id injection (com.apple.Boot.plist).
  3. Supported memory manufactors: Micron, Samsung, Transcend, Apacer, Kingston, PNY, MDT, Corsair, GeIL, takeMS, Buffalo, Mushkin, OCZ, A-DATA, G.SKILL, TeamElite, Patriot and Crucial.
  4. Supported memory controllers: Core i5/i7 IMC, 945G/P, 955X, 945GM/PM, 945GME, 946GZ/PZ, Q963/Q965, P965, P35, X38/X48, 965GM, 965GME and P45.
  5. Supported SMBus controllers: P55, ICH10, ICH9, ICH8 and ICH7.

To set system-type put a system-type= into com.apple.Boot.plist (1=Desktop, 2=Laptop enables Battery, 3=Workstation). Default system-type is 1 (Desktop).

Update Version 1.1.7:

  1. Fixed the font swapping bug (small & console font).
  2. Fixed a problem with disabled MCH MMIO on some mainboards (needed to detect dram frequency).

Update Version 1.1.8:

  1. Fixed the font swapping bug (small & console font) for the Booter with an embedded theme.
  2. Fixed an issue with memory detection for some mainboard (2 slot only mainboards).
  3. Added support for PM45 northbridge memory controller.
  4. Added memory manufactor lookup for: Hynix, Nanya, KingMax, Qimonda and SuperTalent.
  5. Added nVidia GT240 device lookup.
  6. You can now hide HFS partitions too using “Hide Partition?? in com.apple.Boot.plist.
  7. Made the verbose output the using nVidia/ATI ROM’s more useful.
  8. Fixed a bug with sprintf (rek).
  9. Merged hibernation fix from Chameleon repo (46).
  10. Made verbosity at early bootstage useable.
  11. Bugfixes.

Update Version 1.1.9:

  1. Added nVidia ION device lookup.
  2. Added a feature to set/override the nVidia NVCAP value using NVCAP_ key in com.apple.Boot.plist.

If you want to override the NVCAP value, you must determine the PCI DeviceID of your graphic card. For instance: my new GTX260 has the DeviceID 0×05e2. Knowing the DeviceID add this to your com.apple.Boot.plist:


The NVCAP value is exactly 20 bytes long. You have to specify it using ASCII-HEX (0-9,a-f).

Sources under http://github.com/aserebln/Chameleon.


Share this post

Link to post
Share on other sites

Recommended Posts

  • 0

@downlord & @Danica Talos.

I have 2 Systems: a MSI-P55M-GD45 + i7 860 and my old GA-EP45-DS3 + Q9550. The i7 runs 10.6.2 and the other system 10.6.x + 10.5.8. All three installations (i7 & 10.6.2 @ 32&64Bit, Q9550 & 10.5.8 & 10.6.2) are booting and running fine without any issues.

Right now I've testet the Q9550 + 10.5.8 a lot. I did some restarts, shutdowns, sleep/wakeups. It always boots up fine. I've made a filesystem check under OS X. Filesystem is OK, so I have no corrupted files. At least for me it does work as expected. My 10.5.8 installation is nothing special. I started with this HD on a Mac mini with 10.5.0, switched to Efix and then to Chameleon. Always made all OS updates as they came available.

Keep in mind that BIOS settings, the Booter, the com.apple.Boot.plist, the smbios.plist, the extra kernel extensions and last but not least the DSDT itself... all these stuff plays together to give you stable and running system. Without knowing about all these components, it's hard to say something reliable.

You can see my BIOS settings in my blog. It use my Booter v1.1.8. The only extra kernel extensions I'm using are: fakesmc.kext/IONetworking.kext and fakesmc.kect/LegacyHDA.kext. Find the content of my Booter USB-stick below.

Share this post

Link to post
Share on other sites
  • 0

updated on the day it came out. not a single issue with this one. my system is running stable as a rock as id did with all other releases. thank you, asere.

p.s. now i figured out why i wasn't having the font kerning issue with 1.1.7: i was using boot without a theme built-in.

Share this post

Link to post
Share on other sites
  • 0
I see you are using SSDT tables. The documentation explains DropSSDT as follows: "DropSSDT=Yes - Skip the SSDT tables while relocating the ACPI tables."

As I understand this allows you to override the BIOS' SSDT and load modified SSDT tables. Is this correct? How do you make use of it and what is the advantage in comparison to using a modified DSDT.aml?

I've made it to have vanilla Apple CPU Powermanagement (aka Speedstep) working. The original Gigabyte SSDT does not work together with OS X, so I had to modify it. It's now part of the DSDT and therefore I use DropSSDT=yes.

In contrast, the SSDT of the MSI P55M-GD45 does work under OS X.

Share this post

Link to post
Share on other sites
  • 0
I finally got around to booting with my new stick. v. 1.1.7. Everything seems to be OK but my graphics card is not recognized and I have only 1024 x 768 resolution.

my com.apple.boot has:



This worked with my Chameleon boot stick v. RC3

I would try to specify teh video ROM file but do not quite understand the instructions. Where do I find the ROM file? I can rename it but where do I put it and what is the correct syntax for the key/value in com.apple.boot?


Check the PCI Root UID. The Booter uses/determines one and this must match with the UID used in the DSDT.

Share this post

Link to post
Share on other sites
  • 0
Hey AsereBLN,

nice work! I gave your Booter a try but ended up with KP while start up. If I have

<key>Kernel Flags</key>


I get, can't find mach kernel. If I have

<key>Kernel Flags</key>

<string></string> I get KP.

Can it be relatet to my two video cards? I was using Netkas PCEFI 10.5 which supports multiple Ati 4800s.


EDIT: It is not about the two videocards. KP happens also with only one videocard.

UPDATE: my debug pix as far you need them...


this is strange! I can boot 10.6.2 in 32Bit and 64Bit without problems. What does KP? Can you try to boot in verbose mode (and use Wait=Yes) to see what Chameleon says.

Share this post

Link to post
Share on other sites
  • 0
I just switched over to AsereBLN Booter v1.1.7 from Chameleon 2 RC3 and my ethernet is no longer working. DSDT is the same, no changes. I have ethernetbuiltin=Yes and also tried using my old PlatformUUID.kext with system-id=No.

Any ideas?


Share this post

Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Answer this question...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Sign in to follow this  

  • Recently Browsing   0 members

    No registered users viewing this page.

  • Create New...

Important Information

We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.