99 lines
3.6 KiB
C
99 lines
3.6 KiB
C
/*
|
||
* 模块名称：FatFs OS 依赖层 (ffsystem)
|
||
* 模块功能：FF_FS_REENTRANT 卷互斥钩子 + get_fattime 时间钩子（直引用系统墙钟）
|
||
* 适用平台：STM32F407ZGTx（MCU 端；模拟器端不编译 FatFS）
|
||
* 作者：王建锋
|
||
* 创建日期：2026-09-13
|
||
* 修改记录：
|
||
* v1.0 2026-09-13 王建锋 初始版本：osMutex 卷锁（1s 超时）
|
||
* v1.1 2026-09-13 王建锋 get_fattime 采用运行时间伪时（零 I2C 流量、无 RTC 依赖）
|
||
* v1.2 2026-09-13 王建锋 get_fattime 移入独立适配文件 App/ff_time.c（与调试日志墙钟同源）；本文件仅留互斥钩子
|
||
* v1.3 2026-09-13 王建锋 get_fattime 回归本文件并改为时间提供回调（App 启动时注册墙钟，
|
||
* 本文件不引用 App 头文件，保持分层单向）
|
||
* v1.4 2026-09-13 王建锋 get_fattime 改为直引用 sys_clock 墙钟（去掉回调注册机制；
|
||
* sys_clock 归 ④中间件层（App/util/），层内引用，无反向依赖）
|
||
*/
|
||
|
||
#include "ff.h"
|
||
#include "cmsis_os2.h"
|
||
#include "sys_clock.h" /* 墙钟：层内中间件引用（sys_clock 归 ④中间件层，App/util/） */
|
||
|
||
#if (!FF_FS_NORTC)
|
||
|
||
/*
|
||
* 函数名称：FatFs 时间钩子 (get_fattime) —— 提供当前时间的 FAT 时间格式
|
||
* 入口参数：无
|
||
* 返 回 值：FAT 时间 ((year-1980)<<25 | month<<21 | day<<16 | hour<<11 | minute<<5 | second/2)；
|
||
* 墙钟无效时返回固定值（FF_NORTC 约定：2026-01-01 00:00:00）
|
||
* 限定条件：sys_clock_init() 已调用（App 启动时，早于 osKernelStart）
|
||
* 函数说明：1. 时间源 = 系统墙钟（与调试日志时间戳同源：开机 RTC 基准 + tick 推进，运行期零 I2C）
|
||
* 2. 文件 mtime 与日志时间戳一致；ff.h 声明，ff.c 在目录项创建 /
|
||
* 写后关文件 / f_mkfs 时调用
|
||
* 3. 本文件为 FatFs 指定的 OS 胶水文件——FatFs 与平台间的
|
||
* 唯一耦合点（互斥 + 时间）
|
||
*/
|
||
DWORD get_fattime(void)
|
||
{
|
||
sd2506_time_t t;
|
||
|
||
if (sys_clock_get_time(&t) != 0 || t.year < 1980u) {
|
||
return (((DWORD)(FF_NORTC_YEAR - 1980u) << 25) |
|
||
((DWORD)FF_NORTC_MON << 21) |
|
||
((DWORD)FF_NORTC_MDAY << 16));
|
||
}
|
||
|
||
return ((DWORD)(t.year - 1980u) << 25)
|
||
| ((DWORD)t.month << 21)
|
||
| ((DWORD)t.day << 16)
|
||
| ((DWORD)t.hour << 11)
|
||
| ((DWORD)t.minute << 5)
|
||
| (DWORD)(t.second / 2u);
|
||
}
|
||
|
||
#endif /* !FF_FS_NORTC */
|
||
|
||
#if FF_FS_REENTRANT
|
||
|
||
/*
|
||
* FatFs 可重入同步对象：[0] = 系统锁，[1..FF_VOLUMES] = 卷锁
|
||
* 首次 f_mount 时创建；获取超时（FF_FS_TIMEOUT）时对应 f_* 返回 FR_TIMEOUT
|
||
* （优雅失败，由调用方下节拍重试，无死锁）
|
||
*/
|
||
static osMutexId_t s_fs_mutex[FF_VOLUMES + 1u];
|
||
|
||
int ff_mutex_create(int vol)
|
||
{
|
||
static const osMutexAttr_t s_attr = { "ffs", 0u, NULL, 0u };
|
||
|
||
if (s_fs_mutex[vol] != NULL) {
|
||
return 1;
|
||
}
|
||
s_fs_mutex[vol] = osMutexNew(&s_attr);
|
||
return (s_fs_mutex[vol] != NULL) ? 1 : 0;
|
||
}
|
||
|
||
void ff_mutex_delete(int vol)
|
||
{
|
||
if (s_fs_mutex[vol] != NULL) {
|
||
(void)osMutexDelete(s_fs_mutex[vol]);
|
||
s_fs_mutex[vol] = NULL;
|
||
}
|
||
}
|
||
|
||
int ff_mutex_take(int vol)
|
||
{
|
||
if (s_fs_mutex[vol] == NULL) {
|
||
return 1; /* 锁对象未创建 = 无并发，视为已取得 */
|
||
}
|
||
return (osMutexAcquire(s_fs_mutex[vol], FF_FS_TIMEOUT) == osOK) ? 1 : 0;
|
||
}
|
||
|
||
void ff_mutex_give(int vol)
|
||
{
|
||
if (s_fs_mutex[vol] != NULL) {
|
||
(void)osMutexRelease(s_fs_mutex[vol]);
|
||
}
|
||
}
|
||
|
||
#endif /* FF_FS_REENTRANT */
|