# TP_RequestSetStability

## 構文

  `#include <nitro/spi.h>`

      u32 TP_RequestSetStability( u16 retry, u16 range );

## 引数

retry | ※この引数は互換のために残されていますが、内部では使用されておりません。
range | 値が安定したかどうかを判定するための閾値 ( 0〜255 デフォルト値:20 ）

## 返り値

要求が成功した場合には 0を返します。
失敗した場合には 0 以外を返します。

## 説明

タッチパネルのチャタリング対策パラメータとして、安定した座標値だと判定するための振れ幅を設定します。
タッチパネルから取得できる座標単位(0~4095)で最大255までの幅が設定可能です。
この関数が実行されると、以降常に設定したパラメータでチャタリング対策をされた値が取得されます。
座標値がこの設定の幅に収束しなかった場合には、`TPData`で取得されるタッチパネル値のvalidityフラグが立つことで有効な値が取得できなかったことを示します。
アプリケーション作成の際にはtouchの値がONかつvalidityの値がINVALIDである値が格納された場合でも異常な動作を行なわないよう、最後に取得されたVALID値の座標データを使用するなどの対策をとられることを推奨いたします。
チャタリング対策パラメータはデフォルトで推奨パラメータ(閾値:20)に設定されますので、特に設定を変更する必要のない場合はこの関数をコールする必要はありません。

ARM7へ要求を送った後、処理が完了するまで内部でウェイトを行います。

## 注意

この関数はARM7からの完了応答を割り込みで待ちます。ARM7からのFIFO受信割り込みが禁止された状態でコールされるとウェイトから復帰できなくなりますのでご注意ください。

## 参照

`TPData`

## 履歴

Ver. 2004/12/29 retry引数が使用されなくなった旨の説明を追加
Ver. 2004/04/21 非同期版を作成して同期化
Ver. 2004/04/16 初版