You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mynewt.apache.org by ad...@apache.org on 2016/12/15 19:21:58 UTC

incubator-mynewt-site git commit: 1) Added description for newtmgr and oicmgr in "Newt Manager" under OS Guide 2) Removed Security Lifecycle: 'pages/securitybullets.md' from mkdocs.yml. The file is not in the pages directory.

Repository: incubator-mynewt-site
Updated Branches:
  refs/heads/develop 436251209 -> 7cd80682a


1) Added description for newtmgr and oicmgr in "Newt Manager" under OS Guide
2) Removed Security Lifecycle: 'pages/securitybullets.md' from mkdocs.yml. The file is not
in the pages directory.


Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/commit/7cd80682
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/7cd80682
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/7cd80682

Branch: refs/heads/develop
Commit: 7cd80682ae5ddffdef3b9939dec425204706a040
Parents: 4362512
Author: cwanda <wa...@happycity.com>
Authored: Wed Dec 14 21:48:35 2016 -0800
Committer: cwanda <wa...@happycity.com>
Committed: Wed Dec 14 21:55:42 2016 -0800

----------------------------------------------------------------------
 docs/os/modules/newtmgr/newtmgr.md | 112 ++++++++++++++++++++++++++++++++
 mkdocs.yml                         |   3 +-
 2 files changed, 114 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/7cd80682/docs/os/modules/newtmgr/newtmgr.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/newtmgr/newtmgr.md b/docs/os/modules/newtmgr/newtmgr.md
new file mode 100644
index 0000000..7a7d0ed
--- /dev/null
+++ b/docs/os/modules/newtmgr/newtmgr.md
@@ -0,0 +1,112 @@
+## Newt Manager
+
+Newt Manager enables your Mynewt application to communicate with the newtmgr application tool and process 
+newtmgr commands.  Two Newt Manager implementations are provided: newtmgr and oicmgr. You can build one of 
+the two into your application. The one that you select may depend on memory constraints for your application 
+and whether your application supports the OIC (Open Interconnect Consortium) interoperability standard.  
+
+To reduce your application code size, you can customize Newt Manager (newtmgr or oicmgr) to only 
+process the newtmgr commands that your application uses.
+
+### newtmgr
+The newtmgr application tool uses a simple request and response message format to send commands to newtmgr.  A message 
+consists of an eight byte header and the message payload.  The message header specifies the newtmgr command. 
+The message payload contains the newtmgr request/response data and is encoded in 
+CBOR (Concise Binary Object Representation) format.  newtmgr supports BLE and serial connections.
+
+newtmgr has a smaller code size and memory footprint than oicmgr but does not support open connectivity.
+
+### oicmgr
+oicmgr supports the OIC interoperability standard.  Mynewt defines and exposes oicmgr as an OIC Server 
+resource with the following identity and properties: 
+<br>
+<table style="width:50%" align="center">
+<tr> 
+<td>**URI**</td> 
+<td>/omgr</td>
+</tr>
+<tr>
+<td>**Resource Type**(rt)</td>
+<td>x.mynewt.nmgr</td> 
+</tr>
+<td>**Interface**(if)</td>
+<td>oic.if_rw (default), oic.if.baseline</td>
+</tr>
+<td>**Discoverable**</td>
+<td>Yes</td>
+</tr>
+</table>
+The newtmgr application tool uses CoAP (Constrained Application Protocol) requests to send commands to oicmgr.  
+It sends a CoAP request for **/omgr** as follows:
+<ul>
+<li> 
+Specifies the newtmgr command to execute in the URI query string. 
+</li>
+<li> 
+Uses a GET method for newtmgr commands that retreive information 
+from your application, for example, the ```taskstats``` and ```mpstats``` commands. 
+</li>
+<li> 
+Uses a PUT method for newtmgr commands that send data to or modify the state of your application,
+for example, the ```echo``` or ```datetime``` commands. 
+</li>
+<li>
+Sends the CBOR-encoded command request data in the CoAP message payload.
+</li>
+</ul>
+oicmgr supports BLE, serial, and UDP connections.
+
+### Customize Newt Manager with mgmt
+The **mgmt** package enables you to customize Newt Manager (newtmgr or oicmgr) to only process the
+commands that your application uses.  newtmgr commands are divided into management groups.
+A manager package implements the commands for a group.  It implements the handlers that 
+process the commands for the group and registers the handlers with mgmt. 
+When newtmgr or oicmgr receives a newtmgr command, 
+it looks up the handler for the command (by management group id and command id) from mgmt and calls the 
+handler to process the command.   
+
+The system level management groups are listed in following table:
+<table style="width:90%" align="center">
+<tt>
+<td>Management Group</td>
+<td>newtmgr Commands</td>
+<td>Package</td>
+</tt>
+<tr>
+<td>MGMT_GROUP_ID_DEFAULT</td>
+<td>```echo``` ```taskstats``` ```mpstats``` ```datetime``` ```reset```</td>
+<td>mgmt/newtmgr/nmgr_os</td>
+</tr>
+<tr>
+<td>MGMT_GROUP_ID_IMAGE</td>
+<td>```image``` </td>
+<td>mgmt/imgmgr</td>
+</tr>
+<tr>
+<td>MGMT_GROUP_ID_STATS</td>
+<td>```stat``` </td>
+<td>sys/stats</td>
+</tr>
+<tr>
+<td>MGMT_GROUP_ID_CONFIG</td>
+<td>```config```</td>
+<td>sys/config</td>
+</tr>
+<tr>
+<td>MGMT_GROUP_ID_LOGS</td>
+<td>```log```</td>
+<td>sys/log</td>
+</tr>
+<tr>
+<td>MGMT_GROUP_ID_CRASH</td>
+<td>```crash```</td>
+<td>test/crash_test</td>
+</tr>
+<tr>
+<td>MGMT_GROUP_ID_RUNTEST</td>
+<td>```runtest```</td>
+<td>test/runtest</td>
+</tr>
+</table>
+Both newtmgr and ocimgr process the MGMT_GROUP_ID_DEFAULT commands by default.  You can also
+use mgmt to add user defined management group commands. 

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/7cd80682/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index ce9564b..3b53081 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -7,7 +7,6 @@ pages:
 - Home: 'index.md'
 - Pages:
     - Bluetooth Low Energy 4.2: 'pages/ble.md'
-    - Security Lifecycle: 'pages/securitybullets.md' 
 - Quick Start: 'quick-start.md'
 - About: 'about.md'
 - Talks: 'talks.md'
@@ -309,6 +308,8 @@ pages:
                 - 'TEST_CASE': 'os/modules/testutil/test_case.md'
                 - 'TEST_CASE_DECL': 'os/modules/testutil/test_decl.md'
                 - 'tu_restart': 'os/modules/testutil/tu_restart.md'
+        - Newt Manager: 
+            - toc: 'os/modules/newtmgr/newtmgr.md'
         - Image Manager:
             - toc: 'os/modules/imgmgr/imgmgr.md'
             - 'Functions':