DataSaverBigSD.h

Go to the documentation of this file.

#pragma once
 
#include <stdint.h>
 
#include <string>
 
#include "ArduinoHAL.h"
#include "data_handling/DataPoint.h"
#include "data_handling/DataSaver.h"
 
constexpr size_t kPreAllocateSize_MiB = 4; // Define the size in MiB
constexpr size_t kBytesPerMiB_bytes = 1024 * 1024; // Define the number of bytes in 1 MiB
constexpr uint32_t kSyncInterval_ms = 1000;
constexpr size_t kFilePathBufferSize = 32; // Buffer size for file path
 
enum BigSDDataSaverError {
    DS_SUCCESS = 0,            // Operation successful
    DS_NOT_READY = -1,         // DataSaver is not ready
    DS_BUFFER_WRITE_FAILED = -3, // Failed to write buffer to file
    DS_LINE_TOO_LONG = -4,     // Line couldn't fit in an empty buffer
    DS_FLUSH_FAILED = -5       // Failed to flush buffer to file
};

class DataSaverBigSD : public IDataSaver {
public:
    explicit DataSaverBigSD(uint8_t csPin = 5);

    bool begin();

    int  saveDataPoint(const DataPoint& dataPoint, uint8_t name) override;

    void end();
 
private:
    static std::string nextFreeFilePath();                    // /stream‑<n>.csv
 
    uint8_t csPin_;
    bool ready_ {false};
 
    /* single shared SdFat instance */
    static SdFat sd_;
    using SdFile_t = File32;
 
    SdFile_t file_;
    std::string filePath_;
 
    /* buffering parameters */
    static constexpr uint16_t kBufSize_bytes = 512;   // one SD sector
    static constexpr uint16_t kFlushLines = 64;    // flush after N lines
    static constexpr uint32_t kFlushMs    = 200;   // or after 200 ms
 
    /* buffering state */
    char buf_[kBufSize_bytes] = {};
    uint16_t bufLen_ = 0;
    uint16_t linesPending_ = 0;
    uint32_t lastFlushMs_ = 0;
    uint32_t lastSyncMs_ = 0;
};