1. device-connector-intdashとは

アプトポッド製のデバイスコネクター(device-connector-intdash)は、intdash用のデータを扱うのに便利な機能を集めたデバイスコネクターです。 device-connector-intdashを使用すると、外部デバイスからのデータを、intdash Edge Agent 2に渡すためのFIFO用データフォーマット( iscp-v2-compat )に簡単に変換することができます。 また、EDGEPLANT CAN-USB Interfaceや、EDGEPLANT ANALOG-USB Interfaceからのデータを簡単に扱うことができます。

注釈

device-connector-intdashは、Device Connector Frameworkを使用して開発されています。

1.1. インストール

注意

device-connector-intdashは、intdash Edge Agent 2をインストールした際に依存パッケージとしてインストールされています。 インストールされていることを確認するには、以下のコマンドを実行してください。

device-connector-intdash --version

device-connector-intdashがインストール済みの場合は、本インストール手順は不要です。

device-connector-intdashを正しくインストールするには以下の要件を満たす必要があります。

ディストリビューションとアーキテクチャー

ディストリビューション

バージョン

アーキテクチャー

Ubuntu

22.04(LTS), 20.04(LTS), 18.04(LTS)

x86_64 (or amd64), armhf, arm64

Debian

11, 10, 9

x86_64 (or amd64), armhf, arm64

device-connector-intdashは、アプトポッドの公開リポジトリで「device-connector-intdash」パッケージとして提供されています。 device-connector-intdashをインストールするには、インストール先エッジデバイスのターミナルで以下のコマンドを実行します。

  1. アプトポッドの公開リポジトリの設定を行います。

    コマンド内の ${DISTRIBUTION} には、ご使用の環境に応じて、 ubuntu または debian を指定してください。

    $ sudo apt-get update
    $ sudo apt-get install -y \
        apt-transport-https \
        ca-certificates \
        curl \
        gnupg-agent \
        lsb-release
    $ sudo mkdir -p /etc/apt/keyrings
    $ curl -fsSL https://repository.aptpod.jp/intdash-edge/linux/${DISTRIBUTION}/gpg | \
        sudo gpg --dearmor -o /etc/apt/keyrings/intdash-edge.gpg
    $ echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/intdash-edge.gpg] \
        https://repository.aptpod.jp/intdash-edge/linux/${DISTRIBUTION} \
        $(lsb_release -cs) \
        stable" \
        | sudo tee /etc/apt/sources.list.d/intdash-edge.list
    $ sudo apt-get update
    
  2. device-connector-intdashをインストールします。

    $ sudo apt-get install -y device-connector-intdash
    

    注釈

    上記のインストール手順では、推奨される依存パッケージも含めてインストールされます。 プラグイン開発を目的に、必要最低限の機能のみインストールしたい場合は、 apt-get install コマンドに --no-install-recommends オプションを付けて実行してください。

    $ sudo apt-get install -y --no-install-recommends device-connector-intdash
    

    推奨パッケージがインストールされていない場合、以下のエレメントを利用できません。 これらのエレメントをパイプラインで利用したい場合は、 --no-install-recommends を指定せずにdevice-connector-intdashをインストールしてください。

    • apt-analogtrx-src

    • apt-cantrx-src

    • h264-split-filter

    • pcm-split-filter

    • apt-cantrx-sink

1.2. パッケージ情報

利用可能なdevice-connector-intdashのバージョンは、アプトポッドの公開リポジトリの設定後に以下のコマンドで確認が可能です。

表示例:

$ apt policy device-connector-intdash
   device-connector-intdash:
   Installed: 2.0.0
   Candidate: 2.0.0
   Version table:
   *** 2.0.0 500
         500 https://repository.aptpod.jp/intdash-edge/linux/ubuntu focal/stable amd64 Packages
         100 /var/lib/dpkg/status

device-connector-intdash向けにプラグインを開発する 場合、以下の表を参照し、 パッケージバージョンに合ったテンプレートのタグを使用して、プロジェクトを作成してください。

device-connector-intdash パッケージのバージョン

本体のRustバージョン

テンプレートのタグ

2.0.0 以降

1.65.0

v2.2.1 以降

重要

device-connector-intdashパッケージを利用してプラグイン開発を行う場合、 Device Connector Frameworkの既知の制約 により、 Rustのバージョンを本体とプラグインで合わせる必要があります。