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

• discover and select a device
• shell onto a device
• run a remote command on a device
• 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