Skip to content

docs: add notification, gesture, and navigation protocol documentation#2

Open
BBBradyH wants to merge 1 commit intoi-soxi:mainfrom
BBBradyH:docs/notification-gesture-navigation
Open

docs: add notification, gesture, and navigation protocol documentation#2
BBBradyH wants to merge 1 commit intoi-soxi:mainfrom
BBBradyH:docs/notification-gesture-navigation

Conversation

@BBBradyH
Copy link
Copy Markdown

@BBBradyH BBBradyH commented Jan 8, 2026

Summary

This PR adds comprehensive documentation for three protocol areas based on packet captures from Even G2 A glasses:

  • Notifications (docs/notifications.md): Full notification format on Handle 0x0021
  • Gestures (docs/gestures.md): Tap, swipe, and long press callback detection
  • Navigation (docs/navigation.md): Turn-by-turn navigation on Service 0x0820

Details

Notifications

  • Complete field structure: title, subtitle, body, timestamp, action buttons
  • App bundle ID and display name resolution
  • Real examples: phone calls, missed calls, Life360 location updates
  • Python and Swift parsing implementations

Gestures

  • Tap detection (note: single/double tap indistinguishable at protocol level)
  • Swipe forward (1204 0801) and backward (1204 0802) patterns
  • Long press on Service 0x0D01
  • Pattern matching algorithms for detection

Navigation

  • Full protobuf field mapping (distance, instruction, ETA, speed, icon type)
  • Packet building examples for custom navigation
  • Dashboard widget format

Capture Method

  • iPhone with iOS Bluetooth logging profile
  • Apple PacketLogger on macOS
  • Even G2 A glasses (firmware 2.0.1.142)
  • January 2026

Test plan

  • Documentation follows existing repo style
  • Code examples compile (Python/Swift)
  • Real packet examples included and verified

New documentation based on packet captures from Even G2 A glasses:

- notifications.md: Full notification format on Handle 0x0021 including
  title, subtitle, body, timestamp, and action buttons. Includes parsing
  examples in Python and Swift.

- gestures.md: Gesture callback detection for tap, swipe forward/backward,
  and long press. Documents that single/double tap are indistinguishable
  at protocol level.

- navigation.md: Turn-by-turn navigation on Service 0x0820 with full
  protobuf field mapping for distance, instruction, ETA, speed, and
  maneuver icons.

Captured using iOS Bluetooth logging profile and Apple PacketLogger.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant