TP_RequestRawSampling

C Specification

#include <nitro/spi.h>
u32 TP_RequestRawSampling( TPData * result );

Arguments

result Pointer to the variable to obtain touch panel values

Return Values

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

Description

This synchronous function requests from ARM7 processor the current touch panel values for a single event and waits until those values are acquired. The values (values that were already checked for chattering) are acquired as uncalibrated, raw values (x and y values take the range of 0 to 4095). This command cannot be used during autosampling.

Note: This function can obtain touch panel values even during MIC auto sampling. (TP auto sampling is not permitted.)
However, because this function executea the next time the microphone sampling ends, more time is may be required for the results response.

Note

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

See Also

TP_RequestCalibratedSampling, TP_RequestSamplingAsync

Revision History

04/21/2004 Initial version