Debugging

Name: Debugging
Author: facebook

facebook/meta-wearables-dat-ios

5 installs
500 repo stars
Updated August 3, 2026
facebook/meta-wearables-dat-ios

Diagnoses common DAT SDK iOS setup, registration, and streaming issues covering Developer Mode, registration state, and device connectivity.

About

Provides a diagnostic flow for common DAT SDK iOS problems such as a device not connecting. iOS developers use it to check Developer Mode, registration state, Bluetooth range, and the streaming state machine.

Decision-tree diagnosis for connection issues
Covers Developer Mode, registration, and state machine

Debugging by the numbers

5 all-time installs (skills.sh)
Ranked #828 of 1,039 Mobile Development skills by installs in the Skillselion catalog
Data as of Aug 4, 2026 (Skillselion catalog sync)

npx skills add https://github.com/facebook/meta-wearables-dat-ios --skill debugging

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/facebook/meta-wearables-dat-ios/debugging.svg)](https://skillselion.com/skills/facebook/meta-wearables-dat-ios/debugging)

Installs	5
repo stars	★ 500
Last updated	August 3, 2026
Repository	facebook/meta-wearables-dat-ios ↗

What it does

Diagnoses common DAT SDK iOS setup, registration, and streaming issues covering Developer Mode, registration state, and device connectivity.

Files

SKILL.mdMarkdownGitHub ↗

Debugging (iOS)

Diagnose common setup, registration, and streaming issues in DAT SDK integrations.

Quick diagnosis

Device not connecting?
│
├── Is Developer Mode enabled? → Enable in Meta AI app settings
│
├── Is device registered? → Check registration state
│
├── Is device in range? → Bluetooth on, glasses powered on
│
├── Is the app registered? → Check registrationStateStream()
│
└── Stream stuck in waitingForDevice? → Check device availability

Developer Mode

Developer Mode must be enabled for 3P apps to access device features.

Enabling Developer Mode

1. Open Meta AI app on phone 2. Go to Settings → (Your connected glasses) 3. Find "Developer Mode" toggle 4. Toggle ON 5. Device may restart

Symptoms of Developer Mode disabled

Registration completes but device never connects
Stream stuck in waitingForDevice
Permission requests fail or never appear

Watch for

Developer Mode toggles off after firmware updates — re-enable it
Developer Mode is per-device — enable for each glasses pair
Some features need additional permissions beyond Developer Mode

Stream state issues

Expected flow

stopped → waitingForDevice → starting → streaming → stopped

Stuck in waitingForDevice

Device not in range or not connected
Device not reporting availability
DeviceSelector not matching any device

Unexpected stop

Device disconnected (out of range, battery died)
Channel closed by device
Error in frame processing

Version compatibility

Ensure compatible versions of SDK, Meta AI app, and glasses firmware. See version dependencies for the current compatibility matrix.

Known issues

Issue	Workaround
No internet → registration fails	Internet required for registration
Streams started with glasses doffed pause when donned	Unpause by tapping side of glasses
[iOS] Meta Ray-Ban Display: no audio feedback on pause/resume	Will be fixed in future release

Adding debug logging

import os

private let logger = Logger(subsystem: "com.yourapp", category: "Wearables")

// In your streaming code:
logger.debug("Stream state changed to: \(state)")
logger.error("Stream error: \(error)")