FAT32 Tools¶

zeptoforth comes with a variety of words for manipulating files and directories in FAT32 filesystems. Directories can be created, listed, removed, and renamed, and files can be created, appended, overwritten, dumped, removed, and renamed.

zeptoforth includes support for including code for execution within FAT32 filesystems. This includes support for handling nested included files, up to a maximum of eight included files. Note that including code is intended to only be done from within the main task, and undefined results may occur if done from within any other task.

`fat32-tools`¶

The fat32-tools module contains the following words:

`x-fs-not-set`¶

( – )

Current filesystem not set exception.

`x-current-path-too-long`¶

( – )

Current path is too long (i.e. longer than 256 bytes)

`x-include-stack-overflow`¶

( – )

Include stack overflow exception, raised if the number of nested includes exceeds eight includes.

`current-fs!`¶

( fs – )

Set the current FAT32 filesystem. This filesystem is a subclass of <base-fat32-fs> in the fat32 module.

`current-fs@`¶

( – fs )

Get the current FAT32 filesystem. This filesystem is a subclass of <base-fat32-fs> in the fat32 module.

`change-dir`¶

( addr bytes – )

Set the current path for the current FAT32 filesystem.

`init-simple-fat32`¶

( write-through sck-pin tx-pin rx-pin cs-pin spi-device – )

Simple SDHC/SDXC FAT32 card initializer; this creates a SDHC/SDXC card interface and FAT32 filesystem and, if successful, sets it as the current filesystem.

sck-pin, tx-pin, rx-pin, and cs-pin are the clock, transmit, receive, and chip select pins to use. spi-device is the SPI peripheral to use; it must match sck-pin, tx-pin, and rx-pin. write-through is whether to enable write-through; enabling write-through will result in greater data integrity in the case of failures, but slower performance. If write-through is not enabled, manually flushing at opportune moments is highly recommended.

Note that this permanently allots space for the FAT32 filesystem and its support structures in the current task’s RAM dictionary.

`enable-echo`¶

( – )

Enable echoing while loading code from a file. Note that echoing is enabled by default. Also note that a given number of enables require an equal number of disables to be canceled out.

`disable-echo`¶

( – )

Disable echoing while loading code from a file. Note that a given number of disables require an equal number of enables to be canceled out.

`load-file`¶

( file – )

Load code from a file in the FAT32 filesystem. Note that the file object will be duplicated in the process. The contents of the file will be echoed to the console as it is evaluated if echoing is enabled.

`included`¶

( path-addr path-u – )

Load code from a file with the specified path in the current include FAT32 filesystem. The contents of the file will be echoed to the console as it is evaluated if echoing is enabled.

`include`¶

( “path” – )

Load code from a file with the specified path as a token in the current include FAT32 filesystem. The contents of the file will be echoed to the console as it is evaluated if echoing is enabled.

`list-dir`¶

( path-addr path-u – )

List a directory at the specified path. Display the file creation date, modification date, and size.

`create-file`¶

( data-addr data-u path-addr path-u – )

Create a file at the specified path and write data to it.

`create-dir`¶

( path-addr path-u – )

Create a directory at the specified path.

`copy-file`¶

( path-addr path-u new-path-addr new-path-u – )

Copy a file from an existing path to a new path.

`append-file`¶

( data-addr data-u path-addr path-u – )

Write data to the end of a file at the specified path.

`write-file`¶

( data-addr data-u path-addr path-u – )

Overwrite a file at the specified path with data and then truncate it afterwards.

`write-file-window`¶

( data-addr data-u offset-u path-addr path-u – )

Write data at an offset to a file at the specified path without truncating it.