Skip to content

Bump @adafruit/ble-file-transfer-js to 1.0.5#478

Merged
makermelissa merged 1 commit into
circuitpython:mainfrom
makermelissa-piclaw:chore/bump-ble-file-transfer-1.0.5
Apr 28, 2026
Merged

Bump @adafruit/ble-file-transfer-js to 1.0.5#478
makermelissa merged 1 commit into
circuitpython:mainfrom
makermelissa-piclaw:chore/bump-ble-file-transfer-1.0.5

Conversation

@makermelissa-piclaw
Copy link
Copy Markdown
Contributor

Picks up adafruit/ble-file-transfer-js#10, which corrects a long-standing mislabeled status code in the BLE File Transfer client.

What changed upstream

CircuitPython firmware returns status code 0x05 whenever filesystem_lock() fails, not specifically when a USB host is connected. See supervisor/shared/bluetooth/file_transfer_protocol.h:

#define STATUS_ERROR_NO_FILE  0x03
#define STATUS_ERROR_PROTOCOL 0x04
#define STATUS_ERROR_READONLY 0x05

The library was labeling that status STATUS_ERROR_USB_MOUNTED and rejecting with "Unable to write while USB connected" / "Unable to read while USB connected". 1.0.5 renames the constant to STATUS_ERROR_READONLY and reworks the user-facing message to "Filesystem is read-only", which accurately covers any case where the FS can't be locked for writes (host MSC mount, device-side read-only mount, etc.).

Why this matters for web-editor

Users running on wall power with no host attached have been seeing "Unable to write while USB connected" when they try to rename, write, or delete files. The new message tells them what's actually going on.

Risk

Low — pure dependency bump with a friendlier error string. Tested locally with npm run build (clean build, no warnings beyond the existing vite plugin-timings notice).

Independent of #475.

Picks up the renamed status constant and corrected user-facing
message from adafruit/ble-file-transfer-js#10:

  STATUS_ERROR_USB_MOUNTED (0x05) -> STATUS_ERROR_READONLY
  "Unable to write while USB connected" -> "Filesystem is read-only"

The CircuitPython firmware returns 0x05 whenever filesystem_lock()
fails, not specifically when a USB host is connected. The old label
was confusing for users on wall power who saw the USB message even
with no host attached.
@makermelissa makermelissa merged commit 2cc007a into circuitpython:main Apr 28, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants