Mbed Linux OS CLI

Command-line interface for developing with Mbed Linux OS

The Mbed Linux OS CLI is a toolbox for managing target devices running Mbed Linux OS.

Prerequisites

Node.js > v8.10.0 and npm 3.

These can be installed from the Node.js website or from package managers.

e.g. on Ubuntu:

$ curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
$ sudo apt-get install -y nodejs

Installation

The CLI is distributed using npm. To install the tool globally:

$ npm install -g mbl-cli

Usage

$ mbl-cli <command> [arguments]

Options

• -v, --version - Show version number
• -h, --help - Show help

Commands

Discovery and Select

Discover connected Mbed Linux OS devices and allow the user to select one for further commands.

$ mbl-cli select

Shell

Obtain a shell on a device, optionally specifying the device IPv4/IPv6 address to use

$ mbl-cli shell [address]

Run

Run a remote command on a device, optionally specifying the device IPv4/IPv6 address to use

$ mbl-cli run <command> [address]

Get

Copy a file from a device, optionally specifying the device IPv4/IPv6 address to use

$ mbl-cli get <src> <dest> [address]

Put

Copy a file to a device, optionally specifying the device IPv4/IPv6 address to use

$ mbl-cli put <src> <dest> [address]

Implementation Status

• [x] discover and select a device
• [x] shell onto a device
• [x] run a remote command on a device
• [x] copy a file from/to a device
• [ ] deploy an application image on a device
• [ ] deploy a firmware component on a device
• [ ] start an application on a device
• [ ] stop an application on a device
• [ ] restart an application on a device
• [ ] configure the network for a device