debugging

Diagnose Meta Wearables DAT iOS integration failures in device connection and streaming states.

506|113|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/facebook/meta-wearables-dat-ios --skill debugging-facebook
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging
Source: https://github.com/facebook/meta-wearables-dat-ios/tree/main/plugins/mwdat-ios/skills/debugging
Command: npx skills add https://github.com/facebook/meta-wearables-dat-ios --skill debugging-facebook

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you troubleshoot why Meta Wearables Device Access Toolkit (DAT) integrations fail to connect, register, or stream by walking you through the most common setup and state-machine issues.

Core Features & Use Cases

  • Developer Mode validation: Confirms whether Developer Mode is enabled and explains typical failure symptoms when it is not.
  • Stream state diagnosis: Identifies where streaming gets stuck (especially waitingForDevice) and what to check in response.
  • Compatibility and known-issue guidance: Verifies SDK/app/firmware version compatibility and provides targeted workarounds for frequent issues.
  • Debug logging checklist: Shows how to add logging and what operational checks to perform (Bluetooth, registration state, URL scheme, background modes) to isolate root causes.

Quick Start

Ask an AI to “help me debug a DAT iOS integration where the stream is stuck in waitingForDevice by using the Developer Mode and stream-state checklist for iOS.”

Frequently Asked Questions about debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why is my Meta glasses iOS streaming connection stuck in the waitingForDevice state?

A stream stuck in waitingForDevice usually indicates Developer Mode is disabled, the glasses are out of Bluetooth range, or the app registrationStateStream failed to transition properly. Verify Developer Mode configuration and device availability to isolate the iOS connectivity issue.

How do I validate the streaming state machine flow for Meta Wearables DAT on iOS?

Validate the DAT streaming state machine by confirming the iOS integration follows the expected stopped→waitingForDevice→starting→streaming→stopped state flow. Check DeviceSelector matching and verify glasses firmware and SDK version compatibility.

Do I need Developer Mode enabled to use the Meta Wearables Device Access Toolkit on iOS?

Yes, Developer Mode must be enabled for DAT iOS integration. When Developer Mode is disabled, typical failure symptoms include the device failing to register or the streaming state machine getting stuck before reaching the starting phase.

How do I debug Bluetooth and registration issues with Meta glasses on iOS?

Add debug logging to verify Bluetooth connectivity, app registrationStateStream issues, URL scheme configuration, and background modes. This operational checklist helps isolate root causes for Device Access Toolkit iOS connection failures.

What should I check when Meta glasses fail to connect or stream via the iOS SDK?

When glasses fail to connect or stream, check the SDK, Meta AI app, and glasses firmware version compatibility. Also verify device availability conditions are met and DeviceSelector matching is configured correctly for the iOS environment.