Snapdragon® Telematics Application Framework (TelAF) Interface Specification
taf_flash_common.h
Go to the documentation of this file.
1 
2 /*
3  * ====================== WARNING ======================
4  *
5  * THE CONTENTS OF THIS FILE HAVE BEEN AUTO-GENERATED.
6  * DO NOT MODIFY IN ANY WAY.
7  *
8  * ====================== WARNING ======================
9  */
10 #ifndef TAF_FLASH_COMMON_H_INCLUDE_GUARD
11 #define TAF_FLASH_COMMON_H_INCLUDE_GUARD
12 
13 
14 #include "legato.h"
15 
16 #define IFGEN_TAF_FLASH_PROTOCOL_ID "b36da29f4d7707ec3eceaa2f60f31c0a"
17 #define IFGEN_TAF_FLASH_MSG_SIZE 16404
18 
19 
20 
21 //--------------------------------------------------------------------------------------------------
25 //--------------------------------------------------------------------------------------------------
26 #define TAF_FLASH_PARTITION_NAME_MAX_BYTES 128
27 
28 //--------------------------------------------------------------------------------------------------
32 //--------------------------------------------------------------------------------------------------
33 #define TAF_FLASH_MTD_PAGE_MAX_WRITE_SIZE 4096
34 
35 //--------------------------------------------------------------------------------------------------
39 //--------------------------------------------------------------------------------------------------
40 #define TAF_FLASH_MTD_PAGE_MAX_READ_SIZE 4096
41 
42 //--------------------------------------------------------------------------------------------------
46 //--------------------------------------------------------------------------------------------------
47 #define TAF_FLASH_MTD_MAX_READ_SIZE 16384
48 
49 //--------------------------------------------------------------------------------------------------
53 //--------------------------------------------------------------------------------------------------
54 #define TAF_FLASH_MTD_MAX_WRITE_SIZE 16384
55 
56 //--------------------------------------------------------------------------------------------------
60 //--------------------------------------------------------------------------------------------------
61 #define TAF_FLASH_VOLUME_NAME_MAX_BYTES 64
62 
63 //--------------------------------------------------------------------------------------------------
67 //--------------------------------------------------------------------------------------------------
68 #define TAF_FLASH_VOLUME_TYPE_MAX_BYTES 128
69 
70 //--------------------------------------------------------------------------------------------------
74 //--------------------------------------------------------------------------------------------------
75 #define TAF_FLASH_UBI_MAX_READ_SIZE 16384
76 
77 //--------------------------------------------------------------------------------------------------
81 //--------------------------------------------------------------------------------------------------
82 #define TAF_FLASH_UBI_MAX_WRITE_SIZE 16384
83 
84 //--------------------------------------------------------------------------------------------------
88 //--------------------------------------------------------------------------------------------------
89 typedef struct taf_flash_Partition* taf_flash_PartitionRef_t;
90 
91 
92 //--------------------------------------------------------------------------------------------------
96 //--------------------------------------------------------------------------------------------------
97 typedef struct taf_flash_Volume* taf_flash_VolumeRef_t;
98 
99 
100 //--------------------------------------------------------------------------------------------------
104 //--------------------------------------------------------------------------------------------------
105 typedef enum
106 {
113 }
115 
116 
117 
118 //--------------------------------------------------------------------------------------------------
122 //--------------------------------------------------------------------------------------------------
124 (
125  void
126 );
127 
128 
129 //--------------------------------------------------------------------------------------------------
133 //--------------------------------------------------------------------------------------------------
135 (
136  void
137 );
138 
139 
140 //--------------------------------------------------------------------------------------------------
144 //--------------------------------------------------------------------------------------------------
146 (
147  le_msg_SessionRef_t _ifgen_sessionRef
148 );
149 
150 
151 //--------------------------------------------------------------------------------------------------
155 //--------------------------------------------------------------------------------------------------
157 (
158  le_msg_SessionRef_t _ifgen_sessionRef,
159  bool isBlocking
160 );
161 
162 //--------------------------------------------------------------------------------------------------
173 //--------------------------------------------------------------------------------------------------
175 (
176  le_msg_SessionRef_t _ifgen_sessionRef
177 );
178 
179 //--------------------------------------------------------------------------------------------------
188 //--------------------------------------------------------------------------------------------------
190 (
191  le_msg_SessionRef_t _ifgen_sessionRef,
192  const char* LE_NONNULL partitionName,
196  taf_flash_PartitionRef_t* partitionRefPtr
198 );
199 
200 //--------------------------------------------------------------------------------------------------
209 //--------------------------------------------------------------------------------------------------
211 (
212  le_msg_SessionRef_t _ifgen_sessionRef,
213  taf_flash_PartitionRef_t partitionRef
215 );
216 
217 //--------------------------------------------------------------------------------------------------
226 //--------------------------------------------------------------------------------------------------
228 (
229  le_msg_SessionRef_t _ifgen_sessionRef,
230  taf_flash_PartitionRef_t partitionRef,
232  uint32_t* blocksNumberPtr,
234  uint32_t* badBlocksNumberPtr,
236  uint32_t* blockSizePtr,
238  uint32_t* pageSizePtr
240 );
241 
242 //--------------------------------------------------------------------------------------------------
251 //--------------------------------------------------------------------------------------------------
253 (
254  le_msg_SessionRef_t _ifgen_sessionRef,
255  taf_flash_PartitionRef_t partitionRef,
257  uint32_t blockIndex
259 );
260 
261 //--------------------------------------------------------------------------------------------------
270 //--------------------------------------------------------------------------------------------------
272 (
273  le_msg_SessionRef_t _ifgen_sessionRef,
274  taf_flash_PartitionRef_t partitionRef,
276  uint32_t pageIndex,
278  uint8_t* readDataPtr,
280  size_t* readDataSizePtr
282 );
283 
284 //--------------------------------------------------------------------------------------------------
293 //--------------------------------------------------------------------------------------------------
295 (
296  le_msg_SessionRef_t _ifgen_sessionRef,
297  taf_flash_PartitionRef_t partitionRef,
299  uint32_t pageIndex,
301  const uint8_t* writeDataPtr,
303  size_t writeDataSize
305 );
306 
307 //--------------------------------------------------------------------------------------------------
316 //--------------------------------------------------------------------------------------------------
318 (
319  le_msg_SessionRef_t _ifgen_sessionRef,
320  taf_flash_PartitionRef_t partitionRef,
322  uint32_t offset,
324  uint8_t* readDataPtr,
326  size_t* readDataSizePtr
328 );
329 
330 //--------------------------------------------------------------------------------------------------
339 //--------------------------------------------------------------------------------------------------
341 (
342  le_msg_SessionRef_t _ifgen_sessionRef,
343  taf_flash_PartitionRef_t partitionRef,
345  uint32_t offset,
347  const uint8_t* writeDataPtr,
349  size_t writeDataSize
351 );
352 
353 //--------------------------------------------------------------------------------------------------
362 //--------------------------------------------------------------------------------------------------
364 (
365  le_msg_SessionRef_t _ifgen_sessionRef,
366  taf_flash_PartitionRef_t partitionRef
368 );
369 
370 //--------------------------------------------------------------------------------------------------
379 //--------------------------------------------------------------------------------------------------
381 (
382  le_msg_SessionRef_t _ifgen_sessionRef,
383  taf_flash_PartitionRef_t partitionRef,
385  uint32_t blockIndex
387 );
388 
389 //--------------------------------------------------------------------------------------------------
398 //--------------------------------------------------------------------------------------------------
400 (
401  le_msg_SessionRef_t _ifgen_sessionRef,
402  const char* LE_NONNULL volumeName,
406  taf_flash_VolumeRef_t* volumeRefPtr
408 );
409 
410 //--------------------------------------------------------------------------------------------------
419 //--------------------------------------------------------------------------------------------------
421 (
422  le_msg_SessionRef_t _ifgen_sessionRef,
423  taf_flash_VolumeRef_t volumeRef
425 );
426 
427 //--------------------------------------------------------------------------------------------------
436 //--------------------------------------------------------------------------------------------------
438 (
439  le_msg_SessionRef_t _ifgen_sessionRef,
440  taf_flash_VolumeRef_t volumeRef,
442  uint32_t* lebNumberPtr,
444  uint32_t* freeLebNumberPtr,
446  uint32_t* volumeSizePtr
448 );
449 
450 //--------------------------------------------------------------------------------------------------
459 //--------------------------------------------------------------------------------------------------
461 (
462  le_msg_SessionRef_t _ifgen_sessionRef,
463  taf_flash_VolumeRef_t volumeRef,
465  uint32_t offset,
467  uint8_t* readDataPtr,
469  size_t* readDataSizePtr
471 );
472 
473 //--------------------------------------------------------------------------------------------------
485 //--------------------------------------------------------------------------------------------------
487 (
488  le_msg_SessionRef_t _ifgen_sessionRef,
489  taf_flash_VolumeRef_t volumeRef,
491  int64_t writeBytes
493 );
494 
495 //--------------------------------------------------------------------------------------------------
506 //--------------------------------------------------------------------------------------------------
508 (
509  le_msg_SessionRef_t _ifgen_sessionRef,
510  taf_flash_VolumeRef_t volumeRef,
512  const uint8_t* writeDataPtr,
514  size_t writeDataSize
516 );
517 
518 #endif // TAF_FLASH_COMMON_H_INCLUDE_GUARD
LE_SHARED le_result_t ifgen_taf_flash_UbiInitWrite(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_VolumeRef_t volumeRef, int64_t writeBytes)
struct taf_flash_Volume * taf_flash_VolumeRef_t
Definition: taf_flash_common.h:97
LE_SHARED le_result_t ifgen_taf_flash_MtdRead(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_PartitionRef_t partitionRef, uint32_t offset, uint8_t *readDataPtr, size_t *readDataSizePtr)
LE_SHARED bool ifgen_taf_flash_MtdIsBlockGood(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_PartitionRef_t partitionRef, uint32_t blockIndex)
LE_SHARED le_result_t ifgen_taf_flash_UbiOpen(le_msg_SessionRef_t _ifgen_sessionRef, const char *LE_NONNULL volumeName, taf_flash_OpenMode_t mode, taf_flash_VolumeRef_t *volumeRefPtr)
LE_SHARED le_result_t ifgen_taf_flash_MtdWritePage(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_PartitionRef_t partitionRef, uint32_t pageIndex, const uint8_t *writeDataPtr, size_t writeDataSize)
LE_SHARED le_result_t ifgen_taf_flash_MtdClose(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_PartitionRef_t partitionRef)
LE_SHARED le_result_t ifgen_taf_flash_UbiInformation(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_VolumeRef_t volumeRef, uint32_t *lebNumberPtr, uint32_t *freeLebNumberPtr, uint32_t *volumeSizePtr)
Write-Only mode.
Definition: taf_flash_common.h:109
struct taf_flash_Partition * taf_flash_PartitionRef_t
Definition: taf_flash_common.h:89
Read-Only mode.
Definition: taf_flash_common.h:107
LE_SHARED bool ifgen_taf_flash_HasLocalBinding(void)
LE_SHARED le_result_t ifgen_taf_flash_MtdInformation(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_PartitionRef_t partitionRef, uint32_t *blocksNumberPtr, uint32_t *badBlocksNumberPtr, uint32_t *blockSizePtr, uint32_t *pageSizePtr)
LE_SHARED le_result_t ifgen_taf_flash_UbiRead(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_VolumeRef_t volumeRef, uint32_t offset, uint8_t *readDataPtr, size_t *readDataSizePtr)
LE_SHARED le_result_t ifgen_taf_flash_UbiWrite(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_VolumeRef_t volumeRef, const uint8_t *writeDataPtr, size_t writeDataSize)
LE_SHARED le_result_t ifgen_taf_flash_MtdReadPage(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_PartitionRef_t partitionRef, uint32_t pageIndex, uint8_t *readDataPtr, size_t *readDataSizePtr)
LE_SHARED le_result_t ifgen_taf_flash_UbiClose(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_VolumeRef_t volumeRef)
LE_SHARED le_result_t ifgen_taf_flash_MtdErase(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_PartitionRef_t partitionRef)
LE_SHARED le_result_t ifgen_taf_flash_MtdEraseBlock(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_PartitionRef_t partitionRef, uint32_t blockIndex)
LE_SHARED void ifgen_taf_flash_CleanupCommonData(le_msg_SessionRef_t _ifgen_sessionRef)
#define LE_NONNULL
Definition: le_basics.h:368
LE_SHARED le_result_t ifgen_taf_flash_MtdOpen(le_msg_SessionRef_t _ifgen_sessionRef, const char *LE_NONNULL partitionName, taf_flash_OpenMode_t mode, taf_flash_PartitionRef_t *partitionRefPtr)
LE_SHARED void ifgen_taf_flash_Init(le_msg_SessionRef_t _ifgen_sessionRef)
le_result_t
Definition: le_basics.h:45
LE_SHARED le_result_t ifgen_taf_flash_OpenSession(le_msg_SessionRef_t _ifgen_sessionRef, bool isBlocking)
struct le_msg_Session * le_msg_SessionRef_t
Definition: le_messaging.h:860
LE_SHARED le_result_t ifgen_taf_flash_MtdWrite(le_msg_SessionRef_t _ifgen_sessionRef, taf_flash_PartitionRef_t partitionRef, uint32_t offset, const uint8_t *writeDataPtr, size_t writeDataSize)
taf_flash_OpenMode_t
Definition: taf_flash_common.h:105
Read and Write mode.
Definition: taf_flash_common.h:111
#define LE_SHARED
Definition: le_basics.h:297
LE_SHARED void ifgen_taf_flash_InitCommonData(void)