Project restructuring (fixes macOS builds) (#198)

- Create `Include/` folder for all main projects
- Fix some issues here and there (found while moving things)
- All includes are now in `Tactility/` subfolder and must be included with that prefix. This fixes issues with clashing POSIX headers (e.g. `<semaphore.h>` versus Tactility's `Semaphore.h`)

TactilityHeadless/Include/Tactility/service/wifi/Wifi.h

@@ -0,0 +1,133 @@
+#pragma once
+
+#include "./WifiGlobals.h"
+#include "./WifiSettings.h"
+
+#include <Tactility/PubSub.h>
+
+#include <cstdio>
+#include <string>
+#include <vector>
+
+#ifdef ESP_PLATFORM
+#include "esp_wifi.h"
+#include "WifiSettings.h"
+#else
+#include <cstdint>
+// From esp_wifi_types.h in ESP-IDF 5.2
+typedef enum {
+    WIFI_AUTH_OPEN = 0,         /**< authenticate mode : open */
+    WIFI_AUTH_WEP,              /**< authenticate mode : WEP */
+    WIFI_AUTH_WPA_PSK,          /**< authenticate mode : WPA_PSK */
+    WIFI_AUTH_WPA2_PSK,         /**< authenticate mode : WPA2_PSK */
+    WIFI_AUTH_WPA_WPA2_PSK,     /**< authenticate mode : WPA_WPA2_PSK */
+    WIFI_AUTH_ENTERPRISE,       /**< authenticate mode : WiFi EAP security */
+    WIFI_AUTH_WPA2_ENTERPRISE = WIFI_AUTH_ENTERPRISE,  /**< authenticate mode : WiFi EAP security */
+    WIFI_AUTH_WPA3_PSK,         /**< authenticate mode : WPA3_PSK */
+    WIFI_AUTH_WPA2_WPA3_PSK,    /**< authenticate mode : WPA2_WPA3_PSK */
+    WIFI_AUTH_WAPI_PSK,         /**< authenticate mode : WAPI_PSK */
+    WIFI_AUTH_OWE,              /**< authenticate mode : OWE */
+    WIFI_AUTH_WPA3_ENT_192,     /**< authenticate mode : WPA3_ENT_SUITE_B_192_BIT */
+    WIFI_AUTH_WPA3_EXT_PSK,     /**< authenticate mode : WPA3_PSK_EXT_KEY */
+    WIFI_AUTH_WPA3_EXT_PSK_MIXED_MODE, /**< authenticate mode: WPA3_PSK + WPA3_PSK_EXT_KEY */
+    WIFI_AUTH_MAX
+} wifi_auth_mode_t;
+#endif
+
+namespace tt::service::wifi {
+
+enum class EventType {
+    /** Radio was turned on */
+    RadioStateOn,
+    /** Radio is turning on. */
+    RadioStateOnPending,
+    /** Radio is turned off */
+    RadioStateOff,
+    /** Radio is turning off */
+    RadioStateOffPending,
+    /** Started scanning for access points */
+    ScanStarted,
+    /** Finished scanning for access points */ // TODO: 1 second validity
+    ScanFinished,
+    Disconnected,
+    ConnectionPending,
+    ConnectionSuccess,
+    ConnectionFailed
+};
+
+enum class RadioState {
+    OnPending,
+    On,
+    ConnectionPending,
+    ConnectionActive,
+    OffPending,
+    Off,
+};
+
+struct Event {
+    EventType type;
+};
+
+struct ApRecord {
+    std::string ssid;
+    int8_t rssi;
+    int32_t channel;
+    wifi_auth_mode_t auth_mode;
+};
+
+/**
+ * @brief Get wifi pubsub
+ * @return PubSub
+ */
+std::shared_ptr<PubSub> getPubsub();
+
+/** @return Get the current radio state */
+RadioState getRadioState();
+
+/** For logging purposes */
+const char* radioStateToString(RadioState state);
+
+/**
+ * @brief Request scanning update. Returns immediately. Results are through pubsub.
+ */
+void scan();
+
+/** @return true if wifi is actively scanning */
+bool isScanning();
+
+/** @return true the ssid name or empty string */
+std::string getConnectionTarget();
+
+/** @return the access points from the last scan (if any). It only contains public APs. */
+std::vector<ApRecord> getScanResults();
+
+/**
+ * @brief Overrides the default scan result size of 16.
+ * @param[in] records the record limit for the scan result (84 bytes per record!)
+ */
+void setScanRecords(uint16_t records);
+
+/**
+ * @brief Enable/disable the radio. Ignores input if desired state matches current state.
+ * @param[in] enabled
+ */
+void setEnabled(bool enabled);
+
+/**
+ * @brief Connect to a network. Disconnects any existing connection.
+ * Returns immediately but runs in the background. Results are through pubsub.
+ * @param[in] ap
+ * @param[in] remember whether to save the ap data to the settings upon successful connection
+ */
+void connect(const settings::WifiApSettings* ap, bool remember);
+
+/** @brief Disconnect from the access point. Doesn't have any effect when not connected. */
+void disconnect();
+
+/** @return true if the connection isn't unencrypted. */
+bool isConnectionSecure();
+
+/** @return the RSSI value (negative number) or return 1 when not connected. */
+int getRssi();
+
+} // namespace

TactilityHeadless/Include/Tactility/service/wifi/WifiGlobals.h

@@ -0,0 +1,8 @@
+#pragma once
+
+#define TT_WIFI_AUTO_CONNECT true // Default setting for new Wi-Fi entries
+
+#define TT_WIFI_SCAN_RECORD_LIMIT 16 // default, can be overridden
+
+#define TT_WIFI_SSID_LIMIT 32 // 32 characters/octets, according to IEEE 802.11-2020 spec
+#define TT_WIFI_CREDENTIALS_PASSWORD_LIMIT 64 // 64 characters/octets, according to IEEE 802.11-2020 spec

TactilityHeadless/Include/Tactility/service/wifi/WifiSettings.h

@@ -0,0 +1,33 @@
+#pragma once
+
+#include "WifiGlobals.h"
+#include <cstdint>
+
+namespace tt::service::wifi::settings {
+
+/**
+ * This struct is stored as-is into NVS flash.
+ *
+ * The SSID and secret are increased by 1 byte to facilitate string null termination.
+ * This makes it easier to use the char array as a string in various places.
+ */
+struct WifiApSettings {
+    char ssid[TT_WIFI_SSID_LIMIT + 1] = { 0 };
+    char password[TT_WIFI_CREDENTIALS_PASSWORD_LIMIT + 1] = { 0 };
+    int32_t channel = 0;
+    bool auto_connect = true;
+};
+
+bool contains(const char* ssid);
+
+bool load(const char* ssid, WifiApSettings* settings);
+
+bool save(const WifiApSettings* settings);
+
+bool remove(const char* ssid);
+
+void setEnableOnBoot(bool enable);
+
+bool shouldEnableOnBoot();
+
+} // namespace