Asahi LinuxでUSB Type-Cから外部ディスプレイに画面出力を行う

はじめに

ARM64版のVoid Linuxを搭載したMacBook Air M2で、USB Type-Cから外部ディスプレイへの接続に成功した。本記事では、それを可能にするハックが施されたAsahi LinuxカーネルをVoid Linuxでビルド、およびインストールする方法を記す。

普段使い用のMacBook AirにAsahi Linux（ディストロはVoid Linux）を入れてから約半年が経過した。軽くて（Linuxラップトップにしては）バッテリーが持ち、しかもMinecraftを快適にプレイ出来るこの素晴らしい道具は、しかし「ディスプレイをつなぐことが出来ない」という重大な欠点を抱えていた。故に、Asahi Linuxを使う者はコードを書きながらブラウザで動作確認することも、ゲームをやりながらゲーム実況を見ることも出来ない生活を受け入れる必要があった。

Progress Report: Linux 6.19 - Asahi Linux

asahilinux.org

この「DP Alt Mode¹」問題はAsahi Linuxコミュニティでも特に注目されており、Asahi Linuxの開発チームには

“When will display out via USB-C be supported?”
“Is there an ETA for DisplayPort Alt Mode?”
“Can I use an HDMI adapter on my MacBook Air yet?”

という旨の質問がIRCやMatrixで週に一度は飛んできたという。そうした質問攻めはいくら丁寧にお願いしてもやむ気配がなく、結局

DP Alt Mode will be done when it’s done.

と答えるしかなかったようだ。

GitHub - AsahiLinux/linux at fairydust

Linux kernel source tree. Contribute to AsahiLinux/linux development by creating an account on GitHub.

github.com

しかし、彼らは成し遂げた。なんと現在、Asahi LinuxカーネルのfairydustブランチにてDP Altモードでの映像出力を可能にするハックが実装されている。（いくつかのバグはまだ残っているが）この偉大な達成を目にした筆者は、マイクラ実況を見ながらマイクラをする生活を求めてLinuxカーネルのビルドに臨むのだった。

ハック済みLinuxカーネルをインストールする

Asahi Linux, DP Alt Mode를 지원하는 Kernel branch "Fairydust" 공개, kernel 빌드 방법 및 적용 결과

본 포스트는 Fedora Asahi Remix를 기반으로 작성되었습니다. 2025년 12월 30일, 39C3에서 Asahi Team의 개발 멤버인 svan이 Asahi Linux - Porting Linux to Apple Silicon이라는 주제로 발표가 있었습니다. (이전 포스트 참고)그리고, DP alt-mode(DisplayPort alternative mode)가 적용된 kernel source 코드가 공개되었습니다. 아직은 개발자 버전 소스코드라고 할 수 있겠죠.. 코드명은 Fairydust 입니다. 작명 센스가 돋보입니다. Update : 2026.02.16- fairydust 가 6.18.10+ 로 업데이트 되었습니다. 아래 글 내용에서 버전이 불일치 하는 부분들은 참고 하시기 바랍니..

elsainmac.tistory.com

実は、Fedora Asahi Remixでは既に成功例が存在している（詳細は上記を参照）。これを参考に、Void LinuxでfairydustブランチのLinuxカーネルをビルドしてインストールする方法を紹介する。なお、Fedora Asahi Remixを使っている人は上記記事を直接見ることをおすすめする。

void-packagesの導入

まず、void-packagesをGitHubからcloneする。void-packagesは、xbps²形式のバイナリパッケージをビルドするために必要な様々なスクリプト、およびツール類をまとめたビルドシステムである。パッケージをビルドするためのライブラリを作業ディレクトリ内に隔離した状態でインストール出来るため、システム全体を汚さずに済む。本記事では、これを用いてAsahi Linuxのカーネルをビルドする。

git clone https://github.com/void-linux/void-packages
cd void-packages

でリポジトリに入る。

また、xtoolsもインストールしておこう。xtoolsは、xbpsで使える便利なコマンドを取り揃えたユーティリティである。

sudo xbps-install -S xtools

設定ファイルの編集

srcpkgs/linux-asahi配下の2ファイルを、以下のように書き換える。

1. `srcpkgs/linux-asahi/template`

 diff --git a/srcpkgs/linux-asahi/template b/srcpkgs/linux-asahi/template
 index 1e3c5500167..3becf94084d 100644
 --- a/srcpkgs/linux-asahi/template
 +++ b/srcpkgs/linux-asahi/template
@@ -1,12 +1,15 @@
# Template file for 'linux-asahi'
pkgname=linux-asahi
version=6.18.9+1
version=6.18.10+fairydust
revision=1

_commit=61b6e714dd19b7bee1c0e6ec4234199e640c2932

short_desc="Linux kernel and modules for Apple Silicon"
maintainer="dkwo <npiazza@disroot.org>, Will Springer <skirmisher@protonmail.com>"
license="GPL-2.0-only"
homepage="https://asahilinux.org"
distfiles="https://github.com/AsahiLinux/linux/archive/asahi-${version/+/-}.tar.gz"
distfiles="https://github.com/AsahiLinux/linux/archive/${_commit}.tar.gz>${pkgname}-${version}.tar.gz"
checksum=36ba3a3e4c5308d4e3c9c91aba98f727fc03ee5cd015cb8ffb522fa4e7265425
wrksrc="linux-${_commit}"

python_version=3

以上のように変更を加えた後、

./xbps-src -i linux-asahi

でファイルの整合性を検証する。

2. `srcpkgs/linux-asahi/files/arm64-dotconfig`

 diff --git a/srcpkgs/linux-asahi/files/arm64-dotconfig b/srcpkgs/linux-asahi/files/arm64-dotconfig
 index 74134f02df0..06bdf7e2974 100755
 --- a/srcpkgs/linux-asahi/files/arm64-dotconfig
 +++ b/srcpkgs/linux-asahi/files/arm64-dotconfig
@@ -2382,7 +2382,7 @@ CONFIG_NVME_VERBOSE_ERRORS=y
# CONFIG_NVME_FC is not set
# CONFIG_NVME_TCP is not set
# CONFIG_NVME_HOST_AUTH is not set
CONFIG_NVME_APPLE=m
CONFIG_NVME_APPLE=y
# CONFIG_NVME_TARGET is not set
# end of NVME Support

@@ -5831,7 +5831,7 @@ CONFIG_USB_HIDDEV=y
#
# SPI HID support
#
CONFIG_SPI_HID_APPLE_OF=m
CONFIG_SPI_HID_APPLE_OF=y
# end of SPI HID support

CONFIG_SPI_HID_APPLE_CORE=m
@@ -6738,7 +6738,7 @@ CONFIG_APPLE_PMGR_MISC=y
CONFIG_APPLE_TUNABLE=m
CONFIG_APPLE_RTKIT=y
CONFIG_APPLE_RTKIT_HELPER=m
CONFIG_APPLE_SART=m
CONFIG_APPLE_SART=y
CONFIG_RUST_APPLE_MAILBOX=y
2 collapsed lines
CONFIG_RUST_APPLE_RTKIT=y
CONFIG_APPLE_AOP=m

それぞれ、モジュールとしてではなくカーネル内に組み込むようにすると安定性が増すらしい。

ビルド

./xbps-src pkg linux-asahi

を実行し、ビルドする。カーネルモジュールを大量に入れるためか、ビルドが終わるまでに約20分もかかった。気長に待とう。

インストール

xi linux-asahi

でビルドしたLinuxカーネルパッケージをインストールする。

成功！

その後再起動してfairydustと記されたカーネルを選択すれば、（うまくいけば）外部モニターに画面が映るはずである。ただし、USB Type-C ポートは本体左側にある2つのうち前方のものを使う必要がある。

カスタムされたLinuxカーネルを自分でビルドするのは一見ハードルが高く見えるが、void-packagesのおかげで意外と簡単に出来る。（世界に何人いるのか知らないが）Void LinuxをMacBookに入れている人、また本記事を読んで入れたくなった人は是非参考にしてほしい。

おわりに

プロプライエタリなAppleのハードウェアに正面から立ち向かい、リバースエンジニアリングを続けてきた世界中のOSS開発者の皆へ

ありがとう。

USB Type-CからDisplayPort/HDMIで直接映像を出力する機能のこと ↩
Void Linuxのパッケージマネージャー ↩

創作物紹介