INF trong EDK II là gì?

INF là metadata của một module EDK II. Nó trả lời câu hỏi: module này là loại gì, entry point ở đâu, dùng source file nào, cần package nào, cần library class nào, consume protocol/PCD nào.

Nếu C file là phần “logic”, thì INF là phần “module nói với build system rằng tôi cần gì”.

MyDxe/
├─ MyDxe.inf
└─ MyDxe.c

[Defines]
  INF_VERSION                    = 0x00010017
  BASE_NAME                      = MyDxe
  FILE_GUID                      = 22222222-3333-4444-5555-666666666666
  MODULE_TYPE                    = DXE_DRIVER
  VERSION_STRING                 = 1.0
  ENTRY_POINT                    = MyDxeEntryPoint

[Sources]
  MyDxe.c

[Packages]
  MdePkg/MdePkg.dec
  MdeModulePkg/MdeModulePkg.dec
  MyPkg/MyPkg.dec

[LibraryClasses]
  UefiDriverEntryPoint
  UefiBootServicesTableLib
  DebugLib
  BaseMemoryLib
  BoardConfigLib

[Protocols]
  gEfiLoadedImageProtocolGuid

[Pcd]
  gMyPkgTokenSpaceGuid.PcdEnableVerboseLog

Khi muốn gọi hàm của module/library khác

Đây là lỗi rất hay gặp khi mới đọc EDK II: thấy hàm trong source tree rồi include header, nhưng build/link vẫn lỗi.

Trong EDK II, muốn gọi code từ library khác, bạn cần đủ các mảnh sau:

Ví dụ trong C:

#include <Library/BoardConfigLib.h>

EFI_STATUS
EFIAPI
MyDxeEntryPoint (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  CONST BOARD_GPIO_TABLE *Table;

  Table = BoardConfigGetGpioTable ();
  DEBUG ((DEBUG_INFO, "GPIO table = %p\n", Table));
  return EFI_SUCCESS;
}

Nếu chỉ include header nhưng INF thiếu:

[LibraryClasses]
  BoardConfigLib

hoặc DSC thiếu:

[LibraryClasses]
  BoardConfigLib|MyPkg/Library/BoardConfigLib/BoardConfigLib.inf

thì rất dễ gặp link error.

Build error vs link error

INF không quyết định tất cả

INF nói module cần gì, nhưng chưa đủ để module xuất hiện trong firmware image. Module vẫn cần:

• được đưa vào DSC để build trong platform;
• được đưa vào FDF/FV nếu muốn nằm trong ROM image;
• dependency thỏa nếu là PEIM/DXE driver;
• đúng module type và entry point.

Ghi nhớ nhanh

INF là “bản khai nhu cầu” của module. Khi build lỗi, hãy đọc INF như một checklist: module này nói đủ những thứ nó đang dùng trong C chưa?

Bài liên quan

• DEC trong EDK II là gì?
• DEPEX là gì?
• EDK II Module là gì?
• FDF trong EDK II là gì?

Nguồn tham khảo public

• TianoCore EDK II source code
• EDK II Documentation
• EDK II Module Writer’s Guide