sdfat-spin

---

This is a P8X32A/Propeller, P2X8C4M64P/Propeller 2 implementation of the FAT filesystem on SD.

IMPORTANT: This software is meant to be used with the spin-standard-library (P8X32A) or p2-spin-standard-library (P2X8C4M64P). Please install the applicable library first before attempting to use this code, otherwise you will be missing several files required to build the project.

Salient Features

• FAT32 on SDHC/SDXC
• Open file by name or dirent number
• Read currently opened file's attributes: file name and extension, is directory, is the volume name, size, date, time
• Read, write a block of data (writes are currently always synchronous)
• File management: rename, delete, create, find by filename
• Cluster management: Find free cluster, allocate an arbitrary cluster, allocate block of clusters, allocate additional cluster for currently open file, count clusters allocated to file
• POSIX-ish familiarities: (some) method names and params, file open modes

File open modes supported

Symbol	Description	Seek behavior allowed
O_RDONLY	Read	random
O_WRITE	Write	random
O_RDWR	Read/Write	random
O_CREAT	Create file	n/a
O_APPEND	Writes append to file	always points to EOF
O_TRUNC	Truncate file to 0 bytes after opening	n/a

(modes are bitfields that can be OR'd together)

Requirements

P1/SPIN1:

• spin-standard-library
• fatfs-spin
• sdmem-spin

P2/SPIN2:

• p2-spin-standard-library

Compiler Compatibility

Processor	Language	Compiler	Backend	Status
P1	SPIN1	FlexSpin (6.8.1)	Bytecode	OK
P1	SPIN1	FlexSpin (6.8.1)	Native/PASM	Some demos FTBFS
P2	SPIN2	FlexSpin (6.8.1)	NuCode	Not yet implemented
P2	SPIN2	FlexSpin (6.8.1)	Native/PASM2	Not yet implemented

(other versions or toolchains not listed are not supported, and may or may not work)

Limitations

• Very early in development - may malfunction, or outright fail to build
• FAT16, FAT12 not yet supported
• Pre-SDHC cards unsupported (unplanned)
• No (sub)directory support yet
• No long filename support yet
• Slow
• API should be considered unstable