This is an automated email from the ASF dual-hosted git repository.

ccollins pushed a commit to branch master
in repository

The following commit(s) were added to refs/heads/master by this push:
     new 073be80  Add some basic info to the README.
073be80 is described below

commit 073be80c4446a4c9c5102abdb8fadf1ae4a6a627
Author: Christopher Collins <>
AuthorDate: Wed Feb 14 18:16:04 2018 -0800

    Add some basic info to the README.
 README    |  1 - | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 78 insertions(+), 1 deletion(-)

diff --git a/README b/README
deleted file mode 100644
index 3bcb6a5..0000000
--- a/README
+++ /dev/null
@@ -1 +0,0 @@
-# mcumgr CLI
diff --git a/ b/
new file mode 100644
index 0000000..ecf71ea
--- /dev/null
+++ b/
@@ -0,0 +1,78 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# mcumgr
+MCU Manager (`mcumgr`) is the application tool that enables a user to 
+with and manage remote devices running an
+[mcumgr server](
+The `mcumgr` tool is a thin wrapper over the Apache `newtmgr` tool.  Thus, the
+[`newtmgr` documentation](
+provides some useful help with using the `mcumgr` tool.
+### Building
+Build the mcumgr tool as follows:
+1. Unpack mcumgr source.
+2. Rename resulting `apache-mynewt-mcumgr-1.3.0` directory to 
+3. `cd $GOPATH/src/`
+4. `go build`
+### Examples
+Here are some example `mcumgr` invocations.
+#### Send an echo command over Bluetooth
+The following sends an echo command to a Bluetooth device advertising the name
+mcumgr --conntype ble --connstring peer_name=Zephyr echo hello
+#### Upgrade firmware over Bluetooth
+This series of commands performs an image upgrade over Bluetooth.  The device 
is assumed to be advertising the name "Zephyr".
+# 1. Query device for its current image list.
+mcumgr --conntype ble --connstring 'peer_name=Zephyr' image list
+# 2. Upload new image to device.
+mcumgr --conntype ble --connstring 'peer_name=Zephyr' image upload <filename>
+# 3. Tell the device to run the new image on its next boot ("test" the new
+#    image).
+mcumgr --conntype ble --connstring 'peer_name=Zephyr' image test <image-hash>
+# 4. Reboot the device.
+mcumgr --conntype ble --connstring 'peer_name=Zephyr' reset
+# 5. Query device for its current image list; ensure new image is running.
+mcumgr --conntype ble --connstring 'peer_name=Zephyr' image list
+# 6. Make the image swap permanent.
+mcumgr --conntype ble --connstring 'peer_name=Zephyr' image confirm

To stop receiving notification emails like this one, please contact

Reply via email to