Repository navigation
Releases
px4-userland v1.0.0-beta(プレリリース)
px4-userland v1.0.0-beta リリースノート
リリースの位置づけ
本リリースは、SemVerのプレリリース(pre-release)である。安定版 1.0.0 の正式公開ではない。
- リリース名称:
v1.0.0-beta - バイナリの版表示: 配布アーカイブおよび実行バイナリの
--version表示は1.0.0(px4d 1.0.0)である。 - 共通コアライブラリ:
dtv-userland-coreタグv1.0.3(コミット:ba83577710101f9036f11deffeb97464f4212246)にピン留めしている。Core リポジトリ内部の project 定義は1.0.2である(別製品である ASICEN および PIX のデーモン状態表示でもcore_versionとして1.0.2が観測されている)。
ソースおよびビルド情報
- リポジトリ:
Khronos31/px4-userland - 対象コミット:
ce190cc27c28f913b143c6d9ec8464872a9eb3da - GitHub Actions Run ID:
42000859681(push on main、全 10 配布アーカイブおよび source/Core マニフェスト一致確認済み)
検証の前提とスコープ(RC回帰は未実施)
本プレリリースでは、物理操作や環境変更を伴わず HAOS(Home Assistant OS)環境上のみで行える最小限の確認にとどめる方針に基づき、以下の前提を適用している。
- RC回帰試験は未実施である(「RC相当合格」ではない)。
- 検証は、HAOS 環境上でユーザーの物理操作を伴わずに行える最小限の確認にとどめている。
- LNB給電の確認や操作、B-CASカードの抜き差し、アンテナケーブルや機器の入替などの物理操作は実施していない。
- Linux x86_64 以外の他OS(macOS、Windows、Android等)における実機回帰試験は未実施である。
- 長時間ソーク試験(2時間・30分等)および全局RC試験は未実施である。
- L3(レイヤ3統合機能)は含めず、v1.1 へ延期している。また、torne は本リリースの対象外である。
実施した動作確認(HAOS環境)
- 実行環境: HAOS / SCS Debian GNU/Linux 13 (trixie) x86_64(Linux 6.18.52-haos、glibc 2.41)
- 対象バイナリ: 配布候補アーカイブ
px4-userland-1.0.0-linux-glibc-x86_64.tar.gz(SHA-256:1fd512ba1d6d3c40b48be87e736eee41be762395489581c9ae2ecbc385052961)内のpx4d - CLI確認:
px4d --version: 終了コード 0、出力px4d 1.0.0px4d --help: 終了コード 0、使用法表示px4d --list-json: 終了コード 0、PX-Q3U4(sysfs: 1-2.3.1 / 1-2.3.2、receiver 0/1/4/5 ISDB-S、2/3/6/7 ISDB-T)を認識
実機検証結果(既知の問題)
- 対象機器: PX-Q3U4(sysfs: 1-2.3.1 / 1-2.3.2、VID:PID
0511:084a) - ファームウェア:
/config/GitHub/px4_drv/it930x-firmware.bin(SHA-256:5213a5a38872661277a2cc1b2dfdfe88faf06f41205f460f3b51857f0568b484) - 実行結果: デーモン
px4dの起動処理においてdevice 2 initialize: TIMEOUTが発生し、終了コード 5 で終了した。ready 状態に至らず、TS 受信は行われていない。 - 停止後状態: プロセスは終了し、USB ノードのプロセス保持(holder)残留なし(0件)。
- 運用方針: 反復診断や機器の入替等は行わず、既知の問題として本リリースノートに明記している。
既知の問題・注意事項
- PX-Q3U4 においてデーモン起動時に device 2 の初期化タイムアウト(終了コード 5)が発生する既知の問題がある。
- 配布物内のバージョン表記は
1.0.0であるため、将来公開される正式安定版 1.0.0 とファイル名や--version出力が同一となる点に留意すること。
v0.2.1
px4-userland v0.2.1
Windows向けに、チューナー内蔵カードリーダーをB25対応アプリから利用するためのWinSCard互換DLLを追加しました。あわせて、Windowsでの起動処理とTSの連続性エラーの計数を修正しました。
主な変更
- Windows 11 x64向けに、アプリと同じフォルダーへ配置して使用するWinSCard.dllを追加
- 対応APIの範囲で、Windows標準の外付けカードリーダーとの併用に対応
- Windowsで、--runtime-dirを明示してもLOCALAPPDATAの状態によって起動に失敗する問題を修正
- TSの重複パケットと不連続指示の扱いを見直し、CCエラーの誤計数を修正
検証
- Linux・Android/Termux・macOS・Windowsの全9配布バイナリで、PX-Q3U4の短時間実機確認を実施
- Windowsの対象x64構成で、recisdb-rs、EDCB+Multi2Dec/libaribb25、TVTest+CasProcessor/TvCasによるTS復号を確認
- カード抜き差し、USB切断後の復帰、アプリの終了・再起動、外付けカードリーダーとの同時利用を確認。構成ごとの条件と確認範囲は検証記録を参照
既知の制限
v0.2.0
px4-userland v0.2.0
Windows 11 x64(Phase 1)への対応を追加しました。今回の変更は Windows 環境を対象としています。
主な変更
- Windows 11 x64 に対応(Phase 1)
- 対象機器は事前に WinUSB へ bind して使用
- 内蔵カードリーダーは独自 IPC(px4ctl 等)で利用可能。WinSCard(PC/SC)経由の利用は Phase 2 で対応予定
検証
- 配布 binary 9 種で PX-Q3U4 の受信、内蔵カード、カード/USB 抜き差しからの復旧を実機確認
- Windows では PX-M1UR / PX-S1UR も実機確認。環境別の詳細は検証記録と README を参照
- 配布物は tag
v0.2.0(commitdcd663c)の CI 生成物を提供。実行ファイル・ライブラリは実機試験済み build(8c40d49)とバイト一致(差分は文書と metadata のみ、manifest.jsonのsource_refはdcd663c)
既知の制限
v0.1.10
px4-userland v0.1.10
選局とUSB切断時の処理を修正し、mirakcのチャンネル表記を指定できる--channelを追加しました。
主な変更
px4-ts --channelで地上波・BS・CSのチャンネル表記を受け付ける- PX-M1URなどの単一受信機系で、衛星放送のslot/TSID選択と地上波lock後の待機を修正
- Q3系の衛星TSID選択の期限処理、USB切断後のfrontend・電源状態の失効を修正
- 共通TS受信処理でpump threadの終了を待ち、thread寿命と後始末を修正
検証
- 配布binary 8種でPX-Q3U4の受信、内蔵カード、カード抜差し、USB再接続後の復旧を実機確認
- PX-M1UR/PX-S1URをLinuxで追加確認。機種・環境別の判定は検証記録を参照
- 今回のsoakは省略
既知の制限
- PX-Q3U4のreceiver 7でTEI/continuity errorのburstが発生する既知不具合を継続。Issue #1
- macOSではUSB再接続後にreceiver 0〜3のCC異常を1回観測。追加の固定20回では未再現だが、原因は未解明
- USB再接続後の復旧にはdaemonの再起動が必要
- DTV02A-5TS-P / MLT5 profileは共通受信処理の変更により過去のstream実機認定を継承できず、v0.1.10では未再検証。READMEの既存記録は今回版の認定を意味しない。同機材をお持ちの方には再検証へのご協力をお願いしたい
- MLT5系の切断通知と、受信中の機器列挙の
invalid_serial事象は継続。Issue #47、Issue #48
謝辞
選局処理の改善にご協力いただいた5ymさん、問題の報告と調査にご協力いただいた皆さんに感謝します。
v0.1.9
px4-userland v0.1.9
px4d への --list-json の追加、同一シリアルを持つ機器(PX-M1UR / PX-S1UR 等)の衝突対策と接続位置指定の導入、および LNB 15V 非対応機種に対する能力表示と要求拒否の整理を行った Stable リリースです。
主な変更
- JSON 形式の機器列挙オプション(
--list-json)の追加: 接続機器、USB 位置、受信機一覧、LNB 15V 給電能力、シリアルの一意性などの情報を単一の JSON オブジェクトで出力するpx4d --list-jsonを追加。従来のテキスト形式px4d --listは今後非推奨(deprecated)となる予定だが、現時点でも引き続き利用可能。 - 同一シリアル機器の衝突防止と接続位置指定の導入: PX-M1UR と PX-S1UR など同一シリアルを持つ機器が同時に接続された場合、曖昧なシリアル単独指定(
--device)を安全に拒否するよう変更。USB位置による指定(--usb-path)と、ランタイムソケット識別用のトークン指定(--instance)を導入(同一シリアル重複時の個別起動や同時運用は未認定)。 - LNB 15V 非対応機種の能力表示と要求拒否: PX-M1UR などの非対応機種について、機器列挙で給電能力を表示し、
--allow-lnb-powerの有無にかかわらず 15V 給電要求を拒否(UNSUPPORTED)するよう変更。 - 動作環境に関する注意: 機種・環境別の検証状況は README の検証表 を参照。機能追加は全機種・全環境での認定を意味しない。
検証
- GitHub Actions CI run 37001557275 と 37001996151 が全ジョブ成功。
- 実機で複数機器接続時の
--list/--list-json、シリアル衝突時の曖昧な指定拒否、LNB 15V 非対応機種への要求拒否を確認。
既知の制限
- USB切断後の復旧: デーモンの再起動による復旧が必要で、同一プロセス内の自動再接続には未対応。
- PX-Q3U4 受信機 7 のバースト: 一部環境で観測される既知事象。参照ドライバとの比較を含め Issue #1 で追跡中。
v0.1.8
px4-userland v0.1.8
PLEX PX-M1UR および PX-S1UR を正式対応機種に追加した Stable リリースです。
主な変更
- PX-M1UR / PX-S1UR の正式対応: PX-M1UR(ISDB-T/S対応、ISDB-SはLNB 0Vのみ・15V給電非対応)および PX-S1UR(地上波ISDB-T専用)を対応機種に追加。
- 単一受信機モデルの安全性向上: 未対応の15V LNB給電要求を安全に拒否し、GPIO 11へのアクセスを排除。
- 地上波専用モデルの不具合修正: 地上波専用 plain-TS モデルで ISDB-T の受信開始(attach)に失敗する不具合を修正。
- 動作環境に関する注意: 正式対応は機種プロファイルの追加であり、全OS・アクセスパスでの完全認定を意味しない(環境別の詳細は README の検証表を参照)。
検証
- GitHub Actions CI run 36702856032 が全ジョブ成功。
v0.1.7
px4-userland v0.1.7
macOS arm64 配布版の libusb 静的リンク化、外部libusbへの実行時依存の解消、およびライセンス遵守体制を強化したメンテナンスリリースです。
主な変更
- macOS 配布版の libusb 静的リンク化: libusb 1.0.30 を静的リンクし、Homebrew 等の外部 libusb への実行時依存を解消。
- ライセンスおよび再リンク対応: 配布バイナリに LGPL-2.1-or-later ライセンス本文と依存告知を、対応ソースに libusb ソースと再リンク手順を同梱。
- 動作環境に関する注意: プラットフォーム別の詳細な検証状況は README の検証表 を参照(Linux aarch64 は実機未検証)。
検証
- GitHub Actions CI run 36306581189 が全ジョブ成功。Apple Silicon Mac および PX-Q3U4 実機での動作(8受信機同時受信、選局、内蔵カード等)を確認。
既知事項
- PX-Q3U4 受信機 7 のバースト: 試験個体の受信機 7 で TEI/continuity burst が発生したが、同条件の参照ドライバでも再現した既知事象であり、Issue #1 で追跡を継続。
謝辞
v0.1.6
対応機種追加(実機未検証)
以下の機種を識別対象に追加しました。いずれも実機未検証のため、不具合が起こる可能性があります。動作報告・不具合報告をお待ちしております(SPEC v0.17 のリリース基準による hardware-unverified 扱い)。
| メーカー | 機種 | USB ID | 構成 |
|---|---|---|---|
| PLEX | PX-W3U4 | 0511:083f |
1 ブリッジ・受信機 4(衛星 2、地デジ 2) |
| PLEX | PX-W3PE4 | 0511:023f |
1 ブリッジ・受信機 4 |
| PLEX | PX-Q3PE4 | 0511:024a |
2 台連動・受信機 8 |
| PLEX | PX-W3PE5 | 0511:073f |
1 ブリッジ・受信機 4 |
| PLEX | PX-Q3PE5 | 0511:074a |
2 台連動・受信機 8 |
| PLEX | PX-MLT8PE3 | 0511:0252 |
受信機 3(T/S 切替) |
| PLEX | PX-MLT8PE5 | 0511:0253 |
受信機 5(T/S 切替) |
| PLEX | PX-M1UR | 0511:0854 |
受信機 1(T/S 切替) |
| PLEX | PX-S1UR | 0511:0855 |
受信機 1(T 専用) |
| e-Better | DTV02-1T1S-U(実験的) | 0511:004b |
受信機 1(T/S 切替) |
| e-Better | DTV02A-1T1S-U | 0511:004b / 0511:084b |
受信機 1(T/S 切替、ISDB2056N 含む) |
| e-Better | DTV02A-4TS-P | 0511:0254 |
受信機 4(T/S 切替) |
| e-Better | DTV03A-1TU(実験的。ロット 2021-11 以降) | 0511:0052 |
受信機 1(T 専用) |
機能追加
- 同一 lease 内の再選局(Issue #7):
STOP_STREAM後の lease でTUNE成功後に再びSTART_STREAMを実行できます。RELEASE/ACQUIREのやり直しは不要です。ATTACH_STREAMの nonce はACQUIREの値を lease 内で使い回し、token の有効性は arm 単位(START_STREAMからATTACH_STREAM受付または 5 秒満了まで、各 arm 1 回)です。wire 形式・protocol version の変更はありません(SPEC 6.3)。 - px4d 不在・切断時の IFD 耐性(Issue #8): px4d が落ちても PC/SC リーダーは生存し、
IFDHICCPresenceはIFD_ICC_NOT_PRESENTを返します。px4d 復帰後は lazy reconnect します。カード状態属性は未接続時に byte 値 0、power_down/close_channelは冪等に成功します。
仕様
- SPEC を Frozen v0.19 に更新(6.3 節に same-lease retune と arm 単位の token 有効性を追記)。
検証
- CI(portable userland foundation)全ジョブ green。
- Q3U4 実機での短い回帰: 30 秒受信 345,946 packets(エラー 0)、same-lease retune 2 チャンネル巡回 PASS、
px4ctl status/card-status正常。
既知の制限
- 追加機種はすべて実機未検証です。チューナー・カードリーダー・ファームウェア・電源シーケンスの実機確認はこれからです。
- 1 受信機モデル(M1UR / S1UR / ISDBT2071 / ISDB2056 系)の I2C コマンド列を検証する fake-hardware ユニットテストは未追加です。
- IFD の 4 秒タイムアウトへの backoff は未実装です。
v0.1.5 Beta
px4-userland v0.1.5 Beta
PX-W3U4(0511:083f)を、Q3U4 の片側 1 本として扱います。受信機は 4 つで、順は衛星、衛星、地デジ、地デジです。15 桁のシリアルは組にしません。ファームウェアは Q3U4 と同じ 2,169 バイトです。
これは Beta です。W3U4 の実機確認はまだありません。カードリーダーは Q3U4 の 1 本目と同じ経路につないでありますが、未確認です。
テスター
PC に PX-W3U4 を直結し、この版の px4d / px4ctl / px4-ts と it930x-firmware.bin が見える状態で次を実行してください。出力をそのまま Issue に貼ってください。
PX4_BINDIR=/path/to/bin PX4_FIRMWARE=/path/to/it930x-firmware.bin \
scripts/w3u4-report.sh地デジと衛星を試したくないときは PX4_REPORT_TUNE=0 を付けます。LNB は 0V のままです。
検証
px4_userland_testsは、W3U4 を 1 台として分けることと、受信機 4 の LIST を確認しています。- libusb ありの
px4dはビルドできています。 - W3U4 の実機試験はしていません。
- CI: commit
16b2bdbbcf5e3d992a24f284422628def1390aa9、run36089731662。
配布物
以下の 9 アーカイブと SHA256SUMS です。版のファイル名は 0.1.5 です。
px4-userland-0.1.5-linux-glibc-x86_64.tar.gzpx4-userland-0.1.5-linux-musl-x86_64.tar.gzpx4-userland-0.1.5-linux-glibc-aarch64.tar.gzpx4-userland-0.1.5-linux-musl-aarch64.tar.gzpx4-userland-0.1.5-darwin-arm64.tar.gzpx4-userland-0.1.5-android-aarch64.tar.gzpx4-userland-0.1.5-android-armv7a.tar.gzpx4-userland-0.1.5-android-x86_64.tar.gzpx4-userland-0.1.5-source.tar.gzSHA256SUMS
v0.1.4
px4-userland v0.1.4
PX-MLT5PE と DTV02A-5TS-P の対応は @siketyan によるものです。ありがとうございます。
主な変更
- PX-MLT5PE と e-Better DTV02A-5TS-P を追加: 5 チューナーと内蔵 IC カードリーダーをユーザー空間から制御する。DTV02A-5TS-P は PX-MLT5PE のリブランドで、USB Product ID だけが異なる(
0511:024eと0511:924e)。 - Q3U4 の IPC は変更なし: 既存の Q3U4 同士の byte 列は v0.1.3 と同じ。
- 未対応機種の一覧:
tsukumijima/px4_drvが対応し、このソフトウェアでは未対応・未検証の機種を README に写し、テスターとメンテナを募集している。
検証
- PX-Q3U4: この版の開発ビルドで、HAOS 上の短い回帰を確認した。地デジ 5 秒、衛星 5 秒(LNB 0V)、内蔵カードの ATR と APDU。2 時間試験、および Latitude、macOS、Android での再試験はしていない。
- PX-MLT5PE / DTV02A-5TS-P: @siketyan が Ubuntu 26.04 amd64 で地上波、BS/CS、内蔵カードを確認している。他の OS は未検証であり、hardware-verified には入れていない。
- CI: commit
7ec828578db47db4ed2a1b247d4c24fb722aedde、run36028504308(成功)で生成したアーカイブ。
配布物
以下の 9 アーカイブおよび SHA256SUMS を配布する。
px4-userland-0.1.4-linux-glibc-x86_64.tar.gzpx4-userland-0.1.4-linux-musl-x86_64.tar.gzpx4-userland-0.1.4-linux-glibc-aarch64.tar.gzpx4-userland-0.1.4-linux-musl-aarch64.tar.gzpx4-userland-0.1.4-darwin-arm64.tar.gzpx4-userland-0.1.4-android-aarch64.tar.gzpx4-userland-0.1.4-android-armv7a.tar.gzpx4-userland-0.1.4-android-x86_64.tar.gzpx4-userland-0.1.4-source.tar.gzSHA256SUMS
ファームウェア
本ソフトウェアにファームウェアは同梱されていない。別途、README.md に記載されたサイズ(2,169 バイト)および SHA-256(5213a5a38872661277a2cc1b2dfdfe88faf06f41205f460f3b51857f0568b484)を満たす it930x-firmware.bin を用意し、px4d 起動時に --firmware オプションで指定する。
既知の制限
- 受信機 7(地上波)のバーストエラー: 試験個体の receiver 7 で TEI・連続性エラーのバーストが確認されている。同一ハードウェア・周波数で参照カーネルドライバでも同様に再現し、本実装固有の問題ではないと見られるが、根本原因や他個体での発生状況は未確認である。詳細は README.md を参照。