Ken Van Hoeylandt ee5a5a7181
Merge develop into main (#304)
## New

- Read property files with `PropertiesFile`
- Support `boot.properties` so the user can specify the launcher app and an optional app to start after the launcher finishes. (see `BootProperties.cpp`)
- Create registry for CPU affinity and update code to make use of it
- `AppRegistration` and `ServiceRegistration` now also ensure that the `/data` directories always exist for all apps
- `Notes` is now the default app for opening text files. `TextViewer` is removed entirely. Created `tt::app:🎶:start(path)` function.
- WiFi settings moved from NVS to properties file.
- Specify `*.ap.properties` file on the SD card for automatic WiFi settings import on start-up.
- Added `file::getLock(path)` and `file::withLock(path, function)` to do safe file operations on SD cards

## Improvements

- Update TinyUSB to `1.7.6~1`
- Improved `Boot.cpp` code. General code quality fixes and some restructuring to improve readability.
- `tt::string` functionality improvements
- Rename `AppRegistry` to `AppRegistration`
- Rename `ServiceRegistry` to `ServiceRegistration`
- Cleanup in `Notes.cpp`
- `FileTest.cpp` fix for PC
- Created `TestFile` helper class for tests, which automatically deletes files after the test.
- Renamed `Partitions.h` to `MountPoints.h`
- Created `std::string getMountPoints()` function for easy re-use
- Other code quality improvements
- `SdCardDevice`'s `getState()` and `isMounted()` now have a timeout argument

## Fixes

- ELF loading now has a lock so to avoid a bug when 2 ELF apps are loaded in parallel
2025-08-23 17:10:18 +02:00

37 lines
1.2 KiB
C++

#pragma once
#include <functional>
#include <map>
#include <string>
/**
* @note The functionality below safely acquires and releases any SD card device locks. Manual locking isn't needed.
*/
namespace tt::file {
/**
* Load a properties file into a map
* @param[in] filePath the file to load
* @param[out] properties the resulting properties
* @return true when the properties file was opened successfully
*/
bool loadPropertiesFile(const std::string& filePath, std::map<std::string, std::string>& properties);
/**
* Load a properties file and report key-values to a function
* @param[in] filePath the file to load
* @param[in] callback the callback function that receives the key-values
* @return true when the properties file was opened successfully
*/
bool loadPropertiesFile(const std::string& filePath, std::function<void(const std::string& key, const std::string& value)> callback);
/**
* Save properties to a file
* @param[in] filePath the file to save to
* @param[in] properties the properties to save
* @return true when the data was written to the file succesfully
*/
bool savePropertiesFile(const std::string& filePath, const std::map<std::string, std::string>& properties);
}