BonDriverProxy_Linux

これは何？

BonDriverProxyをUnix系の環境での使用の為にpthreadで再実装した物と、Linux用のBonDriverです。 動作は主にUbuntu 14.04 + PT3(ドライバ:m-tsudo/pt3)で確認しています(※ドライバ使用の為、改変版pt1_ioctl.hをincludeしています)。 主な用途としては、WindowsのTVTestからLinuxの録画サーバのチューナを使用して視聴、と言う様な感じです。

また、現状Unix系の環境ではBonDriverと言うインタフェースを利用しているソフトは無いかもしれませんが、あって困る事は無いだろ、 て事でクライアント側も入れています。 録画ソフトや視聴ソフト側でBonDriverを扱える様にすれば、リアルタイム視聴と録画ソフトとでチャンネル変更の優先権を設定できるため、 録画ソフト側は、このチューナが視聴に使われてた場合は…的な、面倒な資源管理をやらなくても良くなって嬉しいかもしれません。 WindowsではほぼデファクトスタンダードになっているBonDriverインタフェースを提供する事で、Windows用に書いたコードの移植がやりやすくなるので、 Unix系の環境もWindows並に充実して行けばいいなと思います。

サーバ

ソースディレクトリで、

make server

でコンパイルできます。 Ex版の場合は、

make serverex

です。 Windows版でiniファイルだった物は、コマンドラインからの引数になりました。 引数無しで実行すると例が出ます。 なお、Ex版のBonDriverのグループ設定のみ、設定ファイルでの設定が必要です。 設定ファイルの名称と設置場所ルールは後述するクライアントモジュールと同じです。 グループ設定のフォーマットに関しては、Windows版を参照して下さい。

クライアントモジュール

サーバ側と同じく、ソースディレクトリで、

make client

でコンパイルできます。 設定ファイルは「モジュール名.conf」をモジュールと同じディレクトリに設置する形になります。 例えばモジュールが

/home/unknown/work/BonDriver_Proxy.so

だったとすると、

/home/unknown/work/BonDriver_Proxy.so.conf

となります。 使用方法や設定内容はWindows版BonDriverProxyと同じですが、行頭「;」の行はコメント行になります。

chardev版 / DVB版 BonDriver

ソースディレクトリで、

make driver

でコンパイルできます。 設定ファイルの名称と設置場所ルールは上記クライアントモジュールと同じで、行頭「;」の行がコメント行になるのも同じです。 デバイスの数だけモジュールをコピーして使用します。 必要な変更事項は、chardev版の場合は、

#DEVICE=/dev/pt3video0

のデバイスパスを、DVB版の場合は、

#ADAPTER_NO=0

のアダプタNoをモジュール毎に被らないように変更するのと、必要であれば、

#USELNB=0

の0を1にすればLNBへの給電がオンになります…と言うか、動作確認は出来てないので、そうなる様につくってるつもりですと言う事で…。
また、

#USESERVICEID=0

の0を1にすると、BonDriverとしての1チャンネルを1サービスに割り当てる事ができます。 いわゆるサービス指定したような感じのTSを出力するようになります。具体的に残しているのはPAT(対象サービスIDのみを含むように変更されます)、 PMT、CAT、NIT、SDT、EIT、TOT、SDTT、BIT、CDTの各PSI/SIと、ECM、EMM、それにもちろん指定したサービスの各PESとなっています。 なおSDTは変更しないので、こちらのモードで使用中にチャンネルスキャンをするとチャンネルが多数ダブって検索される事になる為、 正しいものを除いて無効化するようにして下さい。
またこちらのモードで使用する場合、同じトラポンに含まれる別サービスがBonDriverのチャンネルとして別チャンネル扱いになる為、BonDriverProxy経由で使用する場合、 通常モードでは可能な、2クライアントが1チューナを共有して、例えばそれぞれフジテレビONEとフジテレビNEXTを視聴する、と言うような事が出来なくなります。 代わりに、対象サービス以外のデータが流れなくなる為、ネットワークトラフィックが減るのと、(主にCS放送などで)取得したTSストリームをそのままデスクランブルに回した場合のCASカードの処理能力に余裕ができる事になるでしょう。
なお、必然的にチャンネルの設定がかなり変わるので、こちらのモード用の設定ファイルはBonDriver_(LinuxPT/DVB)_UseServiceID.confの方をテンプレとして使用するのが良いかと思います。

#USESERVICEIDを1で使用している場合、

#MODPMT=0

の0を1にすると、選択中のサービスのPMTが複数TSパケットにまたがっていた場合に、それらのパケットを微修正した上で、出力TSストリーム上で連続するように再配置するようになります。 これによる明確なメリットは特に無いとは思いますが、Windows 8 + テレ東問題が回避出来たりするので、特殊な地雷を踏まない為の保険的な意味合いで行っておいても損は無いかもしれません。

#DEL=

には、削除するPSI/SIの名称のリスト(有効な値はCAT, NIT, SDT, H-EIT, TOT, SDTT, BIT, M-EIT, L-EIT, CDT, ECM, EMM)を指定できます。また、EITを指定するとH-EIT, M-EIT, L-EITの3種を全て指定した場合と同じになります。 更に、TYPEDを指定するとISO/IEC 13818-6 type DのPIDストリーム(データ放送等で使用されています)が削除されます。DEL=CAT,EIT,SDTT,BIT,CDT,TYPEDの様に指定します。 なお、ECMを削除するとスクランブルが解除できなくなるので注意して下さい。
また、DVB版に関しては、

#TSSYNC=0

の0を1にすると、TSの同期処理を行うようになります。もしアダプタから読み出したTSデータが普通の188バイトTSでなかったり同期されていなかったりする場合、#USESERVICEID=1では正しく機能しませんが、 その様な場合にこれを有効にすると機能するようにできるハズです。もっとも、その様なアダプタが存在するかどうかは不明なので、保険の様なものです。
なお、chardev版に関しては、少なくともPT1,2/PT3では同期されたTSデータの出力がデバイスドライバで保証されている様なので、この機能は必要無いと判断しています。

PT3が一枚刺さっている環境で、/home/unknown/workにchardev版モジュールを#USESERVICEID=0で設置するとすると、

// /home/unknown/workの内容
// .soファイルはコンパイルして出来たモジュールのコピー
// .confファイルはBonDriver_LinuxPT.confをコピーして必要箇所のみ変更
--------------------------------------------------------------------------------
BonDriver_LinuxPT-S0.so
BonDriver_LinuxPT-S0.so.conf
BonDriver_LinuxPT-S1.so
BonDriver_LinuxPT-S1.so.conf
BonDriver_LinuxPT-T0.so
BonDriver_LinuxPT-T0.so.conf
BonDriver_LinuxPT-T1.so
BonDriver_LinuxPT-T1.so.conf
--------------------------------------------------------------------------------
.confファイルの#DEVICE=行はそれぞれ、
// BonDriver_LinuxPT-S0.so.conf
---
#DEVICE=/dev/pt3video0
---
// BonDriver_LinuxPT-S1.so.conf
---
#DEVICE=/dev/pt3video1
---
// BonDriver_LinuxPT-T0.so.conf
---
#DEVICE=/dev/pt3video2
---
// BonDriver_LinuxPT-T1.so.conf
---
#DEVICE=/dev/pt3video3
---

となります。それらより下は、説明がめんどくさいのでスルーです。 あんまりいじる必要は無いんじゃないかと思います。 詳しい方は、UHF(地デジ)に関しては、自分の地域の放送局の物理チャンネルを調べて不要箇所を削除すれば、チャンネルスキャンの時間をだいぶ減らせるかと思います(※不要箇所削除の際は、残した物のBonDriverとしてのチャンネル番号を0からの連番に採番しなおしてください)。 なお、もし編集する際は文字コードはUTF-8を使用してください。

サンプルツール

make sample
make util

でコンパイル出来ます。

デバッグビルド

makeするときに

BUILD=DEBUG

の環境変数を渡すことで、デバッグビルドが出来ます（例: BUILD=DEBUG make server）

ライセンス

MITライセンスとします。 LICENSE参照。

Jun/18/2014 unknown unknown_@live.jp

更新履歴

• version 1.1.8.2 (Aug/07/2016)

  • サーバ側にクライアントの接続状況を確認できるコマンドを追加した
  • util以下に、上述のコマンドを利用して指定したサーバの接続状況を確認するツール(cinfo)を追加した

• version 1.1.8.1 (Apr/20/2016)

  • BonDriver_Splitterの設定ファイルのパース処理にkeyとvalueへのtrim的な処理を追加したのと、
    設定ファイル末尾に改行が無かった場合への念の為の対策を追加した

• version 1.1.8.0 (Apr/19/2016)

  • BonDriver_Splitterを追加した
    設定方法はサンプルの設定ファイル(BonDriver_Splitter.conf)参照

• version 1.1.7.0 (Sep/30/2015)

  • チャンネルロック機能で先行優先の排他ロックを可能にした
    ※ついでに設定方式を数値による優先度指定方式にした
  • サーバ側のTSパージ処理は実質不要なので簡素化した
    ※TVTestはSetChannel()の前にPurgeTsStream()を呼ぶが、Ex版の場合はそのSetChannel()で別インスタンスを
    ※使用するようになるかもしれないので、変更前インスタンスのTSデータをパージする必要は全く無い場合がある
    ※この為、Ex版ではこの変更は特に都合が良い

• version 1.1.6.6 (May/06/2015)

  • 1サービス1チャンネルモードに、標準で残すようにしているPSI/SIから不要な物を指定して削除できる機能を追加

• version 1.1.6.5 (Feb/24/2015)

  • サーバ側で、BonDriverに対して実際にSetChannel()が行われた場合、それ以降に送信されるTSバッファと
    CNR値は、確実にチャンネル変更後に取得した物になるようにした
  • それに伴い、BonDriver側でも同様の対応を行った
    ※ただし、結局最終的にはデバイスドライバ次第
  • サーバ側のTsReader()で使用する各変数を構造体にまとめた

• version 1.1.6.4 (Feb/22/2015)

  • Ex版のサーバで、特定条件において、ロック権を持っていないクライアントインスタンスの保持チャンネルと
    実際に選局されているチャンネルとの間にズレが生じる場合があったのを修正
  • クライアントモジュールで、チャンネル変更後最初のTSバッファが受信されるまでGetSignalLevel()を
    ブロックするようにした
  • DVB版BonDriverに、#USESERVICEID=1の際にTS同期処理を行うオプションを追加

• version 1.1.6.3 (Jan/30/2015)

  • サーバで一旦ロードしたBonDriverは、使用クライアントがいなくなってもdlclose()しないのを標準にした
    ※動作は変数g_DisableUnloadBonDriverの値で制御するが、現状実行時に変更する手段は提供していない

• version 1.1.6.2 (Jan/29/2015)

  • BonDriverインスタンスを共有している複数のクライアントがほぼ同時にCloseTuner()した場合に、
    解放済みメモリにアクセスしてしまう場合があったのを修正

• version 1.1.6.1 (Jan/28/2015)

  • Ex版のサーバに対してほぼ同時に複数のクライアントが接続してきた場合に、同一のBonDriverインスタンスに対して
    複数のTS配信スレッドをつくってしまう場合があったのを修正

• version 1.1.6.0 (Jan/25/2015)

  • (ほぼ)共通の部品を共用化した
  • Ex版のサーバを追加した
  • その他若干のソース整形

• version 1.1.5.5 (Dec/19/2014)

  • IPv6に対応した
  • ホスト名として許可する長さを63文字以下から255文字以下にした
  • 分割PMTを再配置する場合、最初のPMTは完成した時点で送信するようにした

• version 1.1.5.4 (Dec/09/2014)

  • 1サービス1チャンネルモードに、分割PMTを出力TSストリーム上で連続するように再配置する機能を追加
  • PMT更新時に、CRC_32をチェックするようにした
  • チャンネル変更ではない場合のPMTの更新では、1世代前のPID群も保持するようにした

• version 1.1.5.3 (Dec/07/2014)

  • 1サービス1チャンネルモードでのPMTの更新時、新しいPMTが分割されており、かつ分割PMTの最初のTSパケットから
    最後のTSパケットまでの間に映像等の残すべきTSパケットが挟まる場合、ドロップしてしまっていたのを修正
    ※分割されたPMTが全部揃うまで残すべきPIDのリストをクリアしない様にした

• version 1.1.5.2 (Nov/21/2014)

  • あるBonDriverインスタンスをCloseTuner()する際はTS読み出しスレッドを必ず停止させておくようにした
  • あるBonDriverインスタンスがCloseTuner()時に、チューナのオープン状態フラグが正しく反映されない
    パターンがあるのを修正
  • レアケースだけどデッドロックするパターンへの対策を追加

• version 1.1.5.1 (Oct/13/2014)

  • TSヘッダのエラーインジケータを確認するようにした
  • ECMのPIDがPMTのES infoで設定されていた場合に対応(念の為)
  • PMTのバージョン更新のチェックが行われていなかったのを修正

• version 1.1.5.0 (Sep/28/2014)

  • DVB版ドライバモジュールを追加

• version 1.1.4.7 (Sep/19/2014)

  • 1サービス1チャンネルモードの際に、チャンネル変更でのTSデータパージ時に解除しておくべきイベントを
    解除していなかったのを修正

• version 1.1.4.6 (Sep/15/2014)

  • 1サービス1チャンネルモードの際に、PID違いのEITとCDTも残すようにしたのと、PMTが分割されていた場合に、
    2TSパケットまでしか確認しないと言う制限を無くした
    ※後者については、実際には3TSパケット以上に跨るPMTと言うのは見た事が無いので、おそらく現実的にはあまり意味は無い

• version 1.1.4.5 (Sep/13/2014)

  • クライアント側で、ネットワークが切断されている状態でアプリから各種BonDriverAPIを呼び出されると、
    アプリに処理が返らなくなる場合があったのに対応

• version 1.1.4.4 (Aug/28/2014)

  • 設定ファイルパース時の、空行に対するバウンダリチェック漏れ修正
  • クライアント側でのTSデータ用メモリ確保&コピー処理を削減
  • サーバ、クライアントそれぞれの受信スレッドを少し変更
    ※冗長なチェックの削除及び、やり取りされるコマンドパケットの内容(サーバからクライアントのパケットは殆どが
    ※TSデータ用=ペイロードの大きなパケットである、等)にあわせた最適化
  • delete対象として、NULLでない場合が大半の物に付いてはNULLチェック削除
  • delete後、即スコープを抜けるなどでNULLクリアが不要な物はNULLクリア削除
  • その他ロジックは変更無しでのソースコード整形

• version 1.1.4.3 (Aug/23/2014)

  • 1サービス1チャンネルモードの際に、CAT(とEMM)及びNITを削らない様にした

• version 1.1.4.2 (Aug/15/2014)

  • BonDriver_LinuxPTにBonDriverとしての1チャンネルを1サービスに割り当てるモードを追加
  • 主にリアルタイム視聴用の簡易ツールを追加(util以下参照)

• version 1.1.4.1 (Jul/04/2014)

  • サーバ側のグローバルなインスタンスロック処理を厳密に行うのをデフォルトにした
    副作用として、サーバプロセスがBonDriver_Proxyをロードし、それが自分自身に再帰接続(直接ではなく、それ以降の プロキシチェーンのどこかからでも同じ)するような状況ではデッドロックする
    ただし、テスト用途以外でその様な使用方法が必要になる状況は多分存在しないので、まず問題になる事は無いハズ
    一応、コンパイル時にSTRICT_LOCKが定義されているかどうかで変更可能なので、以前の動作に戻したい場合は、 BonDriverProxy.cppの頭の方にある#defineをコメントアウトすれば良い
  • 可能性はごく低いが理論的にはあり得るメモリリークへの対策を追加
  • クライアント側のIBonDriver2の方のSetChannel()で、リクエストされたスペース/チャンネルと、現在保持している スペース/チャンネルとの比較処理を廃止
    ※他のクライアントのチャンネル変更に引きずられた場合、実際のスペース/チャンネルと保持しているスペース/ チャンネルにズレが生じる為

• version 1.1.4.0 (Jul/03/2014)

  • サーバ側のTSストリーム配信時のロック処理をロードしたBonDriverのインスタンス毎にグループ分けした
    これにより、グローバルなインスタンスリストのロックや他のBonDriverインスタンスのTSストリーム配信処理の影響を 受けなくなるのと、個々のクライアントへのTSパケット作成時にロック及び比較処理が不要になる
  • サーバにSIGPIPEのハンドリング(単に無視するだけ)を追加
  • BonDriver_Proxyの各種BonDriverAPIを複数スレッドから非同期で呼び出された場合、理論的にはあるコマンドへの レスポンスを他のコマンドへのレスポンスと取り違える可能性があったのに対応
    ※普通に考えるとそのような呼び出し方をする必然性は無いと思われるが、対応しておいても損は無さそうなので…
  • BonDriver_Proxy及びBonDriver_LinuxPTで、現在使用していないTSキューのイベント関連の処理をコメントアウトした
    これはWaitTsStream()を真面目に実装しようとすると必要になるが、そもそもWaitTsStream()はインタフェース的に 若干使い難く、使う必要はまず無い(GetTsStream()をポーリングの方が自由度が高くロスも少ない)為、少なくとも 当面は必要無しと判断
  • BonDriver_LinuxPTをとりあえずPLEXチューナに対応とした(ただし、動作確認をとっていただいたのはx64でのPX-W3PEのみ)
    もっとも、PLEXチューナのドライバはバイナリでしか提供されていない為、それが利用できる環境(CentOS等)が必要になる
    なお、0x8d83のioctl()の引数の構造体は{ポインタ、バイト値、ポインタ、バイト値}と言う微妙な構造であり、 本来はアライメントを気にする必要があるが、少なくともx64ではgcc標準のアライメント(8バイト)で大丈夫らしいので 特に明示していない
    気になる人は自分の使うアーキテクチャでの標準アライメント(x64:8バイト/x86:4バイト)を明示的に設定する方向で
  • x86用にコンパイルした時の警告に対応

• version 1.1.3.0 (Jun/25/2014)

  • クライアント側にサーバへの接続タイムアウトの指定を出来る機能を追加
    ※設定ファイルのCONNECT_TIMEOUTで指定(単位は秒)
  • ついでにWOLのパケット自動送信機能を追加
    ※使い方に難しい点は無いと思うのでBonDriver_Proxy.conf参照
    ※TARGET_MACADDRESSは必須だが、TARGET_ADDRESS及びTARGET_PORT行に関しては、無い場合はADDRESSとPORTをそれぞれ使用する
    ※なお、TARGET_PORTはUDPのポートである事に注意

• version 1.1.2.1 (Jun/21/2014)

  • アプリ側で環境依存を気にしないでSIGALRM使えるようにusleep()をnanosleep()に変更
  • BonDriver使用のサンプルプログラム追加
    コンパイル方法や使用方法はソース(sample.cpp)参照

• version 1.1.2.0 (Jun/19/2014)

  • SetChannel()内で、GetTsStream()でアプリに返したバッファを解放してしまうBonDriverを読み込んだ場合、 タイミングが悪いと解放後メモリにアクセスしてしまう可能性があったのに対応
  • BonDriver_Proxy.cpp自身もプロキシ対象のBonDriverからのレスポンスをサーバから受け取ってからではあるものの 上記の状態だったので、アプリに返したバッファは必須の時以外解放しないように修正
  • BonDriver_Proxy.cppのPurgeTsStream()でのロック処理漏れを修正
  • コマンドパケット/TSパケットのキューがオーバーフローした際にその旨を表示するようにした
  • デフォルトのキューサイズを大きくした(なおキューのサイズはプロセスに使用を許可するメモリ量の制限値的な 意味なので、大きくしておいてもその量が必要時以外に確保されるわけではない)
  • その他ロジックは(ほぼ)変更無しでのソースコード整形

• version 1.1.1.0 (Jun/18/2014)

  • 初版リリース