Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
Introduction for developping UEFI app/driver
Search
orumin
May 25, 2014
Programming
890
1
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
Introduction for developping UEFI app/driver
UEFIを,UDK(EDKII)で開発するための最初のステップについて
解説+α
orumin
May 25, 2014
Transcript
64 slides
自己紹介 • orumin – 学生 • sepcamp2012, GSoC(now) • twitter:
@kotatsu_mi
自己紹介 • orumin – 学生 • sepcamp2012, GSoC(now) • twitter:
@kotatsu_mi • 側転できなさそうな顔の人とか TL 大破とか
自己紹介 • orumin – 学生 • sepcamp2012, GSoC(now) • twitter:
@kotatsu_mi • 側転できなさそうな顔の人とか TL 大破とか • ておくれではない
ておくれではないので, みんなにわかりやすいネタ, やります 既に知ってたらごめんなさい
ておくれではないので, みんなにわかりやすいネタ, やります 既に知ってたらごめんなさい
UEFI
Introduction for developping UEFI app/driver
UEFI • 初出 - “Play with UEFI” カーネル VM 関西
4 • “ いじぇくと的ななにか” カーネル /VM 探検隊 第九回
UEFI • ベタ C 移植 ? • Python? • EFI
Protocol? • なぞのシェル
UEFI • わからん • どう開発してるのか • どう動くのか • ておくれ
UEFI • UEFI は真面目に利便性の高いもの • ておくれてないよ !
UEFI( 加筆 ) • そもそも UEFI とは, BIOS をおきかえるもの •
UEFI 自体にブートローダーやシェルのような ものが実装されている • 自作のアプリケーション,ドライバが簡単に作 れ動かせる ← ココ重要
First Step
First Step • まずは SDK のインストール 今回は UDK について説明します UDK
は EDK(II) の stable で,現在 2014 が最新 (syuu1228 さん,情報提供ありがとうございます )
First Step $ mkdir ~/src $ cd ~/src $ svn
co https://edk2.svn.sourceforge.net/svnroot/ edk2/trunk/edk2 $ make -C edk2/BaseTools $ cd ~/src/edk2 $ export EDK_TOOLS_PATH=$HOME/src/edk2/BaseTools $ source edksetup.sh BaseTools
FirstStep • ${EDK_TOOLS_PATH}/Conf • TOOLS_CHAIN_TAG 変数 • ACTIVE_PLATFORM 変数
FirstStep • ${EDK_TOOLS_PATH}/Conf/target.txt • TOOLS_CHAIN_TAG 変数 -> GCC47 • ACTIVE_PLATFORM
変数 -> FooPkg/FooPkg.dec
FirstStep • ${EDK_TOOLS_PATH}/Conf/target.txt • TOOLS_CHAIN_TAG 変数 -> GCC47 • ACTIVE_PLATFORM
変数 -> FooPkg/FooPkg.dec • 準備完了
FirstStep • ${EDK_TOOLS_PATH}/Conf/target.txt • TOOLS_CHAIN_TAG 変数 -> GCC47 • ACTIVE_PLATFORM
変数 -> FooPkg/FooPkg.dec • 準備完了 • build コマンドでビルドしはじめる
Second Step
Second Step • プロジェクトの設定 • 設定ファイルは基本的には ini ファイルの変種
Second Step • プロジェクトの設定 • 設定ファイルは基本的には ini ファイルの変種 • UNIX-Like
OS で開発してても,滲み出る そこはかとない Windows っぽさ
Second Step • *.dec [Defines] DEC_SPECIFICATION = 0x00010005 PACKAGE_NAME =
AppPkg PACKAGE_GUID = B3E3D3D5-D62B-4497-A175-264F489D127E PACKAGE_VERSION = 0.01
Second Step • たった 4 行 • 設定ファイルのバージョン • プロジェクト名
• UUID • プロジェクトのバージョン
Second Step • *.dsc [Defines] PLATFORM_NAME = AppPkg PLATFORM_GUID =
0458dade-8b6e-4e45-b773-1b27cbda3e06 PLATFORM_VERSION = 0.01 DSC_SPECIFICATION = 0x00010006 OUTPUT_DIRECTORY = Build/AppPkg SUPPORTED_ARCHITECTURES = IA32|IPF|X64 BUILD_TARGETS = DEBUG|RELEASE SKUID_IDENTIFIER = DEFAULT
Second Step • プロジェクト名 • UUID(*.dec とは違うもの ) • プロジェクトのバージョン
• 設定ファイルのバージョン • ビルドの出力先 • ターゲットアーキテクチャ • ビルドターゲット
Second Step • まだまだ続く
Second Step [LibraryClasses] UefiApplicationEntryPoint| MdePkg/Library/UefiApplicationEntryPoint/UefiApplicationEntryPoint.inf ShellCEntryLib| ShellPkg/Library/UefiShellCEntryLib/UefiShellCEntryLib.inf UefiDriverEntryPoint| MdePkg/Library/UefiDriverEntryPoint/UefiDriverEntryPoint.inf
Second Step • この LibraryClasses セクションは, foo|path/to/libraryfolder という形 • foo
はなんでも良いけれど, UDK 内の既存プ ロジェクトに従ったほうが良い
Second Step • 最初の 3 つはエントリポイントについての ライブラリをプロジェクトに読み込む • これをしないとエントリポイントつくれない •
3 つのエントリポイントの違いは後ほど
Second Step BaseLib|MdePkg/Library/BaseLib/BaseLib.inf BaseMemoryLib|MdePkg/Library/BaseMemoryLib/BaseMemoryLib.inf UefiLib|MdePkg/Library/UefiLib/UefiLib.inf PrintLib|MdePkg/Library/BasePrintLib/BasePrintLib.inf PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf MemoryAllocationLib| MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf UefiBootServicesTableLib|
MdePkg/Library/UefiBootServicesTableLib/UefiBootServicesTableLib.inf UefiRuntimeServicesTableLib| MdePkg/Library/UefiRuntimeServicesTableLib/UefiRuntimeServicesTableLib.inf
Second Step • その他必要ライブラリのみなさん • 必ずしもこれらが必要なわけではない • UDK 内の既存プロジェクトとそのヘッダを 見てどんなユーティリティがあるか判断
None
Second Step [Components] AppPkg/Applications/Hello/Hello.inf …
Second Step • [Components] セクション • プロジェクトを更にモジュール毎に分割した 小さいプロジェクトの設定ファイルのパス この設定ファイルは *.inf
Second Step • dsc ファイルについて最後に • libc とか web socket
を使う場合だけ !include StdLib/StdLib.inc !include AppPkg/Applications/Sockets/Sockets.inc • この 2 行で設定の読み込みが必要
Second Step
Second Step [Defines] INF_VERSION = 0x00010006 BASE_NAME = Hello FILE_GUID
= a912f198-7f0e-4803-b908-b757b806ec83 MODULE_TYPE = UEFI_APPLICATION VERSION_STRING = 0.1 ENTRY_POINT = ShellCEntryLib
Second Step • inf ファイルの [defines] セクション • dsc の
[defines] と大差なし • ポイントは,ここで MODULE_TYPE と ENTRY_POINT を指定
Second Step • MODULE_TYPE は UEFI_APPLICATION か UEFI_DRIVER • ENTRY_POINT
は dsc ファイルに書いて 読み込んだ 3 つ, ShellCLibEntryPoint UefiApplicationEntryPoint UefiDriverEntryPoint
Second Step [Sources] Hello.c [Packages] MdePkg/MdePkg.dec ShellPkg/ShellPkg.dec [LibraryClasses] UefiLib ShellCEntryLib
Second Step • リンク / コンパイルするソース全て • 使用するライブラリを含むパッケージの プロジェクト設定へのパス •
LibraryClasses ここでは, dsc に既に書いたので省略形で 記述
Second Step • dsc の Components でモジュール分割するほどのプ ロジェクトでなければ, dsc のほうに
MODULE_TYPE やら ENTRY_POINT や ら書いてしまって, inf には [Sources] だけというのも可能 • inf を応用して,ソースコードだけ別フォルダに 分けるときに使うという使用方法もあり
エントリポイントについて UefiApplication 〜は UEFI の API 独自の作法に 従うエントリポイント EFI_IMAGE_HANDLE,EFI_SYSTEM_TABLE という型の引数で呼ばれる
エントリポイントについて • ShellCLib 〜の場合は普通の main から スタート • ほぼ完全にコード変更なしに pure
C が動作 • UEFI Protocol(API) を呼ぶのがちと面倒
エントリポイントについて • UefiDriver 〜はいわずもがな, UEFI ドライバを記述するときの エントリポイント • 引数は UefiApplication
〜と同様 • ドライバはこれしかない • UnEntryPoint の設定も必要
Let's coding
Let's coding • さあ後はコーディングするだけ ! • inf に適宜ソースファイル追加しつつ コーディングしましょう
Let's coding • さあ後はコーディングするだけ ! • inf に適宜ソースファイル追加しつつ コーディングしましょう •
Happy Hacking!!!
おわり
なワケないでショー !?
なワケないでショー !?
Let's coding • UEFI Protocol について • UEFI の API
のこと • なんで Protocol なんでしょうね • データ駆動型 API です
Let's coding • 基本的には, HandleProtocol() で特定の デバイス等の Handle を取得 •
その Handle を OpenProtocol() にぶちこんで Protocol 構造体にデータを詰め込んでもらう • 構造体に詰められた関数ポインタを通して API コール
None
Let's coding typedef struct { EFI_TABLE_HEADER Hdr*; CHAR16 *FirmwareVendor; UINT32
FirmwareRevision; EFI_HANDLE ConsoleInHandle; EFI_SIMPLE_TEXT_INPUT_PROTOCOL *ConIn; EFI_HANDLE ConsoleOutHandle; EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *ConOut;
Let's coding EFI_HANDLE StandardErrorHandle; EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *StdErr; EFI_RUNTIME_SERVICES *RuntimeServices; EFI_BOOT_SERVICES *BootServices;
UINTN NumberOfTableEntries; EFI_CONFIGURATION_TABLE *ConfigurationTable; } EFI_SYSTEM_TABLE; •
Let's coding EFI_HANDLE StandardErrorHandle; EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *StdErr; EFI_RUNTIME_SERVICES *RuntimeServices; EFI_BOOT_SERVICES *BootServices;
UINTN NumberOfTableEntries; EFI_CONFIGURATION_TABLE *ConfigurationTable; } EFI_SYSTEM_TABLE; •
Let's coding • gST,gRS,gBS … 既に宣言 • gBS が特に重要 LocateHandle()
, Open/CloseProtocol() 他にも LoadImage() , StartImage() ExitBootServices() 等 • 最悪 EFI_SYMPLE_FILE_SYSTEM_PROTOCOL と EFI_BOOT_SERVICES だけでブートローダ書ける
• ドライバの場合,加えてヘッダで自身の プロトコルのデータ構造を公開 • DRIVER_BINDING_PROTOCOL で プロトコルをデバイスに対して使えるかの チェック,プロトコル開始時の資源確保, プロトコル終了時の資源解放を記述
Let's coding • 実際のコードを見てみよう https://github.com/tianocore/edk2-FatPkg *.dec と *.dsc と *.inf
が設定, Fat.h に各種宣言, Fat.c が EntryPoint 他にも Fat.c でつかわれる Lock が Misc.c デバイスのアロケートを Init.c Read/Write を ReadWrite.c… という具合
おわりに • 駆け足だったので伝わらない部分もあったはず • スライド上げとくのでどうぞ読み直して下さい • デモ用意できませんでした • 最小限のプロジェクトのテンプレートを GitHub
に上げとく ( 予定 )
おわりに • UDK は VisualStudio でも使えます (Windows ユーザーさんどうぞ ) •
UNIX Like な OS で動作させる前提のツールは gnu-efi のほうが楽かもしれません GrowBuffer() や LocateHandlebyDiskSignature() とか • rEFInd とか参考にしてね ! http://sourceforge.net/projects/refind/files/
余談 • Hibernation 中の swap パーティションの snapshot を UEFI app
で弄ったりして, secure boot の secure さを壊せるのでは ? https://lkml.org/lkml/2013/8/22/218 • 発端 http://lists.opensuse.org/opensuse-kernel/ 2013-09/msg00068.html
More Decks by orumin
See All by orumin
あのころの iPod を どうにか再生させたい
orumin
2
3k
ヴィンテージマシンと付き合う - kernel/vm online 5
orumin
0
1.3k
むかしの RISC、むかしの Unix
orumin
7
3.9k
Fundamental of architecture to implementing OS on AArch64
orumin
3
5.9k
Kernel/VM Kansai #9
orumin
0
1k
Kernel/VM #14 発表資料
orumin
1
660
Unikernels report
orumin
2
560
第13回Kernel/VM勉強会発表資料
orumin
1
1.7k
第12回カーネル/VM探検隊
orumin
0
410
Other Decks in Programming
See All in Programming
Claude Code ハーネスDeep Dive – 君はどこまで制御する? -
takateeen_knj
6
6.3k
ローカルLLMの基本と近況 2611 / Local LLM basics and recent situation 2611
kishida
3
660
数行の変更でDockerビルドを最大91%高速化~GitLab CIの実行基盤を社内40リポジトリに展開するまで~
picopico
2
260
エラーチャンネルのボールを拾い続けて鍛えるエンジニアの地力 / phpcon-niigata2026
meihei3
1
500
プロジェクトコードをキレイキレイしよう!暗黙的な参照を読み解く静的解析
ostk0069
0
220
[Kotlin Fest 2026] eBPF Tracing for Kotlin
takehaya
1
400
SODA - FACT BOOK(JP)
sodainc
1
40k
AI時代のシニアエンジニアとは
yosuke_furukawa
PRO
15
12k
baseline으로 마이그레이션, 리팩토링 안전하게 맡기기
fornewid
1
1.1k
Debian JP Projectのサーバー構成
uwabami
1
180
どうしても Eloquent でリポジトリパターンをやりたいんだ #phpcon_niigata / phpcon-niigata-2026
shogogg
0
670
SODA - FACT BOOK(EN)
sodainc
1
280
Featured
See All Featured
Darren the Foodie - Storyboard
khoart
PRO
5
4.1k
The SEO Collaboration Effect
kristinabergwall1
1
630
技術選定の審美眼(2025年版) / Understanding the Spiral of Technologies 2025 edition
twada
PRO
121
130k
Navigating the Design Leadership Dip - Product Design Week Design Leaders+ Conference 2024
apolaine
2
530
Why You Should Never Use an ORM
jnunemaker
PRO
61
10k
HU Berlin: Industrial-Strength Natural Language Processing with spaCy and Prodigy
inesmontani
PRO
0
820
Joys of Absence: A Defence of Solitary Play
codingconduct
1
580
Ten Tips & Tricks for a 🌱 transition
stuffmc
1
290
Navigating Weather and Climate Data
rabernat
0
600
The Cult of Friendly URLs
andyhume
79
7.1k
Prompt Engineering for Job Search
mfonobong
0
610
Believing is Seeing
oripsolob
1
290