Skip to content

Add ADAM audio documentation#44305

Draft
Perhan35 wants to merge 2 commits intohome-assistant:nextfrom
Perhan35:Perhan35/add-adam-audio-docs
Draft

Add ADAM audio documentation#44305
Perhan35 wants to merge 2 commits intohome-assistant:nextfrom
Perhan35:Perhan35/add-adam-audio-docs

Conversation

@Perhan35
Copy link
Copy Markdown

@Perhan35 Perhan35 commented Mar 25, 2026 •
edited by c0ffeeca7
Loading

Proposed change

Adds ADAM Audio A-Series speakers integration documentation.
This integration will allow the user to command their speakers from Home Assistant, and without the need of the A Control App.

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI review requested due to automatic review settings March 25, 2026 18:34
@home-assistant home-assistant bot added has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch next This PR goes into the next branch labels Mar 25, 2026
@netlify
Copy link
Copy Markdown

netlify bot commented Mar 25, 2026 •
edited
Loading

✅ Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit a3e0e25
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/69c42eeba020b50008859f7e
😎 Deploy Preview https://deploy-preview-44305--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@home-assistant
Copy link
Copy Markdown

home-assistant bot commented Mar 25, 2026

It seems that this PR is targeted against an incorrect branch. Documentation updates which apply to our current stable release should target the current branch. Please change the target branch of this PR to current and rebase if needed. If this is documentation for a new feature, please add a link to that PR in your description.

Copilot AI reviewed Mar 25, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a new integration documentation page for ADAM Audio A-Series speakers, describing supported devices, setup prerequisites, provided entities, automation examples, and known limitations.

Changes:

  • Added a new integration page at source/_integrations/adam_audio.markdown.
  • Documented supported/unsupported speaker families, entities, and data-update behavior.
  • Included example automations and standard removal guidance.

This was referenced Mar 25, 2026
Draft
Open
Perhan35 and others added 2 commits March 25, 2026 19:52
@Perhan35 Perhan35 force-pushed the Perhan35/add-adam-audio-docs branch from f1d509e to a3e0e25 Compare March 25, 2026 18:52
@home-assistant home-assistant bot removed the needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch label Apr 7, 2026
@c0ffeeca7 c0ffeeca7 added the new-integration This PR adds documentation for a new Home Assistant integration label Apr 7, 2026
c0ffeeca7
c0ffeeca7 requested changes Apr 7, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tiny tweaks

source/_integrations/adam_audio.markdown
---
title: ADAM Audio
description: Integrate ADAM Audio A-Series studio monitors into Home Assistant.
ha_release: 2026.3
Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
ha_release: 2026.3
ha_release: 2026.4

source/_integrations/adam_audio.markdown
Comment on lines +16 to +18
related:
- url: https://github.com/Perhan35/ha-adam-audio
title: GitHub Repository
Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
related:
- url: https://github.com/Perhan35/ha-adam-audio
title: GitHub Repository

We don't usually refer to the GH repository from the user documentation.

source/_integrations/adam_audio.markdown

Due to the connection type with the speakers, state is tracked optimistically. This means the integration records what it has set and assumes the speaker accepted it. If you change settings using the physical knob or the ADAM Audio A Control app, Home Assistant does not reflect those changes until the integration entry is reloaded.

A keepalive packet is sent every 25 seconds to maintain the OCA session.
Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A keepalive packet is sent every 25 seconds to maintain the OCA session.

Do I need to know this as an end user? Do I need to do anything with this?

source/_integrations/adam_audio.markdown
## Known limitations

- Opening the official **ADAM Audio A Control** app while this integration is running causes the speaker to accept commands from the app, which overrides any state set by Home Assistant. Close the app to regain control.
- State is optimistic, meaning physical knob changes are not polled back.
Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- State is optimistic, meaning physical knob changes are not polled back.
- This integration does not poll the device for state changes. If the device is adjusted physically (for example, by turning a knob), Home Assistant does not reflect that change.

Rephrased it a bit in a less technical way. Please correct me if I got this wrong.
What do I need to do to get that change?

@home-assistant home-assistant bot marked this pull request as draft April 7, 2026 14:57
@home-assistant
Copy link
Copy Markdown

home-assistant bot commented Apr 7, 2026

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@c0ffeeca7 c0ffeeca7 c0ffeeca7 requested changes

Requested changes must be addressed to merge this pull request.

Assignees

No one assigned

Labels

has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on new-integration This PR adds documentation for a new Home Assistant integration next This PR goes into the next branch

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@Perhan35 @c0ffeeca7