Clover Change Explanations

[Sherlocks]

Rev 4683/4688/4689

avoid conflicts between AppleUiSupport driver and old FV2 drivers when installing.

no more manually delete old FV2 driver in folder if you have AppleUiSupport driver when installing Clover.

Clover will keep your AppleUiSupport driver without old FV2 Drivers.

 

Rev 4692

avoid conflicts between SMCHelper driver and VirtualSMC driver when installing.

no more manually delete SMCHelper in folder if you have VirtualSMC driver when installing Clover.

Clover will keep your VirtualSMC driver without SMCHelper.

Edited October 3, 2018 by Sherlocks

[Sherlocks]

Rev 4696

Fixed potential black screen issue if SetIntelMaxBacklight.

 

Default LEVX

- Sandy Bridge/Ivy Bridge: 0x0710(1808)
- Haswell/Broadwell: 0x056C(1388)/0x07A1(1953)/0x0AD9(2777)/0x1499(5273)
- Skylake/KabyLake: 0x056C(1388)
- Coffee Lake: 0xFFFF(65535)

 

Rev 4698

Fixed AddPNLF for some laptop that can't control backlight.

 

Default _UID

- Lynnfield/older: 10

- Sandy Bridge/Ivy Bridge: 14
- Haswell/Broadwell: 15
- Skylake/KabyLake/Coffee Lake: 16

- ATI/NVIDIA: 10

 

Edited October 24, 2018 by Sherlocks

[Sherlocks]

Rev 4716

new way for reset native NVRAM in GUI by Sherlocks. thanks to vit9696.

 - it's perfectly same process by vit9696's CleanNvram.efi. now we can't properly delete NVRAM variables in Mojave. so if you want to clean NVRAM, press F11 in GUI.

 - caution! your bootorder also will be deleted(it means that bootorder initialized) if you have a dual boot(macos and windows). it's different according to user system

 

Rev 4717

prevent clover boot options from being deleted when NVRAM is reset

Edited October 24, 2018 by Sherlocks

[Sherlocks]

Rev 4719

Added prelang kbd option if want to keep language when updating macOS with native NVRAM.

 - This is the key to fixing macOS language problems when using native NVRAM.

 - This is macOS bug for long time ago.

 - When using only AptioMemoryFix or OsxAptioFixV3 without emuvariableuefi.efi

 - When using a language other than English

 

- can fix issues blow if use this key.

    <key>GUI</key>
    <dict>

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

    </dict>

 

1. mixed language in restart popup after updating macOS.

 

2. always keep english when updating macOS in recovery despite to user already use other language in macOS.

Edited October 24, 2018 by Sherlocks

[Slice]

Rev 4729

Vector theme became usable. I will write instructions asap. At this moment you can see first theme created by Clovy.

Designed as

 

Real works as

 

OK, not the same.

There are still bugs and absent features. Anyway it somehow works!

[Slice]

Rev 4733

Corrected positions and centerings

[Slice]

Rev 4747

SVG theme can include PNG images. To scale it dithering used.

 

Instruction is follow

1. With vector graphics editor import PNG file into your svg file.

2. Select the object and convert it into pattern.

3. Create an empty shape and set for it Fill->Pattern. There is an circle in the screen.

4. The pattern ID always must be "pattern_xxx" i.e. contain the word "pattern".

 

[Slice]

Rev 4752

Multilevel dithering. By default level = 1.

level = 0 will be without dithering.

For radial gradients like on Clovy vector theme this is not enough. A distance between different colors is too big. So we need dithering with larger steps. I can't calculate the step automatically, so I introduce addition for SVG "ditherCoarse".

It must have a namespace Clover to be ignored by other applications.

	<radialGradient id="GrayRadialBackground_1_" cx="358.2806" cy="0.743" r="0.8783"
                    gradientTransform="matrix(4.700000e-14 768 -768 4.700000e-14 1176.1536 -274946.875)" 
                    gradientUnits="userSpaceOnUse" 
                    clover:ditherCoarse="16">
		<stop  offset="0" style="stop-color:#606060"/>
		<stop  offset="1" style="stop-color:#1F1F1F"/>
	</radialGradient>

So there is a result.

Test square dithered with coarse level=1. As well as the sphere.

While radial background with coarse=16

[Slice]

Rev 4773

Daylight support in Clover GUI (like in Mojave).

You should choose

	<key>GUI</key>
	<dict>
		<key>Timezone</key>
		<integer>3</integer>
		<key>Theme</key>
		<string>embedded</string>
		<key>EmbeddedThemeType</key>
		<string>Daytime</string>

Then BIOS time + Timezone will be compared to 8:00 of morning and 20:00 of evening and set light type or dark.

 

Rev 4774

Clovy SVG theme has os_moja_night icon and Background_night to choose depending on daylight.

[Slice]

Rev 4779

Implemented bootcamp style for vector themes

It looks like follow

 

In <clover:theme ... settings there will be

BootCampStyle="1"

 

And there must be indicator image. I draw simple triangle

	<g id="selection_indicator">
	  <rect visibility="hidden" id="BoundingRect_141_" x="83" y="15" class="st162" width="64" height="64"/>
    	<path d="M 490.376 309.525 Q 490.992 308.43 491.641 309.525 L 507.876 336.934 Q 508.525 338.029 507.26 338.029 L 475.613 338.029 Q 474.348 338.029 474.964 336.934 Z" style="fill: rgb(216, 216, 216);" />
	</g>

 

[Slice]

Rev 4789

Three big news with SVG support:

1. Image can contain text

2. Images can be constructed with <symbol>. The picture above

3. Vector theme can have animated main screen. The first one in BGM_SVG by Blackosx.

[Slice]

Rev 4794

Implemented command line to manage boot.efi output

Explanations by vit9696 

 

By default I set command line as "log=0" it means you will not see long output from system start to ++++++

The setting can be changed in Clover GUI->Options->System parameters

[Slice]

Rev 4833

There is an audio interface in Clover. Regards to Goldfish64 https://github.com/Goldfish64/AudioPkg

I made a sound playback in Clover using his Audio driver.

Place driver AudioDxe.efi into /EFI/CLOVER/drivers64UEFI/ AudioDxe.efi.zip

Place application BootChimeCfg.efi into /EFI/CLOVER/tools/ BootChimeCfg.efi.zip

Place a sound file into your theme folder, for example, /EFI/CLOVER/theme/cesium/. There can be two files: "sound.wav" and "sound_night.wav".   For example sound.wav.zip

After reboot you will hear sound before Clover GUI. It is startup sound like chime in real Mac.

Sound file must be 44100Hz, 16bps, WAV format.

You can convert any sound file into such format using VLC application.

 

Tuning.

Before first start you have to tune your sound system.

Start Clover, goto Shell.

Shell> fs0:

fs0:> cd EFI\CLOVER\tools

fs0:EFI\CLOVER\tools>BootChimeCfg.efi

You will see all options

-l -- list all devices. See and choose.

Then you have to configure and hear.

BootChimeCfg.efi -s 1 -v 60 -t

Audio Output=1 and Sound Volume=60% will be stored in NVRAM and will be used by Clover after next restart.

 

Enjoy!

[Slice]

Rev 4840

Sync and Async sound play.

Sync play - sound play before enter Clover GUI. Clover GUI started after the sound is finished.

Async play - sound started to play before Clover GUI started and continue playing when GUI is ready.

To switch edit config.plist

	<key>GUI</key>
	<dict>
		<key>PlayAsync</key>
		<false/>

In theory async is better. But somehow async playing is buggy so default is false.

[vit9696]

Rev 4846

 

Fixes random kernel panics in macOS 10.14 upon boot when kext injection is used and keepsyms=1 boot argument is not provided. Now this should work just as normal like in 10.13 and lower.

[Slice]

Rev 4847-4852

There is interface in Clover GUI to tune startup sound parameters

Computer will play a sound before enter Clover GUI. To do this you have to

1. Use CloverX64.efi revision 4852 or up.

2. Place AudioDxe-64.efi into drivers64 and drivers64UEFI. Playing is possible in both legacy and UEFI modes. AudioDxe.efi is included into Clover project and will be differ from original by Goldfish64 but almost compatible.

3. Place sound.wav and may be sound_night.wav into your theme folder, for example /EFI/CLOVER/theme/Clovy/. The sound must be 16bit, and 44100 or 48000Hz. But I also made conversion on the fly so 8000Hz is also supported.

4. Tune sound output in Clover GUI as on screen above. The settings will be stored in NVRAM and used next restart. With legacy Clover or systems without nvram you have to use EmuVariableUefi.efi and rc.scripts to save nvram.plist. For very new systems like Z370 where nvram is not working in macOS there is a chance that the nvram is working on Clover level and so all will works. SIC! Legacy Clover saved Variables only with Apple guid so why it will not work. After some discussing I may rebuild the system to use AppleBootGuid. In this case the system will not be compatible with the original driver but will work with legacy systems.

 

No more needs in BootChimeCfg and BootChimeDxe while the compatibility still remains.

[Slice]

Rev 4938 - 4961

Catalina compatibility.

[Slice]

Rev 4967

Cosmetics

[Sherlocks]

Rev 4969 - 4972

improve lapic fix and add lapic master fix

improve kext inject for next macOS

[Slice]

Rev 4976

Improve Apple ROM info

[Slice]

Rev 5000+

 

Now Clover version 2.5k.

It assumes new folder structures

drivers
  BIOS
  off
  UEFI

instead of older folders drivers64 (now drivers/BIOS) and drivers64UEFI (now drivers/UEFI).

 

As well I have to note that there is no automatic update from 2.4 to 2.5. CloverUpdater can't switch versions.

You have to install new version manually and carefully check drivers directories if all needed files presents here.

Thanks Chris1111 for the picture!

[Slice]

Rev 5028

Fix PatchAPIC by Florin9doi

Explanations here

[vector sigma]

Rev 5030

1. espfinder. new way to mount the ESP using this new command line. Is Beta so for now is only activated if /useespfinder is present in the root

   sudo touch /useespfinder

    espfinder should work with APFS, CoreStorage, Fusion, RAID and with a mix of the mentioned.

Edited August 24, 2019 by vector sigma

[Slice]

Rev 5049

Resolved old bug causing Clovy theme to crash.

It is usable now.

[Slice]

Rev 5051

Explanations from Pene