HAL renaming & relocation (#215)

Implemented more consistent naming:
- Moved all HAL devices into their own namespace (and related folder)
- Post-fixed all HAL device names with "Device"

TactilityHeadless/Include/Tactility/hal/sdcard/SdCardDevice.h

@@ -0,0 +1,67 @@
+#pragma once
+
+#include "../Device.h"
+
+#include <Tactility/TactilityCore.h>
+
+namespace tt::hal::sdcard {
+
+class SdCardDevice : public Device {
+
+public:
+
+    enum class State {
+        Mounted,
+        Unmounted,
+        Error,
+        Unknown
+    };
+
+    enum class MountBehaviour {
+        AtBoot, /** Only mount at boot */
+        Anytime /** Mount/dismount any time */
+    };
+
+private:
+
+    MountBehaviour mountBehaviour;
+
+public:
+
+    explicit SdCardDevice(MountBehaviour mountBehaviour) : mountBehaviour(mountBehaviour) {}
+    virtual ~SdCardDevice() override = default;
+
+    Type getType() const final { return Type::SdCard; };
+
+    virtual bool mount(const std::string& mountPath) = 0;
+    virtual bool unmount() = 0;
+    virtual State getState() const = 0;
+    /** Return empty string when not mounted or the mount path if mounted */
+    virtual std::string getMountPath() const = 0;
+
+    virtual std::shared_ptr<Lockable> getLockable() const = 0;
+
+    virtual MountBehaviour getMountBehaviour() const { return mountBehaviour; }
+    bool isMounted() const { return getState() == State::Mounted; }
+};
+
+/** Return the SdCard device if the path is within the SdCard mounted path (path std::string::starts_with() check)*/
+std::shared_ptr<SdCardDevice> _Nullable find(const std::string& path);
+
+/**
+ * Acquires an SD card lock if the path is an SD card path.
+ * Always calls the function, but doesn't lock if the path is not an SD card path.
+ */
+template<typename ReturnType>
+inline ReturnType withSdCardLock(const std::string& path, std::function<ReturnType()> fn) {
+    auto sdcard = find(path);
+    std::unique_ptr<ScopedLockableUsage> scoped_lockable;
+    if (sdcard != nullptr) {
+        scoped_lockable = sdcard->getLockable()->scoped();
+        scoped_lockable->lock(portMAX_DELAY);
+    }
+
+    return fn();
+}
+
+} // namespace tt::hal