# 1. セットアップ

モジュールとそのセットアップを説明します。それぞれのモジュールの詳細な使い方は各モジュールのマニュアルを参照してください。

モジュール | 概要 | リンク
--- | --- | ---
ORiN3 Runtime | 複数のORiN3関連モジュールが含まれたパッケージです。 | リンク
ORiN3 Runtime with Providers | ORiN3 Runtimeに加えてリリースされているすべてのプロバイダが含まれています。 | リンク
ORiN3 Remote Engine | ORiN3のコアとなるモジュールです。 | リンク
ORiN3 Configurator | ORiN3 Remote EngineおよびORiN3プロバイダに対して、ライセンスの管理やORiN3プロバイダのインストールなどができるWindowsアプリケーションです。 | リンク
ORiN3 Message Client | ORiN3 Remote Engineのインターフェイスを実装したgRPCクライアントライブラリです。 | リンク
ORiN3 protoファイル | ORiN3 Remote EngineとgRPC(Google Remote Procedure Call)通信するためのインターフェイスを定義しています。 | リンク
ORiN3 プロバイダ | デバイスと接続するためのライブラリです。 | リンク
ORiN3 Dockerイメージ | ORiN3 Remote EngineがインストールされているDockerイメージです。 | リンク

## 1.1. ORiN3 Runtime

複数のORiN3関連モジュールが含まれたパッケージです。
含まれるモジュールは下記のとおりです。

- 含まれるモジュール一覧

  名称 | 説明 | リンク
  --- | --- | ---
  ORiN3 Remote Engine | ORiN3プロバイダの起動やエンドポイントの設定、OpenTelemetryによるトレースの設定などができ、サービスとして動作します。 | リンク
  ORiN3 Configurator | ORiN3 Remote Engine、ORiN3プロバイダの設定やORiN3プロバイダの動作を確認できるアプリケーションです。 | リンク

### 1.1.1. セットアップ

デンソーウェーブのHPおよびMicrosoft Storeからインストーラをダウンロードできます。
Linuxをお使いの場合は各モジュールのページを参照し、個別に入手してください。

## 1.2. ORiN3 Runtime with Providers

ORiN3 Runtimeで入手できるものに加えて、リリースされているすべてのプロバイダが含まれています。
ただし、使用の可否はご利用のライセンスにより異なります。ライセンスと使用できるプロバイダについてはリンクを参照してください。

### 1.2.1. セットアップ

WindowsのみデンソーウェーブのHPからインストーラがダウンロードできます。
Linuxをお使いの場合はリンクを参照してください。

## 1.3. ORiN3 Remote Engine

ORiN3のコアとなるモジュールです。ORiN3プロバイダの起動やエンドポイントの設定、OpenTelemetryによるトレースの設定などができ、サービスとして動作します。
Windowsをお使いの場合はリンクにて入手できます。WindowsとLinuxでORiN3 Remote Engineの機能に差はありません。

### 1.3.1. システム要件

ORiN3 Remote Engineのシステム要件は以下のとおりです。

項目 | 内容
--- | ---
プロセッサ | 1.0 GHz以上のクロック周波数を持つ64ビットデュアルコア以上のプロセッサ
メモリ (RAM) | 4 GB以上（8 GB以上を推奨）
ストレージ | 1 GB以上の空き容量を持つハードディスクまたはSSD
ネットワーク | 100 Mbps以上の帯域幅を持つイーサネット接続

- オペレーティングシステム

  OS | バージョン | アーキテクチャ | 備考
  --- | --- | --- | ---
  Windows | 10,11 | x64 | タブレットモードは非対応
  Windows Server | 2016, 2019, 2022 | x64 |
  Ubuntu | 22.04, 24.04 | Arm64、x64 |
  Red Hat Enterprise Linux | 8, 9 | Arm64、x64 |
  Raspberry Pi OS | Bookworm(Debian12ベース) | Arm64 |

- コンテナ

  ORiN3 Remote Engineはコンテナ上での動作をサポートしています。コンテナとOSのサポート状況は以下のとおりです。

  コンテナサービス | OS | バージョン | アーキテクチャ | 備考
  --- | --- | --- | --- | ---
  Docker | Ubuntu | 22.04, 24.04 | Arm64, x64 |
  Docker | Red Hat Enterprise Linux | 8, 9 | Arm64, x64 |
  WSL 2 (Windows Subsystem for Linux Ver.2) | Ubuntu | 22.04, 24.04 | Arm64, x64 |

### 1.3.2. セットアップ

- Linux

  - Ubuntu

    事前に.Net8.0をインストールしてください。
    ローカル環境に保存したdebファイルをインストールする手順は以下のとおりです。

  1. debファイルを入手する:
     こちらのリンクからdebファイルをダウンロードしてください。

     ダウンロード画面の一例

  2. インストールする:
     `sudo apt install <debファイルのパス>`コマンドを実行します。

  インターネット上に公開されているdebファイルをインストールする手順は以下のとおりです。

  1. 公開鍵を登録する:
     `sudo mkdir -p /etc/apt/keyrings`
     `curl -fsSL https://packages.iot.fa.denso-wave.com/fa/iot/apt/public.key | sudo gpg --dearmor -o /etc/apt/keyrings/dnwa.gpg`
     gpgが入っていないときは`sudo apt install gpg`でインストールしてください。

  2. レポジトリを追加する:
     `echo "deb [signed-by=/etc/apt/keyrings/dnwa.gpg] https://packages.iot.fa.denso-wave.com/fa/iot/apt stable main" | sudo tee /etc/apt/sources.list.d/dnwa.list`

  3. パッケージリストを更新する:
     `sudo apt update`コマンドを実行します。

  4. インストールする:
     `sudo apt install orin3.remoteengine`コマンドを実行します。

  - Red Hat Enterprise Linux

    事前に.Net8.0をインストールしてください。

    1. rpmパッケージを入手する:
       こちらのリンクからrpmファイルをダウンロードしてください。

    ダウンロード画面の一例

    2. インストールする:
       `sudo dnf install <rpmパッケージパス>`コマンドを実行します。

## 1.4. ORiN3 Configurator

ORiN3 ConfiguratorはORiN3 Remote EngineおよびORiN3プロバイダに対して、ライセンスの管理やORiN3プロバイダのインストールなどができるWindowsアプリケーションです。
ORiN3プロバイダの動作確認も行えるためORiN3アプリケーション開発中に適宜ご利用いただけます。
また、ORiN3 Configurator上で行ったORiN3プロバイダの生成や値の取得などの動作をC#およびPythonのソースコードに出力することもできます。

ORiN3 Configurator

### 1.4.1. システム要件

ORiN3 Configuratorのシステム要件は以下のとおりです。

項目 | 内容
--- | ---
プロセッサ | 1.0 GHz以上のクロック周波数を持つ64ビットデュアルコア以上のプロセッサ
メモリ (RAM) | 4 GB以上（8 GB以上を推奨）
ストレージ | 1 GB以上の空き容量を持つハードディスクまたはSSD
ネットワーク | 100 Mbps以上の帯域幅を持つイーサネット接続

- オペレーティングシステム

  OS | バージョン | アーキテクチャ | 備考
  --- | --- | --- | ---
  Windows | 10,11 | x64 | タブレットモードは非対応

  注釈

  本システム要件におけるオペレーティングシステムは、現時点での情報に基づいており、将来的に変更される可能性があります。
  また、運用時には各オペレーティングシステムの提供元が定めるサポートライフサイクルに従って、適切なバージョンをご使用ください。

### 1.4.2. セットアップ

WindowsのみデンソーウェーブのHPからインストーラがダウンロードできます。

## 1.5. ORiN3 Message Client

ORiN3 Remote Engineのインターフェイスを実装したgRPCクライアントライブラリです。gRPCサーバーとして稼働するORiN3 Remote Engineに対してgRPCクライアントとして接続します。
C#とPythonでそれぞれセットアップが異なります。
これらのプログラム言語以外で開発する場合はリンクを参照してください。

### 1.5.1. C#版のセットアップ

nuget.orgからダウンロードできます。

- Visual Studioからの入手

1. Visual Studioを開く:
   Visual Studioを起動し、対象のプロジェクトをロードします。

2. NuGetパッケージ マネージャーの起動:
   「ツール」メニューから「NuGet パッケージ マネージャー」を選択し、「ソリューションのNuGet パッケージの管理」をクリックします。

3. パッケージの検索:
   「参照」タブを選択し、検索ボックスに「`Message.Client.ORiN3.Provider`」を入力します。

4. パッケージのインストール:
   検索結果から`Message.Client.ORiN3.Provider`のパッケージを選択し、「インストール」ボタンをクリックします。

5. インストールの確認:
   インストールが完了したら、必要に応じてパッケージのバージョンを確認してください。

### 1.5.2. Python版のセットアップ

入手から利用までの手順はpypiのWebサイトを参照してください。

## 1.6. ORiN3 proto ファイル

ORiN3 protoファイルはORiN3 Remote EngineとgRPC(Google Remote Procedure Call)通信するためのインターフェイスを定義しています。
C#とPython以外のgRPCに対応したプログラム言語を使ってORiN3アプリケーションを開発する場合に使用します。

### 1.6.1. セットアップ

ORiN協議会のGitHubにて公開しています。
ORiN-Consortiumを参照してください。

## 1.7. ORiN3 プロバイダ

ORiN3プロバイダとはデバイスと接続するためのライブラリです。接続したい機器、通信規格に応じて適切にご利用ください。
ライセンスによって使用できるプロバイダが異なります。詳細はリンクを参照してください。

### 1.7.1. セットアップ

ORiN3 Configuratorから入手できます。詳細はORiN3 Configuratorのマニュアルを参照してください。

## 1.8. ORiN3 Dockerイメージ

ORiN3 Remote EngineがインストールされているDockerイメージです。Dockerコンテナ上にORiN3環境を構築する場合に使います。

注釈

このDockerイメージに構築されているORiN3にはライセンスが入っていません。必要に応じてライセンスアクティベーションを実施してください。

### 1.8.1. セットアップ

入手から利用までの手順はDockerHubのWebサイトを参照してください。

注釈

Windowsで使用する場合はWindows Subsystem for Linux(WSL)が必要です。