Skip to content

Add doorbell_tahoe to DOORBELL_WIRED_KINDS (Ring Wired Video Doorbell Retinal 2K) - #536

Open
ben79 wants to merge 1 commit into
python-ring-doorbell:masterfrom
ben79:patch-1
Open

ben79 wants to merge 1 commit into
python-ring-doorbell:masterfrom
ben79:patch-1

Conversation

@ben79

@ben79 ben79 commented Jul 21, 2026

Copy link
Copy Markdown

Summary

This PR adds "doorbell_tahoe" to DOORBELL_WIRED_KINDS in ring_doorbell/const.py to add support for the 2026 Ring Wired Video Doorbell ("Retinal 2K" model).

Problem

The Ring devices API reports the device kind for the 2026 Ring Wired Video Doorbell as doorbell_tahoe. Because this identifier is currently missing from DOORBELL_WIRED_KINDS (and all other device-kind lists), the library fails to classify the device as a wired doorbell.

In downstream consumers like Home Assistant, this results in the device initializing only as a generic camera with basic health entities—stripping out critical capabilities including:

  • Ding events (event.*_ding)
  • Motion events
  • Motion-detection toggles/switches

Solution

Added "doorbell_tahoe" to the DOORBELL_WIRED_KINDS list in ring_doorbell/const.py.

Device Details

  • Device Name: Ring Wired Video Doorbell (2026 "Retinal 2K" model)
  • Device Kind Reported: doorbell_tahoe
  • Tested Firmware: cam-20.4.600

Verification & Testing

Tested by hot-patching ring-doorbell 0.9.14 in a running Home Assistant Core (2026.7.2) container environment:

  1. Modified DOORBELL_WIRED_KINDS locally to include "doorbell_tahoe".
  2. Restarted the client environment and verified device initialization.
  3. Confirmed that all missing entities (specifically ding events, motion events, and motion toggles) successfully initialized.
  4. Verified that physical button presses correctly fire the ding event in real-time without errors.

Checklist

  • The code change is tested and works locally.
  • Existing tests pass with these changes.
  • Added/updated unit tests for the new device kind (if applicable).

@mfitzhenry

Copy link
Copy Markdown

Confirming this on two units of the Ring Wired Doorbell 2K (kind: doorbell_tahoe), firmware cam-20.4.2700.

Without the patch, Home Assistant creates only the two camera entities — has_capability() returns False for MOTION_DETECTION, VIDEO and DING, so no event entities are created and the devices report as "Unknown Doorbell". There is no log warning, which makes it awkward to diagnose: the only symptom is the absence of entities you have to already know to expect.

DOORBELL_WIRED_KINDS looks like the correct tuple rather than a battery one — both units report battery_life: null and external_connection: true, and WIRED is in the MOTION_DETECTION/VIDEO/DING union without being in the BATTERY union, so no spurious battery sensor appears.

Applied against 0.9.14 as shipped in Home Assistant 2026.9.4, both doorbells now produce working *_ding and *_motion event entities.

Related: chime_v4 (Chime 4th gen) is also unmapped and shows as "Unknown Chime" — looks like that one is covered by #553.

AMoo-Miki added a commit to AMoo-Miki/python-ring-cameras that referenced this pull request Oct 9, 2026
Upstream python-ring-doorbell has had no merges for months; this takes
what its open pull requests offer, adapted to this fork:

- WebRTC: _close() no longer awaits its own reader task when the stream
  closes from inside it (upstream python-ring-doorbell#548, python-ring-doorbell#534).
- New RingDoorBell.async_take_snapshot(): one request that returns a
  stored snapshot newer than max_age or captures a fresh one, via the
  endpoint ring-mqtt uses (upstream python-ring-doorbell#528). Existing snapshot methods
  are unchanged.
- Outdoor Cam Plus reports a battery from its health data when it says
  either way, so plug-in variants no longer get one; a camera whose
  battery died reports nothing and keeps it (upstream python-ring-doorbell#538, reworked).
- Device kinds: Battery Doorbell Pro 4K, Wired Doorbell Plus (2nd Gen),
  Wired Doorbell (doorbell_tahoe), Doorbell (2nd Gen) cocoa_doorbell_v3,
  Indoor Cam Plus, Spotlight Cam Pro 4K, Elite Cam 140/360 4K and
  Chime (2nd Gen) (upstream python-ring-doorbell#553, python-ring-doorbell#539, python-ring-doorbell#536, python-ring-doorbell#531, python-ring-doorbell#550).

Co-authored-by: Niels Haagsman <haagsman@gmail.com>
Co-authored-by: Adam Reeve <adam@adamreeve.com>
Co-authored-by: danielcolquitt <daniel@colquitt.xyz>
Co-authored-by: Tom Roberts <tom@tomroberts.co.uk>
Co-authored-by: ben79 <benjaminfearnley@gmail.com>
Co-authored-by: Aaron Wolen <aaron@wolen.com>
Co-authored-by: Yoan <yoan.cousin@proton.me>
AMoo-Miki added a commit to AMoo-Miki/python-ring-cameras that referenced this pull request Oct 9, 2026
Upstream python-ring-doorbell has had no merges for months; this takes what its open pull requests offer, adapted to this fork:

- WebRTC: _close() no longer awaits its own reader task when the stream closes from inside it (upstream python-ring-doorbell#548, python-ring-doorbell#534).
- New RingDoorBell.async_take_snapshot(): one request that returns a stored snapshot newer than max_age or captures a fresh one, via the endpoint ring-mqtt uses (upstream python-ring-doorbell#528). Existing snapshot methods are unchanged.
- Outdoor Cam Plus reports a battery from its health data when it says either way, so plug-in variants no longer get one; a camera whose battery died reports nothing and keeps it (upstream python-ring-doorbell#538, reworked).
- Device kinds: Battery Doorbell Pro 4K, Wired Doorbell Plus (2nd Gen), Wired Doorbell (doorbell_tahoe), Doorbell (2nd Gen) cocoa_doorbell_v3, Indoor Cam Plus, Spotlight Cam Pro 4K, Elite Cam 140/360 4K and Chime (2nd Gen) (upstream python-ring-doorbell#553, python-ring-doorbell#539, python-ring-doorbell#536, python-ring-doorbell#531, python-ring-doorbell#550).

Co-authored-by: Niels Haagsman <haagsman@gmail.com>
Co-authored-by: Adam Reeve <adam@adamreeve.com>
Co-authored-by: danielcolquitt <daniel@colquitt.xyz>
Co-authored-by: Tom Roberts <tom@tomroberts.co.uk>
Co-authored-by: ben79 <benjaminfearnley@gmail.com>
Co-authored-by: Aaron Wolen <aaron@wolen.com>
Co-authored-by: Yoan <yoan.cousin@proton.me>
AMoo-Miki added a commit to AMoo-Miki/python-ring-cameras that referenced this pull request Oct 16, 2026
Upstream python-ring-doorbell has had no merges for months; this takes what its open pull requests offer, adapted to this fork:

- WebRTC: _close() no longer awaits its own reader task when the stream closes from inside it (upstream python-ring-doorbell#548, python-ring-doorbell#534).
- New RingDoorBell.async_take_snapshot(): one request that returns a stored snapshot newer than max_age or captures a fresh one, via the endpoint ring-mqtt uses (upstream python-ring-doorbell#528). Existing snapshot methods are unchanged.
- Outdoor Cam Plus reports a battery from its health data when it says either way, so plug-in variants no longer get one; a camera whose battery died reports nothing and keeps it (upstream python-ring-doorbell#538, reworked).
- Device kinds: Battery Doorbell Pro 4K, Wired Doorbell Plus (2nd Gen), Wired Doorbell (doorbell_tahoe), Doorbell (2nd Gen) cocoa_doorbell_v3, Indoor Cam Plus, Spotlight Cam Pro 4K, Elite Cam 140/360 4K and Chime (2nd Gen) (upstream python-ring-doorbell#553, python-ring-doorbell#539, python-ring-doorbell#536, python-ring-doorbell#531, python-ring-doorbell#550).

Co-authored-by: Niels Haagsman <haagsman@gmail.com>
Co-authored-by: Adam Reeve <adam@adamreeve.com>
Co-authored-by: danielcolquitt <daniel@colquitt.xyz>
Co-authored-by: Tom Roberts <tom@tomroberts.co.uk>
Co-authored-by: ben79 <benjaminfearnley@gmail.com>
Co-authored-by: Aaron Wolen <aaron@wolen.com>
Co-authored-by: Yoan <yoan.cousin@proton.me>
AMoo-Miki added a commit to AMoo-Miki/python-ring-cameras that referenced this pull request Oct 16, 2026
Upstream python-ring-doorbell has had no merges for months; this takes what its open pull requests offer, adapted to this fork:

- WebRTC: _close() no longer awaits its own reader task when the stream closes from inside it (upstream python-ring-doorbell#548, python-ring-doorbell#534).
- New RingDoorBell.async_take_snapshot(): one request that returns a stored snapshot newer than max_age or captures a fresh one, via the endpoint ring-mqtt uses (upstream python-ring-doorbell#528). Existing snapshot methods are unchanged.
- Outdoor Cam Plus reports a battery from its health data when it says either way, so plug-in variants no longer get one; a camera whose battery died reports nothing and keeps it (upstream python-ring-doorbell#538, reworked).
- Device kinds: Battery Doorbell Pro 4K, Wired Doorbell Plus (2nd Gen), Wired Doorbell (doorbell_tahoe), Doorbell (2nd Gen) cocoa_doorbell_v3, Indoor Cam Plus, Spotlight Cam Pro 4K, Elite Cam 140/360 4K and Chime (2nd Gen) (upstream python-ring-doorbell#553, python-ring-doorbell#539, python-ring-doorbell#536, python-ring-doorbell#531, python-ring-doorbell#550).

Co-authored-by: Niels Haagsman <haagsman@gmail.com>
Co-authored-by: Adam Reeve <adam@adamreeve.com>
Co-authored-by: danielcolquitt <daniel@colquitt.xyz>
Co-authored-by: Tom Roberts <tom@tomroberts.co.uk>
Co-authored-by: ben79 <benjaminfearnley@gmail.com>
Co-authored-by: Aaron Wolen <aaron@wolen.com>
Co-authored-by: Yoan <yoan.cousin@proton.me>
AMoo-Miki added a commit to AMoo-Miki/python-ring-cameras that referenced this pull request Oct 16, 2026
Upstream python-ring-doorbell has had no merges for months; this takes what its open pull requests offer, adapted to this fork:

- WebRTC: _close() no longer awaits its own reader task when the stream closes from inside it (upstream python-ring-doorbell#548, python-ring-doorbell#534).
- New RingDoorBell.async_take_snapshot(): one request that returns a stored snapshot newer than max_age or captures a fresh one, via the endpoint ring-mqtt uses (upstream python-ring-doorbell#528). Existing snapshot methods are unchanged.
- Outdoor Cam Plus reports a battery from its health data when it says either way, so plug-in variants no longer get one; a camera whose battery died reports nothing and keeps it (upstream python-ring-doorbell#538, reworked).
- Device kinds: Battery Doorbell Pro 4K, Wired Doorbell Plus (2nd Gen), Wired Doorbell (doorbell_tahoe), Doorbell (2nd Gen) cocoa_doorbell_v3, Indoor Cam Plus, Spotlight Cam Pro 4K, Elite Cam 140/360 4K and Chime (2nd Gen) (upstream python-ring-doorbell#553, python-ring-doorbell#539, python-ring-doorbell#536, python-ring-doorbell#531, python-ring-doorbell#550).

Co-authored-by: Niels Haagsman <haagsman@gmail.com>
Co-authored-by: Adam Reeve <adam@adamreeve.com>
Co-authored-by: danielcolquitt <daniel@colquitt.xyz>
Co-authored-by: Tom Roberts <tom@tomroberts.co.uk>
Co-authored-by: ben79 <benjaminfearnley@gmail.com>
Co-authored-by: Aaron Wolen <aaron@wolen.com>
Co-authored-by: Yoan <yoan.cousin@proton.me>
@Cristef

Cristef commented Nov 1, 2026

Copy link
Copy Markdown

Additional confirmation with a Ring Wired Doorbell 2K (kind: doorbell_tahoe) on Home Assistant Core 2026.10.4, using ring-doorbell==0.9.14.

Before applying the equivalent of this PR, the device appeared as Unknown Doorbell and exposed camera entities, but no ding or motion event entities.

Adding doorbell_tahoe to DOORBELL_WIRED_KINDS and reloading the Ring integration:

  • changed the reported model to Doorbell Wired;
  • created the ding event entity (event_types: ["ring"]) and the motion event entity.

There was also a separate push-receiver issue in this installation: firebase_messaging.fcmpushclient stopped with binascii.Error: Incorrect padding while decoding an incoming encrypted notification. Thus, the newly created event entities initially remained unknown, even after pressing the button.

The final working setup combined this model mapping with a local compatibility fix addressing:

After reloading Ring with both fixes active, a physical button press successfully updated the ding entity with event_type: ring. A downstream Home Assistant automation displaying the visitor on a screen also worked.

To be precise: this confirms the model mapping and end-to-end ding delivery with the combined local fixes. Also Motion entity creation was verified.

This branch has not been deployed

No deployments
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.

3 participants