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 2017/05/22 16:45:23 UTC

[5/7] incubator-mynewt-site git commit: Add instructions to install mbed serial port driver for primo and nano2 This does not include the additional instructions to install the updated driver (from Arduino) on Windows 7 to get primo to work. Should decid

Add instructions to install mbed serial port driver for primo and nano2
This does not include the additional instructions to install the updated driver (from Arduino) on Windows 7 to get
primo to work. Should decide if we should package the drivers and put on runtimeco instead of asking user
to download everything from https://github.com/arduino-org/arduino-core-nrf52


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

Branch: refs/heads/develop
Commit: 46fa024d4570023a7d5d9fe816ba8b3c710c28f8
Parents: ceb0b42
Author: cwanda <wa...@happycity.com>
Authored: Wed May 17 13:21:22 2017 -0700
Committer: cwanda <wa...@happycity.com>
Committed: Wed May 17 13:21:22 2017 -0700

----------------------------------------------------------------------
 docs/os/tutorials/blinky_primo.md       | 13 +++++++++++--
 docs/os/tutorials/blinky_stm32f4disc.md |  2 +-
 docs/os/tutorials/rbnano2.md            | 19 +++++++++++++++----
 3 files changed, 27 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/46fa024d/docs/os/tutorials/blinky_primo.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/blinky_primo.md b/docs/os/tutorials/blinky_primo.md
index 7876d7c..fa7dec9 100644
--- a/docs/os/tutorials/blinky_primo.md
+++ b/docs/os/tutorials/blinky_primo.md
@@ -152,7 +152,7 @@ App image succesfully generated: ~/dev/myproj/bin/targets/primoblinky/app/apps/b
 
 **Note:** If you are using the OpenOCD debugger,  you do not need to attach this connector. 
 
-### Load the Bootloader and the Blinky Application Image
+### Load the Bootloader
 Run the `newt load primo_boot` command to load the bootloader onto the board:
 
 ```no-highlight
@@ -160,7 +160,16 @@ $ newt load primo_boot
 Loading bootloader
 $
 ```
+
+**Note:** If you are using OpenOCD on a Windows platform and you get an `unable to find CMSIS-DAP device` error, you will need to download and install the mbed Windows serial port driver from [https://developer.mbed.org/handbook/Windows-serial-configuration](https://developer.mbed.org/handbook/Windows-serial-configuration). Follow the instructions from the site to install the driver.  Here are some additional notes about the installation:
+
+1. The instructions indicate that the mbed Windows serial port driver is not required for Windows 10. If you are using Windows 10 and get the `unable to find CMSIS-DAP device` error, we recommend that you install the driver.
+2. If the driver installation fails, we recommend that you unplug the board, plug it back in, and retry the installation.
+
+Run the `newt load primo_boot` command again.
+
 <br>
+###Load the Blinky Application Image
 Run the `newt load primoblinky` command to load the Blinky application image onto the board.
 
 ```no-highlight
@@ -175,7 +184,7 @@ Note: If the LED does not blink, try resetting the board.
 
 
 <br>
-
+###Erase Flash
 If you want to erase the flash and load the image again, use JLinkExe and issue the `erase` command when you are using the Jlink debug probe: 
  
 **Note:** On Windows: Run the `jlink` command with the same arguments from a Windows Command Prompt terminal.

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/46fa024d/docs/os/tutorials/blinky_stm32f4disc.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/blinky_stm32f4disc.md b/docs/os/tutorials/blinky_stm32f4disc.md
index 131334b..95fc906 100644
--- a/docs/os/tutorials/blinky_stm32f4disc.md
+++ b/docs/os/tutorials/blinky_stm32f4disc.md
@@ -157,7 +157,7 @@ $newt load stm32f4disc_boot
 Loading bootloader
 ```
 
-Note: If you are using Windows and get a `open failed` or  `no device found` error, you will need to install the usb driver. Download [Zadig](http://zadig.akeo.ie) and run it:
+Note: If you are using Windows and get an `open failed` or  `no device found` error, you will need to install the usb driver. Download [Zadig](http://zadig.akeo.ie) and run it:
 
 * Select Options > List All Devices.
 * Select `STM32 STLink` from the drop down menu.

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/46fa024d/docs/os/tutorials/rbnano2.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/rbnano2.md b/docs/os/tutorials/rbnano2.md
index 20ff4dd..20db489 100644
--- a/docs/os/tutorials/rbnano2.md
+++ b/docs/os/tutorials/rbnano2.md
@@ -130,7 +130,7 @@ App image succesfully generated: ~/dev/myproj/bin/targets/rbnano2_blinky/app/app
 Connect the RedBear Nano 2 USB to a USB port on your computer. You should see an orange LED light up on the board.
 
         
-### Load the Bootloader and the Blinky Application Image
+### Load the Bootloader 
 
 Run the `newt load rbnano2_boot` command to load the bootloader onto the board: 
 
@@ -140,7 +140,17 @@ Loading bootloader
 $
 ```
 <br>
-Note: The flash memory on the RedBear Nano 2 comes write protected from the factory. If you get an error loading the bootloader and you are using a brand new chip, you need to clear the write protection from the debugger and then load the bootloader again.  Run the `newt debug rbnano2_blinky` command and issue the following commands at the highlighted (gdb) prompts.  
+
+**Note:** On Windows platforms, if you get an `unable to find CMSIS-DAP device` error, you will need to download and install the mbed Windows serial port driver from [https://developer.mbed.org/handbook/Windows-serial-configuration](https://developer.mbed.org/handbook/Windows-serial-configuration). Follow the instructions from the site to install the driver.  Here are some additional notes about the installation:
+
+1. The instructions indicate that the mbed Windows serial port driver is not required for Windows 10. If you are using Windows 10 and get the `unable to find CMSIS-DAP device` error, we recommend that you install the driver.
+2. If the driver installation fails, we recommend that you unplug the board, plug it back in, and retry the installation.
+
+Run the `newt load rbnano2_boot` command again.
+
+<br>
+####Clear the Write Protection on the Flash Memory
+The flash memory on the RedBear Nano 2 comes write protected from the factory. If you get an error loading the bootloader and you are using a brand new chip, you need to clear the write protection from the debugger and then load the bootloader again.  Run the `newt debug rbnano2_blinky` command and issue the following commands at the highlighted (gdb) prompts.  
 
 **Note:** The output of the debug session below is for Mac OS and Linux platforms. On Windows, openocd and gdb are started in separate Windows Command Prompt terminals, and the terminals are automatically closed when you quit gdb. In addition,  the output of openocd is logged to the openocd.log file in your project's base directory instead of the terminal.
 
@@ -171,9 +181,10 @@ Error: Failed to read memory at 0x00009ef4
 0x70:0xffffffff0xffffffff0xffffffff0xffffffff
 (gdb)
 ```
-
 <br>
-Run the `newt load rbnano2_blinky` command to load the Blinky application image onto the board.
+### Load the Blinky Application Image
+<br>
+Run the `newt load rbnano2_blinky` command to load the Blinky application image onto the board:
 ```no-highlight
 $ newt load rbnano2_blinky
 Loading app image into slot 1