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_semaphore.h

@@ -9,12 +9,40 @@ extern "C" {
 #include <stdint.h>
 #include <stdbool.h>
 
+/** A handle that represents a semaphore instance */
 typedef void* SemaphoreHandle;
 
+/**
+ * Allocate a new semaphore instance.
+ * @param[in] maxCount the maximum counter value
+ * @param[in] initialCount the initial counter value
+ * @return the handle that represents the new instance
+ */
 SemaphoreHandle tt_semaphore_alloc(uint32_t maxCount, TickType_t initialCount);
+
+/** Free up the memory of a specified semaphore instance */
 void tt_semaphore_free(SemaphoreHandle handle);
-bool tt_semaphore_acquire(SemaphoreHandle handle, TickType_t timeoutTicks);
+
+/**
+ * Attempt to acquire a semaphore (increase counter)
+ * @param[in] handle the instance handle
+ * @param[in] timeout the maximum amount of ticks to wait while trying to acquire
+ * @return true on successfully acquiring the semaphore (counter is increased)
+ */
+bool tt_semaphore_acquire(SemaphoreHandle handle, TickType_t timeout);
+
+/**
+ * Release an acquired semaphore (decrease counter)
+ * @param[in] handle the instance handle
+ * @return true on successfully releasing the semaphore (counter is decreased)
+ */
 bool tt_semaphore_release(SemaphoreHandle handle);
+
+/**
+ * Get the counter value of this semaphore instance
+ * @param[in] handle the instance handle
+ * @return the current counter value (acquisition count)
+ */
 uint32_t tt_semaphore_get_count(SemaphoreHandle handle);
 
 #ifdef __cplusplus