コンテンツにスキップ

ウォッチドッグの設定

SiFli SDKのウォッチドッグ資料は、HALが公開するハードウェアウォッチドッグと、アプリケーションが使うRT-Threadウォッチドッグドライバーの2層に分かれています。インスタンス名、リセット範囲、クロック設定はファミリーによって異なるため、次の比較を確認し、対象チップのSDK設定と資料で動作を確認してください。

表: ファミリー別にHAL資料が示すウォッチドッグ動作

| ファミリー | HALに記載されたウォッチドッグ動作 | HALガイドに記載されたクロック | |---|---| | SF32LB52x | HALガイドには、HCPUとLCPUに専用ウォッチドッグがあり、それぞれ割り込みまたは担当サブシステムのリセットを行えるとあります。また、チップ全体をリセットするシステムIWDTも備えます。 | カウンターは32Kクロックを基準に説明されています。52x固有のクロック選択肢は記載されていません。 | | SF32LB55x | HCPUのWDT1とLCPUのWDT2は割り込みを生成できます。ハードウェアリセットの対象はそれぞれのサブシステムに限られます。システムIWDTは割り込みを生成せず、チップ全体をリセットできます。 | RC10Kまたは32K LXTを選択できます。 | | SF32LB56x / SF32LB58x | HALガイドによると、WDT1/WDT2はチップ全体をリセットする機能も備えます。 | RC10Kを使用し、32K低消費電力クロックからは取得しません。 |

RT-Threadウォッチドッグ使用ガイドの適用範囲

ウォッチドッグ使用ガイドはsf32lb52xのパスで公開されていますが、本文ではSF32LB55Xを明記しています。以下に示す30秒の既定値、IDLEスレッドからのキック、スリープ時の動作、アプリケーション層のリセット手順は、同ガイドに記載された55xの設定に対するものです。SF32全ファミリー共通の保証として扱わず、対象ファミリーの資料と生成された設定で確認してください。

ウォッチドッグを有効化・設定する

プロジェクトディレクトリでsdk.py menuconfigを実行し、RT-Threadのデバイスドライバー設定からウォッチドッグを有効にします。SDKリリースによって正確なメニュー名が異なる場合があるため、対象ファミリーの公式ドキュメントを参照し、ビルド前に生成されたrtconfig.hを確認してください。

上記のウォッチドッグ使用ガイドのmenuconfig例では、次の2つの設定を個別に行います。

  • RTOS → On-chip Peripheral Drivers → Enable Watchdog Timer：チップのハードウェアウォッチドッグタイマーを有効にします。
  • RTOS → RT-Thread Components → Device Drivers → Using Watch Dog device drivers：RT-Threadドライバーを有効にします。

同ガイドの55x設定では、既定タイムアウトは30秒です。ドライバーメニューの(30) Watch Dog timeout (NEW)で別の値を選べます。対象ファミリーの既定値はmenuconfigで確認し、生成された設定をファームウェアイメージとともに保管してください。

以下の図は、同ガイドに掲載されたメニュー位置とタイムアウト設定項目です。ガイドのURLパスと本文が示すチップファミリーが一致しないため、図は参考例として扱い、実際のメニューと既定値はプロジェクトのmenuconfig出力で確認してください。

menuconfigにおけるウォッチドッグドライバー設定

図: SiFliのウォッチドッグ使用ガイドに掲載されたドライバーメニュー。

menuconfigにおけるウォッチドッグタイマー設定

図: SiFliのウォッチドッグ使用ガイドに掲載されたタイマー設定。

キックの方針

システムはRT-ThreadのIDLEスレッドからウォッチドッグをキックします。アプリケーションスレッドが設定したタイムアウトを超えて連続実行しない限り、アプリケーション側で追加のコードは必要ありません。

高優先度スレッドを設定したタイムアウトより長く連続実行する必要がある場合は、そのスレッドから次のAPIでウォッチドッグをキックします。

rt_hw_watchdog_pet();

スケジューラーの停止やデッドロックを隠すような無条件のキックループは追加しないでください。キックする位置は、監視対象の処理が正常に進んでいることを示す箇所にしてください。

スリープとリセットの動作

  • StandbyまたはHibernateに入るとウォッチドッグは無効になり、復帰後に再び有効になります。
  • その他のスリープモードではウォッチドッグが動き続けるため、タイムアウト前にシステムを復帰させてキックする必要があります。
  • HCPUはシステムウォッチドッグを使います。タイムアウトするとチップ全体が再起動します。
  • LCPUはLCPUサブシステムのウォッチドッグを使います。タイムアウトするとまず割り込みが発生し、その割り込みハンドラーがソフトウェアによるチップ全体の再起動を実行します。

検証手順

  1. チップファミリー、SDKリビジョン、タイムアウト、キックを担当する処理、スリープモードを記録します。
  2. 正常な負荷で想定したキック箇所に到達することを確認します。
  3. 意図的にキックを停止し、想定した範囲でリセットされ、起動することを確認します。
  4. 特にStandbyとHibernateを含む、対応する各スリープモードで繰り返します。
  5. リセット時の観測結果と起動時診断の証跡を、製品の復旧試験記録とともに保管します。

公式資料

次のファミリー別ウォッチドッグ・アプリケーションノートのパスは、現時点で確認できていません: sf32lb55x/app_note/watchdog.html、sf32lb56x/app_note/watchdog.html、sf32lb58x/app_note/watchdog.html。検索結果や直接アクセスで確認できないことは、これらのパスが404を返すことを意味しません。

最終更新: