Outline ![]()
Files ![]()
loading...
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
/**************************************************************************/
/* */
/* Copyright (c) Microsoft Corporation. All rights reserved. */
/* */
/* This software is licensed under the Microsoft Software License */
/* Terms for Microsoft Azure RTOS. Full text of the license can be */
/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
/* and in the root directory of this software. */
/* */
/**************************************************************************/
#include "fx_stm32_levelx_nor_driver.h"
/* define the struct used to identify the levelx driver to instantiate */
struct fx_lx_nor_driver_instance
{
LX_NOR_FLASH flash_instance;
CHAR name[32];
UINT id;
UINT (*nor_driver_initialize)(LX_NOR_FLASH *);
UINT initialized;
};
static struct fx_lx_nor_driver_instance fx_lx_nor_drivers[MAX_LX_NOR_DRIVERS] =
{
#ifdef LX_NOR_SIMULATOR_DRIVER
{ .name = LX_NOR_SIMULATOR_DRIVER_NAME, .id = LX_NOR_SIMULATOR_DRIVER_ID, .nor_driver_initialize = lx_stm32_nor_simulator_initialize},
#endif
#ifdef LX_NOR_OSPI_DRIVER
{ .name = LX_NOR_OSPI_DRIVER_NAME, .id = LX_NOR_OSPI_DRIVER_ID, .nor_driver_initialize = lx_stm32_ospi_initialize},
#endif
#ifdef LX_NOR_QSPI_DRIVER
{ .name = LX_NOR_QSPI_DRIVER_NAME, .id = LX_NOR_QSPI_DRIVER_ID, .nor_driver_initialize = lx_stm32_qspi_initialize},
#endif
#ifdef LX_NOR_CUSTOM_DRIVER
LX_NOR_CUSTOM_DRIVERS
#endif
};
static struct fx_lx_nor_driver_instance *current_driver = NULL;
/* Exported constants --------------------------------------------------------*/
static ULONG num_drivers = sizeof(fx_lx_nor_drivers)/sizeof(fx_lx_nor_drivers[0]);
/* Exported functions ------------------------------------------------------- */
static UINT find_driver_id(UINT driver_id)
{
UINT i = 0;
for (i = 0; i < num_drivers; i++)
{
if (fx_lx_nor_drivers[i].id == driver_id)
return i;
}
return UNKNOWN_DRIVER_ID;
}
VOID fx_stm32_levelx_nor_driver(FX_MEDIA *media_ptr)
{
ULONG i;
UINT status;
UCHAR *source_buffer;
UCHAR *destination_buffer;
ULONG logical_sector;
/* Process the driver request specified in the media control block.*/
#ifdef USE_LX_NOR_DEFAULT_DRIVER
i = find_driver_id(NOR_DEFAULT_DRIVER);
#else
if (media_ptr->fx_media_driver_info == NULL)
{
i = UNKNOWN_DRIVER_ID;
}
else
{
i = find_driver_id((UINT)media_ptr->fx_media_driver_info);
}
#endif
if (i == UNKNOWN_DRIVER_ID)
{
/* No Driver found return an error */
media_ptr->fx_media_driver_status = FX_MEDIA_INVALID;
return;
}
else
{
current_driver = &fx_lx_nor_drivers[i];
}
switch(media_ptr->fx_media_driver_request)
{
case FX_DRIVER_INIT:
{
if (current_driver->initialized == FX_FALSE)
{
/* Open flash instance*/
status = lx_nor_flash_open(¤t_driver->flash_instance, current_driver->name, current_driver->nor_driver_initialize);
/* LevelX driver correctly initialized */
if (status == LX_SUCCESS)
{
current_driver->initialized = FX_TRUE;
media_ptr->fx_media_driver_status = FX_SUCCESS;
media_ptr->fx_media_driver_free_sector_update = FX_TRUE;
break;
}
else
{
media_ptr->fx_media_driver_status = FX_IO_ERROR;
}
}
else
{
media_ptr->fx_media_driver_status = FX_SUCCESS;
}
break;
}
case FX_DRIVER_UNINIT:
{
/* Successful driver */
status = lx_nor_flash_close(¤t_driver->flash_instance);
if (status == LX_SUCCESS)
{
media_ptr->fx_media_driver_status = FX_SUCCESS;
}
else
{
media_ptr->fx_media_driver_status = FX_IO_ERROR;
}
break;
}
case FX_DRIVER_READ:
{
/* Setup the destination buffer and logical sector. */
logical_sector = media_ptr->fx_media_driver_logical_sector;
destination_buffer =(UCHAR *)media_ptr->fx_media_driver_buffer;
/* Loop to read sectors from flash. */
for (i = 0; i < media_ptr->fx_media_driver_sectors; i++)
{
/* Read a sector from NOR flash. */
status = lx_nor_flash_sector_read(¤t_driver->flash_instance, logical_sector, destination_buffer);
/* Determine if the read was successful. */
if (status != LX_SUCCESS)
{
/* Return an I/O error to FileX. */
media_ptr->fx_media_driver_status = FX_IO_ERROR;
return;
}
/* Move to the next entries. */
logical_sector++;
destination_buffer = destination_buffer + media_ptr->fx_media_bytes_per_sector;
}
/* Successful driver request. */
media_ptr->fx_media_driver_status = FX_SUCCESS;
break;
}
case FX_DRIVER_BOOT_READ:
{
/* Read the boot record and return to the caller. */
/* Setup the destination buffer. */
destination_buffer = (UCHAR *) media_ptr -> fx_media_driver_buffer;
/* Read boot sector from NOR flash. */
status = lx_nor_flash_sector_read(¤t_driver->flash_instance, 0, destination_buffer);
/* Determine if the boot read was successful. */
if (status != LX_SUCCESS)
{
/* Return an I/O error to FileX. */
media_ptr -> fx_media_driver_status = FX_IO_ERROR;
return;
}
/* Successful driver request. */
media_ptr -> fx_media_driver_status = FX_SUCCESS;
break;
}
case FX_DRIVER_WRITE:
{
/* Setup the source buffer and logical sector. */
logical_sector = media_ptr->fx_media_driver_logical_sector;
source_buffer = (UCHAR *) media_ptr->fx_media_driver_buffer;
/* Loop to write sectors to flash. */
for (i = 0; i < media_ptr->fx_media_driver_sectors; i++)
{
/* Write a sector to NOR flash. */
status = lx_nor_flash_sector_write(¤t_driver->flash_instance, logical_sector, source_buffer);
/* Determine if the write was successful. */
if (status != LX_SUCCESS)
{
/* Return an I/O error to FileX. */
media_ptr->fx_media_driver_status = FX_IO_ERROR;
return;
}
/* Move to the next entries. */
logical_sector++;
source_buffer = source_buffer + media_ptr->fx_media_bytes_per_sector;
}
/* Successful driver request. */
media_ptr->fx_media_driver_status = FX_SUCCESS;
break;
}
case FX_DRIVER_BOOT_WRITE:
{
/* Write the boot record and return to the caller. */
/* Setup the source buffer. */
source_buffer = (UCHAR *) media_ptr -> fx_media_driver_buffer;
/* Write boot sector to NOR flash. */
status = lx_nor_flash_sector_write(¤t_driver->flash_instance, 0, source_buffer);
/* Determine if the boot write was successful. */
if (status != LX_SUCCESS)
{
/* Return an I/O error to FileX. */
media_ptr -> fx_media_driver_status = FX_IO_ERROR;
return;
}
/* Successful driver request. */
media_ptr -> fx_media_driver_status = FX_SUCCESS;
break ;
}
case FX_DRIVER_RELEASE_SECTORS:
{
/* Setup the logical sector. */
logical_sector = media_ptr->fx_media_driver_logical_sector;
/* Release sectors. */
for (i = 0; i < media_ptr->fx_media_driver_sectors; i++)
{
/* Release NOR flash sector. */
status = lx_nor_flash_sector_release(¤t_driver->flash_instance, logical_sector);
/* Determine if the sector release was successful. */
if (status != LX_SUCCESS)
{
/* Return an I/O error to FileX. */
media_ptr->fx_media_driver_status = FX_IO_ERROR;
return;
}
/* Move to the next entries. */
logical_sector++;
}
/* Successful driver request. */
media_ptr->fx_media_driver_status = FX_SUCCESS;
break;
}
case FX_DRIVER_FLUSH:
{
/* Return driver success. */
media_ptr->fx_media_driver_status = FX_SUCCESS;
break;
}
case FX_DRIVER_ABORT:
{
/* Return driver success. */
media_ptr->fx_media_driver_status = FX_SUCCESS;
break;
}
default:
{
/* Invalid driver request. */
media_ptr->fx_media_driver_status = FX_IO_ERROR;
break;
}
}
}