> For the complete documentation index, see [llms.txt](https://install.heavietnam.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://install.heavietnam.com/issue/userspace-issue.md).

# Userspace Issue

{% hint style="info" %}
Tác giả: Nam Phạm
{% endhint %}

{% hint style="info" %}
Hướng dẫn fix các lỗi liên quan đến bộ cài và GUI sau khi boot thành công Installer.  &#x20;

> Tức là sau gia đoạn boot kernel
> {% endhint %}

## Bộ cài mac bị chuyển thành tiếng Nga

**B1:** Chỉnh giá trị của `prev-lang:kbd` thành `656e2d55533a30`

> Nằm ở `NVRAM -> Add -> 7C436110-AB2A-4BBB-A880-FE41995C9F82` &#x20;
>
> > &#x20;Giá trị này chính là mã hex của ngôn ngữ US
> >
> > > Ngoài ra bạn cũng có thể điều chỉnh `prev-lang:kbd` sang `string` và điền vào giá trị là `en-US:0`

B2: Reset NVRAM trong boot picker.

{% hint style="warning" %}
Lưu ý:

Nếu vẫn không fix được thì xóa hẳn `prev-lang:kbd`&#x20;

Tạo mới một property `NVRAM -> Delete -> 7C436110-AB2A-4BBB-A880-FE41995C9F82 -> Item 0`

Để giá trị là `prev-lang:kbd` để Opencore tự build lại.

> Định dạng là `String`&#x20;
> {% endhint %}

![markdown](https://dortania.github.io/OpenCore-Install-Guide/assets/img/lang.cb258f4f.png)

## Hỏng bộ cài

{% hint style="info" %}
Nguyên nhân do bị lỗi chứng chỉ bộ cài macOS nếu bạn dùng file cài đã được tải từ trước tháng 10 năm 2019

> Có 2 cách xử lý:
> {% endhint %}

{% hint style="success" %}

* Tải lại phiên bản macOS đó 1 lần nữa
* Đổi ngày tháng năm trong Terminal về ngày chứng chỉ còn hiệu lực
  {% endhint %}

{% hint style="success" %}

* Ngắt kết nối toàn bộ các thiết bị kết nối Internet (mạng LAN, Wifi)
* Vào Terminal của bộ cài gõ dòng lệnh `date 0901000019`
  {% endhint %}

## Stuck `IOConsoleUsers: gIOScreenLock...`/`gIOLockState (3...`

{% hint style="info" %}
Lỗi này thường bị ngay trước khi GPU được kích hoạt, check lại những yêu cầu sau:
{% endhint %}

* GPU hỗ trợ UEFI&#x20;
  * GTX 7XX/ GPU đời 2013 đổ lên
* CSM được chỉnh thành Disabled/Off trong BIOS
* Dùng PCIe đạt chuẩn 3.0
* Đối với iGPU của Coffee Lake từ macOS 10.15.4 đổ lên.
  * Cần thêm boot args `igfxonln=1`&#x20;
* Patch lại GPU theo guide [tại đây](https://basic.heavietnam.com/gpu/patch-igpu)
  * Do boot args `-igfxmlr`&#x20;
    * Gây ra lỗi `Divide by Zero`
* Check lại xem giá trị của `ig-platform-id` và `device-id` có phù hợp không&#x20;
  * Chỉ cần khi bạn dùng iGPU
  * Đối với iGPU UHD 630 trên Desktop thử chuyển thành `00009B3E`

## Scrambled Screen trên laptop <a href="#scrambled-screen-on-laptops" id="scrambled-screen-on-laptops"></a>

{% hint style="info" %}
Tức là màn laptop bị nhiễu
{% endhint %}

{% hint style="success" %}
Bật CSM trong BIOS. Đối với 1 số máy, Option CSM trong BIOS sẽ là "Boot legacy ROMs", v.v
{% endhint %}

## Black screen sau `IOConsoleUsers: gIOScreenLock...`&#x20;

{% hint style="info" %}
Trên Laptop và các máy AIO

> AIO tức là all in one
> {% endhint %}

{% hint style="info" %}
Check lại những mục sau:
{% endhint %}

* Có `SSDT-PLNF` chưa

  * Đã được add vào config và enable chưa

  > &#x20;Kiểm tra ở:
  >
  > * &#x20;`EFI/OC/ACPI`
  > * `Config.plist -> ACPI -> Add`
* Các properties của iGPU đã được config chuẩn chưa&#x20;
  * `DeviceProperties -> Add -> PciRoot(0x0)/Pci(0x2,0x0)`
* Đối với Laptop sử dụng chip Coffee Lake đổ lên
  * thêm boot args  `-igfxblr`&#x20;
  * Hoặc bạn có thể dùng properties sau thay cho `boot-arg`:
    * `enable-backlight-registers-fix | Data | 01000000`
      * Vào `PciRoot(0x0)/Pci(0x2,0x0)`

{% hint style="warning" %}
Ngoài ra, check lại phần [`IOConsoleUsers: gIOScreenLock...`/`gIOLockState (3...` ](#stuckioconsoleusers-gioscreenlock...-giolockstate-3)
{% endhint %}

## Black screen sau `IOConsoleUsers: gIOScreenLock...`

{% hint style="info" %}
&#x20;Trên dòng card rời Navi của AMD
{% endhint %}

* Thêm boot args `agdpmod=pikera`
* Thử cắm cổng khác để xuất hình&#x20;
  * Chuyển từ HDMI sang DVI, DisplayPort,..
* Thử SMBIOS MacPro7,1&#x20;
* Kèm boot arg `agdpmod=ignore`

{% hint style="info" %}
Đối với card do MSI sản xuất, dùng patch này: [Installer not working with 5700XT #901](https://github.com/acidanthera/bugtracker/issues/901)
{% endhint %}

<details>

<summary>Đặc biệt</summary>

Chỉ làm nếu thử hết các cách vẫn lỗi

Thêm các entry dưới đây trong phần `Kernel -> Patch` của config:

```
Base:
Comment: Navi VBIOS Bug Patch
Count: 1
Enabled: YES
Find: 4154592C526F6D2300
Identifier: com.apple.kext.AMDRadeonX6000Framebuffer
Limit: 0
Mask:
MinKernel:
MaxKernel:
Replace: 414D442C526F6D2300
ReplaceMask:
Skip: 0
```

</details>

## Đơ màn hình ở Installer sau 30 giây

{% hint style="info" %}
Nguyên nhân:

* Do `NullCPUPowerManagement` gây lỗi
* Hoặc thiếu các patch power manager
  {% endhint %}

{% hint style="info" %}
Thử các cách sau:

* Xóa `NullCPUPowerManagement` trong `Kernel -> Add` và `EFI\OC\Kexts`
* Enable `DummyPowerManagement` trong `Kernel -> Emulate`
  * Option này dùng trên các dòng đặc biệt không hỗ trợ xcpm

> Hoặc đối với các dòng khác thì kiểm tra lại các patch `xcpm` của bạn
> {% endhint %}

## Bị khởi động lại sau màn hình `Data & Privacy`trên 15h/16h CPU AMD

{% hint style="info" %}
Fix theo hướng dẫn dưới đây&#x20;

> Mục Update 2: [Fix Data and Privacy reboot](https://www.insanelymac.com/forum/topic/335877-amd-mojave-kernel-development-and-testing/?do=findComment\&comment=2658085)
> {% endhint %}

## MacOS bị đơ ngay trước khi đăng nhập vào máy

{% hint style="info" %}
Nguyên nhân do TSC bị lỗi

> Cách fix là thêm kext [`CpuTscSync`](https://github.com/acidanthera/CpuTscSync/releases)
> {% endhint %}

Đối với Skylake-X, cần reset TSC ở `cold boot`

> Tắt hẳn máy đi và boot trở lại&#x20;
>
> > Tức là bạn sẽ shutdown thay vì rest

và wake máy với kext [`TSCAdjustReset` ](https://github.com/dortania/OpenCore-Install-Guide/blob/master/extra-files/TSCAdjustReset.kext.zip)và sủa `Info.plist` của kext như sau:&#x20;

```
IOKitPersonalities -> IOPropertyMatch -> IOCPUNumber -->  User's threads

// Chỉnh giá trị theo số luồng CPU máy bạn có

// Ví dụ:

    I9-7980xe có 18 nhân 36 luồng thì để giá trị là 36
```

{% hint style="info" %}
Một số ví dụ về TSC bị lỗi

> Mang tính chất tham khảo
> {% endhint %}

| Trường hợp 1                                                                                                                                                                                                        | Trường hợp 2                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![](https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FJ3Sy76mSTGh0bBcUennC%2Fimage.png?alt=media\&token=67a66e3b-9e69-4c3c-bae5-8e08465796cf) | ![](https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FaOLFCpisVyegDKSoyZ8e%2Fimage.png?alt=media\&token=b8d7ded5-55dd-4491-8a9f-2f35c7fe5188) |

## Không đủ dung lượng cho MediaKit

{% hint style="info" %}
Lỗi do phân vùng EFI nhỏ

> Windows sẽ tạo EFI 100mb
>
> MacOS 200mb theo mặc định.

Có 2 cách fix như sau:
{% endhint %}

{% hint style="success" %}
Tăng kích thước phân vùng EFI lên 200mb&#x20;

> Dùng các tool như Minitool Partition
>
> > Hướng dẫn chi tiết [tại đây](https://basic.heavietnam.com/multiboot/resize-va-create-partition-efi)
> > {% endhint %}

{% hint style="success" %}
Format lại cả drive thay vì 1 phân vùng

* Disk Utilities chỉ hiện phân vùng
  * Bấm `Cmd/Win +2` để xem toàn bộ ổ&#x20;
  * Có thể bấm nút View trên GUI
    {% endhint %}

| Mặc định                                                                                                                                                                                                                                                  | Show All Devices (Cmd+2)                                                                                                                                                                                                                                  |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FGmCecHwAySlBQqALcs3w%2Fimage.png?alt=media&amp;token=7004d19e-3ab6-40c9-b1f7-e5ef2b4b9a92" alt="" data-size="original"> | <img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FPBrtiS1oi9IkPNegFPop%2Fimage.png?alt=media&amp;token=b2c4a090-fc74-4945-a6e1-16cb3b6d4c8f" alt="" data-size="original"> |

## DiskUtility không erase được ổ

{% hint style="info" %}
Do 1 trong 5 lỗi dưới đây (có thể có nhiều lỗi xảy ra đồng thời):
{% endhint %}

* Do bạn format phân vùng chứ không phải toàn bộ drive, xem lại lỗi MediaKit ở trên
* DiskUtitlity có thể bị lỗi ở lần erase đầu tiên, erase lại lần hai sẽ chạy được
* Option SATA Hot Plug trong BIOS gây lỗi, thử tắt Option này
* `Firmware` cũ -> `Update firmware`
* Ổ cứng của bạn bị hỏng&#x20;
  * Bad sector và các lỗi tương tự
  * Chỉ còn cách thay ổ

## Ổ SATA không hiện trong DiskUltility

* Set `SATA mode` thành `AHCI` trong BIOS
* Một số controller không được hỗ trợ bởi macOS, dùng kext `CtlnaAHCIPort`
  * Đối với các controller cũ&#x20;
    * Hệ legacy
      * Dùng kext `AHCIPortInjector` sẽ phù hợp hơn.

## Stuck on `2 minutes remaining`

![markdown](https://dortania.github.io/OpenCore-Install-Guide/assets/img/2-min-remaining.aca72475.jpeg)

{% hint style="info" %}
Lỗi do bộ cài macOS sẽ chỉnh sửa/thêm một số boot arg vào NVRAM của bạn để boot tiếp sau khi cài xong nhưng có lỗi và bị kẹt tại bước này.

> Dưới đây là một số trường hợp và cách fix tương ứng
> {% endhint %}

* Đối với main 300 series của Intel&#x20;
  * VD: Z390
  * Dùng `SSDT-PMC`
    * Nhớ `snapshot` config lại nhé
* Những máy còn lại chỉnh các `quirk` sau trong `config.plist`
  * Phần `NVRAM`:
    * `LegacyEnable -> Yes`
    * `LegacyOverwrite -> Yes`
    * `WriteFlash -> Yes`

## Lỗi `The recovery server cannot get contacted`

{% hint style="info" %}
Nếu bạn làm USB boot macOS trên Windows hoặc Linux thì USB sẽ chỉ chứa phần Recovery, còn hệ điều hành sẽ phải tải trong quá trình cài.

> Dưới đây là một số cách fix
> {% endhint %}

* Đảm bảo bạn có kết nối Internet
  * Mở `Network Utility` trong phần `Utilities` và check xem máy có nhận card mạng không
    * Nếu máy bạn **không nhận** card mạng, add kext mạng tương ứng với dòng card mạng của bạn, xem lại phần [Wifi và Bluetooth](https://basic.heavietnam.com/network/fix-wifi-va-bluetooth)
    * Nếu máy bạn **đã nhận** card mạng, chạy lệnh `ping -c3 www.google.com` trong terminal để test kết nối mạng
      * Nếu terminal có trả về kết quả thì do server của Apple, cài lại vào lúc khác
      * Nếu không có gì hiện thì do kext bạn đã lỗi, tiến hành tải lại và add vào EFI, config như trước
        * Dùng bản kext cũ hơn nếu bạn gặp lỗi ở những bản kext mới

| Check network card đã nhận hay chưa                                                                                                                                                                                                                                                                                | Check Ping                                                                                  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
| ![](C:%5CUsers%5Cquocn%5CAppData%5CRoaming%5Cmarktext%5Cimages%5C2024-06-12-18-42-41-image.png)![](https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FhdOgeiHsfyvHy1XatWSZ%2Fimage.png?alt=media\&token=e29a799e-03d1-48b2-8d93-d04c6fd1184c) | ![markdown](https://dortania.github.io/OpenCore-Install-Guide/assets/img/ping.14fc994b.png) |

## Không dùng được bàn phím, chuột trong macOS Big Sur+

{% hint style="info" %}
Đối với những máy cũ&#x20;

> Core 2 Duo/máy từ 2010 trở về trước

&#x20;lỗi do những HID (Human Interface Devices) và cổng USB gặp vấn đề.

> Thử kiểm tra lại những vấn đề ở trên:
>
> * Check voodoops2keyboard
> * Check USB map
> * Và thử cách `IOHIDFamily Patch`
>   {% endhint %}

<details>

<summary>IOHIDFamily Patch</summary>

![](https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2Fgbslu0dALm9natrQvNES%2Fimage.png?alt=media\&token=8ddb9df6-654a-4f36-b35d-284ff3dfb602)![](https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2Fgbslu0dALm9natrQvNES%2Fimage.png?alt=media\&token=8ddb9df6-654a-4f36-b35d-284ff3dfb602)

[Source](https://applelife.ru/threads/ustanovka-macos-big-sur-11-0-beta-na-intel-pc-old.2944999/page-81#post-884400)

</details>

## Stuck on `Your Mac needs a firmware update in order to install to this volume`

{% hint style="info" %}
Nếu ban muốn cài macOS trên một ổ có định dạng APFS và gặp lỗi này, nguyên nhân có thể do SMBIOS quá cũ. Check các điều sau:
{% endhint %}

* Đã bật `PlatformInfo -> Automatic`&#x20;
* `UpdateSMBIOSMode` được để là `Create`
  * Cần tắt `CustomSMBIOSGuid`
  * Đối với máy Dell và VAIO
    * Cần bật `CutomSMBIOSGuid`&#x20;
    * Set `UpdateSMBIOSMode` thành `Custom`
* Dùng phiên bản SMBIOS phù hợp với bản macOS bạn đã cài trong trường hợp ban&#x20;
  * Không dùng boot args `-no_compat_check`
* Dùng phiên bản mới nhất của Opencore

{% hint style="warning" %}
Nếu vẫn gặp tình trạng này, lỗi có thể do SMBIOS của Opencore bị lỗi thời và cần Generate lại bản SMBIOS đó hoặc dùng một SMBIOS tương tụ và dc bản macOS bạn cài hỗ trợ.&#x20;

> Ngoài ra, xem lại phần cách chọn SMBIOS: [Choosing the right SMBIOS](https://dortania.github.io/OpenCore-Install-Guide/extras/smbios-support.html)
> {% endhint %}

{% hint style="info" %}
Source tham khảo: <https://dortania.github.io/OpenCore-Install-Guide/troubleshooting/extended/userspace-issues.html>
{% endhint %}
