Hướng dẫn Debug OpenCore

1. Tổng quan.

Nếu bạn đang gặp lỗi hoặc hệ thống bị treo khi khởi động với OpenCore, đây là những bước cần thực hiện để xác định nguyên nhân và khắc phục.

2. Thay đổi file (File Swaps)

Trước tiên, bạn cần sử dụng phiên bản DEBUG hoặc NOOPT của OpenCore thay vì phiên bản RELEASE. Những phiên bản này cung cấp nhiều thông tin chi tiết hơn để debug.

Các file cần thay thế:

• EFI/BOOT/
  • BOOTx64.efi
• EFI/OC/Drivers/
  • OpenRuntime.efi
  • OpenCanopy.efi (nếu bạn đang sử dụng nó)
• EFI/OC/
  • OpenCore.efi

📌 Lưu ý:
Nên debug hệ thống không có OpenCanopy vì nếu OpenCanopy không phải phiên bản DEBUG, bạn sẽ không nhận được thông tin debug hữu ích.

3. Cấu hình trong config.plist (Config Changes)

Mở file config.plist và tìm đến phần Misc > Debug, sau đó chỉnh sửa các giá trị sau:

Bật Chế Độ Debug

• AppleDebug = YES
  • Kích hoạt chế độ debug chi tiết liên quan đến boot.efi, đồng thời lưu log vào ổ đĩa.
• ApplePanic = YES
  • Lưu lại thông tin khi xảy ra kernel panic.
  • Khuyến nghị thêm keepsyms=1 vào boot-args để giữ nguyên thông tin lỗi.
• DisableWatchdog = YES
  • Vô hiệu hóa UEFI Watchdog, tránh OpenCore bị treo do các tác vụ không quan trọng.

Cấu Hình Mức Debug (Target)

Giá trị Target quyết định mức độ debug. Chúng ta sẽ chọn:

• 0x01 – Bật ghi log
• 0x02 – Hiển thị debug trên màn hình
• 0x40 – Lưu log vào file

💡 Tính toán giá trị Target:
0x01 + 0x02 + 0x40 = 0x43 (Chuyển đổi sang decimal: 67)
📌 Cấu hình trong config.plist:

Misc -> Debug -> Target -> 67

Cấu Hình Mức Hiển Thị Log (DisplayLevel)

Chúng ta sẽ bật các mức log quan trọng:

• 0x00000002 – Cảnh báo (DEBUG_WARN)
• 0x00000040 – Thông tin debug (DEBUG_INFO)
• 0x80000000 – Lỗi nghiêm trọng (DEBUG_ERROR)

💡 Tính toán giá trị DisplayLevel:
0x80000042 (Chuyển đổi sang decimal: 2147483714)
📌 Cấu hình trong config.plist:

Misc -> Debug -> DisplayLevel -> 2147483714

4. Tắt Toàn Bộ Debug & Logging

Nếu muốn tắt hoàn toàn chế độ debug và không ghi log, hãy làm như sau:

• Thay lại toàn bộ file OpenCore về phiên bản RELEASE như đã đề cập trong phần File Swaps.
• Chỉnh sửa config.plist: AppleDebug = NO ApplePanic = NO Target = 0

5. Kết Luận

Bằng cách làm theo hướng dẫn trên, bạn có thể debug lỗi OpenCore dễ dàng hơn. Nếu cần thêm thông tin, có thể kiểm tra log được lưu vào ổ đĩa để phân tích nguyên nhân. 🚀

Tham khảo https://dortania.github.io/OpenCore-Install-Guide/troubleshooting/debug.html#config-changes