doc: renamed project

This commit is contained in:
SylvanArnold
2025-04-29 13:52:54 +02:00
committed by Sylvan Arnold
parent 244e516bd8
commit 32618389d1
985 changed files with 1 additions and 1 deletions

View File

@@ -0,0 +1,254 @@
----------------------------------------------------------------------------
Revision history of FatFs module
----------------------------------------------------------------------------
R0.00 (February 26, 2006)
Prototype.
R0.01 (April 29, 2006)
First stable version.
R0.02 (June 01, 2006)
Added FAT12 support.
Removed unbuffered mode.
Fixed a problem on small (<32M) partition.
R0.02a (June 10, 2006)
Added a configuration option (_FS_MINIMUM).
R0.03 (September 22, 2006)
Added f_rename().
Changed option _FS_MINIMUM to _FS_MINIMIZE.
R0.03a (December 11, 2006)
Improved cluster scan algorithm to write files fast.
Fixed f_mkdir() creates incorrect directory on FAT32.
R0.04 (February 04, 2007)
Added f_mkfs().
Supported multiple drive system.
Changed some interfaces for multiple drive system.
Changed f_mountdrv() to f_mount().
R0.04a (April 01, 2007)
Supported multiple partitions on a physical drive.
Added a capability of extending file size to f_lseek().
Added minimization level 3.
Fixed an endian sensitive code in f_mkfs().
R0.04b (May 05, 2007)
Added a configuration option _USE_NTFLAG.
Added FSINFO support.
Fixed DBCS name can result FR_INVALID_NAME.
Fixed short seek (<= csize) collapses the file object.
R0.05 (August 25, 2007)
Changed arguments of f_read(), f_write() and f_mkfs().
Fixed f_mkfs() on FAT32 creates incorrect FSINFO.
Fixed f_mkdir() on FAT32 creates incorrect directory.
R0.05a (February 03, 2008)
Added f_truncate() and f_utime().
Fixed off by one error at FAT sub-type determination.
Fixed btr in f_read() can be mistruncated.
Fixed cached sector is not flushed when create and close without write.
R0.06 (April 01, 2008)
Added fputc(), fputs(), fprintf() and fgets().
Improved performance of f_lseek() on moving to the same or following cluster.
R0.07 (April 01, 2009)
Merged Tiny-FatFs as a configuration option. (_FS_TINY)
Added long file name feature. (_USE_LFN)
Added multiple code page feature. (_CODE_PAGE)
Added re-entrancy for multitask operation. (_FS_REENTRANT)
Added auto cluster size selection to f_mkfs().
Added rewind option to f_readdir().
Changed result code of critical errors.
Renamed string functions to avoid name collision.
R0.07a (April 14, 2009)
Septemberarated out OS dependent code on reentrant cfg.
Added multiple sector size feature.
R0.07c (June 21, 2009)
Fixed f_unlink() can return FR_OK on error.
Fixed wrong cache control in f_lseek().
Added relative path feature.
Added f_chdir() and f_chdrive().
Added proper case conversion to extended character.
R0.07e (November 03, 2009)
Septemberarated out configuration options from ff.h to ffconf.h.
Fixed f_unlink() fails to remove a sub-directory on _FS_RPATH.
Fixed name matching error on the 13 character boundary.
Added a configuration option, _LFN_UNICODE.
Changed f_readdir() to return the SFN with always upper case on non-LFN cfg.
R0.08 (May 15, 2010)
Added a memory configuration option. (_USE_LFN = 3)
Added file lock feature. (_FS_SHARE)
Added fast seek feature. (_USE_FASTSEEK)
Changed some types on the API, XCHAR->TCHAR.
Changed .fname in the FILINFO structure on Unicode cfg.
String functions support UTF-8 encoding files on Unicode cfg.
R0.08a (August 16, 2010)
Added f_getcwd(). (_FS_RPATH = 2)
Added sector erase feature. (_USE_ERASE)
Moved file lock semaphore table from fs object to the bss.
Fixed f_mkfs() creates wrong FAT32 volume.
R0.08b (January 15, 2011)
Fast seek feature is also applied to f_read() and f_write().
f_lseek() reports required table size on creating CLMP.
Extended format syntax of f_printf().
Ignores duplicated directory separators in given path name.
R0.09 (September 06, 2011)
f_mkfs() supports multiple partition to complete the multiple partition feature.
Added f_fdisk().
R0.09a (August 27, 2012)
Changed f_open() and f_opendir() reject null object pointer to avoid crash.
Changed option name _FS_SHARE to _FS_LOCK.
Fixed assertion failure due to OS/2 EA on FAT12/16 volume.
R0.09b (January 24, 2013)
Added f_setlabel() and f_getlabel().
R0.10 (October 02, 2013)
Added selection of character encoding on the file. (_STRF_ENCODE)
Added f_closedir().
Added forced full FAT scan for f_getfree(). (_FS_NOFSINFO)
Added forced mount feature with changes of f_mount().
Improved behavior of volume auto detection.
Improved write throughput of f_puts() and f_printf().
Changed argument of f_chdrive(), f_mkfs(), disk_read() and disk_write().
Fixed f_write() can be truncated when the file size is close to 4GB.
Fixed f_open(), f_mkdir() and f_setlabel() can return incorrect value on error.
R0.10a (January 15, 2014)
Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID)
Added a configuration option of minimum sector size. (_MIN_SS)
2nd argument of f_rename() can have a drive number and it will be ignored.
Fixed f_mount() with forced mount fails when drive number is >= 1. (appeared at R0.10)
Fixed f_close() invalidates the file object without volume lock.
Fixed f_closedir() returns but the volume lock is left acquired. (appeared at R0.10)
Fixed creation of an entry with LFN fails on too many SFN collisions. (appeared at R0.07)
R0.10b (May 19, 2014)
Fixed a hard error in the disk I/O layer can collapse the directory entry.
Fixed LFN entry is not deleted on delete/rename an object with lossy converted SFN. (appeared at R0.07)
R0.10c (November 09, 2014)
Added a configuration option for the platforms without RTC. (_FS_NORTC)
Changed option name _USE_ERASE to _USE_TRIM.
Fixed volume label created by Mac OS X cannot be retrieved with f_getlabel(). (appeared at R0.09b)
Fixed a potential problem of FAT access that can appear on disk error.
Fixed null pointer dereference on attempting to delete the root direcotry. (appeared at R0.08)
R0.11 (February 09, 2015)
Added f_findfirst(), f_findnext() and f_findclose(). (_USE_FIND)
Fixed f_unlink() does not remove cluster chain of the file. (appeared at R0.10c)
Fixed _FS_NORTC option does not work properly. (appeared at R0.10c)
R0.11a (September 05, 2015)
Fixed wrong media change can lead a deadlock at thread-safe configuration.
Added code page 771, 860, 861, 863, 864, 865 and 869. (_CODE_PAGE)
Removed some code pages actually not exist on the standard systems. (_CODE_PAGE)
Fixed errors in the case conversion teble of code page 437 and 850 (ff.c).
Fixed errors in the case conversion teble of Unicode (cc*.c).
R0.12 (April 12, 2016)
Added support of exFAT file system. (_FS_EXFAT)
Added f_expand(). (_USE_EXPAND)
Changed some members in FINFO structure and behavior of f_readdir().
Added an option _USE_CHMOD and removed an option _WORD_ACCESS.
Fixed errors in the case conversion teble of Unicode (cc*.c).

View File

@@ -0,0 +1,21 @@
FatFs Module Source Files R0.12
FILES
00readme.txt This file.
history.txt Revision history.
ffconf.h Configuration file for FatFs module.
ff.h Common include file for FatFs and application module.
ff.c FatFs module.
diskio.h Common include file for FatFs and disk I/O module.
diskio.c An example of glue function to attach existing disk I/O module to FatFs.
integer.h Integer type definitions for FatFs.
option Optional external functions.
Low level disk I/O module is not included in this archive because the FatFs
module is only a generic file system layer and not depend on any specific
storage device. You have to provide a low level disk I/O module that written
to control the target storage device.

View File

@@ -0,0 +1,123 @@
FatFs Module Source Files R0.08a (C)ChaN, 2010
FILES
ffconf.h Configuration file for FatFs module.
ff.h Common include file for FatFs and application module.
ff.c FatFs module.
diskio.h Common include file for FatFs and disk I/O module.
integer.h Alternative type definitions for integer variables.
option Optional external functions.
Low level disk I/O module is not included in this archive because the FatFs
module is only a generic file system layer and not depend on any specific
storage device. You have to provide a low level disk I/O module that written
to control your storage device.
AGREEMENTS
FatFs module is an open source software to implement FAT file system to
small embedded systems. This is a free software and is opened for education,
research and commercial developments under license policy of following trems.
Copyright (C) 2010, ChaN, all right reserved.
* The FatFs module is a free software and there is NO WARRANTY.
* No restriction on use. You can use, modify and redistribute it for
personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY.
* Redistributions of source code must retain the above copyright notice.
REVISION HISTORY
Feb 26, 2006 R0.00 Prototype
Apr 29, 2006 R0.01 First release.
Jun 01, 2006 R0.02 Added FAT12.
Removed unbuffered mode.
Fixed a problem on small (<32M) patition.
Jun 10, 2006 R0.02a Added a configuration option _FS_MINIMUM.
Sep 22, 2006 R0.03 Added f_rename.
Changed option _FS_MINIMUM to _FS_MINIMIZE.
Dec 11, 2006 R0.03a Improved cluster scan algolithm to write files fast.
Fixed f_mkdir creates incorrect directory on FAT32.
Feb 04, 2007 R0.04 Supported multiple drive system. (FatFs)
Changed some APIs for multiple drive system.
Added f_mkfs. (FatFs)
Added _USE_FAT32 option. (Tiny-FatFs)
Apr 01, 2007 R0.04a Supported multiple partitions on a plysical drive. (FatFs)
Fixed an endian sensitive code in f_mkfs. (FatFs)
Added a capability of extending the file size to f_lseek.
Added minimization level 3.
Fixed a problem that can collapse a sector when recreate an
existing file in any sub-directory at non FAT32 cfg. (Tiny-FatFs)
May 05, 2007 R0.04b Added _USE_NTFLAG option.
Added FSInfo support.
Fixed some problems corresponds to FAT32. (Tiny-FatFs)
Fixed DBCS name can result FR_INVALID_NAME.
Fixed short seek (0 < ofs <= csize) collapses the file object.
Aug 25, 2007 R0.05 Changed arguments of f_read, f_write.
Changed arguments of f_mkfs. (FatFs)
Fixed f_mkfs on FAT32 creates incorrect FSInfo. (FatFs)
Fixed f_mkdir on FAT32 creates incorrect directory. (FatFs)
Feb 03, 2008 R0.05a Added f_truncate().
Added f_utime().
Fixed off by one error at FAT sub-type determination.
Fixed btr in f_read() can be mistruncated.
Fixed cached sector is not flushed when create and close without write.
Apr 01, 2008 R0.06 Added f_forward(). (Tiny-FatFs)
Added string functions: fputc(), fputs(), fprintf() and fgets().
Improved performance of f_lseek() on move to the same or following cluster.
Apr 01, 2009, R0.07 Merged Tiny-FatFs as a buffer configuration option.
Added long file name support.
Added multiple code page support.
Added re-entrancy for multitask operation.
Added auto cluster size selection to f_mkfs().
Added rewind option to f_readdir().
Changed result code of critical errors.
Renamed string functions to avoid name collision.
Apr 14, 2009, R0.07a Separated out OS dependent code on reentrant cfg.
Added multiple sector size support.
Jun 21, 2009, R0.07c Fixed f_unlink() may return FR_OK on error.
Fixed wrong cache control in f_lseek().
Added relative path feature.
Added f_chdir().
Added f_chdrive().
Added proper case conversion for extended characters.
Nov 03, 2009 R0.07e Separated out configuration options from ff.h to ffconf.h.
Added a configuration option, _LFN_UNICODE.
Fixed f_unlink() fails to remove a sub-dir on _FS_RPATH.
Fixed name matching error on the 13 char boundary.
Changed f_readdir() to return the SFN with always upper case on non-LFN cfg.
May 15, 2010, R0.08 Added a memory configuration option. (_USE_LFN)
Added file lock feature. (_FS_SHARE)
Added fast seek feature. (_USE_FASTSEEK)
Changed some types on the API, XCHAR->TCHAR.
Changed fname member in the FILINFO structure on Unicode cfg.
String functions support UTF-8 encoding files on Unicode cfg.
Aug 16,'10 R0.08a Added f_getcwd(). (_FS_RPATH = 2)
Added sector erase feature. (_USE_ERASE)
Moved file lock semaphore table from fs object to the bss.
Fixed a wrong directory entry is created on non-LFN cfg when the given name contains ';'.
Fixed f_mkfs() creates wrong FAT32 volume.

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,77 @@
/*
* Copyright (c) 2021, Erich Styger
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#include "platform.h"
#include "McuFatFS_CardPins.h"
#include "McuGPIO.h"
#if McuFatFS_CONFIG_HAS_CARD_DETECT_PIN
static McuGPIO_Handle_t McuFatFS_CardDetectPin;
#endif
#if McuFatFS_CONFIG_HAS_WRITE_PROTECT_PIN
static McuGPIO_Handle_t McuFatFS_WriteProtectPin;
#endif
bool McuFatFS_CardPinDiskPresent(uint8_t *drvStr) {
#if McuFatFS_CONFIG_HAS_CARD_DETECT_PIN
#if McuFatFS_CONFIG_CARD_DETECT_IS_HIGH_ACTIVE
return McuGPIO_IsHigh(McuFatFS_CardDetectPin); /* Pin is high if card is inserted */
#else
return McuGPIO_IsLow(McuFatFS_CardDetectPin); /* Pin is low if card is inserted */
#endif
#else
return true;
#endif
}
bool McuFatFS_CardPinWriteProtected(uint8_t *drvStr) {
#if McuFatFS_CONFIG_HAS_WRITE_PROTECT_PIN
#if McuFatFS_CONFIG_WRITE_PROTECT_IS_HIGH_ACTIVE
return McuGPIO_IsHigh(McuFatFS_WriteProtectPin); /* Pin is high if card is write protected */
#else
return McuGPIO_IsLow(McuFatFS_WriteProtectPin); /* Pin is low if card is write protected */
#endif
#else
return false;
#endif
}
void McuFatFS_CardPinInit(void) {
#if McuFatFS_CONFIG_HAS_CARD_DETECT_PIN || McuFatFS_CONFIG_HAS_WRITE_PROTECT_PIN
McuGPIO_Config_t config;
McuGPIO_GetDefaultConfig(&config);
config.isInput = true;
#endif
/* card detect pin: */
#if McuFatFS_CONFIG_HAS_CARD_DETECT_PIN
config.hw.gpio = McuFatFS_CONFIG_CARD_DETECT_GPIO;
config.hw.port = McuFatFS_CONFIG_CARD_DETECT_PORT;
config.hw.pin = McuFatFS_CONFIG_CARD_DETECT_PIN;
#if McuLib_CONFIG_CPU_IS_LPC && McuLib_CONFIG_CORTEX_M==0
config.hw.iocon = McuFatFS_CONFIG_CARD_DETECT_IOCON;
#endif
McuFatFS_CardDetectPin = McuGPIO_InitGPIO(&config);
if (McuFatFS_CONFIG_CARD_DETECT_PULL!=McuGPIO_PULL_DISABLE) {
McuGPIO_SetPullResistor(McuFatFS_CardDetectPin, McuFatFS_CONFIG_CARD_DETECT_PULL);
}
#endif
/* write protect pin: */
#if McuFatFS_CONFIG_HAS_WRITE_PROTECT_PIN
config.hw.gpio = McuFatFS_CONFIG_WRITE_PROTECT_GPIO;
config.hw.port = McuFatFS_CONFIG_WRITE_PROTECT_PORT;
config.hw.pin = McuFatFS_CONFIG_WRITE_PROTECT_PIN;
#if McuLib_CONFIG_CPU_IS_LPC && McuLib_CONFIG_CORTEX_M==0
config.hw.iocon = McuFatFS_CONFIG_WRITE_PROTECT_IOCON;
#endif
McuFatFS_WriteProtectPin = McuGPIO_InitGPIO(&config);
if (McuFatFS_CONFIG_WRITE_PROTECT_PULL!=McuGPIO_PULL_DISABLE) {
McuGPIO_SetPullResistor(McuFatFS_WriteProtectPin, McuFatFS_CONFIG_WRITE_PROTECT_PULL);
}
#endif
}

View File

@@ -0,0 +1,28 @@
/*
* Copyright (c) 2021, Erich Styger
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#ifndef FATFS_SDCARD_H_
#define FATFS_SDCARD_H_
#include <stdint.h>
#include <stdbool.h>
#include "McuFatFS_CardPins_config.h"
#ifdef __cplusplus
extern "C" {
#endif
bool McuFatFS_CardPinDiskPresent(uint8_t *drvStr);
bool McuFatFS_CardPinWriteProtected(uint8_t *drvStr);
void McuFatFS_CardPinInit(void);
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* FATFS_SDCARD_H_ */

View File

@@ -0,0 +1,102 @@
/*
* Copyright (c) 2021, Erich Styger
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#ifndef MCUFATFS_CARDPINS_CONFIG_H_
#define MCUFATFS_CARDPINS_CONFIG_H_
#ifdef __cplusplus
extern "C" {
#endif
#include "McuLibconfig.h"
#include "McuGPIO.h"
/* card detect pin */
#ifndef McuFatFS_CONFIG_HAS_CARD_DETECT_PIN
#define McuFatFS_CONFIG_HAS_CARD_DETECT_PIN (0)
/*!< 1: has card detection pin. 0: no card detection pin */
#endif
#if McuFatFS_CONFIG_HAS_CARD_DETECT_PIN
#ifndef McuFatFS_CONFIG_CARD_DETECT_GPIO
#define McuFatFS_CONFIG_CARD_DETECT_GPIO GPIOC
#endif
#ifndef McuFatFS_CONFIG_CARD_DETECT_PORT
#define McuFatFS_CONFIG_CARD_DETECT_PORT PORTC
#endif
#ifndef McuFatFS_CONFIG_CARD_DETECT_PIN
#define McuFatFS_CONFIG_CARD_DETECT_PIN 0U
#endif
#ifndef McuFatFS_CONFIG_CARD_DETECT_PULL
#define McuFatFS_CONFIG_CARD_DETECT_PULL McuGPIO_PULL_DOWN
/*!< type of pull, use McuGPIO_PULL_DISABLE for no pull resistor configuration */
#endif
#ifndef McuFatFS_CONFIG_CARD_DETECT_IOCON
#define McuFatFS_CONFIG_CARD_DETECT_IOCON /*IOCON_INDEX_PIO0_4*/
/*!< For LPC Cortex-M0 only */
#endif
#ifndef McuFatFS_CONFIG_CARD_DETECT_IS_HIGH_ACTIVE
#define McuFatFS_CONFIG_CARD_DETECT_IS_HIGH_ACTIVE (1)
/*!< 1: pin is HIGH active for card present; 0: pin is LOW active if card is present */
#endif
#endif /* McuFatFS_CONFIG_HAS_CARD_DETECT_PIN */
/* write protection pin */
#ifndef McuFatFS_CONFIG_HAS_WRITE_PROTECT_PIN
#define McuFatFS_CONFIG_HAS_WRITE_PROTECT_PIN (0)
/*!< 1: has write protection pin. 0: no card write protection pin */
#endif
#if McuFatFS_CONFIG_HAS_WRITE_PROTECT_PIN
#ifndef McuFatFS_CONFIG_WRITE_PROTECT_GPIO
#define McuFatFS_CONFIG_WRITE_PROTECT_GPIO GPIOC
#endif
#ifndef McuFatFS_CONFIG_WRITE_PROTECT_PORT
#define McuFatFS_CONFIG_WRITE_PROTECT_PORT PORTC
#endif
#ifndef McuFatFS_CONFIG_WRITE_PROTECT_PIN
#define McuFatFS_CONFIG_WRITE_PROTECT_PIN 1U
#endif
#ifndef McuFatFS_CONFIG_WRITE_PROTECT_PULL
#define McuFatFS_CONFIG_WRITE_PROTECT_PULL McuGPIO_PULL_DOWN
/*!< type of pull, use McuGPIO_PULL_DISABLE for no pull resistor configuration */
#endif
#ifndef McuFatFS_CONFIG_WRITE_PROTECT_IOCON
#define McuFatFS_CONFIG_WRITE_PROTECT_IOCON /*IOCON_INDEX_PIO0_5*/
/*!< For LPC Cortex-M0 only */
#endif
#ifndef McuFatFS_CONFIG_WRITE_PROTECT_IS_HIGH_ACTIVE
#define McuFatFS_CONFIG_WRITE_PROTECT_IS_HIGH_ACTIVE (1)
/*!< 1: pin is HIGH active for write protection; 0: pin is LOW active if card is write protected */
#endif
#endif /* McuFatFS_CONFIG_HAS_WRITE_PROTECTION_PIN */
/* example configurations below: */
#if 0 /* tinyK22 */
#define McuFatFS_CONFIG_HAS_CARD_DETECT_PIN (1)
#define McuFatFS_CONFIG_CARD_DETECT_GPIO GPIOC
#define McuFatFS_CONFIG_CARD_DETECT_PORT PORTC
#define McuFatFS_CONFIG_CARD_DETECT_PIN 0U
#define McuFatFS_CONFIG_CARD_DETECT_PULL McuGPIO_PULL_DOWN
#define McuFatFS_CONFIG_CARD_DETECT_IS_HIGH_ACTIVE (1)
#define McuFatFS_CONFIG_HAS_WRITE_PROTECT_PIN (0)
#elif 0 /* LPC55S16*/
#define McuFatFS_CONFIG_HAS_CARD_DETECT_PIN (1)
#define McuFatFS_CONFIG_CARD_DETECT_GPIO GPIO
#define McuFatFS_CONFIG_CARD_DETECT_PORT 0
#define McuFatFS_CONFIG_CARD_DETECT_PIN 16U
#define McuFatFS_CONFIG_CARD_DETECT_PULL McuGPIO_PULL_DISABLE /* https://www.pololu.com/product/2587 */
#define McuFatFS_CONFIG_CARD_DETECT_IS_HIGH_ACTIVE (1) /* https://www.pololu.com/product/2587 */
#define McuFatFS_CONFIG_HAS_WRITE_PROTECT_PIN (0)
#endif
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* MCUFATFS_CARDPINS_CONFIG_H_ */

View File

@@ -0,0 +1,39 @@
/**
* \file
* \brief Configuration header file for FAT_FileSystem
* Copyright (c) 2020, Erich Styger
* SPDX-License-Identifier: BSD-3-Clause
*
* This header file is used to configure settings of the FAT File System module.
*/
#ifndef __McuFatFS_CONFIG_H
#define __McuFatFS_CONFIG_H
#ifndef McuFatFS_CONFIG_CARD_INSERT_DELAY_TIME_MS
#define McuFatFS_CONFIG_CARD_INSERT_DELAY_TIME_MS (100)
/*!< Delay time in milliseconds after insertion of the card detected */
#endif
#ifndef McuFatFS_CONFIG_SHELL_ENABLED
#define McuFatFS_CONFIG_SHELL_ENABLED (1)
/*!< 1: Shell support is enabled; 0: no shell support enabled */
#endif
#ifndef McuFatFS_CONFIG_IS_DISK_PRESENT_CALLBACK
#define McuFatFS_CONFIG_IS_DISK_PRESENT_CALLBACK McuFatFS_CardPinDiskPresent
/*!< 1: callback name to be used to decide if a device is present or not */
#endif
#ifndef McuFatFS_CONFIG_IS_WRITE_PROTECTED_CALLBACK
#define McuFatFS_CONFIG_IS_WRITE_PROTECTED_CALLBACK McuFatFS_CardPinWriteProtected
/*!< 1: callback name to be used to decide if a device is present or not */
#endif
#ifndef McuFatFS_CONFIG_DEFAULT_DRIVE_STRING
#define McuFatFS_CONFIG_DEFAULT_DRIVE_STRING "0:/"
/*!< default drive used for commands. The first letter defines the drive */
#endif
#endif /* __McuFatFS_CONFIG_H */

View File

@@ -0,0 +1,305 @@
#ifndef _FFCONF_H_
#define _FFCONF_H_
/*---------------------------------------------------------------------------/
/ FatFs Functional Configurations
/---------------------------------------------------------------------------*/
#define FFCONF_DEF 86604 /* Revision ID */
/*---------------------------------------------------------------------------/
/ MSDK adaptation configuration
/---------------------------------------------------------------------------*/
#define SDSPI_DISK_ENABLE
/* Available options are:
/ RAM_DISK_ENABLE
/ USB_DISK_ENABLE
/ SD_DISK_ENABLE
/ MMC_DISK_ENABLE
/ SDSPI_DISK_ENABLE
/ NAND_DISK_ENABLE */
/*---------------------------------------------------------------------------/
/ Function Configurations
/---------------------------------------------------------------------------*/
#define FF_FS_READONLY 0
/* This option switches read-only configuration. (0:Read/Write or 1:Read-only)
/ Read-only configuration removes writing API functions, f_write(), f_sync(),
/ f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree()
/ and optional writing functions as well. */
#define FF_FS_MINIMIZE 0
/* This option defines minimization level to remove some basic API functions.
/
/ 0: Basic functions are fully enabled.
/ 1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_truncate() and f_rename()
/ are removed.
/ 2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1.
/ 3: f_lseek() function is removed in addition to 2. */
#define FF_USE_STRFUNC 1
/* This option switches string functions, f_gets(), f_putc(), f_puts() and f_printf().
/
/ 0: Disable string functions.
/ 1: Enable without LF-CRLF conversion.
/ 2: Enable with LF-CRLF conversion. */
#define FF_USE_FIND 0
/* This option switches filtered directory read functions, f_findfirst() and
/ f_findnext(). (0:Disable, 1:Enable 2:Enable with matching altname[] too) */
#define FF_USE_MKFS 1
/* This option switches f_mkfs() function. (0:Disable or 1:Enable) */
#define FF_USE_FASTSEEK 0
/* This option switches fast seek function. (0:Disable or 1:Enable) */
#define FF_USE_EXPAND 0
/* This option switches f_expand function. (0:Disable or 1:Enable) */
#define FF_USE_CHMOD 0
/* This option switches attribute manipulation functions, f_chmod() and f_utime().
/ (0:Disable or 1:Enable) Also FF_FS_READONLY needs to be 0 to enable this option. */
#define FF_USE_LABEL 0
/* This option switches volume label functions, f_getlabel() and f_setlabel().
/ (0:Disable or 1:Enable) */
#define FF_USE_FORWARD 0
/* This option switches f_forward() function. (0:Disable or 1:Enable) */
/*---------------------------------------------------------------------------/
/ Locale and Namespace Configurations
/---------------------------------------------------------------------------*/
#define FF_CODE_PAGE 932
/* This option specifies the OEM code page to be used on the target system.
/ Incorrect code page setting can cause a file open failure.
/
/ 437 - U.S.
/ 720 - Arabic
/ 737 - Greek
/ 771 - KBL
/ 775 - Baltic
/ 850 - Latin 1
/ 852 - Latin 2
/ 855 - Cyrillic
/ 857 - Turkish
/ 860 - Portuguese
/ 861 - Icelandic
/ 862 - Hebrew
/ 863 - Canadian French
/ 864 - Arabic
/ 865 - Nordic
/ 866 - Russian
/ 869 - Greek 2
/ 932 - Japanese (DBCS)
/ 936 - Simplified Chinese (DBCS)
/ 949 - Korean (DBCS)
/ 950 - Traditional Chinese (DBCS)
/ 0 - Include all code pages above and configured by f_setcp()
*/
#define FF_USE_LFN 2
#define FF_MAX_LFN 255
/* The FF_USE_LFN switches the support for LFN (long file name).
/
/ 0: Disable LFN. FF_MAX_LFN has no effect.
/ 1: Enable LFN with static working buffer on the BSS. Always NOT thread-safe.
/ 2: Enable LFN with dynamic working buffer on the STACK.
/ 3: Enable LFN with dynamic working buffer on the HEAP.
/
/ To enable the LFN, ffunicode.c needs to be added to the project. The LFN function
/ requiers certain internal working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and
/ additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled.
/ The FF_MAX_LFN defines size of the working buffer in UTF-16 code unit and it can
/ be in range of 12 to 255. It is recommended to be set 255 to fully support LFN
/ specification.
/ When use stack for the working buffer, take care on stack overflow. When use heap
/ memory for the working buffer, memory management functions, ff_memalloc() and
/ ff_memfree() in ffsystem.c, need to be added to the project. */
#define FF_LFN_UNICODE 0
/* This option switches the character encoding on the API when LFN is enabled.
/
/ 0: ANSI/OEM in current CP (TCHAR = char)
/ 1: Unicode in UTF-16 (TCHAR = WCHAR)
/ 2: Unicode in UTF-8 (TCHAR = char)
/ 3: Unicode in UTF-32 (TCHAR = DWORD)
/
/ Also behavior of string I/O functions will be affected by this option.
/ When LFN is not enabled, this option has no effect. */
#define FF_LFN_BUF 255
#define FF_SFN_BUF 12
/* This set of options defines size of file name members in the FILINFO structure
/ which is used to read out directory items. These values should be suffcient for
/ the file names to read. The maximum possible length of the read file name depends
/ on character encoding. When LFN is not enabled, these options have no effect. */
#define FF_STRF_ENCODE 3
/* When FF_LFN_UNICODE >= 1 with LFN enabled, string I/O functions, f_gets(),
/ f_putc(), f_puts and f_printf() convert the character encoding in it.
/ This option selects assumption of character encoding ON THE FILE to be
/ read/written via those functions.
/
/ 0: ANSI/OEM in current CP
/ 1: Unicode in UTF-16LE
/ 2: Unicode in UTF-16BE
/ 3: Unicode in UTF-8
*/
#define FF_FS_RPATH 2
/* This option configures support for relative path.
/
/ 0: Disable relative path and remove related functions.
/ 1: Enable relative path. f_chdir() and f_chdrive() are available.
/ 2: f_getcwd() function is available in addition to 1.
*/
/*---------------------------------------------------------------------------/
/ Drive/Volume Configurations
/---------------------------------------------------------------------------*/
#define FF_VOLUMES 5
/* Number of volumes (logical drives) to be used. (1-10) */
#define FF_STR_VOLUME_ID 0
#define FF_VOLUME_STRS "RAM","NAND","CF","SD","SD2","USB","USB2","USB3"
/* FF_STR_VOLUME_ID switches support for volume ID in arbitrary strings.
/ When FF_STR_VOLUME_ID is set to 1 or 2, arbitrary strings can be used as drive
/ number in the path name. FF_VOLUME_STRS defines the volume ID strings for each
/ logical drives. Number of items must not be less than FF_VOLUMES. Valid
/ characters for the volume ID strings are A-Z, a-z and 0-9, however, they are
/ compared in case-insensitive. If FF_STR_VOLUME_ID >= 1 and FF_VOLUME_STRS is
/ not defined, a user defined volume string table needs to be defined as:
/
/ const char* VolumeStr[FF_VOLUMES] = {"ram","flash","sd","usb",...
*/
#define FF_MULTI_PARTITION 0
/* This option switches support for multiple volumes on the physical drive.
/ By default (0), each logical drive number is bound to the same physical drive
/ number and only an FAT volume found on the physical drive will be mounted.
/ When this function is enabled (1), each logical drive number can be bound to
/ arbitrary physical drive and partition listed in the VolToPart[]. Also f_fdisk()
/ funciton will be available. */
#define FF_MIN_SS 512
#define FF_MAX_SS 512
/* This set of options configures the range of sector size to be supported. (512,
/ 1024, 2048 or 4096) Always set both 512 for most systems, generic memory card and
/ harddisk. But a larger value may be required for on-board flash memory and some
/ type of optical media. When FF_MAX_SS is larger than FF_MIN_SS, FatFs is configured
/ for variable sector size mode and disk_ioctl() function needs to implement
/ GET_SECTOR_SIZE command. */
#define FF_USE_TRIM 0
/* This option switches support for ATA-TRIM. (0:Disable or 1:Enable)
/ To enable Trim function, also CTRL_TRIM command should be implemented to the
/ disk_ioctl() function. */
#define FF_FS_NOFSINFO 0
/* If you need to know correct free space on the FAT32 volume, set bit 0 of this
/ option, and f_getfree() function at first time after volume mount will force
/ a full FAT scan. Bit 1 controls the use of last allocated cluster number.
/
/ bit0=0: Use free cluster count in the FSINFO if available.
/ bit0=1: Do not trust free cluster count in the FSINFO.
/ bit1=0: Use last allocated cluster number in the FSINFO if available.
/ bit1=1: Do not trust last allocated cluster number in the FSINFO.
*/
/*---------------------------------------------------------------------------/
/ System Configurations
/---------------------------------------------------------------------------*/
#define FF_FS_TINY 0
/* This option switches tiny buffer configuration. (0:Normal or 1:Tiny)
/ At the tiny configuration, size of file object (FIL) is shrinked FF_MAX_SS bytes.
/ Instead of private sector buffer eliminated from the file object, common sector
/ buffer in the filesystem object (FATFS) is used for the file data transfer. */
#define FF_FS_EXFAT 0
/* This option switches support for exFAT filesystem. (0:Disable or 1:Enable)
/ To enable exFAT, also LFN needs to be enabled. (FF_USE_LFN >= 1)
/ Note that enabling exFAT discards ANSI C (C89) compatibility. */
#define FF_FS_NORTC 0
#define FF_NORTC_MON 1
#define FF_NORTC_MDAY 1
#define FF_NORTC_YEAR 2018
/* The option FF_FS_NORTC switches timestamp function. If the system does not have
/ any RTC function or valid timestamp is not needed, set FF_FS_NORTC = 1 to disable
/ the timestamp function. Every object modified by FatFs will have a fixed timestamp
/ defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR in local time.
/ To enable timestamp function (FF_FS_NORTC = 0), get_fattime() function need to be
/ added to the project to read current time form real-time clock. FF_NORTC_MON,
/ FF_NORTC_MDAY and FF_NORTC_YEAR have no effect.
/ These options have no effect at read-only configuration (FF_FS_READONLY = 1). */
#define FF_FS_LOCK 0
/* The option FF_FS_LOCK switches file lock function to control duplicated file open
/ and illegal operation to open objects. This option must be 0 when FF_FS_READONLY
/ is 1.
/
/ 0: Disable file lock function. To avoid volume corruption, application program
/ should avoid illegal open, remove and rename to the open objects.
/ >0: Enable file lock function. The value defines how many files/sub-directories
/ can be opened simultaneously under file lock control. Note that the file
/ lock control is independent of re-entrancy. */
/* #include <somertos.h> // O/S definitions */
#define FF_FS_REENTRANT 1
#define FF_FS_TIMEOUT 1000
#define FF_SYNC_t void* /* Type of sync object used on the OS. In reality it is xSemaphoreHandle */
/* The option FF_FS_REENTRANT switches the re-entrancy (thread safe) of the FatFs
/ module itself. Note that regardless of this option, file access to different
/ volume is always re-entrant and volume control functions, f_mount(), f_mkfs()
/ and f_fdisk() function, are always not re-entrant. Only file/directory access
/ to the same volume is under control of this function.
/
/ 0: Disable re-entrancy. FF_FS_TIMEOUT and FF_SYNC_t have no effect.
/ 1: Enable re-entrancy. Also user provided synchronization handlers,
/ ff_req_grant(), ff_rel_grant(), ff_del_syncobj() and ff_cre_syncobj()
/ function, must be added to the project. Samples are available in
/ option/syscall.c.
/
/ The FF_FS_TIMEOUT defines timeout period in unit of time tick.
/ The FF_SYNC_t defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*,
/ SemaphoreHandle_t and etc. A header file for O/S definitions needs to be
/ included somewhere in the scope of ff.h. */
/*--- End of configuration options ---*/
#endif /* _FFCONF_H_ */

View File

@@ -0,0 +1,4 @@
readme.txt
----------
See http://elm-chan.org/fsw/ff/00index_e.html for more information.

View File

@@ -0,0 +1,303 @@
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016-2019 NXP
* All rights reserved.
*
*
* SPDX-License-Identifier: BSD-3-Clause
*/
/*-----------------------------------------------------------------------*/
/* Low level disk I/O module skeleton for FatFs (C)ChaN, 2016 */
/*-----------------------------------------------------------------------*/
/* If a working storage control module is available, it should be */
/* attached to the FatFs via a glue function rather than modifying it. */
/* This is an example of glue functions to attach various exsisting */
/* storage control modules to the FatFs module with a defined API. */
/*-----------------------------------------------------------------------*/
#include "McuLib.h"
#if McuLib_CONFIG_USE_FAT_FS
#include "ffconf.h" /* FatFs configuration options */
#include "ff.h" /* Obtains integer types */
#include "diskio.h" /* Declarations of disk functions */
#ifdef RAM_DISK_ENABLE
#include "FatFS/source/fsl_ram_disk/fsl_ram_disk.h"
#endif
#ifdef USB_DISK_ENABLE
#include "FatFS/source/fsl_usb_disk/fsl_usb_disk.h"
#endif
#ifdef SD_DISK_ENABLE
#include "fsl_sd_disk.h"
#endif
#ifdef MMC_DISK_ENABLE
#include "fsl_mmc_disk.h"
#endif
#ifdef SDSPI_DISK_ENABLE
#include "FatFS/source/fsl_sdspi_disk/fsl_sdspi_disk.h"
#endif
#ifdef NAND_DISK_ENABLE
#include "fsl_nand_disk.h"
#endif
/*-----------------------------------------------------------------------*/
/* Get Drive Status */
/*-----------------------------------------------------------------------*/
DSTATUS disk_status (
BYTE pdrv /* Physical drive nmuber to identify the drive */
)
{
DSTATUS stat;
switch (pdrv)
{
#ifdef RAM_DISK_ENABLE
case RAMDISK:
stat = ram_disk_status(pdrv);
return stat;
#endif
#ifdef USB_DISK_ENABLE
case USBDISK:
stat = USB_HostMsdGetDiskStatus(pdrv);
return stat;
#endif
#ifdef SD_DISK_ENABLE
case SDDISK:
stat = sd_disk_status(pdrv);
return stat;
#endif
#ifdef MMC_DISK_ENABLE
case MMCDISK:
stat = mmc_disk_status(pdrv);
return stat;
#endif
#ifdef SDSPI_DISK_ENABLE
case SDSPIDISK:
stat = sdspi_disk_status(pdrv);
return stat;
#endif
#ifdef NAND_DISK_ENABLE
case NANDDISK:
stat = nand_disk_status(pdrv);
return stat;
#endif
default:
break;
}
return STA_NOINIT;
}
/*-----------------------------------------------------------------------*/
/* Inidialize a Drive */
/*-----------------------------------------------------------------------*/
DSTATUS disk_initialize (
BYTE pdrv /* Physical drive nmuber to identify the drive */
)
{
DSTATUS stat;
switch (pdrv)
{
#ifdef RAM_DISK_ENABLE
case RAMDISK:
stat = ram_disk_initialize(pdrv);
return stat;
#endif
#ifdef USB_DISK_ENABLE
case USBDISK:
stat = USB_HostMsdInitializeDisk(pdrv);
return stat;
#endif
#ifdef SD_DISK_ENABLE
case SDDISK:
stat = sd_disk_initialize(pdrv);
return stat;
#endif
#ifdef MMC_DISK_ENABLE
case MMCDISK:
stat = mmc_disk_initialize(pdrv);
return stat;
#endif
#ifdef SDSPI_DISK_ENABLE
case SDSPIDISK:
stat = sdspi_disk_initialize(pdrv);
return stat;
#endif
#ifdef NAND_DISK_ENABLE
case NANDDISK:
stat = nand_disk_initialize(pdrv);
return stat;
#endif
default:
break;
}
return STA_NOINIT;
}
/*-----------------------------------------------------------------------*/
/* Read Sector(s) */
/*-----------------------------------------------------------------------*/
DRESULT disk_read (
BYTE pdrv, /* Physical drive nmuber to identify the drive */
BYTE *buff, /* Data buffer to store read data */
DWORD sector, /* Start sector in LBA */
UINT count /* Number of sectors to read */
)
{
DRESULT res;
switch (pdrv)
{
#ifdef RAM_DISK_ENABLE
case RAMDISK:
res = ram_disk_read(pdrv, buff, sector, count);
return res;
#endif
#ifdef USB_DISK_ENABLE
case USBDISK:
res = USB_HostMsdReadDisk(pdrv, buff, sector, count);
return res;
#endif
#ifdef SD_DISK_ENABLE
case SDDISK:
res = sd_disk_read(pdrv, buff, sector, count);
return res;
#endif
#ifdef MMC_DISK_ENABLE
case MMCDISK:
res = mmc_disk_read(pdrv, buff, sector, count);
return res;
#endif
#ifdef SDSPI_DISK_ENABLE
case SDSPIDISK:
res = sdspi_disk_read(pdrv, buff, sector, count);
return res;
#endif
#ifdef NAND_DISK_ENABLE
case NANDDISK:
res = nand_disk_read(pdrv, buff, sector, count);
return res;
#endif
default:
break;
}
return RES_PARERR;
}
/*-----------------------------------------------------------------------*/
/* Write Sector(s) */
/*-----------------------------------------------------------------------*/
DRESULT disk_write (
BYTE pdrv, /* Physical drive nmuber to identify the drive */
const BYTE *buff, /* Data to be written */
DWORD sector, /* Start sector in LBA */
UINT count /* Number of sectors to write */
)
{
DRESULT res;
switch (pdrv)
{
#ifdef RAM_DISK_ENABLE
case RAMDISK:
res = ram_disk_write(pdrv, buff, sector, count);
return res;
#endif
#ifdef USB_DISK_ENABLE
case USBDISK:
res = USB_HostMsdWriteDisk(pdrv, buff, sector, count);
return res;
#endif
#ifdef SD_DISK_ENABLE
case SDDISK:
res = sd_disk_write(pdrv, buff, sector, count);
return res;
#endif
#ifdef MMC_DISK_ENABLE
case MMCDISK:
res = mmc_disk_write(pdrv, buff, sector, count);
return res;
#endif
#ifdef SDSPI_DISK_ENABLE
case SDSPIDISK:
res = sdspi_disk_write(pdrv, buff, sector, count);
return res;
#endif
#ifdef NAND_DISK_ENABLE
case NANDDISK:
res = nand_disk_write(pdrv, buff, sector, count);
return res;
#endif
default:
break;
}
return RES_PARERR;
}
/*-----------------------------------------------------------------------*/
/* Miscellaneous Functions */
/*-----------------------------------------------------------------------*/
DRESULT disk_ioctl (
BYTE pdrv, /* Physical drive nmuber (0..) */
BYTE cmd, /* Control code */
void *buff /* Buffer to send/receive control data */
)
{
DRESULT res;
switch (pdrv)
{
#ifdef RAM_DISK_ENABLE
case RAMDISK:
res = ram_disk_ioctl(pdrv, cmd, buff);
return res;
#endif
#ifdef USB_DISK_ENABLE
case USBDISK:
res = USB_HostMsdIoctlDisk(pdrv, cmd, buff);
return res;
#endif
#ifdef SD_DISK_ENABLE
case SDDISK:
res = sd_disk_ioctl(pdrv, cmd, buff);
return res;
#endif
#ifdef MMC_DISK_ENABLE
case MMCDISK:
res = mmc_disk_ioctl(pdrv, cmd, buff);
return res;
#endif
#ifdef SDSPI_DISK_ENABLE
case SDSPIDISK:
res = sdspi_disk_ioctl(pdrv, cmd, buff);
return res;
#endif
#ifdef NAND_DISK_ENABLE
case NANDDISK:
res = nand_disk_ioctl(pdrv, cmd, buff);
return res;
#endif
default:
break;
}
return RES_PARERR;
}
#endif /* McuLib_CONFIG_USE_FAT_FS */

View File

@@ -0,0 +1,118 @@
/*-----------------------------------------------------------------------/
/ Low level disk interface modlue include file (C)ChaN, 2014 /
/-----------------------------------------------------------------------*/
#ifndef _DISKIO_DEFINED
#define _DISKIO_DEFINED
#ifdef __cplusplus
extern "C" {
#endif
/* Definitions of physical drive number for each drive */
#if 1 /* << EST */
#define SDSPIDISK 0 /* sdspi disk to physical drive 4 */
#define USBDISK 1 /* usb disk to physical drive 1 */
#define RAMDISK 2 /* Example: ram disk to physical drive 0 */
#define SDDISK 3 /* sd disk to physical drive 2 */
#define MMCDISK 4 /* mmc disk to physical drive 3 */
#define NANDDISK 5 /* nand disk to physical drive 5 */
#else
#define RAMDISK 0 /* Example: ram disk to physical drive 0 */
#define USBDISK 1 /* usb disk to physical drive 1 */
#define SDDISK 2 /* sd disk to physical drive 2 */
#define MMCDISK 3 /* mmc disk to physical drive 3 */
#define SDSPIDISK 4 /* sdspi disk to physical drive 4 */
#define NANDDISK 5 /* nand disk to physical drive 5 */
#endif
/* Status of Disk Functions */
typedef BYTE DSTATUS;
/* Results of Disk Functions */
typedef enum {
RES_OK = 0, /* 0: Successful */
RES_ERROR, /* 1: R/W Error */
RES_WRPRT, /* 2: Write Protected */
RES_NOTRDY, /* 3: Not Ready */
RES_PARERR /* 4: Invalid Parameter */
} DRESULT;
/*---------------------------------------*/
/* Prototypes for disk control functions */
DSTATUS disk_initialize (BYTE pdrv);
DSTATUS disk_status (BYTE pdrv);
DRESULT disk_read (BYTE pdrv, BYTE* buff, DWORD sector, UINT count);
DRESULT disk_write (BYTE pdrv, const BYTE* buff, DWORD sector, UINT count);
DRESULT disk_ioctl (BYTE pdrv, BYTE cmd, void* buff);
/* Disk Status Bits (DSTATUS) */
#define STA_NOINIT 0x01 /* Drive not initialized */
#define STA_NODISK 0x02 /* No medium in the drive */
#define STA_PROTECT 0x04 /* Write protected */
/* Command code for disk_ioctrl function */
/* Generic command (Used by FatFs) */
#define CTRL_SYNC 0 /* Complete pending write process (needed at FF_FS_READONLY == 0) */
#define GET_SECTOR_COUNT 1 /* Get media size (needed at FF_USE_MKFS == 1) */
#define GET_SECTOR_SIZE 2 /* Get sector size (needed at FF_MAX_SS != FF_MIN_SS) */
#define GET_BLOCK_SIZE 3 /* Get erase block size (needed at FF_USE_MKFS == 1) */
#define CTRL_TRIM 4 /* Inform device that the data on the block of sectors is no longer used (needed at FF_USE_TRIM == 1) */
/* Generic command (Not used by FatFs) */
#define CTRL_POWER 5 /* Get/Set power status */
#define CTRL_LOCK 6 /* Lock/Unlock media removal */
#define CTRL_EJECT 7 /* Eject media */
#define CTRL_FORMAT 8 /* Create physical format on the media */
/* MMC/SDC specific ioctl command */
#define MMC_GET_TYPE 10 /* Get card type */
/* << EST */
#define CT_SD1 (1<<0) /* LDD_SDHC_SD, Secure Digital memory card */
#define CT_SD2 (1<<1) /* LDD_SDHC_SDIO, Secure Digital IO card */
#define CT_BLOCK (1<<2)
#define CT_MMC (1<<3) /* LDD_SDHC_MMC, MultiMediaCard memory card */
#define CT_SDC (1<<4) /* LDD_SDHC_SDCOMBO, Combined Secure Digital memory and IO card */
#define CT_ATA (1<<5) /* LDD_SDHC_CE_ATA, Consumer Electronics ATA card */
/* << EST */
#define MMC_GET_CSD 11 /* Get CSD */
#define MMC_GET_CID 12 /* Get CID */
#define MMC_GET_OCR 13 /* Get OCR */
#define MMC_GET_SDSTAT 14 /* Get SD status */
/* << EST */
#define MMC_GET_SDC_VERSION 15 /* 1 byte */
#define MMC_GET_READ_BL_LEN 16 /* 2 bytes */
#define MMC_GET_DRIVER_VERSION 17 /* 1 byte: return: 0 SPI driver, 1 LLD SDHC driver */
#define MMC_GET_LLD_INFO 18 /* array: 1 byte subcommand, 1 byte bufSize, bufSize*bytes */
#define MMC_GET_LLD_CMD_HIGH_CAPACITY 0 /* return 1 byte, 0 for no, 1 for yes */
#define MMC_GET_LLD_CMD_HIGH_SPEED 1 /* return 1 byte, 0 for no, 1 for yes */
#define MMC_GET_LLD_CMD_LOW_VOLTAGE 2 /* return 1 byte, 0 for no, 1 for yes */
#define MMC_GET_LLD_CMD_DATA_WIDTHS 3 /* return 1 byte (bitset), 0x1: 1, 0x2: 4, 0x4: 8 */
#define MMC_GET_LLD_CMD_OPERATIONS 4 /* return 1 byte (bitset), 0x1: block read, 0x2: block write, 0x4: block erase, 0x8: write protection, 0x10: I/O */
/*<< EST */
#define ISDIO_READ 55 /* Read data form SD iSDIO register */
#define ISDIO_WRITE 56 /* Write data to SD iSDIO register */
#define ISDIO_MRITE 57 /* Masked write data to SD iSDIO register */
/* ATA/CF specific ioctl command */
#define ATA_GET_REV 20 /* Get F/W revision */
#define ATA_GET_MODEL 21 /* Get model name */
#define ATA_GET_SN 22 /* Get serial number */
#ifdef __cplusplus
}
#endif
#endif

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,410 @@
/*----------------------------------------------------------------------------/
/ FatFs - Generic FAT Filesystem module R0.13c /
/-----------------------------------------------------------------------------/
/
/ Copyright (C) 2018, ChaN, all right reserved.
/
/ FatFs module is an open source software. Redistribution and use of FatFs in
/ source and binary forms, with or without modification, are permitted provided
/ that the following condition is met:
/ 1. Redistributions of source code must retain the above copyright notice,
/ this condition and the following disclaimer.
/
/ This software is provided by the copyright holder and contributors "AS IS"
/ and any warranties related to this software are DISCLAIMED.
/ The copyright owner or contributors be NOT LIABLE for any damages caused
/ by use of this software.
/
/----------------------------------------------------------------------------*/
#ifndef FF_DEFINED
#define FF_DEFINED 86604 /* Revision ID */
#ifdef __cplusplus
extern "C" {
#endif
#include "McuLib.h"
#if McuLib_CONFIG_USE_FAT_FS
#include "ffconf.h" /* FatFs configuration options */
#if FF_DEFINED != FFCONF_DEF
#error Wrong configuration file (ffconf.h).
#endif
/* Integer types used for FatFs API */
#if defined(_WIN32) /* Main development platform */
#define FF_INTDEF 2
#include <windows.h>
typedef unsigned __int64 QWORD;
#elif (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || defined(__cplusplus) /* C99 or later */
#define FF_INTDEF 2
#include <stdint.h>
typedef unsigned int UINT; /* int must be 16-bit or 32-bit */
typedef unsigned char BYTE; /* char must be 8-bit */
typedef uint16_t WORD; /* 16-bit unsigned integer */
typedef uint16_t WCHAR; /* 16-bit unsigned integer */
typedef uint32_t DWORD; /* 32-bit unsigned integer */
typedef uint64_t QWORD; /* 64-bit unsigned integer */
#else /* Earlier than C99 */
#define FF_INTDEF 1
typedef unsigned int UINT; /* int must be 16-bit or 32-bit */
typedef unsigned char BYTE; /* char must be 8-bit */
typedef unsigned short WORD; /* 16-bit unsigned integer */
typedef unsigned short WCHAR; /* 16-bit unsigned integer */
typedef unsigned long DWORD; /* 32-bit unsigned integer */
#endif
/* Definitions of volume management */
#if FF_MULTI_PARTITION /* Multiple partition configuration */
typedef struct {
BYTE pd; /* Physical drive number */
BYTE pt; /* Partition: 0:Auto detect, 1-4:Forced partition) */
} PARTITION;
extern PARTITION VolToPart[]; /* Volume - Partition resolution table */
#endif
#if FF_STR_VOLUME_ID
#ifndef FF_VOLUME_STRS
extern const char* VolumeStr[FF_VOLUMES]; /* User defied volume ID */
#endif
#endif
/* Type of path name strings on FatFs API */
#ifndef _INC_TCHAR
#define _INC_TCHAR
#if FF_USE_LFN && FF_LFN_UNICODE == 1 /* Unicode in UTF-16 encoding */
typedef WCHAR TCHAR;
#define _T(x) L ## x
#define _TEXT(x) L ## x
#elif FF_USE_LFN && FF_LFN_UNICODE == 2 /* Unicode in UTF-8 encoding */
typedef char TCHAR;
#define _T(x) u8 ## x
#define _TEXT(x) u8 ## x
#elif FF_USE_LFN && FF_LFN_UNICODE == 3 /* Unicode in UTF-32 encoding */
typedef DWORD TCHAR;
#define _T(x) U ## x
#define _TEXT(x) U ## x
#elif FF_USE_LFN && (FF_LFN_UNICODE < 0 || FF_LFN_UNICODE > 3)
#error Wrong FF_LFN_UNICODE setting
#else /* ANSI/OEM code in SBCS/DBCS */
typedef char TCHAR;
#define _T(x) x
#define _TEXT(x) x
#endif
#endif
/* Type of file size variables */
#if FF_FS_EXFAT
#if FF_INTDEF != 2
#error exFAT feature wants C99 or later
#endif
typedef QWORD FSIZE_t;
#else
typedef DWORD FSIZE_t;
#endif
/* Filesystem object structure (FATFS) */
typedef struct {
BYTE fs_type; /* Filesystem type (0:not mounted) */
BYTE pdrv; /* Associated physical drive */
BYTE n_fats; /* Number of FATs (1 or 2) */
BYTE wflag; /* win[] flag (b0:dirty) */
BYTE fsi_flag; /* FSINFO flags (b7:disabled, b0:dirty) */
WORD id; /* Volume mount ID */
WORD n_rootdir; /* Number of root directory entries (FAT12/16) */
WORD csize; /* Cluster size [sectors] */
#if FF_MAX_SS != FF_MIN_SS
WORD ssize; /* Sector size (512, 1024, 2048 or 4096) */
#endif
#if FF_USE_LFN
WCHAR* lfnbuf; /* LFN working buffer */
#endif
#if FF_FS_EXFAT
BYTE* dirbuf; /* Directory entry block scratchpad buffer for exFAT */
#endif
#if FF_FS_REENTRANT
FF_SYNC_t sobj; /* Identifier of sync object */
#endif
#if !FF_FS_READONLY
DWORD last_clst; /* Last allocated cluster */
DWORD free_clst; /* Number of free clusters */
#endif
#if FF_FS_RPATH
DWORD cdir; /* Current directory start cluster (0:root) */
#if FF_FS_EXFAT
DWORD cdc_scl; /* Containing directory start cluster (invalid when cdir is 0) */
DWORD cdc_size; /* b31-b8:Size of containing directory, b7-b0: Chain status */
DWORD cdc_ofs; /* Offset in the containing directory (invalid when cdir is 0) */
#endif
#endif
DWORD n_fatent; /* Number of FAT entries (number of clusters + 2) */
DWORD fsize; /* Size of an FAT [sectors] */
DWORD volbase; /* Volume base sector */
DWORD fatbase; /* FAT base sector */
DWORD dirbase; /* Root directory base sector/cluster */
DWORD database; /* Data base sector */
#if FF_FS_EXFAT
DWORD bitbase; /* Allocation bitmap base sector */
#endif
DWORD winsect; /* Current sector appearing in the win[] */
BYTE win[FF_MAX_SS]; /* Disk access window for Directory, FAT (and file data at tiny cfg) */
} FATFS;
/* Object ID and allocation information (FFOBJID) */
typedef struct {
FATFS* fs; /* Pointer to the hosting volume of this object */
WORD id; /* Hosting volume mount ID */
BYTE attr; /* Object attribute */
BYTE stat; /* Object chain status (b1-0: =0:not contiguous, =2:contiguous, =3:fragmented in this session, b2:sub-directory stretched) */
DWORD sclust; /* Object data start cluster (0:no cluster or root directory) */
FSIZE_t objsize; /* Object size (valid when sclust != 0) */
#if FF_FS_EXFAT
DWORD n_cont; /* Size of first fragment - 1 (valid when stat == 3) */
DWORD n_frag; /* Size of last fragment needs to be written to FAT (valid when not zero) */
DWORD c_scl; /* Containing directory start cluster (valid when sclust != 0) */
DWORD c_size; /* b31-b8:Size of containing directory, b7-b0: Chain status (valid when c_scl != 0) */
DWORD c_ofs; /* Offset in the containing directory (valid when file object and sclust != 0) */
#endif
#if FF_FS_LOCK
UINT lockid; /* File lock ID origin from 1 (index of file semaphore table Files[]) */
#endif
} FFOBJID;
/* File object structure (FIL) */
typedef struct {
FFOBJID obj; /* Object identifier (must be the 1st member to detect invalid object pointer) */
BYTE flag; /* File status flags */
BYTE err; /* Abort flag (error code) */
FSIZE_t fptr; /* File read/write pointer (Zeroed on file open) */
DWORD clust; /* Current cluster of fpter (invalid when fptr is 0) */
DWORD sect; /* Sector number appearing in buf[] (0:invalid) */
#if !FF_FS_READONLY
DWORD dir_sect; /* Sector number containing the directory entry (not used at exFAT) */
BYTE* dir_ptr; /* Pointer to the directory entry in the win[] (not used at exFAT) */
#endif
#if FF_USE_FASTSEEK
DWORD* cltbl; /* Pointer to the cluster link map table (nulled on open, set by application) */
#endif
#if !FF_FS_TINY
BYTE buf[FF_MAX_SS]; /* File private data read/write window */
#endif
} FIL;
/* Directory object structure (DIR) */
typedef struct {
FFOBJID obj; /* Object identifier */
DWORD dptr; /* Current read/write offset */
DWORD clust; /* Current cluster */
DWORD sect; /* Current sector (0:Read operation has terminated) */
BYTE* dir; /* Pointer to the directory item in the win[] */
BYTE fn[12]; /* SFN (in/out) {body[8],ext[3],status[1]} */
#if FF_USE_LFN
DWORD blk_ofs; /* Offset of current entry block being processed (0xFFFFFFFF:Invalid) */
#endif
#if FF_USE_FIND
const TCHAR* pat; /* Pointer to the name matching pattern */
#endif
} DIR;
/* File information structure (FILINFO) */
typedef struct {
FSIZE_t fsize; /* File size */
WORD fdate; /* Modified date */
WORD ftime; /* Modified time */
BYTE fattrib; /* File attribute */
#if FF_USE_LFN
TCHAR altname[FF_SFN_BUF + 1];/* Altenative file name */
TCHAR fname[FF_LFN_BUF + 1]; /* Primary file name */
#else
TCHAR fname[12 + 1]; /* File name */
#endif
} FILINFO;
/* File function return code (FRESULT) */
typedef enum {
FR_OK = 0, /* (0) Succeeded */
FR_DISK_ERR, /* (1) A hard error occurred in the low level disk I/O layer */
FR_INT_ERR, /* (2) Assertion failed */
FR_NOT_READY, /* (3) The physical drive cannot work */
FR_NO_FILE, /* (4) Could not find the file */
FR_NO_PATH, /* (5) Could not find the path */
FR_INVALID_NAME, /* (6) The path name format is invalid */
FR_DENIED, /* (7) Access denied due to prohibited access or directory full */
FR_EXIST, /* (8) Access denied due to prohibited access */
FR_INVALID_OBJECT, /* (9) The file/directory object is invalid */
FR_WRITE_PROTECTED, /* (10) The physical drive is write protected */
FR_INVALID_DRIVE, /* (11) The logical drive number is invalid */
FR_NOT_ENABLED, /* (12) The volume has no work area */
FR_NO_FILESYSTEM, /* (13) There is no valid FAT volume */
FR_MKFS_ABORTED, /* (14) The f_mkfs() aborted due to any problem */
FR_TIMEOUT, /* (15) Could not get a grant to access the volume within defined period */
FR_LOCKED, /* (16) The operation is rejected according to the file sharing policy */
FR_NOT_ENOUGH_CORE, /* (17) LFN working buffer could not be allocated */
FR_TOO_MANY_OPEN_FILES, /* (18) Number of open files > FF_FS_LOCK */
FR_INVALID_PARAMETER /* (19) Given parameter is invalid */
} FRESULT;
/*--------------------------------------------------------------*/
/* FatFs module application interface */
FRESULT f_open (FIL* fp, const TCHAR* path, BYTE mode); /* Open or create a file */
FRESULT f_close (FIL* fp); /* Close an open file object */
FRESULT f_read (FIL* fp, void* buff, UINT btr, UINT* br); /* Read data from the file */
FRESULT f_write (FIL* fp, const void* buff, UINT btw, UINT* bw); /* Write data to the file */
FRESULT f_lseek (FIL* fp, FSIZE_t ofs); /* Move file pointer of the file object */
FRESULT f_truncate (FIL* fp); /* Truncate the file */
FRESULT f_sync (FIL* fp); /* Flush cached data of the writing file */
FRESULT f_opendir (DIR* dp, const TCHAR* path); /* Open a directory */
FRESULT f_closedir (DIR* dp); /* Close an open directory */
FRESULT f_readdir (DIR* dp, FILINFO* fno); /* Read a directory item */
FRESULT f_findfirst (DIR* dp, FILINFO* fno, const TCHAR* path, const TCHAR* pattern); /* Find first file */
FRESULT f_findnext (DIR* dp, FILINFO* fno); /* Find next file */
FRESULT f_mkdir (const TCHAR* path); /* Create a sub directory */
FRESULT f_unlink (const TCHAR* path); /* Delete an existing file or directory */
FRESULT f_rename (const TCHAR* path_old, const TCHAR* path_new); /* Rename/Move a file or directory */
FRESULT f_stat (const TCHAR* path, FILINFO* fno); /* Get file status */
FRESULT f_chmod (const TCHAR* path, BYTE attr, BYTE mask); /* Change attribute of a file/dir */
FRESULT f_utime (const TCHAR* path, const FILINFO* fno); /* Change timestamp of a file/dir */
FRESULT f_chdir (const TCHAR* path); /* Change current directory */
FRESULT f_chdrive (const TCHAR* path); /* Change current drive */
FRESULT f_getcwd (TCHAR* buff, UINT len); /* Get current directory */
FRESULT f_getfree (const TCHAR* path, DWORD* nclst, FATFS** fatfs); /* Get number of free clusters on the drive */
FRESULT f_getlabel (const TCHAR* path, TCHAR* label, DWORD* vsn); /* Get volume label */
FRESULT f_setlabel (const TCHAR* label); /* Set volume label */
FRESULT f_forward (FIL* fp, UINT(*func)(const BYTE*,UINT), UINT btf, UINT* bf); /* Forward data to the stream */
FRESULT f_expand (FIL* fp, FSIZE_t fsz, BYTE opt); /* Allocate a contiguous block to the file */
FRESULT f_mount (FATFS* fs, const TCHAR* path, BYTE opt); /* Mount/Unmount a logical drive */
FRESULT f_mkfs (const TCHAR* path, BYTE opt, DWORD au, void* work, UINT len); /* Create a FAT volume */
FRESULT f_fdisk (BYTE pdrv, const DWORD* szt, void* work); /* Divide a physical drive into some partitions */
FRESULT f_setcp (WORD cp); /* Set current code page */
int f_putc (TCHAR c, FIL* fp); /* Put a character to the file */
int f_puts (const TCHAR* str, FIL* cp); /* Put a string to the file */
int f_printf (FIL* fp, const TCHAR* str, ...); /* Put a formatted string to the file */
TCHAR* f_gets (TCHAR* buff, int len, FIL* fp); /* Get a string from the file */
#define f_eof(fp) ((int)((fp)->fptr == (fp)->obj.objsize))
#define f_error(fp) ((fp)->err)
#define f_tell(fp) ((fp)->fptr)
#define f_size(fp) ((fp)->obj.objsize)
#define f_rewind(fp) f_lseek((fp), 0)
#define f_rewinddir(dp) f_readdir((dp), 0)
#define f_rmdir(path) f_unlink(path)
#define f_unmount(path) f_mount(0, path, 0)
#ifndef EOF
#define EOF (-1)
#endif
/*--------------------------------------------------------------*/
/* Additional user defined functions */
/* RTC function */
#if !FF_FS_READONLY && !FF_FS_NORTC
DWORD get_fattime (void);
#endif
/* LFN support functions */
#if FF_USE_LFN >= 1 /* Code conversion (defined in unicode.c) */
WCHAR ff_oem2uni (WCHAR oem, WORD cp); /* OEM code to Unicode conversion */
WCHAR ff_uni2oem (DWORD uni, WORD cp); /* Unicode to OEM code conversion */
DWORD ff_wtoupper (DWORD uni); /* Unicode upper-case conversion */
#endif
#if FF_USE_LFN == 3 /* Dynamic memory allocation */
void* ff_memalloc (UINT msize); /* Allocate memory block */
void ff_memfree (void* mblock); /* Free memory block */
#endif
/* Sync functions */
#if FF_FS_REENTRANT
int ff_cre_syncobj (BYTE vol, FF_SYNC_t* sobj); /* Create a sync object */
int ff_req_grant (FF_SYNC_t sobj); /* Lock sync object */
void ff_rel_grant (FF_SYNC_t sobj); /* Unlock sync object */
int ff_del_syncobj (FF_SYNC_t sobj); /* Delete a sync object */
#endif
/*--------------------------------------------------------------*/
/* Flags and offset address */
/* File access mode and open method flags (3rd argument of f_open) */
#define FA_READ 0x01
#define FA_WRITE 0x02
#define FA_OPEN_EXISTING 0x00
#define FA_CREATE_NEW 0x04
#define FA_CREATE_ALWAYS 0x08
#define FA_OPEN_ALWAYS 0x10
#define FA_OPEN_APPEND 0x30
/* Fast seek controls (2nd argument of f_lseek) */
#define CREATE_LINKMAP ((FSIZE_t)0 - 1)
/* Format options (2nd argument of f_mkfs) */
#define FM_FAT 0x01
#define FM_FAT32 0x02
#define FM_EXFAT 0x04
#define FM_ANY 0x07
#define FM_SFD 0x08
/* Filesystem type (FATFS.fs_type) */
#define FS_FAT12 1
#define FS_FAT16 2
#define FS_FAT32 3
#define FS_EXFAT 4
/* File attribute bits for directory entry (FILINFO.fattrib) */
#define AM_RDO 0x01 /* Read only */
#define AM_HID 0x02 /* Hidden */
#define AM_SYS 0x04 /* System */
#define AM_DIR 0x10 /* Directory */
#define AM_ARC 0x20 /* Archive */
#ifdef __cplusplus
}
#endif
#endif /* FF_DEFINED */
#endif /* McuLib_CONFIG_USE_FAT_FS */

View File

@@ -0,0 +1,170 @@
/*------------------------------------------------------------------------*/
/* Sample Code of OS Dependent Functions for FatFs */
/* (C)ChaN, 2018 */
/*------------------------------------------------------------------------*/
#include "ff.h"
#if FF_USE_LFN == 3 /* Dynamic memory allocation */
/*------------------------------------------------------------------------*/
/* Allocate a memory block */
/*------------------------------------------------------------------------*/
void* ff_memalloc ( /* Returns pointer to the allocated memory block (null if not enough core) */
UINT msize /* Number of bytes to allocate */
)
{
return malloc(msize); /* Allocate a new memory block with POSIX API */
}
/*------------------------------------------------------------------------*/
/* Free a memory block */
/*------------------------------------------------------------------------*/
void ff_memfree (
void* mblock /* Pointer to the memory block to free (nothing to do if null) */
)
{
free(mblock); /* Free the memory block with POSIX API */
}
#endif
#if 0 && FF_FS_REENTRANT /* Mutal exclusion */
/*------------------------------------------------------------------------*/
/* Create a Synchronization Object */
/*------------------------------------------------------------------------*/
/* This function is called in f_mount() function to create a new
/ synchronization object for the volume, such as semaphore and mutex.
/ When a 0 is returned, the f_mount() function fails with FR_INT_ERR.
*/
//const osMutexDef_t Mutex[FF_VOLUMES]; /* Table of CMSIS-RTOS mutex */
int ff_cre_syncobj ( /* 1:Function succeeded, 0:Could not create the sync object */
BYTE vol, /* Corresponding volume (logical drive number) */
FF_SYNC_t* sobj /* Pointer to return the created sync object */
)
{
/* Win32 */
//*sobj = CreateMutex(NULL, FALSE, NULL);
//return (int)(*sobj != INVALID_HANDLE_VALUE);
/* uITRON */
// T_CSEM csem = {TA_TPRI,1,1};
// *sobj = acre_sem(&csem);
// return (int)(*sobj > 0);
/* uC/OS-II */
// OS_ERR err;
// *sobj = OSMutexCreate(0, &err);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
*sobj = xSemaphoreCreateMutex();
return (int)(*sobj != NULL);
/* CMSIS-RTOS */
// *sobj = osMutexCreate(&Mutex[vol]);
// return (int)(*sobj != NULL);
}
/*------------------------------------------------------------------------*/
/* Delete a Synchronization Object */
/*------------------------------------------------------------------------*/
/* This function is called in f_mount() function to delete a synchronization
/ object that created with ff_cre_syncobj() function. When a 0 is returned,
/ the f_mount() function fails with FR_INT_ERR.
*/
int ff_del_syncobj ( /* 1:Function succeeded, 0:Could not delete due to an error */
FF_SYNC_t sobj /* Sync object tied to the logical drive to be deleted */
)
{
/* Win32 */
return (int)CloseHandle(sobj);
/* uITRON */
// return (int)(del_sem(sobj) == E_OK);
/* uC/OS-II */
// OS_ERR err;
// OSMutexDel(sobj, OS_DEL_ALWAYS, &err);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
vSemaphoreDelete(sobj);
return 1;
/* CMSIS-RTOS */
// return (int)(osMutexDelete(sobj) == osOK);
}
/*------------------------------------------------------------------------*/
/* Request Grant to Access the Volume */
/*------------------------------------------------------------------------*/
/* This function is called on entering file functions to lock the volume.
/ When a 0 is returned, the file function fails with FR_TIMEOUT.
*/
int ff_req_grant ( /* 1:Got a grant to access the volume, 0:Could not get a grant */
FF_SYNC_t sobj /* Sync object to wait */
)
{
/* Win32 */
//return (int)(WaitForSingleObject(sobj, FF_FS_TIMEOUT) == WAIT_OBJECT_0);
/* uITRON */
// return (int)(wai_sem(sobj) == E_OK);
/* uC/OS-II */
// OS_ERR err;
// OSMutexPend(sobj, FF_FS_TIMEOUT, &err));
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
return (int)(xSemaphoreTake(sobj, FF_FS_TIMEOUT) == pdTRUE);
/* CMSIS-RTOS */
// return (int)(osMutexWait(sobj, FF_FS_TIMEOUT) == osOK);
}
/*------------------------------------------------------------------------*/
/* Release Grant to Access the Volume */
/*------------------------------------------------------------------------*/
/* This function is called on leaving file functions to unlock the volume.
*/
void ff_rel_grant (
FF_SYNC_t sobj /* Sync object to be signaled */
)
{
/* Win32 */
//ReleaseMutex(sobj);
/* uITRON */
// sig_sem(sobj);
/* uC/OS-II */
// OSMutexPost(sobj);
/* FreeRTOS */
xSemaphoreGive(sobj);
/* CMSIS-RTOS */
// osMutexRelease(sobj);
}
#endif

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,117 @@
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016 NXP
* All rights reserved.
*
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#include "McuLib.h"
#if McuLib_CONFIG_USE_FAT_FS
#include "ffconf.h"
/* This fatfs subcomponent is disabled by default
* To enable it, define following macro in ffconf.h */
#ifdef RAM_DISK_ENABLE
#include "fsl_common.h"
#include "fsl_ram_disk.h"
/*******************************************************************************
* Definitions
******************************************************************************/
/* clang-format off */
#define SECTOR_SIZE FF_MIN_SS /* usualy 512 B */
#define DISK_SIZE 65536 /* minmal disk size calculated as 128 * FF_MIN_SS (ff.c ln 4112) , 128*512=65536 */
/* clang-format on */
/*******************************************************************************
* Globals
******************************************************************************/
static uint8_t disk_space[DISK_SIZE];
/*******************************************************************************
* Code
******************************************************************************/
/*!
* @brief Get RAM disk status.
*/
DSTATUS ram_disk_status(BYTE pdrv)
{
if (pdrv != RAMDISK)
{
return STA_NOINIT;
}
return 0;
}
/*!
* @brief Inidialize a RAM disk.
*/
DSTATUS ram_disk_initialize(BYTE pdrv)
{
if (pdrv != RAMDISK)
{
return STA_NOINIT;
}
return 0;
}
/*!
* @brief Read Sector(s) from RAM disk.
*/
DRESULT ram_disk_read(BYTE pdrv, BYTE *buff, DWORD sector, UINT count)
{
if (pdrv != RAMDISK)
{
return RES_PARERR;
}
memcpy(buff, disk_space + sector * SECTOR_SIZE, SECTOR_SIZE * count);
return RES_OK;
}
/*!
* @brief Write Sector(s) to RAM disk.
*/
DRESULT ram_disk_write(BYTE pdrv, const BYTE *buff, DWORD sector, UINT count)
{
if (pdrv != RAMDISK)
{
return RES_PARERR;
}
memcpy(disk_space + sector * SECTOR_SIZE, buff, SECTOR_SIZE * count);
return RES_OK;
}
/*!
* @brief Miscellaneous RAM disk Functions.
*/
DRESULT ram_disk_ioctl(BYTE pdrv, BYTE cmd, void *buff)
{
if (pdrv != RAMDISK)
{
return RES_PARERR;
}
switch (cmd)
{
case GET_SECTOR_COUNT:
*(uint32_t *)buff = DISK_SIZE / SECTOR_SIZE;
return RES_OK;
break;
case GET_SECTOR_SIZE:
*(uint32_t *)buff = SECTOR_SIZE;
return RES_OK;
break;
case CTRL_SYNC:
return RES_OK;
break;
default:
break;
}
return RES_PARERR;
}
#endif /* RAM_DISK_ENABLE */
#endif /* McuLib_CONFIG_USE_FAT_FS */

View File

@@ -0,0 +1,37 @@
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016 NXP
* All rights reserved.
*
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#ifndef __FSL_RAMDISK_H__
#define __FSL_RAMDISK_H__
#include "ff.h"
#include "diskio.h"
/*******************************************************************************
* Definitions
******************************************************************************/
#if defined(__cplusplus)
extern "C" {
#endif
/*******************************************************************************
* API
******************************************************************************/
DSTATUS ram_disk_initialize(BYTE pdrv);
DSTATUS ram_disk_status(BYTE pdrv);
DRESULT ram_disk_read(BYTE pdrv, BYTE *buff, DWORD sector, UINT count);
DRESULT ram_disk_write(BYTE pdrv, const BYTE *buff, DWORD sector, UINT count);
DRESULT ram_disk_ioctl(BYTE pdrv, BYTE cmd, void *buff);
#if defined(__cplusplus)
}
#endif
#endif /* __FSL_RAMDISK_H__ */

View File

@@ -0,0 +1,545 @@
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016 NXP
* All rights reserved.
*
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#include "McuLib.h"
#if McuLib_CONFIG_USE_FAT_FS
#include "ffconf.h"
/* This fatfs subcomponent is disabled by default
* To enable it, define following macro in ffconf.h */
#ifdef SDSPI_DISK_ENABLE
#include <assert.h>
#include <stdio.h>
#include <string.h>
#if McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_K22FN
#include "fsl_dspi.h"
#elif McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_LPC55S16
#include "fsl_spi.h"
#else
#error "target not supported yet"
#endif /* McuLib_CONFIG_CPU_VARIANT */
#include "fsl_sdspi.h"
#include "fsl_gpio.h"
#include "fsl_sdspi_disk.h"
/* << EST */
/******************************* SD Card Standard Commands **********************************/
#define McuSDCard_CMD0 (0x40+0) /* Resets the SD Memory Card */
#define McuSDCard_CMD1 (0x40+1) /* Sends host capacity support information and activates the card's
initialization process. HCS is effective when card receives SEND_IF_COND
command. Reserved bits shall be set to '0'. */
#define McuSDCard_CMD6 (0x40+6) /* Checks switchable function (mode 0) and switches card function (mode 1).*/
#define McuSDCard_CMD8 (0x40+8) /* Sends SD Memory Card interface condition that includes host supply voltage
information and asks the accessed card whether card can operate in supplied
voltage range. Reserved bits shall be set to '0'.*/
#define McuSDCard_CMD9 (0x40+9) /* Asks the selected card to send its cardspecific data (CSD)*/
#define McuSDCard_CMD10 (0x40+10) /* Asks the selected card to send its card identification (CID) */
#define McuSDCard_CMD12 (0x40+12) /* Forces the card to stop transmission in Multiple Block Read Operation */
#define McuSDCard_CMD13 (0x40+13) /* Asks the selected card to send its status register. */
#define McuSDCard_CMD16 (0x40+16) /* Sets a block length (in bytes) for all following block commands (read and
write) of a Standard Capacity Card. Block length of the read and write
commands are fixed to 512 bytes in a High Capacity Card. The length of
LOCK_UNLOCK command is set by this command in both capacity cards.*/
#define McuSDCard_CMD17 (0x40+17) /* Reads a block of the size selected by the SET_BLOCKLEN command.*/
#define McuSDCard_CMD18 (0x40+18) /* Continuously transfers data blocks from card to host until interrupted by a
STOP_TRANSMISSION command.*/
#define McuSDCard_CMD24 (0x40+24) /* Writes a block of the size selected by the SET_BLOCKLEN command. */
#define McuSDCard_CMD25 (0x40+25) /* Continuously writes blocks of data until Stop Tran token is sent
(instead Start Block).*/
#define McuSDCard_CMD27 (0x40+27) /* Programming of the programmable bits of the CSD. */
#define McuSDCard_CMD28 (0x40+28) /* If the card has write protection features, this command sets the write protection bit
of the addressed group. The properties of write protection are coded in the card
specific data (WP_GRP_SIZE). The High Capacity Card does not support this command.*/
#define McuSDCard_CMD29 (0x40+29) /* If the card has write protection features, this command clears the write protection
bit of the addressed group. The High Capacity Card does not support this command. */
#define McuSDCard_CMD30 (0x40+30) /* If the card has write protection features, this command asks the card to send the
status of the write protection bits.6 The High Capacity Card does not support this command. */
#define McuSDCard_CMD32 (0x40+32) /* Sets the address of the first write block to be erased.*/
#define McuSDCard_CMD33 (0x40+33) /* Sets the address of the last write block of the continuous range to be erased. */
#define McuSDCard_CMD38 (0x40+38) /* Erases all previously selected write blocks */
#define McuSDCard_CMD42 (0x40+42) /* Used to Set/Reset the Password or lock/unlock the card. A transferred data block includes
all the command details - refer to Chapter 4.3.7. The size of the Data Block is defined
with SET_BLOCK_LEN command. Reserved bits in the argument and in Lock Card Data Structure
shall be set to 0. */
#define McuSDCard_CMD55 (0x40+55) /* Defines to the card that the next command is an application specific command
rather than a standard command */
#define McuSDCard_CMD56 (0x40+56) /* Used either to transfer a Data Block to the card or to get a Data Block from the card
for general purpose/application specific commands. In case of Standard Capacity SD
Memory Card, the size of the Data Block shall be defined with SET_BLOCK_LEN command.
Block length of this command is fixed to 512-byte in High Capacity Card. */
#define McuSDCard_CMD58 (0x40+58) /* Reads the OCR register of a card. CCS bit is assigned to OCR[30]. */
#define McuSDCard_CMD59 (0x40+59) /* Turns the CRC option on or off. A 1 in the CRC option bit will turn the option on,
a 0 will turn it off */
#define McuSDCard_ACMD41 (0xC0+41) /* SEND_OP_COND (SDC) */
#define McuSDCard_ACMD13 (0xC0+13) /* SD_STATUS (SDC) */
#define McuSDCard_ACMD23 (0xC0+23) /* SET_WR_BLK_ERASE_COUNT (SDC) */
static uint8_t CardType = CT_SD1; /* Card type flags */
/* << EST */
/*******************************************************************************
* Definitions
******************************************************************************/
/*******************************************************************************
* Prototypes
******************************************************************************/
/*******************************************************************************
* Variables
******************************************************************************/
/* SDSPI driver state. */
sdspi_card_t g_card;
sdspi_host_t g_host;
/*******************************************************************************
* Code - SD disk interface
******************************************************************************/
DRESULT sdspi_disk_write(uint8_t physicalDrive, const uint8_t *buffer, uint32_t sector, uint8_t count)
{
if (physicalDrive != SDSPIDISK)
{
return RES_PARERR;
}
if (kStatus_Success != SDSPI_WriteBlocks(&g_card, (uint8_t *)buffer, sector, count))
{
return RES_ERROR;
}
return RES_OK;
}
DRESULT sdspi_disk_read(uint8_t physicalDrive, uint8_t *buffer, uint32_t sector, uint8_t count)
{
if (physicalDrive != SDSPIDISK)
{
return RES_PARERR;
}
if (kStatus_Success != SDSPI_ReadBlocks(&g_card, buffer, sector, count))
{
return RES_ERROR;
}
return RES_OK;
}
#if 1 /* << EST */
#include "McuTimeout.h"
#define McuSDCard_DUMMY 0xff /* SPI dummy value */
#define McuSDCard_TIMEOUT_CMD_MS 100 /* user configured wait timeout for commands */
static void McuSDCard_SPI_WRITE(uint8_t data) {
g_card.host->exchange(&data, NULL, 1U);
}
static void McuSDCard_SPI_WRITE_READ(uint8_t data, uint8_t *val) {
g_card.host->exchange(&data, val, 1U);
}
bool McuSDCard_ReceiveDataBlock(uint8_t *data, uint16_t nofBytes) {
status_t status;
status = g_card.host->exchange(NULL, data, nofBytes);
return status==kStatus_Success; /* all ok */
}
uint8_t McuSDCard_SendCmd(uint8_t cmd, uint32_t arg)
{
uint8_t n, res;
McuTimeout_CounterHandle timeout;
if (cmd&0x80) { /* ACMD<n> is the command sequence of CMD55-CMD<n> */
cmd &= 0x7F;
res = McuSDCard_SendCmd(McuSDCard_CMD55, 0);
if (res > 1) {
return res;
}
}
/* Select the card and wait for ready */
//if (McuSDCard_WaitReady() != ERR_OK) {
// return 0xFF;
// }
// McuSDCard_Activate();
/* Send command packet */
McuSDCard_SPI_WRITE(cmd); /* Start + Command index */
n = (uint8_t)(arg>>24);
McuSDCard_SPI_WRITE(n); /* Argument[31..24] */
n = (uint8_t)(arg>>16);
McuSDCard_SPI_WRITE(n); /* Argument[23..16] */
n = (uint8_t)(arg>>8);
McuSDCard_SPI_WRITE(n); /* Argument[15..8] */
McuSDCard_SPI_WRITE((uint8_t)arg); /* Argument[7..0] */
if (cmd == McuSDCard_CMD0) {
n = 0x95; /* Valid CRC for CMD0(0) */
} else if (cmd == McuSDCard_CMD8) {
n = 0x87; /* Valid CRC for CMD8(0x1AA) */
} else {
n = 0x01; /* Dummy CRC + Stop */
}
McuSDCard_SPI_WRITE(n);
/* Receive command response */
if (cmd == McuSDCard_CMD12) {
McuSDCard_SPI_WRITE_READ(McuSDCard_DUMMY, &res); /* send dummy value, poll response */
}
timeout = McuTimeout_GetCounter(McuSDCard_TIMEOUT_CMD_MS/McuTimeout_TICK_PERIOD_MS); /* timeout */
for(;;) { /* will timeout */
McuSDCard_SPI_WRITE_READ(McuSDCard_DUMMY, &res); /* send dummy value, poll response */
if (!(res&0x80)) { /* valid response */
break;
}
if (McuTimeout_CounterExpired(timeout)) {
break;
}
}
McuTimeout_LeaveCounter(timeout);
//McuSDCard_Deactivate();
return res; /* Return with the response value */
}
uint8_t McuSDCard_ReceiveByte(void)
{
uint8_t data;
// McuSDCard_Activate();
McuSDCard_SPI_WRITE_READ(McuSDCard_DUMMY, &data); /* send dummy value, poll response */
// McuSDCard_Deactivate();
return data;
}
#endif
DRESULT sdspi_disk_ioctl(uint8_t physicalDrive, uint8_t command, void *buffer)
{
#if 1 /* << EST */
uint8_t n, csd[16], *ptr = (uint8_t*)buffer;
uint16_t csize;
#endif
DRESULT result = RES_OK;
if (physicalDrive != SDSPIDISK)
{
return RES_PARERR;
}
switch (command)
{
#if 0 /* << EST */
case GET_SECTOR_COUNT:
if (buffer)
{
*(uint32_t *)buffer = g_card.blockCount;
}
else
{
result = RES_PARERR;
}
break;
#endif
case GET_SECTOR_SIZE:
if (buffer)
{
*(uint32_t *)buffer = g_card.blockSize;
}
else
{
result = RES_PARERR;
}
break;
#if 0 /* << EST */
case GET_BLOCK_SIZE:
if (buffer)
{
*(uint32_t *)buffer = g_card.csd.eraseSectorSize;
}
else
{
result = RES_PARERR;
}
break;
#endif
case CTRL_SYNC:
result = RES_OK;
break;
/* << EST */
#if 0
case CTRL_SYNC : /* Make sure that no pending write process. Do not remove this or written sector might not left updated. */
if (McuSDCard_WaitReady() != ERR_OK) {
res = RES_ERROR;
}
break;
#endif
case MMC_GET_READ_BL_LEN: /* get Block Length */
// if (SDSPI_SendCommand(g_card.host, (kSDMMC_SendCsd<<8)|kSDSPI_ResponseTypeR1 /*McuSDCard_CMD9*/, 0, csd)!=kStatus_Success) {
// result = RES_PARERR;
// }
if ((McuSDCard_SendCmd(McuSDCard_CMD9, 0) == 0) && McuSDCard_ReceiveDataBlock(csd, 16)) {
switch((csd[5]&15)) { /* READ_BL_LEN is either 9, 10 or 11, end the block size is 2^READ_BL_LEN */
case 9: *(uint16_t*)ptr = 512; break;
case 10: *(uint16_t*)ptr = 1024; break;
case 11: *(uint16_t*)ptr = 2048; break;
default: *(uint16_t*)ptr = 0; break; /* illegal */
}
}
break;
case MMC_GET_SDC_VERSION: /* get CSD Version (1 byte: 1 for 1.xx or MMC, 2 for 2.0 */
if ((McuSDCard_SendCmd(McuSDCard_CMD9, 0) == 0) && McuSDCard_ReceiveDataBlock(csd, 16)) {
if ((csd[0] >> 6) == 1) { /* SDC ver 2.00 */
*ptr = 2;
} else { /* SDC ver 1.XX or MMC*/
*ptr = 1;
}
}
break;
case GET_SECTOR_COUNT : /* Get number of sectors on the disk (uint32_t) */
if ((McuSDCard_SendCmd(McuSDCard_CMD9, 0) == 0) && McuSDCard_ReceiveDataBlock(csd, 16)) {
if ((csd[0] >> 6) == 1) { /* SDC ver 2.00 */
csize = (uint16_t)(csd[9] + ((uint16_t)csd[8] << 8) + 1);
*(uint32_t*)buffer = (uint32_t)csize << 10;
} else { /* SDC ver 1.XX or MMC*/
n = (uint8_t)((csd[5] & 15) + ((csd[10] & 128) >> 7) + ((csd[9] & 3) << 1) + 2);
csize = (uint16_t)((csd[8] >> 6) + ((uint16_t)csd[7] << 2) + ((uint16_t)(csd[6] & 3) << 10) + 1);
*(uint32_t*)buffer = (uint32_t)csize << (uint8_t)(n - 9);
}
}
break;
// case GET_SECTOR_SIZE : /* Get R/W sector size (uint16_t) */
// *(uint16_t*)buff = McuSDCard_BLOCK_SIZE;
// break;
case GET_BLOCK_SIZE : /* Get erase block size in unit of sector (uint32_t) */
if (CardType & CT_SD2) { /* SDC ver 2.00 */
if (McuSDCard_SendCmd(McuSDCard_ACMD13, 0) == 0) { /* Read SD status */
(void)McuSDCard_ReceiveByte();
if (McuSDCard_ReceiveDataBlock(csd, 16)) { /* Read partial block */
for (n = 64 - 16; n; n--) {
(void)McuSDCard_ReceiveByte(); /* Purge trailing data */
}
*(uint32_t*)buffer = 16UL << (csd[10] >> 4);
}
}
} else { /* SDC ver 1.XX or MMC */
if ((McuSDCard_SendCmd(McuSDCard_CMD9, 0) == 0) && McuSDCard_ReceiveDataBlock(csd, 16)) { /* Read CSD */
if (CardType & CT_SD1) { /* SDC ver 1.XX */
*(uint32_t*)buffer = (uint32_t)((((csd[10] & 63) << 1) + ((uint16_t)(csd[11] & 128) >> 7) + 1) << (uint8_t)((csd[13] >> 6) - 1));
} else { /* MMC */
*(uint32_t*)buffer = (uint32_t)(((uint16_t)((csd[10] & 124) >> 2) + 1) * (((csd[11] & 3) << 3) + ((csd[11] & 224) >> 5) + 1));
}
}
}
break;
case MMC_GET_TYPE : /* Get card type flags (1 byte) */
*ptr = CardType;
break;
case MMC_GET_CSD : /* Receive CSD as a data block (16 bytes) */
if (!(McuSDCard_SendCmd(McuSDCard_CMD9, 0) == 0 /* READ_CSD */
&& McuSDCard_ReceiveDataBlock(ptr, 16)))
{
result = RES_PARERR;
}
break;
case MMC_GET_CID : /* Receive CID as a data block (16 bytes) */
if (!(McuSDCard_SendCmd(McuSDCard_CMD10, 0) == 0 /* READ_CID */
&& McuSDCard_ReceiveDataBlock(ptr, 16)))
{
result = RES_PARERR;
}
break;
case MMC_GET_OCR : /* Receive OCR as an R3 resp (4 bytes) */
if (McuSDCard_SendCmd(McuSDCard_CMD58, 0) == 0) { /* READ_OCR */
for (n = 4; n; n--) {
*ptr++ = McuSDCard_ReceiveByte();
}
} else {
result = RES_PARERR;
}
break;
case MMC_GET_SDSTAT : /* Receive SD status as a data block (64 bytes) */
if (McuSDCard_SendCmd(McuSDCard_ACMD13, 0) == 0) { /* SD_STATUS */
(void)McuSDCard_ReceiveByte();
if (!McuSDCard_ReceiveDataBlock(ptr, 64)) {
result = RES_PARERR;
}
} else {
result = RES_PARERR;
}
break;
case MMC_GET_DRIVER_VERSION: /* 1 byte: return: 0 SPI driver, 1 LLD SDHC driver */
*ptr = 0;
break;
/* << EST */
default:
result = RES_PARERR;
break;
}
return result;
}
DSTATUS sdspi_disk_status(uint8_t physicalDrive)
{
if (physicalDrive != SDSPIDISK)
{
return STA_NOINIT;
}
return 0;
}
DSTATUS sdspi_disk_initialize(uint8_t physicalDrive)
{
if (physicalDrive == SDSPIDISK)
{
spi_init();
sdspi_host_init();
SDSPI_Init(&g_card);
g_card.host = &g_host;
return 0;
}
return STA_NOINIT;
}
/*******************************************************************************
* Code - SPI interface
******************************************************************************/
void spi_init(void)
{
#if McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_K22FN
uint32_t sourceClock;
dspi_master_config_t masterConfig;
/*Master config*/
masterConfig.whichCtar = DSPI_MASTER_CTAR;
masterConfig.ctarConfig.baudRate = DSPI_BUS_BAUDRATE;
masterConfig.ctarConfig.bitsPerFrame = 8;
masterConfig.ctarConfig.cpol = kDSPI_ClockPolarityActiveHigh;
masterConfig.ctarConfig.cpha = kDSPI_ClockPhaseFirstEdge;
masterConfig.ctarConfig.direction = kDSPI_MsbFirst;
masterConfig.ctarConfig.pcsToSckDelayInNanoSec = 0;
masterConfig.ctarConfig.lastSckToPcsDelayInNanoSec = 0;
masterConfig.ctarConfig.betweenTransferDelayInNanoSec = 0;
masterConfig.whichPcs = DSPI_MASTER_PCS_CONFIG;
masterConfig.pcsActiveHighOrLow = kDSPI_PcsActiveLow;
masterConfig.enableContinuousSCK = false;
masterConfig.enableRxFifoOverWrite = false;
masterConfig.enableModifiedTimingFormat = false;
masterConfig.samplePoint = kDSPI_SckToSin0Clock;
sourceClock = CLOCK_GetFreq(DSPI_MASTER_CLK_SRC);
DSPI_MasterInit((SPI_Type *)BOARD_SDSPI_SPI_BASE, &masterConfig, sourceClock);
#elif McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_LPC55S16
spi_master_config_t userConfig = {0};
uint32_t srcFreq = 0;
status_t res;
SPI_MasterGetDefaultConfig(&userConfig);
srcFreq = SDSPI_SPI_MASTER_CLK_FREQ;
userConfig.sselNum = (spi_ssel_t)SDSPI_SPI_SSEL;
userConfig.sselPol = (spi_spol_t)SDSPI_SPI_SPOL;
userConfig.dataWidth = kSPI_Data8Bits;
userConfig.polarity = kSPI_ClockPolarityActiveHigh;
userConfig.phase = kSPI_ClockPhaseFirstEdge;
userConfig.direction = kSPI_MsbFirst;
userConfig.sselPol = kSPI_SpolActiveAllLow; /* low active CS */
res = SPI_MasterInit(SDSPI_SPI_MASTER, &userConfig, srcFreq);
if (res!=kStatus_Success) {
for(;;) {}
}
#else
#error "unknown device"
#endif
}
status_t spi_set_frequency(uint32_t frequency)
{
#if McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_K22FN
uint32_t sourceClock;
sourceClock = CLOCK_GetFreq(DSPI_MASTER_CLK_SRC);
/* If returns 0, indicates failed. */
if (DSPI_MasterSetBaudRate((SPI_Type *)BOARD_SDSPI_SPI_BASE, DSPI_MASTER_CTAR, frequency, sourceClock))
{
return kStatus_Success;
}
return kStatus_Fail;
#elif McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_LPC55S16
uint32_t sourceClock;
status_t res;
sourceClock = SDSPI_SPI_MASTER_CLK_FREQ;
/* If returns 0, indicates failed. */
res = SPI_MasterSetBaud((SPI_Type *)SDSPI_SPI_MASTER, frequency, sourceClock);
if (res!=kStatus_Success) {
for(;;) {}
}
return res;
#else
#error "unknown device"
#endif
}
status_t spi_exchange(uint8_t *in, uint8_t *out, uint32_t size)
{
#if McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_K22FN
dspi_transfer_t masterTransfer;
masterTransfer.txData = in;
masterTransfer.rxData = out;
masterTransfer.dataSize = size;
masterTransfer.configFlags = (kDSPI_MasterCtar0 | DSPI_MASTER_PCS_TRANSFER | kDSPI_MasterPcsContinuous);
return DSPI_MasterTransferBlocking((SPI_Type *)BOARD_SDSPI_SPI_BASE, &masterTransfer);
#elif McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_LPC55S16
spi_transfer_t xfer = {0};
xfer.txData = in;
xfer.rxData = out;
xfer.dataSize = size;
xfer.configFlags = kSPI_FrameAssert;
return SPI_MasterTransferBlocking(SDSPI_SPI_MASTER, &xfer);
#else
#error "unknown device"
#endif
}
#if 1 /* << EST */
static void sdspi_init(void) {
}
static void sdspi_deinit(void) {
}
static void sdspi_activePolarity(sdspi_cs_active_polarity_t polarity) { /* used to change clock polarity */
}
#endif
void sdspi_host_init(void)
{
/* Saves host state and callback. */
g_host.busBaudRate = DSPI_BUS_BAUDRATE;
g_host.setFrequency = spi_set_frequency;
g_host.exchange = spi_exchange;
#if 1 /* << EST */
g_host.init = sdspi_init;
g_host.deinit = sdspi_deinit;
g_host.csActivePolarity = sdspi_activePolarity;
#endif
/* Saves card state. */
g_card.host = &g_host;
}
#endif /* SDSPI_DISK_ENABLE */
#endif /* McuLib_CONFIG_USE_FAT_FS */

View File

@@ -0,0 +1,195 @@
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016 NXP
* All rights reserved.
*
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#ifndef _FSL_SDSPI_DISK_H_
#define _FSL_SDSPI_DISK_H_
#include <stdint.h>
#include "ff.h"
#include "diskio.h"
#include "fsl_common.h"
#include "board.h"
/*!
* @addtogroup SD Disk over SPI
* @{
*/
/*******************************************************************************
* Definitions
******************************************************************************/
#if McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_K22FN
/* DSPI clock source */
#if (BOARD_SDSPI_SPI_BASE == SPI0_BASE)
#define DSPI_MASTER_CLK_SRC (DSPI0_CLK_SRC)
#elif(BOARD_SDSPI_SPI_BASE == SPI1_BASE)
#define DSPI_MASTER_CLK_SRC (DSPI0_CLK_SRC)
#elif(BOARD_SDSPI_SPI_BASE == SPI2_BASE)
#define DSPI_MASTER_CLK_SRC (DSPI2_CLK_SRC)
#elif(BOARD_SDSPI_SPI_BASE == SPI3_BASE)
#define DSPI_MASTER_CLK_SRC (DSPI3_CLK_SRC)
#elif(BOARD_SDSPI_SPI_BASE == SPI4_BASE)
#define DSPI_MASTER_CLK_SRC (DSPI4_CLK_SRC)
#else
#error Should define the DSPI_MASTER_CLK_SRC!
#endif
/* Which PCS used to select the slave */
#if (BOARD_SDSPI_SPI_PCS_NUMBER == 0U)
#define DSPI_MASTER_PCS_CONFIG kDSPI_Pcs0
#define DSPI_MASTER_PCS_TRANSFER kDSPI_MasterPcs0
#elif(BOARD_SDSPI_SPI_PCS_NUMBER == 1U)
#define DSPI_MASTER_PCS_CONFIG kDSPI_Pcs1
#define DSPI_MASTER_PCS_TRANSFER kDSPI_MasterPcs1
#elif(BOARD_SDSPI_SPI_PCS_NUMBER == 2U)
#define DSPI_MASTER_PCS_CONFIG kDSPI_Pcs2
#define DSPI_MASTER_PCS_TRANSFER kDSPI_MasterPcs2
#elif(BOARD_SDSPI_SPI_PCS_NUMBER == 3U)
#define DSPI_MASTER_PCS_CONFIG kDSPI_Pcs3
#define DSPI_MASTER_PCS_TRANSFER kDSPI_MasterPcs3
#elif(BOARD_SDSPI_SPI_PCS_NUMBER == 4U)
#define DSPI_MASTER_PCS_CONFIG kDSPI_Pcs4
#define DSPI_MASTER_PCS_TRANSFER kDSPI_MasterPcs4
#elif(BOARD_SDSPI_SPI_PCS_NUMBER == 5U)
#define DSPI_MASTER_PCS_CONFIG kDSPI_Pcs5
#define DSPI_MASTER_PCS_TRANSFER kDSPI_MasterPcs5
#endif
#define DSPI_MASTER_CTAR (kDSPI_Ctar0) /* The CTAR to describe the transfer attribute */
#elif McuLib_CONFIG_CPU_VARIANT==McuLib_CONFIG_CPU_VARIANT_NXP_LPC55S16
#define SDSPI_SPI_MASTER SPI8
#define SDSPI_SPI_MASTER_IRQ FLEXCOMM8_IRQn
#define SDSPI_SPI_MASTER_CLK_SRC kCLOCK_Flexcomm8
#define SDSPI_SPI_MASTER_CLK_FREQ CLOCK_GetFlexCommClkFreq(8U)
#define SDSPI_SPI_SSEL 1
#define SDSPI_SPI_SPOL kSPI_SpolActiveAllLow
#else
#error "unknown device"
#endif /* McuLib_CONFIG_CPU_VARIANT */
#define DSPI_BUS_BAUDRATE (500000U) /* Transfer baudrate - 500k */
/*************************************************************************************************
* API - SD disk interface
************************************************************************************************/
#if defined(__cplusplus)
extern "C" {
#endif
/*!
* @name SD over SPI Disk Function
* @{
*/
/*!
* @brief Initializes SD disk over SPI.
*
* @param physicalDrive Physical drive number.
* @retval STA_NOINIT Failed.
* @retval RES_OK Success.
*/
DSTATUS sdspi_disk_initialize(uint8_t physicalDrive);
/*!
* Gets SD over SPI disk status
*
* @param physicalDrive Physical drive number.
* @retval STA_NOINIT Failed.
* @retval RES_OK Success.
*/
DSTATUS sdspi_disk_status(uint8_t physicalDrive);
/*!
* @brief Reads SD disk over SPI.
*
* @param physicalDrive Physical drive number.
* @param buffer The data buffer pointer to store read content.
* @param sector The start sector number to be read.
* @param count The sector count to be read.
* @retval RES_PARERR Failed.
* @retval RES_OK Success.
*/
DRESULT sdspi_disk_read(uint8_t physicalDrive, uint8_t *buffer, uint32_t sector, uint8_t count);
/*!
* @brief Writes to SD disk over SPI.
*
* @param physicalDrive Physical drive number.
* @param buffer The data buffer pointer to store write content.
* @param sector The start sector number to be written.
* @param count The sector count to be written.
* @retval RES_PARERR Failed.
* @retval RES_OK Success.
*/
DRESULT sdspi_disk_write(uint8_t physicalDrive, const uint8_t *buffer, uint32_t sector, uint8_t count);
/*!
* @brief SD over SPI disk IO operation.
*
* @param physicalDrive Physical drive number.
* @param command The command to be set.
* @param buffer The buffer to store command result.
* @retval RES_PARERR Failed.
* @retval RES_OK Success.
*/
DRESULT sdspi_disk_ioctl(uint8_t physicalDrive, uint8_t command, void *buffer);
/*************************************************************************************************
* API - SPI interface
************************************************************************************************/
/*!
* @brief Initializes the SPI.
*/
void spi_init(void);
/*!
* @brief Sets the SPI bus frequency.
*
* @param frequency The frequency to set.
* @retval kStatus_Success Success.
* @retval kStatus_Fail Failed.
*/
status_t spi_set_frequency(uint32_t frequency);
/*!
* @brief Transfers data over SPI bus in full-duplex way.
*
* @param in The buffer to save the data to be sent.
* @param out The buffer to save the data to be read.
* @param size The transfer data size.
* @return The status of the function DSPI_MasterTransferPolling().
*/
status_t spi_exchange(uint8_t *in, uint8_t *out, uint32_t size);
/*!
* @brief Initializes the timer to generator 1ms interrupt used to get current time in milliseconds.
*/
void timer_init(void);
/*!
* @brief Gets current time in milliseconds.
*
* @return Current time in milliseconds.
*/
uint32_t timer_get_current_milliseconds(void);
/*!
* @brief Initializes the host descriptor.
*/
void sdspi_host_init(void);
/* @} */
#if defined(__cplusplus)
}
#endif
#endif /* _FSL_SDSPI_DISK_H_ */

View File

@@ -0,0 +1,90 @@
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016 NXP
* All rights reserved.
*
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#ifndef _MSD_DISKIO_H_
#define _MSD_DISKIO_H_
#include "usb_host_config.h"
#include "usb_host.h"
#include "usb_host_msd.h"
#include "ff.h"
#include "diskio.h"
/*******************************************************************************
* Definitions
******************************************************************************/
/*! @brief mass storage read/write retry time */
#define USB_HOST_FATFS_RW_RETRY_TIMES (2U)
/*******************************************************************************
* API
******************************************************************************/
/*!
* @brief fatfs call this function to initialize physical disk.
*
* @param pdrv Physical drive number.
*
* @retval 0x00 success.
*/
extern DSTATUS USB_HostMsdInitializeDisk(BYTE pdrv);
/*!
* @brief fatfs call this function to get physical disk status.
*
* @param pdrv Physical drive number.
*
* @retval 0x00 OK.
*/
extern DSTATUS USB_HostMsdGetDiskStatus(BYTE pdrv);
/*!
* @brief fatfs call this function to write data to physical disk.
*
* @param pdrv Physical drive number.
* @param buff Pointer to the data buffer to store read data.
* @param sector Start sector number.
* @param count Number of sectors to read.
*
* @retval RES_PARERR parameter error.
* @retval RES_ERROR usb stack driver error.
* @retval RES_NOTRDY read disk error.
*/
extern DRESULT USB_HostMsdReadDisk(BYTE pdrv, BYTE *buff, DWORD sector, UINT count);
/*!
* @brief fatfs call this function to write data to physical disk.
*
* @param pdrv Physical drive number.
* @param buff Pointer to the data buffer to be written.
* @param sector Start sector number.
* @param count Number of sectors to read.
*
* @retval RES_PARERR parameter error.
* @retval RES_ERROR usb stack driver error.
* @retval RES_NOTRDY write disk error.
*/
extern DRESULT USB_HostMsdWriteDisk(BYTE pdrv, const BYTE *buff, DWORD sector, UINT count);
/*!
* @brief fatfs call this function to write data to physical disk.
*
* @param pdrv Physical drive number.
* @param cmd ioctl command, please reference to diskio.h
* @param buff Parameter or data buffer.
*
* @retval RES_PARERR parameter error.
* @retval RES_ERROR usb stack driver error.
* @retval RES_NOTRDY write disk error.
*/
extern DRESULT USB_HostMsdIoctlDisk(BYTE pdrv, BYTE cmd, void *buff);
#endif /* _MSD_DISKIO_H_ */

View File

@@ -0,0 +1,386 @@
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016 NXP
* All rights reserved.
*
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#include "McuLib.h"
#if McuLib_CONFIG_USE_FAT_FS
#include "ffconf.h"
/* This fatfs subcomponent is disabled by default
* To enable it, define following macro in ffconf.h */
#ifdef USB_DISK_ENABLE
#include "fsl_usb_disk.h" /* FatFs lower layer API */
/*******************************************************************************
* Definitons
******************************************************************************/
/*******************************************************************************
* Prototypes
******************************************************************************/
/*!
* @brief host msd ufi command callback.
*
* This function is used as callback function for ufi command .
*
* @param param NULL.
* @param data data buffer pointer.
* @param dataLength data length.
* @status transfer result status.
*/
static void USB_HostMsdUfiCallback(void *param, uint8_t *data, uint32_t dataLength, usb_status_t status);
/*******************************************************************************
* Variables
******************************************************************************/
extern usb_host_handle g_HostHandle;
usb_host_class_handle g_UsbFatfsClassHandle;
static uint32_t s_FatfsSectorSize;
/* command on-going state. It should set to 1 when start command, it is set to 0 in the callback */
static volatile uint8_t ufiIng;
/* command callback status */
static volatile usb_status_t ufiStatus;
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
USB_DMA_NONINIT_DATA_ALIGN(USB_DATA_ALIGN_SIZE) static uint8_t s_UsbTransferBuffer[FF_MAX_SS];
#else
USB_DMA_NONINIT_DATA_ALIGN(USB_DATA_ALIGN_SIZE) static uint8_t s_UsbTransferBuffer[20];
#endif
/*******************************************************************************
* Code
******************************************************************************/
static void USB_HostMsdUfiCallback(void *param, uint8_t *data, uint32_t dataLength, usb_status_t status)
{
ufiIng = 0;
ufiStatus = status;
}
static inline void USB_HostControllerTaskFunction(usb_host_handle hostHandle)
{
#if ((defined USB_HOST_CONFIG_KHCI) && (USB_HOST_CONFIG_KHCI))
USB_HostKhciTaskFunction(hostHandle);
#endif /* USB_HOST_CONFIG_KHCI */
#if ((defined USB_HOST_CONFIG_EHCI) && (USB_HOST_CONFIG_EHCI))
USB_HostEhciTaskFunction(hostHandle);
#endif /* USB_HOST_CONFIG_EHCI */
#if ((defined USB_HOST_CONFIG_IP3516HS) && (USB_HOST_CONFIG_IP3516HS > 0U))
USB_HostIp3516HsTaskFunction(g_HostHandle);
#endif /* USB_HOST_CONFIG_IP3516HS */
#if ((defined USB_HOST_CONFIG_OHCI) && (USB_HOST_CONFIG_OHCI > 0U))
USB_HostOhciTaskFunction(g_HostHandle);
#endif /* USB_HOST_CONFIG_OHCI */
}
DSTATUS USB_HostMsdInitializeDisk(BYTE pdrv)
{
uint32_t address;
/* test unit ready */
ufiIng = 1;
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
if (USB_HostMsdTestUnitReady(g_UsbFatfsClassHandle, 0, USB_HostMsdUfiCallback, NULL) != kStatus_USB_Success)
{
return STA_NOINIT;
}
while (ufiIng) /* wait the command */
{
USB_HostControllerTaskFunction(g_HostHandle);
}
/*request sense */
ufiIng = 1;
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
if (USB_HostMsdRequestSense(g_UsbFatfsClassHandle, 0, s_UsbTransferBuffer, sizeof(usb_host_ufi_sense_data_t),
USB_HostMsdUfiCallback, NULL) != kStatus_USB_Success)
{
return STA_NOINIT;
}
while (ufiIng) /* wait the command */
{
USB_HostControllerTaskFunction(g_HostHandle);
}
/* get the sector size */
ufiIng = 1;
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
if (USB_HostMsdReadCapacity(g_UsbFatfsClassHandle, 0, s_UsbTransferBuffer, sizeof(usb_host_ufi_read_capacity_t),
USB_HostMsdUfiCallback, NULL) != kStatus_USB_Success)
{
return STA_NOINIT;
}
else
{
while (ufiIng)
{
USB_HostControllerTaskFunction(g_HostHandle);
}
if (ufiStatus == kStatus_USB_Success)
{
address = (uint32_t)&s_UsbTransferBuffer[0];
address = (uint32_t)((usb_host_ufi_read_capacity_t *)(address))->blockLengthInBytes;
s_FatfsSectorSize = USB_LONG_FROM_BIG_ENDIAN_ADDRESS(((uint8_t *)address));
}
else
{
s_FatfsSectorSize = 512;
}
}
return 0x00;
}
DSTATUS USB_HostMsdGetDiskStatus(BYTE pdrv)
{
return 0x00;
}
DRESULT USB_HostMsdReadDisk(BYTE pdrv, BYTE *buff, DWORD sector, UINT count)
{
DRESULT fatfs_code = RES_ERROR;
usb_status_t status = kStatus_USB_Success;
uint32_t retry = USB_HOST_FATFS_RW_RETRY_TIMES;
uint8_t *transferBuf;
uint32_t sectorCount;
uint32_t sectorIndex;
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
uint32_t index;
#endif
if (!count)
{
return RES_PARERR;
}
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
transferBuf = s_UsbTransferBuffer;
sectorCount = 1;
for (index = 0; index < count; ++index)
{
sectorIndex = sector + index;
#else
transferBuf = buff;
sectorCount = count;
sectorIndex = sector;
#endif
retry = USB_HOST_FATFS_RW_RETRY_TIMES;
while (retry--)
{
ufiIng = 1;
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
status = USB_HostMsdRead10(g_UsbFatfsClassHandle, 0, sectorIndex, (uint8_t *)transferBuf,
(uint32_t)(s_FatfsSectorSize * sectorCount), sectorCount, USB_HostMsdUfiCallback, NULL);
if (status != kStatus_USB_Success)
{
fatfs_code = RES_ERROR;
}
else
{
while (ufiIng)
{
USB_HostControllerTaskFunction(g_HostHandle);
}
if (ufiStatus == kStatus_USB_Success)
{
fatfs_code = RES_OK;
break;
}
else
{
fatfs_code = RES_NOTRDY;
}
}
}
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
memcpy(buff + index * s_FatfsSectorSize, s_UsbTransferBuffer, s_FatfsSectorSize);
}
#endif
return fatfs_code;
}
DRESULT USB_HostMsdWriteDisk(BYTE pdrv, const BYTE *buff, DWORD sector, UINT count)
{
DRESULT fatfs_code = RES_ERROR;
usb_status_t status = kStatus_USB_Success;
uint32_t retry = USB_HOST_FATFS_RW_RETRY_TIMES;
const uint8_t *transferBuf;
uint32_t sectorCount;
uint32_t sectorIndex;
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
uint32_t index;
#endif
if (!count)
{
return RES_PARERR;
}
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
transferBuf = (const uint8_t *)s_UsbTransferBuffer;
sectorCount = 1;
for (index = 0; index < count; ++index)
{
sectorIndex = sector + index;
memcpy(s_UsbTransferBuffer, buff + index * s_FatfsSectorSize, s_FatfsSectorSize);
#else
transferBuf = buff;
sectorCount = count;
sectorIndex = sector;
#endif
retry = USB_HOST_FATFS_RW_RETRY_TIMES;
while (retry--)
{
ufiIng = 1;
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
status = USB_HostMsdWrite10(g_UsbFatfsClassHandle, 0, sectorIndex, (uint8_t *)transferBuf,
(uint32_t)(s_FatfsSectorSize * sectorCount), sectorCount, USB_HostMsdUfiCallback, NULL);
if (status != kStatus_USB_Success)
{
fatfs_code = RES_ERROR;
}
else
{
while (ufiIng)
{
USB_HostControllerTaskFunction(g_HostHandle);
}
if (ufiStatus == kStatus_USB_Success)
{
fatfs_code = RES_OK;
break;
}
else
{
fatfs_code = RES_NOTRDY;
}
}
}
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
}
#endif
return fatfs_code;
}
DRESULT USB_HostMsdIoctlDisk(BYTE pdrv, BYTE cmd, void *buff)
{
uint32_t address;
DRESULT fatfs_code = RES_ERROR;
usb_status_t status = kStatus_USB_Success;
uint32_t value;
switch (cmd)
{
case GET_SECTOR_COUNT:
case GET_SECTOR_SIZE:
if (!buff)
{
return RES_ERROR;
}
ufiIng = 1;
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
status = USB_HostMsdReadCapacity(g_UsbFatfsClassHandle, 0, s_UsbTransferBuffer,
sizeof(usb_host_ufi_read_capacity_t), USB_HostMsdUfiCallback, NULL);
if (status != kStatus_USB_Success)
{
fatfs_code = RES_ERROR;
}
else
{
while (ufiIng)
{
USB_HostControllerTaskFunction(g_HostHandle);
}
if (ufiStatus == kStatus_USB_Success)
{
fatfs_code = RES_OK;
}
else
{
fatfs_code = RES_NOTRDY;
}
}
if (fatfs_code == RES_OK)
{
if (GET_SECTOR_COUNT == cmd) /* Get number of sectors on the disk (DWORD) */
{
address = (uint32_t)&s_UsbTransferBuffer[0];
address = (uint32_t)((usb_host_ufi_read_capacity_t *)(address))->lastLogicalBlockAddress;
value = USB_LONG_FROM_BIG_ENDIAN_ADDRESS(((uint8_t *)address));
((uint8_t *)buff)[0] = ((uint8_t*)&value)[0];
((uint8_t *)buff)[1] = ((uint8_t*)&value)[1];
((uint8_t *)buff)[2] = ((uint8_t*)&value)[2];
((uint8_t *)buff)[3] = ((uint8_t*)&value)[3];
}
else /* Get the sector size in byte */
{
address = (uint32_t)&s_UsbTransferBuffer[0];
address = (uint32_t)((usb_host_ufi_read_capacity_t *)(address))->blockLengthInBytes;
value = USB_LONG_FROM_BIG_ENDIAN_ADDRESS(((uint8_t *)address));
((uint8_t *)buff)[0] = ((uint8_t*)&value)[0];
((uint8_t *)buff)[1] = ((uint8_t*)&value)[1];
((uint8_t *)buff)[2] = ((uint8_t*)&value)[2];
((uint8_t *)buff)[3] = ((uint8_t*)&value)[3];
}
}
break;
case GET_BLOCK_SIZE:
if (!buff)
{
return RES_ERROR;
}
*(uint32_t *)buff = 0;
fatfs_code = RES_OK;
break;
case CTRL_SYNC:
fatfs_code = RES_OK;
break;
default:
fatfs_code = RES_PARERR;
break;
}
return fatfs_code;
}
#endif /* USB_DISK_ENABLE */
#endif /* McuLib_CONFIG_USE_FAT_FS */

View File

@@ -0,0 +1,376 @@
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016 NXP
* All rights reserved.
*
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#include "McuLib.h"
#if McuLib_CONFIG_USE_FAT_FS
#include "ffconf.h"
/* This fatfs subcomponent is disabled by default
* To enable it, define following macro in ffconf.h */
#ifdef USB_DISK_ENABLE
#include "fsl_usb_disk.h" /* FatFs lower layer API */
/*******************************************************************************
* Definitons
******************************************************************************/
/*******************************************************************************
* Prototypes
******************************************************************************/
/*!
* @brief host msd ufi command callback.
*
* This function is used as callback function for ufi command .
*
* @param param NULL.
* @param data data buffer pointer.
* @param dataLength data length.
* @status transfer result status.
*/
static void USB_HostMsdUfiCallback(void *param, uint8_t *data, uint32_t dataLength, usb_status_t status);
/*******************************************************************************
* Variables
******************************************************************************/
extern usb_host_handle g_HostHandle;
usb_host_class_handle g_UsbFatfsClassHandle;
static uint32_t s_FatfsSectorSize;
static SemaphoreHandle_t s_CommandSemaphore;
/* command callback status */
static volatile usb_status_t ufiStatus;
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
USB_DMA_NONINIT_DATA_ALIGN(USB_DATA_ALIGN_SIZE) static uint8_t s_UsbTransferBuffer[FF_MAX_SS];
#else
USB_DMA_NONINIT_DATA_ALIGN(USB_DATA_ALIGN_SIZE) static uint8_t s_UsbTransferBuffer[20];
#endif
/*******************************************************************************
* Code
******************************************************************************/
static void USB_HostMsdUfiCallback(void *param, uint8_t *data, uint32_t dataLength, usb_status_t status)
{
xSemaphoreGive(s_CommandSemaphore);
ufiStatus = status;
}
DSTATUS USB_HostMsdInitializeDisk(BYTE pdrv)
{
uint32_t address;
if (s_CommandSemaphore == NULL)
{
s_CommandSemaphore = xSemaphoreCreateCounting(0x01U, 0x00U);
}
else
{
vSemaphoreDelete(s_CommandSemaphore);
s_CommandSemaphore = xSemaphoreCreateCounting(0x01U, 0x00U);
}
if (NULL == s_CommandSemaphore)
{
return RES_ERROR;
}
/* test unit ready */
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
if (USB_HostMsdTestUnitReady(g_UsbFatfsClassHandle, 0, USB_HostMsdUfiCallback, NULL) != kStatus_USB_Success)
{
return STA_NOINIT;
}
if (pdTRUE != xSemaphoreTake(s_CommandSemaphore, portMAX_DELAY)) /* wait the command */
{
return RES_ERROR;
}
/*request sense */
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
if (USB_HostMsdRequestSense(g_UsbFatfsClassHandle, 0, s_UsbTransferBuffer, sizeof(usb_host_ufi_sense_data_t),
USB_HostMsdUfiCallback, NULL) != kStatus_USB_Success)
{
return STA_NOINIT;
}
if (pdTRUE != xSemaphoreTake(s_CommandSemaphore, portMAX_DELAY)) /* wait the command */
{
return RES_ERROR;
}
/* get the sector size */
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
if (USB_HostMsdReadCapacity(g_UsbFatfsClassHandle, 0, s_UsbTransferBuffer, sizeof(usb_host_ufi_read_capacity_t),
USB_HostMsdUfiCallback, NULL) != kStatus_USB_Success)
{
return STA_NOINIT;
}
else
{
if (pdTRUE != xSemaphoreTake(s_CommandSemaphore, portMAX_DELAY)) /* wait the command */
{
return RES_ERROR;
}
if (ufiStatus == kStatus_USB_Success)
{
address = (uint32_t)&s_UsbTransferBuffer[0];
address = (uint32_t)((usb_host_ufi_read_capacity_t *)(address))->blockLengthInBytes;
s_FatfsSectorSize = USB_LONG_FROM_BIG_ENDIAN_ADDRESS(((uint8_t *)address));
}
else
{
s_FatfsSectorSize = 512;
}
}
return 0x00;
}
DSTATUS USB_HostMsdGetDiskStatus(BYTE pdrv)
{
return 0x00;
}
DRESULT USB_HostMsdReadDisk(BYTE pdrv, BYTE *buff, DWORD sector, UINT count)
{
DRESULT fatfs_code = RES_ERROR;
usb_status_t status = kStatus_USB_Success;
uint32_t retry = USB_HOST_FATFS_RW_RETRY_TIMES;
uint8_t *transferBuf;
uint32_t sectorCount;
uint32_t sectorIndex;
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
uint32_t index;
#endif
if (!count)
{
return RES_PARERR;
}
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
transferBuf = s_UsbTransferBuffer;
sectorCount = 1;
for (index = 0; index < count; ++index)
{
sectorIndex = sector + index;
#else
transferBuf = buff;
sectorCount = count;
sectorIndex = sector;
#endif
retry = USB_HOST_FATFS_RW_RETRY_TIMES;
while (retry--)
{
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
status = USB_HostMsdRead10(g_UsbFatfsClassHandle, 0, sectorIndex, (uint8_t *)transferBuf,
(uint32_t)(s_FatfsSectorSize * sectorCount), sectorCount, USB_HostMsdUfiCallback, NULL);
if (status != kStatus_USB_Success)
{
fatfs_code = RES_ERROR;
}
else
{
if (pdTRUE != xSemaphoreTake(s_CommandSemaphore, portMAX_DELAY)) /* wait the command */
{
return RES_ERROR;
}
if (ufiStatus == kStatus_USB_Success)
{
fatfs_code = RES_OK;
break;
}
else
{
fatfs_code = RES_NOTRDY;
}
}
}
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
memcpy(buff + index * s_FatfsSectorSize, s_UsbTransferBuffer, s_FatfsSectorSize);
}
#endif
return fatfs_code;
}
DRESULT USB_HostMsdWriteDisk(BYTE pdrv, const BYTE *buff, DWORD sector, UINT count)
{
DRESULT fatfs_code = RES_ERROR;
usb_status_t status = kStatus_USB_Success;
uint32_t retry = USB_HOST_FATFS_RW_RETRY_TIMES;
const uint8_t *transferBuf;
uint32_t sectorCount;
uint32_t sectorIndex;
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
uint32_t index;
#endif
if (!count)
{
return RES_PARERR;
}
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
transferBuf = (const uint8_t *)s_UsbTransferBuffer;
sectorCount = 1;
for (index = 0; index < count; ++index)
{
sectorIndex = sector + index;
memcpy(s_UsbTransferBuffer, buff + index * s_FatfsSectorSize, s_FatfsSectorSize);
#else
transferBuf = buff;
sectorCount = count;
sectorIndex = sector;
#endif
retry = USB_HOST_FATFS_RW_RETRY_TIMES;
while (retry--)
{
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
status = USB_HostMsdWrite10(g_UsbFatfsClassHandle, 0, sectorIndex, (uint8_t *)transferBuf,
(uint32_t)(s_FatfsSectorSize * sectorCount), sectorCount, USB_HostMsdUfiCallback, NULL);
if (status != kStatus_USB_Success)
{
fatfs_code = RES_ERROR;
}
else
{
if (pdTRUE != xSemaphoreTake(s_CommandSemaphore, portMAX_DELAY)) /* wait the command */
{
return RES_ERROR;
}
if (ufiStatus == kStatus_USB_Success)
{
fatfs_code = RES_OK;
break;
}
else
{
fatfs_code = RES_NOTRDY;
}
}
}
#if (defined(USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE) && (USB_HOST_CONFIG_BUFFER_PROPERTY_CACHEABLE)) ||\
(defined(DATA_SECTION_IS_CACHEABLE) && (DATA_SECTION_IS_CACHEABLE))
}
#endif
return fatfs_code;
}
DRESULT USB_HostMsdIoctlDisk(BYTE pdrv, BYTE cmd, void *buff)
{
uint32_t address;
DRESULT fatfs_code = RES_ERROR;
usb_status_t status = kStatus_USB_Success;
uint32_t value;
switch (cmd)
{
case GET_SECTOR_COUNT:
case GET_SECTOR_SIZE:
if (!buff)
{
return RES_ERROR;
}
if (g_UsbFatfsClassHandle == NULL)
{
return RES_ERROR;
}
status = USB_HostMsdReadCapacity(g_UsbFatfsClassHandle, 0, s_UsbTransferBuffer,
sizeof(usb_host_ufi_read_capacity_t), USB_HostMsdUfiCallback, NULL);
if (status != kStatus_USB_Success)
{
fatfs_code = RES_ERROR;
}
else
{
if (pdTRUE != xSemaphoreTake(s_CommandSemaphore, portMAX_DELAY)) /* wait the command */
{
return RES_ERROR;
}
if (ufiStatus == kStatus_USB_Success)
{
fatfs_code = RES_OK;
}
else
{
fatfs_code = RES_NOTRDY;
}
}
if (fatfs_code == RES_OK)
{
if (GET_SECTOR_COUNT == cmd) /* Get number of sectors on the disk (DWORD) */
{
address = (uint32_t)&s_UsbTransferBuffer[0];
address = (uint32_t)((usb_host_ufi_read_capacity_t *)(address))->lastLogicalBlockAddress;
value = USB_LONG_FROM_BIG_ENDIAN_ADDRESS(((uint8_t *)address));
((uint8_t *)buff)[0] = ((uint8_t*)&value)[0];
((uint8_t *)buff)[1] = ((uint8_t*)&value)[1];
((uint8_t *)buff)[2] = ((uint8_t*)&value)[2];
((uint8_t *)buff)[3] = ((uint8_t*)&value)[3];
}
else /* Get the sector size in byte */
{
address = (uint32_t)&s_UsbTransferBuffer[0];
address = (uint32_t)((usb_host_ufi_read_capacity_t *)(address))->blockLengthInBytes;
value = USB_LONG_FROM_BIG_ENDIAN_ADDRESS(((uint8_t *)address));
((uint8_t *)buff)[0] = ((uint8_t*)&value)[0];
((uint8_t *)buff)[1] = ((uint8_t*)&value)[1];
((uint8_t *)buff)[2] = ((uint8_t*)&value)[2];
((uint8_t *)buff)[3] = ((uint8_t*)&value)[3];
}
}
break;
case GET_BLOCK_SIZE:
if (!buff)
{
return RES_ERROR;
}
*(uint32_t *)buff = 0;
fatfs_code = RES_OK;
break;
case CTRL_SYNC:
fatfs_code = RES_OK;
break;
default:
fatfs_code = RES_PARERR;
break;
}
return fatfs_code;
}
#endif /* USB_DISK_ENABLE */
#endif /* McuLib_CONFIG_USE_FAT_FS */