.

Committer:
mbed_official
Date:
Wed Dec 13 16:20:24 2017 +0000
Revision:
0:8e251d9511b8
Child:
1:2bfc377bcc2a
Merge pull request #6 from ARMmbed/geky-patch-1

Add docs for troubleshooting
.
Commit copied from https://github.com/ARMmbed/mbed-os-example-filesystem

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 0:8e251d9511b8 1 /* mbed Microcontroller Library
mbed_official 0:8e251d9511b8 2 * Copyright (c) 2006-2013 ARM Limited
mbed_official 0:8e251d9511b8 3 *
mbed_official 0:8e251d9511b8 4 * Licensed under the Apache License, Version 2.0 (the "License");
mbed_official 0:8e251d9511b8 5 * you may not use this file except in compliance with the License.
mbed_official 0:8e251d9511b8 6 * You may obtain a copy of the License at
mbed_official 0:8e251d9511b8 7 *
mbed_official 0:8e251d9511b8 8 * http://www.apache.org/licenses/LICENSE-2.0
mbed_official 0:8e251d9511b8 9 *
mbed_official 0:8e251d9511b8 10 * Unless required by applicable law or agreed to in writing, software
mbed_official 0:8e251d9511b8 11 * distributed under the License is distributed on an "AS IS" BASIS,
mbed_official 0:8e251d9511b8 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mbed_official 0:8e251d9511b8 13 * See the License for the specific language governing permissions and
mbed_official 0:8e251d9511b8 14 * limitations under the License.
mbed_official 0:8e251d9511b8 15 */
mbed_official 0:8e251d9511b8 16 #include "mbed.h"
mbed_official 0:8e251d9511b8 17 #include <stdio.h>
mbed_official 0:8e251d9511b8 18 #include <errno.h>
mbed_official 0:8e251d9511b8 19
mbed_official 0:8e251d9511b8 20 // Block devices
mbed_official 0:8e251d9511b8 21 #include "SPIFBlockDevice.h"
mbed_official 0:8e251d9511b8 22 #include "SDBlockDevice.h"
mbed_official 0:8e251d9511b8 23 #include "HeapBlockDevice.h"
mbed_official 0:8e251d9511b8 24
mbed_official 0:8e251d9511b8 25 // File systems
mbed_official 0:8e251d9511b8 26 #include "LittleFileSystem.h"
mbed_official 0:8e251d9511b8 27 #include "FATFileSystem.h"
mbed_official 0:8e251d9511b8 28
mbed_official 0:8e251d9511b8 29
mbed_official 0:8e251d9511b8 30 // Physical block device, can be any device that supports the BlockDevice API
mbed_official 0:8e251d9511b8 31 SPIFBlockDevice bd(
mbed_official 0:8e251d9511b8 32 MBED_CONF_SPIF_DRIVER_SPI_MOSI,
mbed_official 0:8e251d9511b8 33 MBED_CONF_SPIF_DRIVER_SPI_MISO,
mbed_official 0:8e251d9511b8 34 MBED_CONF_SPIF_DRIVER_SPI_CLK,
mbed_official 0:8e251d9511b8 35 MBED_CONF_SPIF_DRIVER_SPI_CS);
mbed_official 0:8e251d9511b8 36
mbed_official 0:8e251d9511b8 37 // File system declaration
mbed_official 0:8e251d9511b8 38 LittleFileSystem fs("fs");
mbed_official 0:8e251d9511b8 39
mbed_official 0:8e251d9511b8 40
mbed_official 0:8e251d9511b8 41 // Set up the button to trigger an erase
mbed_official 0:8e251d9511b8 42 InterruptIn irq(BUTTON1);
mbed_official 0:8e251d9511b8 43 void erase() {
mbed_official 0:8e251d9511b8 44 printf("Initializing the block device... ");
mbed_official 0:8e251d9511b8 45 fflush(stdout);
mbed_official 0:8e251d9511b8 46 int err = bd.init();
mbed_official 0:8e251d9511b8 47 printf("%s\n", (err ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 48 if (err) {
mbed_official 0:8e251d9511b8 49 error("error: %s (%d)\n", strerror(-err), err);
mbed_official 0:8e251d9511b8 50 }
mbed_official 0:8e251d9511b8 51
mbed_official 0:8e251d9511b8 52 printf("Erasing the block device... ");
mbed_official 0:8e251d9511b8 53 fflush(stdout);
mbed_official 0:8e251d9511b8 54 err = bd.erase(0, bd.size());
mbed_official 0:8e251d9511b8 55 printf("%s\n", (err ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 56 if (err) {
mbed_official 0:8e251d9511b8 57 error("error: %s (%d)\n", strerror(-err), err);
mbed_official 0:8e251d9511b8 58 }
mbed_official 0:8e251d9511b8 59
mbed_official 0:8e251d9511b8 60 printf("Deinitializing the block device... ");
mbed_official 0:8e251d9511b8 61 fflush(stdout);
mbed_official 0:8e251d9511b8 62 err = bd.deinit();
mbed_official 0:8e251d9511b8 63 printf("%s\n", (err ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 64 if (err) {
mbed_official 0:8e251d9511b8 65 error("error: %s (%d)\n", strerror(-err), err);
mbed_official 0:8e251d9511b8 66 }
mbed_official 0:8e251d9511b8 67 }
mbed_official 0:8e251d9511b8 68
mbed_official 0:8e251d9511b8 69
mbed_official 0:8e251d9511b8 70 // Entry point for the example
mbed_official 0:8e251d9511b8 71 int main() {
mbed_official 0:8e251d9511b8 72 printf("--- Mbed OS filesystem example ---\n");
mbed_official 0:8e251d9511b8 73
mbed_official 0:8e251d9511b8 74 // Setup the irq in case we want to use it
mbed_official 0:8e251d9511b8 75 irq.fall(erase);
mbed_official 0:8e251d9511b8 76
mbed_official 0:8e251d9511b8 77 // Try to mount the filesystem
mbed_official 0:8e251d9511b8 78 printf("Mounting the filesystem... ");
mbed_official 0:8e251d9511b8 79 fflush(stdout);
mbed_official 0:8e251d9511b8 80 int err = fs.mount(&bd);
mbed_official 0:8e251d9511b8 81 printf("%s\n", (err ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 82 if (err) {
mbed_official 0:8e251d9511b8 83 // Reformat if we can't mount the filesystem
mbed_official 0:8e251d9511b8 84 // this should only happen on the first boot
mbed_official 0:8e251d9511b8 85 printf("No filesystem found, formatting... ");
mbed_official 0:8e251d9511b8 86 fflush(stdout);
mbed_official 0:8e251d9511b8 87 err = fs.reformat(&bd);
mbed_official 0:8e251d9511b8 88 printf("%s\n", (err ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 89 if (err) {
mbed_official 0:8e251d9511b8 90 error("error: %s (%d)\n", strerror(-err), err);
mbed_official 0:8e251d9511b8 91 }
mbed_official 0:8e251d9511b8 92 }
mbed_official 0:8e251d9511b8 93
mbed_official 0:8e251d9511b8 94 // Open the numbers file
mbed_official 0:8e251d9511b8 95 printf("Opening \"/fs/numbers.txt\"... ");
mbed_official 0:8e251d9511b8 96 fflush(stdout);
mbed_official 0:8e251d9511b8 97 FILE *f = fopen("/fs/numbers.txt", "r+");
mbed_official 0:8e251d9511b8 98 printf("%s\n", (!f ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 99 if (!f) {
mbed_official 0:8e251d9511b8 100 // Create the numbers file if it doesn't exist
mbed_official 0:8e251d9511b8 101 printf("No file found, creating a new file... ");
mbed_official 0:8e251d9511b8 102 fflush(stdout);
mbed_official 0:8e251d9511b8 103 f = fopen("/fs/numbers.txt", "w+");
mbed_official 0:8e251d9511b8 104 printf("%s\n", (!f ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 105 if (!f) {
mbed_official 0:8e251d9511b8 106 error("error: %s (%d)\n", strerror(errno), -errno);
mbed_official 0:8e251d9511b8 107 }
mbed_official 0:8e251d9511b8 108
mbed_official 0:8e251d9511b8 109 for (int i = 0; i < 10; i++) {
mbed_official 0:8e251d9511b8 110 printf("\rWriting numbers (%d/%d)... ", i, 10);
mbed_official 0:8e251d9511b8 111 fflush(stdout);
mbed_official 0:8e251d9511b8 112 err = fprintf(f, " %d\n", i);
mbed_official 0:8e251d9511b8 113 if (err < 0) {
mbed_official 0:8e251d9511b8 114 printf("Fail :(\n");
mbed_official 0:8e251d9511b8 115 error("error: %s (%d)\n", strerror(errno), -errno);
mbed_official 0:8e251d9511b8 116 }
mbed_official 0:8e251d9511b8 117 }
mbed_official 0:8e251d9511b8 118 printf("\rWriting numbers (%d/%d)... OK\n", 10, 10);
mbed_official 0:8e251d9511b8 119
mbed_official 0:8e251d9511b8 120 printf("Seeking file... ");
mbed_official 0:8e251d9511b8 121 fflush(stdout);
mbed_official 0:8e251d9511b8 122 err = fseek(f, 0, SEEK_SET);
mbed_official 0:8e251d9511b8 123 printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 124 if (err < 0) {
mbed_official 0:8e251d9511b8 125 error("error: %s (%d)\n", strerror(errno), -errno);
mbed_official 0:8e251d9511b8 126 }
mbed_official 0:8e251d9511b8 127 }
mbed_official 0:8e251d9511b8 128
mbed_official 0:8e251d9511b8 129 // Go through and increment the numbers
mbed_official 0:8e251d9511b8 130 for (int i = 0; i < 10; i++) {
mbed_official 0:8e251d9511b8 131 printf("\rIncrementing numbers (%d/%d)... ", i, 10);
mbed_official 0:8e251d9511b8 132 fflush(stdout);
mbed_official 0:8e251d9511b8 133
mbed_official 0:8e251d9511b8 134 // Get current stream position
mbed_official 0:8e251d9511b8 135 long pos = ftell(f);
mbed_official 0:8e251d9511b8 136
mbed_official 0:8e251d9511b8 137 // Parse out the number and increment
mbed_official 0:8e251d9511b8 138 int32_t number;
mbed_official 0:8e251d9511b8 139 fscanf(f, "%d", &number);
mbed_official 0:8e251d9511b8 140 number += 1;
mbed_official 0:8e251d9511b8 141
mbed_official 0:8e251d9511b8 142 // Seek to beginning of number
mbed_official 0:8e251d9511b8 143 fseek(f, pos, SEEK_SET);
mbed_official 0:8e251d9511b8 144
mbed_official 0:8e251d9511b8 145 // Store number
mbed_official 0:8e251d9511b8 146 fprintf(f, " %d\n", number);
mbed_official 0:8e251d9511b8 147 }
mbed_official 0:8e251d9511b8 148 printf("\rIncrementing numbers (%d/%d)... OK\n", 10, 10);
mbed_official 0:8e251d9511b8 149
mbed_official 0:8e251d9511b8 150 // Close the file which also flushes any cached writes
mbed_official 0:8e251d9511b8 151 printf("Closing \"/fs/numbers.txt\"... ");
mbed_official 0:8e251d9511b8 152 fflush(stdout);
mbed_official 0:8e251d9511b8 153 err = fclose(f);
mbed_official 0:8e251d9511b8 154 printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 155 if (err < 0) {
mbed_official 0:8e251d9511b8 156 error("error: %s (%d)\n", strerror(errno), -errno);
mbed_official 0:8e251d9511b8 157 }
mbed_official 0:8e251d9511b8 158
mbed_official 0:8e251d9511b8 159 // Display the root directory
mbed_official 0:8e251d9511b8 160 printf("Opening the root directory... ");
mbed_official 0:8e251d9511b8 161 fflush(stdout);
mbed_official 0:8e251d9511b8 162 DIR *d = opendir("/fs/");
mbed_official 0:8e251d9511b8 163 printf("%s\n", (!d ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 164 if (!d) {
mbed_official 0:8e251d9511b8 165 error("error: %s (%d)\n", strerror(errno), -errno);
mbed_official 0:8e251d9511b8 166 }
mbed_official 0:8e251d9511b8 167
mbed_official 0:8e251d9511b8 168 printf("root directory:\n");
mbed_official 0:8e251d9511b8 169 while (true) {
mbed_official 0:8e251d9511b8 170 struct dirent *e = readdir(d);
mbed_official 0:8e251d9511b8 171 if (!e) {
mbed_official 0:8e251d9511b8 172 break;
mbed_official 0:8e251d9511b8 173 }
mbed_official 0:8e251d9511b8 174
mbed_official 0:8e251d9511b8 175 printf(" %s\n", e->d_name);
mbed_official 0:8e251d9511b8 176 }
mbed_official 0:8e251d9511b8 177
mbed_official 0:8e251d9511b8 178 printf("Closing the root directory... ");
mbed_official 0:8e251d9511b8 179 fflush(stdout);
mbed_official 0:8e251d9511b8 180 err = closedir(d);
mbed_official 0:8e251d9511b8 181 printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 182 if (err < 0) {
mbed_official 0:8e251d9511b8 183 error("error: %s (%d)\n", strerror(errno), -errno);
mbed_official 0:8e251d9511b8 184 }
mbed_official 0:8e251d9511b8 185
mbed_official 0:8e251d9511b8 186 // Display the numbers file
mbed_official 0:8e251d9511b8 187 printf("Opening \"/fs/numbers.txt\"... ");
mbed_official 0:8e251d9511b8 188 fflush(stdout);
mbed_official 0:8e251d9511b8 189 f = fopen("/fs/numbers.txt", "r");
mbed_official 0:8e251d9511b8 190 printf("%s\n", (!f ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 191 if (!f) {
mbed_official 0:8e251d9511b8 192 error("error: %s (%d)\n", strerror(errno), -errno);
mbed_official 0:8e251d9511b8 193 }
mbed_official 0:8e251d9511b8 194
mbed_official 0:8e251d9511b8 195 printf("numbers:\n");
mbed_official 0:8e251d9511b8 196 while (!feof(f)) {
mbed_official 0:8e251d9511b8 197 int c = fgetc(f);
mbed_official 0:8e251d9511b8 198 printf("%c", c);
mbed_official 0:8e251d9511b8 199 }
mbed_official 0:8e251d9511b8 200
mbed_official 0:8e251d9511b8 201 printf("\rClosing \"/fs/numbers.txt\"... ");
mbed_official 0:8e251d9511b8 202 fflush(stdout);
mbed_official 0:8e251d9511b8 203 err = fclose(f);
mbed_official 0:8e251d9511b8 204 printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 205 if (err < 0) {
mbed_official 0:8e251d9511b8 206 error("error: %s (%d)\n", strerror(errno), -errno);
mbed_official 0:8e251d9511b8 207 }
mbed_official 0:8e251d9511b8 208
mbed_official 0:8e251d9511b8 209 // Tidy up
mbed_official 0:8e251d9511b8 210 printf("Unmounting... ");
mbed_official 0:8e251d9511b8 211 fflush(stdout);
mbed_official 0:8e251d9511b8 212 err = fs.unmount();
mbed_official 0:8e251d9511b8 213 printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
mbed_official 0:8e251d9511b8 214 if (err < 0) {
mbed_official 0:8e251d9511b8 215 error("error: %s (%d)\n", strerror(-err), err);
mbed_official 0:8e251d9511b8 216 }
mbed_official 0:8e251d9511b8 217
mbed_official 0:8e251d9511b8 218 printf("Mbed OS filesystem example done!\n");
mbed_official 0:8e251d9511b8 219 }
mbed_official 0:8e251d9511b8 220