私は 80 ドルで入手した RK3562 アンドロイドタブレットを、Debian リンックス上の作業環境として再利用するプロジェクトを立ち上げました。

rkdebian — Doogee U10（RK3562）向け Debian 12

事前リリースイメージのダウンロード

現在バージョン（パブリックビルド、予備公開：2026 年 5 月 14 日）

• リリースページ: tech4bot/rk3562deb (pre-release-14052026)
• 直接的なイメージダウンロード:

  rk3562-debian.img.xz

• デモビデオ: YouTube

Doogee U10 タブレット上で完全な Debian 12 Bookworm を動作させることができます。ブートローダーのアンロックは不要です。SD カードから起動させ、必要であれば SD カードを抜くと通常の Android に復帰します。内部ストレージに変更は一切行いません。

ゼロからリバースエンジニアリングされたものであり、BSP（ボードサポートパッケージ）、ベンダーのドキュメント、公式サポートはありません。 構築には Claude、Codex、および Antigravity（Google Gemini）の支援を受けました。Firefly RK3562 オープンソースリポジトリを起点としています。

概要

rkdebian は、Rockchip RK3562 SoC で動作する Doogee U10 Android タブレット向けの完全で起動可能な Debian 12 Bookworm イメージを生成するビルドシステムです。 生成されたイメージは SD カードに書き込まれます。これを挿入して電源を入れるとタブレットが Debian を起動し、SD カードを抜けば内部 eMMC から通常の通り Android が起動します。

ハードウェア：Doogee U10

動作機能一覧

rk-flashlightctl

標準インストールされたアプリ

RKDEBIAN_PREINSTALL_FREETUBE=0

kgx

gnome-terminal

NPU LLM (RK3562)

このタブレットイメージでは、Rockchip の RKLLM ス tack を使用して RK3562 NPU 上でのローカル LLM 推論をサポートしています。

使用されている NPU ソフトウェア

• airockchip/rknn-llm

  — ランタイム、RKLLM ツールキット、デモアプリ (llm_demo)

• airockchip/rknn-toolkit2

  — RKLLM ワークフローで使用される RKNN 変換/ツールチェーン依存项

使用されたモデル変換設定

• ターゲットプラットフォーム: rk3562
• クオンタイゼーション: W8A8
• NPU コア数: num_npu_core=1 (RK3562 は 1 コアのみサポート)
• 最適化レベル: 0（このボードでの互換性・安定性を考慮して選択）

ホスト PC での例の変換コマンド:

python3 convert_qwen_rk3562.py \
  --model-dir ./models/Qwen3-0.6B \
  --target-platform rk3562 \
  --quantized-dtype W8A8 \
  --optimization-level 0 \
  --num-npu-core 1 \
  --output ./out/Qwen3-0.6B_W8A8_RK3562_opt0.rkllm

ベンチマーク（タブレット上で、NPU パス） 2026 年 4 月 6 日に

<tablet-ip>

• プロンプト: "Exactly 300 English words about arithmetic speed testing do not include punctuation and do not stop early" を出力
• MAX_NEW_TOKENS=64, MAX_CONTEXT_LEN=1024
• ランナー:

  ~/npu-test/xcompile/demo_Linux_aarch64/run_llm_rk3562.sh

使用コマンド:

# Qwen3-0.6B (最初の実行には fix_freq が含まれる)
USE_FIX_FREQ=1 RKLLM_LOG_LEVEL=1 PROMPT="Output exactly 300 English words about arithmetic speed testing do not include punctuation and do not stop early" \
  ./run_llm_rk3562.sh ~/npu-test/models/Qwen3-0.6B_W8A8_RK3562_opt0.rkllm 64 1024

# Qwen2.5-1.5B
USE_FIX_FREQ=0 RKLLM_LOG_LEVEL=1 PROMPT="Output exactly 300 English words about arithmetic speed testing do not include punctuation and do not stop early" \
  ./run_llm_rk3562.sh ~/npu-test/models/Qwen2.5-1.5B-Instruct_W8A8_RK3562.rkllm 64 1024

結果: RK3562 タブレット上でのローカル NPU 推論において、Qwen3-0.6B は Qwen2.5-1.5B に比べて大幅に高速です。

既知の問題点

• タブレットを数時間電源オフにした後にバッテリー表示が 0% になる場合があります。

  rk-battery-gauge-fix.service

  が起動時にこれを修正します。タブレットが完全に電源オフになっていない場合は一度再起動してください。次の起動時にバッテリー残量は修正されます。
• フロント (s5k5e8) とリヤ (s5k4h5yb) カメラのプレビュー/キャプチャは機能していますが、色が少しずれており、追加の ISP 較正が必要です。

要件

ホストマシン: x86-64 Linux（Debian/Ubuntu が推奨） ビルド依存関係をすべてインストールするには：

sudo apt-get install \
  git make gcc-aarch64-linux-gnu bc bison flex device-tree-compiler \
  genimage wget tar mtools xz-utils debootstrap qemu-user-static e2fsprogs

ビルド

フルビルド（推奨）

U-Boot、カーネル、Debian ルートファイルシステムを構築し、即座にフラッシュできる SD カードイメージを生成します：

ログをファイルへ出力しつつ (tee)、実際のビルド終了状態を保持するには：

set -o pipefail
./build.sh all 2>&1 | tee build.log

./build.sh

all

最終的なイメージは以下の場所に書き込まれます：

• out/rk3562-debian.img.xz

  — 圧縮された最終イメージ（推奨）

• output/update/update.img.xz

  — Firefly 互換パス用の圧縮イメージ

互換性/生画像も保持されます：

• out/rk3562-debian.img

• output/update/update.img

CLI の使用法とオプション

./build.sh [options] {check|lunch|uboot|extboot|updateimg|updatepkg|compile|rootfs|image|all}

--ui-session

--gpu-stack

--display-server

--cpu-governor

--force-clean-rootfs

RKDEBIAN_FORCE_CLEAN_ROOTFS=1

--no-force-clean-rootfs

-h, --help

インディビジュアル ビルドターゲット

./build.sh check

./build.sh lunch

./build.sh uboot

./build.sh extboot

./build.sh rootfs

./build.sh compile

./build.sh image

./build.sh updateimg

./build.sh updatepkg

out/rootfs

out/boot/*

output/update/update.tar.gz

./build.sh all

image

updatepkg

out/rootfs

環境変数

これらの変数は

build.sh

ルート FS (Rootfs)

RKDEBIAN_FORCE_CLEAN_ROOTFS

ROOTFS_IMAGE_SIZE

ROOTFS_HEADROOM_MB

ROOTFS_MIN_MB

RKDEBIAN_DISPLAY_SERVER

RKDEBIAN_UI_SESSION

RKDEBIAN_GPU_STACK

RKDEBIAN_CPU_GOVERNOR

RKDEBIAN_MALI_GBM_PROVIDER

RKDEBIAN_PREINSTALL_FREETUBE

RKDEBIAN_MINIMIZE_IMAGE

カーネル

RKDEBIAN_MAKE_THREADS

RKDEBIAN_KEEP_OVERLAY_PMIC_PATCHES

rk808.c

rk817_battery.c

rk817_charger.c

例

• クリーンなルート FS の再構築を強制：

  RKDEBIAN_FORCE_CLEAN_ROOTFS=1 ./build.sh all
  # CLI フラグを使用する場合も同様
  ./build.sh all --force-clean-rootfs
  

• 固定された 4 GB ルート FS パーティションでのクリーン再構築を強制：

  RKDEBIAN_FORCE_CLEAN_ROOTFS=1 ROOTFS_IMAGE_SIZE=4G ./build.sh all
  

• ルート FS のみビルド、クリーン強制：

  RKDEBIAN_FORCE_CLEAN_ROOTFS=1 ./build.sh rootfs
  

• イメージのみ再構築（U-Boot とカーネルは既に構築済み）：

  ./build.sh image
  

• カーネルのみのビルド：

  ./build.sh extboot
  

• カーネルビルド中にオーバーレイ PMIC パッチを保持：

  RKDEBIAN_KEEP_OVERLAY_PMIC_PATCHES=1 ./build.sh extboot
  

• テスト用 Wayland デスクトップイメージを強制生成：

  ./build.sh all --display-server=wayland
  

• 明示的にクリーン強制を無効化（スクリプト実行などで有用）：

  ./build.sh all --no-force-clean-rootfs
  

• Phosh バランスモードマッピングに使用するベースライン Governor をオーバーライド：

  RKDEBIAN_CPU_GOVERNOR=schedutil ./build.sh all
  

• CLI の使用方法とターゲットリストを表示：

  ./build.sh --help
  

• Mesa/Panfrost 上の Phosh イメージを構築（クリーンルート FS を強く推奨）：

  ./build.sh all --ui-session=phosh --gpu-stack=panfrost --force-clean-rootfs
  

• Debian libgbm オーバーライドを使用した Mali スタック（互換性テスト用のみ）：

  RKDEBIAN_MALI_GBM_PROVIDER=debian ./build.sh all --ui-session=phosh --gpu-stack=mali --force-clean-rootfs
  

• GitHub アップロードが容易なサイズ重視のビルド：

  RKDEBIAN_FORCE_CLEAN_ROOTFS=1 RKDEBIAN_MINIMIZE_IMAGE=1 RKDEBIAN_PREINSTALL_FREETUBE=0 ./build.sh all
  

• デフォルト FreeTube プリインストールを有効にしたままのサイズ重視ビルド：

  RKDEBIAN_FORCE_CLEAN_ROOTFS=1 RKDEBIAN_MINIMIZE_IMAGE=1 RKDEBIAN_PREINSTALL_FREETUBE=1 ./build.sh all
  

RKDEBIAN_UI_SESSION

RKDEBIAN_GPU_STACK

--force-clean-rootfs

Phosh パワーモードマッピング

イメージには

rk-power-profile-sync.service

power-profiles-daemon

• balanced ->

  RKDEBIAN_CPU_GOVERNOR

  の Governor（デフォルト performance）、最大周波数キャップ 100%
• power-saver -> Governor powersave、最大周波数キャップ 65%
• performance (ハードウェアで公開されている場合) -> Governor performance、最大周頻度キャップ 100%

マッピングは

/etc/default/rk-power-profile-map

Phosh UX 統合

• リヤカメラフラットライトは

  LED camera:flash

  として公開され、Phosh がネイティブトップメニューのトーチアイコンを表示します。

• rk-flashlightctl

  はリヤ LED の切り替えと強度制御（0..100 を設定）をサポートします。

• rk-powerkey-longpress.service

  がハードウェアパワーキーポリシーを管理します：
  • 短押し (<3 秒) -> キーリリース時にスリープ
  • 長押し (>=3 秒) -> スタンダード GNOME シャットダウンダイアログ
  • logind/GNOME の押下トリガーデフォルトは無効化されており、キーダウン時の即時スリープを防ぎます。

ロック画面の方位

ロック画面の方位は最後のアクティブなタブレット方位から保存されるため、タブレットがランドスケープ時でもウェイク/ロック時にポートレートに強制されません。

セーフ Phosh セッションテスト（オンデバイス）

イメージには

rk-session-failsafe.timer

リスキーなセッションテストに再起動する前のロールバック:

sudo install -d /var/lib/rk-session-failsafe
sudo touch /var/lib/rk-session-failsafe/armed
sudo reboot

挙動：

• Phosh が健全な場合、ワトチドは自動で解除され何も行いません。
• セッション起動が失敗した場合、ワトチドは LightDM + Phosh 自動ログインを復元して再起動します。

OTA アップデート（オンデバイス）

タブレットで Debian が動作し始めたら、SD カードの書き換えなしにアップデートを適用できます。ホスト上でアップデートパッケージを構築：

./build.sh all        # または単に ./build.sh image && ./build.sh updatepkg

これにより

output/update/update.tar.gz

/home/chaos/update/

/update/pending/

次の再起動時に、

rk-apply-update

*.tar.gz

*.tgz

/update/update.tar.gz

パッケージアーカイブの挙動:

• 正常に適用されたパッケージは

  /update/applied/

  に移動されます。
• 無効または抽出失敗したパッケージは

  /update/failed/

  に移動されます。
• 既に適用済みパッケージ（同じ SHA-256）は

  /update/duplicate/

  に移動されます。

更新進捗とエラーは

/var/log/rk-update.log

/update/failed/

SD カードへのフラッシュ

成功したビルドの後、圧縮イメージを SD カードにフラッシュします：

# /dev/sdX は SD カードデバイスに置き換えてください（lsblk で確認）
xz -dc out/rk3562-debian.img.xz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync

警告: デバイスパスを必ず二重確認してください。誤ったデバイスに書き込むとデータを上書きします。

Doogee U10 に SD カードを挿入して電源を入れます。Debian が自動的に起動します。SD カードを抜けば Android に復帰できます。

デフォルト認証情報

ビルドシステムは Debian イメージで以下のアカウントを作成します：

最初の起動でこれらを変更してください：

passwd                   # chaos のパスワード変更
sudo passwd root         # root のパスワード変更

イメージレイアウト

SD カードイメージは GPT パーティションテーブルを使用します：

ルート FS パーティションは最初の起動時に自動的に SD カードを埋め尽くすように拡大されます。

ソースツリー

rkdebian/
├── build.sh              # メインビルドエントリポイント
├── build_rootfs.sh       # Debian ルート FS ビルダー (debootstrap + chroot)
├── genimage.cfg          # SD カードイメージパーティションレイアウト
├── extlinux.conf         # ブートローダー設定 (カーネル + DTB)
├── splash.png            # ブートスプラッシュ画面
├── overlay/              # 独自カーネルドライバ、DTS、ファームウェア、サービス、ヘッダー
│   ├── arch/             # デバイストリートソース (DTS/DTSI)
│   ├── drivers/          | アウトオブツリーカーネルドライバ (Wi-Fi EA6621Q, カメラ, PMIC)
│   ├── firmware/         | Wi-Fi ファームウェア blobs (Seekwave EA6621Q)
│   ├── include/          | ビルド時カーネルヘッダーオーバーライド
│   ├── kernel-patches/   | ビルド中に適用されるカーネルパッチ
│   ├── etc/              | オンデバイス設定オーバーライド (logind など)
│   ├── mali-shim.c       | Mali GPU ユーザースペースシャム（ビルド時にコンパイル）
│   └── *.sh / *.service  # オンデバイスセットアップスクリプトおよび systemd ユニット
├── debs/                 # プリビルト .deb パッケージ (Mali GPU, Rockchip MPP)
├── mali/                 | Mali GPU ユーザースペースライブラリ (.so)
├── wifi/                 | Wi-Fi ファームウェア、ベンダー SDK、ポルティングガイド
├── tools/                | オンデバイスカメラキャプチャおよび ISP 診断ツール
├── docs/                 | デザイン仕様およびビルドノート
├── src/                  | クローンされたソース（カーネル、u-boot、rkbin）— ビルドによって充填
├── out/                  # ビルドアーティファクト（カーネル、ルート FS、イメージ）
└── output/update/        # 最終フラッシュ可能イメージ + OTA アップデートパッケージ

カーネル & ブートローダーバージョン

謝辞

このリポジトリに含まれるサードパーティコンポーネント：

• Mali GPU バイナリ:

  debs/

  のプリビルト Mali GPU パッケージおよび

  mali/

  のユーザースペースライブラりは以下のソースから提供されます：
  • christianhaitian/rk3566_core_builds
  • tsukumijima/libmali-rockchip これらのバイナリは各自のプロジェクトのそれぞれの条件下で提供されています。ARM Mali ファームウェアおよびユーザースペースライブラリは固有の ARM IP です。
• Rockchip MPP (Media Process Platform):

  debs/

  の Rockchip MPP パッケージ (

  librockchip-mpp1

  ,

  librockchip-mpp-dev

  ,

  librockchip-vpu0

  ) は

  rockchip-linux/mpp

  からソース取得されます。Rockchip MPP は Apache 2.0 ライセンスの下でライセンスされています。
• Seekwave Wi-Fi / ブルートゥース:

  overlay/drivers/net/wireless/ea6621q/

  の Wi-Fi およびブルートゥースドライバソースおよび

  overlay/firmware/

  および

  wifi/

  のファームウェア blobs は Seekwave Technology Co. Ltd. から提供されます。ドライバはベンダーによって GNU General Public License v2.0 (GPL-2.0) の下でリリースされています。

ライセンス

MIT ライセンス — © 2026 tech4bot このソフトウェアおよび関連するドキュメントファイル（「ソフトウェア」と呼ぶ）の複製を取得するすべての人に、本ソフトウェアを制限なく取り扱う権利、とりわけ使用、複製、変更、統合、出版、配布、サブライセンスおよび/または販売のコピーを行う権利を含むがこれに限定されない、無料で与えることを許可します。供された者に対しても同様です。 上記の著作権表示およびこの許可通知は、ソフトウェアのすべてのコピーまたは実質的な部分に含まれるものとする。 本ソフトウェアは「ありのまま」状態で提供され、商品性に対する保証、特定目的への適合性に対する保証、不法行為に対する保証を含むいかなる種類の明示的または黙示的な保証もなく保証される。著作者および著作権保持者は、契約または不法行為、またはソフトウェアの使用またはその他の取引の前後に生じてもよとも、いかなる請求、損害または他の責任についても一切責任を負わないものとする。 このビルドシステムに含まれるかまたは生成された Linux カーネル、U-Boot、Debian パッケージ、Rockchip rkbin およびサードパーティドライバは、それぞれのアップストリームライセンスを維持します。