@@ -339,7 +339,7 @@ FF_Buffer_t * prvGetFromFATBuffers( FF_IOManager_t * pxIOManager,
339
339
{
340
340
/* Setting an error code without the Module/Function,
341
341
* will be filled-in by the caller. */
342
- xError = ( FF_Error_t ) ( FF_ERR_DEVICE_DRIVER_FAILED | FF_ERRFLAG );
342
+ xError = FF_createERR ( FF_ERR_DEVICE_DRIVER_FAILED , FF_ERRFLAG );
343
343
}
344
344
}
345
345
@@ -372,7 +372,7 @@ FF_Buffer_t * prvGetFromFATBuffers( FF_IOManager_t * pxIOManager,
372
372
373
373
if ( FF_isERR ( xError ) )
374
374
{
375
- xError = FF_GETERROR ( xError ) | FF_GETFATENTRY ;
375
+ xError = FF_CreateError ( FF_GETERROR ( xError ), FF_GETFATENTRY ) ;
376
376
}
377
377
else
378
378
{
@@ -394,7 +394,7 @@ FF_Buffer_t * prvGetFromFATBuffers( FF_IOManager_t * pxIOManager,
394
394
395
395
if ( pxBuffer == NULL )
396
396
{
397
- xError = ( FF_Error_t ) ( FF_ERR_DEVICE_DRIVER_FAILED | FF_GETFATENTRY );
397
+ xError = FF_createERR ( FF_ERR_DEVICE_DRIVER_FAILED , FF_GETFATENTRY );
398
398
}
399
399
else
400
400
{
@@ -444,7 +444,7 @@ uint32_t FF_getFATEntry( FF_IOManager_t * pxIOManager,
444
444
{
445
445
/* _HT_ find a more specific error code.
446
446
* Probably not really important as this is a function internal to the library. */
447
- xError = ( FF_Error_t ) ( FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE | FF_GETFATENTRY );
447
+ xError = FF_createERR ( FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE , FF_GETFATENTRY );
448
448
}
449
449
else
450
450
{
@@ -505,7 +505,7 @@ uint32_t FF_getFATEntry( FF_IOManager_t * pxIOManager,
505
505
506
506
if ( FF_isERR ( xError ) )
507
507
{
508
- xError = FF_GETERROR ( xError ) | FF_GETFATENTRY ;
508
+ xError = FF_createERR ( FF_GETERROR ( xError ), FF_GETFATENTRY ) ;
509
509
}
510
510
else
511
511
{
@@ -568,7 +568,7 @@ uint32_t FF_getFATEntry( FF_IOManager_t * pxIOManager,
568
568
* pxError = xError ;
569
569
}
570
570
571
- return ( int32_t ) ulFATEntry ;
571
+ return ulFATEntry ;
572
572
} /* FF_getFATEntry() */
573
573
/*-----------------------------------------------------------*/
574
574
@@ -595,14 +595,14 @@ FF_Error_t FF_ClearCluster( FF_IOManager_t * pxIOManager,
595
595
596
596
if ( pxBuffer == NULL )
597
597
{
598
- xError = ( FF_Error_t ) ( FF_ERR_DEVICE_DRIVER_FAILED | FF_CLEARCLUSTER );
598
+ xError = FF_createERR ( FF_ERR_DEVICE_DRIVER_FAILED , FF_CLEARCLUSTER );
599
599
break ;
600
600
}
601
601
602
602
memset ( pxBuffer -> pucBuffer , 0x00 , pxIOManager -> usSectorSize );
603
603
}
604
604
605
- xError = FF_BlockWrite ( pxIOManager , ulBaseLBA + xIndex , 1 , pxBuffer -> pucBuffer , pdFALSE );
605
+ xError = FF_BlockWrite ( pxIOManager , ( uint32_t ) ( ulBaseLBA + xIndex ), 1U , pxBuffer -> pucBuffer , pdFALSE );
606
606
607
607
if ( FF_isERR ( xError ) )
608
608
{
@@ -631,15 +631,13 @@ FF_Error_t FF_ClearCluster( FF_IOManager_t * pxIOManager,
631
631
/*-----------------------------------------------------------*/
632
632
633
633
/**
634
- * @private
635
634
* @brief Returns the Cluster address of the Cluster number from the beginning of a chain.
636
635
*
637
636
* @param pxIOManager FF_IOManager_t Object
638
637
* @param ulStart Cluster address of the first cluster in the chain.
639
638
* @param ulCount Number of Cluster in the chain,
640
639
*
641
640
*
642
- *
643
641
**/
644
642
uint32_t FF_TraverseFAT ( FF_IOManager_t * pxIOManager ,
645
643
uint32_t ulStart ,
@@ -728,7 +726,6 @@ uint32_t FF_FindEndOfChain( FF_IOManager_t * pxIOManager,
728
726
/*-----------------------------------------------------------*/
729
727
730
728
/**
731
- * @private
732
729
* @brief Tests if the ulFATEntry is an End of Chain Marker.
733
730
*
734
731
* @param pxIOManager FF_IOManager_t Object
@@ -826,7 +823,7 @@ BaseType_t FF_isEndOfChain( FF_IOManager_t * pxIOManager,
826
823
{
827
824
if ( pxBuffer == NULL )
828
825
{
829
- xError = ( FF_Error_t ) ( FF_ERR_DEVICE_DRIVER_FAILED | FF_PUTFATENTRY );
826
+ xError = FF_createERR ( FF_ERR_DEVICE_DRIVER_FAILED , FF_PUTFATENTRY );
830
827
break ;
831
828
}
832
829
@@ -844,7 +841,7 @@ BaseType_t FF_isEndOfChain( FF_IOManager_t * pxIOManager,
844
841
{
845
842
if ( pxBuffer == NULL )
846
843
{
847
- xError = ( FF_Error_t ) ( FF_ERR_DEVICE_DRIVER_FAILED | FF_PUTFATENTRY );
844
+ xError = FF_createERR ( FF_ERR_DEVICE_DRIVER_FAILED , FF_PUTFATENTRY );
848
845
break ;
849
846
}
850
847
@@ -864,7 +861,6 @@ BaseType_t FF_isEndOfChain( FF_IOManager_t * pxIOManager,
864
861
#endif /* if ( ffconfigFAT12_SUPPORT != 0 ) */
865
862
866
863
/**
867
- * @private
868
864
* @brief Writes a new Entry to the FAT Tables.
869
865
*
870
866
* @param pxIOManager IOMAN object.
@@ -899,7 +895,7 @@ FF_Error_t FF_putFATEntry( FF_IOManager_t * pxIOManager,
899
895
if ( ( ulCluster == 0ul ) || ( ulCluster >= pxIOManager -> xPartition .ulNumClusters ) )
900
896
{
901
897
/* find a more specific error code. */
902
- xError = ( FF_Error_t ) ( FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE | FF_PUTFATENTRY );
898
+ xError = FF_createERR ( FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE , FF_PUTFATENTRY );
903
899
}
904
900
else
905
901
{
@@ -950,7 +946,7 @@ FF_Error_t FF_putFATEntry( FF_IOManager_t * pxIOManager,
950
946
951
947
if ( FF_isERR ( xError ) )
952
948
{
953
- xError = FF_GETERROR ( xError ) | FF_PUTFATENTRY ;
949
+ xError = FF_createERR ( FF_GETERROR ( xError ), FF_PUTFATENTRY ) ;
954
950
break ;
955
951
}
956
952
@@ -1007,13 +1003,12 @@ FF_Error_t FF_putFATEntry( FF_IOManager_t * pxIOManager,
1007
1003
/*-----------------------------------------------------------*/
1008
1004
1009
1005
/**
1010
- * @private
1011
1006
* @brief Finds a Free Cluster and returns its number.
1012
1007
*
1013
1008
* @param pxIOManager IOMAN Object.
1014
1009
*
1015
1010
* @return The number of the cluster found to be free.
1016
- * @return 0 on error.
1011
+ * @retval 0 on error.
1017
1012
**/
1018
1013
#if ( ffconfigFAT12_SUPPORT != 0 )
1019
1014
static uint32_t prvFindFreeClusterSimple ( FF_IOManager_t * pxIOManager ,
@@ -1060,7 +1055,7 @@ FF_Error_t FF_putFATEntry( FF_IOManager_t * pxIOManager,
1060
1055
{
1061
1056
/* There is no free cluster any more. */
1062
1057
ulCluster = 0 ;
1063
- xError = ( FF_Error_t ) ( FF_FINDFREECLUSTER | FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE );
1058
+ xError = FF_createERR ( FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE , FF_FINDFREECLUSTER );
1064
1059
}
1065
1060
1066
1061
* pxError = xError ;
@@ -1112,7 +1107,7 @@ uint32_t FF_FindFreeCluster( FF_IOManager_t * pxIOManager,
1112
1107
1113
1108
if ( pxBuffer == NULL )
1114
1109
{
1115
- xError = ( FF_Error_t ) ( FF_ERR_DEVICE_DRIVER_FAILED | FF_FINDFREECLUSTER );
1110
+ xError = FF_createERR ( FF_ERR_DEVICE_DRIVER_FAILED , FF_FINDFREECLUSTER );
1116
1111
}
1117
1112
else
1118
1113
{
@@ -1134,8 +1129,8 @@ uint32_t FF_FindFreeCluster( FF_IOManager_t * pxIOManager,
1134
1129
uint32_t ulFATSector ;
1135
1130
uint32_t ulFATOffset ;
1136
1131
1137
- ulEntriesPerSector = pxIOManager -> usSectorSize / xEntrySize ;
1138
- ulFATOffset = ulCluster * xEntrySize ;
1132
+ ulEntriesPerSector = ( uint32_t ) ( pxIOManager -> usSectorSize / xEntrySize ) ;
1133
+ ulFATOffset = ( uint32_t ) ( ulCluster * xEntrySize ) ;
1139
1134
1140
1135
/* Start from a sector where the first free entry is expected,
1141
1136
* and iterate through every FAT sector. */
@@ -1147,7 +1142,7 @@ uint32_t FF_FindFreeCluster( FF_IOManager_t * pxIOManager,
1147
1142
1148
1143
if ( pxBuffer == NULL )
1149
1144
{
1150
- xError = ( FF_Error_t ) ( FF_ERR_DEVICE_DRIVER_FAILED | FF_FINDFREECLUSTER );
1145
+ xError = FF_createERR ( FF_ERR_DEVICE_DRIVER_FAILED , FF_FINDFREECLUSTER );
1151
1146
break ;
1152
1147
}
1153
1148
@@ -1156,7 +1151,7 @@ uint32_t FF_FindFreeCluster( FF_IOManager_t * pxIOManager,
1156
1151
/* Double-check: don't use non-existing clusters */
1157
1152
if ( ulCluster >= uNumClusters )
1158
1153
{
1159
- xError = ( FF_Error_t ) ( FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE | FF_FINDFREECLUSTER );
1154
+ xError = FF_createERR ( FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE , FF_FINDFREECLUSTER );
1160
1155
break ;
1161
1156
}
1162
1157
@@ -1201,7 +1196,7 @@ uint32_t FF_FindFreeCluster( FF_IOManager_t * pxIOManager,
1201
1196
if ( ( FF_isERR ( xError ) == pdFALSE ) &&
1202
1197
( ulFATSector == pxIOManager -> xPartition .ulSectorsPerFAT ) )
1203
1198
{
1204
- xError = ( FF_Error_t ) ( FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE | FF_FINDFREECLUSTER );
1199
+ xError = FF_createERR ( FF_ERR_IOMAN_NOT_ENOUGH_FREE_SPACE , FF_FINDFREECLUSTER );
1205
1200
}
1206
1201
} /* if( FF_isERR( xError ) == pdFALSE ) */
1207
1202
} /* if( pxIOManager->xPartition.ucType != FF_T_FAT12 ) */
@@ -1243,10 +1238,9 @@ uint32_t FF_FindFreeCluster( FF_IOManager_t * pxIOManager,
1243
1238
/*-----------------------------------------------------------*/
1244
1239
1245
1240
/**
1246
- * @private
1247
1241
* @brief Creates a Cluster Chain
1248
- * @return > 0 New created cluster
1249
- * @return = 0 See pxError
1242
+ * @retval > 0 New created cluster
1243
+ * @retval = 0 See pxError
1250
1244
**/
1251
1245
uint32_t FF_CreateClusterChain ( FF_IOManager_t * pxIOManager ,
1252
1246
FF_Error_t * pxError )
@@ -1316,17 +1310,16 @@ uint32_t FF_GetChainLength( FF_IOManager_t * pxIOManager,
1316
1310
/*-----------------------------------------------------------*/
1317
1311
1318
1312
/**
1319
- * @private
1320
1313
* @brief Free's Disk space by freeing unused links on Cluster Chains
1321
1314
*
1322
- * @param pxIOManager, IOMAN object.
1315
+ * @param pxIOManager IOMAN object.
1323
1316
* @param ulStartCluster Cluster Number that starts the chain.
1324
- * @param ulCount Number of Clusters from the end of the chain to unlink.
1325
- * @param ulCount 0 Means Free the entire chain (delete file).
1326
- * @param ulCount 1 Means mark the start cluster with EOF.
1317
+ * @param xDoTruncate Perform truncation of the FAT entry
1318
+ * when non-zero - truncate
1319
+ * when 0 - do not perform truncation
1327
1320
*
1328
- * @return 0 On Success.
1329
- * @return -1 If the device driver failed to provide access.
1321
+ * @retval 0 On Success.
1322
+ * @retval -1 If the device driver failed to provide access.
1330
1323
*
1331
1324
**/
1332
1325
FF_Error_t FF_UnlinkClusterChain ( FF_IOManager_t * pxIOManager ,
@@ -1494,7 +1487,7 @@ uint32_t FF_CountFreeClusters( FF_IOManager_t * pxIOManager,
1494
1487
1495
1488
if ( pxBuffer == NULL )
1496
1489
{
1497
- xError = ( FF_Error_t ) ( FF_ERR_DEVICE_DRIVER_FAILED | FF_COUNTFREECLUSTERS );
1490
+ xError = FF_createERR ( FF_ERR_DEVICE_DRIVER_FAILED , FF_COUNTFREECLUSTERS );
1498
1491
}
1499
1492
else
1500
1493
{
@@ -1542,7 +1535,7 @@ uint32_t FF_CountFreeClusters( FF_IOManager_t * pxIOManager,
1542
1535
1543
1536
if ( pxBuffer == NULL )
1544
1537
{
1545
- xError = ( FF_Error_t ) ( FF_ERR_DEVICE_DRIVER_FAILED | FF_COUNTFREECLUSTERS );
1538
+ xError = FF_createERR ( FF_ERR_DEVICE_DRIVER_FAILED , FF_COUNTFREECLUSTERS );
1546
1539
break ;
1547
1540
}
1548
1541
0 commit comments