m3

Node library and CLI to update MicroPython firmware on connected Mycelium devices over USB.

$ npm i @hypericon/m3

Installation

mpremote must be installed separately!

$ pip install mpremote

Either install globally to use the CLI:

$ npm i -g @hypericon/m3

CLI Usage

Common flags:

• -v --verbose - enable verbose logging

Devices

List connected devices, including USB information and serial number

$ m3 devices

Info

Display firmware information for a specified device, if it is available

$ m3 info COM4

Storage

Read information about a device's storage usage

$ m3 storage COM4

Read

Read files or folders. Like a mix of cat and ls.

$ m3 read COM4 # list files & folders in "/"
$ m3 read COM4 main.py
$ m3 read COM4 nested/folder/
$ m3 read COM4 nested/folder/some-ile.py

Upload

Upload a number of files and directories to the root of the device's storage. Useful for initial configuration of a device.

$ m3 upload <device> <...paths>
$ m3 upload COM4 src test main.py persona.json

Copy

Copy a file or directory ts a specified path. Useful for copying configuration files to specific locations.

$ m3 upload <device> <localPath> <remotePath>
$ m3 upload COM4 personas/light-engine-test.json persona.json

Wipe

Delete all the files and folders on the device.

• -f, --force - do not prompt the user for confirmation

$ m3 wipe <device>
$ m3 wipe COM4
$ m3 wipe COM4 -f

Help

Display help for the CLI

$ m3 -h
# or
$ m3 --help

Display help for the individual commands

$ m3 devices -h