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/10/25 07:33:26 UTC

[20/30] incubator-mynewt-site git commit: Added sub pages for ble.html and configurability.html and change landing page blurbs

Added sub pages for ble.html and configurability.html and change landing page blurbs


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/a5e67ab3
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/a5e67ab3
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/a5e67ab3

Branch: refs/heads/landingFormat
Commit: a5e67ab37b91f26c366a43d3ce3da91737c336ee
Parents: 4d77c59
Author: aditihilbert <ad...@runtime.io>
Authored: Fri Oct 21 14:15:54 2016 -0700
Committer: aditihilbert <ad...@runtime.io>
Committed: Fri Oct 21 14:15:54 2016 -0700

----------------------------------------------------------------------
 custom-theme/landing.html               | 76 ++++++++++++++++++----------
 custom-theme/pages/ble.html             | 15 ++++++
 custom-theme/pages/configurability.html | 18 +++++++
 custom-theme/pages/template.html        | 23 ---------
 docs/pages/ble.md                       |  8 +++
 docs/pages/configurability.md           |  8 +++
 docs/pages/template.md                  |  6 ---
 mkdocs.yml                              |  3 +-
 8 files changed, 101 insertions(+), 56 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a5e67ab3/custom-theme/landing.html
----------------------------------------------------------------------
diff --git a/custom-theme/landing.html b/custom-theme/landing.html
index 2b7e69a..69c81ae 100644
--- a/custom-theme/landing.html
+++ b/custom-theme/landing.html
@@ -5,15 +5,17 @@
        <div class="highlight">
             <img src="/img/NimBLE_throughput.png">
 
-            <h2>Bluetooth Low Energy</h2>
+            <h2>Built to be deployable, manageable</h2>
 
-            <p>Run Mynewt\u2019s BLE 4.2 stack NimBLE as a complete stack or choose only its host or its controller part.</p>
+            <p>Ready your IoT network of billions for remote monitoring, troubleshooting, management, and upgrade.</p>
 
-            <p>Mynewt offers NimBLE, a complete Bluetooth Low Energy 4.2 stack featuring source code for both host and controller subsystems. The standardized Hardware Controller Interface (HCI) allows you to mix and match Mynewt\u2019s host or controller portion with another vendor\u2019s controller or host implementation respectively, to suit your product hardware and application.
+            <ul>
+	      <li> Image management module to enable efficient, failure-aware, and reliable remote firmware updates </li>
+              <li> Logging modules that can be invoked at various levels of granularity, including specialized reboot logs </li>
+              <li> Richly instrumented statistics modules for OS components and network interfaces </li>
+              <li> Modularity for selective, optimized composition to extract the best performance from the hardware platform </li>
+            </ul>
 
-The controller implementation is available for a growing list of System on Chips (SoC). It is powerful and flexible, having demonstrated up to 32 concurrent BLE connections between a central and its peripherals. Since Mynewt\u2019s controller exposes several more configuration options than a typical SoC vendor\u2019s implementation, performance can be dramatically increased. For example, by maximizing the packet size and the connection event span in a connection interval using Mynewt, an nRF52 chip from Nordic Semiconductor can achieve 10x the throughput possible with the built-in Soft Device.
-
-Read more about NimBLE in the <a href="https://mynewt.apache.org/latest/network/ble/ble_intro/">BLE User Guide</a>
             </p>
         </div>
 
@@ -22,47 +24,69 @@ Read more about NimBLE in the <a href="https://mynewt.apache.org/latest/network/
                 &nbsp;
             </div>
 
-            <h2>Utilities</h2>
-
-            <p>Utilities such as boot loaders, file systems, time-series data, JSON formatted log request/response, and more </p>
-        </div>
+            <h2>Security from the start</h2>
 
-        <div class="highlight">
-            <img src="/img/concurrent_conn.png">
+            <p> Ensure security is built into the code as well as lifecycle management for your product. </p>
+            <ul>
+              <li>Secure bootloader to verify firmware integrity and authenticity  </li>
+              <li>Device identity for secure provisioning  </li>
+              <li>Authenticated, authorized, and encrypted data transfers  </li>
+              <li>Abstracted interface to leverage hardware security </li>
+            </ul>
 
-            <h2>Highly Configurable</h2>
 
-            <p>Direct access to peripherals for granular control to better utilize the resources of the target embedded platform</p>
         </div>
 
         <div class="highlight">
-            <img src="/img/atmel.png" style="margin-top: 0px;">
+            <img src="/img/concurrent_conn.png">
 
-            <h2>Multiple connectivity options</h2>
+            <h2>Built for wireless networking</h2>
 
-            <p>Choose your communication technology depending on your application requirements such as power demands, amount of data transfer, deployment model and more.</p>
+            <p> Meet your application\u2019s demands with open source networking stacks e.g. Bluetooth Low Energy 4.2. </p>
+
+            <ul>
+              <li> Flexible, powerful BLE implementation </li>
+		<ul>
+		  <li> Full stack, host only, or controller only - your choice </li>
+		  <li> 10x throughput of Nordic Softdevice </li>
+		  <li> 2x as many concurrent connections as Nordic Softdevice </li>
+		  <li> 4x as many active connections in simulatenous central and peripheral roles as Intel Zephyr and Nordic Softdevice </li>
+                  <li> <a href="/pages/ble/">more detail...</a> </li>
+                </ul>
+              <li> Additional connectivity options include WiFi </li>
+              <li> Native support for TCP/IP, UDP </li>
+              <li> Supports protocols for constrained networks e.g. CoAP and 6LoWPAN </li>
+            </ul>
 
-            <p>
-                Mynewt offers a choice of high-performance networking stacks suitable for a range of IoT applications. It includes native support for the pervasive TCP/IP networking protocol suite. It offers Wi-Fi services to an application via a socket API that accesses Wi-Fi controllers and an abstracted interface to Wi-Fi supplicants. Mynewt also includes protocols with considerations and optimizations for constrained devices such as CoAP, 6LoWPAN, and of course, BLE. Several other protocols appropriate for IoT applications are under consideration in the community.
-            </p>
         </div>
 
         <div class="highlight">
             <img src="/img/secure_img.png" style="width:400px;">
 
-            <h2>Secure</h2>
+            <h2>Cross platforms</h2>
 
-            <p>Ensure security is built into the code as well as lifecycle management for your product.</p>
+            <p> Pick one MCU now. Migrate to another later. </p>
+
+            <ul>
+              <li> Designed to be hardware agnostic - Cortex M0-M4 micro controllers, MIPS, RISC-V </li>
+              <li> Hardware Abstraction Layer (HAL) to provide a uniform interface for peripherals across various micro controllers </li>
+              <li> Board specific configurations are abstracted in Board Support Packages (BSP) </li>
+            </ul>
 
-            <p>
-                Mynewt goes beyond providing crypto libraries for secure connections between devices or between a service and remote devices to ensure confidentiality, integrity, and availability of all concerned assets. It also provides the framework and functionality to manage a device securely from its birth to end of life. Mynewt offers a secure bootloader that verifies the authenticity and integrity of firmware image before booting from it. It enables secure image upgrade both remotely over-the-air and locally through a serial interface. With an abstracted interface to hardware security features such as secure memory and crypto accelerators, Mynewt enables components like the BLE stack as well as applications to leverage them easily.
-            </p>
         </div>
 
         <div class="highlight">
             <img src="/img/newt-img.png" style="width:400px;">
             <h2>Easy to use</h2>
-            <p>Easily composable modules and HAL (Hardware Abstraction Layer) for portability </p>
+            <p> Compose, fine-tune, and build your image within hours or even minutes. </p>
+
+            <ul>
+	      <li> Hardware initialization in single configuration file for the chosen BSP </li>
+              <li> Initialization of service parameters in a single configuration file for the chosen module e.g. BLE controller </li>
+              <li> Smart package management and build using Newt Tool </li>
+              <li> Automatic configuration audits using Newt Tool </li>
+              <li> <a href="/pages/configurability/">more detail...</a> </li>
+            </ul>
         </div>
 
         <div class="updates">

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a5e67ab3/custom-theme/pages/ble.html
----------------------------------------------------------------------
diff --git a/custom-theme/pages/ble.html b/custom-theme/pages/ble.html
new file mode 100644
index 0000000..8af9701
--- /dev/null
+++ b/custom-theme/pages/ble.html
@@ -0,0 +1,15 @@
+<div class="col-xs-12 v2-sub-page">
+
+    <h2>Bluetooth Low Energy (BLE 4.2) </h2>
+    <p>
+      
+   For low power IoT applications, Mynewt offers NimBLE, a complete Bluetooth Low Energy 4.2 stack featuring source code for both host and controller subsystems. You can choose to run NimBLE as a complete stack or use only its host or its controller part. The standardized Hardware Controller Interface (HCI) allows you to mix and match Mynewt\u2019s host or controller portion with another vendor\u2019s controller or host implementation respectively, to suit your product hardware and application. 
+    </p>
+    <p>
+The controller implementation is available for a growing list of System on Chips (SoC). It is powerful and flexible, having demonstrated up to 32 concurrent BLE connections between a central and its peripherals. Since Mynewt\u2019s controller exposes several more configuration options than a typical SoC vendor\u2019s implementation, performance can be dramatically increased. For example, by maximizing the packet size and the connection event span in a connection interval using Mynewt, an nRF52 chip from Nordic Semiconductor can achieve 10x the throughput possible with the built-in Soft Device. Read more about NimBLE in <a href="../../network/ble/ble_intro/">Documentation</a>  
+    
+    </p>
+
+    {{ content }}
+
+</div>

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a5e67ab3/custom-theme/pages/configurability.html
----------------------------------------------------------------------
diff --git a/custom-theme/pages/configurability.html b/custom-theme/pages/configurability.html
new file mode 100644
index 0000000..0f8a175
--- /dev/null
+++ b/custom-theme/pages/configurability.html
@@ -0,0 +1,18 @@
+<div class="col-xs-12 v2-sub-page">
+
+    <h2>Newt Tool makes it easy to Compose and Configure</h2>
+    <p>
+    Mynewt  exposes a highly granular set of configuration parameters for each software module or service. For example, the BLE controller stack allows the user to set parameters such as the whitelist size, sleep clock accuracy, number of slots to allocate to each connection, transmit power level, and plenty more. To keep configuration clean and simple, settings are specified in a single syscfg.yml configuration file in each package. Sensible defaults are built into all the configuration files to allow a quick build for simple, straightforward applications.
+    </p>
+    <p>
+Hardware initialization sets up the flash map and peripherals such as UART, ADC, SPI, I2C etc. on the chosen board. For consistency, this hardware-specific initialization is also done using a single syscfg.yml configuration file for the BSP (Board Support Package). Again, sensible defaults are built into all the configuration files for common use cases.  
+    </p>
+    <p>
+Mynewt comes with a powerful configuration and build tool called Newt. It can automatically generate a single, comprehensive system configuration file from the various software and hardware initialization files. This makes system configuration audits easy. Newt Tool can manage task and interrupt priority settings. It can also detect and resolve conflicts in package dependencies. It comes with utilities such as generating digitally signed images. In short, putting an image together for your application becomes easy with the Newt Tool.
+
+    </p>
+
+
+    {{ content }}
+
+</div>

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a5e67ab3/custom-theme/pages/template.html
----------------------------------------------------------------------
diff --git a/custom-theme/pages/template.html b/custom-theme/pages/template.html
deleted file mode 100644
index 30f4a1f..0000000
--- a/custom-theme/pages/template.html
+++ /dev/null
@@ -1,23 +0,0 @@
-<div class="col-xs-12 v2-sub-page">
-
-    <h2>Something about MyNewt that will not fit on the landing page</h2>
-    <p>
-        Non eram nescius, Brute, cum, quae summis ingeniis exquisitaque doctrina philosophi Graeco sermone tractavissent, ea Latinis litteris mandaremus, fore ut hic noster labor in varias reprehensiones incurreret. nam quibusdam, et iis quidem non admodum indoctis,
-        totum hoc displicet philosophari. quidam autem non tam id reprehendunt, si remissius agatur, sed tantum studium tamque multam operam ponendam in eo non arbitrantur. erunt etiam, et ii quidem eruditi Graecis litteris, contemnentes Latinas, qui se dicant
-        in Graecis legendis operam malle consumere. postremo aliquos futuros suspicor, qui me ad alias litteras vocent, genus hoc scribendi, etsi sit elegans, personae tamen et dignitatis esse negent.
-    </p>
-
-    <p>
-        Link to this with <a href="/pages/template/">more detail...</a>
-    </p>
-
-    <h2>Another Chunk</h2>
-    <p>
-        Non eram nescius, Brute, cum, quae summis ingeniis exquisitaque doctrina philosophi Graeco sermone tractavissent, ea Latinis litteris mandaremus, fore ut hic noster labor in varias reprehensiones incurreret. nam quibusdam, et iis quidem non admodum indoctis,
-        totum hoc displicet philosophari. quidam autem non tam id reprehendunt, si remissius agatur, sed tantum studium tamque multam operam ponendam in eo non arbitrantur. erunt etiam, et ii quidem eruditi Graecis litteris, contemnentes Latinas, qui se dicant
-        in Graecis legendis operam malle consumere. postremo aliquos futuros suspicor, qui me ad alias litteras vocent, genus hoc scribendi, etsi sit elegans, personae tamen et dignitatis esse negent.
-    </p>
-
-    {{ content }}
-
-</div>

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a5e67ab3/docs/pages/ble.md
----------------------------------------------------------------------
diff --git a/docs/pages/ble.md b/docs/pages/ble.md
new file mode 100644
index 0000000..251db32
--- /dev/null
+++ b/docs/pages/ble.md
@@ -0,0 +1,8 @@
+html: pages/ble.html
+sub_page: True
+
+<!--
+## Markdown
+
+You could make a page with markdown but then you will need to add a {{ content }} to your pages/whatever.html.
+-->

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a5e67ab3/docs/pages/configurability.md
----------------------------------------------------------------------
diff --git a/docs/pages/configurability.md b/docs/pages/configurability.md
new file mode 100644
index 0000000..58025cf
--- /dev/null
+++ b/docs/pages/configurability.md
@@ -0,0 +1,8 @@
+html: pages/configurability.html
+sub_page: True
+
+<!--
+## Markdown
+
+You could make a page with markdown but then you will need to add a {{ content }} to your pages/whatever.html.
+-->

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a5e67ab3/docs/pages/template.md
----------------------------------------------------------------------
diff --git a/docs/pages/template.md b/docs/pages/template.md
deleted file mode 100644
index 7ce124f..0000000
--- a/docs/pages/template.md
+++ /dev/null
@@ -1,6 +0,0 @@
-html: pages/template.html
-sub_page: True
-
-## Markdown
-
-You could make a page with markdown but then you will need to add a {{ content }} to your pages/whatever.html.

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a5e67ab3/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index b952e82..4b9f521 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -6,7 +6,8 @@ theme_dir: 'custom-theme'
 pages:
 - Home: 'index.md'
 - Pages:
-    - Page Title: 'pages/template.md'
+    - Bluetooth Low Energy 4.2: 'pages/ble.md'
+    - Newt build and configuration Tool: 'pages/configurability.md' 
 - Quick Start: 'quick-start.md'
 - About: 'about.md'
 - Download: 'download.md'