lift_indicator_suite/port/fatfs

port/fatfs — FatFS diskio поверх bsp_sd

Адаптирует FatFS diskio-интерфейс к bsp_sd через NXP fsl_sd_disk. Предоставляет тонкую обёртку microsd_disk_* → sd_disk_* и изолирует номер диска от вызывающего кода.

---

Архитектура

graph TB
    FW["firmware_test / tft_app\nf_mount / f_read / f_write"]
    DISKIO["diskio.c\nв каждом бинарнике\n(диспетчер по pdrv)"]
    PORT["port/fatfs/sd\nmicrosd_disk_*"]
    FSL["fsl_sd_disk\nsd_disk_* (NXP SDK)"]
    BSP["bsp_sd\nSD_HostInit / SD_Read / SD_Write"]
    HW["USDHC1 / SD карта"]

    FW --> DISKIO --> PORT --> FSL --> BSP --> HW

Почему diskio_sd.c не компилируется самим port_fatfs_sd: diskio_sd.c включает diskio.h → ff.h → ffconf.h. Этот файл конфигурации разный у firmware_test (bare-metal, FF_FS_REENTRANT=0) и tft_app (FreeRTOS, FF_FS_REENTRANT=1). Поэтому port_fatfs_sd — INTERFACE-библиотека: предоставляет include path и зависимости, а каждый бинарник компилирует diskio_sd.c в свой FatFS-таргет самостоятельно через переменную PORT_FATFS_SD_SRC.

---

Использование в бинарнике

# firmware/test/CMakeLists.txt
add_library(firmware_test_fatfs STATIC
    fatfs/ff.c
    fatfs/diskio.c
    ${PORT_FATFS_SD_SRC}        # ← diskio_sd.c с правильным ffconf.h
)

target_link_libraries(firmware_test_fatfs
    PRIVATE port_fatfs_sd       # include path + bsp_sd + sdk_fatfs_headers
)

#include "port/fatfs/diskio_sd.h"

/* diskio.c вызывает microsd_disk_* через диспетчер по pdrv: */
DSTATUS disk_initialize(BYTE pdrv)
{
    if (pdrv == SDDISK) return microsd_disk_initialize(pdrv);
    return STA_NOINIT;
}

---

API (microsd_disk_*)

DSTATUS microsd_disk_initialize(BYTE pdrv);
DSTATUS microsd_disk_status(BYTE pdrv);
DRESULT microsd_disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count);
DRESULT microsd_disk_write(BYTE pdrv, const BYTE *buff, LBA_t sector, UINT count);
DRESULT microsd_disk_ioctl(BYTE pdrv, BYTE cmd, void *buff);

Функции — тонкие обёртки над sd_disk_* из NXP SDK. Не вызывать из прикладного кода напрямую — только через диспетчер diskio.c.

---

CMake

# Получить путь к diskio_sd.c
target_link_libraries(<fatfs_target> PRIVATE port_fatfs_sd)
# PORT_FATFS_SD_SRC автоматически доступна после add_subdirectory(port)

Зависимости модуля:

Зависимость	Тип	Описание
sdk_fatfs_headers	INTERFACE	ff.h, fsl_sd_disk.h, SDK_FATFS_*_SRC
bsp_sd	INTERFACE	g_sd, bsp_sd_is_inserted()