Skip to content

Conversation

bdraco
Copy link
Member

@bdraco bdraco commented Sep 17, 2025

Description:

Update documentation to reflect that Arduino-specific BLE limitations have been removed since Arduino now runs as an ESP-IDF component.

This PR updates the documentation for esp32_ble, esp32_ble_tracker, and bluetooth_proxy components to remove framework-specific limitations that are no longer applicable after ESPHome PR esphome/esphome#10647 changed ESP32 Arduino builds to use Arduino as an ESP-IDF component.

Related issue (if applicable): N/A

Pull request in esphome with YAML changes (if applicable):

Checklist:

  • I am merging into next because this is new documentation that has a matching pull-request in esphome as linked above.
    or

  • I am merging into current because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.

  • Link added in /components/index.rst when creating new documents for new components or cookbook.

Background:

With PR esphome/esphome#10647, Arduino now runs as an ESP-IDF component which means:

  • Both frameworks now support the same maximum of 9 BLE connections
  • Both frameworks now support the same BLE configuration options
  • The SplitDefault configurations in the code have been replaced with standard defaults
  • The framework-specific validations (cv.only_with_esp_idf) have been removed

These documentation updates reflect the code changes to ensure users understand that these features are now available regardless of their framework choice, though ESP-IDF is still recommended for Bluetooth Proxy due to lower memory usage.

Copy link

netlify bot commented Sep 17, 2025

Deploy Preview for esphome ready!

Name Link
🔨 Latest commit fd15e3e
🔍 Latest deploy log https://app.netlify.com/projects/esphome/deploys/68cb3d776d9d9300085e8673
😎 Deploy Preview https://deploy-preview-5379--esphome.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.

@bdraco bdraco marked this pull request as ready for review September 17, 2025 23:13
@Copilot Copilot AI review requested due to automatic review settings September 17, 2025 23:13
Copy link
Contributor

@Copilot 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

Updates documentation to remove Arduino framework-specific BLE limitations that are no longer applicable since Arduino now runs as an ESP-IDF component, making BLE features consistent across both frameworks.

  • Removes framework-specific restrictions for BLE connection limits and configuration options
  • Updates default values and availability statements for BLE parameters
  • Simplifies documentation by removing references to ESP-IDF-only features

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
content/components/esp32_ble_tracker.md Removes ESP-IDF framework requirement for max_connections parameter
content/components/esp32_ble.md Removes ESP-IDF framework requirements for connection_timeout and max_notifications parameters
content/components/bluetooth_proxy.md Removes ESP-IDF framework requirements for cache_services and connection_slots parameters

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

Successfully merging this pull request may close these issues.

1 participant