README: Add Documentation

README.md

@@ -0,0 +1,203 @@
+# Hackintosh-DELL-Vostro-5468
+
+
+![Monterey](Screenshot/1.png)
+
+
+<p align = "center">
+macOS Monterey
+</p>
+
+* macOS:
+  - Monterey 12.0.1 ✅
+* Windows:
+  - Windows 11 ✅
+* Bootloader: OpenCore 0.7.7.
+* EFI can be used for both for installation and booting from SSD.
+
+## Introduction
+
+<details>  
+<summary><strong>System Overview</strong></summary>
+</br>
+
+**Dell Vostro 5468**
+
+| Type | Item |
+| ---- | ---- |
+| CPU | Intel Core i3-7100U @ 2.40 GHz, 3M Cache |
+| RAM | Samsung 4GB DDR4-2666MHz |
+| SSD1 | Digital Alliance 128GB M.2 SATA III |
+| HDD2 | Western Digital WD5000LPCX 500GB SATA Hard Drive |
+| Sound | Realtek ALC256 |
+| Wireless, Bluetooth | Intel 3165 |
+| Integrated GPU | Intel HD Graphics 620 |
+
+</details>
+
+<details>  
+<summary><strong>Current Status</strong></summary>
+</br>
+
+| Feature | Status |
+| ------------- | ------------- |
+| CPU Power Management | ✅ Working |
+| Sleep/Wake | ✅ Working |
+| Intel HD620 Graphics Acceleration | ✅ Working |
+| Intel Quartz Extreme and Intel Core Image (QE/CI) | ✅ Working |
+| Brightness control slider | ✅ Working |
+| Special function keys (audio, brightness...) | ✅ Working |
+| Ethernet | ✅ Working |
+| Audio | ✅ Working |
+| Touchpad | ✅ Working |
+| Battery | ✅ Working |
+| iMessage/Facetime and App Store | ✅ Working  |
+| Speakers and Headphones | ✅ Working |
+| Built-in Microphone | ✅ Working |
+| Webcam | ✅ Working |
+| Wi-Fi/Bluetooth | ✅ Working |
+| Hibernation | ✅ Working |
+| Airdrop/Handoff | [-] Not Tested |
+| BootCamp | [-] Not Tested |
+| SD Card | ❌ Not working |
+| Fingerprint reader | ❌ Not working |
+
+</details>
+
+## Installation
+
+<details>  
+<summary><strong>BIOS Configuration</strong></summary>
+</br>
+
+**Recommend you should restore the BIOS setting to BIOS Setting first. Then configure the following things:**
+
+  | Sub-menu | Key: Value | Comment |
+  | --- | --- | --- |
+  | UEFI Boot Path Security | `Disabled` | |
+  | Enable Legacy Option ROMs | `Disabled` | Disable will help OpenCanopy load faster |
+  | SATA Operation | `AHCI` | |
+  | Enabled USB Boot Support | `Enabled` | |
+  | Enable External USB Port | `Enabled` | |
+  | Secure Boot | `Disabled` | Can set to `Enabled` if you have already custom secure boot keys and signed OpenCore binaries |
+  | Wake on USB | `Enabled` | Wake from keyboard works correctly | |
+
+</details>
+
+<details>
+<summary><strong>Mainly Configuration</strong></summary>
+
+### Graphic Display
+* Integrated Intel HD Graphics 620 support is handled by WhateverGreen, and configured in the `DeviceProperties` section of `config.plist`.
+
+### Audio
+* For ALC256 on this my Machine, I use `layout-id = 17`.
+* Without any modifications, the headphone jack is buggy. External microphones aren't detected and the audio output may randomly stop working or start making weird noises.
+* Start from this version, I change to use `ComboJack`. It gives better sound experience and performance when using the headset/headphone. ( See on Branch ComboJack. )
+
+</details>
+
+<details>
+<summary><strong>Other Configuration</strong></summary>
+
+### USB
+* Native without USBInjectAll or USBMap, i use SSDT-UIAC-ALL .
+
+### Wireless, Bluetooth
+* The stock Intel AC 3165 can be worked well with [OpenIntelWireless](https://github.com/OpenIntelWireless).
+
+### Sleep, Wake and Hibernation
+* Hibernation now is worked correctly with `hibernatemode = 3` and `SSDT-GPRW`.
+
+### CPU Power Management
+* CPU power management is done by `CPUFriend.kext` while `CPUFriendDataProvider.kext` defines how it should be done. `CPUFriendDataProvider.kext` is generated for a specific CPU and power setting. You should follow [this guide](https://dortania.github.io/OpenCore-Post-Install/universal/pm.html) to generate your own `CPUFriendDataProvider.kext`.
+
+</details>
+
+<details>
+<summary><strong>iServices</strong></summary>
+
+* To use iMessage and other Apple services, you need to generate your own serial numbers. This can be done using [CorpNewt's GenSMBIOS](https://github.com/corpnewt/GenSMBIOS). Make sure model is `MacBookPro15,1`. Then, go [Apple Check Coverage page](https://checkcoverage.apple.com/) to check your generated serial numbers. If the website tells you that the serial number **is not valid**, that is fine. Otherwise, you have to generate a new set.
+
+* Next you will have to copy the following values to your `config.plist`:
+  - Serial Number -> `PlatformInfo/Generic/SystemSerialNumber`.
+  - Board Number -> `PlatformInfo/Generic/MLB`.
+  - SmUUID -> `/PlatformInfo/Generic/SystemUUID`.
+  Reboot and Apple services should work.
+
+* If they don't, follow [this in-depth guide](https://dortania.github.io/OpenCore-Post-Install/universal/iservices.html). It goes deeper into ROM, clearing NVRAM, clearing Keychain (missing this step might cause major issues), and much more.
+</details>
+
+<details>  
+<summary><strong>Kext Docs</strong></summary>
+</br>
+
+* AirportItlwm.kext: Intel AC 3165 Wirelless
+* AppleALC.kext: Enable Audio with layout-id=17
+* BlueToolFixup.kext: Enable Bluetooth
+* BrightnessKeys.kext: Mapping Brightness F11+F12 with Fn Keys
+* CPUFriend.kext and CPUFriendDataProvider.kext: CPU power management data injection
+* Lilu.kext: Kernel extension bringing a platform for arbitrary kext, library, and program patching throughout the system for macOS
+* RealtekRTL8111.kext: Driver Ethernet for the Realtek RTL8111/8168 family 
+* VerbStub.kext: For Fix JackAudio with ComboJack
+* VirtualSMC.kext: Advanced Apple SMC emulator in the kernel
+* VoodooI2C.kext and VoodooI2CHID.kext: Enable I2C Trackpad
+* VoodooPS2Controller.kext: Enable Keyboard
+* WhateverGreen.kext: Lilu plugin providing patches to select GPUs on macOS
+
+</details>
+
+<details>
+<summary><strong>SSDT Patch Docs</strong></summary>
+</br>
+
+* ALS0: Enable light sensor
+* EC-USBX: Fake embedded controller and fix USB power properties
+* GPRW: Fix instant wake
+* HPET: Fixing IRQ Conflicts
+* PLUG: to allow the kernel's XCPM CPU Power Management to manage our CPU's power management
+* PNLF: Fix brightness control
+* SMBUS-MCHC: Fixing SMBus support
+* UIAC-ALL: Fix USB Mapping Native without Kext/Injector
+* USB-Reset: Reset All Detected Ports and hit discover ports
+* XOSI: fixing I2C trackpads is enabling them within ACPI
+* [Now All SSDT* make to SSDT-HACK for make Simple]()
+* You Can See Configuration SSDT from [Dortania](https://dortania.github.io/OpenCore-Post-Install/#how-to-follow-this-guide)
+
+</details>
+
+<details>
+<summary><strong>Screenshot</strong></summary>
+</br>
+
+![1](Screenshot/1.png)
+![2](Screenshot/2.png)
+![3](Screenshot/3.png)
+![4](Screenshot/4.png)
+![5](Screenshot/5.png)
+![6](Screenshot/6.png)
+![7](Screenshot/7.png)
+![8](Screenshot/8.png)
+![9](Screenshot/9.png)
+![10](Screenshot/10.png)
+![11](Screenshot/11.png)
+![12](Screenshot/12.png)
+![13](Screenshot/13.png)
+![14](Screenshot/14.png)
+![15](Screenshot/15.png)
+![16](Screenshot/16.png)
+![17](Screenshot/17.png)
+![18](Screenshot/18.png)
+![19](Screenshot/19.png)
+![20](Screenshot/20.png)
+![21](Screenshot/21.png)
+![22](Screenshot/22.png)
+
+</details>
+
+## Credit
+- [Apple](https://apple.com) for macOS;
+- [Acidanthera](https://github.com/acidanthera) for OpenCore and all the lovely hackintosh work.
+- [Dortania](https://github.com/dortania) For their detailed guides.
+- [Olarila](Olarila.com) For Installer
+- Etc ...