カメラヘルスチェック
はじめに
カメラヘルスチェックは、接続されているカメラに対して一連の診断を実行し、レポートを返します(Camera::checkHealth())。個々のチェックにはステータス(深刻度)とその算出元となった値があり、全体ステータスはすべてのチェックの中で最も深刻度の高いものを集約したものです。これは、カメラが規定の範囲内で動作していることを確認したり、ファンの停止やホスト接続の低速化などの問題が生産に影響を及ぼす前に検知したりするのに役立ちます。
同じレポートは Zivid Studio でも確認できます。Health Check を参照してください。
注釈
ヘルスチェックを実行するには、カメラが接続されている必要があります。接続されていないカメラに対して Camera::checkHealth() を呼び出すと、例外がスローされます。
ステータス値
各チェックは、以下のいずれかの深刻度を報告します。
ステータス |
意味 |
|---|---|
OK |
最適な状態です。 |
準最適 |
低下していますが、動作に支障はありません。 |
エラー |
故障、または仕様範囲外です。 |
不明 |
チェックが実行されなかった、またはその結果を判定できませんでした。 |
個々のチェック
チェック |
説明 |
値 |
|---|---|---|
最大転送速度 |
カメラとホストコンピューター間のエンドツーエンドの最大転送速度(カメラのポートリンク速度とホスト PC のネットワークアダプターのリンク速度のうち、低い方の値)です。 |
転送速度(Mbps)。 |
温度(DMD、LED、レンズ) |
カメラの各コンポーネントの温度ステータスです。 |
各コンポーネントの温度(摂氏)。 |
ファン |
カメラのファンが想定どおりに動作しているかどうかです。 |
ファンが稼働しているか、予期せず停止しているかどうか。 |
メモリ |
カメラのメモリテストの結果です。 |
検出されたメモリエラーの数。 |
Infield Verification |
カメラが最後に実行した Infield Verification のステータスです。 |
最後に実行した Infield Verification の日時。 |
各チェックには、ステータスとその算出元となった値の両方が含まれます。値は任意項目であり、設定されない場合もあります(例えば、チェックを実行できなかった場合など)。
注釈
ヘルスチェックは一度限りの診断です。コンポーネントの生の温度(摂氏)を継続的に監視するには、カメラ温度の監視 を参照してください。
ヘルスチェックのポーリング
以下のサンプルは、メインスレッドでキャプチャを継続しながら、別スレッドからヘルスチェックをポーリングし、1 秒ごとに全体ステータスと個々のステータスおよび値を出力します。これにより、実行中のキャプチャループのバックグラウンドでヘルスチェックを監視する方法を示します。
const auto pollInterval = std::chrono::seconds(1);
std::promise<void> stop;
auto stopRequested = stop.get_future();
auto polling = std::async(std::launch::async, [&] {
do
{
printHealthcheck(camera.checkHealth());
std::cout << std::endl;
} while(stopRequested.wait_for(pollInterval) == std::future_status::timeout);
});
const auto settings = Zivid::Settings{ Zivid::Settings::Acquisitions{ Zivid::Settings::Acquisition{} } };
const auto captureCycle = std::chrono::seconds(5);
const size_t numberOfCaptures = 5;
for(size_t i = 1; i <= numberOfCaptures; ++i)
{
const auto frame = camera.capture3D(settings);
std::cout << "Captured frame " << i << " of " << numberOfCaptures << std::endl;
if(i < numberOfCaptures)
{
std::this_thread::sleep_for(captureCycle);
}
}
stop.set_value();
polling.get();
var pollInterval = TimeSpan.FromSeconds(1);
var stop = new ManualResetEventSlim(false);
var pollingTask = Task.Run(() =>
{
while (!stop.IsSet)
{
PrintHealthcheck(camera.CheckHealth());
Console.WriteLine();
stop.Wait(pollInterval);
}
});
var settings = new Zivid.NET.Settings { Acquisitions = { new Zivid.NET.Settings.Acquisition { } } };
var captureCycle = TimeSpan.FromSeconds(5);
const int numberOfCaptures = 5;
for (int i = 1; i <= numberOfCaptures; ++i)
{
using (camera.Capture3D(settings)) { }
Console.WriteLine("Captured frame {0} of {1}", i, numberOfCaptures);
if (i < numberOfCaptures)
{
Thread.Sleep(captureCycle);
}
}
stop.Set();
pollingTask.Wait();
poll_interval = 1
stop = threading.Event()
def poll() -> None:
while not stop.is_set():
_print_healthcheck(camera.check_health())
print()
stop.wait(poll_interval)
polling_thread = threading.Thread(target=poll)
polling_thread.start()
settings = zivid.Settings(acquisitions=[zivid.Settings.Acquisition()])
capture_cycle = 5
number_of_captures = 5
for i in range(1, number_of_captures + 1):
camera.capture_3d(settings)
print(f"Captured frame {i} of {number_of_captures}")
if i < number_of_captures:
time.sleep(capture_cycle)
stop.set()
polling_thread.join()
バージョン履歴
SDK |
変更内容 |
|---|---|
2.18.0 |
カメラヘルスチェックが追加されました。 |