RK3588 のデプロイ(Rockchip NPU)

RK3588 は現在サポートされている唯一の ARM プラットフォームです。オンボードの 6 TOPS NPU で AI 検出をハードウェアアクセラレーションし、VPU で複数系統の映像をハードウェアデコードします。低消費電力で独立 GPU も不要なため、常時稼働の低消費電力な小型ボックスを求めるユーザーに最適です。⚠ ハードウェアの要件は x86 より高く、ベンダー BSP カーネルを備え、デバイスノードが揃った RK3588 ボードが必須です。現段階では 4GB メモリのボードを推奨し、8GB 以上は実験的な位置づけです。

1. 対応機種とハードウェア要件

よく使われるボードには Orange Pi 5 / 5 Plus、Radxa Rock 5A / 5B、firefly などの RK3588 / RK3588S 開発ボードがあります。ハードウェアの要件は x86 より高く、下表を必ず満たす必要があります:

項目	要件
SoC	RK3588 / RK3588S(6 TOPS NPU)
メモリ	4GB(推奨、安定性を十分に検証済み);8GB / 16GB は現在実験的(下記の警告を参照)
システム	ベンダー BSP カーネル——Armbian(vendor kernel を選択)/ 公式 Rockchip / ボードメーカー製システム;vanilla Debian / Ubuntu メインラインカーネルは使用不可
ストレージ	システムディスク / eMMC ≥ 16GB;録画は別途 NVMe または大容量ディスクのマウントを推奨
デバイスノード	/dev/dri、/dev/dma_heap、/dev/rga、/dev/mpp_service がすべて揃っていること

>4GB メモリは現在実験的です

8GB / 16GB ボードでは、一部の BSP カーネル上で AI 検出の負荷がかかると、RGA 関連のカーネルパニックによるマシン全体の再起動が発生します(根本原因は RK3588 の 4GB 物理アドレスライン以上におけるカーネルバグで、現在修正中です)。現段階では 4GB ボードを優先してください——安定性が十分に検証されています。すでに 8G / 16G ボードをお持ちの方は、まずは少数のカメラのみで運用するか、修正版をお待ちください。

ベンダー BSP カーネルが必須です

RK3588 の NPU(rknpu)、ハードウェアデコード(MPP)、2D アクセラレーション(RGA)のドライバは Rockchip BSP カーネルにのみ含まれます。vanilla Debian / Ubuntu メインラインカーネルにはこれらのドライバが含まれず、SkyView をインストールしても NPU を利用できません。Armbian(vendor kernel 版のイメージを選択)をフラッシュするか、ボードメーカー公式のシステムをご利用ください。

完成品 NAS / アプライアンスは慎重に

一部の完成品 NAS はロックされたファームウェアで BSP が削られていたり、デバイスノードが欠けていたり、カーネルパラメータの変更が許可されていなかったりするため、インストールできない、または不安定になる場合があります。オープンな開発ボード用システム(Orange Pi / Radxa / firefly の公式イメージまたは Armbian)を優先してください。

2. 事前チェック:デバイスノードが揃っているか

SSH でボードに入り、NPU / ハードウェアデコード / RGA のデバイスノードがすべて存在することを確認します(ワンクリックスクリプトは自動でチェックしますが、手動デプロイの場合は必ず先に確認してください):

bash

for d in /dev/dri /dev/dma_heap /dev/rga /dev/mpp_service; do
  [ -e "$d" ] && echo "OK  $d" || echo "缺  $d"
done
cat /sys/kernel/debug/rknpu/version 2>/dev/null || echo "无 rknpu 驱动"

すべて OK かつ rknpu にバージョン番号が表示されれば、BSP カーネルは正常で、そのままインストールを進められます。「缺」(不足)や「无 rknpu 驱动」(rknpu ドライバなし)が表示された場合は、カーネルが削られているか BSP カーネルではないので、先にシステムを入れ替えてから再度お試しください。

3. docker のインストール

bash

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# 注销重登让 docker 组生效;或临时 newgrp docker

4. ワンクリックスクリプトによるデプロイ(推奨)

SkyView のワンクリックスクリプトは、RK3588 を自動判別し、rknn バリアントを選択し、デバイスノードを事前チェックし、イメージを取得してコンテナを起動します。5〜15 分で完了します:

bash

curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash

スクリプトが完了すると、ブラウザのアクセスアドレス(http://192.168.1.10:23406/ のようなもの)が直接表示されます。そこにアクセスしてセットアップウィザードに入り、データベースの作成 + 管理者の作成 + 最初のカメラの追加を行います。

5. あるいは手動で compose

設定を自分で管理したい場合は、RK3588 専用の compose テンプレートを使用します(5 つのデバイスノード + /sys の読み取り専用 + ハードウェア指紋のマウントが設定済み;ARM には DMI がないため、x86 版の product_uuid はマウントしません):

RK3588 compose テンプレートをダウンロード

必ず compose.yml として保存してください —— Web 管理画面のオンラインアップグレードは、この固定ファイル名で場所を特定します

compose.yml

または SSH で wget を使って取得してから起動します:

bash

mkdir -p ~/yunkan && cd ~/yunkan
wget https://yun-kan.com/compose/rknn.yml -O compose.yml
docker compose -f compose.yml up -d

一部のカーネルには /dev/rk_dma_heap がありません

一部の BSP カーネルには Rockchip 専用の /dev/rk_dma_heap ノードがありません(汎用の /dev/dma_heap で十分です)。docker compose up が no such file or directory: /dev/rk_dma_heap というエラーを出す場合は、compose 内の - /dev/rk_dma_heap:/dev/rk_dma_heap の行をコメントアウトしてから起動してください。

起動後、ブラウザで http://<板子IP>:23406/ を開きセットアップウィザードに入ります。

6. よくある問題

稼働中にマシン全体が再起動 / フリーズする

おそらく >4GB メモリボードが引き起こす RGA カーネルパニックです(上記「ハードウェア要件」を参照)。現段階の対処法:4GB ボードに交換する、またはまずカメラを 1〜2 系統だけにして、AI 検出内の負荷の重い機能をオフにします。この問題は現在、根本から修正を進めています。

検出が「AI 認識の有効化待ち」のまま表示される

多くの場合、デバイスノードの欠落(カーネルが削られている / BSP カーネルではない)か、rknn バリアントとしてインストールされていないことが原因です。ステップ 2 に戻ってデバイスノードのチェックを再実行し、コンテナが yunkan-rknn イメージを使用していることを確認してください。

アップグレード:Web 管理画面 → 設定 → システム → 更新を確認でワンクリックアップグレード;または SSH で cd ~/yunkan && docker compose -f compose.yml pull && docker compose -f compose.yml up -d。