1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<title>TP_RequestAutoSamplingStartAsync</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">TP_RequestAutoSamplingStartAsync <img src="../../image/NTR.gif"><img src="../../image/TWL.gif"></h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <nitro/spi.h></CODE><BR> 20 <PRE><CODE>void TP_RequestAutoSamplingStartAsync( 21 u16 vcount, 22 u16 frequence, 23 <A href="TPData.html">TPData</A> samplingBufs[], 24 u16 bufSize );</CODE></PRE> 25 </dd> 26</dl><h2>Arguments</h2> 27<TABLE border="1" width="100%"> 28 <TBODY> 29 <TR> 30 <TD width="300"><em><strong><font face="Courier New">vcount</font></strong></em></TD> 31 <TD width="700">Base V-count value for auto sampling.</TD> 32 </TR> 33 <TR> 34 <TD><em><strong><font face="Courier New">frequence</font></strong></em></TD> 35 <TD>The number of samples taken during one frame (MAX 4).</TD> 36 </TR> 37 <TR> 38 <TD><em><strong><font face="Courier New">samplingBufs</font></strong></em></TD> 39 <TD>The pointer that sets the buffer in which auto sampling values are stored. At minimum you must secure a region large enough to contain <b><i><code>frequence</code></i></b> * <code><a href="TPData.html">TPData</a></code>.</TD> 40 </TR> 41 <TR> 42 <TD><em><strong><font face="Courier New">bufSize</font></strong></em></TD> 43 <TD>The element count of the buffer passed by <CODE>samplingBufs</CODE>.</TD> 44 </TR> 45 </TBODY> 46</TABLE> 47<h2>Return Values</h2> 48<p>None.</p> 49<H2>Description</H2> 50<P>This function asynchronously issues a request to ARM7 to begin auto sampling touch panel values. Once this request is accepted, sampling occurs periodically and values are stored in the array specified by <b><i><code>samplingBufs</code></i></b>. The autosampling interval is the interval at which VAlarm samples data uniformly, <code><STRONG><EM>frequence</EM></STRONG></code> times per frame, based on the value set in <code><STRONG><EM>vcount</EM></STRONG></code>.<BR>However, the V-count values in the time range of 200 to 214 are not used for sampling. This is because the V-count values may be changed by <CODE>GX_SetVCount</CODE>. If the V-count value to be sampled is contained in this interval, sampling is delayed until line 215.<BR>If a user callback is set with the <CODE><A href="TP_SetCallback.html">TP_SetCallback</A></CODE> function, notification is given by a callback each time a value is saved. After this function clears <b><i><code>samplingBufs</code></i></b>, the buffer will be used as a loop buffer. The <CODE><A href="TP_GetLatestIndexInAuto.html">TP_GetLatestIndexInAuto</A></CODE> function can be used to get the index of the data that was last saved. When auto-sampling, it is possible that the sampling value for (newest index + 1) will be unexpectedly overwritten by an interrupt. If you are using the sampling values from one frame all together, you can avoid this by securing an area that is at least <b><i><code>frequence</code></i></b> + 1.<BR><BR> <STRONG>Note:</STRONG><BR>In this function, you must confirm whether the request to ARM7 was properly processed. <BR>The success or failure of the request must be obtained either with an argument in a user callback, or with the <CODE><A href="TP_CheckError.html">TP_CheckError</A></CODE> function after using the <code><a href="TP_WaitBusy.html">TP_WaitBusy</a></code> function to wait for completion.</P> 51<h2>See Also</h2> 52<P><CODE><A href="TP_RequestAutoSamplingStop.html">TP_RequestAutoSamplingStop</A>, <A href="TP_GetLatestRawPointInAuto.html">TP_GetLatestRawPointInAuto</A>,<A href="TP_GetLatestCalibratedPointInAuto.html">TP_GetLatestCalibratedPointInAuto</A>, <A href="TP_GetLatestIndexInAuto.html">TP_GetLatestIndexInAuto</A>,<A href="TP_WaitBusy.html">TP_WaitBusy</A>, <A href="TP_CheckError.html">TP_CheckError</A>,<A href="TP_RequestAutoSamplingStart.html">TP_RequestAutoSamplingStart</A>, <A href="TPData.html">TPData</A></CODE></P> 53<H2>Revision History</H2> 54<P> 552007/10/29 Added a description.<br> 2007/10/16 Added an explanation of unused V-count values.<br>2006/09/01 Revised the description of <CODE>bufSize</CODE>.<br>2004/04/21 Initial version. 56</P> 57<hr><p>CONFIDENTIAL</p></body> 58</html> 59
