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/11/28 21:19:11 UTC

[01/10] incubator-mynewt-site git commit: Changed mkdocs.yml to add console and shell tutorial and serial connection how to. This closes #127.

Repository: incubator-mynewt-site
Updated Branches:
  refs/heads/master 12ebf161b -> 3fdca23f3


Changed mkdocs.yml to add console and shell tutorial and serial connection how to. This closes #127.


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

Branch: refs/heads/master
Commit: 4637b320bc0f1211e583c90e2e1da102c179b295
Parents: 12ebf16
Author: aditihilbert <ad...@runtime.io>
Authored: Mon Nov 28 10:34:24 2016 -0800
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 10:34:24 2016 -0800

----------------------------------------------------------------------
 mkdocs.yml | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/4637b320/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index bd466ff..8275413 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -25,6 +25,7 @@ pages:
             - 'Install Newt on Linux': 'newt/install/newt_linux.md'
             - 'Install Cross Tools for ARM': 'os/get_started/cross_tools.md'
         - 'Create Your First Project': 'os/get_started/project_create.md'
+        - 'Serial Port Setup': 'os/get_started/serial_access.md'
     - Concepts: 'os/get_started/vocabulary.md'
     - Tutorials:
         - toc: 'os/tutorials/tutorials.md'
@@ -39,13 +40,16 @@ pages:
             - 'Run Blinky from SRAM, no bootloader': 'os/tutorials/blinky_sram_olimex.md'
         - 'Work with repositories':
             - toc: 'os/tutorials/repo/add_repos.md'
-            - 'Upgrade a repo': 'os/tutorials/repo/upgrade_repo.md'
-            - 'Turn project into a repo': 'os/tutorials/repo/create_repo.md'
+            - 'Upgrade a Repo': 'os/tutorials/repo/upgrade_repo.md'
+            - 'Turn project into a Repo': 'os/tutorials/repo/create_repo.md'
         - 'Write a Test Suite for a Package': 'os/tutorials/unit_test.md'
         - 'Air-quality Sensor project': 'os/tutorials/air_quality_sensor.md'
         - 'Add task to manage multiple events': 'os/tutorials/event_queue.md'
-        - 'Enable remote comms on sim device': 'os/tutorials/project-slinky.md'
-        - 'Enable remote comms on STM32 board': 'os/tutorials/project-target-slinky.md'
+        - 'Project Slinky for remote comms': 
+	      - 'Slinky on sim device': 'os/tutorials/project-slinky.md'
+              - 'Slinky on STM32 board': 'os/tutorials/project-target-slinky.md'
+        - 'Enable newtmgr in any app': 'os/tutorials/add_newtmgr.md' 
+ +      - 'Enable the OS Shell and Console': 'os/tutorials/add_shell.md'
         - 'BLE app to check stats via console': 'os/tutorials/bletiny_project.md'
         - 'BLE peripheral project':
             - toc: 'os/tutorials/bleprph/bleprph-intro.md'

[04/10] incubator-mynewt-site git commit: Updated Task lesson

Posted by ad...@apache.org.
Updated Task lesson

Updated task lesson for latest changes


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

Branch: refs/heads/master
Commit: dbf11611df787cf8b3cc72309c6a003c8bff862e
Parents: 0862fea
Author: David G. Simmons <sa...@mac.com>
Authored: Tue Nov 22 13:21:16 2016 -0500
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 10:52:59 2016 -0800

----------------------------------------------------------------------
 docs/os/tutorials/tasks_lesson.md | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/dbf11611/docs/os/tutorials/tasks_lesson.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/tasks_lesson.md b/docs/os/tutorials/tasks_lesson.md
index b3a21de..2b84e48 100644
--- a/docs/os/tutorials/tasks_lesson.md
+++ b/docs/os/tutorials/tasks_lesson.md
@@ -35,7 +35,7 @@ in main.c (located in apps/blinky/src):
 struct os_task work_task;
 ```
 
-A task is represented by the [*os_task*](http://mynewt.apache.org/os/core_os/task/task/#data-structures)  
+A task is represented by the [*os_task*](http://mynewt.apache.org/os/core_os/task/task/#data-structures) 
 struct which will hold the task\u2019s information (name, state, priority, etc.). A task is made up of two 
 main elements, a task function (also known as a task handler) and a task stack.
 
@@ -50,7 +50,6 @@ which are generally 32 bits, making our entire stack 1024 Bytes.
 
 ```c
   #define WORK_STACK_SIZE OS_STACK_ALIGN(256)
-  os_stack_t work_stack[WORK_STACK_SIZE];
 ```
 
 
@@ -97,13 +96,17 @@ Let\u2019s set the priority of `work_task` to 0, because everyone knows that work i
 ### Initialization
 To initialize a new task we use [*os_task_init()*](http://mynewt.apache.org/os/core_os/task/os_task_init/) 
 which takes a number of arguments including our new task function, stack, and priority. Much like `blinky_task`, 
-we\u2019re going to initialize `work_task` inside `init_tasks` to keep our main function clean.
+we\u2019re going to initialize `work_task` inside `init_tasks` to keep our main function clean. We'll set the task stack here and pass it to the `os_task_init()` function as well.
 
 ```c
 int
 init_tasks(void)
 {
     /* \u2026 */
+    os_stack_t *work_stack;
+    work_stack = malloc(sizeof(os_stack_t)*WORK_STACK_SIZE);
+    
+    assert(pstack);
     os_task_init(&work_task, "work", work_task_handler, NULL,
             WORK_TASK_PRIO, OS_WAIT_FOREVER, work_stack,
             WORK_STACK_SIZE);
@@ -151,6 +154,7 @@ os_task_init(&mytask, "mytask", mytask_handler, NULL,
 ```
 
 ##Task Priority, Preempting, and Context Switching
+
 A preemptive RTOS is one in which a higher priority task that is *ready to run* will preempt (i.e. take the 
 place of) the lower priority task which is *running*. When a lower priority task is preempted by a higher 
 priority task, the lower priority task\u2019s context data (stack pointer, registers, etc.) is saved and the new 
@@ -237,9 +241,9 @@ Set a new app location.
 $ newt target set task_tgt app=apps/mynewt_tasks_lesson
 ```
 
-Now let\u2019s take a look at our new code. First, notice that we have abandoned blinking, instead choosing t
-o use the [*console*](http://mynewt.apache.org/latest/os/modules/console/console/) and [*shell*](http://mynewt.apache.org/latest/os/modules/shell/shell/) 
-to follow our tasks through execution.
+Now let\u2019s take a look at our new code. First, notice that we have abandoned blinking, instead 
+choosing to use the [*console*](http://mynewt.apache.org/latest/os/modules/console/console/) 
+and [*shell*](http://mynewt.apache.org/latest/os/modules/shell/shell/) to follow our tasks through execution.
 
 Additionally, we have a number of different tasks:
 
@@ -398,7 +402,8 @@ rate, Task B would take over a minute to finish one cycle.
 
 Feel free to play around with the testing parameters to study the different changes yourself!
 
-##Conclusion
+###Conclusion
+
 Moving forward, tasks are just the tip of the iceberg. The [*scheduler*](http://mynewt.apache.org/latest/os/core_os/context_switch/context_switch/), 
 [*event queues*](http://mynewt.apache.org/latest/os/core_os/event_queue/event_queue/), 
 [*semaphores*](http://mynewt.apache.org/latest/os/core_os/semaphore/semaphore/), and

[08/10] incubator-mynewt-site git commit: Updated link to serial tutorial

Posted by ad...@apache.org.
Updated link to serial tutorial


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

Branch: refs/heads/master
Commit: 6d99db18240f9dc73047e9608e93bc4be21488f7
Parents: 9f06a93
Author: David G. Simmons <sa...@mac.com>
Authored: Mon Nov 28 11:31:41 2016 -0500
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 10:53:46 2016 -0800

----------------------------------------------------------------------
 docs/os/tutorials/add_shell.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/6d99db18/docs/os/tutorials/add_shell.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/add_shell.md b/docs/os/tutorials/add_shell.md
index a5b0e91..f3739b5 100644
--- a/docs/os/tutorials/add_shell.md
+++ b/docs/os/tutorials/add_shell.md
@@ -102,7 +102,7 @@ $ newt load myble
 
 ### Set up Serial connection
 
-You'll need a Serial connection to see the output of your program. You can see the instructions in the [Tasks and Priority Management](tasks_lesson.md) 
+You'll need a Serial connection to see the output of your program. You can reference the [Serial Port Setup](../get_started/serial_access.md) 
 Tutorial for more information on setting up your serial communications.
 
 <br>

[06/10] incubator-mynewt-site git commit: graphic removed

Posted by ad...@apache.org.
graphic removed


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

Branch: refs/heads/master
Commit: 9b02d39930bd5528b9392e0e3d0e69bfbe13a40b
Parents: 94b06dd
Author: David G. Simmons <sa...@mac.com>
Authored: Wed Nov 23 11:35:39 2016 -0500
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 10:53:19 2016 -0800

----------------------------------------------------------------------
 docs/os/get_started/pics/x.png | Bin 5630775 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/9b02d399/docs/os/get_started/pics/x.png
----------------------------------------------------------------------
diff --git a/docs/os/get_started/pics/x.png b/docs/os/get_started/pics/x.png
deleted file mode 100644
index 400fa62..0000000
Binary files a/docs/os/get_started/pics/x.png and /dev/null differ

[05/10] incubator-mynewt-site git commit: Serial Comms Tutorial

Posted by ad...@apache.org.
Serial Comms Tutorial

Shows you how to set up serial communications with the NRF52DK and
Arduino M0 Pro using am FT232H Serial UART board.


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

Branch: refs/heads/master
Commit: 94b06dd006ef16076aa589f114e577ff65558799
Parents: dbf1161
Author: David G. Simmons <sa...@mac.com>
Authored: Wed Nov 23 11:33:48 2016 -0500
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 10:53:09 2016 -0800

----------------------------------------------------------------------
 docs/os/get_started/pics/ft232h.png  | Bin 0 -> 572354 bytes
 docs/os/get_started/pics/m0pro.png   | Bin 0 -> 613306 bytes
 docs/os/get_started/pics/nrf52dk.png | Bin 0 -> 517522 bytes
 docs/os/get_started/pics/x.png       | Bin 0 -> 5630775 bytes
 docs/os/get_started/serial_access.md | 118 ++++++++++++++++++++++++++++++
 mkdocs.yml                           |   1 +
 6 files changed, 119 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/94b06dd0/docs/os/get_started/pics/ft232h.png
----------------------------------------------------------------------
diff --git a/docs/os/get_started/pics/ft232h.png b/docs/os/get_started/pics/ft232h.png
new file mode 100644
index 0000000..f907f8f
Binary files /dev/null and b/docs/os/get_started/pics/ft232h.png differ

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/94b06dd0/docs/os/get_started/pics/m0pro.png
----------------------------------------------------------------------
diff --git a/docs/os/get_started/pics/m0pro.png b/docs/os/get_started/pics/m0pro.png
new file mode 100644
index 0000000..e3ac967
Binary files /dev/null and b/docs/os/get_started/pics/m0pro.png differ

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/94b06dd0/docs/os/get_started/pics/nrf52dk.png
----------------------------------------------------------------------
diff --git a/docs/os/get_started/pics/nrf52dk.png b/docs/os/get_started/pics/nrf52dk.png
new file mode 100644
index 0000000..6b24805
Binary files /dev/null and b/docs/os/get_started/pics/nrf52dk.png differ

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/94b06dd0/docs/os/get_started/pics/x.png
----------------------------------------------------------------------
diff --git a/docs/os/get_started/pics/x.png b/docs/os/get_started/pics/x.png
new file mode 100644
index 0000000..400fa62
Binary files /dev/null and b/docs/os/get_started/pics/x.png differ

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/94b06dd0/docs/os/get_started/serial_access.md
----------------------------------------------------------------------
diff --git a/docs/os/get_started/serial_access.md b/docs/os/get_started/serial_access.md
new file mode 100644
index 0000000..21aa838
--- /dev/null
+++ b/docs/os/get_started/serial_access.md
@@ -0,0 +1,118 @@
+#Using the Serial Port with Mynewt OS
+
+Some of the projects and tutorials here will allow you to use a serial port
+to interact with your Mynewt project. While most modern PCs and laptops
+no longer have a true serial port, almost all can use their USB ports
+as serial ports. 
+
+This will show you how to connect to some of the development boards
+we use via a serial port. 
+
+The development boards covered here are:
+
+* Nordic Semiconductor NRF52dk
+* Arduino M0 Pro
+
+In order to communicate with these boards you will also need a USB<-->Serial
+converted. We'll be using the [AdaFruit FT232H Breakout Board](https://www.adafruit.com/products/2264) for
+this, but almost any similar board should work just as well. You will also
+need Minicom or a similar Serial communications application. We'll show you how
+to use the `screen` command built in to Mac OS X, but later tutorials will
+also show Minicom setup.
+
+So let's get started!
+
+<br>
+
+##Setup FT232H 
+
+This is a great board because it's so easy to set up, and it can do Serial UART,
+SPI, I2C and GPIO as well. There's full documentation on the board [here](https://learn.adafruit.com/adafruit-ft232h-breakout/overview)
+ but we're only covering the wiring for the Serial UART. 
+ 
+Start by connecting a jumper wire to Pin D0. This will be the UART Tx pin, 
+which we'll then connect to the Rx pin on the Development Board.
+
+Next connect a jumper wire to pin D1. This will be the UART Rx pin,
+which we'll connect to the Tx pin on the development board.
+
+Finally connect a jumper wire to the GND pin.
+
+It should look like this:
+
+![FT232H Wiring](pics/ft232h.png)
+
+<br>
+
+##Setup Nordic Semiconductor NRF52DK
+
+On the NRF52DK developer kit board, the Rx pin is P0.08, so you'll attach your
+jumper wire from the Tx pin (D0) of the FT232H board here.
+
+The TX Pin is pin P0.08, so you'll attache the jumper wire from the Rx Pin (D1)
+on the FT232H board here. 
+
+Finally, the GND wire should go to the GND Pin on the NRF52DK. When you're
+done, your wiring should look like this:
+
+![NRF52DK Wiring](pics/nrf52dk.png) 
+
+<br>
+
+##Setup Arduino M0 Pro
+
+On the Arduino M0 Pro, the Tx and Rx pins are clearly labeled as such, as is the GND
+pin. Just make sure you wire Rx from the FT232H to TX on the M0 Pro, and vice-versa.
+
+Your Arduino M0 Pro should look like this:
+
+![Arduino M0 Pro Wiring](pics/m0pro.png)
+
+<br>
+
+##Setup Serial Communications
+
+As mentioned earlier, we'll be using the built in `screen` command for this, but we'll still 
+need to know which serial port to connect to. So, before plugging in the FT232H Board, 
+check to see what USB devices are already connected:
+
+```
+$ ls -la /dev/*usb*
+0 crw-rw-rw-  1 root  wheel   20,  63 Nov 23 11:13 /dev/cu.usbmodem401322
+0 crw-rw-rw-  1 root  wheel   20,  62 Nov 23 11:13 /dev/tty.usbmodem401322
+$
+```
+
+Now, plug in the FT232H board, and run that command again:
+
+```
+$ ls -la /dev/*usb*
+0 crw-rw-rw-  1 root  wheel   20,  63 Nov 23 11:13 /dev/cu.usbmodem401322
+0 crw-rw-rw-  1 root  wheel   20,  65 Nov 23 11:26 /dev/cu.usbserial-0020124
+0 crw-rw-rw-  1 root  wheel   20,  62 Nov 23 11:13 /dev/tty.usbmodem401322
+0 crw-rw-rw-  1 root  wheel   20,  64 Nov 23 11:26 /dev/tty.usbserial-0020124
+$
+```
+
+So the FT232H is connected to `/dev/tty.usbserial-0020124` (The number after tty.usbserial
+will be different on your machine.)
+
+So let's connect to it:
+
+```
+$ screen /dev/tty.usbserial-0020124 115200
+```
+
+If there's no Mynewt app running, or the Mynewt app doesn't have the Shell and Console
+enabled, you won't see anything there, but you can always refer back to this page
+from later tutorials if you need to.
+
+To exit out of `screen` you'll type `control-A` followed by `control-\` and you'll
+be back to a terminal prompt.
+
+Now that you know how to communicate with your mynewt application, let's move on to
+creating one!
+
+<br>
+
+

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/94b06dd0/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index cd5d6d4..0edf61a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -24,6 +24,7 @@ pages:
             - 'Install Newt on Mac': 'newt/install/newt_mac.md'
             - 'Install Newt on Linux': 'newt/install/newt_linux.md'
             - 'Install Cross Tools for ARM': 'os/get_started/cross_tools.md'
+        - 'Serial Port Setup': 'os/get_started/serial_access.md'
         - 'Create Your First Project': 'os/get_started/project_create.md'
         - 'Serial Port Setup': 'os/get_started/serial_access.md'
     - Concepts: 'os/get_started/vocabulary.md'

[07/10] incubator-mynewt-site git commit: Updated tutorials for Serial Comms

Posted by ad...@apache.org.
Updated tutorials for Serial Comms

Linked tutorials to the new Serial Comms tutorial.


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

Branch: refs/heads/master
Commit: 9f06a93930d2704d1b18e3fa882f2210792edee1
Parents: 9b02d39
Author: David G. Simmons <sa...@mac.com>
Authored: Wed Nov 23 11:56:29 2016 -0500
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 10:53:36 2016 -0800

----------------------------------------------------------------------
 docs/os/get_started/serial_access.md | 23 +++++++++++++++++++++--
 docs/os/tutorials/bletiny_project.md |  8 ++++----
 docs/os/tutorials/tasks_lesson.md    | 16 ++--------------
 3 files changed, 27 insertions(+), 20 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/9f06a939/docs/os/get_started/serial_access.md
----------------------------------------------------------------------
diff --git a/docs/os/get_started/serial_access.md b/docs/os/get_started/serial_access.md
index 21aa838..57dd6d1 100644
--- a/docs/os/get_started/serial_access.md
+++ b/docs/os/get_started/serial_access.md
@@ -103,12 +103,31 @@ So let's connect to it:
 $ screen /dev/tty.usbserial-0020124 115200
 ```
 
+To exit out of `screen` you'll type `control-A` followed by `control-\` and you'll
+be back to a terminal prompt.
+
+If you'd like to use Minicom:
+
+```
+$ minicom -D /dev/tty.usbserial-0020124
+
+```
+Welcome to minicom 2.7
+
+OPTIONS: 
+Compiled on Nov 24 2015, 16:14:21.
+Port /dev/tty.usbserial-0020124, 09:57:17
+
+Press Meta-Z for help on special keys
+```
+
+<br>
+
 If there's no Mynewt app running, or the Mynewt app doesn't have the Shell and Console
 enabled, you won't see anything there, but you can always refer back to this page
 from later tutorials if you need to.
 
-To exit out of `screen` you'll type `control-A` followed by `control-\` and you'll
-be back to a terminal prompt.
+
 
 Now that you know how to communicate with your mynewt application, let's move on to
 creating one!

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/9f06a939/docs/os/tutorials/bletiny_project.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/bletiny_project.md b/docs/os/tutorials/bletiny_project.md
index 495a8b3..5a49339 100644
--- a/docs/os/tutorials/bletiny_project.md
+++ b/docs/os/tutorials/bletiny_project.md
@@ -143,13 +143,13 @@ $ newt load myble
 
 ### Establish serial connection
 
-You will now look for some BLE related stats over a serial connection and see the radio is actually working. The picture below shows a serial connector set up. Pin PA.08 is RX and pin PA.06 is TX. Make sure TX from the NRF52 goes to RX on your Serial board, and that RX on the NRF52 goes to TX on your Serial Board.
-
-![nRF52](pics/nrf52.JPG "nRF52 Dev Board with a Serial Connection set up")
+You will now look for some BLE related stats over a serial connection and see the radio is actually working. 
+If you haven't done so already, make sure you're familiar with the [Serial Port Setup and Configuration](../get_started/serial_access.md)
+section. 
 
 <br>
 
-You may use any terminal emulation program to communicate with the board. This tutorial shows a Minicom set up. You will have to find out what the usbserial port number is on your laptop, of course.
+You may use any terminal emulation program to communicate with the board. This tutorial shows a Minicom set up. 
 
 
 ```

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/9f06a939/docs/os/tutorials/tasks_lesson.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/tasks_lesson.md b/docs/os/tutorials/tasks_lesson.md
index 2b84e48..39ff6ab 100644
--- a/docs/os/tutorials/tasks_lesson.md
+++ b/docs/os/tutorials/tasks_lesson.md
@@ -281,20 +281,8 @@ $ cd repos/mynewt_arduino_zero
 $ git checkout develop
 ```
 
-Open a new terminal window and list your serial connections to find our Arduino.
-```c
-$ ls /dev/tty.*
-
-/dev/tty.Bluetooth-Incoming-Port /dev/tty.usbmodem14132
-```
-
-In the same window, connect to the serial port using a serial communication program. 
-In this case I\u2019ll be using mincom as it can scroll through output.
-```c
-$ minicom -D /dev/tty.usbmodem14132 -b 115200
-```
-
-If you see minicom welcome you, you\u2019re ready to move on!
+You should already be familiar with the [Serial Port Setup and Configuration](../get_started/serial_access.md), but if
+you're not, you can go there now and then come back. 
 
 ### Output Analysis

[10/10] incubator-mynewt-site git commit: This closes #127. edits in bletiny_project.md and tasks

Posted by ad...@apache.org.
This closes #127. edits in bletiny_project.md and tasks


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

Branch: refs/heads/master
Commit: 3fdca23f33549196d0f896834a76254e067dfbbd
Parents: 054e387
Author: aditihilbert <ad...@runtime.io>
Authored: Mon Nov 28 11:57:13 2016 -0800
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 12:08:17 2016 -0800

----------------------------------------------------------------------
 docs/os/tutorials/bletiny_project.md |  8 +++----
 docs/os/tutorials/tasks_lesson.md    | 35 ++++++++++++++++++-------------
 mkdocs.yml                           | 14 ++++---------
 3 files changed, 29 insertions(+), 28 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/3fdca23f/docs/os/tutorials/bletiny_project.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/bletiny_project.md b/docs/os/tutorials/bletiny_project.md
index 5a49339..495a8b3 100644
--- a/docs/os/tutorials/bletiny_project.md
+++ b/docs/os/tutorials/bletiny_project.md
@@ -143,13 +143,13 @@ $ newt load myble
 
 ### Establish serial connection
 
-You will now look for some BLE related stats over a serial connection and see the radio is actually working. 
-If you haven't done so already, make sure you're familiar with the [Serial Port Setup and Configuration](../get_started/serial_access.md)
-section. 
+You will now look for some BLE related stats over a serial connection and see the radio is actually working. The picture below shows a serial connector set up. Pin PA.08 is RX and pin PA.06 is TX. Make sure TX from the NRF52 goes to RX on your Serial board, and that RX on the NRF52 goes to TX on your Serial Board.
+
+![nRF52](pics/nrf52.JPG "nRF52 Dev Board with a Serial Connection set up")
 
 <br>
 
-You may use any terminal emulation program to communicate with the board. This tutorial shows a Minicom set up. 
+You may use any terminal emulation program to communicate with the board. This tutorial shows a Minicom set up. You will have to find out what the usbserial port number is on your laptop, of course.
 
 
 ```

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/3fdca23f/docs/os/tutorials/tasks_lesson.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/tasks_lesson.md b/docs/os/tutorials/tasks_lesson.md
index 39ff6ab..b3a21de 100644
--- a/docs/os/tutorials/tasks_lesson.md
+++ b/docs/os/tutorials/tasks_lesson.md
@@ -35,7 +35,7 @@ in main.c (located in apps/blinky/src):
 struct os_task work_task;
 ```
 
-A task is represented by the [*os_task*](http://mynewt.apache.org/os/core_os/task/task/#data-structures) 
+A task is represented by the [*os_task*](http://mynewt.apache.org/os/core_os/task/task/#data-structures)  
 struct which will hold the task\u2019s information (name, state, priority, etc.). A task is made up of two 
 main elements, a task function (also known as a task handler) and a task stack.
 
@@ -50,6 +50,7 @@ which are generally 32 bits, making our entire stack 1024 Bytes.
 
 ```c
   #define WORK_STACK_SIZE OS_STACK_ALIGN(256)
+  os_stack_t work_stack[WORK_STACK_SIZE];
 ```
 
 
@@ -96,17 +97,13 @@ Let\u2019s set the priority of `work_task` to 0, because everyone knows that work i
 ### Initialization
 To initialize a new task we use [*os_task_init()*](http://mynewt.apache.org/os/core_os/task/os_task_init/) 
 which takes a number of arguments including our new task function, stack, and priority. Much like `blinky_task`, 
-we\u2019re going to initialize `work_task` inside `init_tasks` to keep our main function clean. We'll set the task stack here and pass it to the `os_task_init()` function as well.
+we\u2019re going to initialize `work_task` inside `init_tasks` to keep our main function clean.
 
 ```c
 int
 init_tasks(void)
 {
     /* \u2026 */
-    os_stack_t *work_stack;
-    work_stack = malloc(sizeof(os_stack_t)*WORK_STACK_SIZE);
-    
-    assert(pstack);
     os_task_init(&work_task, "work", work_task_handler, NULL,
             WORK_TASK_PRIO, OS_WAIT_FOREVER, work_stack,
             WORK_STACK_SIZE);
@@ -154,7 +151,6 @@ os_task_init(&mytask, "mytask", mytask_handler, NULL,
 ```
 
 ##Task Priority, Preempting, and Context Switching
-
 A preemptive RTOS is one in which a higher priority task that is *ready to run* will preempt (i.e. take the 
 place of) the lower priority task which is *running*. When a lower priority task is preempted by a higher 
 priority task, the lower priority task\u2019s context data (stack pointer, registers, etc.) is saved and the new 
@@ -241,9 +237,9 @@ Set a new app location.
 $ newt target set task_tgt app=apps/mynewt_tasks_lesson
 ```
 
-Now let\u2019s take a look at our new code. First, notice that we have abandoned blinking, instead 
-choosing to use the [*console*](http://mynewt.apache.org/latest/os/modules/console/console/) 
-and [*shell*](http://mynewt.apache.org/latest/os/modules/shell/shell/) to follow our tasks through execution.
+Now let\u2019s take a look at our new code. First, notice that we have abandoned blinking, instead choosing t
+o use the [*console*](http://mynewt.apache.org/latest/os/modules/console/console/) and [*shell*](http://mynewt.apache.org/latest/os/modules/shell/shell/) 
+to follow our tasks through execution.
 
 Additionally, we have a number of different tasks:
 
@@ -281,8 +277,20 @@ $ cd repos/mynewt_arduino_zero
 $ git checkout develop
 ```
 
-You should already be familiar with the [Serial Port Setup and Configuration](../get_started/serial_access.md), but if
-you're not, you can go there now and then come back. 
+Open a new terminal window and list your serial connections to find our Arduino.
+```c
+$ ls /dev/tty.*
+
+/dev/tty.Bluetooth-Incoming-Port /dev/tty.usbmodem14132
+```
+
+In the same window, connect to the serial port using a serial communication program. 
+In this case I\u2019ll be using mincom as it can scroll through output.
+```c
+$ minicom -D /dev/tty.usbmodem14132 -b 115200
+```
+
+If you see minicom welcome you, you\u2019re ready to move on!
 
 ### Output Analysis
 
@@ -390,8 +398,7 @@ rate, Task B would take over a minute to finish one cycle.
 
 Feel free to play around with the testing parameters to study the different changes yourself!
 
-###Conclusion
-
+##Conclusion
 Moving forward, tasks are just the tip of the iceberg. The [*scheduler*](http://mynewt.apache.org/latest/os/core_os/context_switch/context_switch/), 
 [*event queues*](http://mynewt.apache.org/latest/os/core_os/event_queue/event_queue/), 
 [*semaphores*](http://mynewt.apache.org/latest/os/core_os/semaphore/semaphore/), and 

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/3fdca23f/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index 8546fad..bd466ff 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -25,7 +25,6 @@ pages:
             - 'Install Newt on Linux': 'newt/install/newt_linux.md'
             - 'Install Cross Tools for ARM': 'os/get_started/cross_tools.md'
         - 'Create Your First Project': 'os/get_started/project_create.md'
-        - 'Serial Port Setup': 'os/get_started/serial_access.md'
     - Concepts: 'os/get_started/vocabulary.md'
     - Tutorials:
         - toc: 'os/tutorials/tutorials.md'
@@ -40,18 +39,13 @@ pages:
             - 'Run Blinky from SRAM, no bootloader': 'os/tutorials/blinky_sram_olimex.md'
         - 'Work with repositories':
             - toc: 'os/tutorials/repo/add_repos.md'
-            - 'Upgrade a Repo': 'os/tutorials/repo/upgrade_repo.md'
-            - 'Turn project into a Repo': 'os/tutorials/repo/create_repo.md'
-        - 'Tasks and Priority Management': 'os/tutorials/tasks_lesson.md'
-        - 'Enable Wi-Fi on Arduino Zero': 'os/tutorials/wi-fi_on_arduino.md'
+            - 'Upgrade a repo': 'os/tutorials/repo/upgrade_repo.md'
+            - 'Turn project into a repo': 'os/tutorials/repo/create_repo.md'
         - 'Write a Test Suite for a Package': 'os/tutorials/unit_test.md'
         - 'Air-quality Sensor project': 'os/tutorials/air_quality_sensor.md'
         - 'Add task to manage multiple events': 'os/tutorials/event_queue.md'
-        - 'Project Slinky for remote comms':
-            - 'Slinky on sim device': 'os/tutorials/project-slinky.md'
-            - 'Slinky on STM32 board': 'os/tutorials/project-target-slinky.md'
-        - 'Enable newtmgr in any app': 'os/tutorials/add_newtmgr.md' 
-        - 'Enable the OS Shell and Console': 'os/tutorials/add_shell.md'
+        - 'Enable remote comms on sim device': 'os/tutorials/project-slinky.md'
+        - 'Enable remote comms on STM32 board': 'os/tutorials/project-target-slinky.md'
         - 'BLE app to check stats via console': 'os/tutorials/bletiny_project.md'
         - 'BLE peripheral project':
             - toc: 'os/tutorials/bleprph/bleprph-intro.md'

[02/10] incubator-mynewt-site git commit: Fixed mkdocs.yml errors

Posted by ad...@apache.org.
Fixed mkdocs.yml errors


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

Branch: refs/heads/master
Commit: 7c242c3d6276a1e33e2b6fe51f4d5543c9a814e0
Parents: 4637b32
Author: aditihilbert <ad...@runtime.io>
Authored: Mon Nov 28 10:36:23 2016 -0800
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 10:36:23 2016 -0800

----------------------------------------------------------------------
 mkdocs.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/7c242c3d/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index 8275413..d21ee59 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -46,8 +46,8 @@ pages:
         - 'Air-quality Sensor project': 'os/tutorials/air_quality_sensor.md'
         - 'Add task to manage multiple events': 'os/tutorials/event_queue.md'
         - 'Project Slinky for remote comms': 
-	      - 'Slinky on sim device': 'os/tutorials/project-slinky.md'
-              - 'Slinky on STM32 board': 'os/tutorials/project-target-slinky.md'
+	    - 'Slinky on sim device': 'os/tutorials/project-slinky.md'
+            - 'Slinky on STM32 board': 'os/tutorials/project-target-slinky.md'
         - 'Enable newtmgr in any app': 'os/tutorials/add_newtmgr.md' 
  +      - 'Enable the OS Shell and Console': 'os/tutorials/add_shell.md'
         - 'BLE app to check stats via console': 'os/tutorials/bletiny_project.md'

[09/10] incubator-mynewt-site git commit: Fixed tab error in mkdocs.yml

Posted by ad...@apache.org.
Fixed tab error in mkdocs.yml


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

Branch: refs/heads/master
Commit: 054e387ffeba343a0262c2739731d8abc2c09086
Parents: 6d99db1
Author: aditihilbert <ad...@runtime.io>
Authored: Mon Nov 28 10:57:39 2016 -0800
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 10:57:39 2016 -0800

----------------------------------------------------------------------
 mkdocs.yml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/054e387f/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index 0edf61a..8546fad 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -24,7 +24,6 @@ pages:
             - 'Install Newt on Mac': 'newt/install/newt_mac.md'
             - 'Install Newt on Linux': 'newt/install/newt_linux.md'
             - 'Install Cross Tools for ARM': 'os/get_started/cross_tools.md'
-        - 'Serial Port Setup': 'os/get_started/serial_access.md'
         - 'Create Your First Project': 'os/get_started/project_create.md'
         - 'Serial Port Setup': 'os/get_started/serial_access.md'
     - Concepts: 'os/get_started/vocabulary.md'
@@ -48,8 +47,8 @@ pages:
         - 'Write a Test Suite for a Package': 'os/tutorials/unit_test.md'
         - 'Air-quality Sensor project': 'os/tutorials/air_quality_sensor.md'
         - 'Add task to manage multiple events': 'os/tutorials/event_queue.md'
-        - 'Project Slinky for remote comms': 
-	    - 'Slinky on sim device': 'os/tutorials/project-slinky.md'
+        - 'Project Slinky for remote comms':
+            - 'Slinky on sim device': 'os/tutorials/project-slinky.md'
             - 'Slinky on STM32 board': 'os/tutorials/project-target-slinky.md'
         - 'Enable newtmgr in any app': 'os/tutorials/add_newtmgr.md' 
         - 'Enable the OS Shell and Console': 'os/tutorials/add_shell.md'

[03/10] incubator-mynewt-site git commit: Added shell tutorial

Posted by ad...@apache.org.
Added shell tutorial


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

Branch: refs/heads/master
Commit: 0862fea9972fb2e0f09f4251d54a84fe8dcb47ab
Parents: 7c242c3
Author: David G. Simmons <sa...@mac.com>
Authored: Tue Nov 22 09:32:54 2016 -0500
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 10:52:03 2016 -0800

----------------------------------------------------------------------
 docs/os/tutorials/add_newtmgr.md |   2 +-
 docs/os/tutorials/add_shell.md   | 140 ++++++++++++++++++++++++++++++++++
 mkdocs.yml                       |   4 +-
 3 files changed, 144 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0862fea9/docs/os/tutorials/add_newtmgr.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/add_newtmgr.md b/docs/os/tutorials/add_newtmgr.md
index 24f7483..2c5fe85 100644
--- a/docs/os/tutorials/add_newtmgr.md
+++ b/docs/os/tutorials/add_newtmgr.md
@@ -110,7 +110,7 @@ $ newt load myble
 
 ### Set up newtmgr connection
 
-Newtmgr reqwiures a connection profile in order to connect to your board. If you haven't yet, follow the [instructions](../../newtmgr/overview.md) for setting up your connection profile.
+Newtmgr requires a connection profile in order to connect to your board. If you haven't yet, follow the [instructions](../../newtmgr/overview.md) for setting up your connection profile.
 
 <br>
 

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0862fea9/docs/os/tutorials/add_shell.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/add_shell.md b/docs/os/tutorials/add_shell.md
new file mode 100644
index 0000000..a5b0e91
--- /dev/null
+++ b/docs/os/tutorials/add_shell.md
@@ -0,0 +1,140 @@
+##Enabling The Console and Shell in a project
+
+<br>
+
+This tutorial explains how to add the Console and Shell task to a project so that you 
+can interact with your project over a serial line connection.
+
+<br>
+
+### Pre-Requisites
+
+* Ensure you have installed [newt](../../newt/install/newt_mac.md) and that the 
+newt command is in your system path. 
+* You must have Internet connectivity to fetch remote Mynewt components.
+* You must [install the compiler tools](../get_started/native_tools.md) to 
+support native compiling to build the project this tutorial creates.  
+* You must install the [Segger JLINK package]( https://www.segger.com/jlink-software.html) to 
+load your project on the board.
+* Cable to establish a serial USB connection between the board and the laptop
+
+<br>
+
+### Use an existing project
+
+Since all we're doing is adding the shell and console capability to a project, we assume 
+that you have worked through at least some of the other tutorials, and have an existing project.
+For this example, we'll be modifying the [ble_tiny](bletiny_project.md) project to enable 
+the shell and console connectivity. We'll be calling our app myble as in that project as well. 
+Feel free to use whatever project you'd like though.
+
+<br>
+
+###Modify the Dependencies and Configuration
+
+The first thing you'll need to add is a few new dependencies for your app. To add shell support to 
+your app make sure the following `pkg.deps` are defined in your target's pkg.yml file:
+
+```
+pkg.deps:
+    - "@apache-mynewt-core/sys/console/full"
+    - "@apache-mynewt-core/sys/shell"
+    - "@apache-mynewt-core/sys/sysinit"
+```
+
+This lets the newt system know that it needs to pull in the code for the console and the shell.
+
+Now we'll need to modify the settings for the app to turn on the shell, etc. by modifying the
+`syscfg.yml` file for your target. (Remember, these files are in the targets/<app-name> directory.)
+If there isn't a `syscfg.yml` file in your target's directory, you will need to create one.
+
+```no-highlight
+# Package: apps/bletiny
+
+syscfg.vals:
+    # Enable the shell task.
+    SHELL_TASK: 1
+    # Enable Console OS Ticks
+    CONSOLE_TICKS: 1
+    # Enable Console Prompt
+    CONSOLE_PROMPT: 1 
+```
+
+### Build targets
+
+We're not going to build the bootloader here since we are assuming that you have already
+built and loaded it during previous tutorials.
+
+```no-highlight
+$ newt build myble
+Archiving cbmem.a
+Compiling crc16.c
+Compiling crc8.c
+Archiving crc.a
+Compiling mem.c
+Archiving mem.a
+Linking ~/dev/myproj/bin/targets/myble/app/apps/bletiny/bletiny.elf
+Target successfully built: targets/myble
+```
+
+<br>
+
+### Create the app image
+
+Generate a signed application image for the `myble` target. The version number is arbitrary.
+
+```
+$ newt create-image myble 1.0.0
+App image succesfully generated: ~/dev/myproj/bin/targets/myble/app/apps/bletiny/bletiny.img
+```
+
+<br>
+
+### Load the image
+
+Make sure the USB connector is in place and the power LED on the board is lit. Use the Power ON/OFF switch to reset the board after loading the image.
+
+```
+$ newt load myble
+```
+
+<br>
+
+### Set up Serial connection
+
+You'll need a Serial connection to see the output of your program. You can see the instructions in the [Tasks and Priority Management](tasks_lesson.md) 
+Tutorial for more information on setting up your serial communications.
+
+<br>
+
+###Connecting with your app
+
+Once you have a connection set up, you can connect to your device with ```minicom -D /dev/tty.usbmodem<port> -b 115200``` to run connect
+to the console of your app. 
+    
+To test and make sure that the Shell is running, first just hit <return>:
+    
+```no-highlight
+3534: >
+```
+
+Remember, we turned the CONSOLE_PROMPT and the CONSOLE_TICKS on earlier. You can try some commands now:
+
+```no-highlight
+3609: > ?
+Commands:
+8841:     echo         ?    prompt     ticks     tasks  mempools
+8843:     date         b
+8844: > ticks off
+ Console Ticks off
+ > prompt off
+ Prompt now off.
+ticks on
+33383: Console Ticks on
+
+33568:
+prompt on
+39108: Prompt now on.
+39108: >
+```
+

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0862fea9/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index d21ee59..cd5d6d4 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -42,6 +42,8 @@ pages:
             - toc: 'os/tutorials/repo/add_repos.md'
             - 'Upgrade a Repo': 'os/tutorials/repo/upgrade_repo.md'
             - 'Turn project into a Repo': 'os/tutorials/repo/create_repo.md'
+        - 'Tasks and Priority Management': 'os/tutorials/tasks_lesson.md'
+        - 'Enable Wi-Fi on Arduino Zero': 'os/tutorials/wi-fi_on_arduino.md'
         - 'Write a Test Suite for a Package': 'os/tutorials/unit_test.md'
         - 'Air-quality Sensor project': 'os/tutorials/air_quality_sensor.md'
         - 'Add task to manage multiple events': 'os/tutorials/event_queue.md'
@@ -49,7 +51,7 @@ pages:
 	    - 'Slinky on sim device': 'os/tutorials/project-slinky.md'
             - 'Slinky on STM32 board': 'os/tutorials/project-target-slinky.md'
         - 'Enable newtmgr in any app': 'os/tutorials/add_newtmgr.md' 
- +      - 'Enable the OS Shell and Console': 'os/tutorials/add_shell.md'
+        - 'Enable the OS Shell and Console': 'os/tutorials/add_shell.md'
         - 'BLE app to check stats via console': 'os/tutorials/bletiny_project.md'
         - 'BLE peripheral project':
             - toc: 'os/tutorials/bleprph/bleprph-intro.md'