This guide shows you how to install the latest release of newtmgr from binary or from source. The tool is written in Go (golang).
It assumes that you have already installed the newt tool on Windows and have the Windows development environment set up.
This guide shows you how to perform the following:
See Installing Previous Releases of Newtmgr to install an earlier version of newtgmr.
Note: If you would like to contribute to the newtmgr tool, see Setting Up Go Environment to Contribute to Newt and Newtmgr Tools.
You can install the latest release of newtmgr from binary. It has been tested on Windows 10 64 bit platform.
$ wget -P /tmp https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.3.0/newtmgr_1_3_0_windows_amd64.tar.gz
If you previously built newtmgr from the master branch, you can extract the file into your $GOPATH/bin directory. Note: This overwrites the current newtmgr.exe in the directory and assumes that you are using $GOPATH/bin for your Go applications.
tar -xzf /tmp/newtmgr_1_3_0_windows_amd64.tar.gz -C $GOPATH/bin
If you are installing newtmgr for the first time and do not have Go setup, you can extract into /usr/bin directory:
tar -xzf /tmp/newtmgr_1_3_0_windows_amd64.tar.gz -C /usr/bin
If you have an older version of Windows or a 32 bit platform, you can build and install the latest release version of newtmgr from source.
$ cd /tmp $ mkdir go $ cd go $ export GOPATH=/tmp/go
$ go get mynewt.apache.org/newtmgr/newtmgr
Note If you get the following error, you may ignore it as we will rebuild newtmgr from the latest release version of newtmgr in the next step:
# github.com/currantlabs/ble/examples/lib/dev ..\..\..\github.com\currantlabs\ble\examples\lib\dev\dev.go:7: undefined: DefaultDevice
$ cd src/mynewt.apache.org/newtmgr $ git checkout mynewt_1_3_0_tag Note: checking out 'mynewt_1_3_0_tag'.
$ cd newtmgr $ go install $ ls /tmp/go/bin/newtmgr.exe -rwxr-xr-x 1 user None 15457280 Sep 12 00:30 /tmp/go/bin/newtmgr.exe
$newtmgr Newtmgr helps you manage remote devices running the Mynewt OS Usage: newtmgr [flags] newtmgr [command] Available Commands: config Read or write a config value on a device conn Manage newtmgr connection profiles crash Send a crash command to a device datetime Manage datetime on a device echo Send data to a device and display the echoed back data fs Access files on a device help Help about any command image Manage images on a device log Manage logs on a device mpstat Read mempool statistics from a device reset Perform a soft reset of a device run Run test procedures on a device stat Read statistics from a device taskstat Read task statistics from a device Flags: -c, --conn string connection profile to use -h, --help help for newtmgr -l, --loglevel string log level to use (default "info") --name string name of target BLE device; overrides profile setting -t, --timeout float timeout in seconds (partial seconds allowed) (default 10) -r, --tries int total number of tries in case of timeout (default 1) Use "newtmgr [command] --help" for more information about a command.