@mentra/bluetooth-sdk 0.1.13 → 0.1.16

package/ios/Source/sgcs/SGCManager.swift

@@ -22,13 +22,13 @@ protocol SGCManager {
     func startStream(_ message: [String: Any])
     func stopStream()
     func sendStreamKeepAlive(_ message: [String: Any])
-    func startVideoRecording(requestId: String, save: Bool, flash: Bool, sound: Bool)
+    func startVideoRecording(requestId: String, save: Bool, sound: Bool)
     /// Start video recording with optional per-recording resolution/fps. A width,
     /// height, or fps of 0 means "use the device's saved button-video default".
     /// Defaulted in an extension to delegate to the basic recording path; devices
     /// that support custom settings (e.g. Mentra Live) override this.
     func startVideoRecording(
-        requestId: String, save: Bool, flash: Bool, sound: Bool, width: Int, height: Int, fps: Int,
+        requestId: String, save: Bool, sound: Bool, width: Int, height: Int, fps: Int,
         maxRecordingTimeMinutes: Int
     )
     func stopVideoRecording(requestId: String)
@@ -44,7 +44,6 @@ protocol SGCManager {
     func sendButtonPhotoSettings()
     func sendButtonVideoRecordingSettings()
     func sendButtonMaxRecordingTime()
-    func sendButtonCameraLedSetting()
     func sendCameraFovSetting()
 
     // MARK: - Display Control
@@ -57,6 +56,12 @@ protocol SGCManager {
     /// Display a bitmap. Optional `x`/`y`/`width`/`height` position and size the target
     /// container (used by G2; other SGCs ignore positioning and render the bitmap as before).
     func displayBitmap(base64ImageData: String, x: Int32?, y: Int32?, width: Int32?, height: Int32?) async -> Bool
+    /// Show text in a positioned container with an optional rounded border.
+    /// G2-only capability; default no-op (see protocol extension) so other glasses ignore it.
+    func sendPositionedText(
+        _ text: String, x: Int32, y: Int32, width: Int32, height: Int32,
+        borderWidth: Int32, borderRadius: Int32
+    ) async
     func showDashboard()
     func setDashboardPosition(_ height: Int, _ depth: Int)
     /// Default implementation sends both via [setDashboardPosition]; Nex overrides to one protobuf.
@@ -119,7 +124,6 @@ protocol SGCManager {
     func sendOtaStart(otaVersionUrl: String?)
     func sendOtaQueryStatus()
     func sendSetSystemTime(_ timestampMs: Int64)
-    func sendOtaRetryVersionCheck()
 
     // MARK: - User Context (for crash reporting)
 
@@ -146,13 +150,19 @@ protocol SGCManager {
 /// doesn't seem to work for concurrency reasons :(
 /// we can make read-only getters for convienence though:
 extension SGCManager {
+    /// Default: no-op. Only G2 renders positioned text containers; other glasses ignore it.
+    func sendPositionedText(
+        _: String, x _: Int32, y _: Int32, width _: Int32, height _: Int32,
+        borderWidth _: Int32, borderRadius _: Int32
+    ) async {}
+
     // MARK: - Video recording (default: ignore custom settings, use saved defaults)
 
     func startVideoRecording(
-        requestId: String, save: Bool, flash: Bool, sound: Bool, width _: Int, height _: Int,
+        requestId: String, save: Bool, sound: Bool, width _: Int, height _: Int,
         fps _: Int, maxRecordingTimeMinutes _: Int
     ) {
-        startVideoRecording(requestId: requestId, save: save, flash: flash, sound: sound)
+        startVideoRecording(requestId: requestId, save: save, sound: sound)
     }
 
     func stopVideoRecording(requestId: String, webhookUrl _: String?, authToken _: String?) {
@@ -202,10 +212,6 @@ extension SGCManager {
         Bridge.log("SGC: sendSetSystemTime not supported")
     }
 
-    func sendOtaRetryVersionCheck() {
-        Bridge.log("SGC: sendOtaRetryVersionCheck not supported")
-    }
-
     // MARK: - Default DeviceStore-backed property implementations
 
     var fullyBooted: Bool {

package/ios/Source/sgcs/Simulated.swift

@@ -80,7 +80,7 @@ class Simulated: SGCManager {
     // MARK: - Camera & Media
 
     func requestPhoto(_ request: PhotoRequest) {
-        Bridge.log("requestPhoto flash=\(request.flash) save=\(request.save) sound=\(request.sound)")
+        Bridge.log("requestPhoto save=\(request.save) sound=\(request.sound)")
     }
 
     func startStream(_: [String: Any]) {
@@ -95,7 +95,7 @@ class Simulated: SGCManager {
         Bridge.log("sendStreamKeepAlive")
     }
 
-    func startVideoRecording(requestId _: String, save _: Bool, flash _: Bool, sound _: Bool) {
+    func startVideoRecording(requestId _: String, save _: Bool, sound _: Bool) {
         Bridge.log("startVideoRecording")
     }
 
@@ -113,10 +113,6 @@ class Simulated: SGCManager {
         Bridge.log("sendButtonVideoRecordingSettings")
     }
 
-    func sendButtonCameraLedSetting() {
-        Bridge.log("sendButtonCameraLedSetting")
-    }
-
     func sendCameraFovSetting() {
         Bridge.log("sendCameraFovSetting")
     }

package/ios/Source/status/DeviceStatus.swift

@@ -552,10 +552,6 @@ struct BluetoothStatus: CustomStringConvertible {
         ButtonPhotoSize(rawValue: stringValue(values, "button_photo_size") ?? "") ?? .medium
     }
 
-    var buttonCameraLed: Bool {
-        boolValue(values, "button_camera_led") ?? true
-    }
-
     var buttonMaxRecordingTime: Int {
         intValue(values["button_max_recording_time"]) ?? 10
     }
@@ -924,10 +920,6 @@ struct BluetoothStatusUpdate: CustomStringConvertible {
         optionalStringValue(values, "button_photo_size").map { ButtonPhotoSize(normalizedRawValue: $0) }
     }
 
-    var buttonCameraLed: Bool? {
-        optionalBoolValue(values, "button_camera_led")
-    }
-
     var buttonMaxRecordingTime: Int? {
         optionalIntValue(values, "button_max_recording_time")
     }

package/ios/Source/streaming/StreamModels.swift

@@ -23,6 +23,7 @@ public struct StreamVideoConfig {
         if let width { values["width"] = width }
         if let height { values["height"] = height }
         if let bitrate { values["bitrate"] = bitrate }
+        // ASG stream parsers shipped with the BLE key named "frameRate".
         if let fps { values["frameRate"] = fps }
         return values
     }
@@ -219,31 +220,22 @@ public struct StreamResolvedConfig: Equatable {
 public struct StreamRequest {
     public let streamUrl: String
     public let streamId: String
-    public let keepAlive: Bool
-    public let keepAliveIntervalSeconds: Int
     public let sound: Bool
     public let video: StreamVideoConfig?
     public let audio: StreamAudioConfig?
-    public let extraValues: [String: Any]
 
     public init(
         streamUrl: String,
         streamId: String = "",
-        keepAlive: Bool = true,
-        keepAliveIntervalSeconds: Int = 5,
         sound: Bool = true,
         video: StreamVideoConfig? = nil,
-        audio: StreamAudioConfig? = nil,
-        extraValues: [String: Any] = [:]
+        audio: StreamAudioConfig? = nil
     ) {
         self.streamUrl = streamUrl
         self.streamId = streamId
-        self.keepAlive = keepAlive
-        self.keepAliveIntervalSeconds = keepAliveIntervalSeconds
         self.sound = sound
         self.video = video
         self.audio = audio
-        self.extraValues = extraValues
     }
 
     init(values: [String: Any]) {
@@ -254,25 +246,17 @@ public struct StreamRequest {
                 ?? values["whipUrl"] as? String
                 ?? "",
             streamId: values["streamId"] as? String ?? "",
-            keepAlive: values["keepAlive"] as? Bool ?? true,
-            keepAliveIntervalSeconds: intValue(values["keepAliveIntervalSeconds"]) ?? 5,
             sound: values["sound"] as? Bool ?? true,
             video: StreamVideoConfig(values: values["video"] as? [String: Any]),
-            audio: StreamAudioConfig(values: values["audio"] as? [String: Any]),
-            extraValues: values
+            audio: StreamAudioConfig(values: values["audio"] as? [String: Any])
         )
     }
 
     public var values: [String: Any] {
-        var values = extraValues
-        values.removeValue(forKey: "keepAliveMode")
+        var values: [String: Any] = [:]
         values["type"] = "start_stream"
         values["streamUrl"] = streamUrl
         values["streamId"] = streamId
-        values["keepAlive"] = keepAlive
-        values["keepAliveIntervalSeconds"] = keepAliveIntervalSeconds
-        // The camera light is a privacy indicator and cannot be disabled by SDK callers.
-        values["flash"] = true
         values["sound"] = sound
         if let videoValues = video?.dictionary, !videoValues.isEmpty {
             values["video"] = videoValues
@@ -284,33 +268,24 @@ public struct StreamRequest {
     }
 }
 
-extension StreamRequest {
-    var isExternallyManagedKeepAlive: Bool {
-        stringValue(extraValues, "keepAliveMode") == "external"
-    }
-}
-
 struct StreamKeepAliveRequest {
     let streamId: String
     let ackId: String
-    let extraValues: [String: Any]
 
-    init(streamId: String, ackId: String, extraValues: [String: Any] = [:]) {
+    init(streamId: String, ackId: String) {
         self.streamId = streamId
         self.ackId = ackId
-        self.extraValues = extraValues
     }
 
     init(values: [String: Any]) {
         self.init(
             streamId: values["streamId"] as? String ?? "",
-            ackId: values["ackId"] as? String ?? "",
-            extraValues: values
+            ackId: values["ackId"] as? String ?? ""
         )
     }
 
     var values: [String: Any] {
-        var values = extraValues
+        var values: [String: Any] = [:]
         values["type"] = "keep_stream_alive"
         values["streamId"] = streamId
         values["ackId"] = ackId

package/ios/Source/stt/STTTools.swift

@@ -7,7 +7,7 @@ class STTTools {
         // Send partial result to server witgetConnectedBluetoothNameh proper formatting
         let transcriptionLanguage =
             UserDefaults.standard.string(forKey: "STTModelLanguageCode") ?? "en-US"
-        Bridge.log("Mentra: Sending partial transcription: \(text), \(transcriptionLanguage)")
+        // Bridge.log("Mentra: Sending partial transcription: \(text), \(transcriptionLanguage)")
         let transcription: [String: Any] = [
             "type": "local_transcription",
             "text": transcriptionLanguage == "en-US" ? text.lowercased() : text,

package/ios/Source/types/DeviceModels.swift

@@ -18,6 +18,7 @@ public enum DeviceModel: String {
     case mach1
     case z100
     case frame
+    case nimo
     case simulated
     case r1
 
@@ -37,6 +38,8 @@ public enum DeviceModel: String {
             DeviceTypes.Z100
         case .frame:
             DeviceTypes.FRAME
+        case .nimo:
+            DeviceTypes.NIMO
         case .simulated:
             DeviceTypes.SIMULATED
         case .r1:
@@ -60,6 +63,8 @@ public enum DeviceModel: String {
             .z100
         case DeviceTypes.FRAME:
             .frame
+        case DeviceTypes.NIMO:
+            .nimo
         case DeviceTypes.SIMULATED:
             .simulated
         case ControllerTypes.R1:

package/ios/Source/utils/Constants.swift

@@ -7,6 +7,7 @@ struct DeviceTypes {
     static let Z100 = "Vuzix Z100"
     static let NEX = "Mentra Display"
     static let FRAME = "Brilliant Frame"
+    static let NIMO = "NIMO"
 
     static let ALL = [
         SIMULATED,
@@ -17,6 +18,7 @@ struct DeviceTypes {
         Z100,
         NEX,
         FRAME,
+        NIMO,
     ]
 
     /// Private init to prevent instantiation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "0.1.13",
+  "version": "0.1.16",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -12,6 +12,11 @@
       "react-native": "./src/index.ts",
       "default": "./build/index.js"
     },
+    "./internal": {
+      "types": "./build/_internal.d.ts",
+      "react-native": "./src/_internal.ts",
+      "default": "./build/_internal.js"
+    },
     "./react": {
       "types": "./build/react/index.d.ts",
       "react-native": "./src/react/index.ts",

package/src/BluetoothSdk.types.ts

@@ -270,6 +270,15 @@ export type PhotoStatusEvent = {
   errorMessage?: string
 }
 
+export type CameraStatusEvent = {
+  type: "camera_status"
+  requestId: string
+  state: "warming" | "ready" | "stopped" | "error" | string
+  timestamp: number
+  errorCode?: string
+  errorMessage?: string
+}
+
 export type VideoRecordingStatusEvent = {
   type: "video_recording_status"
   requestId?: string
@@ -310,9 +319,7 @@ export type VideoRecordingStoppedStatusEvent = Omit<VideoRecordingStatusEvent, "
   status: "recording_stopped"
 }
 
-export type VideoRecordingSuccessStatusEvent =
-  | VideoRecordingStartedStatusEvent
-  | VideoRecordingStoppedStatusEvent
+export type VideoRecordingSuccessStatusEvent = VideoRecordingStartedStatusEvent | VideoRecordingStoppedStatusEvent
 
 export type MediaUploadSuccessEvent = {
   type: "media_success"
@@ -396,9 +403,9 @@ export type SettingsAckSetting =
   | "gallery_mode"
   | "button_photo"
   | "button_video_recording"
-  | "button_camera_led"
   | "button_max_recording_time"
   | "camera_fov"
+  | "camera_tuning"
 
 export type SettingsAckEvent = {
   type: "settings_ack"
@@ -416,6 +423,10 @@ export type SettingsAckEvent = {
   fps?: number
   enabled?: boolean
   minutes?: number
+  /** ANR enabled flag; present when setting === "camera_tuning" */
+  anr?: boolean
+  /** Stock-gain flag; present when setting === "camera_tuning" */
+  gain?: boolean
   errorCode?: string
   errorMessage?: string
 }
@@ -431,8 +442,8 @@ export type RgbLedColor = "red" | "green" | "blue" | "orange" | "white"
 export type PhotoSize = "low" | "medium" | "high" | "max"
 export type ButtonPhotoSize = "low" | "medium" | "high" | "max"
 
-export type ButtonPhotoSettings = {
-  size: ButtonPhotoSize
+export type PhotoCaptureDefaults = {
+  size?: PhotoSize
   mfnr?: boolean
   zsl?: boolean
   noiseReduction?: boolean
@@ -448,9 +459,15 @@ export type ButtonPhotoSettings = {
 }
 export type PhotoCompression = "none" | "medium" | "heavy"
 
+export type VideoRecordingDefaults = {
+  width: number
+  height: number
+  fps: number
+}
+
 /**
  * Optional per-recording video settings for {@link startVideoRecording}. When
- * omitted, the glasses fall back to their saved button-video settings. Any
+ * omitted, the glasses fall back to their saved video recording defaults. Any
  * field left undefined is omitted from the BLE command (glasses default applies).
  */
 export interface VideoRecordingSettings {
@@ -473,6 +490,7 @@ export const DeviceModels = {
   Mach1: "Mentra Mach1",
   Z100: "Vuzix Z100",
   Frame: "Brilliant Frame",
+  Nimo: "NIMO",
   R1: "Even Realities R1",
 } as const
 
@@ -523,8 +541,7 @@ export type MicPreference = "auto" | "phone" | "glasses" | "bluetooth"
 export type MicMode = "phone" | "glasses" | "bluetoothClassic" | "bluetooth"
 
 export type PhotoRequestParams = {
-  requestId: string
-  appId: string
+  requestId?: string
   size: PhotoSize
   webhookUrl: string | null
   authToken: string | null
@@ -547,6 +564,13 @@ export type PhotoRequestParams = {
   ispAnalogGain?: string
 }
 
+export type WarmUpCameraParams = {
+  requestId?: string
+  size: PhotoSize
+  exposureTimeNs?: number | null
+  durationMs?: number
+}
+
 export type StreamVideoConfig = {
   width?: number
   height?: number
@@ -565,8 +589,6 @@ export type StreamStartRequest = {
   type?: "start_stream"
   streamUrl: string
   streamId?: string
-  keepAlive?: boolean
-  keepAliveIntervalSeconds?: number
   sound?: boolean
   video?: StreamVideoConfig
   audio?: StreamAudioConfig
@@ -722,15 +744,6 @@ export type MtkUpdateCompleteEvent = {
   timestamp: number
 }
 
-export type OtaUpdateAvailableEvent = {
-  type: "ota_update_available"
-  version_code?: number
-  version_name?: string
-  updates?: string[]
-  total_size?: number
-  cache_ready?: boolean
-}
-
 /** @deprecated Glasses no longer emit ota_progress; use {@link OtaStatusEvent} and status-store mapping. */
 export type OtaProgressEvent = {
   type: "ota_progress"
@@ -761,7 +774,7 @@ export type OtaStatusEvent = {
   error_message?: string
 }
 
-export type OtaQueryResult = OtaUpdateAvailableEvent | OtaStatusEvent
+export type OtaQueryResult = OtaStatusEvent
 
 /** Nex BLE protobuf trace (NexEventUtils); payload matches native Map keys. */
 export type BleCommandTraceEvent = {
@@ -800,6 +813,7 @@ export type BluetoothSdkModuleEvents = {
   hotspot_error: (event: HotspotErrorEvent) => void
   photo_response: (event: PhotoResponseEvent) => void
   photo_status: (event: PhotoStatusEvent) => void
+  camera_status: (event: CameraStatusEvent) => void
   video_recording_status: (event: VideoRecordingStatusEvent) => void
   media_success: (event: MediaUploadSuccessEvent) => void
   media_error: (event: MediaUploadErrorEvent) => void
@@ -823,7 +837,6 @@ export type BluetoothSdkModuleEvents = {
   stream_status: (event: StreamStatusEvent) => void
   keep_alive_ack: (event: KeepAliveAckEvent) => void
   mtk_update_complete: (event: MtkUpdateCompleteEvent) => void
-  ota_update_available: (event: OtaUpdateAvailableEvent) => void
   ota_start_ack: (event: OtaStartAckEvent) => void
   ota_status: (event: OtaStatusEvent) => void
   version_info: (event: VersionInfoEvent) => void
@@ -877,6 +890,7 @@ export type BluetoothSdkEventMap = {
   hotspot_error: HotspotErrorEvent
   photo_response: PhotoResponseEvent
   photo_status: PhotoStatusEvent
+  camera_status: CameraStatusEvent
   video_recording_status: VideoRecordingStatusEvent
   media_success: MediaUploadSuccessEvent
   media_error: MediaUploadErrorEvent
@@ -946,13 +960,27 @@ export interface BluetoothSdkPublicModule {
 
   setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>
-  setButtonPhotoSettings(settings: ButtonPhotoSettings): Promise<SettingsAckSuccessEvent>
-  setButtonVideoRecordingSettings(width: number, height: number, fps: number): Promise<SettingsAckSuccessEvent>
-  setButtonCameraLed(enabled: boolean): Promise<SettingsAckSuccessEvent>
-  setButtonMaxRecordingTime(minutes: number): Promise<SettingsAckSuccessEvent>
+  setPhotoCaptureDefaults(settings: PhotoCaptureDefaults): Promise<SettingsAckSuccessEvent>
+  setVideoRecordingDefaults(settings: VideoRecordingDefaults): Promise<SettingsAckSuccessEvent>
+  setMaxVideoRecordingDuration(minutes: number): Promise<SettingsAckSuccessEvent>
   setCameraFov(request: CameraFovRequest): Promise<CameraFovResult>
+  /**
+   * Configure camera HAL tuning (ANR / gain) on Mentra Live glasses.
+   *
+   * The phone sends a {@code camera_tuning_config} BLE command; the glasses relay it as a
+   * {@code camconfig} broadcast to the camera HAL so parameters take effect without a reboot.
+   *
+   * **Scan-mode convention**: call with `(false, false)` when activating scan mode to disable ANR
+   * and pixsmart gain for sharper text/barcode captures. Call with `(true, true)` to restore
+   * defaults when exiting scan mode.
+   *
+   * @param anrOn  `true` = ANR enabled (default), `false` = ANR disabled
+   * @param gainOn `true` = stock gain params (default), `false` = pixsmart gain-off params
+   */
+  setCameraTuningConfig(anrOn: boolean, gainOn: boolean): Promise<SettingsAckSuccessEvent>
   queryGalleryStatus(): Promise<GalleryStatusEvent>
   requestPhoto(params: PhotoRequestParams): Promise<PhotoSuccessResponseEvent>
+  warmUpCamera(params: WarmUpCameraParams): Promise<CameraStatusEvent>
   startVideoRecording(
     requestId: string,
     save: boolean,
@@ -1057,7 +1085,6 @@ export interface OtaUpdateInfo {
   versionName: string
   updates: string[] // ["apk", "mtk", "bes"]
   totalSize: number
-  cacheReady?: boolean
 }
 
 export interface OtaProgress {
@@ -1237,7 +1264,6 @@ export type BluetoothSettingsUpdate = Partial<{
   button_video_width: number
   button_video_height: number
   button_video_fps: number
-  button_camera_led: boolean
   button_max_recording_time: number
   camera_fov: NativeCameraFovSetting
   should_send_pcm: boolean

package/src/_internal.ts

@@ -1,10 +1,10 @@
 /**
  * MentraOS-only compatibility entrypoint.
  *
- * Apps should import from `@mentra/bluetooth-sdk`. This file is not a
- * package export; MentraOS resolves it through its local
- * `@mentra/bluetooth-sdk-internal` alias while the app is migrated onto the
- * public SDK surface.
+ * Apps should import from `@mentra/bluetooth-sdk`. This is exported as
+ * `@mentra/bluetooth-sdk/internal` only for MentraOS packages that still need
+ * the compatibility surface while the app is migrated onto the public SDK
+ * surface.
  */
 export {default} from "./_private/BluetoothSdkModule"
 export type {BluetoothSdkInternalModule} from "./_private/BluetoothSdkModule"

package/src/_private/BluetoothSdkModule.ts

@@ -4,7 +4,7 @@ import {
   BluetoothSettingsUpdate,
   BluetoothSdkModuleEvents,
   BluetoothStatus,
-  ButtonPhotoSettings,
+  PhotoCaptureDefaults,
   CalendarEvent,
   CAMERA_FOV_DEFAULT,
   CAMERA_FOV_MAX,
@@ -14,6 +14,7 @@ import {
   CameraFovResult,
   CameraFovSetting,
   CameraRoiPosition,
+  CameraStatusEvent,
   ConnectOptions,
   DashboardMenuItem,
   Device,
@@ -43,9 +44,11 @@ import {
   VideoRecordingSettings,
   VideoRecordingStoppedStatusEvent,
   VersionInfoResult,
+  WarmUpCameraParams,
   WifiSearchResult,
   WifiStatusChangeEvent,
 } from "../BluetoothSdk.types"
+import {warmUpCameraParamsForNative} from "./cameraRequestPayload"
 import {photoRequestParamsForNative} from "./photoRequestPayload"
 
 /**
@@ -121,14 +124,22 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   // Gallery Commands
   setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>
-  setButtonPhotoSettings(settings: ButtonPhotoSettings): Promise<SettingsAckSuccessEvent>
-  setButtonPhotoCaptureSettings(settings: ButtonPhotoSettings): Promise<SettingsAckSuccessEvent>
-  setButtonVideoRecordingSettings(width: number, height: number, fps: number): Promise<SettingsAckSuccessEvent>
-  setButtonCameraLed(enabled: boolean): Promise<SettingsAckSuccessEvent>
-  setButtonMaxRecordingTime(minutes: number): Promise<SettingsAckSuccessEvent>
+  setPhotoCaptureDefaults(settings: PhotoCaptureDefaults): Promise<SettingsAckSuccessEvent>
+  setVideoRecordingDefaults(width: number, height: number, fps: number): Promise<SettingsAckSuccessEvent>
+  setMaxVideoRecordingDuration(minutes: number): Promise<SettingsAckSuccessEvent>
   setCameraFov(request: CameraFovRequest): Promise<CameraFovResult>
+  /**
+   * Configure camera HAL tuning (ANR / gain) on Mentra Live glasses.
+   * Sends a {@code camera_tuning_config} BLE message; the ASG client relays it as a
+   * {@code camconfig} broadcast so the HAL picks up new parameters without a reboot.
+   *
+   * Scan-mode convention: pass `{anr: false, gain: false}` when activating scan mode
+   * (disables ANR and pixsmart gain) and `{anr: true, gain: true}` to restore defaults.
+   */
+  setCameraTuningConfig(anrOn: boolean, gainOn: boolean): Promise<SettingsAckSuccessEvent>
   queryGalleryStatus(): Promise<GalleryStatusEvent>
   requestPhoto(params: PhotoRequestParams): Promise<PhotoSuccessResponseEvent>
+  warmUpCamera(params: WarmUpCameraParams): Promise<CameraStatusEvent>
 
   // OTA Commands
   setOtaVersionUrl(otaVersionUrl: string): void
@@ -136,8 +147,6 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   checkForOtaUpdate(): Promise<boolean>
   startOtaUpdate(otaVersionUrl?: string | null): Promise<OtaStartAckEvent>
   sendOtaQueryStatus(): Promise<OtaQueryResult>
-  /** Re-run glasses-side OTA version check (called after a clock fix invalidates a TLS failure). */
-  retryOtaVersionCheck(): Promise<OtaQueryResult>
 
   // Version Info Commands
   requestVersionInfo(): Promise<VersionInfoResult>
@@ -568,9 +577,9 @@ NativeBluetoothSdkModule.requestPhoto = function (params: PhotoRequestParams) {
   return nativeRequestPhoto(photoRequestParamsForNative(params) as unknown as PhotoRequestParams)
 }
 
-const nativeStartStream = NativeBluetoothSdkModule.startStream.bind(NativeBluetoothSdkModule)
-NativeBluetoothSdkModule.startExternallyManagedStream = function (params: StreamStartRequest) {
-  return nativeStartStream({...params, keepAliveMode: "external"} as StreamStartRequest)
+const nativeWarmUpCamera = NativeBluetoothSdkModule.warmUpCamera.bind(NativeBluetoothSdkModule)
+NativeBluetoothSdkModule.warmUpCamera = function (params: WarmUpCameraParams) {
+  return nativeWarmUpCamera(warmUpCameraParamsForNative(params) as unknown as WarmUpCameraParams)
 }
 
 export default NativeBluetoothSdkModule

package/src/_private/cameraRequestPayload.ts

@@ -0,0 +1,29 @@
+import type {WarmUpCameraParams} from "../BluetoothSdk.types"
+import {normalizePhotoSizeTier} from "./photoRequestPayload"
+
+function nonBlankString(value?: string | null): string | undefined {
+  const trimmed = value?.trim()
+  return trimmed && trimmed.length > 0 ? trimmed : undefined
+}
+
+/** Expo Android bridge rejects null values in Map<String, Any> — omit optional nullish fields. */
+export function warmUpCameraParamsForNative(
+  params: WarmUpCameraParams,
+): Record<string, string | number> {
+  const payload: Record<string, string | number> = {
+    size: normalizePhotoSizeTier(params.size),
+  }
+  const requestId = nonBlankString(params.requestId)
+  if (requestId != null) {
+    payload.requestId = requestId
+  }
+  const exposureTimeNs = params.exposureTimeNs
+  if (exposureTimeNs != null && Number.isFinite(exposureTimeNs) && exposureTimeNs > 0) {
+    payload.exposureTimeNs = exposureTimeNs
+  }
+  const durationMs = params.durationMs
+  if (durationMs != null && Number.isFinite(durationMs) && durationMs > 0) {
+    payload.durationMs = Math.round(durationMs)
+  }
+  return payload
+}

package/src/_private/photoRequestPayload.ts

@@ -19,19 +19,28 @@ export function normalizePhotoSizeTier(size: string | undefined): PhotoSize {
   }
 }
 
+function nonBlankString(value?: string | null): string | undefined {
+  const trimmed = value?.trim()
+  return trimmed && trimmed.length > 0 ? trimmed : undefined
+}
+
 /** Expo Android bridge rejects null values in Map<String, Any> — omit optional nullish fields. */
 export function photoRequestParamsForNative(
   params: PhotoRequestParams,
 ): Record<string, string | number | boolean> {
   const payload: Record<string, string | number | boolean> = {
-    requestId: params.requestId,
-    appId: params.appId,
     size: normalizePhotoSizeTier(params.size),
     webhookUrl: params.webhookUrl ?? "",
     compress: params.compress,
-    flash: true,
     sound: params.sound,
   }
+  const requestId = nonBlankString(params.requestId)
+  if (requestId != null) {
+    payload.requestId = requestId
+  }
+  if (params.save != null) {
+    payload.save = params.save
+  }
   if (params.authToken != null && params.authToken.length > 0) {
     payload.authToken = params.authToken
   }