px4_drv - Unofficial Linux / Windows (WinUSB) driver for PLEX PX4/PX5/PX-MLT series ISDB-T/S receivers

PLEX や e-Better から発売された各種 ISDB-T/S チューナー向けの chardev 版非公式 Linux ドライバ / Windows (WinUSB) ドライバです。
PLEX 社の Webサイトにて配布されている公式ドライバとは別物です。

このフォークについて

本家 nns779/px4_drv は 2021 年以降メンテナンスされておらず、残念ながら nns779 氏自身もネット上から失踪されています。
このフォークは、各々のフォークに散逸していた有用な変更を一つにまとめ、継続的にメンテナンスしていくことを目的としています。

変更点 (WinUSB 版)

エラー発生時の MessageBox を表示しない設定を追加
- BonDriver の ini 内の DisplayErrorMessage を 1 に設定すると今まで通り MessageBox が表示される
hendecarows 氏のフォークでの更新を取り込み、DTV02A-1T1S-U / PX-M1UR / PX-S1UR に対応
PX-Q3PE5 の inf ファイルを追加
inf ファイルをより分かりやすい名前に変更
inf ファイルを ARM 版 Windows でもインストールできるようにする
- 実機がないので試せていないけど、おそらくインストールできるはず
- ref: https://mevius.5ch.net/test/read.cgi/avi/1625673548/762
inf ファイルを改善し、チューナーをタスクトレイの「ハードウェアの安全な取り外し」に表示しないようにする
- ref: https://mevius.5ch.net/test/read.cgi/avi/1666581918/207
inf ファイルに自己署名を行い、自己署名証明書のインストールだけで正式なドライバーと認識されるように
- 以前は署名がないためインストール時にドライバー署名の強制の無効化が必要だったが、事前に自己署名証明書を適切な証明書ストアにインストールしておけばこの作業が不要になる
- ref: https://mevius.5ch.net/test/read.cgi/avi/1577466040/104-108
自己署名証明書のインストール・アンインストールスクリプトを追加
- 拡張子が .jse となっているが、これは PowerShell スクリプトにダブルクリックで実行させるための JScript コードを先頭の行に加えたもの
- 実際に表示されないかは今のところ未確認
地上波の ChSet に物理 53ch ～ 62ch の定義を追加
- 物理 53ch ～ 62ch は地上波の割り当て周波数から削除されているが、現在も ”イッツコムch10” など、一部ケーブルテレビの自主放送の割り当て周波数として使われている
BS/CS の ChSet に2022年3月開局の BS 新チャンネル（BS松竹東急・BSJapanext・BSよしもと）の定義を追加
バージョン情報が DLL のプロパティに表示されないのを修正
ビルドとパッケージングを全自動で行うスクリプトを追加
- Visual Studio 2019 が入っていれば、build.ps1 を実行するだけで全自動でビルドからパッケージングまで行える
README（このページ）に WinUSB 版のインストール方法などを追記

変更点 (Linux 版)

動作確認は Ubuntu 20.04 LTS (x64) で行っています。

チップ構成が一部変更された、ロット番号 2309 (2023年9月) 以降の DTV02A-1T1S-U に対応
otya 氏のフォークでの更新を取り込み、安定性と互換性を改善
techmadot 氏のフォークの内容を取り込み、PX-M1UR / PX-S1UR に対応
kznrluk 氏のフォークの内容を取り込み、Linux カーネル 6.4 系以降の API 変更に対応
https://github.com/tsukumijima/px4_drv/pull/6 をマージし、Linux カーネル 6.8 系以降の API 変更に対応
https://github.com/tsukumijima/px4_drv/pull/3 をマージし、ctrl_timeout をモジュールパラメーターに追加
Debian パッケージ (.deb) の作成とインストールに対応
DKMS でのインストール時にファームウェアを自動でインストールするように変更
README (このページ) に Debian パッケージからのインストール方法などを追記

対応デバイス

PLEX
- PX-W3U4
- PX-Q3U4
- PX-W3PE4
- PX-Q3PE4
- PX-W3PE5
- PX-Q3PE5
- PX-MLT5PE
- PX-MLT8PE
- PX-M1UR
- PX-S1UR
e-Better
- DTV02-1T1S-U (実験的)
- DTV02A-1T1S-U
  - チップ構成が一部変更された、ロット番号 2309 (2023年9月) 以降の DTV02A-1T1S-U にも対応しています。
    手元の実機では問題なく動作していますが、長期間の動作テストは行えていないため、未知の不具合があるかもしれません。
- DTV02A-4TS-P

[!NOTE] 2021 年以降メンテナンスされていない nns779/px4_drv と異なり、新規に下記チューナーのサポートを追加しています。

PLEX PX-M1UR

PLEX PX-S1UR

e-Better DTV02A-1T1S-U / Digibest ISDB2056 (Windows 版ドライバ)

e-Better DTV02A-1T1S-U (ロット番号 2309 以降) / Digibest ISDB2056N

インストール (Windows)

Windows (WinUSB) 版のドライバは、OS にチューナーを認識させるための inf ファイルと、px4_drv 専用の BonDriver、ドライバの実体でチューナー操作を司る DriverHost_PX4 から構成されています。

ビルド済みのアーカイブはこちらからダウンロードできます。
または、winusb フォルダにある build.ps1 を実行して、ご自分でビルドしたものを使うこともできます (Visual Studio 2019 が必要です) 。

1. 自己署名証明書のインストール

Driver フォルダには、各機種ごとのドライバのインストールファイル (.inf) が配置されています。
ドライバをインストールする前に cert-install.jse を実行し、自己署名証明書をインストールしてください。

自己署名証明書をインストールして信頼することで、自己署名証明書を使用して署名されたドライバも、（自己署名証明書をアンインストールするまでは）通常の署名付きドライバと同様に信頼されるようになります。

2. ドライバのインストール

自己署名証明書をインストールしたあとは、公式ドライバと同様の手順でインストールできると思います（公式ドライバは事前にアンインストールしてください）。

具体的には、デバイスマネージャーからチューナーデバイスを選択し、右クリックメニューの [ドライバーの更新] → [コンピューターを参照してドライバーを検索] から、inf ファイルが入っている Driver フォルダを指定してください。[ドライバーが正常に更新されました] と表示されていれば OK です。

3. BonDriver の配置

チューナーの機種に応じた BonDriver を配置します。

PX4/PX5 シリーズの機種: BonDriver_PX4
PX-MLT シリーズの機種・DTV02A-4TS-P: BonDriver_PX-MLT
DTV02A-1T1S-U: BonDriver_ISDB2056
DTV02A-1T1S-U (ロット番号 2309 以降): BonDriver_ISDB2056N
PX-M1UR: BonDriver_PX-M1UR
PX-S1UR: BonDriver_PX-S1UR

お使いの PC に合うビット数のフォルダの中のファイルをすべて選択し、TVTest や EDCB などのソフトウェアが指定する BonDriver の配置フォルダにコピーします。
BonDriver と同じフォルダに DriverHost_PX4.exe / DriverHost_PX4.ini / it930x-firmware.bin があることを確認してください。

使用にあたり、特段 ini ファイルの設定変更などは必要ありません。ソフトウェアごとにチャンネルスキャンを行えばそのまま視聴できます。
なお、BonDriver の ini ファイル内の DisplayErrorMessage を 1 に設定すると、オリジナル同様にエラー発生時にメッセージボックスを表示します。

インストール (Linux)

1. ファームウェアの抽出とインストール (手動インストール時のみ)

[!IMPORTANT]
px4_drv を Debian パッケージや DKMS を使用してインストールする際、ファームウェアは自動的にインストールされます。
Debian パッケージや DKMS を使用してインストールを行う場合は、この手順をスキップしてください。

事前に unzip, gcc, make がインストールされている必要があります。

$ cd fwtool
$ make
$ wget http://plex-net.co.jp/plex/pxw3u4/pxw3u4_BDA_ver1x64.zip -O pxw3u4_BDA_ver1x64.zip
$ unzip -oj pxw3u4_BDA_ver1x64.zip pxw3u4_BDA_ver1x64/PXW3U4.sys && rm pxw3u4_BDA_ver1x64.zip
$ ./fwtool PXW3U4.sys it930x-firmware.bin && rm PXW3U4.sys
$ sudo mkdir -p /lib/firmware && sudo cp it930x-firmware.bin /lib/firmware/
$ cd ../

または、抽出済みのファームウェアを利用することもできます。

$ sudo mkdir -p /lib/firmware && sudo cp ./etc/it930x-firmware.bin /lib/firmware/

2. ドライバのインストール

一部の Linux ディストリビューションでは、別途 udev のインストールが必要になる場合があります。

Debian パッケージを使用してインストール (強く推奨)

Debian パッケージを使用してインストールすると依存パッケージも自動インストールされるほか、DKMS のソースコード管理も透過的に行われます。
Ubuntu / Debian 環境では Debian パッケージを使用してインストールすることを強く推奨します。

$ wget https://github.com/tsukumijima/px4_drv/releases/download/v0.5.1/px4-drv-dkms_0.5.1_all.deb
$ sudo apt install -y ./px4-drv-dkms_0.5.1_all.deb

上記コマンドで、px4_drv の Debian パッケージをインストールできます。

[!TIP] 手動で Debian パッケージを生成することもできます。
./build_deb.sh を実行すると、./build_deb.sh の一つ上層のディレクトリに px4-drv-dkms_0.5.1_all.deb という名前の Debian パッケージが生成されます。
$ ./build_deb.sh
$ sudo apt install -y ../px4-drv-dkms_0.5.1_all.deb
上記コマンドで、生成した px4_drv の Debian パッケージをインストールできます。

DKMS を使用してインストールする

gcc, make, カーネルソース/ヘッダ, dkms がインストールされている必要があります。

$ sudo cp -a ./ /usr/src/px4_drv-0.5.1
$ sudo dkms add px4_drv/0.5.1
$ sudo dkms install px4_drv/0.5.1

DKMS を使用せずにインストールする

事前に gcc, make, カーネルソース/ヘッダがインストールされている必要があります。

[!WARNING]
DKMS を使用せずにインストールした場合、カーネルのアップデート時にドライバが自動で再ビルドされないため、アップデート後に再度インストールを行う必要があります。
可能な限り DKMS を使用してインストールすることをおすすめします。

$ cd driver
$ make
$ sudo make install
$ cd ../

3. 確認

3.1 カーネルモジュールのロードの確認

下記のコマンドを実行し、px4_drv から始まる行が表示されれば、カーネルモジュールが正常にロードされています。

$ lsmod | grep -e ^px4_drv
px4_drv                81920  0

何も表示されない場合は、下記のコマンドでカーネルモジュールを明示的にロードしてから、再度上記のコマンドを実行して確認を行ってください。

$ sudo modprobe px4_drv

それでもカーネルモジュールが正常にロードされない場合は、インストールから再度やり直してください。

[!IMPORTANT]
px4_drv や Linux カーネルの更新後、px4_drv は自動再ロードされない場合があります。
px4_drv や Linux カーネルを更新した際は、可能な限りすぐに PC を再起動することを強く推奨します。
すぐに再起動ができない状況では、必ず sudo modprobe px4_drv を実行してください。
(当然ですが、録画予約のある時間帯に px4_drv や Linux カーネルを更新するべきではありません。)

3.2 デバイスファイルの確認

インストールに成功し、カーネルモジュールがロードされた状態でデバイスが接続されると、/dev/ 以下にデバイスファイルが作成されます。
下記のようなコマンドで確認できます。

PLEX PX-W3U4/W3PE4/W3PE5 を接続した場合

$ ls /dev/px4video*
/dev/px4video0  /dev/px4video1  /dev/px4video2  /dev/px4video3

チューナーは、px4video0 から ISDB-S, ISDB-S, ISDB-T, ISDB-T というように、SとTが2つずつ交互に割り当てられます。

PLEX PX-Q3U4/Q3PE4/Q3PE5 を接続した場合

$ ls /dev/px4video*
/dev/px4video0  /dev/px4video2  /dev/px4video4  /dev/px4video6
/dev/px4video1  /dev/px4video3  /dev/px4video5  /dev/px4video7

チューナーは、px4video0 から ISDB-S, ISDB-S, ISDB-T, ISDB-T, ISDB-S, ISDB-S, ISDB-T, ISDB-T というように、S と T が2つずつ交互に割り当てられます。