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)

Boards/M5stackCoreS3/Source/I2cDevice/I2cDevice.cpp

@@ -0,0 +1,59 @@
+#include "I2cDevice.h"
+
+bool I2cDevice::readRegister12(uint8_t reg, float& out) const {
+    std::uint8_t data[2] = {0};
+    if (tt::hal::i2c::masterReadRegister(port, address, reg, data, 2, DEFAULT_TIMEOUT) == ESP_OK) {
+        out = (data[0] & 0x0F) << 8 | data[1];
+        return true;
+    } else {
+        return false;
+    }
+}
+
+bool I2cDevice::readRegister14(uint8_t reg, float& out) const {
+    std::uint8_t data[2] = {0};
+    if (tt::hal::i2c::masterReadRegister(port, address, reg, data, 2, DEFAULT_TIMEOUT) == ESP_OK) {
+        out = (data[0] & 0x3F) << 8 | data[1];
+        return true;
+    } else {
+        return false;
+    }
+}
+
+bool I2cDevice::readRegister16(uint8_t reg, uint16_t& out) const {
+    std::uint8_t data[2] = {0};
+    if (tt::hal::i2c::masterReadRegister(port, address, reg, data, 2, DEFAULT_TIMEOUT) == ESP_OK) {
+        out = data[0] << 8 | data[1];
+        return true;
+    } else {
+        return false;
+    }
+}
+
+bool I2cDevice::readRegister8(uint8_t reg, uint8_t& result) const {
+    return tt::hal::i2c::masterWriteRead(port, address, &reg, 1, &result, 1, DEFAULT_TIMEOUT);
+}
+
+bool I2cDevice::writeRegister8(uint8_t reg, uint8_t value) const {
+    return tt::hal::i2c::masterWriteRegister(port, address, reg, &value, 1, DEFAULT_TIMEOUT);
+}
+
+bool I2cDevice::bitOn(uint8_t reg, uint8_t bitmask) const {
+    uint8_t state;
+    if (readRegister8(reg, state)) {
+        state |= bitmask;
+        return writeRegister8(reg, state);
+    } else {
+        return false;
+    }
+}
+
+bool I2cDevice::bitOff(uint8_t reg, uint8_t bitmask) const {
+    uint8_t state;
+    if (readRegister8(reg, state)) {
+        state &= ~bitmask;
+        return writeRegister8(reg, state);
+    } else {
+        return false;
+    }
+}

Boards/M5stackCoreS3/Source/I2cDevice/I2cDevice.h

@@ -0,0 +1,25 @@
+#pragma once
+
+#include "hal/i2c/I2c.h"
+
+class I2cDevice {
+
+protected:
+
+    i2c_port_t port;
+    uint8_t address;
+
+    static constexpr TickType_t DEFAULT_TIMEOUT = 1000 / portTICK_PERIOD_MS;
+
+    bool readRegister8(uint8_t reg, uint8_t& result) const;
+    bool writeRegister8(uint8_t reg, uint8_t value) const;
+    bool readRegister12(uint8_t reg, float& out) const;
+    bool readRegister14(uint8_t reg, float& out) const;
+    bool readRegister16(uint8_t reg, uint16_t& out) const;
+    bool bitOn(uint8_t reg, uint8_t bitmask) const;
+    bool bitOff(uint8_t reg, uint8_t bitmask) const;
+
+public:
+
+    explicit I2cDevice(i2c_port_t port, uint32_t address) : port(port), address(address) {}
+};