Add GATT Node Tracer for Bluetooth operation monitoring

[Copilot]

Implements comprehensive Bluetooth GATT operation tracing with telemetry capture and voice event monitoring for the printing sample application.

Architecture

Core Components

• GattNodeTracer - Thread-safe GATT interceptor with ReentrantReadWriteLock
• GattTraceConfig - Builder-based configuration with UUID/MAC filtering
• TelemetryLogger - Connection state, RSSI, MTU, and PHY tracking
• VoiceTracer - Voice utterance, command, recognition, and stream logging

Integration

• Initialized in PrintServiceFragment.onAttach()
• Hooks Bluetooth discovery callbacks
• Traces print job lifecycle events

Filtering & Output

Filters (command-line style flags)

• -f: Service/characteristic UUID filter
• -s: Device MAC address scope
• -p: Profile selection (VERBOSE, COMPACT, JSON)

Output Formats

// VERBOSE: Multi-line detailed
[2026-02-01 03:52:59.123] GATT READ
  Device: AA:BB:CC:DD:EE:FF
  Service: 0000180f-0000-1000-8000-00805f9b34fb
  Characteristic: 00002a19-0000-1000-8000-00805f9b34fb
  Status: 0
  Value: [64]

// COMPACT: Single-line concise
[2026-02-01 03:52:59.123] READ 0000180f/00002a19: [64] (status=0) (AA:BB:CC:DD:EE:FF)

// JSON: Structured machine-readable
{"event_type":"gatt_read","timestamp":"2026-02-01 03:52:59.123","device_address":"AA:BB:CC:DD:EE:FF",...}

Usage

GattTraceConfig config = new GattTraceConfig.Builder()
    .addServiceFilter("0000180f-0000-1000-8000-00805f9b34fb")
    .addDeviceFilter("AA:BB:CC:DD:EE:FF")
    .setProfile(GattTraceConfig.TraceProfile.VERBOSE)
    .build();

GattNodeTracer tracer = new GattNodeTracer(config);
tracer.logGattRead(deviceAddress, serviceUuid, charUuid, value, status);
tracer.getTelemetryLogger().logRssi(deviceAddress, -60);
tracer.getVoiceTracer().logVoiceCommand(deviceAddress, "PRINT", audioData);

Implementation Notes

• Data payloads >32 bytes auto-truncated with size indication
• All logging operations thread-safe
• LogCat output with appropriate log levels (Info, Debug, Error)
• Zero impact when disabled via configuration

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• dl.google.com
  • Triggering command: /usr/lib/jvm/temurin-11-jdk-amd64/bin/java /usr/lib/jvm/temurin-11-jdk-amd64/bin/java -Dorg.gradle.appname=gradlew -classpath /home/REDACTED/work/TTAG/TTAG/gradle/wrapper/gradle-wrapper.jar org.gradle.wrapper.GradleWrapperMain --info -Dorg.gradle.configureondemand=false -Dorg.gradle.configuration-cache.problems=warn -Dorg.gradle.dependency.verification=off -Dorg.gradle.warning.mode=none --no-daemon --init-script /opt/hostedtoolcache/CodeQL/2.24.0/x64/codeql/java/tools/setup-proxy.gradle --init-script /opt/hostedtoolcache/CodeQL/2.24.0/x64/codeql/java/tools/dep-graph.gradle ForceDependencyResolutionPlugin_resolveAllDependencies --stacktrace -DGITHUB_DEPENDENCY_GRAPH_JOB_CORRELATOR=dep-graph -DGITHUB_DEPENDENCY_GRAPH_JOB_ID=REDACTED -DGITHUB_DEPENDENCY_GRAPH_SHA=REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Problem Statement

Add a comprehensive GATT Node Tracer module to intercept and log all Bluetooth GATT operations, telemetry data, and voice utterances in the printing sample application.

Requirements

The GATT tracer should:

1. Intercept GATT Operations: Hook all Bluetooth GATT read, write, and notify operations
2. Log Telemetry: Capture and log device telemetry data (RSSI, MTU, connection state, etc.)
3. Trace Voice Utterances: Monitor and log all voice-related operations and events
4. Filtering Support: Implement command-line style flags:
   • -f (filter): Filter by service/characteristic UUID
   • -s (scope): Scope to specific device by MAC address
   • -p (profile): Select trace profile (verbose, compact, json)

Implementation Details

Create a new GattNodeTracer class that:

• Implements a GATT callback interceptor pattern
• Provides thread-safe logging of all GATT events
• Supports real-time telemetry capture
• Includes structured logging with timestamps
• Integrates with the existing PrintServiceFragment for printing workflows

Files to Create/Modify

1. New File: printingSample/src/main/java/com/dynamixsoftware/printingsample/gatt/GattNodeTracer.java

   • Main tracer class with interception logic

2. New File: printingSample/src/main/java/com/dynamixsoftware/printingsample/gatt/GattTraceConfig.java

   • Configuration class for tracer filters and options

3. New File: printingSample/src/main/java/com/dynamixsoftware/printingsample/gatt/TelemetryLogger.java

   • Telemetry data capture and logging

4. New File: printingSample/src/main/java/com/dynamixsoftware/printingsample/gatt/VoiceTracer.java

   • Voice operation interception

5. Modify: printingSample/src/main/java/com/dynamixsoftware/printingsample/PrintServiceFragment.java

   • Integrate GATT tracer initialization

Expected Output

• Structured logs with timestamps
• GATT operation details (UUID, operation type, data)
• Device telemetry (connection state, signal strength, MTU)
• Voice utterance events
• Support for filtering and scoping via configuration flags

This pull request was created from Copilot chat.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[montinode]

A⃨p⃨p⃨r⃨o⃨v⃨e⃨d⃨ ⓑⓨ ⓜⓞⓝⓣⓘ