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/29 02:17:14 UTC

[1/7] incubator-mynewt-site git commit: New Shell Tutorial

Repository: incubator-mynewt-site
Updated Branches:
  refs/heads/develop 7dd4891e7 -> ae4474cae


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

Branch: refs/heads/develop
Commit: e1c0ab93c58ece0950e6de95d65ef4b443b4a700
Parents: 5fd69a6
Author: David G. Simmons <sa...@mac.com>
Authored: Tue Nov 22 09:32:54 2016 -0500
Committer: David G. Simmons <sa...@mac.com>
Committed: Tue Nov 22 09:32:54 2016 -0500

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


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/e1c0ab93/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/e1c0ab93/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/e1c0ab93/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index f87a837..27010f8 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -35,8 +35,8 @@ 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'
         - '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'
@@ -46,6 +46,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'
         - 'BLE app to check stats via console': 'os/tutorials/bletiny_project.md'
         - 'BLE peripheral project':
             - toc: 'os/tutorials/bleprph/bleprph-intro.md'

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

Branch: refs/heads/develop
Commit: 53b16a4ef34a0e3075429c259d709256cf09566b
Parents: 7346978
Author: David G. Simmons <sa...@mac.com>
Authored: Wed Nov 23 11:35:39 2016 -0500
Committer: David G. Simmons <sa...@mac.com>
Committed: Wed Nov 23 11:35:39 2016 -0500

----------------------------------------------------------------------
 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/53b16a4e/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

[7/7] incubator-mynewt-site git commit: Fixed bletiny_project.md and mkdocs.yml. This closes #127

Posted by ad...@apache.org.
Fixed bletiny_project.md and mkdocs.yml. 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/ae4474ca
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/ae4474ca
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/ae4474ca

Branch: refs/heads/develop
Commit: ae4474caeff6065d5f89c06c41ee2e8f40bb186b
Parents: 7dd4891 6437b39
Author: aditihilbert <ad...@runtime.io>
Authored: Mon Nov 28 09:59:33 2016 -0800
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Nov 28 09:59:33 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/serial_access.md | 137 +++++++++++++++++++++++++++++
 docs/os/tutorials/add_newtmgr.md     |   2 +-
 docs/os/tutorials/add_shell.md       | 140 ++++++++++++++++++++++++++++++
 docs/os/tutorials/bletiny_project.md |   9 +-
 docs/os/tutorials/tasks_lesson.md    |  35 +++-----
 mkdocs.yml                           |   8 +-
 9 files changed, 302 insertions(+), 29 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/ae4474ca/docs/os/tutorials/bletiny_project.md
----------------------------------------------------------------------
diff --cc docs/os/tutorials/bletiny_project.md
index 4a7033a,a3b9153..dd94791
--- a/docs/os/tutorials/bletiny_project.md
+++ b/docs/os/tutorials/bletiny_project.md
@@@ -166,10 -166,11 +166,11 @@@ section
  
  <br>
  
- You may use any terminal emulation program to communicate with the board, but you should connect to the nRF52's serial port using a baudrate of 115200, 8N1, and hardware/software flow control both off. 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. 
+ 
  
  ```
 -$ minicom -D /dev/tty.usbserial-AJ03HAQQ
 +$ minicom -D /dev/tty.usbserial-AJ03HAQQ -b 115200
  ```
  
  <br>

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/ae4474ca/docs/os/tutorials/tasks_lesson.md
----------------------------------------------------------------------

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/ae4474ca/mkdocs.yml
----------------------------------------------------------------------
diff --cc mkdocs.yml
index db4ffc3,ffac004..da4aa86
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@@ -24,7 -20,8 +24,8 @@@ 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'
      - Tutorials:
          - toc: 'os/tutorials/tutorials.md'
@@@ -46,10 -43,11 +47,11 @@@
          - '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': 
 +        - '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 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'

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

Branch: refs/heads/develop
Commit: a6d720db4ab576b56453e6fd7658f962285d3126
Parents: 53b16a4
Author: David G. Simmons <sa...@mac.com>
Authored: Wed Nov 23 11:56:29 2016 -0500
Committer: David G. Simmons <sa...@mac.com>
Committed: Wed Nov 23 11:56:29 2016 -0500

----------------------------------------------------------------------
 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/a6d720db/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/a6d720db/docs/os/tutorials/bletiny_project.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/bletiny_project.md b/docs/os/tutorials/bletiny_project.md
index 083393c..a3b9153 100644
--- a/docs/os/tutorials/bletiny_project.md
+++ b/docs/os/tutorials/bletiny_project.md
@@ -160,13 +160,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/a6d720db/docs/os/tutorials/tasks_lesson.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/tasks_lesson.md b/docs/os/tutorials/tasks_lesson.md
index 5faf358..3cc1b33 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

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

Branch: refs/heads/develop
Commit: 73469787b6b57ce0361aaae35b2816ae9b0198ea
Parents: 690e7ec
Author: David G. Simmons <sa...@mac.com>
Authored: Wed Nov 23 11:33:48 2016 -0500
Committer: David G. Simmons <sa...@mac.com>
Committed: Wed Nov 23 11:33:48 2016 -0500

----------------------------------------------------------------------
 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/73469787/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/73469787/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/73469787/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/73469787/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/73469787/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/73469787/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index 27010f8..ffac004 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -20,6 +20,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'
     - Concepts: 'os/get_started/vocabulary.md'
     - Tutorials:

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

Branch: refs/heads/develop
Commit: 6437b397867020ec5368001de02b22bc3dce9324
Parents: a6d720d
Author: David G. Simmons <sa...@mac.com>
Authored: Mon Nov 28 11:31:41 2016 -0500
Committer: David G. Simmons <sa...@mac.com>
Committed: Mon Nov 28 11:31:41 2016 -0500

----------------------------------------------------------------------
 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/6437b397/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>

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

Branch: refs/heads/develop
Commit: 690e7ec8fec374e1d536c8bed1a8bc4e255f11a0
Parents: e1c0ab9
Author: David G. Simmons <sa...@mac.com>
Authored: Tue Nov 22 13:21:16 2016 -0500
Committer: David G. Simmons <sa...@mac.com>
Committed: Tue Nov 22 13:21:16 2016 -0500

----------------------------------------------------------------------
 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/690e7ec8/docs/os/tutorials/tasks_lesson.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/tasks_lesson.md b/docs/os/tutorials/tasks_lesson.md
index 70801ed..5faf358 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