@mentra/bluetooth-sdk 0.1.0

package/ios/Source/sgcs/SGCManager.swift

@@ -0,0 +1,243 @@
+import Foundation
+
+@MainActor
+protocol SGCManager {
+    // MARK: - hard coded device properties:
+
+    var type: String { get set }
+    var hasMic: Bool { get }
+
+    // MARK: - Audio Control
+
+    func setMicEnabled(_ enabled: Bool)
+    func sortMicRanking(list: [String]) -> [String]
+
+    // MARK: - Messaging
+
+    func sendJson(_ jsonOriginal: [String: Any], wakeUp: Bool, requireAck: Bool)
+
+    // MARK: - Camera & Media
+
+    func requestPhoto(
+        _ requestId: String, appId: String, size: String?, webhookUrl: String?, authToken: String?,
+        compress: String?, flash: Bool, sound: Bool
+    )
+    func startStream(_ message: [String: Any])
+    func stopStream()
+    func sendStreamKeepAlive(_ message: [String: Any])
+    func startVideoRecording(requestId: String, save: Bool, flash: Bool, sound: Bool)
+    func stopVideoRecording(requestId: String)
+
+    // MARK: - Button Settings
+
+    func sendButtonPhotoSettings()
+    func sendButtonVideoRecordingSettings()
+    func sendButtonMaxRecordingTime()
+    func sendButtonCameraLedSetting()
+    func sendCameraFovSetting()
+
+    // MARK: - Display Control
+
+    func setBrightness(_ level: Int, autoMode: Bool)
+    func clearDisplay()
+    func sendTextWall(_ text: String)
+    func sendDoubleTextWall(_ top: String, _ bottom: String)
+    func displayBitmap(base64ImageData: String) async -> Bool
+    func showDashboard()
+    func setDashboardPosition(_ height: Int, _ depth: Int)
+    /// Default implementation sends both via [setDashboardPosition]; Nex overrides to one protobuf.
+    func setDashboardHeightOnly(_ height: Int)
+    func setDashboardDepthOnly(_ depth: Int)
+
+    // MARK: - Dashboard Menu
+
+    func setDashboardMenu(_ items: [[String: Any]])
+
+    // MARK: - Device Control
+
+    func setHeadUpAngle(_ angle: Int)
+    func getBatteryStatus()
+    func setSilentMode(_ enabled: Bool)
+    func exit()
+    func sendShutdown()
+    func sendReboot()
+    func sendRgbLedControl(
+        requestId: String, packageName: String?, action: String, color: String?, ontime: Int,
+        offtime: Int, count: Int
+    )
+
+    // MARK: - Connection Management
+
+    func disconnect()
+    func forget()
+    func findCompatibleDevices()
+    func stopScan()
+    func connectById(_ id: String)
+    func getConnectedBluetoothName() -> String?
+    func connectController()
+    func disconnectController()
+    func cleanup()
+    func ping()
+    func dbg1()
+    func dbg2()
+
+    // MARK: - Network Management
+
+    func requestWifiScan()
+    func sendWifiCredentials(_ ssid: String, _ password: String)
+    func forgetWifiNetwork(_ ssid: String)
+    func sendHotspotState(_ enabled: Bool)
+    func sendOtaStart()
+    func sendOtaQueryStatus()
+
+    // MARK: - User Context (for crash reporting)
+
+    func sendUserEmailToGlasses(_ email: String)
+
+    // MARK: - Incident Reporting
+
+    func sendIncidentId(_ incidentId: String, apiBaseUrl: String?)
+
+    // MARK: - Gallery
+
+    func queryGalleryStatus()
+    func sendGalleryMode()
+
+    // MARK: - Version Info
+
+    func requestVersionInfo()
+}
+
+/// doesn't seem to work for concurrency reasons :(
+/// we can make read-only getters for convienence though:
+extension SGCManager {
+    // MARK: - Dashboard (default: combined wire format; Nex implements single-field)
+
+    func setDashboardHeightOnly(_ height: Int) {
+        let d = DeviceStore.shared.get("bluetooth", "dashboard_depth") as? Int ?? 2
+        setDashboardPosition(height, d)
+    }
+
+    func setDashboardDepthOnly(_ depth: Int) {
+        let h = DeviceStore.shared.get("bluetooth", "dashboard_height") as? Int ?? 4
+        setDashboardPosition(h, depth)
+    }
+
+    // MARK: - Dashboard Menu (default no-op — only G2 supports this)
+
+    func setDashboardMenu(_: [[String: Any]]) {}
+
+    // MARK: - Default DeviceStore-backed property implementations
+
+    var fullyBooted: Bool {
+        DeviceStore.shared.get("glasses", "fullyBooted") as? Bool ?? false
+    }
+
+    var connected: Bool {
+        DeviceStore.shared.get("glasses", "connected") as? Bool ?? false
+    }
+
+    var appVersion: String {
+        DeviceStore.shared.get("glasses", "appVersion") as? String ?? ""
+    }
+
+    var buildNumber: String {
+        DeviceStore.shared.get("glasses", "buildNumber") as? String ?? ""
+    }
+
+    var deviceModel: String {
+        DeviceStore.shared.get("glasses", "deviceModel") as? String ?? ""
+    }
+
+    var androidVersion: String {
+        DeviceStore.shared.get("glasses", "androidVersion") as? String ?? ""
+    }
+
+    var otaVersionUrl: String {
+        DeviceStore.shared.get("glasses", "otaVersionUrl") as? String ?? ""
+    }
+
+    var firmwareVersion: String {
+        DeviceStore.shared.get("glasses", "fwVersion") as? String ?? ""
+    }
+
+    var btMacAddress: String {
+        DeviceStore.shared.get("glasses", "btMacAddress") as? String ?? ""
+    }
+
+    var serialNumber: String {
+        DeviceStore.shared.get("glasses", "serialNumber") as? String ?? ""
+    }
+
+    var style: String {
+        DeviceStore.shared.get("glasses", "style") as? String ?? ""
+    }
+
+    var color: String {
+        DeviceStore.shared.get("glasses", "color") as? String ?? ""
+    }
+
+    var micEnabled: Bool {
+        DeviceStore.shared.get("glasses", "micEnabled") as? Bool ?? false
+    }
+
+    var vadEnabled: Bool {
+        DeviceStore.shared.get("glasses", "vadEnabled") as? Bool ?? false
+    }
+
+    var batteryLevel: Int {
+        DeviceStore.shared.get("glasses", "batteryLevel") as? Int ?? -1
+    }
+
+    var headUp: Bool {
+        DeviceStore.shared.get("glasses", "headUp") as? Bool ?? false
+    }
+
+    var charging: Bool {
+        DeviceStore.shared.get("glasses", "charging") as? Bool ?? false
+    }
+
+    var caseOpen: Bool {
+        DeviceStore.shared.get("glasses", "caseOpen") as? Bool ?? true
+    }
+
+    var caseRemoved: Bool {
+        DeviceStore.shared.get("glasses", "caseRemoved") as? Bool ?? true
+    }
+
+    var caseCharging: Bool {
+        DeviceStore.shared.get("glasses", "caseCharging") as? Bool ?? false
+    }
+
+    var caseBatteryLevel: Int {
+        DeviceStore.shared.get("glasses", "caseBatteryLevel") as? Int ?? -1
+    }
+
+    var wifiSsid: String {
+        DeviceStore.shared.get("glasses", "wifiSsid") as? String ?? ""
+    }
+
+    var wifiConnected: Bool {
+        DeviceStore.shared.get("glasses", "wifiConnected") as? Bool ?? false
+    }
+
+    var wifiLocalIp: String {
+        DeviceStore.shared.get("glasses", "wifiLocalIp") as? String ?? ""
+    }
+
+    var hotspotEnabled: Bool {
+        DeviceStore.shared.get("glasses", "hotspotEnabled") as? Bool ?? false
+    }
+
+    var hotspotSsid: String {
+        DeviceStore.shared.get("glasses", "hotspotSsid") as? String ?? ""
+    }
+
+    var hotspotPassword: String {
+        DeviceStore.shared.get("glasses", "hotspotPassword") as? String ?? ""
+    }
+
+    var hotspotGatewayIp: String {
+        DeviceStore.shared.get("glasses", "hotspotGatewayIp") as? String ?? ""
+    }
+}

package/ios/Source/sgcs/Simulated.swift

@@ -0,0 +1,270 @@
+//
+//  Simulated.swift
+//  AOS
+//
+//  Created by Matthew Fosse on 10/7/25.
+//
+
+@MainActor
+class Simulated: SGCManager {
+    init() {
+        DeviceStore.shared.apply("glasses", "fullyBooted", true)
+        DeviceStore.shared.apply("glasses", "connected", true)
+        DeviceStore.shared.apply("glasses", "connectionState", ConnTypes.CONNECTED)
+        DeviceStore.shared.apply("glasses", "micEnabled", false)
+        DeviceStore.shared.apply("glasses", "vadEnabled", false)
+        DeviceStore.shared.apply("glasses", "btcConnected", false)
+    }
+
+    // MARK: - Device Information
+
+    var type: String = DeviceTypes.SIMULATED
+    var ready: Bool = true
+    var connectionState: String = ConnTypes.CONNECTED
+
+    var appVersion: String = ""
+    var buildNumber: String = ""
+    var deviceModel: String = ""
+    var androidVersion: String = ""
+    var otaVersionUrl: String = ""
+    var firmwareVersion: String = ""
+    var btMacAddress: String = ""
+    var serialNumber: String = ""
+    var style: String = ""
+    var color: String = ""
+
+    // MARK: - Hardware Status
+
+    var hasMic: Bool = false
+    var batteryLevel: Int = 100
+    var headUp: Bool = false
+    var micEnabled: Bool = false
+
+    // MARK: - Case Status
+
+    var caseOpen: Bool = false
+    var caseRemoved: Bool = false
+    var caseCharging: Bool = false
+    var caseBatteryLevel: Int = -1
+
+    // MARK: - Network Status
+
+    var wifiSsid: String = ""
+    var wifiConnected: Bool = false
+    var wifiLocalIp: String = ""
+    var hotspotEnabled: Bool = false
+    var hotspotSsid: String = ""
+    var hotspotPassword: String = ""
+    var hotspotGatewayIp: String = ""
+
+    // MARK: - Audio Control
+
+    func setMicEnabled(_: Bool) {
+        Bridge.log("setMicEnabled")
+    }
+
+    func sortMicRanking(list: [String]) -> [String] {
+        return list
+    }
+
+    // MARK: - Messaging
+
+    func sendJson(_: [String: Any], wakeUp _: Bool, requireAck _: Bool) {
+        Bridge.log("sendJson")
+    }
+
+    // MARK: - Camera & Media
+
+    func requestPhoto(_: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?, compress _: String?, flash _: Bool, sound _: Bool) {
+        Bridge.log("requestPhoto")
+    }
+
+    func startStream(_: [String: Any]) {
+        Bridge.log("startStream")
+    }
+
+    func stopStream() {
+        Bridge.log("stopStream")
+    }
+
+    func sendStreamKeepAlive(_: [String: Any]) {
+        Bridge.log("sendStreamKeepAlive")
+    }
+
+    func startVideoRecording(requestId _: String, save _: Bool, flash _: Bool, sound _: Bool) {
+        Bridge.log("startVideoRecording")
+    }
+
+    func stopVideoRecording(requestId _: String) {
+        Bridge.log("stopVideoRecording")
+    }
+
+    // MARK: - Button Settings
+
+    func sendButtonPhotoSettings() {
+        Bridge.log("sendButtonPhotoSettings")
+    }
+
+    func sendButtonVideoRecordingSettings() {
+        Bridge.log("sendButtonVideoRecordingSettings")
+    }
+
+    func sendButtonCameraLedSetting() {
+        Bridge.log("sendButtonCameraLedSetting")
+    }
+
+    func sendCameraFovSetting() {
+        Bridge.log("sendCameraFovSetting")
+    }
+
+    func sendButtonMaxRecordingTime() {}
+
+    // MARK: - Display Control
+
+    func setBrightness(_: Int, autoMode _: Bool) {
+        Bridge.log("setBrightness")
+    }
+
+    func clearDisplay() {
+        Bridge.log("clearDisplay")
+    }
+
+    func sendTextWall(_: String) {
+        Bridge.log("sendTextWall")
+    }
+
+    func sendDoubleTextWall(_: String, _: String) {
+        Bridge.log("sendDoubleTextWall")
+    }
+
+    func displayBitmap(base64ImageData _: String) async -> Bool {
+        Bridge.log("displayBitmap")
+        return false
+    }
+
+    func showDashboard() {
+        Bridge.log("showDashboard")
+    }
+
+    func setDashboardPosition(_: Int, _: Int) {
+        Bridge.log("setDashboardPosition")
+    }
+
+    // MARK: - Device Control
+
+    func setHeadUpAngle(_: Int) {
+        Bridge.log("setHeadUpAngle")
+    }
+
+    func getBatteryStatus() {
+        Bridge.log("getBatteryStatus")
+    }
+
+    func setSilentMode(_: Bool) {
+        Bridge.log("setSilentMode")
+    }
+
+    func exit() {
+        Bridge.log("exit")
+    }
+
+    func sendShutdown() {
+        Bridge.log("sendShutdown - not supported on Simulated")
+    }
+
+    func sendReboot() {
+        Bridge.log("sendReboot - not supported on Simulated")
+    }
+
+    func sendRgbLedControl(requestId: String, packageName _: String?, action _: String, color _: String?, ontime _: Int, offtime _: Int, count _: Int) {
+        Bridge.log("sendRgbLedControl - not supported on Simulated")
+        Bridge.sendRgbLedControlResponse(requestId: requestId, success: false, error: "device_not_supported")
+    }
+
+    // MARK: - Connection Management
+
+    func disconnect() {
+        Bridge.log("disconnect")
+    }
+
+    func forget() {
+        Bridge.log("forget")
+    }
+
+    func findCompatibleDevices() {
+        Bridge.log("findCompatibleDevices")
+    }
+
+    func stopScan() {
+        Bridge.log("stopScan")
+    }
+
+    func connectById(_: String) {
+        Bridge.log("connectById")
+    }
+
+    func getConnectedBluetoothName() -> String? {
+        return nil
+    }
+
+    func cleanup() {
+        Bridge.log("cleanup")
+    }
+
+    func ping() {
+        Bridge.log("ping")
+    }
+
+    func dbg1() {}
+    func dbg2() {}
+    func connectController() {}
+    func disconnectController() {}
+
+    // MARK: - Network Management
+
+    func requestWifiScan() {
+        Bridge.log("requestWifiScan")
+    }
+
+    func sendWifiCredentials(_: String, _: String) {
+        Bridge.log("sendWifiCredentials")
+    }
+
+    func forgetWifiNetwork(_ ssid: String) {
+        Bridge.log("forgetWifiNetwork: \(ssid)")
+    }
+
+    func sendHotspotState(_: Bool) {
+        Bridge.log("sendHotspotState")
+    }
+
+    func sendUserEmailToGlasses(_ email: String) {
+        Bridge.log("sendUserEmailToGlasses: \(email)")
+    }
+
+    func sendOtaStart() {
+        Bridge.log("sendOtaStart")
+    }
+
+    func sendOtaQueryStatus() {
+        Bridge.log("sendOtaQueryStatus")
+    }
+
+    // MARK: - Gallery
+
+    func queryGalleryStatus() {
+        Bridge.log("queryGalleryStatus")
+    }
+
+    func sendGalleryMode() {
+        Bridge.log("sendGalleryMode")
+    }
+
+    // MARK: - Version Info
+
+    func requestVersionInfo() {
+        Bridge.log("requestVersionInfo - not supported on Simulated")
+    }
+
+    func sendIncidentId(_: String, apiBaseUrl _: String?) {}
+}