October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk5 min

Which ESP32 Bluetooth Proxy Settings Should You Change in ESPHome?

Most ESP32 Bluetooth proxies should keep ESPHome’s scan interval and window at their defaults. Change connection slots, notification limits, and timeouts only when a specific connection need or log symptom calls for it.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For most ESP32 Bluetooth proxies, keep ESPHome’s BLE scan interval and window at their defaults. Start with esp32_ble_tracker: and bluetooth_proxy:; enable active proxy connections if Home Assistant needs to read or write device characteristics. Change connection slots only when you need more simultaneous active connections, and increase them conservatively because each slot uses memory.

Start with a minimal proxy configuration

ESPHome’s proxy uses the BLE tracker component. A typical Wi-Fi configuration follows this pattern:

As an Amazon Associate I earn from qualifying purchases.

esp32:
  variant: esp32
  framework:
    type: esp-idf

esp32_ble_tracker:

bluetooth_proxy:
  active: true

Add the network, API, and OTA settings required by your installation; ESPHome’s full example also enables logging. The active: true line is optional on ESP32 because active proxy connections are enabled by default in the current documentation, but stating it explicitly makes the intended behavior clear. See ESPHome’s Bluetooth Proxy documentation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Know which kind of Bluetooth activity you need

A proxy can forward BLE advertisements and, when active proxy connections are enabled, support integrations that connect to a device and read or write GATT characteristics. Advertisement forwarding does not use proxy connection slots. Passive broadcast sensors therefore do not need active GATT connections just to deliver their advertisements to Home Assistant. Device and integration support varies; a proxy does not make every BLE device compatible.

#1 Best Overall
ESP-WROOM-32 ESP32 ESP-32S Development Board 2.4GHz Dual-Mode WiFi + Bluetooth Dual Cores Microcontroller Processor Integrated with Antenna RF AMP Filter AP STA Compatible with Arduino IDE (3PCS)
  • 2.4GHz Dual Mode WiFi + Bluetooth Development Board
  • Support LWIP protocol, Freertos
  • SupportThree Modes: AP, STA, and AP+STA
  • Ultra-Low power consumption, Compatible with Arduino IDE
  • ESP32 is a safe, reliable, and scalable to a variety of applications

Two similarly named settings control different things:

  • bluetooth_proxy.active enables active GATT proxy connections.
  • esp32_ble_tracker.scan_parameters.active controls active scanning, which requests scan-response data from nearby devices.

Change connection slots only when connections are the bottleneck

ESPHome’s current ESP32 proxy documentation sets connection_slots to 3 by default. Each configured proxy slot uses approximately 1 KB of RAM, and ESPHome recommends not exceeding 5 to avoid stability and memory problems. The documented maximum is 9, but the proxy’s slot count must not exceed the BLE component’s max_connections. These are ESPHome configuration figures, not independent measurements. See the proxy reference.

Rank #2
ELEGOO 3PCS ESP-32 Dev Boards, ESP-WROOM-32, USB-C, WiFi Bluetooth 4.2
  • Dual-Core Performance Up to 240 MHz: Run sensor processing, wireless communication, automation logic and connected-device tasks on a 32-bit dual-core ESP32 platform designed for responsive embedded and IoT projects
  • Built-in Wi-Fi and Bluetooth 4.2: Connect to 2.4 GHz Wi-Fi networks or use Bluetooth Classic and BLE for wireless sensors, smart devices, remote controls, home automation and other connected projects
  • Flexible Power-Saving Modes: ESP32 power-management features support dynamic clock scaling and low-power operating modes, helping developers reduce energy use in compatible sensing, monitoring and connected-device applications, suitable for battery-powered Internet of Things (IoT) devices.
  • USB-C Programming with CP2102: Connect through USB-C for power, sketch uploads and serial monitoring, while GPIO, UART, SPI and I2C interfaces support sensors, displays, motor drivers and other modules (USB-C cable not included)
  • Over-the-Air Update Support: Configure OTA functionality through a compatible ESP-32 software framework to update deployed firmware over Wi-Fi without reconnecting the board by USB for every revision

Slots matter for simultaneous active GATT connections, not for advertisement reception. Devices that stay connected can occupy slots; devices that connect briefly and disconnect release them. Before increasing the setting, identify whether Home Assistant is actually trying to maintain more concurrent connections than the proxy allows.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Keep the BLE connection limit in step

esp32_ble.max_connections is the total simultaneous BLE connection limit shared by the tracker, proxy, and BLE server. ESPHome documents a default of 3, a range of 1–9, and roughly 1 KB of RAM per connection slot; it recommends staying at or below 5 for memory stability. If you raise connection_slots, make sure this BLE limit is at least as high, while accounting for the board’s other memory demands. ESPHome warns that the ESP32 BLE stack itself consumes significant RAM.

Rank #3
ELEGOO ESP-32 Super Starter Kit with Tutorial Compatible with Arduino IDE
  • Powerful ESP-32 Board: Unlock the world of Internet of Things (IoT) and advanced electronics with the heart of this kit: the ESP-32 board. It features a powerful dual-core processor, integrated Wi-Fi and Bluetooth 4.2, making it perfect for building connected, smart devices that communicate with your phone or the cloud. It's fully compatible with the Arduino IDE for easy programming.
  • Super Starter Kit: This kit contains over 35 different modules and electronic components, including sensors, displays, motors, and input devices. From LEDs and buttons to an OLED screen, servo motor, and keypad, you have everything needed to explore a vast range of projects in one box.
  • Step by Step Online Tutorial: Jump right in with our detailed, beginner-friendly tutorial. Access 30+ projects with complete code, clear circuit diagrams, and step-by-step instructions. Learn the fundamentals of electronics, coding, and how to utilize the ESP-32's unique capabilities without any prior experience.
  • Hands-on Learning for All Skill Levels: Perfect for students, makers, engineers, and hobbyists. Start with basic circuits and coding, then progress to intermediate and advanced IoT applications. Build practical projects like weather stations, smart home controllers, remote-controlled devices, and interactive gadgets. The skills you learn are the foundation for real-world innovation.
  • Quality & Great Support: Elegoo is committed to quality. We provide a clear, detailed tutorial guide, refined code, and a well-organized component kit. All modules are carefully selected for reliability and ease of use. Our dedicated technical support team and active online community are ready to help you succeed in your learning journey.

Older configurations may put max_connections under esp32_ble_tracker. That option is deprecated; configure it under esp32_ble instead. The tracker documentation says the deprecated option is scheduled for removal in ESPHome 2026.10.0. Because configuration names and timelines are release-sensitive, check the documentation for the ESPHome version installed on your node before migrating older YAML. References: ESP32 BLE component and ESP32 BLE Tracker.

Usually leave scan interval and window at their defaults

ESPHome recommends the default scan parameters for most users. Changing interval or window often adds CPU and network load without a meaningful benefit. ESPHome warns that aggressive scan settings can overheat some PoE proxies and destabilize Wi-Fi proxies. In particular, a higher scan duty cycle is not a guaranteed way to improve reception.

Rank #4
ESP-WROOM-32 ESP32 ESP-32S Development Board 2.4GHz Dual-Mode WiFi + Bluetooth Dual Cores Microcontroller Processor Integrated with Antenna RF AMP Filter AP STA Compatible with Arduino IDE (1 PCS)
  • 2.4GHz Dual Mode WiFi + Bluetooth Development Board
  • Support LWIP protocol, Freertos;ESP32 is a safe, reliable, and scalable to a variety of applications
  • SupportThree Modes: AP, STA, and AP+STA
  • Ultra-Low power consumption, Compatible with Arduino IDE
  • 1PCS 30Pin ESP32 Development Board 2.4GHz WiFi Dual Cores Microcontroller Integrated with Antenna RF Low Noise Amplifiers Filters

The BLE tracker defines interval as the time between scan windows and window as the time spent listening on a channel; the window cannot exceed the interval. With Wi-Fi configured, the default window equals the interval so Bluetooth can listen when Wi-Fi is not using the shared radio. If tuning scans made a Wi-Fi proxy unstable, restore the defaults before trying other changes. See Bluetooth Proxy guidance and the tracker reference.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Active scanning is not active proxying

Active scanning is enabled by default. It asks nearby devices for scan-response data, which may contain additional information, but can increase battery use on those BLE devices. Passive scanning is adequate for most ongoing operation; set scan_parameters.active: false if the devices you care about do not need scan responses or you want less radio activity. This does not disable active GATT connections controlled by bluetooth_proxy.active.

Best Value
HiLetgo ESP-WROOM-32 ESP32 ESP-32S Development Board 2.4GHz Dual-Mode WiFi + Bluetooth Dual Cores Microcontroller Processor Integrated with Antenna RF AMP Filter AP STA for Arduino IDE
  • 2.4GHz Dual Mode WiFi + Bluetooth Development Board
  • Ultra-Low power consumption, works perfectly with the Arduino IDE
  • Support LWIP protocol, Freertos
  • SupportThree Modes: AP, STA, and AP+STA
  • ESP32 is a safe, reliable, and scalable to a variety of applications
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Use connection scan and coexistence settings cautiously

connection_scan_window

This setting controls listening time for scans while a BLE connection is active. ESPHome cautions that setting it close to the scan interval can leave too little radio time for active connections and cause disconnects. When Wi-Fi is configured and the regular window defaults to interval, the documented default for connection_scan_window is 30 ms. If connections drop during scanning, inspect this value rather than maximizing every scan window. See the BLE component reference.

software_coexistence

With Wi-Fi configured, software coexistence is enabled by default. It briefly prioritizes Bluetooth over Wi-Fi during initial BLE connection establishment and may improve reliability. It is available only with the Wi-Fi component; leave it at its default unless you are diagnosing a specific issue. See ESPHome’s BLE documentation.

Adjust notification and timeout limits only for specific symptoms

max_notifications

ESPHome documents a default maximum of 12 notification registrations shared across BLE connections, with a configurable range of 1–64. Raise it only when a device needs more characteristic notifications and logs show ESP_GATT_NO_RESOURCES with status 128 while notifications are being enabled.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

connection_timeout

The documented default is 20 seconds, with a range of 10–180 seconds. ESPHome advises aligning this timeout with the BLE client’s timeout so a failed connection attempt does not occupy a proxy slot longer than necessary. Both settings are described in the ESP32 BLE reference.

Troubleshoot in an order that avoids unnecessary tuning

  1. Check the task. Advertisement-only devices do not require active GATT connections; integrations that read or write characteristics do.
  2. Undo aggressive scan changes. Restore default interval and window settings if Wi-Fi became unstable, the proxy overheats, or tuning did not help reception.
  3. Investigate connection drops during scans. Review connection_scan_window and avoid starving active connection traffic.
  4. Check slot exhaustion. Count devices that remain connected at once, then raise proxy slots conservatively within the BLE connection limit and memory headroom.
  5. Match settings to log symptoms. Consider max_notifications for notification resource errors; align connection_timeout with the client when connection attempts time out.
  6. Improve placement and radio conditions. ESPHome advises placing the node near BLE devices and at least 3 meters from routers, switches, and similar equipment. Ethernet can remove Wi-Fi traffic from the ESP32’s radio.

Placement and network design are often better first moves than increasing scan duty. ESPHome’s proxy documentation includes a Wi-Fi example and a separate Ethernet example for the Olimex ESP32-PoE-ISO. That board is an example, not a requirement: choose hardware compatible with the ESPHome variant and network connection, and consider an external antenna if the selected hardware supports one.

Choose settings based on connection type and network

Situation Settings approach Why
Wi-Fi proxy, default operation Keep scan interval and window at their defaults. Aggressive scans can destabilize Wi-Fi, while ESPHome recommends defaults for most users.
Ethernet proxy Keep defaults initially; investigate scan changes only for a specific need. Ethernet offloads Wi-Fi traffic from the ESP32 radio, but aggressive scans can still increase load and may overheat some PoE proxies.
Advertisement-based sensor Forward advertisements; no active GATT slot is needed just for broadcast data. Advertisement forwarding is separate from active connections.
Integration that reads or writes GATT characteristics Enable active proxy connections and provide enough slots for simultaneous connections. These operations require active connections and consume slots.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.