Doorbell Audio Operator Workflow

Scope

• Bridge branch: codex/sentinel-rubi-bridge-v4-pro
• Runtime: savant_network_sentinel_clean_rubi_bridge_v4_0_pro.rb
• App branch expected: codex/sentinel-pro-baseline

Supported Endpoints

• GET /api/v1/tools/doorbell/status
• GET /api/v1/tools/doorbell/sample-audio?sample_id=...
• POST /api/v1/tools/doorbell/apply-sample
• POST /api/v1/tools/doorbell/upload

Operator Flow

1. Open Sentinel Pro and connect to the target home.
2. Open Tools and launch Doorbell Audio.
3. Press Refresh to read active reference path and expected WAV format.
4. Preview bundled samples with Play.
5. Apply a bundled sound with Apply, or upload a custom WAV.
6. If required by host, provide sudo password before applying changes.
7. Confirm bridge response and verify service reload status.
8. If reload is unavailable, follow soft reboot recommendation.

Custom WAV Rules

Custom WAV files must match active Savant reference for:

• Codec and audio format
• Channel count
• Sample rate
• Bit depth
• Frame duration

If any field differs, the bridge returns doorbell_audio_mismatch with explicit mismatch details.

Typical Errors and Meaning

• invalid_wav_file: uploaded file is not a supported WAV payload.
• doorbell_reference_not_found: active config has no valid doorbell reference.
• sudo_password_required: host patch path requires elevated privileges.
• sample_not_found: requested sample id does not exist.
• sample_file_missing: sample metadata exists but file is absent on host.
• sample_preview_exception: sample audio could not be streamed for preview.

Validation Checklist

• Verify /api/v1/tools/doorbell/status returns reference_audio.
• Verify at least one sample_sounds entry is available: true.
• Confirm sample preview audio can be fetched from sample-audio.
• Apply one bundled sample and confirm successful response.
• Upload one known-good WAV and verify no compatibility mismatches.