【Wio Terminal】SD卡的使用

一、概述

本节介绍了如何在Wio Terminal上安装文件系统库。它提供了与SD卡进行文件操作的基本功能，允许使用SPI接口从SD卡中读取或写入数据。

1、安装文件系统库

• 访问 Seeed_Arduino_FS 仓库并将整个仓库下载到本地驱动器。
• 现在，可以将 FS 库安装到 Arduino IDE 中。打开 Arduino IDE，点击“项目” -> “导入库” -> “添加 .ZIP 库”，然后选择您刚刚下载的 Seeed_Arduino_FS 文件。
  

2、安装依赖的 SFUD 库

• 访问 Seeed_Arduino_SFUD 仓库并将整个仓库下载到本地驱动器。
• 现在，可以将 SFUD 库安装到 Arduino IDE 中。打开 Arduino IDE，点击“项目” -> “导入库” -> “添加 .ZIP 库”，然后选择您刚刚下载的 Seeed_Arduino_SFUD 文件。

3、MicroSD卡格式化

最大MicroSD卡容量：16GB
支持的MicroSD卡格式：

• FAT12
• FAT16
• FAT32
• exFAT

二、SD卡读写

本节描述了如何从SD卡读取或写入数据。使用它，您可以从SD卡加载数据，一个简单的演示将是将传感器读数存储到SD卡上。

1、在Wio Terminal上初始化SD卡

要初始化Wio Terminal上的SD卡，首先需要包含Seeed_FS库。包含以下 Seeed_FS 库。然后，使用 SD.begin(SDCARD_SS_PIN, SDCARD_SPI) 来初始化SD卡。并使用 SD.begin(SDCARD_SS_PIN, SDCARD_SPI) 来初始化 SD 卡，其中 SPI 用于在 Wio Terminal 中与 SD 卡进行通信。

#include <SPI.h>
#include <Seeed_FS.h>
#include "SD/Seeed_SD.h"

// 初始化SD卡File;
File myFile;    // 声明一个File对象，命名为myFile

void setup() {
  Serial.begin(115200);
  while (!Serial) {
  }

  Serial.print("Initializing SD card...");
  if (!SD.begin(SDCARD_SS_PIN, SDCARD_SPI)) {
    Serial.println("initialization failed!");
    while (1);
  }
  Serial.println("initialization done.");

2、写入SD卡

要向SD卡写入数据，首先需要打开文件。文件系统有不同的模式，因此在打开文件时需要指明使用哪种模式。这些模式如下：

模式	宏定义
WRITE	FILE_WRITE
READ	FILE_READ
APPEND	FILE_APPEND

要打开文件，可以使用File类的成员函数open，它接受两个参数，如下所示：

open(const char *filepath, uint8_t mode = FILE_READ) // 默认模式为 READ

在这种情况下，打开名为test.txt的文本文件，并使用FILE_WRITE模式。要向文本文件内部写入内容，可以使用println函数（File类提供）：

  // 打开文件。请注意一次只能打开一个文件，
  // 因此您必须在打开另一个文件之前关闭这个文件。
  myFile = SD.open("test.txt", FILE_WRITE); // 写模式

  // 如果文件打开成功，向它写入：
  if (myFile) {
    Serial.print("Writing to test.txt...");
    myFile.println("testing 1, 2, 3."); //向 "test.txt" 写入
    // 关闭文件:
    myFile.close();
    Serial.println("done.");
  } else {
    // 如果文件没有被打开，则打印：
    Serial.println("error opening test.txt");
  }

注意：一次一个文件，所以完成后关闭一个文件。

2、读取SD卡

要从SD卡中读取文件，同样需要先打开文件。这次，使用FILE_READ模式来仅读取文件。
使用File类的成员函数available()来检查文件的可用性，并使用read()来打印出文件中的内容。

myFile = SD.open("test.txt", FILE_READ); //读模式
  if (myFile) {
    Serial.println("test.txt:");

    // 从文件中读取，直到文件中没有其他内容：
    while (myFile.available()) {
      Serial.write(myFile.read());
    }
    // 关闭文件:
    myFile.close();
  } else {
    // 如果文件没有被打开，则打印：
    Serial.println("error opening test.txt");
  }
}

3、完整代码

#include <SPI.h>
#include <Seeed_FS.h>
#include "SD/Seeed_SD.h"

File myFile;

void setup() {
  Serial.begin(115200);
  while (!Serial) {
  }
  Serial.print("Initializing SD card...");
  if (!SD.begin(SDCARD_SS_PIN, SDCARD_SPI)) {
    Serial.println("initialization failed!");
    while (1);
  }
  Serial.println("initialization done.");

  // 打开文件。请注意一次只能打开一个文件，
  // 因此您必须在打开另一个文件之前关闭这个文件。
  myFile = SD.open("test.txt", FILE_WRITE);

  // 如果文件打开成功，向它写入：
  if (myFile) {
    Serial.print("Writing to test.txt...");
    myFile.println("testing 1, 2, 3.");
    // 关闭文件:
    myFile.close();
    Serial.println("done.");
  } else {
    // 如果文件没有被打开，则打印:
    Serial.println("error opening test.txt");
  }

  // 重新打开文件进行读取:
  myFile = SD.open("test.txt", FILE_READ);
  if (myFile) {
    Serial.println("test.txt:");

    // 从文件中读取，直到文件中没有其他内容：
    while (myFile.available()) {
      Serial.write(myFile.read());
    }
    // 关闭文件:
    myFile.close();
  } else {
    // 如果文件没有被打开，则打印:
    Serial.println("error opening test.txt");
  }
}

void loop() {
  // nothing happens after setup
}

4、使用QSPI读/写Flash

随着FS库的更新，我们在系统中引入了SFUD。您现在可以使用QSPI访问Wio终端上的Flash。

完整示例代码

此示例演示读取/擦除/写入：

#include <sfud.h>

#define SFUD_DEMO_TEST_BUFFER_SIZE                     1024
static uint8_t sfud_demo_test_buf[SFUD_DEMO_TEST_BUFFER_SIZE];
static void sfud_demo(uint32_t addr, size_t size, uint8_t *data);
 
#define SERIAL Serial

void setup()
{
    SERIAL.begin(115200);
    while(!SERIAL) {};
    while(!(sfud_init() == SFUD_SUCCESS));
    #ifdef SFUD_USING_QSPI
    sfud_qspi_fast_read_enable(sfud_get_device(SFUD_W25Q32_DEVICE_INDEX), 2);
    #endif
    sfud_demo(0, sizeof(sfud_demo_test_buf), sfud_demo_test_buf);
}

void loop()
{

}
/**
 * SFUD demo for the first flash device test.
 *
 * @param addr flash start address
 * @param size test flash size
 * @param size test flash data buffer
 */
static void sfud_demo(uint32_t addr, size_t size, uint8_t *data) {
    sfud_err result = SFUD_SUCCESS;
    const sfud_flash *flash = sfud_get_device_table() + 0;
    size_t i;
    /*准备写数据 */
    for (i = 0; i < size; i++) {
        data[i] = i;
    }
    /* 擦除测试 */
    result = sfud_erase(flash, addr, size);
    if (result == SFUD_SUCCESS) {
        SERIAL.println("Erase the flash data finish");
    } else {
        SERIAL.println("Erase flash data failed");
        return;
    }
    /* 写测试 */
    result = sfud_write(flash, addr, size, data);
    if (result == SFUD_SUCCESS) {
        SERIAL.println("Write the flash data finish");
    } else {
        SERIAL.println("Write the flash data failed");
        return;
    }
    /* 读测试 */
    size_t BaseTime = micros();
    result = sfud_read(flash, addr, size, data);
    size_t CostTime = micros() - BaseTime;
    if (result == SFUD_SUCCESS) {
        SERIAL.println("Read the flash data success.");
        SERIAL.println("Offset (h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F\r\n");
        for (i = 0; i < size; i++) {
            if (i % 16 == 0) {
                SERIAL.print("0x");
                SERIAL.print(addr + i,HEX);
                SERIAL.print("\t");
            }
            SERIAL.print(data[i],HEX);
            SERIAL.print("\t");
            if (((i + 1) % 16 == 0) || i == size - 1) {
                SERIAL.println("");
            }
        }
        SERIAL.println(" ");
    } else {
        SERIAL.println("Read the flash data failed.");
    }
    /* 数据检查 */
    for (i = 0; i < size; i++) {
        if (data[i] != i % 256) {
            SERIAL.println("Read and check write data has an error.");
   break;
        }
    }
    if (i == size) {
        SERIAL.println("The flash test is success.\r\n");
        SERIAL.print("read costTime: ");
        SERIAL.print(CostTime);
        SERIAL.println(" us");
    }
}