Merge develop into main (#167)

- WiFi Connect app is now hidden by default, but accessible at the bottom of the WiFi Manage app when WiFi is turned on.
- WiFi service now turns on WiFi when calling connect() and WiFi is not on.
- Removed `blocking` option for `service::loader::startApp()`. This feature was unused and complex.
- Various apps: Moved private headers into Private/ folder.
- Various apps: created start() function for easy starting.
- Added documentation to all TactilityC APIs
- Refactored various `enum` into `class enum`
- Refactor M5Stack `initBoot()` (but VBus is still 0V for some reason)

TactilityC/Source/tt_mutex.h

@@ -9,6 +9,7 @@ extern "C" {
 #include <stdint.h>
 #include <stdbool.h>
 
+/** A handle that represents a mutex instance */
 typedef void* MutexHandle;
 
 enum TtMutexType {
@@ -16,9 +17,30 @@ enum TtMutexType {
     MUTEX_TYPE_RECURSIVE
 };
 
-MutexHandle tt_mutex_alloc(enum TtMutexType);
+/**
+ * Allocate a new mutex instance
+ * @param[in] type specify if the mutex is either a normal one, or whether it can recursively (re)lock
+ * @return the allocated instance
+ */
+MutexHandle tt_mutex_alloc(enum TtMutexType type);
+
+/** Free up the memory of the specified mutex instance. */
 void tt_mutex_free(MutexHandle handle);
-bool tt_mutex_lock(MutexHandle handle, TickType_t timeoutTicks);
+
+/**
+ * Attempt to lock a mutex.
+ * @param[in] handle the handle that represents the mutex instance
+ * @param[in] timeout the maximum amount of ticks to wait when trying to lock
+ * @return true when the lock was acquired
+ */
+bool tt_mutex_lock(MutexHandle handle, TickType_t timeout);
+
+/**
+ * Attempt to unlock a mutex.
+ * @param[in] handle the handle that represents the mutex instance
+ * @param[in] timeout the maximum amount of ticks to wait when trying to unlock
+ * @return true when the lock was unlocked
+ */
 bool tt_mutex_unlock(MutexHandle handle);
 
 #ifdef __cplusplus