mirror of
https://github.com/CloverHackyColor/CloverBootloader.git
synced 2024-11-23 11:35:19 +01:00
240 lines
12 KiB
C
240 lines
12 KiB
C
/** @file
|
|
Copyright (C) 2019, vit9696. All rights reserved.<BR>
|
|
This program and the accompanying materials are licensed and made available
|
|
under the terms and conditions of the BSD License which accompanies this
|
|
distribution. The full text of the license may be found at
|
|
http://opensource.org/licenses/bsd-license.php.
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
**/
|
|
|
|
#ifndef APPLE_FEATURES_H
|
|
#define APPLE_FEATURES_H
|
|
|
|
//
|
|
// OEM Firmware Volume Information - Firmware Feature Bits.
|
|
// These bits are exposed via APPLE_SMBIOS_TABLE_TYPE128 FirmwareFeatures,
|
|
// and UEFI variables under gEfiAppleNvramGuid (4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14):
|
|
// UINT32 FirmwareFeatures / FirmwareFeaturesMask.
|
|
// UINT64 ExtendedFirmwareFeatures / ExtendedFirmwareFeaturesMask.
|
|
//
|
|
// nvram -x 4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14:FirmwareFeatures
|
|
// nvram -x 4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14:FirmwareFeaturesMask
|
|
// nvram -x 4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14:ExtendedFirmwareFeatures
|
|
// nvram -x 4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14:ExtendedFirmwareFeaturesMask
|
|
//
|
|
// Relevant binaries (besides firmware and boot.efi) can be found with FirmwareFeatures
|
|
// and IORegistry exposed firmware-features:
|
|
// /usr/libexec/diskmanagementd
|
|
// /usr/libexec/kextd
|
|
// /usr/sbin/bless
|
|
// /usr/sbin/kextcache
|
|
// /System/Library/CoreServices/backupd.bundle/Contents/Resources/brtool
|
|
// /System/Library/CoreServices/Software Update.app/Contents/MacOS/Software Update
|
|
// /System/Library/Extensions/AppleACPIPlatform.kext/Contents/MacOS/AppleACPIPlatform
|
|
// /System/Library/PrivateFrameworks/DiskManagement.framework/Versions/A/DiskManagement
|
|
// /System/Library/PrivateFrameworks/FindMyMac.framework/XPCServices/com.apple.HasTRB.xpc/Contents/MacOS/com.apple.HasTRB
|
|
// /System/Library/PrivateFrameworks/StorageKit.framework/Versions/A/Resources/storagekitd
|
|
// /System/Library/Extensions/AppleSMBIOS.kext/Contents/MacOS/AppleSMBIOS
|
|
// /System/Library/PreferencePanes/StartupDisk.prefPane/Contents/MacOS/StartupDisk
|
|
// /System/Library/PrivateFrameworks/Install.framework/Frameworks/DistributionKit.framework/Versions/A/DistributionKit
|
|
// /System/Library/PrivateFrameworks/Install.framework/Versions/A/Install
|
|
// /System/Library/PrivateFrameworks/OSInstaller.framework/Versions/A/OSInstaller
|
|
//
|
|
// NOTE: There is an unconfirmed belief that Thunderbolt also has a bit.
|
|
// NOTE: FirmwareFeatures enabling code is similar in all recent firmwares, T2 and not:
|
|
// VOID SetPlatformFeatures (VOID) {
|
|
// UINT64 Mask = 0xFF1FFF3FU; /* Model dependent */
|
|
// UINT64 Features = 0xFC07E136U; /* Model dependent */
|
|
// UINT32 SecurityPolicy;
|
|
// APPLE_PLATFORM_SECURITY_POLICY_PROTOCOL *Policy;
|
|
// if (!EFI_ERROR (gBS->LocateProtocol(&gApplePlatformSecurityPolicyProtocolGuid, NULL, (VOID **) &Policy))
|
|
// && (!EFI_ERROR (Policy->GetSecurityPolicy(Policy, &SecurityPolicy)))) {
|
|
// if (SecurityPolicy & 1) Features |= 0x400U;
|
|
// if (SecurityPolicy & 2) Features |= 0x800U;
|
|
// Features |= 0x1000000U;
|
|
// }
|
|
// Features = ((*(UINT64 *)(0xFFFFFF80) != 0x4E15E2F599858AC6ULL) << 12U) | Features & 0xFFFFFFFFFFFFEFFFULL;
|
|
// if (!EFI_ERROR (gRT->SetVariable(L"FirmwareFeaturesMask", &gEfiAppleNvramGuid, 6, sizeof (UINT32), &Mask)))
|
|
// gRT->SetVariable(L"FirmwareFeatures", &gEfiAppleNvramGuid, 6, sizeof (UINT32), &Features);
|
|
// if ((Features & 0x2000000U)
|
|
// && !EFI_ERROR (gRT->SetVariable(L"ExtendedFirmwareFeaturesMask", &gEfiAppleNvramGuid, 6, sizeof (UINT64), &Mask)))
|
|
// gRT->SetVariable(L"ExtendedFirmwareFeatures", &gEfiAppleNvramGuid, 6, sizeof (UINT64), &Features);
|
|
// }
|
|
//
|
|
|
|
//
|
|
// Supports CSM module, which allows booting legacy Windows operating systems like Windows 7.
|
|
// See: https://opensource.apple.com/source/bless/bless-166/libbless/EFI/BLSupportsLegacyMode.c.auto.html
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_CSM_LEGACY_MODE 0x00000001U // 0
|
|
//
|
|
// Supports CD/DVD Drive boot via El Torito.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_CD_DRIVE_BOOT 0x00000002U // 1
|
|
//
|
|
// Supports target disk mode, normally invoked by pressing T key at start.
|
|
// Note, AppleTamperResistantBootProtocol+6 may prohibit this.
|
|
// See: BootPicker.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_TARGET_DISK_MODE 0x00000004U // 2
|
|
#define FW_FEATURE_UNKNOWN_BIT3 0x00000008U // 3
|
|
//
|
|
// Supports NET boot. Read by StartupDisk.prefPane.
|
|
// FW_FEATURE_SUPPORTS_WIRELESS also implies NET boot support.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_NET_BOOT 0x00000010U // 4
|
|
//
|
|
// Supports SlingShot recovery embedded into the firmware.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_SLING_SHOT 0x00000020U // 5
|
|
#define FW_FEATURE_UNKNOWN_BIT6 0x00000040U // 6
|
|
#define FW_FEATURE_UNKNOWN_BIT7 0x00000080U // 7
|
|
//
|
|
// Has Wi-Fi module and supports wireless drivers in the firmware.
|
|
// Found in SlingShot.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_WIRELESS 0x00000100U // 8
|
|
#define FW_FEATURE_UNKNOWN_BIT9 0x00000200U // 9
|
|
//
|
|
// Bit 0 of the ApplePlatformSecurityPolicy.
|
|
// TODO: Explore, related to ApplePlatformInfoDatabaseProtocol.
|
|
// Set by AppleFirmwareFeaturesProtocol.
|
|
//
|
|
#define FW_FEATURE_PLATFORM_SECURITY_POLICY_01 0x00000400U // 10
|
|
//
|
|
// Bit 1 of the ApplePlatformSecurityPolicy.
|
|
// TODO: Explore, related to AppleTamperResistantBootProtocol.
|
|
// Set by AppleFirmwareFeaturesProtocol.
|
|
//
|
|
#define FW_FEATURE_PLATFORM_SECURITY_POLICY_02 0x00000800U // 11
|
|
//
|
|
// Supports Apple Tamper Resistant Boot, which helps FindMyMac functionality.
|
|
// Not set on Macs with T2 via detected non APPLE_EFI_FIRMWARE_GEN3_ID_MAGIC.
|
|
// See: /System/Library/PrivateFrameworks/FindMyMac.framework/XPCServices/com.apple.HasTRB.xpc/Contents/MacOS/com.apple.HasTRB.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_TRB 0x00001000U // 12
|
|
#define FW_FEATURE_UNKNOWN_BIT13 0x00002000U // 13
|
|
//
|
|
// Supports USB 2.0 in the firmware. Found in AppleACPIPlatform.kext.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_HIGH_SPEED_USB 0x00004000U // 14
|
|
#define FW_FEATURE_UNKNOWN_BIT15 0x00008000U // 15
|
|
#define FW_FEATURE_UNKNOWN_BIT16 0x00010000U // 16
|
|
//
|
|
// Instructs AppleACPIPlatform.kext not to substitute certain USB ports with other ports.
|
|
// In particular: EHC2-2 -> EHC1-3, EHC2-3 -> EHC1-4.
|
|
//
|
|
#define FW_FEATURE_DISABLE_USB_SUBSTITUTE_WORKAROUND 0x00020000U // 17
|
|
#define FW_FEATURE_UNKNOWN_BIT18 0x00040000U // 18
|
|
//
|
|
// Supports APFS filesystem (via JumpStart or built-in driver).
|
|
// Verified by OSInstaller.framework (apfsSupportedByROM). Either bit would do.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_APFS 0x00080000U // 19
|
|
//
|
|
// Supports APFS filesystem (unused by by any known Mac Model including Macmini7,1).
|
|
// Verified by OSInstaller.framework (apfsSupportedByROM). Either bit would do.
|
|
// Could be reserved for APFS Fusion Drive support, but unused even on them.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_APFS_EXTRA 0x00100000U // 20
|
|
#define FW_FEATURE_UNKNOWN_BIT21 0x00200000U // 21
|
|
#define FW_FEATURE_UNKNOWN_BIT22 0x00400000U // 22
|
|
#define FW_FEATURE_UNKNOWN_BIT23 0x00800000U // 23
|
|
//
|
|
// Supports platform security policy.
|
|
// Exposed in UEFI via gApplePlatformSecurityPolicyProtocolGuid GUID.
|
|
// Set by gAppleFirmwareFeaturesProtocolGuid.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_PLATFORM_SECURITY_POLICY 0x01000000U // 24
|
|
//
|
|
// Supports 64-bit ExtendedFirmwareFeatures/ExtendedFirmwareFeaturesMask variables.
|
|
// Lower 32-bits are same as FirmwareFeatures, and higher 32-bits contain new information.
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_EXTENDED_FEATURES 0x02000000U // 25
|
|
#define FW_FEATURE_UNKNOWN_BIT26 0x04000000U // 26
|
|
#define FW_FEATURE_UNKNOWN_BIT27 0x08000000U // 27
|
|
//
|
|
// Instructs boot.efi not to adjust memory map on MacBookAir4,1 and MacBookAir4,2
|
|
// during hibernate wake.
|
|
//
|
|
#define FW_FEATURE_DISABLE_MBA_S4_WORKAROUND 0x10000000U // 28
|
|
//
|
|
// Supports Windows UEFI boot (Windows 8 and newer).
|
|
// DMIsPreBootEnvironmentUEFIWindowsBootCapable
|
|
//
|
|
#define FW_FEATURE_SUPPORTS_UEFI_WINDOWS_BOOT 0x20000000U // 29
|
|
#define FW_FEATURE_UNKNOWN_BIT30 0x40000000U // 30
|
|
//
|
|
// Instructs boot.efi not to adjust memory map based on AcpiGlobalVariable->AcpiBootScriptTable.
|
|
// See: https://github.com/Piker-Alpha/macosxbootloader/blob/1abba11e3b792dd29c2a08c410c122efd1d19e98/src/boot/AcpiUtils.cpp#L152
|
|
//
|
|
#define FW_FEATURE_DISABLE_BOOTSCRIPT_WORKAROUND 0x80000000U // 31
|
|
|
|
//
|
|
// OEM Platform Feature Information - Platform feature bits
|
|
// These bits are exposed via APPLE_SMBIOS_TABLE_TYPE133 FirmwareFeatures:
|
|
// UINT64 PlatformFeature.
|
|
//
|
|
// Ref: https://github.com/al3xtjames/AppleSystemInfo/blob/master/src/util/dump_features.c
|
|
//
|
|
// Relevant binaries can be found with IORegistry exposed firmware-features
|
|
// and AppleSystemInfo ASI_IsPlatformFeatureEnabled function:
|
|
// /System/Library/Extensions/AppleACPIPlatform.kext/Contents/PlugIns/AppleACPIEC.kext/Contents/MacOS/AppleACPIEC
|
|
// /System/Library/Extensions/AppleSMBIOS.kext/Contents/MacOS/AppleSMBIOS
|
|
// /System/Library/PrivateFrameworks/AppleSystemInfo.framework/Versions/A/AppleSystemInfo
|
|
// /System/Library/PrivateFrameworks/NeutrinoCore.framework/Versions/A/NeutrinoCore
|
|
// /System/Library/PrivateFrameworks/PhotoLibraryPrivate.framework/Versions/A/Frameworks/PAImaging.framework/Versions/A/PAImaging
|
|
// /System/Library/CoreServices/PowerChime.app/Contents/MacOS/PowerChime
|
|
// /System/Library/SystemProfiler/SPMemoryReporter.spreporter/Contents/MacOS/SPMemoryReporter
|
|
//
|
|
|
|
#define PT_FEATURE_UNKNOWN_BIT0 0x00000001 // 0
|
|
//
|
|
// Has not replaceable system memory (RAM).
|
|
//
|
|
#define PT_FEATURE_HAS_SOLDERED_SYSTEM_MEMORY 0x00000002 // 1
|
|
//
|
|
// Has headless (connector-less) GPU present.
|
|
//
|
|
#define PT_FEATURE_HAS_HEADLESS_GPU 0x00000004 // 2
|
|
//
|
|
// Supports host power management.
|
|
//
|
|
#define PT_FEATURE_SUPPORTS_HOST_PM 0x00000008 // 3
|
|
//
|
|
// Supports Power Chime sound at boot.
|
|
//
|
|
#define PT_FEATURE_SUPPORTS_POWER_CHIME 0x00000010 // 4
|
|
#define PT_FEATURE_UNKNOWN_BIT5 0x00000020 // 5
|
|
#define PT_FEATURE_UNKNOWN_BIT6 0x00000040 // 6
|
|
#define PT_FEATURE_UNKNOWN_BIT7 0x00000080 // 7
|
|
#define PT_FEATURE_UNKNOWN_BIT8 0x00000100 // 8
|
|
#define PT_FEATURE_UNKNOWN_BIT9 0x00000200 // 9
|
|
#define PT_FEATURE_UNKNOWN_BIT10 0x00000400 // 10
|
|
#define PT_FEATURE_UNKNOWN_BIT11 0x00000800 // 11
|
|
#define PT_FEATURE_UNKNOWN_BIT12 0x00001000 // 12
|
|
#define PT_FEATURE_UNKNOWN_BIT13 0x00002000 // 13
|
|
#define PT_FEATURE_UNKNOWN_BIT14 0x00004000 // 14
|
|
#define PT_FEATURE_UNKNOWN_BIT15 0x00008000 // 15
|
|
#define PT_FEATURE_UNKNOWN_BIT16 0x00010000 // 16
|
|
#define PT_FEATURE_UNKNOWN_BIT17 0x00020000 // 17
|
|
#define PT_FEATURE_UNKNOWN_BIT18 0x00040000 // 18
|
|
#define PT_FEATURE_UNKNOWN_BIT19 0x00080000 // 19
|
|
#define PT_FEATURE_UNKNOWN_BIT20 0x00100000 // 20
|
|
#define PT_FEATURE_UNKNOWN_BIT21 0x00200000 // 21
|
|
#define PT_FEATURE_UNKNOWN_BIT22 0x00400000 // 22
|
|
#define PT_FEATURE_UNKNOWN_BIT23 0x00800000 // 23
|
|
#define PT_FEATURE_UNKNOWN_BIT24 0x01000000 // 24
|
|
#define PT_FEATURE_UNKNOWN_BIT25 0x02000000 // 25
|
|
#define PT_FEATURE_UNKNOWN_BIT26 0x04000000 // 26
|
|
#define PT_FEATURE_UNKNOWN_BIT27 0x08000000 // 27
|
|
#define PT_FEATURE_UNKNOWN_BIT28 0x10000000 // 28
|
|
#define PT_FEATURE_UNKNOWN_BIT29 0x20000000 // 29
|
|
#define PT_FEATURE_UNKNOWN_BIT30 0x40000000 // 30
|
|
#define PT_FEATURE_UNKNOWN_BIT31 0x80000000 // 31
|
|
|
|
#endif // APPLE_FEATURES_H
|