Skip to content

Commit f9ef0c3

Browse files
DerekSeamanclaude
andcommitted
Add version upgrade clean build instructions to troubleshooting
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent fbc7964 commit f9ef0c3

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -418,6 +418,16 @@ Watches that require "reverse" pairing (i.e. the watch advertises as a device th
418418
- Try pairing to the ESP32 again
419419
- If that still fails, power cycle your phone/watch/tablet, power cycle your ESP32, change the BLE Device Name, and try pairing again
420420

421+
### Upgrading to a New Version
422+
423+
When upgrading IRK Capture to a new version, always perform a clean build to ensure all component changes are fully compiled:
424+
425+
1. In ESPHome Device Builder, open your IRK Capture device
426+
2. Click the three-dot menu (⋮) and select **"Clean Build Files"**
427+
3. After the clean completes, click **"Install"** to rebuild and flash
428+
429+
Skipping the clean step can result in stale cached object files being linked against the new component source, which may cause unexpected behavior even if the flash appears to succeed.
430+
421431
### ESPHome Build Fails
422432

423433
- Clean the build folder and retry

0 commit comments

Comments
 (0)