1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
|
/*
* Copyright (c) 2010 NVIDIA Corporation.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
#ifndef INCLUDED_NVODM_TOUCH_PANJIT_H
#define INCLUDED_NVODM_TOUCH_PANJIT_H
#include "nvodm_touch_int.h"
#include "nvodm_services.h"
#if defined(__cplusplus)
extern "C"
{
#endif
typedef struct PANJIT_TouchDevice_Rec
{
NvOdmTouchDevice OdmTouch;
NvOdmTouchCapabilities Caps;
NvOdmServicesI2cHandle hOdmI2c;
NvOdmServicesGpioHandle hGpio;
NvOdmServicesPmuHandle hPmu;
NvOdmGpioPinHandle hPin;
NvOdmGpioPinHandle hResetPin;
NvOdmServicesGpioIntrHandle hGpioIntr;
NvOdmOsSemaphoreHandle hIntSema;
NvU32 PrevFingers;
NvU32 DeviceAddr;
NvU32 SampleRate;
NvU32 SleepMode;
NvBool PowerOn;
NvU32 I2cClockSpeedKHz;
} PANJIT_TouchDevice;
/**
* Gets a handle to the touch pad in the system.
*
* @param hDevice A pointer to the handle of the touch pad.
* @return NV_TRUE if successful, or NV_FALSE otherwise.
*/
NvBool PANJIT_Open(NvOdmTouchDeviceHandle *hDevice);
/**
* Releases the touch pad handle.
*
* @param hDevice The touch pad handle to be released. If
* NULL, this API has no effect.
*/
void PANJIT_Close(NvOdmTouchDeviceHandle hDevice);
/**
* Gets capabilities for the specified touch device.
*
* @param hDevice The handle of the touch pad.
* @param pCapabilities A pointer to the targeted
* capabilities returned by the ODM.
*/
void
PANJIT_GetCapabilities(
NvOdmTouchDeviceHandle hDevice,
NvOdmTouchCapabilities* pCapabilities);
/**
* Gets coordinate info from the touch device.
*
* @param hDevice The handle to the touch pad.
* @param coord A pointer to the structure holding coordinate info.
* @return NV_TRUE if successful, or NV_FALSE otherwise.
*/
NvBool
PANJIT_ReadCoordinate(
NvOdmTouchDeviceHandle hDevice,
NvOdmTouchCoordinateInfo *pCoord);
/**
* Hooks up the interrupt handle to the GPIO interrupt and enables the interrupt.
*
* @param hDevice The handle to the touch pad.
* @param hInterruptSemaphore A handle to hook up the interrupt.
* @return NV_TRUE if successful, or NV_FALSE otherwise.
*/
NvBool
PANJIT_EnableInterrupt(
NvOdmTouchDeviceHandle hDevice,
NvOdmOsSemaphoreHandle hInterruptSemaphore);
/**
* Prepares the next interrupt to get notified from the touch device.
*
* @param hDevice A handle to the touch pad.
* @return NV_TRUE if successful, or NV_FALSE otherwise.
*/
NvBool PANJIT_HandleInterrupt(NvOdmTouchDeviceHandle hDevice);
/**
* Gets the touch ADC sample rate.
*
* @param hDevice A handle to the touch ADC.
* @param pTouchSampleRate A pointer to the NvOdmTouchSampleRate stucture.
*
* @return NV_TRUE if successful, or NV_FALSE otherwise.
*/
NvBool
PANJIT_GetSampleRate(
NvOdmTouchDeviceHandle hDevice,
NvOdmTouchSampleRate* pTouchSampleRate);
/**
* Sets the touch ADC sample rate.
*
* @param hDevice A handle to the touch ADC.
* @param SampleRate 1 indicates high frequency, 0 indicates low frequency.
*
* @return NV_TRUE if successful, or NV_FALSE otherwise.
*/
NvBool PANJIT_SetSampleRate(NvOdmTouchDeviceHandle hDevice, NvU32 rate);
/**
* Sets the touch panel power mode.
*
* @param hDevice A handle to the touch ADC.
* @param mode The mode, ranging from full power to power off.
*
* @return NV_TRUE if successful, or NV_FALSE otherwise.
*/
NvBool
PANJIT_PowerControl(
NvOdmTouchDeviceHandle hDevice,
NvOdmTouchPowerModeType mode);
/**
* Gets the touch panel calibration data.
* This is optional as calibration may perform after the OS is up.
* This is not required to bring up the touch panel.
*
* @param hDevice A handle to the touch panel.
* @param NumOfCalibrationData Indicates the number of calibration points.
* @param pRawCoordBuffer The collection of X/Y coordinate data.
*
* @return NV_TRUE if preset calibration data is required, or NV_FALSE otherwise.
*/
NvBool
PANJIT_GetCalibrationData(
NvOdmTouchDeviceHandle hDevice,
NvU32 NumOfCalibrationData,
NvS32* pRawCoordBuffer);
/**
* Powers the touch device on or off.
*
* @param hDevice A handle to the touch ADC.
* @param OnOff Specify 1 to power ON, 0 to power OFF.
*/
NvBool PANJIT_PowerOnOff(NvOdmTouchDeviceHandle hDevice, NvBool OnOff);
#if defined(__cplusplus)
}
#endif
#endif // INCLUDED_NVODM_TOUCH_PANJIT_H
|
