Merge branch 'master' of github.com:tsukumijima/libaribb25

.appveyor.yml

@@ -1,4 +1,4 @@
-version: "0.2.7 build #{build}"
+version: "0.2.8 build #{build}"
 shallow_clone: true
 
 environment:

.github/workflows/build-package.yml

@@ -2,6 +2,44 @@ name: Package
 on: push
 
 jobs:
+  windows:
+    name: Windows
+    strategy:
+      matrix:
+        os:
+          - windows-2019
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: setup msbuild
+        uses: microsoft/[email protected]
+      - uses: actions/checkout@v3
+      - name: build
+        run: |
+          msbuild arib_std_b25.sln /t:Build /p:Configuration=Release /p:Platform=Win32 /p:PlatformToolset=v142
+          msbuild arib_std_b25.sln /t:Build /p:Configuration=Release /p:Platform=x64 /p:PlatformToolset=v142
+      - name: get output name
+        id: get_output_name
+        run: |
+          $version = bash -c 'LC_ALL=ja_JP.utf8 grep -oP ''#define VERSION_STRING ""\\K[^""]+'' aribb25/td.c'
+          echo "archive_path=libaribb25_${version}_windows.zip" >> $ENV:GITHUB_OUTPUT
+      - name: package
+        run: |
+          mkdir libaribb25/
+          mkdir libaribb25/32bit/
+          mkdir libaribb25/64bit/
+          Copy-Item -Path ".\Win32\Release\*" -Destination ".\libaribb25\32bit\" -Recurse -Force
+          Copy-Item -Path ".\x64\Release\*" -Destination ".\libaribb25\64bit\" -Recurse -Force
+          Copy-Item -Path libaribb25\32bit\libaribb1.dll -Destination libaribb25\32bit\B1Decoder.dll -Force
+          Copy-Item -Path libaribb25\64bit\libaribb1.dll -Destination libaribb25\64bit\B1Decoder.dll -Force
+          Copy-Item -Path libaribb25\32bit\libaribb25.dll -Destination libaribb25\32bit\B25Decoder.dll -Force
+          Copy-Item -Path libaribb25\64bit\libaribb25.dll -Destination libaribb25\64bit\B25Decoder.dll -Force
+          7z a -tzip ${{ steps.get_output_name.outputs.archive_path }} libaribb25
+      - name: save artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: ${{ steps.get_output_name.outputs.archive_path }}
+          path: ${{ steps.get_output_name.outputs.archive_path }}
+
   deb-package:
     runs-on: ubuntu-20.04
     steps:

CMakeLists.txt

@@ -14,7 +14,7 @@ set(CMAKE_BUILD_TYPE "Release" CACHE STRING "default build type")
 
 set(CMAKE_INSTALL_SO_NO_EXE False)
 
-project(libaribb25 VERSION 0.2.7 LANGUAGES C CXX)
+project(libaribb25 VERSION 0.2.8 LANGUAGES C CXX)
 enable_language("CXX")
 
 include(GitRevision)
@@ -76,7 +76,7 @@ set(ARIBB1_PRODUCT "ARIB STD-B1")
 
 set(ARIBB1_MAJOR_VERSION "0")
 set(ARIBB1_MINOR_VERSION "2")
-set(ARIBB1_PATCH_VERSION "7")
+set(ARIBB1_PATCH_VERSION "8")
 set(ARIBB1_VERSION_NUMBER ${ARIBB1_MAJOR_VERSION}.${ARIBB1_MINOR_VERSION}.${ARIBB1_PATCH_VERSION})
 set(ARIBB1_VERSION_STRING stz-${ARIBB1_VERSION_NUMBER})
 
@@ -94,7 +94,7 @@ set(ARIBB25_PRODUCT "ARIB STD-B25")
 
 set(ARIBB25_MAJOR_VERSION "0")
 set(ARIBB25_MINOR_VERSION "2")
-set(ARIBB25_PATCH_VERSION "7")
+set(ARIBB25_PATCH_VERSION "8")
 set(ARIBB25_VERSION_NUMBER ${ARIBB25_MAJOR_VERSION}.${ARIBB25_MINOR_VERSION}.${ARIBB25_PATCH_VERSION})
 set(ARIBB25_VERSION_STRING stz-${ARIBB25_VERSION_NUMBER})
 

README.md

@@ -69,9 +69,75 @@ B25Decoder.cpp / B25Decoder.h が一見それのように見えますが、実
 > そもそも関数名が UpperCamelCase から snake_case に変更されていることからして、本来の B25Decoder インターフェイスとの互換性はありません。  
 おそらく Linux で B25Decoder のようなインターフェイスを実装した libaribb25 のラッパーとしてのコードだと思われますが、このコードが含まれていた epgdatacapbon 版でも現在は使われておらず、どのような意図で利用されていたコードなのかは不明です。本来削除しても問題はないのですが、念のため残しています。
 
+### ini ファイルでカードリーダー名を指定してスクランブル解除を行う機能の追加 (Windows のみ)
+
+Windows 版のみ、独自に B25Decoder.dll や arib-b25-stream-test.exe などの各種 .exe / .dll と同じ名前の ini ファイルでカードリーダー名を指定してスクランブル解除を行う機能を追加しました。  
+主に EDCB で B-CAS カードと C-CAS カードの両方を併用したい場合に利用できると思います。
+
+ini ファイルを配置しない場合の動作は、通常の B25(B1)Decoder.dll / b25(b1).exe / arib-b25(b1)-stream-test.exe と同じです。  
+具体的には、一番先に検出されたカードリーダーがスクランブル解除に利用されます。
+
+下記の例を参考に (.exe or .dll と同じファイル名).ini 内の `Name=` プロパティにカードリーダー名を記述すると、指定されたカードリーダーに接続されている B-CAS or C-CAS or SPHD カードを使ってスクランブル解除を行います。  
+カードリーダー名は TVTest の TS プロセッサーで表示されているものがそのまま使えるので、コピペするのがおすすめです。
+
+#### 注意
+
+- ini ファイルで指定されたカードリーダーが PC に接続されていない場合、スクランブル解除に失敗します (スクランブルされたままの TS が返される) 。
+  - 無理に復号しようとしてファイルが壊れたりとかはないので、後から解除すること自体は可能なはずです。
+- B25Decoder.dll と同じフォルダに winscard.dll を配置している場合は、その仮想 winscard.dll の実装で提供されている仮想カードリーダーの名前しか指定できなくなります。注意してください。
+  - たとえば radi-sh 版 BonDriver の内蔵カードリーダーなら `Plex PX-x3U4 Card Reader 0` 、SoftCas なら `@OishiiSlurper` になります。
+  - Windows ネイティブの winscard.dll の機能を上書きする形になるため、仮想 winscard.dll が配置されている状態では、別途物理カードリーダーが接続されていたとしても libaribb25 から認識されなくなります。
+  - このため、仮想 winscard.dll を利用している環境でカードリーダー名指定機能を使う意味はありません。
+
+#### 利用例
+
+- B-CAS: TVTest で `SCM Microsystems Inc. SCR33x USB Smart Card Reader 0` として認識されるカードリーダーに接続中
+- C-CAS: TVTest で `SCM Microsystems Inc. SCR33x USB Smart Card Reader 1`として認識されるカードリーダーに接続中
+
+の環境だと仮定します。
+
+まず、EDCB (EpgDataCap_Bon.exe) と同じフォルダに B25Decoder.dll と、それをコピーした B25Decoder-CATV.dll を配置します。
+
+```
+[CardReader]
+Name=SCM Microsystems Inc. SCR33x USB Smart Card Reader 0
+```
+
+次に新規作成した B25Decoder.ini に上記の内容を、
+
+```
+[CardReader]
+Name=SCM Microsystems Inc. SCR33x USB Smart Card Reader 1
+```
+
+同じく新規作成した B25Decoder-CATV.ini に上記の内容を書き込んで保存します。
+
+```
+...
+[SET]
+FFFFFFFF=B25Decoder.dll
+0004FFFF=B25Decoder.dll
+0006FFFF=B25Decoder.dll
+0007FFFF=B25Decoder.dll
+000AFFFF=B1Decoder.dll
+0001FFFF=B1Decoder.dll
+0003FFFF=B1Decoder.dll
+FFFEFFFF=B25Decoder-CATV.dll
+FFFAFFFF=B25Decoder-CATV.dll
+FFFDFFFF=B25Decoder-CATV.dll
+FFF9FFFF=B25Decoder-CATV.dll
+...
+```
+
+最後に、EDCB の BonCtrl.ini の [SET] 以下の記述を、上記の通りに変更して保存します。  
+これで B-CAS カードと C-CAS カードを同じ PC に接続した状態で、地上波と CATV (C-CAS が必要なトランスモジュレーション方式 (ISDB-C) チャンネル) を両方受信できるようになるはずです！
+
+> BonCtrl.ini に追記した行の先頭の `FFFE`,`FFFA`,`FFFD`,`FFF9` はいずれも CATV チャンネルの network_id を示しています。  
+> その次の FFFF は、同じ network_id のすべてのチャンネルに対して同じデコーダーを利用することを示しています。
+
 ### SIMD 実装の差異
 
-基本的に Windows と Linux でコードベースは共通になっていますが、MULTI2 の復号周りのコードに関しては両者ともに大きく変更されていたため、マージは行いませんでした。  
+基本的に Windows と Linux でコードベースは共通ですが、MULTI2 の復号周りのコードに関しては両者ともに大きく変更されていたため、マージは行いませんでした。  
 multi2.c が HaijinW 版由来のオリジナルに近い MULTI2 復号コードで、multi2.cc が stz2012 版由来の C++ で書き直された MULTI2 復号コードです。  
 Windows (Visual Studio) でビルドする場合は HaijinW 版由来の SIMD 実装 (ENABLE_MULTI2_SIMD) が、Linux (CMake) でビルドする場合は stz2012 版由来の SIMD 実装が利用されるように調整しています。