私、macOS XをNintendo Wiiにポート(移植)いたしました。

2026/04/09 0:40

私、macOS XをNintendo Wiiにポート(移植)いたしました。

RSS: https://news.ycombinator.com/rss

要約

Japanese Translation:


改良された要約

Mac OS X 10.0(Cheetah)は、Nintendo Wii 上でネイティブに動作するようにポートされ、コンソールをキーボード/マウス入力と GUI サポート付きの完全機能型デスクトップへ変貌させました。プロジェクトのコアは、ppcskel をベースに最初から書き直されたカスタムブートローダーです。このブートローダーは、Wii の PowerPC 750CL CPU を起動し、メモリレイアウトを設定し、最小限のデバイスツリー(root → cpus → PowerPC,750; memory)を作成します。SD カードから XNU カーネルをロードし、実行中にカーネルバイナリをパッチ(MEM1/MEM2 用の BAT 設定と USB Gecko へのコンソール出力)し、制御を XNU に渡します。

ブートローダーが提供する主要ドライバーは次の通りです:

  • SD‑カードドライバー:Starlet MINI IPC コマンド(IPC_SDMMC_SIZE, READ, WRITE)を介して IOBlockStorageDevice を実装し、XNU が SD カードからルートファイルシステムをマウントできるようにします。
  • フレームバッファドライバー:0x01700000 に RGB フレームバッファ(640×480 @ 16 bpp)を提供し、Wii のアナログテレビ出力用に YUV へ変換して Mac OS X GUI を実現します。
  • USB サポート:PCI デバイスのニブ(NintendoWiiHollywoodPCIDevice)を作成し、AppleUSBOHCI をパッチして受け入れさせ、OHCI ドライバーからバイトスワップ処理を除去することでリバースレトルエンディアンハードウェアに対応し、USB キーボード/マウス機能をフル実装します。

ブートローダーは Apple Partition Map を解析し、起動可能なパーティションを一覧表示し、/chosen/memory‑map ノード経由でカーネル拡張を直接メモリにロードできるようにするため、改変されていない Mac OS X インストーラーパーティションからのインストールも可能です。必要なカーネル変更は最小限(BAT 設定、“hollywood” I/O ベース取得、フレームバッファキャッシュ整合性修正)で済み、その他すべてのドライバーはブートローダーが提供します。

この成果は、歴史的にサポートされていなかったプラットフォーム――Nintendo Wii――でも Mac OS X Cheetah をエンドツーエンドで動作させることを示し、ホビイストに低コストのレトロコンソールとして機能するデスクトップコンピュータを提供します。

本文

マック OS X 10.0(Cheetah)をニンテンドーWii上でネイティブに動かす


概要

2007年の発売以来、WiiはLinux・NetBSD・Windows NTをホストしてきました。
現在ではMac OS X 10.0 Cheetahも実行できるようになりました。このプロジェクトでは
Wii のハードウェアを学び、ブートローダを書き、XNU をパッチし、SD‑カード・フレームバッファ・USB 用の IOKit ドライバを構築しました。


1. 実現可能性

項目内容
ハードウェアCPU:PowerPC 750CL(G3 iBooks / iMac 系列と同一)
RAM:88 MB(24 MB 1T‑SRAM + 64 MB GDDR3 SDRAM)
Cheetah は公式に128 MB が必要ですが、少ないメモリでもブート可能
必須ペリフェラル:USB Gecko(シリアルデバッグ)、SDカード(rootfs)、IRQ コントローラ、RAM フレームバッファ、マウス/キーボード用 USB ホスト
ソフトウェアDarwin のコアはオープンソース。Wii 上で動作させるために必要なのはカーネルパッチだけ
実際のMac は Open Firmware → BootX → XNU を経て起動しますが、XNU が開始するとファームウェアや BootX への依存はなくなります

2. ブートローダ設計

タスクアプローチ
ハードウェア初期化
ppcskel
の雛形を使用。レジスタ設定、フレームバッファ、USB Gecko をセットアップ
カーネル読み込みSDカードから Mach‑O をロードし、ロードコマンドを解析してセグメントを RAM にマップ
デバイスツリー構築最小限のハードコード済みツリー(
/
,
cpus → PowerPC,750
,
memory
)を作成
ブート引数渡し
boot_args_t
を埋め込み、コマンドライン、DRAM バンク情報、ビデオ情報、deviceTreeP などを設定
XNU 起動エントリポイントを関数としてキャストし、
(boot_args_address, MAC_OS_X_SIGNATURE)
で呼び出す
  • カーネルエントリポイントのパッチ
    • 各重要ステージ(
      start.s
      ,
      ppc_init.c
      など)後に Wii の LED を点滅させるバイナリパッチをオンザフライで行う。シリアル出力が無い環境でも進捗確認が可能。

3. カーネルパッチ

  1. BAT 設定 – XNU のメモリマッピングを MEM1/MEM2 レイアウトに合わせる。
  2. I/O ベースアドレス – デバイスツリー内の
    hollywood
    ノードから取得。
  3. フレームバッファキャッシュ整合性 – 未キャッシュアクセスを強制。

開発環境:QEMU で Cheetah を実行し、ホスト Mac から NFS 経由で XNU ソースを取得、SSH でビルドをトリガー。


4. ドライバ開発

4.1 IOKit の基礎

  • ドライバはオブジェクト、nubs はアタッチポイント。
  • 例:PCI バスドライバが
    IOPCIDevice
    nubs を生成し、イーサネットドライバがそれらにアタッチ。

4.2 Hollywood SoC ドライバ

bool NintendoWiiHollywood::publishBelow(OSIterator *iter) {
    IOService *nub;
    while ((next = (IORegistryEntry *)iter->getNextObject())) {
        nub = createNub(next);
        if (!nub) continue;
        if (nub->attach(this)) nub->registerService();
        nub->release();
    }
    iter->release();
    return true;
}
  • /hollywood
    配下の各子ノードに対してナブを作成し、他のドライバがアタッチできるよう公開。

4.3 SD‑カード ドライバ

  • IOBlockStorageDevice
    をサブクラス化。
  • Starlet の Mini IPC を利用し SD コマンド(
    IPC_SDMMC_SIZE
    ,
    READ
    ,
    WRITE
    )を送受信。
  • DMA バッファ用に未キャッシュメモリを扱う。

4.4 フレームバッファ ドライバ

IODeviceMemory *NintendoWiiFramebuffer::getApertureRange(
        IOPixelAperture aperature) {
    return IODeviceMemory::withRange(0x01700000, 640 * 480 * 2);
}
  • RGB(Mac OS X が使用)と YUV(Wii のビデオハードウェアが期待)という二つのフレームバッファを提供。
  • 60 Hz で RGB → YUV を変換し、YUV フレームバッファへコピー。

isConsoleDevice()
true
を返すことで従来型テキストコンソールを抑制。

4.5 USB サポート

  1. 欠落したソース – 古い Apple CVS の
    IOUSBFamily
    を取得。
  2. ホストコントローラ
    AppleUSBOHCI
    を改造し、偽 PCI ナブ(
    NintendoWiiHollywoodPCIDevice
    )を作成してドライバ人格を満たす。
  3. エンディアン – Wii はリバース・リトルエンディアンであるため、不要なビットスワップ処理をバイナリから除去。

結果として USB キーボード/マウスが動作し、Wii を実用的な Mac に変えることに成功。


5. ブートローダ拡張

  • パーティションブートメニュー – Apple Partition Map (APM) を解析してインストール・システムパーティションを一覧表示。
  • ドライバ注入 – SDカードから kext を読み込み、
    /chosen/memory‑map
    にロードして XNU 起動前にカーネルをクリーンに保つ。

6. 簡易化されたカーネル

必要なパッチはわずか三点:

  1. Wii メモリレイアウト用の BAT 設定。
  2. “hollywood” ノードから取得した I/O ベースアドレス。
  3. フレームバッファキャッシュ整合性修正。

ドライバは root ファイルシステムに置くことで、将来の 10.1 Puma への移植が容易になります。


7. 締めくくり

このプロジェクトは、一見不可能と思われるポートでも、粘り強さとハードウェア理解を深めれば実現できることを示しました。
得られた教訓は次の通りです:

  • ブートローダ設計
  • Mach‑O パース
  • IOKit ドライバ構築
  • Starlet 上の IPC リバースエンジニアリング
  • エンディアン特有の問題処理

現在、Wii はフル機能の Mac OS X デスクトップを稼働し、GUI、キーボード/マウス入力、SDカード経由でのインストール・アップデートが可能です。

同じ日のほかのニュース

一覧に戻る →

2026/04/09 4:23

**ソフトウェア開発者のためのUSB:ユーザースペース USB ドライバー作成入門**

## Japanese Translation: ``` USB デバイスの操作は、libusb を使用してユーザー空間だけで完全に処理できるため、カーネルレベルのドライバ開発は不要です。 例として、Fastboot モード(VID 18d1 / PID 4ee0)にある Android フォンを挙げます。接続すると `lsusb` は「Google Inc. Nexus/Pixel Device (fastboot)」と表示し、カーネルドライバは付いていません。また、ベンダー固有クラスインターフェースが 2 つのバルクエンドポイントを公開します:コマンド送信用 OUT 0x02 とレスポンス受信用 IN 0x81。 libusb のホットプラグコールバックはこのデバイスの到着を検出し、Fastboot コマンドを自動的に発行できます。典型的な手順は次のとおりです: 1. `libusb_control_transfer` を使用して GET_STATUS リクエストを送信します。2 バイトの応答はデバイスがセルフパワーであり、リモートウェイクアップをサポートしないことを示します。 2. GET_DESCRIPTOR リクエストを送信して完全なデバイスディスクリプタ(ベンダー/プロダクト ID、USB バージョン等)を取得します。 3. バルク OUT 0x02 を介して Fastboot コマンドを発行します(例:「getvar:version」を 64 バイトにパディング)。 デバイスは IN 0x81 で 4 文字のステータス(「OKAY」または「FAIL」)と任意のペイロードを返します。 同じユーザー空間アプローチは、バルク転送に依存する他の USB プロトコルにも適用できます。主な作業はカーネルコードを書く代わりにプロトコルロジックを実装することです。これにより OEM 向けドライバ開発が簡素化され、ブートローダーのテストが迅速化し、カーネルモジュールなしでカスタム USB デバイスの高速プロトタイピングやデバッグが可能になり、組込み開発者と広範な USB エコシステムに恩恵をもたらします。 ```

2026/04/08 17:53

**コードを読む前に実行しておくべき一般的な Git コマンド** - `git fetch --all` *リモートの全ブランチとタグを取得します。* - `git status` *現在のブランチと未コミットの変更点を確認します。* - `git checkout <branch>` *対象となる機能やバグ修正用ブランチに切り替えます。* - `git pull --rebase` *ローカルブランチを最新の upstream コミットで更新します。* - `git log --oneline --graph --decorate -5` *簡潔なコミット履歴を表示し、文脈を把握します。* - `git diff origin/<branch>..HEAD` *まだプッシュしていない変更点を確認します。* - `git rev-parse HEAD` *現在のコミットハッシュを取得(参照に便利)。* - `git tag --list` *利用可能なタグ一覧を表示し、バージョン管理に役立てます。* - `git show <commit>` *特定のコミットの詳細と差分を調べます。* これらのコマンドで、コードを掘り下げる前にリポジトリの状態を素早く把握できます。

## 日本語訳: 以下の文章を日本語に翻訳してください。 ### 修正版要約 この記事は、ソースファイルを検査する前にコードベースの簡易監査が隠れた健康リスクを明らかにできる方法を示しています。これは5つの簡潔な Git コマンドを実行することで達成されます。 1. `git log --format=format: --name-only --since="1 year ago" | sort | uniq -c | sort -nr | head -20` 過去 1 年間で最も変更頻度が高い上位 20 ファイルを一覧表示し、潜在的な「ドラッグ」スポット(高い変更率)をフラグ付けします。 2. `git shortlog -sn --no-merges` コミット数で貢献者をランク付けします。単一人物が 70 % 超を占める場合はバスファクターが低く、過去 6 ヶ月にその貢献者がいない場合は危機的状況を示唆します。 3. `git log -i -E --grep="fix|bug|broken" --name-only --format='' | sort | uniq -c | sort -nr | head -20` バグ関連コミットが最も多いファイルを特定し、変更率データと照合して最高リスクコードをピンポイントします。 4. `git log --format='%ad' --date=format:'%Y-%m' | sort | uniq -c` 月ごとのコミット数を表示し、活動の加速または減退(例:半月間のドロップ)が重要人物の離脱を示す可能性があります。 5. `git log --oneline --since="1 year ago" | grep -iE 'revert|hotfix|emergency|rollback'` リバートとホットフィックスの数をカウントします。頻繁なリバートはデプロイ/テストが不安定であることを示し、ゼロの場合は安定性またはコミットメッセージ不足を意味する可能性があります。 これらの指標(変更ホットスポット、バスファクター問題、バグクラスタ、プロジェクトモーメンタム、火災対策頻度)は、コード複雑度測定だけよりも欠陥予測精度が高いと示されています(Microsoft Research 2005)。記事はスクワッシュマージワークフローが著者データを歪めることを警告しています。最初の監査に1時間を費やした後、筆者は特定されたリスクスポットに対して週単位で詳細調査を計画しています。関連研究としてはエンジニアリングチーム速度、Vim 使用、レガシー Rails 監査、Rails `default_scope` が引用されています。この手法は開発者に迅速なコミット履歴ベースの診断を提供し、高リスクファイルへの詳細コードレビューを集中させることでバグ削減、チームレジリエンス、およびリリース信頼性の向上を実現します。

2026/04/09 2:11

**カルマンフィルタを理解する:シンプルなレーダー例題** カルマンフィルタは、ノイズの多い測定値からシステム(位置・速度など)の状態を推定するアルゴリズムです。 この例では、レーダーセンサーを使って移動物体を追跡する方法を見てみます。 1. **システムモデル** - 状態ベクトル:\(\mathbf{x}_k = [x_k,\; y_k,\; \dot{x}_k,\; \dot{y}_k]^T\) - 変換行列(定常速度モデル): \[ \mathbf{F} = \begin{bmatrix} 1 & 0 & \Delta t & 0\\ 0 & 1 & 0 & \Delta t\\ 0 & 0 & 1 & 0\\ 0 & 0 & 0 & 1 \end{bmatrix} \] - プロセスノイズ共分散:\(\mathbf{Q}\)(加速度不確かさに依存) 2. **測定モデル** - レーダーは距離 \(r\) と方位角 \(\theta\) を返します。 - 測定ベクトル:\(\mathbf{z}_k = [r_k,\; \theta_k]^T\) - 観測行列: \[ \mathbf{H} = \begin{bmatrix} \dfrac{x}{\sqrt{x^2+y^2}} & \dfrac{y}{\sqrt{x^2+y^2}} & 0 & 0\\[4pt] -\dfrac{y}{x^2+y^2} & \dfrac{x}{x^2+y^2} & 0 & 0 \end{bmatrix} \] - 測定ノイズ共分散:\(\mathbf{R}\) 3. **カルマンフィルタの手順** - *予測* \[ \hat{\mathbf{x}}_{k|k-1}= \mathbf{F}\,\hat{\mathbf{x}}_{k-1|k-1} \] \[ \mathbf{P}_{k|k-1}= \mathbf{F}\,\mathbf{P}_{k-1|k-1}\,\mathbf{F}^T + \mathbf{Q} \] - *更新* イノベーション(残差)を計算: \[ \mathbf{y}_k = \mathbf{z}_k - h(\hat{\mathbf{x}}_{k|k-1}) \] イノベーション共分散: \[ \mathbf{S}_k = \mathbf{H}\,\mathbf{P}_{k|k-1}\,\mathbf{H}^T + \mathbf{R} \] カルマンゲイン: \[ \mathbf{K}_k = \mathbf{P}_{k|k-1}\,\mathbf{H}^T\,\mathbf{S}_k^{-1} \] 更新された状態と共分散: \[ \hat{\mathbf{x}}_{k|k}= \hat{\mathbf{x}}_{k|k-1}+ \mathbf{K}_k\,\mathbf{y}_k \] \[ \mathbf{P}_{k|k}= (\mathbf{I}-\mathbf{K}_k\,\mathbf{H})\,\mathbf{P}_{k|k-1} \] 4. **実装のヒント** - レーダー測定関数が非線形の場合は、線形化したモデル(拡張カルマンフィルタ)を使用します。 - 追跡が失われた際には、頻繁にフィルタを再初期化してください。 - \(\mathbf{Q}\) と \(\mathbf{R}\) を実際のセンサーノイズ特性に合わせて調整します。 5. **結果の解釈** - 追加測定が増えるにつれて、推定位置は真軌道に収束します。 - フィルタが十分なデータを蓄積し不確実性が減少すると、速度推定も改善されます。 これらの手順に従えば、シンプルなレーダー測定値でもカルマンフィルタで処理でき、物体運動の正確かつリアルタイムな追跡を実現できます。

## Japanese Translation: カルマンフィルタは、測定ノイズとプロセスノイズが存在する状況でシステムの状態を予測し修正する最適な再帰推定器です。単純な一次元レーダートラッキング例では、状態ベクトル \(x=[r;\;v]\) が距離と速度を表します。初期時刻 \(t_0\) での測定値(\(r=10\,000 \text{ m}, v=200 \text{ m/s}\))から、フィルタは一定速度モデルを用いて次状態を予測します(\(\Delta t = 5\,\text{s}\)): \(x_{1|0}=F x_{0|0}=[11\,000;\;200]\)。 予測された共分散行列は、遷移行列 \(F\) と必要に応じてプロセスノイズ \(Q=\sigma_a^2\begin{bmatrix}\frac{\Delta t^4}{4}&\frac{\Delta t^3}{2}\\ \frac{\Delta t^3}{2}&\Delta t^2\end{bmatrix} = \begin{bmatrix}6.25&2.5\\ 2.5&1\end{bmatrix}\) によって更新され、\(P_{1|0}=28.5,\;3.75;\;3.75,\;1.25\) となります。 時刻 \(t_1\) での第二測定値(\(r=11\,020 \text{ m}, v=202 \text{ m/s}\))、共分散行列 \(R_1=\begin{bmatrix}36&0\\0&2.25\end{bmatrix}\)は、カルマンゲイン \(K_1=P_{1|0}(P_{1|0}+R_1)^{-1}= \begin{bmatrix}0.4048&0.6377\\0.0399&0.3144\end{bmatrix}\) を通じて組み込まれます。 更新された状態は \(x_{1|1}=[11\,009.37;\;201.43]\)、共分散行列は \(P_{1|1}=(I-K_1)P_{1|0}= \begin{bmatrix}14.57&1.43\\1.43&0.71\end{bmatrix}\) となり、事前予測と測定の不確実性に比べて減少します。 フィルタは次に \(t_2\) に再び予測します:\(x_{2|1}=F x_{1|1}=[12\,016.5;\;201.43]\)、共分散行列 \(P_{2|1}=F P_{1|1} F^T + Q = \begin{bmatrix}52.86&7.47\\7.47&1.71\end{bmatrix}\)。 この簡潔な説明は、すべての重要な定量的詳細を保持し、予測‑更新サイクルを示し、カルマンフィルタが不確実性をどのように減少させるかを強調しています。基本的な線形代数と推定概念に精通した読者には明瞭であり、不必要な専門用語は避けています。

私、macOS XをNintendo Wiiにポート(移植)いたしました。 | そっか~ニュース