ネットワーク設定
注意
ネットワーク構成の正しい手順は、 SDK のバージョンによって異なります。左上のドロップダウンで SDK バージョンを選択します。
デフォルト設定
イーサネットベースの Zivid カメラは、以下の表に示すデフォルトの静的 IP が設定されて出荷されます。カメラに接続するには、インターフェースするネットワークカードの IP がカメラと同じサブネット範囲内にある必要があります。
このチュートリアルの前にカメラをまったく設定していないか、カメラがまだデフォルト設定のままであることがわかっているとします。その場合は、 PC のインターフェースネットワークカードを設定してから接続してください。これを行うには、 静的 IP ネットワーク構成 - PC を参照してください。
IP |
サブネットマスク |
ゲートウェイ |
ホスト名 |
|
|---|---|---|---|---|
Zivid カメラ |
|
|
|
|
使用可能な PC |
|
|
|
カスタム構成
たとえば次のような場合には、カスタム構成が必要です。
カメラの IP またはホスト名を変更したい
カメラがデフォルト設定ではない
複数のカメラに接続したい
Zivid SDK が接続できるカメラを制限したい
これには、カメラと PC の静的 IP の変更だけでなく、それらを動的モードに構成することも含まれる場合があります。カスタム構成は、静的 IP 構成と動的 IP 構成に分かれています。
これはカメラのデフォルト設定であり、静的 IP 172.28.60.5 が割り当てられます。次のガイドでは、カメラと PC の両方の静的 IP を変更および構成する方法について説明します。
カメラは、 DHCP またはリンクローカルを使用した自動 IP 構成もサポートしています。自動 IP を使用するように設定されている場合、カメラは最初に DHCP を使用して IP アドレスの取得を試みます（約 45 秒以内）。 DHCP サーバーから IP アドレスを取得するには、ネットワーク上のルーターまたはローカルの PC 上で DHCP サーバーが実行されている必要があります。
次のガイドでは、 DHCP またはリンクローカルを使用して、 PC とカメラの両方に動的 IP を構成する方法について説明します。
カメラへの接続
デフォルト設定 または カスタム構成 のいずれかに従っていると仮定すると、これでカメラに接続できるはずです。プロセスで初めてカメラが接続されるときは、接続するまでに 10〜20 秒かかる場合があることに注意してください。カメラを検出して接続するには、2 つの推奨方法があります。
Zivid Studio を開き、カメラを検出して接続できることを確認します。
ZividListCameras CLI ツールを使用して接続をテストします。このツールは、 Windows では Zivid SDK とともにインストールされ、 Ubuntu では Zivid Tools パッケージとともにインストールされます。
ZividListCameras --test-connect
それでもカメラを検出または接続できない場合は、トラブルシューティング記事 No cameras found in Zivid Studio を参照してください。
パフォーマンス
撮影時間は、カメラとネットワークインターフェース間の接続速度や使用する撮影設定などによって異なります。最適なパフォーマンスを得るには、カメラは 10 Gbps の速度を必要とします。お使いのコンピューターに 10 ギガビットイーサネットポートがない場合でも、 Thunderbolt 3 - 10GbE アダプターを使用して接続できます。パフォーマンスは低下しますが、 5GbE 、 2.5GbE 、または 1GbE も使用できます。
特定のキャプチャ設定（プリセットを含む）の最大帯域幅を確認するには、 キャプチャ速度計算ツール を参照してください。
ヒント
カメラの背面にある ステータス LED は現在のリンク容量を示します。
パフォーマンス |
ネットワーク |
インターフェース |
接続 |
|---|---|---|---|
最適（推奨） |
10GbE（10Gbps） |
PCIe カード |
直接 |
非常に良好 |
10GbE |
Thunderbolt アダプター |
直接 |
良好 |
5GbE または 2.5GbE |
PCIe/USB/Thunderbolt アダプター |
ダイレクト/スイッチ |
最小 |
1GbE（1Gbps） |
PCIe/USB アダプター |
ダイレクト/スイッチ |
注意
USB ベースのネットワークアダプターでは、キャプチャ速度が低下して変動が大きくなるため、カメラの使用時にエラーが発生する場合があります。
Cameras.yml と検出可能なカメラを制限する方法
設定ファイル Cameras.yml を使用して、 Zivid SDK が接続できる IP アドレスとホスト名を制限できます。 Zivid SDK がカメラを検出する方法と Cameras.yml の使用方法の詳細については、下のドロップダウンを使用してください。
Cameras.yml と Zivid SDK がカメラを検出する方法
Zivid SDK はどのようにしてカメラを見つけますか？
Zivid SDK は、ネットワーク上のカメラを自動検出するためにマルチキャスト DNS (mDNS) を使用します。 SDK 2.7 以前では、デフォルト以外の IP を持つカメラは、 Zivid 設定フォルダー内の Cameras.yml ファイルにリストされている必要があり、 SDK はカメラを検出するためにこのファイルを検索しました。
mDNS では Cameras.yml の要件が削除されていますが、このファイルは SDK が接続できるカメラをオーバーライドするために引き続き使用される可能性があります。したがって Cameras.yml は、 PC に接続できるカメラを制限する機能があります（指定されている場合）。
If you only need to connect to a specific camera at a known address, you can connect to it directly by its IP address or hostname, without Cameras.yml.
See キャプチャチュートリアル for how to do this.
Cameras.yml
Zivid SDK が検索する IP を制限したい場合は、以下に示すように Cameras.yml をダウンロードし、 Zivid 設定フォルダーに配置します。
mkdir %LOCALAPPDATA%\Zivid\API
move %HOMEPATH%\Downloads\Cameras.yml %LOCALAPPDATA%\Zivid\API\
mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
mv ~/Downloads/Cameras.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/
注意
既存の設定ファイルは上書きされます。
注意
Zivid 設定ファイルは、 .yml ファイル拡張子（ .yaml ではない）を使用する必要があります。
Cameras.yml がどのように見えるかの例を、ホスト名または IP アドレスを使用して以下に示します。
__version__: 1
Cameras:
NetworkCameras:
- NetworkCamera:
Host: zivid-2152D404.local
- NetworkCamera:
Host: zivid-20205M19.local
- NetworkCamera:
Host: zivid-21389K63.local
__version__: 1
Cameras:
NetworkCameras:
- NetworkCamera:
Host: 172.28.60.5
- NetworkCamera:
Host: 172.28.60.6
- NetworkCamera:
Host: 172.28.60.7
バージョン履歴
SDK |
変更点 |
|---|---|
2.13.0 |
Zivid Studio および SDK にネットワーク設定のサポートを追加しました。 |
2.11.0 |
利用可能なカメラと利用できないカメラの両方を一覧表示して設定するためのネットワーク検出が改善されました。 |
2.8.0 |
マルチキャスト DNS を使用した自動検出のサポートが追加され、デフォルト以外の IP を持つカメラを検出するための |
2.7.0 |
マルチキャスト DNS を使用した、 |