Skip to content

Commit

Permalink
1.1.2 version sync and FAQ updates for mobile GPUs.
Browse files Browse the repository at this point in the history
  • Loading branch information
vit9696 committed Oct 22, 2017
1 parent 6a7e882 commit f29371f
Show file tree
Hide file tree
Showing 4 changed files with 9 additions and 4 deletions.
3 changes: 3 additions & 0 deletions Changelog.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
WhateverGreen Changelog
=======================
#### v1.1.2
- Enabled the kext in installer and recovery by default
- Improved controller start debugging

#### v1.1.1
- Added more GPU models to automatic detection
Expand Down
3 changes: 2 additions & 1 deletion Manual/FAQ.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,8 @@ While not pretending to be perfect, there is a [SSDT sample](https://github.com/

- _What properties should I additionally inject for my MOBILE GPU?_
Mobile AMD GPUs have very few issues but only if they are physically connected to the display (i.e. AMD Switchable Graphics users are out of luck). You will almost certainly have to inject a VBIOS (`ATY,bin_image` property) that is exactly 64 KBs. Afterwards you will have working external displays. For internal display you most likely will have to inject its EDID (`AAPL00,override-no-connect` property) and set display channel representation to 6 bits (`@0,display-link-component-bits` and `@0,display-pixel-component-bits` properties). If you have a resolution higher than 1600x900 you will likely have to also set `@0,display-dual-link` to 1.
Further details are available in [SSDT sample](https://github.com/vit9696/WhateverGreen/blob/master/Manual/Sample.dsl) to get the general idea.
Further details are available in [SSDT sample](https://github.com/vit9696/WhateverGreen/blob/master/Manual/Sample.dsl) to get the general idea.
Attention! If your built-in display needs 6-bit colour channels (component-bits), you will still see glitches (gradients) in installer and recovery, because those parameters are ignored by AMD drivers without full acceleration. You should pass `-radvesa` boot argument during macOS installation.

- _How could I tune my GPU configuration?_
ATI/AMD GPUs could be configured by `aty_config`, `aty_properties` parameters that one could find in AMDxxxxController.kext Info.plist files. Different framebuffers have overrides for these preferences for lower energy consumption, higher performance, or other reasons. Unfortunately in such combinations they often are unsuitable for different GPUs.
Expand Down
3 changes: 2 additions & 1 deletion Manual/FAQ.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,8 @@ UEFI без использования CSM. В случае отсутствия

- _Какие дополнительные свойства нужно инжектировать для мобильных видеокарт?_
Мобильные видеокарты AMD при условии физической связи между экраном и картой (т.е. поколения до AMD Switchable Graphics) проблем практически не имеют. В большинстве случаев необходимо инжектировать видеобиос (свойство `ATY,bin_image`) размера 64 килобайт. С этого момента внешние экраны должны функционировать. Для работы внутреннего экрана часто необходим инжект EDID (свойство `AAPL00,override-no-connect`) и установка представления цветового канала в 6 бит (свойства `@0,display-link-component-bits` и `@0,display-pixel-component-bits`). Для разрешение выше 1600x900 может также потребоваться установка `@0,display-dual-link` в 1.
Подробности указаны в [примере SSDT](https://github.com/vit9696/WhateverGreen/blob/master/Manual/Sample.dsl).
Подробности указаны в [примере SSDT](https://github.com/vit9696/WhateverGreen/blob/master/Manual/Sample.dsl).
Внимание! Если внутреннему дисплею нужны 6-битные цветовые каналы (component-bits), то в установщике и рекавери всё равно будут артифкаты, так как эти параметры игнорируются драйверами AMD без полного ускорения. На время установки необходимо использовать аргумент загрузки `-radvesa`.

- _Как указать более тонкую настройку видеокарты?_
Видеокарты ATI/AMD настраиваются с помощью параметров `aty_config`, `aty_properties`, которые можно найти в Info.plist кекстов AMDxxxxController.kext. Различные фреймбуферы используют эти параметры для достижения пониженного энергопотребления, повышенной производительности и подобного. К сожалению, в большинстве случаев предустановленные конфигурации не приводят к положительному результату для большинства видеокарт.
Expand Down
4 changes: 2 additions & 2 deletions Manual/Sample.dsl
Original file line number Diff line number Diff line change
Expand Up @@ -143,15 +143,15 @@ DefinitionBlock ("", "SSDT", 2, "APPLE ", "SSDTAMDGPU", 0x00001000)
0x01, 0x00, 0x00, 0x00
},
// Equal to AAPL00,LinkFormat
// Equal to AAPL00,LinkFormat = 0 (0 - 6 bits, 1 - 8 bits)
// Most laptop displays do not support 24-bit (32) colour but only 18-bit.
// This property must be used if you see "gradient" glitches.
"@0,display-link-component-bits",
Buffer () {
0x06, 0x00, 0x00, 0x00
},
// Equal to AAPL00,PixelFormat
// Equal to AAPL00,PixelFormat = 0 (0 - 6 bits, 1 - 8 bits)
// Similar to display-link-component-bits
"@0,display-pixel-component-bits",
Buffer ()
Expand Down

0 comments on commit f29371f

Please sign in to comment.