FatFs for the Sega Dreamcast

FatFs is a generic FAT file system module for small embedded systems. This version has been ported to the Sega Dreamcast and NAOMI platforms to provide seamless support for FAT, FAT32 and exFAT file systems on these systems. It's based on ChaN FatFs R0.16 and has been specifically optimized to leverage the hardware capabilities, ensuring efficient file operations and reliable performance for various storage solutions. The initial FatFs implementation for KallistiOS was taken from DreamShell.

Install as KallistiOS Addon

• Copy the include and fatfs directories into your KallistiOS's addons directory:

cp -R include fatfs /opt/toolchains/dc/kos/addons

• Rebuild KallistiOS -- FatFs will now build automatically when building KallistiOS.

Build as external library

make

Build Options

You can customize the build with the following options:

• DEBUG=1 - Enable debug output (disabled by default)
• DMA_BUF=0 - Disable DMA buffer (enabled by default)
• SD_CHECK_CRC=1 - Enable CRC checking for SD cards (disabled by default)
• EXFAT=0 - Disable exFAT and 64-bit LBA (enabled by default)

Examples:

# Build with defaults
make

# Build with CRC checking for SD cards
make SD_CHECK_CRC=1

# Build without DMA buffer
make DMA_BUF=0

# Build without exFAT
make EXFAT=0

Usage

• Add #include <fatfs.h> in your C source file.
• Add -lfatfs in your Makefile on the line which builds your program, e.g.:
  • kos-cc -o $(TARGET) $(OBJS) -lfatfs
• Simply call fs_fat_mount_sd() to mount a FAT/exFAT partition to /sd and/or call fs_fat_mount_ide() to mount a FAT/exFAT partition to /ide.
• Additionally, you can use other block devices by calling fs_fat_mount() with the appropriate parameters for the target device -- see fatfs.h for more information.

Links

• DreamShell: https://github.com/DC-SWAT/DreamShell
• KallistiOS: https://github.com/KallistiOS/KallistiOS
• FatFs: http://elm-chan.org/fsw/ff/