Configuration / Graphics
<key>Graphics</key> <dict> ... </dict>
This parameter group is made for injecting video card properties as done, for example, by Natit.kext. There are many different parameters that are injected, mostly constants, some of them calculated, some of them defined in the internal table and only a few parameters can be adjusted with the configuration file.
Enables graphics injection, which is necessary for a working system. It is only advised to disable it, if you do not know a better method. Some video cards, for instance Nvidia GTX 6xx or AMD Radeon HD 6xxx do not require injection and it will automatically be disabled without user interaction. At least it is enough to reach the desktop.
Enabled by default.
<key>Inject</key> <dict> <key>Intel</key> <true/> </dict>
<key>Inject</key> <dict> <key>ATI</key> <true/> </dict>
<key>Inject</key> <dict> <key>NVidia</key> <true/> </dict>
Amount of video memory in MB. It is determined automatically but no one will be harmed if you write a correct value. However, changing it has not helped anyone yet.
Loads a video bios from a file, which needs to be stored at the directory EFI/CLOVER/OEM/[model]/ROM or EFI/CLOVER/ROM with the name [vendor]_[device].rom, for instance 1002_68d8.rom. Sometimes it makes sense to load video bios manually, for example when you need a patched version or when the video card does not show it to the system - like mobile Radeon cards. In this case it is enough to set this parameter to
Yes without providing any file. Clover will read the video bios from legacy memory at 0xC0000, where it is present most of the times, and enable functionality.
Apparently the video bios written to the card's ROM does not match the one stored at address 0xC0000 - the shadow ROM. In short:
<true/>- Use for mobile Radeon cards without any external file.
<false/>- For all other variants
Some systems show a quartered screen. Use
0 to solve this problem, as showed in the example above.
Clover applies corrections to the shadow ROM at address 0xC0000 to allow support of the highest monitor resolution. For instance, a monitor's EDID contains the mode 1920x1080 but the video bios does not. Clover will apply it as the first mode to be used. In case the monitor does not produce an EDID, it can be injected manually.
ScreenResolution in section
GUI is set, it will be used for this patch.
Should the automatic patch fail, then you can specify a manual one.
<key>PatchVBiosBytes</key> <array> <dict> <key>Find</key> <data>gAeoAqAF</data> <key>Replace</key> <data>gAeoAjgE</data> </dict> </array>
This example applied to an AMD Radeon HD 6670 video bios, resulting in a replacement of mode 1920x1440 with mode 1920x1080. It is advised to choose a mode with the same horizontal resolution.
It is possible to apply multiple patches. An Nvidia video bios, for instance, was successfully modified with four patches.
Old keys InjectEDID and CustomEDID were moved here.
<key>EDID</key> <dict> <key>Inject</key> <true/> <key>Custom</key> <data>AP///////wAyDADfAAAAAAASAQOAIRV4CunVmVlTjigmUFQAAAABAQEBAQEBAQEBAQEBAQEB3iGgcFCEHzAgIFYAS88QAAAY3iGgcFCEHzAgIFYAS88QAAAAAAAA/gBXNjU3RwAxNTRXUDEKAAAA/gAjMz1IZYSq/wIBCiAgAJo=</data> <key>VendorID</key> <string>0x1006</string> <key>ProductID</key> <string>0x9221</string> </dict>
Inject parameter is useful when an EDID exists but is not seen by Apple's drivers. In this case it is enough to set this option to
<true/>. Clover will automatically extract the EDID and provide it to the drivers. See Mobile Radeons for more info. For monitors without DDC and for UEFI-only computers a custom EDID is needed.
Custom parameter is for providing custom EDID when it's missing. The main requirement is to have a correct maximal resolution.
Another possibility is to use ViewSonic EDID Editor v3.1.5 that can easily be ported to Mac, if needed.
An EDID from a Dell Inspiron will be used in the sample configuration file with a matrix of 1440x900.
A custom EDID will also be used for automatic video bios patching. Look above.
You can override VendorID and ProductID in EDID.
The amount of ports on a video card, including TVO and/or HDMI. The chosen Apple framebuffer may not correspond to our real video card.
This parameter is specific to AMD Radeon cards, which have a bunch of different framebuffers without any specific pattern. For a wide range of common video cards Clover will automatically choose a suiting framebuffer name. Feel free to set your own if you want. If you do not know what to write here, delete this parameter completely.
Do not use Macaque! It is solely used for absurdity. But no - people still use it in their configurations!
Small guidance table:
Series v / Type >|Mobile|Desktop :---|:---|:--- HD 5000|Alouatta|Baboon HD 6000|Cttail|Ipomoea HD 7000|Pondweed|Futomaki
This parameter is only useful for Nvidia video cards and configures types and usage of video ports. The example line contains 40 capitalised hexadecimal digits. Theory is missing in this case and praxis shows controversial results.
Following table exists (found somewhere on insanelymac) but its correctness is debatable:
You can also find other methods on calculating a correct value for this line.
Clover will try to generate one according to the video bios.
This parameter is also just for Nvidia cards. For details see the topic on projectosx. However the listed examples are controversial. You can see real configurations in this topic. Apparently it is best to just let Clover handle this value. Leave it out completely and let Clover do the calculation.
This parameter is used to enable the internal Intel HD 4000 video card. Until now no common rule for selecting a value was found, so either let Clover handle this parameter or use another one if it does not work.
Here is a table with possible values:
Value|Type|Ports :---|:---|:--- 0x01660000|Mobile|4 ports: 1 LVDS, 3 DP 0x01660001|Mobile|4 ports: 1 LVDS, 1 HDMI, 2 DP 0x01660002|Mobile|1 port: LVDS 0x01660003|Mobile|4 ports: 1 LVDS, 1 HDMI e 2 DP 0x01660004|Mobile|1 port: LVDS 0x01620005|Desktop|3 ports: DP 0x01620006|Desktop|0 ports 0x01620007|Desktop|0 ports 0x01660008|Mobile|3 ports: 1 LVDS, 2 DP 0x01660009|Mobile|3 ports: 1 LVDS, 2 DP 0x0166000a|Mobile|3 ports: 2 DP, 1 HDMI 0x0166000b|Mobile|3 ports: 2 DP, 1 HDMI
Last edited by Michael Belyaev (usr-sse2), 2017-09-22 15:50:25