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)

Tactility/Private/app/wifimanage/Bindings.h

@@ -0,0 +1,19 @@
+#pragma once
+
+namespace tt::app::wifimanage {
+
+typedef void (*OnWifiToggled)(bool enable);
+typedef void (*OnConnectSsid)(const char* ssid);
+typedef void (*OnDisconnect)();
+typedef void (*OnShowApSettings)(const char* ssid);
+typedef void (*OnConnectToHidden)();
+
+struct Bindings{
+    OnWifiToggled onWifiToggled;
+    OnConnectSsid onConnectSsid;
+    OnDisconnect onDisconnect;
+    OnShowApSettings onShowApSettings;
+    OnConnectToHidden onConnectToHidden;
+};
+
+} // namespace

Tactility/Private/app/wifimanage/State.h

@@ -0,0 +1,40 @@
+#pragma once
+
+#include "service/wifi/Wifi.h"
+#include "Mutex.h"
+
+namespace tt::app::wifimanage {
+
+/**
+ * View's state
+ */
+class State {
+
+    Mutex mutex = Mutex(Mutex::Type::Recursive);
+    bool scanning = false;
+    bool scannedAfterRadioOn = false;
+    service::wifi::RadioState radioState;
+    std::vector<service::wifi::ApRecord> apRecords;
+    std::string connectSsid;
+
+public:
+    State() = default;
+
+    void setScanning(bool isScanning);
+    bool isScanning() const;
+
+    bool hasScannedAfterRadioOn() const { return scannedAfterRadioOn; }
+
+    void setRadioState(service::wifi::RadioState state);
+    service::wifi::RadioState getRadioState() const;
+
+    void updateApRecords();
+
+    const std::vector<service::wifi::ApRecord>& lockApRecords() const;
+    void unlockApRecords() const;
+
+    void setConnectSsid(const std::string& ssid);
+    std::string getConnectSsid() const;
+};
+
+} // namespace

Tactility/Private/app/wifimanage/View.h

@@ -0,0 +1,40 @@
+#pragma once
+
+#include "app/AppContext.h"
+#include "./Bindings.h"
+#include "./State.h"
+#include "lvgl.h"
+
+namespace tt::app::wifimanage {
+
+class View {
+
+private:
+
+    Bindings* bindings;
+    State* state;
+    std::unique_ptr<app::Paths> paths;
+    lv_obj_t* root = nullptr;
+    lv_obj_t* enable_switch = nullptr;
+    lv_obj_t* enable_on_boot_switch = nullptr;
+    lv_obj_t* scanning_spinner = nullptr;
+    lv_obj_t* networks_list = nullptr;
+    lv_obj_t* connect_to_hidden = nullptr;
+
+    void updateWifiToggle();
+    void updateEnableOnBootToggle();
+    void updateScanning();
+    void updateNetworkList();
+    void updateConnectToHidden();
+    void createSsidListItem(const service::wifi::ApRecord& record, bool isConnecting);
+
+public:
+
+    View(Bindings* bindings, State* state) : bindings(bindings), state(state) {}
+
+    void init(const AppContext& app, lv_obj_t* parent);
+    void update();
+};
+
+
+} // namespace

Tactility/Private/app/wifimanage/WifiManagePrivate.h

@@ -0,0 +1,35 @@
+#pragma once
+
+#include "Mutex.h"
+#include "./View.h"
+#include "./State.h"
+#include "service/wifi/Wifi.h"
+
+namespace tt::app::wifimanage {
+
+class WifiManage {
+
+    PubSubSubscription* wifiSubscription = nullptr;
+    Mutex mutex;
+    Bindings bindings = { };
+    State state;
+    View view = View(&bindings, &state);
+    bool isViewEnabled = false;
+
+public:
+
+    WifiManage();
+
+    void lock();
+    void unlock();
+
+    void onShow(AppContext& app, lv_obj_t* parent);
+    void onHide(AppContext& app);
+
+    Bindings& getBindings() { return bindings; }
+    State& getState() { return state; }
+
+    void requestViewUpdate();
+};
+
+} // namespace