µC/FS Migration Guide
Migrating from V4.06.01 to V4.07.00
The following is a comprehensive list of the modifications you must apply to your µC/FS projects to update them to V4.07.00 from V4.06.01. The changes are easy to make and updating your project should take a short time.
New source code
µC/FS V4.07.00 is comprised of mostly bugfixes and minor changes in existing modules. The first step is to replace every file of your project by the new ones.
Updated requirements
An update of µC/LIB to V1.38.00 is required for µC/FS V4.07.00 to successfully build due to the usage of a new macro introduced in V1.38.00.
API changes
NAND Generic controller Board Support Package (BSP) API changes
The NAND generic controller now supports 16-bit NAND parallel devices. The DataWr() and DataRd() functions now take the width, in bits, of the requested bus access. See Board Support Package for API details.
Existing implementations may ignore the 'width' argument and assume 8-bit operation and return error code FS_ERR_INVALID_ARG if 'width' is set to 16, as in the following example:
static void FS_NAND_BSP_DataWr (void *p_src,
CPU_SIZE_T cnt,
FS_ERR *p_err)
{
CPU_INT08U *p_dest = SAM9M10_NAND_DATA;
CPU_INT08U *p_src_08 = (CPU_INT08U *)p_src;
CPU_SIZE_T i;
for (i = 0u; i < cnt, i++) {
*(p_dest++) = *(p_src_08++);
}
*p_err = FS_ERR_NONE;
}
static void FS_NAND_BSP_DataRd (void *p_dest,
CPU_SIZE_T cnt,
FS_ERR *p_err)
{
CPU_INT08U *p_src = SAM9M10_NAND_DATA;
CPU_INT08U *p_dest_08 = (CPU_INT08U *)p_dest;
CPU_SIZE_T i;
for (i = 0u; i < cnt, i++) {
*(p_dest_08++) = *(p_src++);
}
*p_err = FS_ERR_NONE;
}
static void FS_NAND_BSP_DataWr (void *p_src,
CPU_SIZE_T cnt,
CPU_INT08U width,
FS_ERR *p_err)
{
CPU_INT08U *p_dest = SAM9M10_NAND_DATA;
CPU_INT08U *p_src_08 = (CPU_INT08U *)p_src;
CPU_SIZE_T i;
if (width != 8u) { /* <-- Added check. */
*p_err = FS_ERR_INVALID_ARG;
return;
}
for (i = 0u; i < cnt, i++) {
*(p_dest++) = *(p_src_08++);
}
*p_err = FS_ERR_NONE;
}
static void FS_NAND_BSP_DataRd (void *p_dest,
CPU_SIZE_T cnt,
CPU_INT08U width,
FS_ERR *p_err)
{
CPU_INT08U *p_src = SAM9M10_NAND_DATA;
CPU_INT08U *p_dest_08 = (CPU_INT08U *)p_dest;
CPU_SIZE_T i;
if (width != 8u) { /* <-- Added check. */
*p_err = FS_ERR_INVALID_ARG;
return;
}
for (i = 0u; i < cnt, i++) {
*(p_dest_08++) = *(p_src++);
}
*p_err = FS_ERR_NONE;
}
Previous versions
The migration guide for previous versions of µC/FS is available in PDF: uC-FS-MigrationGuide.pdf