Skip to content

Commit

Permalink
Version 1.0.1 sync
Browse files Browse the repository at this point in the history
  • Loading branch information
vit9696 committed Jul 29, 2017
1 parent ad3c02e commit f4c6774
Show file tree
Hide file tree
Showing 4 changed files with 18 additions and 9 deletions.
8 changes: 7 additions & 1 deletion Changelog.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
WhateverGreen Changelog
=======================

#### v1.0.1
- Added more GPU models to automatic detection
- Disabled DVI transmitter changes by default (use `-raddvi` boot-arg)
- Added IOAccelDeviceGetName correction
- Added libWhateverName.dylib with an app for GPU GL/Compute/Metal engine name correction

#### v1.0.0
- Initial release
- Initial release
7 changes: 4 additions & 3 deletions Manual/FAQ.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ Unfortunately it is not possible to test all the GPUs and their configurations,
Install DEBUG versions of WhateverGreen and Lilu, then add `-raddbg -liludbg` to the boot arguments. Once you boot run the following command in terminal:
`log show --predicate 'process == "kernel" AND (eventMessage CONTAINS "WhateverGreen" OR eventMessage CONTAINS "Lilu")' --style syslog --source`
If you have macOS 10.11 or earlier, use this command:
`cat /var/log/system.log | egrep '(WhateverGreen|Lilu)'`
`cat /var/log/system.log | egrep '(WhateverGreen|Lilu)'`
Please note that in the case you cannot boot if your problem is specific to the GPU you should be able to get the log via SSH. In this case also check the `kextstat` command output.

- _What is the state of 10.13 support?_
At the time of the release 10.13 is still being tested, so no support could even be thought about. There exist cases of broken AMD graphics on pre-Nehalem CPU chipsets. If you have older hardware please stay away from using 10.13. For other systems WhateverGreen may work if no drastic changes happen in 10.13.
Expand All @@ -29,7 +30,7 @@ To do so there is no need to use custom connectors with 7xxx GPUs or newer. Add

- _What properties should I inject for my GPU?_
Very few! You should inject an `HDAU` device to your GPU controller, `hda-gfx` properties with a corresponding number to the amount of audio codecs you have, and that is basically all. If you need to mask to an unsupported GPU, additionally add `device-id`. It is also recommended to add some cosmetic properties: `AAPL,slot-name` (displayed slot name in system details), `@X,AAPL,boot-display` (boot logo drawing issues), `model` (GPU display name, if detection failed).
While not pretending to be perfect, there is a [SSDT sample](https://github.com/vit9696/WhateverGreen/blob/master/Docs/Sample.dsl) to get the general idea.
While not pretending to be perfect, there is a [SSDT sample](https://github.com/vit9696/WhateverGreen/blob/master/Manual/Sample.dsl) to get the general idea.

- _When do I need to use `radpg` boot argument?_
This argument is as a replacement for the original igork's AMDRadeonX4000 Info.plist patch required for some 7xxx GPUs to start. WhateverGreen is not compatible with Verde.kext, and it should be deleted. The argument allows to force-enable certain power-gating flags like CAIL_DisableGfxCGPowerGating. The value is a bit mask of CAIL_DisableDrmdmaPowerGating, CAIL_DisableGfxCGPowerGating, CAIL_DisableUVDPowerGating, CAIL_DisableVCEPowerGating, CAIL_DisableDynamicGfxMGPowerGating, CAIL_DisableGmcPowerGating, CAIL_DisableAcpPowerGating, CAIL_DisableSAMUPowerGating. Therefore `radpg=15` activates the first four keys.
Expand All @@ -44,7 +45,7 @@ If this bothers you, either wait a bit longer or try adding `darkwake=0` boot ar
One of the easiest signs is boot time. If initialised improperly, your boot process will stall for 30 extra seconds to get your display ready.

- _Is it normal to have `Prototype` in OpenGL/OpenCL engine names?_
Yes. It was discovered during the reverse-engineering that the displayed title has no effect on performance. Furthermore, it was discovered that certain attempts to patch this by modifying the identitiers in kexts (e.g. AMDRadeonX4000) may lead to overall system instability.
Yes. It was discovered during the reverse-engineering that the displayed title has no effect on performance. Furthermore, it was discovered that certain attempts to patch this by modifying the identitiers in kexts (e.g. AMDRadeonX4000) may lead to overall system instability. For the improperly coded apps having issues with such naming use `libWhateverName.dylib`.

- _How do I use my IGPU?_
In most cases IGPU should be used for hardware video decoding (with a connector-less frame). In case you need extra screens, IGPU may be fully enabled. You should not use `-radlogo` boot argument with IntelGraphicsFixup.
Expand Down
5 changes: 3 additions & 2 deletions Manual/FAQ.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@
Установить DEBUG версии WhateverGreen и Lilu, добавить `-raddbg -liludbg` в аргументы загрузки. После запуска выполнить команду в терминале:
`log show --predicate 'process == "kernel" AND (eventMessage CONTAINS "WhateverGreen" OR eventMessage CONTAINS "Lilu")' --style syslog --source`
Для macOS 10.11 и старее использовать:
`cat /var/log/system.log | egrep '(WhateverGreen|Lilu)'`
`cat /var/log/system.log | egrep '(WhateverGreen|Lilu)'`
Следует обратить внимание, что если проблема с видеокартой, то лог можно получить через SSH. В этом случае стоит также проверить вывод `kextstat`.

- _Каково состояние поддержки 10.13?_
В момент выпуска 10.13 находится на стадии тестирования, потому об официальной поддержке речи не идёт. Известны случаи незапуска графики на чипсетах старше Nehalem. Если у вас имеется подобное железо, воздержитесь от обновления. В остальных случаях WhateverGreen может работать, при условии отстутствия значительных изменений в 10.13.
Expand Down Expand Up @@ -44,7 +45,7 @@ UEFI без использования CSM. В случае отсутствия
Один из наиболее простых показателей — время загрузки. При неправильном заводе загрузка происходит на 30 секунд дольше.

- _Нормально ли иметь в названии движка OpenGL/OpenCL `Prototype`?_
Да, нормально. В процессе обратной разработки удалось выяснить, что отображаемое название никак не влияет на производительность. Напротив, попытки поменять данное название патчем идентификаторов в кекстах (например, AMDRadeonX4000) могут привести к нестабильной работе системы.
Да, нормально. В процессе обратной разработки удалось выяснить, что отображаемое название никак не влияет на производительность. Напротив, попытки поменять данное название патчем идентификаторов в кекстах (например, AMDRadeonX4000) могут привести к нестабильной работе системы. Для безалаберно написанных приложений, работающих неправильно с подобными названиями можно использовать `libWhateverName.dylib`.

- _Как использовать IGPU?_
В большинстве случаев желательно использовать IGPU для декодирования видео (с заводом на фрейм без коннекторов). В случае необходимости дополнительных мониторов возможно активировать IGPU полностью. При использовании IntelGraphicsFixup аргумент загрузки `-radlogo` не требуется.
Expand Down
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ WhateverGreen
- Fixes boot to black screen
- Fixes sleep wake to black screen
- Fixes boot logo distortion in certain cases (`-radlogo`)
- Fixes transmitter/encoder in autodetected connectors for multimonitor support
- Fixes transmitter/encoder in autodetected connectors for multimonitor support (`-raddvi`)
- Fixes certain HD 7xxx initialisation (`radpg=15`)
- Allows enforcing 24-bit mode on unsupported displays (`-rad24`)
- Allows booting without video acceleration (`-radvesa`)
Expand All @@ -26,10 +26,11 @@ No support is provided for the time being.
Add `-raddbg` to enable debug printing (available in DEBUG binaries).
Add `-radvesa` to disable ATI/AMD video acceleration completely.
Add `-radoff` to disable WhateverGreen.
Add `-radbeta` to enable WhateverGreen on unsupported os versions.
Add `-radbeta` to enable WhateverGreen on unsupported os versions (10.13 and below are enabled by default).
Add `-rad24` to enforce 24-bit display mode.
Add `-radlogo` to patch boot logo distortion.
Add `radpg=15` to disable several power-gating modes (read FAQ for more details).
Add `radpg=15` to disable several power-gating modes (see FAQ, required for 7xxx GPUs).
Add `-raddvi` to enable DVI transmitter correction (required for 290X, 370, etc.)

#### Credits
- [Apple](https://www.apple.com) for macOS
Expand Down

0 comments on commit f4c6774

Please sign in to comment.