> 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/build-efi/build-efi-with-heavn-oc-builder.md).

# Build EFI with HeaVN OC Builder

{% hint style="info" %}
Nếu các bạn cảm thấy việc build EFI bằng tay quá rườm ra thì có thể đọc guide này. 

> Tool được build và bản quyền thuộc về HeaVN

Nhìn chung tool này build EFI khá chuẩn. 

> Chuẩn hơn nhiều so với newbie buid, cũng như một số bác chưa có kinh nghiệm nhiều
> {% endhint %}

{% hint style="danger" %}
Chú ý

Ở thời điểm viết bài HeaVN OC Builder đang ở thời điểm beta.

> Do đó nếu có bất cứ lỗi gì xin vui lòng nhắn tin trực tiếp với mình nhé:
>
> * [Facebook](https://www.facebook.com/profile.php?id=100070274020733)
> * SĐT: 0838953358
> * Mail: <hoanglongvonguyen@gmail.com>
>   {% endhint %}

## Chuẩn bị

B1: Tải tool [sau](https://github.com/dragon-hea/Heavietnam-Opencore-Builder-)&#x20;

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FlJEFkJVeVU9HpjUMFnaC%2Fimage.png?alt=media&amp;token=7e521bcd-4e16-4f57-8350-e54ea821b4d2" alt=""><figcaption></figcaption></figure>

B2: Cài đặt [python](https://www.python.org/)

B3: Cài đặt `pip3`

<details>

<summary>Cách cài đặt pip3</summary>

#### Hướng dẫn chi tiết cài đặt pip3 trên Windows

**Bước 1: Cài đặt Python 3**

1. **Tải Python:**
   * Truy cập [trang web Python](https://www.python.org/downloads/).
   * Tải xuống phiên bản Python 3.x mới nhất.
2. **Cài đặt Python:**
   * Chạy tệp cài đặt Python đã tải về.
   * Chọn tùy chọn "Add Python to PATH" (thêm Python vào biến môi trường PATH).
   * Nhấn "Install Now" để bắt đầu cài đặt.

**Bước 2: Kiểm tra cài đặt Python và pip**

1. **Mở Command Prompt:**
   * Nhấn `Windows + R`, gõ `cmd`, và nhấn Enter.
2. **Kiểm tra Python:**

   ```bash
   python --version
   ```

   * Lệnh này sẽ hiển thị phiên bản Python đã cài đặt.
3. **Kiểm tra pip:**

   ```bash
   pip --version
   ```

   * Lệnh này sẽ hiển thị phiên bản pip đã cài đặt. Nếu pip đã được cài đặt cùng với Python, bạn sẽ thấy thông tin phiên bản của pip.

**Bước 3: Cài đặt pip (nếu chưa có)**

1. **Tải tệp get-pip.py:**
   * Truy cập [liên kết get-pip.py](https://bootstrap.pypa.io/get-pip.py).
   * Lưu tệp này vào một thư mục trên máy tính của bạn.
2. **Chạy tệp get-pip.py:**

   * Mở Command Prompt và điều hướng đến thư mục chứa tệp `get-pip.py`.

   ```bash
   cd path\to\your\folder
   ```

   * Chạy tệp `get-pip.py`:

   ```bash
   python get-pip.py
   ```

**Bước 4: Kiểm tra cài đặt pip3**

1. **Kiểm tra phiên bản pip3:**

   ```bash
   pip3 --version
   ```

   * Lệnh này sẽ xác nhận rằng pip3 đã được cài đặt thành công trên hệ thống của bạn.

#### Sử dụng pip3 để cài đặt các gói Python

1. **Cài đặt một gói Python:**

   ```bash
   pip3 install package_name
   ```
2. **Nâng cấp một gói Python:**

   ```bash
   pip3 install --upgrade package_name
   ```
3. **Gỡ cài đặt một gói Python:**

   ```bash
   pip3 uninstall package_name
   ```

Với hướng dẫn này, bạn đã có thể cài đặt pip3 trên Windows và bắt đầu quản lý các gói Python một cách dễ dàng.

</details>

B4: Tìm hiểu chi tiết về phần cứng của bạn

> Xem chi tiết [tại đây](/general/cach-xac-dinh-phan-cung.md)
>
> > Tìm hiểu rõ hơn về phần cứng xem [tại đây](/general/tim-hieu-chung-ve-phan-cung.md)

B4: Chạy file `install.bat`

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2Fcy8zrlU3oR7avssZa8sx%2Fimage.png?alt=media&amp;token=54187271-6652-404e-9a2b-50f3e0859098" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2F9WvgS6bU8fdYHHoCMw6N%2Fimage.png?alt=media&amp;token=e87af8eb-37af-4311-ac8c-553b69bfa132" alt=""><figcaption><p>Như này là cài đặt thành công nhé</p></figcaption></figure>

## Tiến hành

{% hint style="warning" %}
Đọc thật kỹ nhé

> Tool sẽ tối ưu theo từng thiết bị do đó tuỳ vào phần cứng của bạn mà tool sẽ hiển thị khác nhau
>
> > Do đó không cần lo lắng nếu tool của bạn không giống như trong hệ thống nhé
> > {% endhint %}

B1: Chạy file `main.bat`

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FnrRtmoTIxegySLwZKKEh%2Fimage.png?alt=media&amp;token=5dd44e61-bb9a-471d-9ea3-c15cac07af94" alt=""><figcaption><p>Đây là giao diện chính nhé</p></figcaption></figure>

B2: Chọn thế hệ cpu của bạn&#x20;

> Trong ví dụ tôi sẽ chọn `Coffee Lake`

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2F3DzBaxtT2fAfAFRq85iI%2Fimage.png?alt=media&amp;token=c2f5d613-ca9a-4412-8363-e67e2d211851" alt=""><figcaption></figcaption></figure>

B3: Chọn loại thiết bị của bạn

> Tức là bạn đang dùng:
>
> * `Nuc`
> * `Laptop`
> * `Desktop`

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2Fe2SGQ2p1g4jS5pbGstk1%2Fimage.png?alt=media&amp;token=928bed5b-bbbc-4a2b-b564-7a0d7a67a307" alt=""><figcaption></figcaption></figure>

> Ở ví dụ này mình sẽ dùng `Desktop`

B4: Tiếp theo chọn xem bạn có `DGPU` không

> Nếu có thì ấn `y`&#x20;
>
> Nếu không thì ấn `n`

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FJqLQy49RB5qD5pMS8c4W%2Fimage.png?alt=media&amp;token=e1d1e32d-b5c4-4f5c-ae6f-8f7188c3ac69" alt=""><figcaption></figcaption></figure>

B5: Chọn loại DGPU của các bạn&#x20;

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FacYO5EonJgGLMh3uvUdR%2Fimage.png?alt=media&amp;token=79de5de8-c528-4fb3-a2bb-725704f56eaf" alt=""><figcaption></figcaption></figure>

> Ở ví dụ này mình sẽ chọn `AMD`

B6: Chọn loại `AMD GPU` của bạn

> Chỉ hiện ra khi ở B5 bạn chọn `AMD`

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2Fk9lYYltWN7n79XBAU9GF%2Fimage.png?alt=media&amp;token=bb3d17a2-7372-4824-a34b-8f26a3ac7409" alt=""><figcaption></figcaption></figure>

B7: Chọn loại ổ cứng của bạn

{% hint style="warning" %}
Chú ý:

Nếu như trong danh sách có danh sách ổ cứng của bạn thì xin chia buồn ổ cứng này không được `Support`

> Nếu không có hãy chọn `other`
> {% endhint %}

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FNST7rGxJD7N63jEEya8p%2Fimage.png?alt=media&amp;token=d19c1062-b687-4a09-b697-455dd8276ebe" alt=""><figcaption></figcaption></figure>

B8: Chọn giao thức ổ cứng của bạn

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FtGtIcnh0Y3L1UWbRMrf8%2Fimage.png?alt=media&amp;token=51616c18-7e3a-427f-96fe-967a58d87a3b" alt=""><figcaption></figcaption></figure>

> Ở ví dụ này mình sẽ chọn AMD

B9: Chọn `card wifi` của bạn

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FAzn70fRO6cmuxPtDg80g%2Fimage.png?alt=media&amp;token=715289f6-c139-4941-a456-fdb576e9b72a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FxiCpn8WSvwEErcSzYB8s%2Fimage.png?alt=media&amp;token=195bfa4e-02aa-46fb-a2e4-314ee061b3c3" alt=""><figcaption></figcaption></figure>

B10: Chọn `card lan` của bạn

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FY9OXYC5FWtaOIu5S5zwJ%2Fimage.png?alt=media&amp;token=bd736f84-4bde-45e8-9bbc-11d58bbbc262" alt=""><figcaption></figcaption></figure>

B11: Chọn version MacOS bạn muốn cài

{% hint style="warning" %}
Chú ý:

Các version MacOS hiển thị trên tool là các phiên bản MacOS hỗ trợ phần cứng của bạn

> Không tính trường hợp sử dụng `OpenCore legacy patcher`
> {% endhint %}

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FuuZmoTWbdcsw2w5JENrZ%2Fimage.png?alt=media&amp;token=933115a2-5546-494d-8c3a-6b62564ee338" alt=""><figcaption></figcaption></figure>

B12: Chọn loại `OpenCore Pkg` mà bạn muốn cài đặt

{% hint style="warning" %}
Chú ý:

* OpenCore standard: là bản OpenCore chính thức&#x20;
* Opencore NO ACPI: là bản OpenCore mod giúp tránh inject ACPI&#x20;
  * Giúp dễ dàng Dualboot&#x20;
    {% endhint %}

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FtMSl9mZJe3cY16QCduEu%2Fimage.png?alt=media&amp;token=63a02613-9b1d-4ea0-bbbb-511bfaea03ee" alt=""><figcaption></figcaption></figure>

> Như vầy là đang build rồi nha

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FjcSICsZK0H7SBuJUsMoi%2Fimage.png?alt=media&amp;token=4fdd67d8-8fde-4ee2-9391-af9111ff7bd5" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Do tool download bản mới nhất của kext và OC nên tốc độ build phụ thuộc vào tốc độ internet nhà bạn
{% endhint %}

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FqwcMufyKUjARHSDC5G98%2Fimage.png?alt=media&amp;token=68149f0f-5d93-4d73-9aaa-9716f8296f76" alt=""><figcaption><p>Như này là build xong rồi nhé</p></figcaption></figure>

{% hint style="info" %}
Lướt lên trên để đọc những gì tool đã làm nha

> Sau khi build xong file EFI sẽ nằm trong&#x20;
>
> > `\heavietnam_OC_builder\scripts\extra\X64`
> > {% endhint %}

<figure><img src="https://1509717028-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkg5oI9lF3urxLNHi996%2Fuploads%2FeUm37M7joZBn55FQeYLP%2Fimage.png?alt=media&amp;token=c2d97a9d-72a4-4a30-8f67-266818841ce6" alt=""><figcaption></figcaption></figure>

## Một số Lưu ý

{% hint style="warning" %}
Cần chú ý do trong config mình đã thêm sẵn path của kext `USBTBMAP.kext` nên bạn bắt buộc phải map usb trước khi sử dụng

> * Map USB chi tiết [tại đây](https://basic.heavietnam.com/usb-fix/map-usb)
> * Hoặc bạn cũng có thể snapshot chi tiết [tại đây](/general/tim-hieu-chi-tiet-ve-config.plist.md#cach-oc_snapshot)
>   * Chỉ cần khi bạn không map usb
>     {% endhint %}

{% hint style="warning" %}
Lưu ý cho RX 6600XT và RX 6600:

Đối với các bạn sử dụng card này thì khi boot nếu gặp tình trạng màn đen hoặc gặp tình trạng bị reset&#x20;

> Ở đây đang nói bị reset ở giai đoạn sau khi load `GPU`
>
> > Để hiểu rõ bạn đang boot ở giai đoạn nào xem chi tiết [tại đây](/issue/tim-hieu-qua-trinh-cai-dat.md)

* Xoá những boot-arg `-v debug=0x100 keepsyms=1`
* Setting những dòng sau trong `Misc -> Debug`
  * `AppleDebug = False`
  * `ApplePanic = False`
  * `DisableWatchDog = True`
  * `Target = 0`

> Dùng [propertree](https://github.com/corpnewt/ProperTree) chạy dưới quyền `admin` để chỉnh những dòng config sau nhé&#x20;
> {% endhint %}

{% hint style="warning" %}
Nếu bạn gặp lỗi `[EB|#LOG:EXITBS:START]`

Chỉnh `SetupVirtualMap` thành `True` hoặc thành `False`

> Tuỳ theo trạng thái của dòng đó trong config
>
> * `True --> False`
> * `False --> True`
>   {% endhint %}

{% hint style="warning" %}
Cuối cùng nhớ chỉnh bios của bạn

> Full hướng dẫn bios [tại đây](/build-efi/create-efi.md#chinh-cai-dat-firmware)
>
> > Đặc biệt chú ý dòng `Resizable BAR Support`&#x20;
> >
> > > Tuỳ thuộc vào giá trị dòng này trong bios mà chỉnh lại dòng này trong config thay từ `0 --> -1` và ngược lại
> > > {% endhint %}

{% hint style="info" %}
Nếu trong quá trình cài đặt có bất cứ lỗi nào bạn có thể tham khảo cách fix lỗi ở đây

* [Tìm hiểu về quá trình cài đặt](https://install.heavietnam.com/issue/tim-hieu-qua-trinh-cai-dat)
  * Các kiến thức cơ bản và các lỗi đặc trưng trong quá trình cài đặt
* [Boot issue](https://heavietnam.ga/su-co-khoi-dong-opencore/)
  * Các vấn đề gặp phải từ khi khởi động usb cho đến trước khi chọn option boot macos
* [Kernel issue](https://install.heavietnam.com/issue/kernel-issue)
  * Các vấn đề gặp phải khi chọn option boot macos ở picker cho đến khi vào giao diện cài đặt
* [Userspace Issue](https://install.heavietnam.com/issue/userspace-issue)
  * Các vấn đề gặp phải sau khi qua giai đoạn boot kernel tới màn hình hello của MacOS
* [Bigsur issue](https://install.heavietnam.com/issue/issue-bigsur)
  * Các lỗi đặt trưng ở bigsur trở lên
* [Propertree issue](https://install.heavietnam.com/issue/issue-propertree)
  * Các vấn đề gặp phải khi sử dụng propertree
    {% endhint %}

> Và giờ thì tận hưởng thôi :smile: