SD card improvements (#214)

- Implement SD card locking logic and helper functions
- Fix issue with running ELF apps from SD card: this would crash when launched from the AppList
- Reduce Boot app wait time to 1 second
- Speed up boot by about 0.1 second by moving app&service registration to the Boot app
- Files app now uses proper SD card mount point name (and multiple SD cards)
- Removed `TT_SCREENSHOT_MODE`

TactilityHeadless/Include/Tactility/hal/Device.h

@@ -5,6 +5,7 @@
 #include <ranges>
 #include <string>
 #include <vector>
+#include <cassert>
 
 namespace tt::hal {
 

TactilityHeadless/Include/Tactility/hal/SdCard.h

@@ -6,9 +6,6 @@
 
 namespace tt::hal {
 
-#define TT_SDCARD_MOUNT_NAME "sdcard"
-#define TT_SDCARD_MOUNT_POINT "/sdcard"
-
 class SdCard : public Device {
 
 public:
@@ -36,12 +33,35 @@ public:
 
     Type getType() const final { return Type::SdCard; };
 
-    virtual bool mount(const char* mountPath) = 0;
+    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; }
 };
 
-} // namespace
+/** Return the SdCard device if the path is within the SdCard mounted path (path std::string::starts_with() check)*/
+std::shared_ptr<SdCard> _Nullable findSdCard(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 = hal::findSdCard(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

TactilityHeadless/Include/Tactility/hal/SpiSdCard.h

@@ -15,7 +15,7 @@ namespace tt::hal {
 /**
  * SD card interface at the default SPI interface
  */
-class SpiSdCard : public tt::hal::SdCard {
+class SpiSdCard final : public tt::hal::SdCard {
 public:
     struct Config {
         Config(
@@ -24,7 +24,7 @@ public:
             gpio_num_t spiPinWp,
             gpio_num_t spiPinInt,
             MountBehaviour mountBehaviourAtBoot,
-            std::shared_ptr<Lockable> lockable = nullptr,
+            std::shared_ptr<Lockable> lockable = std::make_shared<Mutex>(),
             std::vector<gpio_num_t> csPinWorkAround = std::vector<gpio_num_t>(),
             spi_host_device_t spiHost = SPI2_HOST,
             int spiFrequencyKhz = SDMMC_FREQ_DEFAULT
@@ -37,7 +37,9 @@ public:
             lockable(std::move(lockable)),
             csPinWorkAround(std::move(csPinWorkAround)),
             spiHost(spiHost)
-        {}
+        {
+            assert(this->lockable != nullptr);
+        }
 
         int spiFrequencyKhz;
         gpio_num_t spiPinCs; // Clock
@@ -56,12 +58,12 @@ public:
 
 private:
 
-    std::string mountPoint;
+    std::string mountPath;
     sdmmc_card_t* card = nullptr;
     std::shared_ptr<Config> config;
 
     bool applyGpioWorkAround();
-    bool mountInternal(const char* mount_point);
+    bool mountInternal(const std::string& mountPath);
 
 public:
 
@@ -73,8 +75,12 @@ public:
     std::string getName() const final { return "SD Card"; }
     std::string getDescription() const final { return "SD card via SPI interface"; }
 
-    bool mount(const char* mountPath) override;
-    bool unmount() override;
+    bool mount(const std::string& mountPath) final;
+    bool unmount() final;
+    std::string getMountPath() const final { return mountPath; }
+
+    std::shared_ptr<Lockable> getLockable() const final { return config->lockable; }
+
     State getState() const override;
 
     sdmmc_card_t* _Nullable getCard() { return card; }