blob: 4a4c2297e2a603c173a5d57ce76a5fad5622e45c (
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
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
|
/**************************************************************************//**
* @file hbi.c
* @version V3.00
* @brief HyperBus Interface (HBI) driver source file
*
* @copyright SPDX-License-Identifier: Apache-2.0
* @copyright Copyright (C) 2020 Nuvoton Technology Corp. All rights reserved.
*****************************************************************************/
#include "NuMicro.h"
/** @addtogroup Standard_Driver Standard Driver
@{
*/
/** @addtogroup HBI_Driver HBI Driver
@{
*/
int32_t g_HBI_i32ErrCode = 0; /*!< HBI global error code */
/** @addtogroup HBI_EXPORTED_FUNCTIONS HBI Exported Functions
@{
*/
/**
* @brief Reset HBI function
* @return None
* @note This function sets g_HBI_i32ErrCode to HBI_TIMEOUT_ERR if waiting Hyper RAM time-out.
*/
void HBI_ResetHyperRAM(void)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
HBI->CMD = HBI_CMD_RESET_HRAM;
g_HBI_i32ErrCode = 0;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
g_HBI_i32ErrCode = HBI_TIMEOUT_ERR;
break;
}
}
}
/**
* @brief Exit from Hybrid sleep and deep Power down function
* @return None
* @note This function sets g_HBI_i32ErrCode to HBI_TIMEOUT_ERR if waiting Hyper RAM time-out.
*/
void HBI_ExitHSAndDPD(void)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
HBI->CMD = HBI_CMD_EXIT_HS_PD;
g_HBI_i32ErrCode = 0;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
g_HBI_i32ErrCode = HBI_TIMEOUT_ERR;
break;
}
}
}
/**
* @brief Read HyperRAM register space
* @param[in] u32Addr Address of HyperRAM register space
* - \ref HYPERRAM_ID_REG0 : 0x0000_0000 = Identification Register 0
* - \ref HYPERRAM_ID_REG1 : 0x0000_0002 = Identification Register 1
* - \ref HYPERRAM_CONFIG_REG0 : 0x0000_1000 = Configuration Register 0
* - \ref HYPERRAM_CONFIG_REG1 : 0x0000_1002 = Configuration Register 1
* @return The data of HyperRAM register.
* @return -1 An illeagal register space
* @return -2 Wait Hyper RAM time-out
*/
int32_t HBI_ReadHyperRAMReg(uint32_t u32Addr)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
if ((u32Addr == HYPERRAM_ID_REG0) || (u32Addr == HYPERRAM_ID_REG1) || (u32Addr == HYPERRAM_CONFIG_REG0) || (u32Addr == HYPERRAM_CONFIG_REG1))
{
HBI->ADR = u32Addr;
HBI->CMD = HBI_CMD_READ_HRAM_REGISTER;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
return HBI_TIMEOUT_ERR;
}
}
return HBI->RDATA;
}
else
{
return -1;
}
}
/**
* @brief Write HyperRAM register space
* @param[in] u32Addr Address of HyperRAM register space
* - \ref HYPERRAM_ID_REG0 : 0x0000_0000 = Identification Register 0
* - \ref HYPERRAM_ID_REG1 : 0x0000_0002 = Identification Register 1
* - \ref HYPERRAM_CONFIG_REG0 : 0x0000_1000 = Configuration Register 0
* - \ref HYPERRAM_CONFIG_REG1 : 0x0000_1002 = Configuration Register 1
* @param[in]
* @return 0 success.
* @return -1 An illeagal register space
* @return -2 Wait Hyper RAM time-out
*/
int32_t HBI_WriteHyperRAMReg(uint32_t u32Addr, uint32_t u32Value)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
if ((u32Addr == HYPERRAM_ID_REG0) || (u32Addr == HYPERRAM_ID_REG1) || (u32Addr == HYPERRAM_CONFIG_REG0) || (u32Addr == HYPERRAM_CONFIG_REG1))
{
HBI->ADR = u32Addr;
HBI->WDATA = u32Value;
HBI->CMD = HBI_CMD_WRITE_HRAM_REGISTER;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
return HBI_TIMEOUT_ERR;
}
}
return 0;
}
else
{
return -1;
}
}
/**
* @brief Read 1 word from HyperRAM space
* @param[in] u32Addr Address of HyperRAM space
* @return The 16 bit data of HyperRAM space.
* @note This function sets g_HBI_i32ErrCode to HBI_TIMEOUT_ERR if waiting Hyper RAM time-out.
*/
uint32_t HBI_Read1Word(uint32_t u32Addr)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
HBI->ADR = u32Addr;
HBI->CMD = HBI_CMD_READ_HRAM_1_WORD;
g_HBI_i32ErrCode = 0;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
g_HBI_i32ErrCode = HBI_TIMEOUT_ERR;
break;
}
}
return HBI->RDATA;
}
/**
* @brief Read 2 word from HyperRAM space
* @param[in] u32Addr Address of HyperRAM space
* @return The 32bit data of HyperRAM space.
*/
uint32_t HBI_Read2Word(uint32_t u32Addr)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
HBI->ADR = u32Addr;
HBI->CMD = HBI_CMD_READ_HRAM_2_WORD;
g_HBI_i32ErrCode = 0;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
g_HBI_i32ErrCode = HBI_TIMEOUT_ERR;
break;
}
}
return HBI->RDATA;
}
/**
* @brief Write 1 byte to HyperRAM space
* @param[in] u32Addr Address of HyperRAM space
* @param[in] u8Data 8 bits data to be written to HyperRAM space
* @return None.
* @note This function sets g_HBI_i32ErrCode to HBI_TIMEOUT_ERR if waiting Hyper RAM time-out.
*/
void HBI_Write1Byte(uint32_t u32Addr, uint8_t u8Data)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
HBI->ADR = u32Addr;
HBI->WDATA = u8Data;
HBI->CMD = HBI_CMD_WRITE_HRAM_1_BYTE;
g_HBI_i32ErrCode = 0;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
g_HBI_i32ErrCode = HBI_TIMEOUT_ERR;
break;
}
}
}
/**
* @brief Write 2 bytes to HyperRAM space
* @param[in] u32Addr Address of HyperRAM space
* @param[in] u16Data 16 bits data to be written to HyperRAM space
* @return None.
* @note This function sets g_HBI_i32ErrCode to HBI_TIMEOUT_ERR if waiting Hyper RAM time-out.
*/
void HBI_Write2Byte(uint32_t u32Addr, uint16_t u16Data)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
HBI->ADR = u32Addr;
HBI->WDATA = u16Data;
HBI->CMD = HBI_CMD_WRITE_HRAM_2_BYTE;
g_HBI_i32ErrCode = 0;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
g_HBI_i32ErrCode = HBI_TIMEOUT_ERR;
break;
}
}
}
/**
* @brief Write 3 bytes to HyperRAM space
* @param[in] u32Addr Address of HyperRAM space
* @param[in] u32Data 24 bits data to be written to HyperRAM space
* @return None.
* @note This function sets g_HBI_i32ErrCode to HBI_TIMEOUT_ERR if waiting Hyper RAM time-out.
*/
void HBI_Write3Byte(uint32_t u32Addr, uint32_t u32Data)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
HBI->ADR = u32Addr;
HBI->WDATA = u32Data;
HBI->CMD = HBI_CMD_WRITE_HRAM_3_BYTE;
g_HBI_i32ErrCode = 0;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
g_HBI_i32ErrCode = HBI_TIMEOUT_ERR;
break;
}
}
}
/**
* @brief Write 4 byte to HyperRAM space
* @param[in] u32Addr Address of HyperRAM space
* @param[in] u32Data 32 bits data to be written to HyperRAM space
* @return None.
* @note This function sets g_HBI_i32ErrCode to HBI_TIMEOUT_ERR if waiting Hyper RAM time-out.
*/
void HBI_Write4Byte(uint32_t u32Addr, uint32_t u32Data)
{
int32_t i32TimeOutCnt = HBI_TIMEOUT;
HBI->ADR = u32Addr;
HBI->WDATA = u32Data;
HBI->CMD = HBI_CMD_WRITE_HRAM_4_BYTE;
g_HBI_i32ErrCode = 0;
while (HBI->CMD != HBI_CMD_HRAM_IDLE)
{
if (i32TimeOutCnt-- <= 0)
{
g_HBI_i32ErrCode = HBI_TIMEOUT_ERR;
break;
}
}
}
/*@}*/ /* end of group HBI_EXPORTED_FUNCTIONS */
/*@}*/ /* end of group HBI_Driver */
/*@}*/ /* end of group Standard_Driver */
|
