Как изменить разрешение clover при загрузке

Описание параметров файла config.plist

Оглавление

1. GUI

• 1.1 TextOnly
• 1.2 ConsoleMode
• 1.3 Theme
• 1.4 EmbeddedThemeType
• 1.5 Timezone
• 1.6 PlayAsync
• 1.7 CustomIcons
• 1.8 ScreenResolution
• 1.9 ProvideConsoleGop
• 1.10 KbdPrevLang
• 1.11 Language
• 1.12 Mouse
  • 1.12.1 Enabled
  • 1.12.2 Speed
  • 1.12.3 Mirror
• 1.13 Hide
• 1.14 Scan
  • 1.14.1 Legacy
  • 1.14.2 Entries
  • 1.14.3 Tool
  • 1.14.4 Linux
  • 1.14.5 Kernel
• 1.15 Custom
  • 1.15.1 Entries
  • 1.15.2 Legacy
  • 1.15.3 Tool
• 1.16 ShowOptimus
  2. Boot
• 2.1 Timeout
• 2.2 Fast
• 2.3 DefaultVolume
• 2.4 DefaultLoader
• 2.5 Legacy

1. GUI

• Описание:

  Группа параметров, с помощью которых можно настроить вид загрузчика Clover.

//TODO: добавить пример кода со всеми параметрами из данной группы со значениями по умолчанию

1.1 TextOnly

• Тип значения: boolean

• Значение по умолчанию: false

• Возможные значения: false, true

• Описание:

  Данный параметр позволяет отображать интерфейс загрузчика в текстовом режиме. Если стоит false, то Clover работает в графическом режиме. Разрешение текстового экрана, здесь, а также в Shell.efi и на экране boot.efi, можно установить с помощью параметра ConsoleMode.

• Пример кода:

  <key>TextOnly</key>
  <false/>

• Пример результата применения:

1.2 ConsoleMode

• Тип значения: string

• Значение по умолчанию: 0

• Возможные значения: 0, Min, Max, [number]

• Описание:

  Переключит драйвер консоли в требуемый режим консоли (который используется оболочкой, boot.efi, shell.efi, dumpueficalls и т.д.). Обычно в этом нет необходимости, и следует использовать только там, где это необходимо.

• Пример кода:

  <key>ConsoleMode</key>
  <string>0</string>

1.3 Theme

• Тип значения: string

• Значение по умолчанию: embedded

• Возможные значения: random, embedded, [text]

• Описание:

  Если вы не включили текстовый режим загрузчика Clover, то оформление графической оболочки будет зависеть от выбранной темы. Значение данного параметра это имя папки в /CLOVER/themes, которая содержит соответствующую структуру файлов.

  //TODO: добавить ссылку на инструкцию по созданию темы и theme.plist

  //TODO: добавить ссылку на информацию о контрольной панели

  Тему можно выбрать в Контрольной панели Clover, и оно будет определяющим, в независимости от того, какая тема написана в config.plist. Если указана неправильная тема (в указанной папке нет файла theme.plist), то будет выбрана тема из config.plist. Если и там указана неверная тема, то будет отображаться встроенная embedded тема (последний вариант от Clovy). Так же, начиная с ревизии 1955 тему можно сменить и в самом загрузчике, перейдя в Options -> GUI tuning -> Themes. После выбора темы и перехода на начальный экран загрузчика, выбранная тема сразу применится и вид загрузчика изменится.

  Тему можно скачать и установить вручную просто скачав архив с нужной темой, распаковав его в папку /CLOVER/themes и указав название папки с файлами темы параметре Theme. Официальный список и содержимое тем есть в github репозитории загрузчика (так же хранилище тем есть на SourceForge, но это устаревший вариант, т.к. он давно никем не обновляется) или в соответствующей теме форума insanelymac. Так же есть приложения для удобного просмотра тем и их автоматической настройки — Clover.app и Clover Theme Manager (он вроде бы устарел).

  Если вписать значение random, то при каждой загрузки в Clover будет использоваться случайная тема из тех, что находятся в CLOVER/themes.

  Если ваш монитор имеет разрешение, например 2560х1600 или 4K, то
  иконки и текст на экране будет слишком мелким. Чтобы это исправить, нужно использовать тему с более крупными значками и более крупным размером текста. Начиная с ревизии 4438 загрузчик Clover может самостоятельно на большом мониторе использовать крупную тему, а на маленьких — обычную тему. Крупная тема должна называться также, как и обычная, но с приставкой @2x. Например в параметре Theme указано значение metal и тогда для мониторов с небольшим разрешением Clover будет использовать файлы из папки /CLOVER/themes/metal, а для мониторов с большим разрешением Clover будет использовать файлы из папки /CLOVER/themes/metal@2x. Критерий «большого» монитора это количество пикселей больше 1100 по высоте.

  Начиная с ревизии 4862 загрузчик Clover стал поддерживать масштабируемые, т.е. векторные темы. В векторных темах используется файл theme.svg, а в обычной растровой файл theme.plist. По наличию этих файлов Clover и отличает какая тема находится в папке. Сами же векторные темы начали внедрятся начиная с ревизии 4279 (пост на insanelymac об этом).

• Пример кода:

  <key>Theme</key>
  <string>BGM</string>

1.4 EmbeddedThemeType

• Тип значения: string

• Значение по умолчанию: DayTime

• Возможные значения: DayTime, Dark, Light

• Описание:

  С помощью значений Dark и Light в данном параметре можно включить светлую или темную версию выбранной темы (конечно, если в теме присутствует светлая и темная версия). Если выбранная тема не сделана с учетом темной и светлой версии, то просто в любом случае будет отображаться единственный вариант этой темы. Данный параметр добавлен в ревизии 4644.

  В ревизии 4773 добавлено значение DayTime (пост на insanelymac об этом). Если выбрано данное значение, то темная и светлая версия выбранной темы переключается в зависимости от времени суток, по аналогии с Mojave. Clover включает светлую версию темы в промежутке от 8:00 до 20:00.

• Пример кода:

  <key>EmbeddedThemeType</key>
  <string>DayTime</string>

1.5 Timezone

• Тип значения: integer

• Значение по умолчанию: 3

• Возможные значения: +3, -5, [number]

• Описание:

  Этот параметр актуально использовать только в паре с EmbeddedThemeType со значением DayTime. При запуске Clover считывает время из BIOS (оно обычно по Гринвичу) и прибавляет число из этого параметра и в сумме получается локальное время. Значения можно писать со знаком + или со знаком - или без знака (что равносильно знаку +). Параметр добавлен в ревизии 4773 (пост на insanelymac об этом).

• Пример кода:

  <key>Timezone</key>
  <integer>3</integer>

1.6 PlayAsync

• Тип значения: boolean

• Значение по умолчанию: false

• Возможные значения: false, true

• Описание:

  В зависимости от значения в этом параметре, Clover определяет проигрывать звук синхронно со своей работой или асинхронно.

  При синхронном воспроизведении ничего не работает, пока звуковая дорожка не закончится. То есть при синхронном режиме даже GUI загрузчика Clover не отобразится, пока вся аудиодорожка не проиграет.

  При асинхронном воспроизведении звук играет независимо от действий, происходящих на экране. Звук начинает играть после появления на экране сообщения ...scan entries... затем появляется интерфейс Clover, воспроизведение звука продолжается, затем появляются строчки работы boot.efi, воспроизведение звука продолжается, затем запускается ядро, и по очереди запускаются кексты. Начиная с какого-то из них, воспроизведение звука обрывается. Ну это, разумеется, если аудиодорожка в файле sound.wav длинная.

  Сама функция воспроизведения звука во время загрузки Clover добавлена в ревизии 4833 (пост на insanelymac об этом) и она работает при наличии драйвера AudioDxe.efi (автор Goldfish64). Этот параметр добавлен в Clover в ревизии 4840 (пост на insanelymac об этом).

  Clover ревизии 4862 имел баг и включенный параметр PlayAsync (именно со значением true) вызывал не давал правильно работать компьютеру. В ревизии 4870 этот баг исправили.

• Пример кода:

  <key>PlayAsync</key>
  <false/>

1.7 CustomIcons

• Тип значения: boolean

• Значение по умолчанию: false

• Возможные значения: false, true

• Описание:

  Этот параметр используется для отображения кастомных иконок у разделов диска. Если значение true, то для каждого раздела с операционной системой будет выполняться поиск иконки .VolumeIcon.icns в корне раздела и использоваться вместо иконок, заданных темой.

• Пример кода:

  <key>CustomIcons</key>
  <false/>

1.8 ScreenResolution

• Тип значения: string

• Значение по умолчанию: 1280x1024

• Возможные значения: 1280x1024, 1920x1080, [text]

• Описание:

  Этот параметр позволяет установить разрешение экрана в меню загрузчика Clover. Clover пытается выставить наибольшее возможное разрешение, однако, он может ошибиться. Проверяйте список доступных режимов в boot.log.

  Если в секции Graphics параметр PatchVBios имеет значение true, то у вас появится максимальное разрешение, доступное для данного монитора. В этом случае параметр ScreenResolution может оказаться лишним. С некоторыми конфигурациями параметр PatchVBios может быть фатальным — будет отображаться черный экран без признаков жизни.

  При использовании данного параметра есть одна тонкость. Загрузчику Clover должен быть известен EDID монитора. Legacy Clover пытается его получить через вызовы INT10 BIOS, часто это успешно, иногда неуспешно. UEFI CLover запрашивает данные у UEFI BIOS, который наверняка знает EDID для встроенной видеокарты, и наверняка не знает для вставленной. Смотрите preboot.log, и если там нет EDID, то вписывайте его вручную.

//TODO: добавить ссылки на EDID и на PatchVBios

• Пример кода:

  <key>ScreenResolution</key>
  <string>1280x1024</string>

1.9 ProvideConsoleGop

• Тип значения: boolean

• Значение по умолчанию: true

• Возможные значения: true, false

• Описание:

  Этот параметр создает протокол GOP для режима консоли ConsoleMode, то есть, чтобы вывод текста был не в текстовом режиме, как привыкли делать в PC BIOS, а в графическом, как это делает Apple.

  В некоторых ревизиях Clover, этот параметр дублировался с квирком ProvideConsoleGopEnable, но начиная с ревизии 5128 этот параметр убран из списка квирков и есть только в разделе GUI с немного другим названием. Значение параметра ProvideConsoleGop из раздела GUI будет переопределять значение параметра ProvideConsoleGopEnable из списка квирков, если вдруг вы забыли убрать этот параметр из конфига при обновлении загрузчика.

  Параметр лучше не выключать, нет адекватных аргументов в пользу его выключения.

• Пример кода:

  <key>ProvideConsoleGop</key>
  <true/>

1.10 KbdPrevLang

• Тип значения: boolean

• Значение по умолчанию: false

• Возможные значения: false, true

• Описание:

  Этот параметр используется для исправлению языковых проблем macOS при использовании нативного NVRAM. Этот баг macOS существует уже давно. Включите этот параметр (задайте значение true), если вы хотите сохранить язык системы при обновлении macOS с помощью встроенного NVRAM.

  Этот параметр работает только при использовании AptioMemoryFix или OsxAptioFixV3 без EmuVariableuefi.efi, т.е. нужен «железный» NVRAM. И также параметр работает при использовании языка, отличного от английского.

  Рекомендуется всегда сохраняйте английский язык при обновлении macOS в режиме восстановления, несмотря на то, что пользователь уже использует другой язык в macOS.

  Этот параметр добавлен в ревизии 4719 разработчиком Sherlocks. В посте на insanelymac он описал свойства этого параметра.

  Вы можете исправить проблемы ниже, используя этот ключ:

  <key>GUI</key>
      <dict>
          <key>KbdPrevLang</key>
          <true/>
          <key>Language</key>
          <string>ru:0</string>          <----- you want language
      </dict>

• Пример проявления проблемы:

• Пример кода:

  <key>ProvideConsoleGop</key>
  <true/>

1.11 Language

• Тип значения: string

• Значение по умолчанию: ru:0

• Возможные значения: ru:0, en:0, fr:0, it:0, es:0, pt:0, br:0, de:0, nl:0, pl:0, ua:0, cz:0, hr:0, id:0, ko:0, [text]

• Описание:

  На данный момент установка языка с помощью этого параметра имеет смысл только для меню «Help» вызываемого по клавише F1. Также, это значение передается в систему, и может повлиять на язык по умолчанию.

• Пример кода:

  <key>Language</key>
  <string>ru:0</string>

1.12 Mouse

• Описание:

  Группа параметров, с помощью которых можно настроить работу мыши и курсора в меню загрузчика Clover

//TODO: добавить пример кода со всеми параметрами из данной группы со значениями по умолчанию

1.12.1 Enabled

• Тип значения: boolean

• Значение по умолчанию: true

• Возможные значения: true, false

• Описание:

  Этот параметр включает работу мыши и, соответственно, отображение курсора в меню Clover. От того, включен ли этот параметр имеет смысл включение других параметров в этой категории.

• Пример кода:

  <key>Enabled</key>
  <true/>

1.12.2 Speed

• Тип значения: integer

• Значение по умолчанию: 2

• Возможные значения: 2, 3, 4, 5, 6, 7, 8, [number]

• Описание:

  Этот параметр корректирует скорость перемещения мыши в меню Clover. Разумные значения от 2 до 8 включительно. Для некоторых мышей требуется отрицательная скорость, перемещение в обратном направлении. Значение 0 означает, что мышь отключена.

• Пример кода:

  <key>Speed</key>
  <integer>2</integer>

1.12.3 Mirror

• Тип значения: boolean

• Значение по умолчанию: false

• Возможные значения: false, true

• Описание:

  Этот параметр включает зеркальное перемещение курсора, то есть перемещение в обратном направлении от того, куда вы двигаете курсор.

• Пример кода:

  <key>Mirror</key>
  <false/>

1.13 Hide

• Тип значения: array

• Значение по умолчанию:

• Возможные значения: WindowsHDD, BOOTX64.EFI, E223FF7F-F2DA-4DBB-B765-756F2D95B0FE, [text]

• Описание:

  Этот параметр позволяет скрыть отображение определенных разделов в меню Clover, указав имя раздела или его GUID. Таким образом вы сможете убрать из меню отображение ненужных разделов, например Recovery или Preboot.

  В интерфейсе загрузчика Clover можно увидеть legacy и UEFI загрузчики для установленных операционных систем. При этом на одном разделе может быть и несколько загрузчиков. Может быть, вам и не нужно видеть все, что нашел Clover, и вам достаточно отображение пары реальных систем. Вы можете скрыть из интерфейса как отдельные разделы, так и целые классы загрузчиков.

• Пример кода:

  <key>Hide</key>
  <array>
      <string>WindowsHDD</string>
      <string>BOOTX64.EFI</string>
      <string>E223FF7F-F2DA-4DBB-B765-756F2D95B0FE</string>
      <string>HD(1,GPT,E223FF7F-F2DA-4DBB-B765- 756F2D95B0FE)</string>
  </array>

1.14 Scan

• Описание:

  Группа параметров, с помощью которых можно указать загрузчику Clover, что именно сканировать

//TODO: добавить пример кода со всеми параметрами из данной группы со значениями по умолчанию

1.14.1 Legacy

• Тип значения: string, boolean

• Значение по умолчанию: false

• Возможные значения: No, First, Last, false

• Описание:

  Этот параметр включает или выключает поиск устаревших загрузчиков, запускаемых из PBR. Есть варианты значений No — не показывать вообще эти разделы, First — расположить legacy разделы в начале списка, Last — расположить legacy разделы в конце списка.

• Пример кода:

  <key>Legacy</key>
  <false/>

1.14.2 Entries

• Тип значения: boolean

• Значение по умолчанию: true

• Возможные значения: true, false

• Описание:

  Этот параметр включает или выключает поиск UEFI записей на каждом разделе при загрузке Clover.

• Пример кода:

  <key>Entries</key>
  <true/>

1.14.3 Tool

• Тип значения: boolean

• Значение по умолчанию: true

• Возможные значения: true, false

• Описание:

  Этот параметр включает или выключает поиск UEFI инструментов на каждом разделе при загрузке Clover.

• Пример кода:

1.14.4 Linux

• Тип значения: boolean

• Значение по умолчанию: true

• Возможные значения: true, false

• Описание:

  Этот параметр включает или выключает поиск Linux загрузчиков на каждом разделе при загрузке Clover.

• Пример кода:

1.14.5 Kernel

• Тип значения: string

• Значение по умолчанию: All

• Возможные значения: All, Newest, Oldest, First, Last, MostRecent, Earliest, None

• Описание:

  Этот параметр включает или выключает поиск ядра Linux на каждом разделе при загрузке Clover.

  Дополнительно вы можете выбрать один из нескольких вариантов:

  • All — все найденные ядра
  • Newest — самый свежий измененный файл по дате
  • Oldest — самый старый измененный файл по дате
  • First — первый совпавший
  • Last — последний совпавший
  • MostRecent — самая последняя версия
  • Earliest — самая ранняя версия
  • None — не сканировать ядра

• Пример кода:

  <key>Kernel</key>
  <string>All</string>

1.15 Custom

• Описание:

  Группа параметров, с помощью которых можно более тонко настроить интерфейс меню загрузчика, если вы понимаете как и что нужно делать. В нем находится 3 массива. Один элемент массива содержит описание выбранного пункта в виде словаря.

  И каждый пункт меню может содержать еще подпункты (SubEntries), которые представляют собой разные варианты вызова основного ключа.

  Возможно вам будет понятней из описания данного параметра на Sourceforge Wiki. Код, отвечающий за эти параметры, разработал Apianti.

1.15.1 Entries

• Тип значения: array

• Возможные значения: смотрите ниже Описание внутренних параметров

• Пример кода:

  <key>Entries</key>
  <array>
      <dict>
          <key>Hidden</key>
          <false/>
          <key>Disabled</key>
          <false/>
          <key>Image</key>
          <string>os_mageia</string>
          <key>Path</key>
          <string>EFIMAGEIAGRUBX64.efi</string>
          <key>Title</key>
          <string>Mageia Linux</string>
          <key>Type</key>
          <string>Linux</string>
      </dict>
      <dict>
          <key>Hidden</key>
          <false/>
          <key>Hotkey</key>
          <string>M</string>
          <key>Volume</key>
          <string>D68F1885-571C-4441-8DD5-F14803EFEF54</string>
          <key>Arguments</key>
          <string>Kernel=mach_kernel</string>
          <key>Disabled</key>
          <true/>
          <key>AddArguments</key>
          <string>-v</string>
          <key>Path</key>
          <string>EFIBOOTBOOTX64.efi</string>
          <key>Title</key>
          <string>MyCustomEntry</string>
          <key>NoCaches</key>
          <false/>
          <key>InjectKexts</key>
          <false/>
          <key>Type</key>
          <string>OSXRecovery</string>
      </dict>
      <dict>
          <key>Hidden</key>
          <false/>
          <key>Volume</key>
          <string>454794AC-760D-46E8-8F77-D6EB23D2FD32</string>
          <key>SubEntries</key>
          <array>
              <dict>
                  <key>AddArguments</key>
                  <string>-v</string>
                  <key>Title</key>
                  <string>Boot OS X 10.8.5 (12F36) Mountain Lion in Verbose Mode</string>
              </dict>
          </array>
          <key>Type</key>
          <string>OSX</string>
          <key>Title</key>
          <string>OS X 10.8.5 (12F36) Mountain Lion</string>
          <key>NoCaches</key>
          <false/>
          <key>InjectKexts</key>
          <false/>
      </dict>
  </array>

1.15.2 Legacy

• Тип значения: array

• Возможные значения: смотрите ниже Описание внутренних параметров

• Пример кода:

  <key>Legacy</key>
  <array>
      <dict>
          <key>Hidden</key>
          <false/>
          <key>Hotkey</key>
          <string>L</string>
          <key>Volume</key>
          <string>89433CD3-21F2-4D3C-95FC-722C48066D3A</string>
          <key>Disabled</key>
          <true/>
          <key>Type</key>
          <string>Windows</string>
          <key>Title</key>
          <string>MyLegacyEntry</string>
      </dict>
  </array>

1.15.3 Tool

• Тип значения: array

• Возможные значения: смотрите ниже Описание внутренних параметров

• Пример кода:

  <key>Tool</key>
  <array>
      <dict>
          <key>Hidden</key>
          <false/>
          <key>Hotkey</key>
          <string>S</string>
          <key>Volume</key>
          <string>D68F1885-571C-4441-8DD5-F14803EFEF54</string>
          <key>Arguments</key>
          <string>-b</string>
          <key>Disabled</key>
          <false/>
          <key>Path</key>
          <string>EFICLOVERTOOLSShell64-v1.efi</string>
          <key>Title</key>
          <string>MyCustomShell</string>
      </dict>
  </array>

Описание внутренних параметров Custom:

• Disabled — отключает всю структуру и она не принимается во внимание.
• Volume — Имя тома или GUID, которые будут использоваться при поиске
  загрузчика на разделах дисков.
• VolumeType — Тип тома, которому должна соответствовать ваша пользовательская запись. Может быть строкой одного типа или массивом нескольких типов. Допустимые типы томов: Internal, External, Optical, FireWire.
• Path — Местоположение для сканирования загрузчика efi.
• Arguments — Аргументы, которые нужно передать загрузчику. Отменяет аргументы
  загрузки по умолчанию в Boot -> Arguments.
• AddArguments — Добавляет аргументы загрузки по умолчанию. Для SubEntry он
  добавляет аргументам к основной записи.
• Title — Изменяет отображаемый заголовок. Использует формат «Boot Title from
  VolumeName«
• FullTitle — Устанавливает отображаемый заголовок только «FullTitle» без какого либо формата.
• Image — Путь к файлу настраиваемого изображения. Путь поиска — это корневой каталог тома записи, каталог тем, каталог клевера, корневой каталог тома клевера и, наконец, имена значков ОС.
• ImageData — Встроенное собственное изображение. Может быть в формате PNG или
  BMP, определенная в конфиге как бинарный массив.
• DriveImage — Путь к файлу пользовательского картинки диска. Путь поиска — это корневой каталог тома записи, каталог тем, каталог клевера, корневой каталог тома клевера и, наконец, имена значков ОС.
• DriveImageData — Встроенный собственная картинка диска. Может быть в формате PNG или BMP.
• Hidden — Скрывает запись. Если значение true, запись можно отобразить, нажав F3 в меню Clover. Если значение равно Always, запись никогда не будет отображаться.
• InjectKexts — Внедряет кексты. Допустимые варианты: Yes, No или Detect. А еще на какой-то Entry можно поставить. Используйте Detect для внедрения кекстов, только если FakeSMC отсутствует в KernelCache или /S/L/E. Для записей типа OSX, OSXInstaller и OSXRecovery.
• NoCaches — Пропустить кеши. Для записей типа OSX, OSXInstaller и OSXRecovery.
• Kernel — Установите приоритет сканирования ядра Linux. Если эта опция не указана, Clover покажет все найденные ядра. Допустимые варианты: Newest, Oldest, First, Last, MostRecent, Earliest. Для записей типа LinuxKernel.
• Type — Тип ОС, на которую выполняется сканирование. Допустимые типы: OSX, OSXInstaller, OSXRecovery, Windows, Linux, LinuxKernel. Если Тип не один из перечисленных, он будет рассматриваться как все типы.
• BootBgColor — Задает цвет фона загрузочного экрана. Для записей типа OSX, OSXInstaller и OSXRecovery.
• CustomLogo — Определяет стиль логотипа загрузочного экрана. Для получения
  дополнительной информации прочтите Boot -> CustomLogo.
• SubEntries — По умолчанию: true. Отключает вложенные записи по умолчанию, если установлено значение false. Может также использоваться для создания настраиваемых вложенных записей с использованием той же структуры, что и основная запись, любые настройки, которые не установлены во вложенной записи, будут унаследованы от основной записи.
• KernelAndKextPatches — Использует ту же иерархию и предлагает те же функции, что и KernelAndKextPatches, поэтому вы можете выборочно применять исправления для каждой записи. Работает только с версией 2797 или выше.
• Ignore — Запись будет проигнорирована или не использована, поэтому ни на что не повлияет.
• Hotkey — ?

//TODO: добавить ссылки якорные на аналогичные пункты из конфига

1.16 ShowOptimus

• Тип значения: boolean

• Значение по умолчанию: false

• Возможные значения: false, true

• Описание:

  Этот параметр в зависимости от того, работает у вас встроенная и дискретная видеокарта или только одна из них, отображает слово Intel или Discrete в меню загрузчика Clover внизу по середине.

  Если работает графика Intel + дискретная видеокарта, то на экрана отображается слово Intel. Если работает только дискретная графика, то отображается слово Discrete.

  Этот параметр добавлен в ревизии 4221 и изначально этот параметр предназначался для использования на ноутбуках, потому что на некоторых ноутбуках есть возможность отключить работу режима Optimus в BIOS, но иногда он самопроизвольно включается. И вместо слова Intel отображалось слово Optimus.

• Пример кода:

  <key>ShowOptimus</key>
  <false/>

2. Boot

• Описание:

  Группа параметров, с помощью которых можно настроить параметры загрузки операционных систем из меню Clover.

//TODO: добавить пример кода со всеми параметрами из данной группы со значениями по умолчанию

2.1 Timeout

• Тип значения: integer

• Значение по умолчанию: 5

• Возможные значения: 5, 3, 0, -1, 237, [number]

• Описание:

  Этот параметр позволяет указать сколько секунд надо подождать прежде чем запустить выбранную в меню Clover операционную систему. Отсчет начинается сразу после того, как загрузчик перешел в графический (или текстовый) режим. Если в течении указанного времени пользователь нажмет какую-либо клавишу на клавиатуре или мышке, то отсчет времени прекратится.

  Если задано значение 0, то вы не увидите меню Clover, выбранная по умолчанию для загрузки система сразу будет загружаться. Однако, если нажать (или зажать) пробел — отобразится меню Clover. Этот параметр с этим значением аналогичен параметру Fast со значением true.

  Если установлено значение -1, то появится меню Clover, но попыток старта происходить не будет.

  Бывает, что из-за тяжелой анимации таймер тикает медленнее, чем 1Гц. Это зависит от темы.

  Задержка не работает, если в NVRAM не определена система по умолчанию. Один из вариантов решить эту проблему — зайти в систему, в системную панель «Загрузочный Диск», и перезагрузиться в помощью нее. В следующий раз Timeout будет работать!

• Пример кода:

  <key>Timeout</key>
  <integer>5</integer>

2.2 Fast

• Тип значения: string

• Значение по умолчанию: false

• Возможные значения: false, true

• Описание:

  С включением этого параметра система, начнет запускаться с раздела, заданного в параметре DefaultVolume сразу после запуска компьютера.

  В отличие от параметра Timeout со значением 0, при выставлении значения true для параметра Fast производится дополнительная экономия времени загрузки на том, чтобы не загружать интерфейс и его элементы. Т.е. уже невозможно будет зайти в меню Clover и невозможно будет что-то поправить в случае ошибки.

• Пример кода:

2.3 DefaultVolume

• Тип значения: string

• Значение по умолчанию: LastBootedVolume

• Возможные значения: LastBootedVolume, Macintosh HD, 57272A5A-7EFE-4404-9CDA-C33761D0DB3C, HD(1,GPT,57272A5A-7EFE-4404-9CDA-C33761D0DB3C,0x800,0xFF000), [text]

• Описание:

  Этот параметр используется, чтобы указать, какой раздел является загрузочным по умолчанию в Clover.

  В качестве значений, можно указать:

  • имя раздела, например Macintosh HD.
  • GUID раздела, например 57272A5A-7EFE-4404-9CDA-C33761D0DB3C. Точное значение можно узнать, например в preboot.log или debug.log или Clover boot log.
  • часть пути к устройству, например HD(1,GPT,57272A5A-7EFE-4404-9CDA-C33761D0DB3C,0x800,0xFF000). Точное значение можно узнать, например в preboot.log или debug.log или Clover boot log.
  • LastBootedVolume — означает выбрать тот раздел, который был запущен после последнего запуска компьютера.

  Однако, имя может быть также задано в NVRAM после перезагрузки из контрольной панели «Загрузочный Диск». Имя, заданное в NVRAM является приоритетным.

• Пример кода:

  <key>DefaultVolume</key>
  <string>LastBootedVolume</string>

2.4 DefaultLoader

• Тип значения: string

• Значение по умолчанию: boot.efi

• Возможные значения: boot.efi, bootmgfw.efi, [text]

• Описание:

  Этот параметр используется, чтобы указать, какой загрузчик будет запускаться по умолчанию после запуска компьютера.

  Опять же, имя загрузчика по умолчанию может быть также задано в NVRAM после перезагрузки из контрольной панели «Загрузочный Диск». Имя, заданное в NVRAM является приоритетным. таким образом обеспечивается автозапуск Windows через панель macOS. К сожалению в Windows такого сервиса нет, вернуться в macOS можно только вручную.

• Пример кода:

  <key>DefaultLoader</key>
  <string>boot.efi</string>

2.5 Legacy

• Тип значения: string

• Значение по умолчанию: PBR

• Возможные значения: PBR, PBRtest, PBRsata, LegacyBiosDefault

• Описание:

  Этот параметр используется для запуска старых версий Windows или Linux.

  Очень сильно зависит от аппаратной части и от BIOS, поэтому разработаны несколько алгоритмов, и выбор алгоритма производится в этом ключе.

  • LegacyBiosDefault — это значение используется для тех UEFI BIOS, где есть протокол LegacyBios.
  • PBRtest, PBR, PBRsata – варианты алгоритма PBR boot, подбирается индивидуально — кому с каким повезет.

• Пример кода:

  <key>Legacy</key>
  <string>PBR</string>

Walkthrough of Clover Configurator

I spent some time writing a walkthrough of Clover Configurator. I did this because I wanted to understand how Clover Configurator works and what each of the parameters mean. Let’s go through each of the screens to understand what’s going on. You don’t have to read through this, but I try my best to explain what I’ve learned about each of the settings in clover and what they mean. You don’t necessarily have to read it. You can certainly boot the computer without any of this.

ACPI

ACPI Section of Clover

The first screen shows ACPI configuration. This includes DSDT and SSDT patches. ACPI (Advanced Configuration and Power Interface) is an industry specification for the efficient handling of power consumption in desktop and mobile computers. ACPI specifies how a computer’s basic input/output system (BIOS), operating system, and peripheral devices communicate with each other about power usage. It provides an open standard that is OS-independent that can be used to discover and configure computer hardware components, to perform power management by (for example) putting unused components to sleep, and to perform status monitoring. The ACPI is specified by two types of tables.

• DSDT : Differentiated System Description Table is used to describe what peripherals the machine has. Also holds information on PCI IRQ mappings and power management..
• SSDT : Secondary System Description Table, which is like an extended version of DSDT.

This distinction is important because we can set DSDT and SSDT patches to modify the ACPI when the Hackintosh is loading. Several above include:

• Change XHCI to XHC
• Change SATA0 to SATA
• Change GFX0 to IGPU
• Change HDAS to HDEF

The SSDT table is seen on the bottom right on the Boot secion for Clover Configurator — SSDT-UIAC.aml is a file we will create later to specify our USB devices. You don’t need to bother yourself about this part. Read the section on to understand how an SSDT file is created to map the USB ports.

Boot

Boot section of Clover

• These set of options specify what happens when the system boots. Under arguments, you may want to check the following:
• Verbose (-v): Provides verbose mode.
• Slide=0 : unclear to me what this exactly does, but I found on several forums that the issue of USB drives getting ejected was avoided with this and setting darkwake=on. I chose a different way to avoid this USB drive ejection issue by changing my memory frequency. I am guessing both options work, but give it a go and see.
• Dart=0 : An extra layer of protection against Vt-d issues
• Debug=0x100 : This prevents a reboot during a kernel panic. Helpful to see what happens that leads to the kernel panic.
• Keepsyms=1 : This is a companion setting to debug=0x100. Tells the OS to print the symbols during a kernel panic.
• Under custom flags :
• shikigva=40 : This is a flag specific to iGPU.
• DefaultBootVolume : This uses NVRAM to remember which volume was last booted by Clover and auto selects the same volume for booting.
• TimeOut : This is the number of seconds before the DefaultBootVolume auto boots. Setting this to -1 avoids all timeout, or to 0 to skip the GUI entirely. If set to 0, you can press any key at the boot to get to the GUI to show back up.

Devices

Devices section of Clover

• We are going to skip ahead to this section. This is a very important section also. Pay attention to the bottom right, and choose properties. This is where we will be changing some parameters associated with activating a headless iGPU.
• The primary purpose of this section is to handle property injection for the WhateverGreen.kext here. Some key things to note here:

USB : Under this section, we ensure that Inject and FixOwnership are selected to avoid issues with hanging at a half-printed line somewhere around the Enabling Legacy Matching verbose line. You can also get past that by enabling XHCI Hand Off in BIOS.
Audio:Here we set our audio to inject Layout 11 — this may or may not be compatible with your codec, but you can check on AppleALC’s Supported Codec Page. For me, both Layout 1 and Layout 11 gave good results. We also enabled ResetHDA which puts the codec back in a neutral state between OS reboots. This prevents some issues with no audio after booting to another OS and then back.
Properties: This section is setup via Headkaze’s Intel Framebuffer Patching Guide Intel Framebuffer patching using WhateverGreen and Lilu and plugins, which is the ig-platform-id. The way we get the proper value for this is to look at the ig-platform-id we intend to use, then swap the pairs of hex bytes. To make matters simple, this is how it goes:

If you want the iGPU to drive a display : 07009B3E
If you want the iGPU to run headless (without display) used only for compute tasks : 0300923E

In order for FCPX to run efficiently, Intel QuickSync should be enabled, and this as well as other functions, rely on the iGPU to offload the main GPU. Thus, I chose to run my iGPU in headless mode by setting the parameter:

AAPL;ig-platform-id 	0300923E	DATA 
Device-id		923E0000	DATA

We also add 2 more properties, framebuffer-patch-enable and framebuffer-stolenmem. The first enables patching via WhateverGreen.kext, and the second sets the min stolen memory to 19MB.

GUI

GUI Section of Clover

This section sets parameters for the Clover Boot Manager (CBM) GUI that shows up when you first enter. There is nothing major here to remember since a lot of what happens here is cosmetic.

Scan: The only settings I’ve tweaked on this page are the Scan settings. I’ve selected Custom, then checked everything except Legacy and Kernel. This just omits some of the unbootable entries in Clover to clean up the menu.

Hide Volumes: I haven’t added anything here, but you can hide unwanted volumes here. You can do so by either adding the volume’s name, or UUID. To hide extra APFS entries, add the following to this list:

Preboot

Recovery

To hide all Recovery partitions, add Recovery to the list.
Alternatively, you could also do the same by choosing custom entries. If you choose this option, you can specify which boot drives to show on clover at startup. Since I have a Windows 10 partition, for example, I can open up the options for this, as shown below. Under this, I directly choose the UUID for the partition (NOTE: this is a partition UUID, not Volume UUID).

To get the UUID of a drive to hide, you can use the following terminal command:

Diskutil list

diskutil info diskXsY | grep -i "Partition UUID" | rev | cut -d' ' -f 1 | rev

Make sure to replace diskXsY with the actual disk number of the volume you’d like to hide.

Kernel and Kext Patches

Kernel and Kext Patches Section in Clover

This screen shows a series of kext patches that were applied. I believe a lot of these kext patches have to do with increasing the port limit during various iterations of MacOS 10.x.x so as far as I am concerned the one that matters is really the AppleAHCIPort. This last one acts as an orange icons fix — when internal drives are hotpluggable, and treated as external drives. I believe the others can be removed safely (although I did not). For more information on what this is accomplishing, see my on Custom SSDT for USB 2.0 and 3.0.

Checkboxes: We have a couple checkboxes selected here:

Apple RTC — this ensures that we don’t have a BIOS reset on reboot.

KernelPM — this setting prevents writing to MSR 0xe2 which can prevent a kernel panic at boot.

Rt Variables

The next three sections, Rt Variables, SMBIOS, System Parameters, have to do with setting up System Integrity Protection, iMessage and other iServices. I won’t get into the details of this here, so read up on the trouble shooting section about setting up SMBIOS and iServices. Also for privacy reasons, I am not going to display the screenshots since it contains identifiers specific to my machine.

System Parameters

The only real important thing here is to check the box that states Inject kexts. This essentially tells the system to inject any and all kexts to the loading MacOS.
InjectSystemID : This is also checked. This tells Clover to set the SmUUID as the System-ID at boot. This is again reportedly important to get iServices working properly.

Clover Tools

There are several clover tools that we will be using regularly.

Mount EFI

This screen helps mount any EFI partitions we need to make changes to the EFI Clover folder, for example.

Install Drivers

This tool helps you install the latest version of any UEFI drivers. Note the green indicators under the Drivers UEFI 64-Bit section. The Drivers BIOS 64 Bit are for BIOS based motherboards, and these days virtually everything is UEFI based.

Kexts Installer

This is an easy utility to install Kexts directly from Clover. A couple of things to remember:

1. Always set the OS version (top right) to “Other”. To avoid conflict, I actually delete all the other OS folders in the /EFI/clover/kexts/ folder so that the only one remaining is /EFI/clover/kexts/other/.

2. You can directly check the boxes and the latest kexts from a repository will be downloaded. Some kexts such as VirtualSMC can have additional power-monitoring kexts downloaded. These are deposited in the kexts folder in the EFI partition, and NOT in the /system/library/extensions/ which is where Apple usually places its kexts.

3. In lieu of using this Kext Installer, you could simply copy your latest kext files into the /EFI/clover/kexts/other folder also. They both accomplish the same thing.

Walkthrough of Clover Configurator

I spent some time writing a walkthrough of Clover Configurator. I did this because I wanted to understand how Clover Configurator works and what each of the parameters mean. Let’s go through each of the screens to understand what’s going on. You don’t have to read through this, but I try my best to explain what I’ve learned about each of the settings in clover and what they mean. You don’t necessarily have to read it. You can certainly boot the computer without any of this.

ACPI

ACPI Section of Clover

The first screen shows ACPI configuration. This includes DSDT and SSDT patches. ACPI (Advanced Configuration and Power Interface) is an industry specification for the efficient handling of power consumption in desktop and mobile computers. ACPI specifies how a computer’s basic input/output system (BIOS), operating system, and peripheral devices communicate with each other about power usage. It provides an open standard that is OS-independent that can be used to discover and configure computer hardware components, to perform power management by (for example) putting unused components to sleep, and to perform status monitoring. The ACPI is specified by two types of tables.

• DSDT : Differentiated System Description Table is used to describe what peripherals the machine has. Also holds information on PCI IRQ mappings and power management..
• SSDT : Secondary System Description Table, which is like an extended version of DSDT.

This distinction is important because we can set DSDT and SSDT patches to modify the ACPI when the Hackintosh is loading. Several above include:

• Change XHCI to XHC
• Change SATA0 to SATA
• Change GFX0 to IGPU
• Change HDAS to HDEF

The SSDT table is seen on the bottom right on the Boot secion for Clover Configurator — SSDT-UIAC.aml is a file we will create later to specify our USB devices. You don’t need to bother yourself about this part. Read the section on to understand how an SSDT file is created to map the USB ports.

Boot

Boot section of Clover

• These set of options specify what happens when the system boots. Under arguments, you may want to check the following:
• Verbose (-v): Provides verbose mode.
• Slide=0 : unclear to me what this exactly does, but I found on several forums that the issue of USB drives getting ejected was avoided with this and setting darkwake=on. I chose a different way to avoid this USB drive ejection issue by changing my memory frequency. I am guessing both options work, but give it a go and see.
• Dart=0 : An extra layer of protection against Vt-d issues
• Debug=0x100 : This prevents a reboot during a kernel panic. Helpful to see what happens that leads to the kernel panic.
• Keepsyms=1 : This is a companion setting to debug=0x100. Tells the OS to print the symbols during a kernel panic.
• Under custom flags :
• shikigva=40 : This is a flag specific to iGPU.
• DefaultBootVolume : This uses NVRAM to remember which volume was last booted by Clover and auto selects the same volume for booting.
• TimeOut : This is the number of seconds before the DefaultBootVolume auto boots. Setting this to -1 avoids all timeout, or to 0 to skip the GUI entirely. If set to 0, you can press any key at the boot to get to the GUI to show back up.

Devices

Devices section of Clover

• We are going to skip ahead to this section. This is a very important section also. Pay attention to the bottom right, and choose properties. This is where we will be changing some parameters associated with activating a headless iGPU.
• The primary purpose of this section is to handle property injection for the WhateverGreen.kext here. Some key things to note here:

USB : Under this section, we ensure that Inject and FixOwnership are selected to avoid issues with hanging at a half-printed line somewhere around the Enabling Legacy Matching verbose line. You can also get past that by enabling XHCI Hand Off in BIOS.
Audio:Here we set our audio to inject Layout 11 — this may or may not be compatible with your codec, but you can check on AppleALC’s Supported Codec Page. For me, both Layout 1 and Layout 11 gave good results. We also enabled ResetHDA which puts the codec back in a neutral state between OS reboots. This prevents some issues with no audio after booting to another OS and then back.
Properties: This section is setup via Headkaze’s Intel Framebuffer Patching Guide Intel Framebuffer patching using WhateverGreen and Lilu and plugins, which is the ig-platform-id. The way we get the proper value for this is to look at the ig-platform-id we intend to use, then swap the pairs of hex bytes. To make matters simple, this is how it goes:

If you want the iGPU to drive a display : 07009B3E
If you want the iGPU to run headless (without display) used only for compute tasks : 0300923E

In order for FCPX to run efficiently, Intel QuickSync should be enabled, and this as well as other functions, rely on the iGPU to offload the main GPU. Thus, I chose to run my iGPU in headless mode by setting the parameter:

AAPL;ig-platform-id 	0300923E	DATA 
Device-id		923E0000	DATA

We also add 2 more properties, framebuffer-patch-enable and framebuffer-stolenmem. The first enables patching via WhateverGreen.kext, and the second sets the min stolen memory to 19MB.

GUI

GUI Section of Clover

This section sets parameters for the Clover Boot Manager (CBM) GUI that shows up when you first enter. There is nothing major here to remember since a lot of what happens here is cosmetic.

Scan: The only settings I’ve tweaked on this page are the Scan settings. I’ve selected Custom, then checked everything except Legacy and Kernel. This just omits some of the unbootable entries in Clover to clean up the menu.

Hide Volumes: I haven’t added anything here, but you can hide unwanted volumes here. You can do so by either adding the volume’s name, or UUID. To hide extra APFS entries, add the following to this list:

Preboot

Recovery

To hide all Recovery partitions, add Recovery to the list.
Alternatively, you could also do the same by choosing custom entries. If you choose this option, you can specify which boot drives to show on clover at startup. Since I have a Windows 10 partition, for example, I can open up the options for this, as shown below. Under this, I directly choose the UUID for the partition (NOTE: this is a partition UUID, not Volume UUID).

To get the UUID of a drive to hide, you can use the following terminal command:

Diskutil list

diskutil info diskXsY | grep -i "Partition UUID" | rev | cut -d' ' -f 1 | rev

Make sure to replace diskXsY with the actual disk number of the volume you’d like to hide.

Kernel and Kext Patches

Kernel and Kext Patches Section in Clover

This screen shows a series of kext patches that were applied. I believe a lot of these kext patches have to do with increasing the port limit during various iterations of MacOS 10.x.x so as far as I am concerned the one that matters is really the AppleAHCIPort. This last one acts as an orange icons fix — when internal drives are hotpluggable, and treated as external drives. I believe the others can be removed safely (although I did not). For more information on what this is accomplishing, see my on Custom SSDT for USB 2.0 and 3.0.

Checkboxes: We have a couple checkboxes selected here:

Apple RTC — this ensures that we don’t have a BIOS reset on reboot.

KernelPM — this setting prevents writing to MSR 0xe2 which can prevent a kernel panic at boot.

Rt Variables

The next three sections, Rt Variables, SMBIOS, System Parameters, have to do with setting up System Integrity Protection, iMessage and other iServices. I won’t get into the details of this here, so read up on the trouble shooting section about setting up SMBIOS and iServices. Also for privacy reasons, I am not going to display the screenshots since it contains identifiers specific to my machine.

System Parameters

The only real important thing here is to check the box that states Inject kexts. This essentially tells the system to inject any and all kexts to the loading MacOS.
InjectSystemID : This is also checked. This tells Clover to set the SmUUID as the System-ID at boot. This is again reportedly important to get iServices working properly.

Clover Tools

There are several clover tools that we will be using regularly.

Mount EFI

This screen helps mount any EFI partitions we need to make changes to the EFI Clover folder, for example.

Install Drivers

This tool helps you install the latest version of any UEFI drivers. Note the green indicators under the Drivers UEFI 64-Bit section. The Drivers BIOS 64 Bit are for BIOS based motherboards, and these days virtually everything is UEFI based.

Kexts Installer

This is an easy utility to install Kexts directly from Clover. A couple of things to remember:

1. Always set the OS version (top right) to “Other”. To avoid conflict, I actually delete all the other OS folders in the /EFI/clover/kexts/ folder so that the only one remaining is /EFI/clover/kexts/other/.

2. You can directly check the boxes and the latest kexts from a repository will be downloaded. Some kexts such as VirtualSMC can have additional power-monitoring kexts downloaded. These are deposited in the kexts folder in the EFI partition, and NOT in the /system/library/extensions/ which is where Apple usually places its kexts.

3. In lieu of using this Kext Installer, you could simply copy your latest kext files into the /EFI/clover/kexts/other folder also. They both accomplish the same thing.