Giter VIP home page Giter VIP logo

libaribb25's Introduction

libaribb25

このフォークについて

散逸している libaribb25 派生のソースコードやパッチを一つのコードベースにまとめる事を目的とした、Windows・Linux 共用の ARIB STD-B1 / ARIB STD-B25 ライブラリです。
epgdatacapbon 版 版と stz2012 版 を統合し、同じコードベースから Windows 向けと Linux 向け両方の libaribb25 をビルドできるようになったほか、スカパー！プレミアムサービス (libaribb1) への対応、arib-b25-stream-test への対応、Windows 向け SIMD 実装の統合も行っています。

細心の注意を払ってコードを統合したほか、libaribb1・libaribb25 ともに動作確認を行っています。
ただし、私が C/C++ が書けず、コードの実装内容を正確に理解できているわけでもないため、100% 動作する保証はありません。自己の責任のもとでお願いします。
何か不備がありましたら Issue や Pull Request までお願いします。可能な範囲で対応します。

変更点

コードの統合

libaribb25 には主に Windows 環境で利用されている epgdatacapbon 版 と、Linux 環境で利用されている stz2012 版 の2つのフォークがあります。
このフォークでは、epgdatacapbon 版にさらに SIMD 対応を実装している HaijinW 版 をベースに、比較的更新が活発な stz2012 版 の変更内容を取り込みました。
加えて epgdatacapbon 氏が別途公開している stz2012 版ベースのフォーク での変更内容も取り込み、現時点で存在する有用な変更内容を大方取り込んだつもりです。

2つのフォークの統合にあたり、stz2012 版由来の libarib25 という表現を libaribb25 に統一したほか、epgdatacapbon 版由来の Linux 向け Makefile を削除し、Linux でのビルド方法を CMake に統一しています。
Windows 向けライブラリのビルドは Visual Studio で、Linux 向けライブラリのビルドは CMake で行えます。

スカパー！プレミアムサービス対応の統合

さらに、パッチとしていくつか実装がある ARIB STD-B1 対応のためのコードを統合しました。

ARIB STD-B1 は、スカパー！プレミアムサービスの CAS システム（スカパーカード）の仕様が定められている標準規格です。
とはいえ、実際に ARIB STD-B1 で規定されている内容は僅かで、多くはスカパーによる非公開仕様となっています。

のコードを参考に、現行のコードに手作業で統合しました。
多くが非公開仕様となっている関係で、現状 EMM 処理と通電制御情報の取得は未サポートとなっています。
そのため、ARIB STD-B25 における b25.exe に相当する b1.exe のコマンドラインオプションからも、EMM の送信を行う -m オプションと、通信制御情報を表示する -p オプションを削除しています。

便宜上 libaribb1 という別ライブラリとしていますが、コードベースは同一です。
ENABLE_ARIB_STD_B1 プリプロセッサが定義された状態でビルドすると、libaribb25 ではなく libaribb1 が生成されます。
スカパー！プレミアムサービス対応の統合にともない、Windows (Visual Studio)・Linux (CMake) の両方で libaribb25 (b25.exe / libaribb25.dll) と同時に libaribb1 (b1.exe / libaribb1.dll) が生成できるよう、Visual Studio のプロジェクトファイルと CMakeList.txt を変更しています。

arib-b1-stream-test・arib-b25-stream-test の統合

arib-b25-stream-test は、標準入力から MULTI2 で暗号化された TS を受け、B-CAS カードと通信し復号した TS を標準出力に出力するプログラムです。
b25（実行ファイル）に渡す src.m2t dst.m2t の各引数をそれぞれ標準入出力に置き換えたものと言えば分かりやすいでしょうか。
arib-b1-stream-test は、その名の通り arib-b25-stream-test の ARIB STD-B1 対応版となっています。

Mirakurun で受信した放送波のスクランブルを解除するための decoder として多く利用されていますが、実は 5 年以上前のかなり古い stz2012 版の libarib25 がベースとなっています。
そのため、最新の stz2012 版などでは修正されている不具合が未修正のままになっているなど、いくつかの問題を抱えています。

もっともほとんどのケースで問題なく動作するため、影響はさほど大きくないと思われます。

arib-b25-stream-test_for_win のコードを参考に、Linux 対応を追加して現行のコードに手作業で統合しました。
ENABLE_ARIB_STREAM_TEST プリプロセッサが定義された状態でビルドすると、b1・b25 ではなく arib-b1-stream-test・arib-b25-stream-test が生成されます。
arib-b1-stream-test・arib-b25-stream-test の統合にともない、Windows (Visual Studio)・Linux (CMake) の両方で libaribb1・libaribb25 と同時に arib-b1-stream-test・arib-b25-stream-test が生成できるよう、Visual Studio のプロジェクトファイルと CMakeList.txt を変更しています。

B25Decoder 互換インターフェイスの対応

epgdatacapbon 版由来の、libaribb25 における B25Decoder 互換インターフェイスの実装を引き継いでいます。
libaribb1.dll / libaribb25.dll をそれぞれ B1Decoder.dll / B25Decoder.dll とリネームして EDCB などの各ソフトに配置することで、オリジナルの B1Decoder.dll / B25Decoder.dll を代替することができます。

B25Decoder 互換のインターフェイスがビルドされるのは Windows (Visual Studio) でビルドした場合のみです。
Linux (CMake) でビルドした場合はビルド対象になりません。そもそも Windows API に依存しているため、Linux ではビルドに失敗すると思われます。

B25Decoder 互換のインターフェイスが実装されているのは libaribb25.cpp / libaribb25.h です。
B25Decoder.cpp / B25Decoder.h が一見それのように見えますが、実はプロジェクト上では使用されておらず、ビルド対象にも入っていないコードです。

そもそも関数名が UpperCamelCase から snake_case に変更されていることからして、本来の B25Decoder インターフェイスとの互換性はありません。
おそらく Linux で B25Decoder のようなインターフェイスを実装した libaribb25 のラッパーとしてのコードだと思われますが、このコードが含まれていた epgdatacapbon 版でも現在は使われておらず、どのような意図で利用されていたコードなのかは不明です。本来削除しても問題はないのですが、念のため残しています。

SIMD 実装の差異

基本的に Windows と Linux でコードベースは共通になっていますが、MULTI2 の復号周りのコードに関しては両者ともに大きく変更されていたため、マージは行いませんでした。
multi2.c が HaijinW 版由来のオリジナルに近い MULTI2 復号コードで、multi2.cc が stz2012 版由来の C++ で書き直された MULTI2 復号コードです。
Windows (Visual Studio) でビルドする場合は HaijinW 版由来の SIMD 実装 (ENABLE_MULTI2_SIMD) が、Linux (CMake) でビルドする場合は stz2012 版由来の SIMD 実装が利用されるように調整しています。

Windows 向け（＝ HaijinW 版の SIMD 実装）の b1.exe / b25.exe では、SSE2,SSE3,AVX2 のどの SIMD 拡張命令を利用するかを選択する -i オプションと、MULTI2 の復号のベンチマークテストを行う -b オプションが実装されています。
Linux 向け（＝ stz2012 版の SIMD 実装）の b1 / b25 では、オプションの追加はありませんが、SIMD が使用可能であれば自動的に利用するコードになっていると思われます。
なお、AVX2 を有効化するには、後述の CMake でのビルドの際に cmake に -DUSE_AVX2=ON オプションを付与する必要があるようです。

バイナリの構成

  • b1.exe / b1
    • ARIB STD-B1 記載の処理を行うためのプログラム
    • MULTI2 で暗号化された TS を、スカパーカードと通信し復号して出力する
  • arib-b1-stream-test.exe / arib-b1-stream-test
    • 上記のプログラムに変更を加え、標準入力から MULTI2 で暗号化された TS を受け、復号した TS を標準出力に出力するプログラム
  • libaribb1.dll / libaribb1.so
    • MULTI2 復号処理を行うライブラリ
    • libaribb1.dll は B1Decoder.dll と互換性がある
  • b25.exe / b25
    • ARIB STD-B25 記載の処理を行うためのプログラム
    • MULTI2 で暗号化された TS を、B-CAS カードと通信し復号して出力する
  • arib-b25-stream-test.exe / arib-b25-stream-test
    • 上記のプログラムに変更を加え、標準入力から MULTI2 で暗号化された TS を受け、復号した TS を標準出力に出力するプログラム
  • libaribb25.dll / libaribb25.so
    • MULTI2 復号処理を行うライブラリ
    • libaribb25.dll は B25Decoder.dll と互換性がある

ビルド方法

Windows (Visual Studio)

Visual Studio 2019 で arib_std_b25.sln を開きます。

上部メニューの [Debug] を [Release] に変更し、お使いのアーキテクチャに合わせて [Win32] または [x64] のいずれかを選択します。
[ビルド] → [ソリューションのビルド] をクリックし、ビルドを実行します。

ビルドが完了すると、Win32/Release または x64/Release 以下にバイナリが生成されています。

Ubuntu (CMake)

sudo apt install cmake libpcsclite1 libpcsclite-dev pkg-config

あらかじめ、cmake・libpcsclite1・libpcsclite-dev・pkg-config のインストールが必要です。

cmake -B build
cd build
make
sudo make install

cmake -B build で build/ ディレクトリに Makefile を生成してから、make でビルドを実行します。

sudo make install でビルドした libaribb1 / libaribb25 をインストールします。
build/ ディレクトリで sudo make uninstall を実行することで、インストールしたファイルをアンインストールすることができます。

以下のドキュメントは、元の readme.txt を内容をそのままに Markdown 形式に書き直したものです。
HaijinW 版での変更内容が記載されている MEMO.txt もあわせて参照してください。

ARIB STD-B25 仕様確認テストプログラムソースコード

バージョン

0.2.5

作者

茂木 和洋 (MOGI, Kazuhiro)
[email protected]

一次配布元

http://www.marumo.ne.jp/db2012_2.htm#13 又は

あるいは

http://www.marumo.ne.jp/junk/arib_std_b25-0.2.5.lzh

目的

ARIB STD-B25 の仕様を理解する為の、参考用の実装として公開

背景

2011 年 7 月の地上アナログ放送停波を控え、廉価な地上デジタル放送受信機の販売が待たれている

しかし、ARIB の標準文書はわざと判りにくく書いて開発費をかさませようとしているとしか思えないほどに意味不明瞭な記述になっており、このままでは低価格受信機の開発など不可能に思える

そこで、自分なりに ARIB 標準文書を読み、理解した範囲をソースコードの形にまとめて公開することにした

このコードが安価な受信機の開発の一助となることを期待する

なお、あくまでも仕様理解を目的としたものであるため、ビルド済みバイナリファイルは配布しない

実装した範囲

CA システム (B-CAS カード関連) を中心に ECM(table_id=0x82) の処理とストリーム暗号の復号処理、EMM(table_id=0x84) の処理までを実装した

EMM メッセージ (table_id=0x85) 関連は未実装となっている

プログラムの動作環境

ISO 7816 対応の IC カードリーダがインストールされた Windows PC を想定動作環境とする

ISO 7816 対応スマートカードリーダーは一般に「住基カード対応 IC カードリーダ」「e-Tax 対応 IC カードリーダ」などとして 4000 円程度で販売されているものが利用可能である

日立マクセル製の HX-520UJJ と NTT コミュニケーションズの SCR3310 で正常に動作することを確認している

ソースコードのライセンスについて

  • ソースコードを利用したことによって、特許上のトラブルが発生しても茂木 和洋は責任を負わない
  • ソースコードを利用したことによって、プログラムに問題が発生しても茂木 和洋は責任を負わない

上記 2 条件に同意して作成された二次的著作物に対して、茂木 和洋は原著作者に与えられる諸権利を行使しない

プログラムの構成

  • arib_std_b25.h/c
    • ARIB STD-B25 記載の処理を行うためのモジュール
    • MPEG-2 TS の分離、CA システム (B-CAS カード) 機能の呼び出し、MULTI2 復号機能の呼び出し等を担当する
  • ts_section_parser.h/c
    • MPEG-2 TS のセクション形式データの分割処理を担当する
  • b_cas_card.h/c
    • CA システム (B-CAS カード) のリソース管理および直接の制御を担当する
  • multi2.h/c
    • MULTI2 暗号の符号化と復号を担当する
  • td.c
    • テストドライバ
    • PAT/PMT/ECM を含む MPEG-2 TS ファイルを読み込み、復号後のMPEG-2 TS ファイルを出力する
    • コマンドラインオプションで MULTI2 暗号のラウンド数を指定可能
      • ラウンド数を指定しない場合の初期値は 4
      • このラウンド数 4 は MULTI2 用語では 32 に相当する
      • ARIB STD-B25 では MULTI2 のラウンド数は非公開パラメータだが総当たりで実際のラウンド数は推定可能である

処理の流れ

起動時

  1. アプリケーションは B_CAS_CARD モジュールのインスタンスを作成し、B_CAS_CARD モジュールに、初期化を依頼する
    1. B_CAS_CARD モジュールは WIN32 API のスマートカード関連 API を呼び出し、CA システムに接続する
    2. B_CAS_CARD モジュールは ARIB STD-B25 記載の「初期条件設定コマンドを CA システムに発行し、システム鍵 (64 byte) 初期 CBC 状態 (8 byte) を受け取る
  2. アプリケーションは ARIB_STD_B25 モジュールのインスタンスを作成し、B_CAS_CARD モジュールを ARIB_STD_B25 モジュールに登録する

データ処理時

  1. アプリケーションは ARIB_STD_B25 モジュールに順次データを提供し、ARIB_STD_B25 モジュールから処理完了データを受け取ってファイルに出力していく

ARIB_STD_B25 モジュール内

  1. TS パケットのユニットサイズ (188/192/204 などが一般的) が特定されていない場合 8K まで入力データをバッファしてから、ユニットサイズを特定する
    • ユニットサイズが特定できなかった場合は、エラー終了する
  2. PAT が発見されていない場合、PAT が発見できるまで入力データをバッファし続ける
    • PAT が発見できずにバッファサイズが 16M を超過した場合エラー終了する
    • PAT が発見できた場合、プログラム配列を作成し PID マップ配列に登録する
  3. PAT に登録されていた PMT すべてが発見されるか、どれかひとつの PMT で 2 個目のセクションが到着するまで入力データをバッファし続ける
    • 上記条件を満たさずにバッファサイズが 32M を超過した場合エラー終了する
    • PMT が到着する毎に ECM の有無を確認し、ECM が存在する場合はデクリプタを作成してプログラムに所属するストリームと PID マップ上で関連付ける
  4. PMT に登録されていた ECM すべてが発見されるか、どれかひとつの ECM で 2 個目のセクションが到着するまで入力データをバッファし続ける
    • 上記条件を満たさずにバッファサイズが 32M を超過した場合エラー終了する
    • 各 ECM に対して、最初のセクションデータが到着した時点で MULTI2 モジュールのインスタンスをデクリプタ上に作成する
    • ECM セクションデータは B_CAS_CARD モジュールに提供してスクランブル鍵を受け取り、MULTI2 モジュールにシステム鍵、初期 CBC 状態、スクランブル鍵を渡し、MULTI2 復号の準備を行う
    1. 暗号化されている TS パケットであれば、PID から対応ECM ストリームを特定し、デクリプタの MULTI2 モジュールに復号させて出力バッファに積む
    2. 暗号化されていない TS パケットであれば、そのまま出力バッファに積む
    3. CAT を検出した場合、EMM の PID を取得して EMM の処理準備を行う
    4. EMM を受け取った場合、B-CAS カード ID と比較し、自分宛ての EMM であれば B-CAS カードに引き渡して処理させる

EMM 処理オプションが指定されている場合

  1. ECM が更新された場合、B_CAS_CARD モジュールに処理を依頼し、出力されたスクランブル鍵を MULTI2 モジュールに登録する
  2. PMT が更新された場合、ECM PID が変化していれば新たにデクリプタを作成して 4 に戻る
  3. PAT が更新された場合、プログラム配列を破棄して 3 に戻る

終了時

  1. 各モジュールが確保したリソースを解放する

更新履歴

libaribb25's People

Contributors

eru avatar eternalharvest avatar haijinw avatar kazuki0824 avatar kazuohagihara avatar mittyorz avatar noriy avatar pinterior avatar stz2012 avatar tkmsst avatar tsukumijima avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.