FileSystemDriver.h

/****************************************************************************
 * Platform Abstraction Layer
 * Daryl Borth 2026
 * FileSystemDriver.h
 ***************************************************************************/
#pragma once
#include <stddef.h>
#include <stdio.h>
 
#include "SmbDriver.h"
#include "Mutex.h"
 
#define MAX_STORAGE_DEVICES 16

enum Device
{
    DEVICE_AUTO = 0,
    DEVICE_SD,
    DEVICE_USB,
    DEVICE_USB2,
    DEVICE_USB3,
    DEVICE_DVD,
    DEVICE_SMB,
    DEVICE_SD_SLOTA,     
    DEVICE_SD_SLOTB,     
    DEVICE_SD_PORT2,     
    DEVICE_SD_GCLOADER,
    DEVICE_LENGTH
};

struct StorageDevice
{
    int  id;               
    char prefix[32];       
    char name[20];         
    char volumeLabel[16];  
    bool removable;          
    bool autoMountAtStartup; 
    bool alwaysListed; 
};

enum class MountResult
{
    Success,
    DeviceNotFound, 
    MountFailed     
};

class FileSystemDriver
{
    public:
        virtual ~FileSystemDriver() = default;

        virtual void init() = 0;
        virtual void shutdown() = 0;

        virtual int enumerateStorageDevices(StorageDevice outDevices[MAX_STORAGE_DEVICES]) = 0;

        virtual MountResult mountStorageDevice(int deviceId) = 0;

        virtual const char * mountResultMessage(int deviceId, MountResult result) = 0;

        virtual void invalidateStorageDevice(int deviceId) = 0;

        virtual void pollStorageDevices(int removedIds[MAX_STORAGE_DEVICES], int & outRemovedCount, bool & deviceListChanged) = 0;

        virtual bool hasRemovableStorageDevices() const = 0;

        virtual bool isDevicePresent(int deviceId) const = 0;

        virtual const char * getDevicePrefix(int device) const = 0;

        virtual const char * getMountPath(int device) const = 0;

        template<size_t N>
        void getPath(char (&out)[N], int device, const char * suffix) const
        {
            getPath(out, N, device, suffix);
        }

        template<size_t N>
        void getPath(char (&out)[N], int device, const char * folder, const char * file) const
        {
            getPath(out, N, device, folder, file);
        }

        void getPath(char * out, size_t outSize, int device, const char * suffix) const
        {
            const char * mp = getMountPath(device);
            snprintf(out, outSize, "%s%s", mp ? mp : "", suffix ? suffix : "");
        }

        void getPath(char * out, size_t outSize, int device, const char * folder, const char * file) const
        {
            snprintf(out, outSize, "%s%s/%s", getMountPath(device), folder ? folder : "", file ? file : "");
        }

        virtual const int * getValidLoadDevices(int & outCount) const = 0;
        virtual const int * getValidSaveDevices(int & outCount) const = 0;

        virtual SmbDriver * getSmb() = 0;
};

inline const char * FindFirstMountedPath(FileSystemDriver * fs, const int * candidates, int count)
{
    for(int i = 0; i < count; i++)
    {
        const char * path = fs->getMountPath(candidates[i]);
        if(path && path[0] != '\0')
            return path;
    }
    return "";
}