# @balena/node-beaglebone-usbboot

> Transforms BeagleBone to mass storage device

Latest version **3.0.7** (published 2026-07-16) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @balena/node-beaglebone-usbboot
pnpm add @balena/node-beaglebone-usbboot
yarn add @balena/node-beaglebone-usbboot
bun add @balena/node-beaglebone-usbboot
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 3.0.7 |
| Published | 2026-07-16 |
| First published | 2021-02-16 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=16 |
| Dependencies | 5 |
| Unpacked size | 673 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 2 |
| Author | Balena Ltd. |
| Maintainers | balena.io, page |
| Keywords | beaglebone, usbboot, usb, am335x, mass storage |

## Links

- npm: https://www.npmjs.com/package/@balena/node-beaglebone-usbboot
- Repository: https://github.com/balena-io-modules/node-beaglebone-usbboot
- Homepage: https://github.com/balena-io-modules/node-beaglebone-usbboot#readme
- Issues: https://github.com/balena-io-modules/node-beaglebone-usbboot/issues
- npm.io page: https://npm.io/package/@balena/node-beaglebone-usbboot

## Dependencies (5)

- [usb](https://npm.io/package/usb.md) ^2.5.2
- [debug](https://npm.io/package/debug.md) ^4.3.1
- [schemapack](https://npm.io/package/schemapack.md) ^1.4.2
- [endian-toggle](https://npm.io/package/endian-toggle.md) 0.0.0
- [binary-parser-encoder](https://npm.io/package/binary-parser-encoder.md) ^1.4.5

## Alternatives

- [localforage](https://npm.io/package/localforage.md) — 6.2M weekly downloads
- [localforage-observable](https://npm.io/package/localforage-observable.md) — 30.8K weekly downloads
- [@y/y](https://npm.io/package/@y/y.md) — 30.1K weekly downloads
- [@metaobjectsdev/render](https://npm.io/package/@metaobjectsdev/render.md) — 3.5K weekly downloads
- [@ledgerhq/coin-algorand](https://npm.io/package/@ledgerhq/coin-algorand.md) — 1.1K weekly downloads

## Recent versions

- 3.0.7 (latest) — 2026-07-16
- 3.0.8-build-renovate-rimraf-6-x-839bc6ea853c41c7a8fa3b08b481d690ab0d6ba8-1 (build-renovate-rimraf-6-x) — 2026-08-20
- 3.0.7-build-renovate-pin-dependencies-25e0dfe8c0491d20706e485fd0588a886ae7bae0-1 (build-renovate-pin-dependencies) — 2026-07-16
- 3.0.6-build-renovate-rimraf-4-x-f4c227c261f135bb90d1e07bfc0f52756383b8fb-1 (build-renovate-rimraf-4-x) — 2026-05-16
- 3.0.6-build-renovate-rimraf-4-1-x-48aa7a87d4eb9e9023ccc3cd28584f71b5d15d71-1 (build-renovate-rimraf-4-1-x) — 2026-05-16
- 3.0.6-build-renovate-major-20-node-491783bd171a3b20581185277c3050ba03ddd58d-1 (build-renovate-major-20-node) — 2026-05-10
- 3.0.5-build-add-npm-oidc-permissions-2ab32670f00276e1151528020e3739087712d25e-1 (build-add-npm-oidc-permissions) — 2026-02-18
- 3.0.8-build-renovate-rimraf-6-x-4bd0c0df7d5a8b22065eaa43de79b5c2942e0efb-1 — 2026-07-28
- 3.0.8-build-renovate-rimraf-6-x-0322d05e1e7576ffa2d5c4a74ef42dbde5dccdae-1 — 2026-07-16
- 3.0.7-build-renovate-rimraf-6-x-b25d3b119c4812c6f04d78cd1ecf71d8871eb3d5-1 — 2026-07-16
- 3.0.6 — 2026-05-16
- 3.0.6-build-renovate-major-20-node-1502305ea5e510c12a247ec89a44c114939ea972-1 — 2026-04-06
- 3.0.6-build-renovate-major-20-node-22d83ea1dcf7f0e5472ea5c37d3ec3426d06f89a-1 — 2026-03-01
- 3.0.6-build-renovate-major-20-node-72d55a60d473ab8e8edd7d5410e5a57de8ecf095-1 — 2026-02-19
- 3.0.5 — 2026-02-19
- … 54 more at https://npm.io/package/@balena/node-beaglebone-usbboot/versions

## README

# node-beaglebone-usbboot
Transforms BeagleBone to mass storage device


This is heavily based on [node-beagle-boot](https://github.com/ravikp7/node-beagle-boot) & 
[node-raspberrypi-usbboot](https://github.com/balena-io-modules/node-raspberrypi-usbboot)

Install modules:

```bash
npm ci
```

Run the script:
> NOTE: On most GNU/Linux distributions you'll need to run this as root.

```bash
npm start
```

Now that everything is ready, we can transform BeagleBone to mass storage device:
* Makeing sure the device is powered off
* Pluging the USB cable to the device but not to the computer yet
* Pressing the the 'USER' button, and keep pressing it
* Pluging the USB cable: This will power up the device
* Releasing the 'USER' button

The device will now configure itself trough BOOTP and transform to mass storage device.

---
_Source: https://npm.io/package/@balena/node-beaglebone-usbboot · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._