kopia lustrzana https://github.com/meshtastic/firmware
376 wiersze
11 KiB
C++
376 wiersze
11 KiB
C++
/**
|
|
* @file FSCommon.cpp
|
|
* @brief This file contains functions for common filesystem operations such as copying, renaming, listing and deleting files and
|
|
* directories.
|
|
*
|
|
* The functions in this file are used to perform common filesystem operations such as copying, renaming, listing and deleting
|
|
* files and directories. These functions are used in the Meshtastic-device project to manage files and directories on the
|
|
* device's filesystem.
|
|
*
|
|
*/
|
|
#include "FSCommon.h"
|
|
#include "SPILock.h"
|
|
#include "configuration.h"
|
|
|
|
#ifdef HAS_SDCARD
|
|
#include "SPILock.h"
|
|
#include <SD.h>
|
|
#include <SPI.h>
|
|
#if defined(ARCH_ESP32)
|
|
#if defined(SDCARD_USE_HSPI)
|
|
SPIClass SDHandler = SPIClass(HSPI);
|
|
#elif defined(SDCARD_USE_VSPI)
|
|
SPIClass SDHandler = SPIClass(VSPI);
|
|
#endif
|
|
#elif defined(ARCH_NRF52)
|
|
#if defined(SDCARD_USE_SPI1)
|
|
#define SDHandler SPI1 // only used for esp32, SPI selection for NRF52 happens in variant.h (for now)
|
|
#elif defined(SDCARD_USE_SPI)
|
|
#define SDHandler SPI // only used for esp32
|
|
#endif // NRF52 SPI or SPI1
|
|
#endif // ESP32/NRF52
|
|
#ifndef SD_SPI_FREQUENCY
|
|
#define SD_SPI_FREQUENCY 4000000U
|
|
#endif
|
|
#endif // HAS_SDCARD
|
|
|
|
|
|
#if defined(ARCH_STM32WL)
|
|
|
|
uint16_t OSFS::startOfEEPROM = 1;
|
|
uint16_t OSFS::endOfEEPROM = 2048;
|
|
|
|
// 3) How do I read from the medium?
|
|
void OSFS::readNBytes(uint16_t address, unsigned int num, byte *output)
|
|
{
|
|
for (uint16_t i = address; i < address + num; i++) {
|
|
*output = EEPROM.read(i);
|
|
output++;
|
|
}
|
|
}
|
|
|
|
// 4) How to I write to the medium?
|
|
void OSFS::writeNBytes(uint16_t address, unsigned int num, const byte *input)
|
|
{
|
|
for (uint16_t i = address; i < address + num; i++) {
|
|
EEPROM.update(i, *input);
|
|
input++;
|
|
}
|
|
}
|
|
#endif // ARCH_STM32WL
|
|
|
|
/**
|
|
* @brief Copies a file from one location to another.
|
|
*
|
|
* @param from The path of the source file.
|
|
* @param to The path of the destination file.
|
|
* @return true if the file was successfully copied, false otherwise.
|
|
*/
|
|
bool copyFile(const char *from, const char *to)
|
|
{
|
|
#ifdef FSCom
|
|
// take SPI Lock
|
|
concurrency::LockGuard g(spiLock);
|
|
unsigned char cbuffer[16];
|
|
|
|
File f1 = FSCom.open(from, FILE_O_READ);
|
|
if (!f1) {
|
|
LOG_ERROR("Failed to open source file %s", from);
|
|
return false;
|
|
}
|
|
|
|
File f2 = FSCom.open(to, FILE_O_WRITE);
|
|
if (!f2) {
|
|
LOG_ERROR("Failed to open destination file %s", to);
|
|
return false;
|
|
}
|
|
|
|
while (f1.available() > 0) {
|
|
byte i = f1.read(cbuffer, 16);
|
|
f2.write(cbuffer, i);
|
|
}
|
|
|
|
f2.flush();
|
|
f2.close();
|
|
f1.close();
|
|
return true;
|
|
#endif
|
|
}
|
|
|
|
/**
|
|
* Renames a file from pathFrom to pathTo.
|
|
*
|
|
* @param pathFrom The original path of the file.
|
|
* @param pathTo The new path of the file.
|
|
*
|
|
* @return True if the file was successfully renamed, false otherwise.
|
|
*/
|
|
bool renameFile(const char *pathFrom, const char *pathTo)
|
|
{
|
|
#ifdef FSCom
|
|
|
|
#ifdef ARCH_ESP32
|
|
// take SPI Lock
|
|
spiLock->lock();
|
|
// rename was fixed for ESP32 IDF LittleFS in April
|
|
bool result = FSCom.rename(pathFrom, pathTo);
|
|
spiLock->unlock();
|
|
return result;
|
|
#else
|
|
// copyFile does its own locking.
|
|
if (copyFile(pathFrom, pathTo) && FSCom.remove(pathFrom)) {
|
|
return true;
|
|
} else {
|
|
return false;
|
|
}
|
|
#endif
|
|
|
|
#endif
|
|
}
|
|
|
|
#include <vector>
|
|
|
|
/**
|
|
* @brief Get the list of files in a directory.
|
|
*
|
|
* This function returns a list of files in a directory. The list includes the full path of each file.
|
|
* We can't use SPILOCK here because of recursion. Callers of this function should use SPILOCK.
|
|
*
|
|
* @param dirname The name of the directory.
|
|
* @param levels The number of levels of subdirectories to list.
|
|
* @return A vector of strings containing the full path of each file in the directory.
|
|
*/
|
|
std::vector<meshtastic_FileInfo> getFiles(const char *dirname, uint8_t levels)
|
|
{
|
|
std::vector<meshtastic_FileInfo> filenames = {};
|
|
#ifdef FSCom
|
|
File root = FSCom.open(dirname, FILE_O_READ);
|
|
if (!root)
|
|
return filenames;
|
|
if (!root.isDirectory())
|
|
return filenames;
|
|
|
|
File file = root.openNextFile();
|
|
while (file) {
|
|
if (file.isDirectory() && !String(file.name()).endsWith(".")) {
|
|
if (levels) {
|
|
#ifdef ARCH_ESP32
|
|
std::vector<meshtastic_FileInfo> subDirFilenames = getFiles(file.path(), levels - 1);
|
|
#else
|
|
std::vector<meshtastic_FileInfo> subDirFilenames = getFiles(file.name(), levels - 1);
|
|
#endif
|
|
filenames.insert(filenames.end(), subDirFilenames.begin(), subDirFilenames.end());
|
|
file.close();
|
|
}
|
|
} else {
|
|
meshtastic_FileInfo fileInfo = {"", static_cast<uint32_t>(file.size())};
|
|
#ifdef ARCH_ESP32
|
|
strcpy(fileInfo.file_name, file.path());
|
|
#else
|
|
strcpy(fileInfo.file_name, file.name());
|
|
#endif
|
|
if (!String(fileInfo.file_name).endsWith(".")) {
|
|
filenames.push_back(fileInfo);
|
|
}
|
|
file.close();
|
|
}
|
|
file = root.openNextFile();
|
|
}
|
|
root.close();
|
|
#endif
|
|
return filenames;
|
|
}
|
|
|
|
/**
|
|
* Lists the contents of a directory.
|
|
* We can't use SPILOCK here because of recursion. Callers of this function should use SPILOCK.
|
|
*
|
|
* @param dirname The name of the directory to list.
|
|
* @param levels The number of levels of subdirectories to list.
|
|
* @param del Whether or not to delete the contents of the directory after listing.
|
|
*/
|
|
void listDir(const char *dirname, uint8_t levels, bool del)
|
|
{
|
|
#ifdef FSCom
|
|
#if (defined(ARCH_ESP32) || defined(ARCH_RP2040) || defined(ARCH_PORTDUINO))
|
|
char buffer[255];
|
|
#endif
|
|
File root = FSCom.open(dirname, FILE_O_READ);
|
|
if (!root) {
|
|
return;
|
|
}
|
|
if (!root.isDirectory()) {
|
|
return;
|
|
}
|
|
|
|
File file = root.openNextFile();
|
|
while (
|
|
file &&
|
|
file.name()[0]) { // This file.name() check is a workaround for a bug in the Adafruit LittleFS nrf52 glue (see issue 4395)
|
|
if (file.isDirectory() && !String(file.name()).endsWith(".")) {
|
|
if (levels) {
|
|
#ifdef ARCH_ESP32
|
|
listDir(file.path(), levels - 1, del);
|
|
if (del) {
|
|
LOG_DEBUG("Remove %s", file.path());
|
|
strncpy(buffer, file.path(), sizeof(buffer));
|
|
file.close();
|
|
FSCom.rmdir(buffer);
|
|
} else {
|
|
file.close();
|
|
}
|
|
#elif (defined(ARCH_RP2040) || defined(ARCH_PORTDUINO))
|
|
listDir(file.name(), levels - 1, del);
|
|
if (del) {
|
|
LOG_DEBUG("Remove %s", file.name());
|
|
strncpy(buffer, file.name(), sizeof(buffer));
|
|
file.close();
|
|
FSCom.rmdir(buffer);
|
|
} else {
|
|
file.close();
|
|
}
|
|
#else
|
|
LOG_DEBUG(" %s (directory)", file.name());
|
|
listDir(file.name(), levels - 1, del);
|
|
file.close();
|
|
#endif
|
|
}
|
|
} else {
|
|
#ifdef ARCH_ESP32
|
|
if (del) {
|
|
LOG_DEBUG("Delete %s", file.path());
|
|
strncpy(buffer, file.path(), sizeof(buffer));
|
|
file.close();
|
|
FSCom.remove(buffer);
|
|
} else {
|
|
LOG_DEBUG(" %s (%i Bytes)", file.path(), file.size());
|
|
file.close();
|
|
}
|
|
#elif (defined(ARCH_RP2040) || defined(ARCH_PORTDUINO))
|
|
if (del) {
|
|
LOG_DEBUG("Delete %s", file.name());
|
|
strncpy(buffer, file.name(), sizeof(buffer));
|
|
file.close();
|
|
FSCom.remove(buffer);
|
|
} else {
|
|
LOG_DEBUG(" %s (%i Bytes)", file.name(), file.size());
|
|
file.close();
|
|
}
|
|
#else
|
|
LOG_DEBUG(" %s (%i Bytes)", file.name(), file.size());
|
|
file.close();
|
|
#endif
|
|
}
|
|
file = root.openNextFile();
|
|
}
|
|
#ifdef ARCH_ESP32
|
|
if (del) {
|
|
LOG_DEBUG("Remove %s", root.path());
|
|
strncpy(buffer, root.path(), sizeof(buffer));
|
|
root.close();
|
|
FSCom.rmdir(buffer);
|
|
} else {
|
|
root.close();
|
|
}
|
|
#elif (defined(ARCH_RP2040) || defined(ARCH_PORTDUINO))
|
|
if (del) {
|
|
LOG_DEBUG("Remove %s", root.name());
|
|
strncpy(buffer, root.name(), sizeof(buffer));
|
|
root.close();
|
|
FSCom.rmdir(buffer);
|
|
} else {
|
|
root.close();
|
|
}
|
|
#else
|
|
root.close();
|
|
#endif
|
|
#endif
|
|
}
|
|
|
|
/**
|
|
* @brief Removes a directory and all its contents.
|
|
*
|
|
* This function recursively removes a directory and all its contents, including subdirectories and files.
|
|
*
|
|
* @param dirname The name of the directory to remove.
|
|
*/
|
|
void rmDir(const char *dirname)
|
|
{
|
|
#ifdef FSCom
|
|
|
|
#if (defined(ARCH_ESP32) || defined(ARCH_RP2040) || defined(ARCH_PORTDUINO))
|
|
listDir(dirname, 10, true);
|
|
#elif defined(ARCH_NRF52)
|
|
// nRF52 implementation of LittleFS has a recursive delete function
|
|
FSCom.rmdir_r(dirname);
|
|
#endif
|
|
|
|
#endif
|
|
}
|
|
|
|
/**
|
|
* Some platforms (nrf52) might need to do an extra step before FSBegin().
|
|
*/
|
|
__attribute__((weak, noinline)) void preFSBegin() {}
|
|
|
|
void fsInit()
|
|
{
|
|
#ifdef FSCom
|
|
concurrency::LockGuard g(spiLock);
|
|
preFSBegin();
|
|
if (!FSBegin()) {
|
|
LOG_ERROR("Filesystem mount failed");
|
|
// assert(0); This auto-formats the partition, so no need to fail here.
|
|
}
|
|
#if defined(ARCH_ESP32)
|
|
LOG_DEBUG("Filesystem files (%d/%d Bytes):", FSCom.usedBytes(), FSCom.totalBytes());
|
|
#else
|
|
LOG_DEBUG("Filesystem files:");
|
|
#endif
|
|
listDir("/", 10);
|
|
#endif
|
|
}
|
|
|
|
/**
|
|
* Initializes the SD card and mounts the file system.
|
|
*/
|
|
void setupSDCard()
|
|
{
|
|
#ifdef HAS_SDCARD
|
|
concurrency::LockGuard g(spiLock);
|
|
#if (defined(ARCH_ESP32) || defined(ARCH_NRF52))
|
|
#if (defined(ARCH_ESP32))
|
|
SDHandler.begin(SPI_SCK, SPI_MISO, SPI_MOSI);
|
|
#elif (defined(ARCH_NRF52))
|
|
SDHandler.begin();
|
|
#endif
|
|
|
|
if (!SD.begin(SDCARD_CS, SDHandler, SD_SPI_FREQUENCY)) {
|
|
LOG_DEBUG("No SD_MMC card detected");
|
|
return;
|
|
}
|
|
uint8_t cardType = SD.cardType();
|
|
if (cardType == CARD_NONE) {
|
|
LOG_DEBUG("No SD_MMC card attached");
|
|
return;
|
|
}
|
|
if (cardType == CARD_MMC) {
|
|
LOG_DEBUG("SD_MMC Card Type: MMC");
|
|
} else if (cardType == CARD_SD) {
|
|
LOG_DEBUG("SD_MMC Card Type: SDSC");
|
|
} else if (cardType == CARD_SDHC) {
|
|
LOG_DEBUG("SD_MMC Card Type: SDHC");
|
|
} else {
|
|
LOG_DEBUG("SD_MMC Card Type: UNKNOWN");
|
|
}
|
|
|
|
uint64_t cardSize = SD.cardSize() / (1024 * 1024);
|
|
LOG_DEBUG("SD Card Size: %lu MB", (uint32_t)cardSize);
|
|
LOG_DEBUG("Total space: %lu MB", (uint32_t)(SD.totalBytes() / (1024 * 1024)));
|
|
LOG_INFO("Now scanning free clusters on SD card");
|
|
delay(100); // let serial print the above statement properly
|
|
LOG_DEBUG("Used space: %lu MB", (uint32_t)(SD.usedBytes() / (1024 * 1024)));
|
|
|
|
#endif
|
|
#endif
|
|
} |