Skip to content

Document that autoConnect does not enable automatic reconnection - #1212

Draft
twyatt wants to merge 1 commit into
mainfrom
cursor/autoconnect-reconnect-docs-4047
Draft

Document that autoConnect does not enable automatic reconnection#1212
twyatt wants to merge 1 commit into
mainfrom
cursor/autoconnect-reconnect-docs-4047

Conversation

@twyatt

@twyatt twyatt commented Jul 15, 2026

Copy link
Copy Markdown
Member

Resolves the documentation confusion raised in #764 (comment).

  • README (autoConnect section): adds an IMPORTANT callout explaining that autoConnect only influences how a connection is established (not reconnection), why Android's native reconnect never occurs with Kable, and how to implement automatic reconnection by monitoring the state flow (based on the approach used in the SensorTag sample's HeadlessApp).
  • PeripheralBuilder.autoConnectIf KDoc: adds the same clarification so it is visible in the IDE.

Closes #764.

Open in Web Open in Cursor 

Clarifies confusion raised in #764: Android's system-level behavior of
re-establishing autoConnect connections after a disconnect never takes
effect with Kable, because Kable closes the underlying BluetoothGatt as
soon as a disconnect occurs. Documents how to implement reconnection by
monitoring the state flow.

Co-authored-by: Travis Wyatt <travis.i.wyatt@gmail.com>
@twyatt twyatt added skip-changelog Excludes issue/PR from generated release change log. android maintenance General maintenance that doesn't effect the public API. labels Jul 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

android maintenance General maintenance that doesn't effect the public API. skip-changelog Excludes issue/PR from generated release change log.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

reconnect mechanism not working

2 participants