[fatfs] Add Petit FatFs v0.03a module

Author: salkinium

ext/chan/module_petit.lb

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+#
+# Copyright (c) 2021, Niklas Hauser
+#
+# This file is part of the modm project.
+#
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+# -----------------------------------------------------------------------------
+
+def init(module):
+    module.name = ":fatfs.petit"
+    module.description = """
+# Petit FatFs: Tiny FAT Filesystem
+
+Petit FatFs is a sub-set of FatFs module for tiny 8-bit microcontrollers. It can
+be incorporated into the tiny microcontrollers with limited memory even if the
+RAM size is less than sector size.
+
+See http://elm-chan.org/fsw/ff/00index_p.html.
+
+
+## Configuration
+
+To configure Petit FatFs for your project, create a `<pffconf_local.h>` file,
+which is included at the *beginning* of the config, thus overwriting the default
+settings. Please see the `modm/ext/fatfs-petit/pffconf.h` file for the available
+configuration options and their default values.
+
+Example `<pffconf_local.h>` configuration:
+
+```c
+// Enable directories: pf_opendir(), pf_readdir()
+#define PF_USE_DIR 1
+
+// Enabling writing: pf_write()
+#define PF_USE_WRITE 1
+
+// Use FAT12 file system
+#define PF_FS_FAT12 1
+#define PF_FS_FAT16 0
+#define PF_FS_FAT32 0
+```
+"""
+
+def prepare(module, options):
+    return True
+
+def build(env):
+    env.collect(":build:path.include", "modm/ext")
+    env.outbasepath = "modm/ext/fatfs-petit"
+
+    env.copy("fatfs/tiny/source/diskio.h", "diskio.h")
+    env.copy("fatfs/tiny/source/pff.h", "pff.h")
+    env.copy("fatfs/tiny/source/pff.c", "pff.c")
+    env.copy("fatfs/tiny/LICENSE.txt", "LICENSE.txt")
+
+    env.copy("pffconf.h")

ext/chan/pffconf.h

@@ -0,0 +1,81 @@
+/*---------------------------------------------------------------------------/
+/  Petit FatFs - Configuration file
+/---------------------------------------------------------------------------*/
+
+#ifndef PFCONF_DEF
+#define PFCONF_DEF 8088	/* Revision ID */
+
+/* A header file that overwrites with local project settings. */
+#if __has_include(<pffconf_local.h>)
+#include <pffconf_local.h>
+#endif
+
+/*---------------------------------------------------------------------------/
+/ Function Configurations (0:Disable, 1:Enable)
+/---------------------------------------------------------------------------*/
+
+#ifndef PF_USE_READ
+#	define PF_USE_READ   1	/* pf_read() function */
+#endif
+#ifndef PF_USE_DIR
+#	define PF_USE_DIR    0	/* pf_opendir() and pf_readdir() function */
+#endif
+#ifndef PF_USE_LSEEK
+#	define PF_USE_LSEEK  0	/* pf_lseek() function */
+#endif
+#ifndef PF_USE_WRITE
+#	define PF_USE_WRITE  0	/* pf_write() function */
+#endif
+
+#ifndef PF_FS_FAT12
+#	define PF_FS_FAT12   0	/* FAT12 */
+#endif
+#ifndef PF_FS_FAT16
+#	define PF_FS_FAT16   1	/* FAT16 */
+#endif
+#ifndef PF_FS_FAT32
+#	define PF_FS_FAT32   0	/* FAT32 */
+#endif
+
+
+/*---------------------------------------------------------------------------/
+/ Locale and Namespace Configurations
+/---------------------------------------------------------------------------*/
+
+#ifndef PF_USE_LCC
+#	define PF_USE_LCC    0	/* Allow lower case ASCII and non-ASCII chars */
+#endif
+
+#ifndef PF_CODE_PAGE
+#	define PF_CODE_PAGE  437
+#endif
+/* The PF_CODE_PAGE specifies the code page to be used on the target system.
+/  SBCS code pages with PF_USE_LCC == 1 requiers a 128 byte of case conversion
+/  table. It might occupy RAM on some platforms, e.g. avr-gcc.
+/  When PF_USE_LCC == 0, PF_CODE_PAGE has no effect.
+/
+/   437 - U.S.
+/   720 - Arabic
+/   737 - Greek
+/   771 - KBL
+/   775 - Baltic
+/   850 - Latin 1
+/   852 - Latin 2
+/   855 - Cyrillic
+/   857 - Turkish
+/   860 - Portuguese
+/   861 - Icelandic
+/   862 - Hebrew
+/   863 - Canadian French
+/   864 - Arabic
+/   865 - Nordic
+/   866 - Russian
+/   869 - Greek 2
+/   932 - Japanese (DBCS)
+/   936 - Simplified Chinese (DBCS)
+/   949 - Korean (DBCS)
+/   950 - Traditional Chinese (DBCS)
+*/
+
+
+#endif /* PF_CONF */