summaryrefslogtreecommitdiff
path: root/bsp/nuvoton_nuc472/Libraries/StdDriver/inc/ps2.h
blob: 4ca07916c015f6c8d18a0ca1cfefc2fc6fd27759 (plain)
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
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
/**************************************************************************//**
 * @file     PS2.h
 * @version  V0.10
 * $Revision: 6 $
 * $Date: 14/10/06 1:58p $
 * @brief    NUC472/NUC442 PS2 Driver Header File
 *
 * @note
 * Copyright (C) 2013 Nuvoton Technology Corp. All rights reserved.
 ******************************************************************************/
#ifndef __PS2_H__
#define __PS2_H__

/*---------------------------------------------------------------------------------------------------------*/
/* Include related headers                                                                                 */
/*---------------------------------------------------------------------------------------------------------*/
#include "NUC472_442.h"

#ifdef __cplusplus
extern "C"
{
#endif


/** @addtogroup NUC472_442_Device_Driver NUC472/NUC442 Device Driver
  @{
*/

/** @addtogroup NUC472_442_PS2_Driver PS2 Driver
  @{
*/


/** @addtogroup NUC472_442_PS2_EXPORTED_FUNCTIONS PS2 Exported Functions
  @{
*/


/**
 *  @brief    This function use to set TX FIFO length.
 *
 *  @param[in]    u32Count    TX FIFO length
 *
 *  @return   None
 * \hideinitializer 
 */
#define PS2_SET_TX_BYTE_CNT(u32Count) (PS2->CTL = (PS2->CTL & ~PS2_CTL_TXFDEPTH_Msk) \
                                      | ((u32Count-1) << PS2_CTL_TXFDEPTH_Pos))

/**
 *  @brief    This function use to get PS2 status.
 *
 *  @param    None
 *
 *  @return   PS2 status
 * \hideinitializer 
 */
#define PS2_GET_STATUS() (PS2->STATUS)

/**
 *  @brief    This function use to clear PS2 status.
 *
 *  @param[in]    u32Mask    Clear the specified status of Ps2 module:
 *                         \ref PS2_STATUS_FRAMEERR_Msk , \ref PS2_STATUS_RXOV_Msk
 *
 *  @return   None
 */
#define PS2_CLR_STATUS(u32Mask) (PS2D->PS2STATUS = u32Mask)

/**
 *  @brief    This function use to clear PS2 Tx FIFO.
 *
 *  @param    None
 *
 *  @return   None
 *  \hideinitializer 
 */
__STATIC_INLINE void PS2_CLEAR_TX_FIFO(void) 
{
    PS2->CTL |= PS2_CTL_CLRFIFO_Msk; 
    PS2->CTL &= ~PS2_CTL_CLRFIFO_Msk;
}

/**
 *  @brief    This function use to clear PS2 Rx interrupt.
 *
 *  @param    None
 *
 *  @return   None
 *  \hideinitializer 
 */
#define PS2_CLR_RX_INT_FLAG() (PS2->INTSTS = PS2_INTSTS_RXIF_Msk)

/**
 *  @brief    This function use to clear PS2 Tx interrupt.
 *
 *  @param    None
 *
 *  @return   None
 *  \hideinitializer 
 */
#define PS2_CLR_TX_INT_FLAG() (PS2->INTSTS = PS2_INTSTS_TXIF_Msk)

/**
 *  @brief    This function use to get PS2 interrupt.
 *
 *  @param[in]    u32IntFlag interrupt flag: \ref PS2_INTSTS_TXIF_Msk , \ref PS2_INTSTS_RXIF_Msk
 *
 *  @return   1: interrupt occurs
 *            0: interrupt not occurs
 *  \hideinitializer 
 */
#define PS2_GET_INT_FLAG(u32IntFlag) ((PS2->INTSTS & u32IntFlag)?1:0)

/**
 *  @brief    This function use to set PS2CLK and PS2DATA pins are controlled by hardware.
 *
 *  @param    None
 *
 *  @return   None
 *  \hideinitializer 
 */
#define PS2_DISABLE_OVERRIDE() (PS2->CTL &= ~PS2_CTL_PS2EN_Msk)

/**
 *  @brief    This function use to set PS2CLK and PS2DATA pins are controlled by software.
 *
 *  @param    None
 *
 *  @return   None
 *  \hideinitializer 
 */
#define PS2_ENABLE_OVERRIDE() (PS2->CTL |= PS2_CTL_PS2EN_Msk)

/**
 *  @brief    This function use to get indicates which data byte in transmit data shift register.
 *
 *  @param    None
 *
 *  @return   The indicates which data byte in transmit data shift register.
 *  \hideinitializer 
 */
#define PS2_GET_TX_BYTE_INDEX() ((PS2->STATUS & PS2_STATUS_BYTEIDX_Msk) >> PS2_STATUS_BYTEIDX_Pos)

/**
 *  @brief    This function use to set PS2DATA Pin low.
 *
 *  @param    None
 *
 *  @return   None.
 *  \hideinitializer 
 */
#define PS2_SET_DATA_LOW() (PS2->CTL &= ~PS2_CTL_FPS2DAT_Msk)

/**
 *  @brief    This function use to set PS2DATA Pin high.
 *
 *  @param    None
 *
 *  @return   None.
 *  \hideinitializer 
 */
#define PS2_SET_DATA_HIGH() (PS2->CTL |= PS2_CTL_FPS2DAT_Msk)

/**
 *  @brief    This function use to set PS2CLK Pin low.
 *
 *  @param    None
 *
 *  @return   None.
 *  \hideinitializer 
 */
#define PS2_SET_CLK_LOW() (PS2->CTL &= ~PS2_CTL_FPS2CLK_Msk)

/**
 *  @brief    This function use to set PS2CLK Pin high.
 *
 *  @param    None
 *
 *  @return   None.
 *  \hideinitializer 
 */
#define PS2_SET_CLK_HIGH() (PS2->CTL |= PS2_CTL_FPS2CLK_Msk)

/**
 *  @brief    If Parity error or Stop bit is Not Received Correctly, Acknowledge will Not be Sent to host at 12th clock.
 *
 *  @param    None
 *
 *  @return   None.
 *  \hideinitializer 
 */
#define PS2_DISABLE_ACK_ALWAYS() (PS2->CTL |= PS2_CTL_ACK_Msk)

/**
 *  @brief    Always sends acknowledge to host at 12th clock for host to device communication.
 *
 *  @param    None
 *
 *  @return   None.
 *  \hideinitializer 
 */
#define PS2_ENABLE_ACK_ALWAYS() (PS2->CTL &= ~PS2_CTL_ACK_Msk)


/*---------------------------------------------------------------------------------------------------------*/
/* Define Function Prototypes                                                                              */
/*---------------------------------------------------------------------------------------------------------*/

void PS2_Open(void);
void PS2_Close(void);
uint8_t PS2_Read(void);
int32_t PS2_Write(uint32_t *pu32Buf, uint32_t u32ByteCount);
void PS2_EnableInt(uint32_t u32Mask);
void PS2_DisableInt(uint32_t u32Mask);


/*@}*/ /* end of group NUC472_442_PS2_EXPORTED_FUNCTIONS */

/*@}*/ /* end of group NUC472_442_PS2_Driver */

/*@}*/ /* end of group NUC472_442_Device_Driver */

#ifdef __cplusplus
}
#endif

#endif //__PS2_H__

/*** (C) COPYRIGHT 2013 Nuvoton Technology Corp. ***/