# TP_RequestSetStability

## C Specification

      #include <nitro/spi.h>

      u32 TP_RequestSetStability(
                  u8      retry ,
                  u16     range );

## Description

Sets the following touch panel chattering provision parameters: the maximum number of retry attempts to obtain the coordinate value and a range for determining stabilization

After this function executes, all of the values that are obtained will have chattering measures applied using the parameters that have been set. If the value does not stabilize by the time the retry number arrives, the touch panel `invalidity` flag will be set, indicating that valid values could not be obtained. By default, the recommended parameter (retry: 3, threshold value: 15) is set. There is no need to call this function unless you need to change the setting.

After sending a request to the ARM7, this function waits internally for the process to complete.

## Notes

This function uses an interrupt to wait for a completion response from the ARM7. If it is called while FIFO receive interrupts from ARM7 are prohibited, it will not be possible to return from the wait state.

## Arguments

`retry` | The maximum number of retry attempts to obtain the coordinate (1 – 255, default: 3)
`range` | Threshold value for determining whether the value has stabilized (0 – 4096, default: 15)

## Return Values

Returns 0 if the request succeeds.
Returns a non-zero value if the request fails.

## Revision History

04/21/2004 Created an asynchronous version, and made it synchronous
04/16/2004 Initial version