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
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
/*
****************************************************************************
PROJECT : HYPB driver
FILE : $Id: r_hypb_sys.h 14751 2017-09-25 04:27:33Z shinya.tomari $
============================================================================
DESCRIPTION
HYPB support functions
============================================================================
C O P Y R I G H T
============================================================================
Copyright (c) 2016
by
Renesas Electronics (Europe) GmbH.
Arcadiastrasse 10
D-40472 Duesseldorf
Germany
All rights reserved.
============================================================================
Purpose: only for testing, not for mass production
DISCLAIMER
LICENSEE has read, understood and accepted the terms and conditions defined in
the license agreement, especially the usage rights. In any case, it is
LICENSEE's responsibility to make sure that any user of the software complies
with the terms and conditions of the signed license agreement.
SAMPLE CODE is not part of the licensed software, as such it must not be used in
mass-production applications. It can only be used for evaluation and
demonstration purposes at customer's premises listed in the signed license
agreement.
****************************************************************************
*/
/***************************************************************************
Title: HYPB Driver support functions
HYPB (HyperBus Controller) driver support functions
The generic HYPB driver uses these functions. They have to be implemented
within the driver library for a concrete device. (e.g. D1L, D1M)
Support functions are functions that are not part of the driver itself
but they must be provided to integrate the driver on a particular board.
*/
#ifndef R_HYPB_SYS_H
#define R_HYPB_SYS_H
#ifdef __cplusplus
extern "C" {
#endif
/***************************************************************************
Section: Global Functions
*/
/***************************************************************************
Group: HYPB driver Basic interface functions
*/
/***************************************************************************
Function: R_HYPB_Sys_Init
Description:
This function initializes environment-dependent part.
This function is called from <R_HYPB_Init>.
This function executes the following processing.
* Checks whether this LSI supports HYPB function.
Customizing Points:
It is NOT necessary to modify this function in general use-case.
If you want to add the initialization code of environment-depend (e.g. clock control),
please implement to this function.
Parameter:
Unit - Instance number.
Return value:
R_HYPB_ERR_OK - No error has occurred.
R_HYPB_ERR_RANGE_UNIT - Unit number is out of range.
R_HYPB_ERR_DEVICE - HYPB driver is not applicable to target d1x device.
R_HYPB_ERR_FATAL_HW - Fatal error has occurred at H/W.
See <r_hypb_Error_t>.
*/
r_hypb_Error_t R_HYPB_Sys_Init(const uint32_t Unit);
/***************************************************************************
Function: R_HYPB_Sys_DeInit
Description:
This function de-initializes environment-dependent part.
This function is called from <R_HYPB_DeInit>.
This function is empty as default.
Customizing Points:
It is NOT necessary to modify this function in general use-case.
If you want to add the de-initialization code of environment-depend (e.g. clock control),
please implement to this function.
Parameter:
Unit - Instance number.
Return value:
R_HYPB_ERR_OK - No error has occurred.
R_HYPB_ERR_RANGE_UNIT - Unit number is out of range.
R_HYPB_ERR_FATAL_HW - Fatal error has occurred at H/W.
See <r_hypb_Error_t>.
*/
r_hypb_Error_t R_HYPB_Sys_DeInit(const uint32_t Unit);
/***************************************************************************
Function: R_HYPB_Sys_BaseAddrGet
Description:
This function gives back the base address of HYPB H/W macro's register.
This function is called from several HYPB APIs.
This function executes the following processing.
* Returns the base address of HYPB H/W macro's register.
Customizing Points:
It is NOT necessary to modify this function in general use-case.
Parameter:
Unit - Instance number.
Return value:
Macro base address.
*/
uint32_t R_HYPB_Sys_BaseAddrGet(const uint32_t Unit);
/***************************************************************************
Function: R_HYPB_Sys_ConfigRegSet
Description:
This function makes the value to set configuration register.
This function is called from <R_HYPB_Open>.
This function executes the following processing.
* Checks the original configuration register value.
> - If it looks normal value, uses the value as-is.
> - If it doesn't look normal value, uses the register default value.
* Reflects latency code to register value.
* Reflects parameter-sector settings to register value in case of Hyper Flash.
* Returns the making register value.
Customizing Points:
This function is sample code for (I)S26KL512S/(I)S26KL256S/(I)S26KL128S and IS66WVH16M8BLL.
If you use other Hyper flash or Hyper RAM, it must be changed according to the connected device
specification.
Parameter:
Unit - Instance number.
Config - Pointer to <r_hypb_Config_t> structure.
RegVal - Original value of configuration register.
Return value:
Set value to configuration register.
*/
uint16_t R_HYPB_Sys_ConfigRegSet(const uint32_t Unit,
const r_hypb_Config_t * const Config,
const uint16_t RegVal);
/***************************************************************************
Function: R_HYPB_Sys_StatusRegCheck
Description:
This function returns the result code from status register value.
This function also judges the time out of status polling.
This function is called from <R_HYPB_DataErase> and <R_HYPB_DataWrite>.
This function executes the following processing.
* Checks the calling counter. If it reaches to time-out count, returns R_HYPB_ERR_TIMEOUT.
* Checks READY bit. If it shows BUSY state, returns R_HYPB_ERR_NOT_ACCEPTABLE.
* Checks Erase / Program Status bit. it shows Successful, returns R_HYPB_ERR_OK.
* Checks Sector Lock Status bit.
> - it shows Sector Locked Error, returns R_HYPB_ERR_PROTECTED.
> - it shows Sector Not Locked, returns R_HYPB_ERR_ABORTED.
Customizing Points:
* This function is sample code for (I)S26KL512S/(I)S26KL256S/(I)S26KL128S and IS66WVH16M8BLL.
If you use other Hyper flash or Hyper RAM, it must be changed according to the connected device
specification.
* If you want to change time-out count, please modify the definition R_HYPB_STATUS_TIMEOUT in
r_config_hypb.h.
* This function is called from busy wait. Please implement CPU relaxing to avoid blocking.
Parameter:
Unit - Instance number.
CmdType - Command type.
RegVal - Value of the status register.
Count - Call counter.
Return value:
R_HYPB_ERR_OK - No error has occurred.
R_HYPB_ERR_RANGE_UNIT - Unit number is out of range.
R_HYPB_ERR_PARAM_INCORRECT - A parameter is incorrect.
R_HYPB_ERR_NOT_ACCEPTABLE - A process is executing.
R_HYPB_ERR_FATAL_OS - Fatal error has occurred at OS interface.
R_HYPB_ERR_PROTECTED - A process is aborted because of memory protection.
R_HYPB_ERR_ABORTED - A process is aborted because of other reason.
R_HYPB_ERR_TIMEOUT - Status polling is timeout.
See <r_hypb_Error_t>.
*/
r_hypb_Error_t R_HYPB_Sys_StatusRegCheck(const uint32_t Unit,
const r_hypb_CmdType_t CmdType,
const uint16_t RegVal,
const uint32_t Count);
/***************************************************************************
Function: R_HYPB_Sys_SyncPeripheral
Description:
This function performs synchronization processing to reflect updated
contents of the control register.
This function is called from several HYPB APIs.
This function executes the following processing.
* SYNCP instruction of RH850 is executed.
Customizing Points:
It is NOT necessary to modify this function in general use-case.
Parameter:
None
Return value:
None
*/
void R_HYPB_Sys_SyncPeripheral(void);
/***************************************************************************
Group: HYPB driver OS interface functions
*/
/***************************************************************************
Function: R_HYPB_Sys_Lock
Description:
This function locks the HYPB driver access to the specified unit from other threads.
This function is called from several HYPB APIs.
This function is empty as default.
Customizing Points:
Please implement the lock process by mutex or semaphore if HYPB API is called from
multi-thread.
Parameter:
Unit - Instance number.
Return value:
R_HYPB_ERR_OK - No error has occurred.
R_HYPB_ERR_RANGE_UNIT - Unit number is out of range.
R_HYPB_ERR_FATAL_OS - Fatal error has occurred at OS interface.
See <r_hypb_Error_t>.
*/
r_hypb_Error_t R_HYPB_Sys_Lock(const uint32_t Unit);
/***************************************************************************
Function: R_HYPB_Sys_Unlock
Description:
This function unlocks the HYPB driver access to the specified unit from other threads.
This function is called from several HYPB APIs.
This function is empty as default.
Customizing Points:
Please implement the unlock process depending on <R_HYPB_Sys_Lock>.
Parameter:
Unit - Instance number.
Return value:
R_HYPB_ERR_OK - No error has occurred.
R_HYPB_ERR_RANGE_UNIT - Unit number is out of range.
R_HYPB_ERR_FATAL_OS - Fatal error has occurred at OS interface.
See <r_hypb_Error_t>.
*/
r_hypb_Error_t R_HYPB_Sys_Unlock(const uint32_t Unit);
/***************************************************************************
Function: R_HYPB_Sys_Relax
Description:
This function relaxes CPU to avoid blocking.
This function is called from <R_HYPB_DataWrite> and <R_HYPB_DataRead>.
This function is empty as default.
Customizing Points:
Please implement the relaxing or re-scheduling process if necessary.
Parameter:
Unit - Instance number.
Return value:
R_HYPB_ERR_OK - No error has occurred.
R_HYPB_ERR_RANGE_UNIT - Unit number is out of range.
R_HYPB_ERR_FATAL_OS - Fatal error has occurred at OS interface.
See <r_hypb_Error_t>.
*/
r_hypb_Error_t R_HYPB_Sys_Relax(const uint32_t Unit);
#ifdef __cplusplus
}
#endif
#endif /* R_HYPB_SYS_H */