Skip to content

Add Specialized Turbo integration docs#44119

Open
JamieMagee wants to merge 5 commits intohome-assistant:nextfrom
JamieMagee:add-specialized-turbo-docs
Open

Add Specialized Turbo integration docs#44119
JamieMagee wants to merge 5 commits intohome-assistant:nextfrom
JamieMagee:add-specialized-turbo-docs

Conversation

@JamieMagee
Copy link
Copy Markdown
Contributor

@JamieMagee JamieMagee commented Mar 14, 2026

Proposed change

Documentation for the new Specialized Turbo e-bike BLE integration. Covers setup (auto-discovery and manual with pairing PIN), all 18 sensor entities, two automation examples, how the push-based data updates work, BLE-specific limitations, and troubleshooting for common issues like discovery failures and unavailable sensors.

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 14, 2026 20:03
@home-assistant home-assistant bot added has-parent This PR has a parent PR in another repo next This PR goes into the next branch labels Mar 14, 2026
@netlify
Copy link
Copy Markdown

netlify bot commented Mar 14, 2026

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 6687387
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/69c74a02ece950000896119d
😎 Deploy Preview https://deploy-preview-44119--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.

Covers setup (auto-discovery and manual), supported bikes, pairing
PIN configuration, all 18 sensor entities, automation examples,
data update behavior, known BLE limitations, and troubleshooting.
@JamieMagee JamieMagee force-pushed the add-specialized-turbo-docs branch from 83f1226 to 09156f8 Compare March 14, 2026 20:06
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 documentation for the new Specialized Turbo e-bike Bluetooth Low Energy integration, targeting the next branch for the 2026.4 release. The page covers auto-discovery and manual setup with a pairing PIN, lists 18 sensor entities, includes two automation examples, documents push-based data updates, BLE-specific limitations, and troubleshooting steps.

Changes:

  • New integration documentation page for specialized_turbo covering setup, entities, examples, data updates, known limitations, troubleshooting, and removal
  • Two YAML automation examples (battery full notification and battery health warning)
  • Front matter with standard fields (ha_bluetooth, ha_config_flow, ha_quality_scale: bronze, etc.)

- Wrap Jinja2 template in raw/endraw to prevent Jekyll/Liquid parsing
- Fix configuration_basic indentation from 4 to 2 spaces
- Remove mixed breadcrumb with Bluetooth outside My link
@c0ffeeca7 c0ffeeca7 added the new-integration This PR adds documentation for a new Home Assistant integration label Mar 16, 2026
Copy link
Copy Markdown
Contributor

@Laufmaschine Laufmaschine left a comment

Choose a reason for hiding this comment

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

Hi @JamieMagee, thank you very much for your contribution! 👍 This page looks very nice already. I just have a few suggestions, mainly in the Troubleshooting section, to align it with the integration docs template. I added an example as a comment for your consideration, with descriptions in brackets, though I am not sure if the content is technically correct.

@home-assistant home-assistant bot marked this pull request as draft March 26, 2026 12:06
@home-assistant
Copy link
Copy Markdown

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.

@JamieMagee
Copy link
Copy Markdown
Contributor Author

@Laufmaschine thanks for the review. I think I've addressed all your comments. The only follow-up question I had was about your comments on the troubleshooting section: were those just to highlight the format I should follow, or would you like me to rewrite the content as well? At the moment I've just rewritten them to follow the format you highlighted.


Before setting up this integration, make sure:

1. Your bike is powered on and awake (pedal or press the power button — the TCU screen should be lit).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
1. Your bike is powered on and awake (pedal or press the power button — the TCU screen should be lit).
1. Your bike is powered on and awake. If it isn´t, pedal or press the power button. The TCU screen should be lit.

Copy link
Copy Markdown
Contributor

@Laufmaschine Laufmaschine left a comment

Choose a reason for hiding this comment

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

Thank you very much @JamieMagee for the adjustments. The structure of the Troubleshooting is perfect now. I have just noticed two little things that I commented for your consideration.

@JamieMagee JamieMagee requested a review from Laufmaschine March 28, 2026 03:25
Copy link
Copy Markdown
Contributor

@Laufmaschine Laufmaschine left a comment

Choose a reason for hiding this comment

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

Thank you, @JamieMagee ! 👌

@Laufmaschine Laufmaschine added the awaits-parent Awaits the merge of an parent PR label Mar 30, 2026
@Laufmaschine Laufmaschine marked this pull request as ready for review March 30, 2026 07:37
@home-assistant home-assistant bot requested a review from Laufmaschine March 30, 2026 07:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaits-parent Awaits the merge of an parent PR has-parent This PR has a parent PR in another repo new-integration This PR adds documentation for a new Home Assistant integration next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants