HealthCtrlInfo関数

コントローラーに関する指定した種別の部品の交換推奨時期までの残り月数を返す関数です。

書式
HealthCtrlInfo(部品種別)

パラメーター

部品種別
交換推奨時期までの残り月数を返す部品を整数値 (1)、または以下に示す定数で指定します。

定数 値 モード
HEALTH_CONTROLLER_TYPE_BATTERY 1 バッテリーを指定します。

戻り値
交換推奨時期までの残り月数を実数で返します (単位: 月)。

解説
交換推奨時期までの月数は、過去の使用状況による部品消耗率、およびコントローラーをHealthCalcPeriodで設定された期間稼働するごとに取得される消費率の変化量に基づいて演算されます。

注意

コントローラーをHealthCalcPeriodで設定された期間稼働するごとに取得される消費率の変化量に基づいて交換推奨時期までの残り月数が演算されるため、以下のような場合には正常に演算されません。

  • 稼働時間がHealthCalcPeriodで設定された期間に満たない状況で本コマンドを実行する場合。
  • 長期間のロボット稼働停止期間を終えた後に本コマンドを実行する場合。
  • 部品交換をして部品消耗のリセットを行った後に本コマンドを実行する場合。
  • コントローラーの日時の設定を変更した場合。

このような場合は、コントローラーをHealthCalcPeriodで設定された期間の2倍以上稼働させた後で本コマンドを実行すると正しい値が表示されます。

参照
HealthCtrlAlarmOn関数, HealthRateCtrlInfo関数

HealthCtrlInfo関数使用例
交換推奨時期までの残り月数が1か月以下になったらアラームを出力する例です。

Function AlarmCheck
  Real month

  month = HealthCtrlInfo(HEALTH_CONTROLLER_TYPE_BATTERY)
  If month < 1 Then
    Print "Alarm ON"
  EndIf
Fend

← HealthCtrlRateOffset →

© 2025 Seiko Epson Corp.