Emilia Marino / SDFileSystem

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

FATFileSystem/FATFileSystem.h@0:5f7b02d095c2, 2021-12-18 (annotated)

Committer:
emiliamarino
Date:
Sat Dec 18 20:17:31 2021 +0000
Revision:
0:5f7b02d095c2
Assignment 4

Who changed what in which revision?

UserRevisionLine numberNew contents of line
emiliamarino 0:5f7b02d095c2 1 /* mbed Microcontroller Library
emiliamarino 0:5f7b02d095c2 2 * Copyright (c) 2006-2012 ARM Limited
emiliamarino 0:5f7b02d095c2 3 *
emiliamarino 0:5f7b02d095c2 4 * Permission is hereby granted, free of charge, to any person obtaining a copy
emiliamarino 0:5f7b02d095c2 5 * of this software and associated documentation files (the "Software"), to deal
emiliamarino 0:5f7b02d095c2 6 * in the Software without restriction, including without limitation the rights
emiliamarino 0:5f7b02d095c2 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
emiliamarino 0:5f7b02d095c2 8 * copies of the Software, and to permit persons to whom the Software is
emiliamarino 0:5f7b02d095c2 9 * furnished to do so, subject to the following conditions:
emiliamarino 0:5f7b02d095c2 10 *
emiliamarino 0:5f7b02d095c2 11 * The above copyright notice and this permission notice shall be included in
emiliamarino 0:5f7b02d095c2 12 * all copies or substantial portions of the Software.
emiliamarino 0:5f7b02d095c2 13 *
emiliamarino 0:5f7b02d095c2 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
emiliamarino 0:5f7b02d095c2 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
emiliamarino 0:5f7b02d095c2 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
emiliamarino 0:5f7b02d095c2 17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
emiliamarino 0:5f7b02d095c2 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
emiliamarino 0:5f7b02d095c2 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
emiliamarino 0:5f7b02d095c2 20 * SOFTWARE.
emiliamarino 0:5f7b02d095c2 21 */
emiliamarino 0:5f7b02d095c2 22 #ifndef MBED_FATFILESYSTEM_H
emiliamarino 0:5f7b02d095c2 23 #define MBED_FATFILESYSTEM_H
emiliamarino 0:5f7b02d095c2 24
emiliamarino 0:5f7b02d095c2 25 #include "FileSystemLike.h"
emiliamarino 0:5f7b02d095c2 26 #include "FileHandle.h"
emiliamarino 0:5f7b02d095c2 27 #include "ff.h"
emiliamarino 0:5f7b02d095c2 28 #include <stdint.h>
emiliamarino 0:5f7b02d095c2 29
emiliamarino 0:5f7b02d095c2 30 using namespace mbed;
emiliamarino 0:5f7b02d095c2 31
emiliamarino 0:5f7b02d095c2 32 /**
emiliamarino 0:5f7b02d095c2 33 * FATFileSystem based on ChaN's Fat Filesystem library v0.8
emiliamarino 0:5f7b02d095c2 34 */
emiliamarino 0:5f7b02d095c2 35 class FATFileSystem : public FileSystemLike {
emiliamarino 0:5f7b02d095c2 36 public:
emiliamarino 0:5f7b02d095c2 37
emiliamarino 0:5f7b02d095c2 38 FATFileSystem(const char* n);
emiliamarino 0:5f7b02d095c2 39 virtual ~FATFileSystem();
emiliamarino 0:5f7b02d095c2 40
emiliamarino 0:5f7b02d095c2 41 static FATFileSystem * _ffs[_VOLUMES]; // FATFileSystem objects, as parallel to FatFs drives array
emiliamarino 0:5f7b02d095c2 42 FATFS _fs; // Work area (file system object) for logical drive
emiliamarino 0:5f7b02d095c2 43 char _fsid[2];
emiliamarino 0:5f7b02d095c2 44
emiliamarino 0:5f7b02d095c2 45 /**
emiliamarino 0:5f7b02d095c2 46 * Opens a file on the filesystem
emiliamarino 0:5f7b02d095c2 47 */
emiliamarino 0:5f7b02d095c2 48 virtual FileHandle *open(const char* name, int flags);
emiliamarino 0:5f7b02d095c2 49 virtual int open(FileHandle **file, const char *name, int flags);
emiliamarino 0:5f7b02d095c2 50
emiliamarino 0:5f7b02d095c2 51 /**
emiliamarino 0:5f7b02d095c2 52 * Removes a file path
emiliamarino 0:5f7b02d095c2 53 */
emiliamarino 0:5f7b02d095c2 54 virtual int remove(const char *filename);
emiliamarino 0:5f7b02d095c2 55
emiliamarino 0:5f7b02d095c2 56 /**
emiliamarino 0:5f7b02d095c2 57 * Renames a file
emiliamarino 0:5f7b02d095c2 58 */
emiliamarino 0:5f7b02d095c2 59 virtual int rename(const char *oldname, const char *newname);
emiliamarino 0:5f7b02d095c2 60
emiliamarino 0:5f7b02d095c2 61 /**
emiliamarino 0:5f7b02d095c2 62 * Formats a logical drive, FDISK artitioning rule, 512 bytes per cluster
emiliamarino 0:5f7b02d095c2 63 */
emiliamarino 0:5f7b02d095c2 64 virtual int format();
emiliamarino 0:5f7b02d095c2 65
emiliamarino 0:5f7b02d095c2 66 /**
emiliamarino 0:5f7b02d095c2 67 * Opens a directory on the filesystem
emiliamarino 0:5f7b02d095c2 68 */
emiliamarino 0:5f7b02d095c2 69 virtual DirHandle *opendir(const char *name);
emiliamarino 0:5f7b02d095c2 70 virtual int open(DirHandle **dir, const char *name);
emiliamarino 0:5f7b02d095c2 71
emiliamarino 0:5f7b02d095c2 72 /**
emiliamarino 0:5f7b02d095c2 73 * Creates a directory path
emiliamarino 0:5f7b02d095c2 74 */
emiliamarino 0:5f7b02d095c2 75 virtual int mkdir(const char *name, mode_t mode);
emiliamarino 0:5f7b02d095c2 76
emiliamarino 0:5f7b02d095c2 77 /**
emiliamarino 0:5f7b02d095c2 78 * Mounts the filesystem
emiliamarino 0:5f7b02d095c2 79 */
emiliamarino 0:5f7b02d095c2 80 virtual int mount();
emiliamarino 0:5f7b02d095c2 81
emiliamarino 0:5f7b02d095c2 82 /**
emiliamarino 0:5f7b02d095c2 83 * Unmounts the filesystem
emiliamarino 0:5f7b02d095c2 84 */
emiliamarino 0:5f7b02d095c2 85 virtual int unmount();
emiliamarino 0:5f7b02d095c2 86
emiliamarino 0:5f7b02d095c2 87 virtual int disk_initialize() { return 0; }
emiliamarino 0:5f7b02d095c2 88 virtual int disk_status() { return 0; }
emiliamarino 0:5f7b02d095c2 89 virtual int disk_read(uint8_t *buffer, uint32_t sector, uint32_t count) = 0;
emiliamarino 0:5f7b02d095c2 90 virtual int disk_write(const uint8_t *buffer, uint32_t sector, uint32_t count) = 0;
emiliamarino 0:5f7b02d095c2 91 virtual int disk_sync() { return 0; }
emiliamarino 0:5f7b02d095c2 92 virtual uint32_t disk_sectors() = 0;
emiliamarino 0:5f7b02d095c2 93
emiliamarino 0:5f7b02d095c2 94 };
emiliamarino 0:5f7b02d095c2 95
emiliamarino 0:5f7b02d095c2 96 #endif