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/11 20:01:32 UTC
[1/9] incubator-mynewt-site git commit: Added NUCLEO-F401RE to the
list of BSPs in landing page
Repository: incubator-mynewt-site
Updated Branches:
refs/heads/develop 536e0daf0 -> 9d206a14d
Added NUCLEO-F401RE to the list of BSPs in landing page
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/5001761a
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/5001761a
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/5001761a
Branch: refs/heads/develop
Commit: 5001761ab0c4d30ac8c1ae84fed547545a314837
Parents: 536e0da
Author: aditihilbert <ad...@runtime.io>
Authored: Mon Oct 3 13:08:35 2016 -0700
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Oct 3 13:08:35 2016 -0700
----------------------------------------------------------------------
custom-theme/landing.html | 3 +++
1 file changed, 3 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5001761a/custom-theme/landing.html
----------------------------------------------------------------------
diff --git a/custom-theme/landing.html b/custom-theme/landing.html
index e369d76..c76d048 100644
--- a/custom-theme/landing.html
+++ b/custom-theme/landing.html
@@ -105,6 +105,9 @@
<li>
<a href="http://www.arduino.org/products/boards/4-arduino-boards/arduino-m0-pro"> Arduino M0 Pro </a> (Cortex-M0)
</li>
+ <li>
+ <a href="http://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-eval-tools/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-f401re.html"> NUCLEO-F401RE </a> from ST Micro (Cortex-M4)
+ </li>
</ul>
</div>
[2/9] incubator-mynewt-site git commit: fix link
Posted by ad...@apache.org.
fix link
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/c0101c44
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/c0101c44
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/c0101c44
Branch: refs/heads/develop
Commit: c0101c445cefc070176a4f9b0518b9e1c3f5bc24
Parents: 536e0da
Author: Gavin Jefferies <ga...@runtime.io>
Authored: Thu Oct 6 16:13:44 2016 -0700
Committer: Gavin Jefferies <ga...@runtime.io>
Committed: Thu Oct 6 16:13:44 2016 -0700
----------------------------------------------------------------------
README.md | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/c0101c44/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 214108f..e6c3d07 100644
--- a/README.md
+++ b/README.md
@@ -33,7 +33,7 @@ When a new release of MyNewt OS and its associated tools occurs, the documentati
### Test
1. Run: `./serve.py`
-1. Visit http://localhost:8000
+1. Visit [http://localhost:8000](http://localhost:8000)
### Deploy
1. Run: `./deploy.sh`
@@ -43,3 +43,6 @@ When a new release of MyNewt OS and its associated tools occurs, the documentati
## Links to Documentation
For the deployed site a version prefix is added to the URL for each mkdocs page. When developing there is no version prefix. If you want to link from a _site page_ to a _documentation page_ you should prefix the URL with */DOCSLINK/* so that the user is taken to the correct location when browsing in production.
+
+
+
[9/9] incubator-mynewt-site git commit: Merge branch 'develop' of
https://github.com/davidgs/incubator-mynewt-site into develop
Posted by ad...@apache.org.
Merge branch 'develop' of https://github.com/davidgs/incubator-mynewt-site into develop
This closes #117
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/9d206a14
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/9d206a14
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/9d206a14
Branch: refs/heads/develop
Commit: 9d206a14d6ec29cbef6bbb1275f3790f945957d6
Parents: f48d3b1 8800078
Author: aditihilbert <ad...@runtime.io>
Authored: Tue Oct 11 12:57:39 2016 -0700
Committer: aditihilbert <ad...@runtime.io>
Committed: Tue Oct 11 12:57:39 2016 -0700
----------------------------------------------------------------------
docs/newt/install/newt_linux.md | 23 +++++++++++++++++++++++
docs/newt/install/newt_mac.md | 25 +++++++++++++++++++++++++
2 files changed, 48 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/9d206a14/docs/newt/install/newt_linux.md
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/9d206a14/docs/newt/install/newt_mac.md
----------------------------------------------------------------------
[7/9] incubator-mynewt-site git commit: fix more links
Posted by ad...@apache.org.
fix more links
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/5c00cfff
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/5c00cfff
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/5c00cfff
Branch: refs/heads/develop
Commit: 5c00cfff4e6643ce6510b81c789f19c0b24eb5d6
Parents: bbbda53
Author: Gavin Jefferies <ga...@runtime.io>
Authored: Fri Oct 7 16:27:10 2016 -0700
Committer: Gavin Jefferies <ga...@runtime.io>
Committed: Fri Oct 7 16:30:32 2016 -0700
----------------------------------------------------------------------
README.md | 6 +-
build.py | 21 +++++-
custom-theme/base.html | 3 +-
docs/network/ble/ini_stack/ble_parent_ini.md | 2 +-
docs/os/core_os/time/os_time_tick.md | 8 +--
.../os/modules/hal/hal_cputime/hal_cpu_timer.md | 14 ++--
docs/os/modules/hal/hal_gpio/hal_gpio.md | 19 +++---
docs/os/tutorials/blinky_sram_olimex.md | 41 ++++++------
docs/os/tutorials/olimex.md | 56 ++++++++--------
docs/os/tutorials/project-target-slinky.md | 38 ++++-------
docs/os/tutorials/tutorials.md | 21 +++---
docs/os/tutorials/wi-fi_on_arduino.md | 70 ++++++++++----------
12 files changed, 151 insertions(+), 148 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index dc61b4e..6351d8c 100644
--- a/README.md
+++ b/README.md
@@ -44,5 +44,9 @@ When a new release of MyNewt OS and its associated tools occurs, the documentati
For the deployed site a version prefix is added to the URL for each mkdocs page. When developing there is no version prefix. If you want to link from a _site page_ to a _documentation page_ you should prefix the URL with */DOCSLINK/* so that the user is taken to the correct location when browsing in production.
+## Link Checking
-
+1. Grab a link checking tool like [Integrity](http://peacockmedia.software/mac/integrity/free.html)
+1. Run: `./build.py --test-build`
+1. Run: `./serve.py`
+1. point the link checker at http://localhost:8000/
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/build.py
----------------------------------------------------------------------
diff --git a/build.py b/build.py
index b392523..e1fc469 100755
--- a/build.py
+++ b/build.py
@@ -9,9 +9,14 @@ import fileinput
@click.command()
@click.option('-s', '--site-branch', default='master', help='Use this branch as source for the top level pages')
+@click.option('-t', '--test-build', is_flag=True, help='Test the build using only the working directory (good for testing for broken links)')
+def build(site_branch, test_build):
+ if test_build:
+ buildForTest()
+ else:
+ buildForReal(site_branch)
-def build(site_branch):
-
+def buildForReal(site_branch):
# make sure there are no local mods outstanding
repo = Repo(os.getcwd())
if repo.is_dirty() or repo.untracked_files:
@@ -48,8 +53,18 @@ def build(site_branch):
mygit.checkout(version['branch'])
deployVersion(version)
+def buildForTest():
+ print "Building site pages..."
+ updateConfigVersion('develop')
+ sh.rm('-rf', 'site')
+ sh.mkdocs('build', '--clean')
+ sh.git('checkout', '--', 'mkdocs.yml')
+
+ cfg = config.load_config()
+ for version in cfg['extra']['versions']:
+ deployVersion(version)
+
def deployVersion(version):
- mygit.checkout(version['branch'])
buildTo(version['branch'])
if version['latest']:
buildTo('latest')
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/custom-theme/base.html
----------------------------------------------------------------------
diff --git a/custom-theme/base.html b/custom-theme/base.html
index 04b6513..20831ad 100644
--- a/custom-theme/base.html
+++ b/custom-theme/base.html
@@ -6,7 +6,8 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
{% if page_description %}<meta name="description" content="{{ page_description }}">{% endif %}
{% if site_author %}<meta name="author" content="{{ site_author }}">{% endif %}
- {% if canonical_url %}<link rel="canonical" href="{{ canonical_url }}">{% endif %}
+ <!-- This is broken by doc revisioning.
+ {% if canonical_url %}<link rel="canonical" href="{{ canonical_url }}">{% endif %} -->
{% if favicon %}<link rel="shortcut icon" href="{{ favicon }}">
{% else %}<link rel="shortcut icon" href="{{ base_url }}/img/favicon.ico">{% endif %}
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/docs/network/ble/ini_stack/ble_parent_ini.md
----------------------------------------------------------------------
diff --git a/docs/network/ble/ini_stack/ble_parent_ini.md b/docs/network/ble/ini_stack/ble_parent_ini.md
index 463a6f0..6928ef5 100644
--- a/docs/network/ble/ini_stack/ble_parent_ini.md
+++ b/docs/network/ble/ini_stack/ble_parent_ini.md
@@ -6,7 +6,7 @@ application-specific work, the host parent task does work for NimBLE by
processing events generated by the host.
The process of creating an OS task is described in the [Add Task
-tutorial](../../../../os/tutorials/event_queue/).
+tutorial](../../../os/tutorials/event_queue/).
**Priority:**
It is up to you which priority to use for the host parent task. Unlike the
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/docs/os/core_os/time/os_time_tick.md
----------------------------------------------------------------------
diff --git a/docs/os/core_os/time/os_time_tick.md b/docs/os/core_os/time/os_time_tick.md
index 420aa23..1c217e1 100644
--- a/docs/os/core_os/time/os_time_tick.md
+++ b/docs/os/core_os/time/os_time_tick.md
@@ -1,10 +1,10 @@
## <font color="F2853F" style="font-size:24pt">os_time_tick</font>
```c
-void os_time_tick(void)
+void os_time_tick(void)
```
-Increments the OS time tick for the system. Typically, this is called in one place by the architecture specific OS code (`libs/os/arch`) `timer_handler` which is in turn called by the BSP specific code assigned to drive the OS timer tick. See [Porting Mynewt OS](../port_os) for details.
+Increments the OS time tick for the system. Typically, this is called in one place by the architecture specific OS code (`libs/os/arch`) `timer_handler` which is in turn called by the BSP specific code assigned to drive the OS timer tick. See [Porting Mynewt OS](../porting/port_os) for details.
#### Arguments
@@ -14,7 +14,7 @@ N/A
N/A
-#### Notes
+#### Notes
Called for every single tick by the architecture specific functions.
@@ -25,5 +25,3 @@ Called for every single tick by the architecture specific functions.
```c
os_time_tick();
```
-
-
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/docs/os/modules/hal/hal_cputime/hal_cpu_timer.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/hal/hal_cputime/hal_cpu_timer.md b/docs/os/modules/hal/hal_cputime/hal_cpu_timer.md
index 99fa830..d430dfc 100644
--- a/docs/os/modules/hal/hal_cputime/hal_cpu_timer.md
+++ b/docs/os/modules/hal/hal_cputime/hal_cpu_timer.md
@@ -7,7 +7,7 @@ The hardware independent interface to system time.
Contains several different interface.
-* An interface to get the current CPU time
+* An interface to get the current CPU time
* Interfaces to convert between CPU time and clock time (microseconds etc.)
* An Interface to set up a software timer based on CPU time.
@@ -17,15 +17,13 @@ Contains several different interface.
###CPU Time
-The CPU time is not the same as the [os_time](TBD). Typically,
+The CPU time is not the same as the [os_time](). Typically,
the os_time is set to a much slower tick rate than the CPU time. The CPU
time should be used for timing real-time events at exact times. The os_time
-should be used for system level timeout etc that are not in fine time
+should be used for system level timeout etc that are not in fine time
resolutions. In fact, cputime is not part of the os at all, but a hardware
-layer abstraction to high resolution timers.
+layer abstraction to high resolution timers.
-There are methods to get the cputime as 32-bit and 64-bit values. Both
+There are methods to get the cputime as 32-bit and 64-bit values. Both
values may eventually wrap, but for timing short events a 32-bit value
-may be sufficient and would
-
-
+may be sufficient and would
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/docs/os/modules/hal/hal_gpio/hal_gpio.md
----------------------------------------------------------------------
diff --git a/docs/os/modules/hal/hal_gpio/hal_gpio.md b/docs/os/modules/hal/hal_gpio/hal_gpio.md
index 5518bc8..a8d6af6 100644
--- a/docs/os/modules/hal/hal_gpio/hal_gpio.md
+++ b/docs/os/modules/hal/hal_gpio/hal_gpio.md
@@ -8,20 +8,20 @@ This is the hardware independent GPIO (General Purpose Input Output) Interface f
Contains the basic operations to set and read General Purpose Digital I/O Pins
within a Mynewt system.
-Individual GPIOs are referenced in the APIs as `pins`. However, in this interface the `pins` are virtual GPIO pins. The MCU hal driver maps these virtual `pins` to the physical GPIO ports and pins.
+Individual GPIOs are referenced in the APIs as `pins`. However, in this interface the `pins` are virtual GPIO pins. The MCU hal driver maps these virtual `pins` to the physical GPIO ports and pins.
Typically, the BSP code may define named I/O pins in terms of these virtual `pins` to describe the devices attached to the physical pins.
Here's a brief example so you can get the gist of the translation.
-Suppose my product uses the stm32F4xx processor. There already exists support for this processor within Mynewt. The processor has N ports (A,B,C..) of 16 GPIO pins per port. The MCU hal_gpio driver maps these to a set of virtual pins 0-N where port A maps to 0-15, Port B maps to 16-31, Port C maps to 32-47 and so on. The exact number of physical port (and virtual
+Suppose my product uses the stm32F4xx processor. There already exists support for this processor within Mynewt. The processor has N ports (A,B,C..) of 16 GPIO pins per port. The MCU hal_gpio driver maps these to a set of virtual pins 0-N where port A maps to 0-15, Port B maps to 16-31, Port C maps to 32-47 and so on. The exact number of physical port (and virtual
port pins) depends on the specific variant of the stm32F4xx.
-So if I want to turn on port B pin 3, that would be virtual pin 1*16 + 3 = 19.
-This translation is defined in the MCU implementation of
-[hal_gpio.c](https://github.com/apache/incubator-mynewt-larva/blob/master/hw/mcu/stm/stm32f4xx/src/hal_gpio.c)
-for the stmf32F4xx. Each MCU will typically have a different translation method
-depending on its GPIO architecture.
+So if I want to turn on port B pin 3, that would be virtual pin 1*16 + 3 = 19.
+This translation is defined in the MCU implementation of
+[hal_gpio.c](https://github.com/apache/incubator-mynewt-larva/blob/master/hw/mcu/stm/stm32f4xx/src/hal_gpio.c)
+for the stmf32F4xx. Each MCU will typically have a different translation method
+depending on its GPIO architecture.
Now, when writing a BSP, it's common to give names to the relevant port pins that you are using. Thus, the BSP may define a mapping between a function and a virtual port pin. For example
@@ -46,11 +46,10 @@ SYSTEM_LED --> hal_gpio virtual pin 37 --> port C pin 5 on the stm34F4xx
#### Blinky
-Blinky uses the hal_gpio to blink the system LED. The blinky source code is available
-[here](https://github.com/apache/incubator-mynewt-larva/blob/master/project/blinky/src/main.c).
+Blinky uses the hal_gpio to blink the system LED. The blinky source code is available
+[here](https://github.com/apache/incubator-mynewt-core/blob/master/apps/blinky/src/main.c).
Examine how `task1_handler` initializes and toggles the GPIO to control the LED.
<br>
---------------------
-
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/docs/os/tutorials/blinky_sram_olimex.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/blinky_sram_olimex.md b/docs/os/tutorials/blinky_sram_olimex.md
index dd2439d..3bd5750 100644
--- a/docs/os/tutorials/blinky_sram_olimex.md
+++ b/docs/os/tutorials/blinky_sram_olimex.md
@@ -6,12 +6,12 @@ To download an application image directly into the embedded SRAM in the microcon
### What you need
-1. STM32-E407 development board from Olimex. You can order it from [http://www.mouser.com](http://www.mouser.com/ProductDetail/Olimex-Ltd/STM32-E407/?qs=UN6GZl1KCcit6Ye0xmPO4A%3D%3D), [http://www.digikey.com](http://www.digikey.com/product-detail/en/STM32-E407/1188-1093-ND/3726951), and other places.
+1. STM32-E407 development board from Olimex. You can order it from [http://www.mouser.com](http://www.mouser.com/search/ProductDetail.aspx?R=0virtualkey0virtualkeySTM32-E407), [http://www.digikey.com](http://www.digikey.com/product-detail/en/STM32-E407/1188-1093-ND/3726951), and other places.
2. ARM-USB-TINY-H connector with JTAG interface for debugging ARM microcontrollers (comes with the ribbon cable to hook up to the board)
3. USB A-B type cable to connect the debugger to your personal computer
4. Personal Computer with Mac OS (Mac: OS X Yosemite Version 10.10.5) or Linux box (Ubuntu 14.10: Utopic Unicorn)
5. An account on Github repository and *git* installed on your computer.
-6. It is assumed you have already installed newt tool.
+6. It is assumed you have already installed newt tool.
7. It is assumed you already installed native tools as described [here](../get_started/native_tools.md)
Also, we assume that you're familiar with UNIX shells. Let's gets started!
@@ -21,13 +21,13 @@ Also, we assume that you're familiar with UNIX shells. Let's gets started!
### Prepare the Software
-* Make sure the PATH environment variable includes the $HOME/dev/go/bin directory.
-
+* Make sure the PATH environment variable includes the $HOME/dev/go/bin directory.
+
<br>
### Create a project
-Create a new project to hold your work. For a deeper understanding, you can read about project creation in
+Create a new project to hold your work. For a deeper understanding, you can read about project creation in
[Get Started -- Creating Your First Project](../get_started/project_create.md)
or just follow the commands below.
@@ -41,15 +41,15 @@ or just follow the commands below.
$cd myproj
- $ newt install -v
+ $ newt install -v
apache-mynewt-core
Downloading repository description for apache-mynewt-core... success!
...
apache-mynewt-core successfully installed version 0.7.9-none
-```
+```
<br>
-
+
### Create a target
Change directory to ~/dev/myproj directory and define the *blinky* target inside myproj, using the *newt* tool. Starting with the target name, assign specific aspects of the project, as shown below, to pull the appropriate packages and build the right bundle or list for the board. For example, we set the build_profile, board support package (bsp), and app.
@@ -71,11 +71,11 @@ Change directory to ~/dev/myproj directory and define the *blinky* target inside
### Build the image
-Next, let's build the image for the above target. By default, the linker script within the `hw/bsp/olimex_stm32-e407_devboard` package builds an image for flash memory, which we don't want; instead, we want an image for the SRAM, so you need to switch that script with `run_from_sram.ld`.
+Next, let's build the image for the above target. By default, the linker script within the `hw/bsp/olimex_stm32-e407_devboard` package builds an image for flash memory, which we don't want; instead, we want an image for the SRAM, so you need to switch that script with `run_from_sram.ld`.
+
+Afer you build the target, you can find the executable *blinky.elf* in the project directory *~/dev/myproj/bin/blinky/apps/blinky/.*
+
-Afer you build the target, you can find the executable *blinky.elf* in the project directory *~/dev/myproj/bin/blinky/apps/blinky/.*
-
-
```no-highlight
$ cd ~/dev/myproj/repos/apache-mynewt-core/hw/bsp/olimex_stm32-e407_devboard/
$ diff olimex_stm32-e407_devboard.ld run_from_sram.ld
@@ -106,12 +106,12 @@ Afer you build the target, you can find the executable *blinky.elf* in the proje
<br>
-* B1_1/B1_0 and B0_1/B0_0 are PTH jumpers. Note that because the markings on the board may not always be accurate, when in doubt, you should always refer to the manual for the correct positioning. Since the jumpers are a pair, they should move together, and as such, the pair is responsible for the boot mode when bootloader is present.
+* B1_1/B1_0 and B0_1/B0_0 are PTH jumpers. Note that because the markings on the board may not always be accurate, when in doubt, you should always refer to the manual for the correct positioning. Since the jumpers are a pair, they should move together, and as such, the pair is responsible for the boot mode when bootloader is present.
To locate the bootloader, the board searches in three places: User Flash Memory, System Memory or the Embedded SRAM. For this Blinky project, we will configure it to boot from SRAM by jumpering **B0_1** and **B1_1**.
-* Connect USB-OTG#2 in the picture above to a USB port on your computer (or a powered USB hub to make sure there is enough power available to the board).
+* Connect USB-OTG#2 in the picture above to a USB port on your computer (or a powered USB hub to make sure there is enough power available to the board).
-* The red PWR LED should be lit.
+* The red PWR LED should be lit.
* Connect the JTAG connector to the SWD/JTAG interface on the board. The other end of the cable should be connected to the USB port or hub of your computer.
@@ -133,7 +133,7 @@ To locate the bootloader, the board searches in three places: User Flash Memory,
(info)
...
target state: halted
- target halted due to debug-request, current mode: Thread
+ target halted due to debug-request, current mode: Thread
xPSR: 0x01000000 pc: 0x080003c0 msp: 0x10010000
Info : accepting 'gdb' connection on tcp/3333
Info : device id = 0x10036413
@@ -141,15 +141,15 @@ To locate the bootloader, the board searches in three places: User Flash Memory,
```
<br>
-Check the value of the msp (main service pointer) register. If it is not 0x10010000 as indicated above, you will have to manually set it after you open the gdb tool and load the image on it. For example,
-
+Check the value of the msp (main service pointer) register. If it is not 0x10010000 as indicated above, you will have to manually set it after you open the gdb tool and load the image on it. For example,
+
```no-highlight
(gdb) set $msp=0x10010000
```
<br>
- Now load the image and type "c" or "continue" from the GNU debugger.
+ Now load the image and type "c" or "continue" from the GNU debugger.
```no-highlight
(gdb) load ~/dev/myproj/bin/blinky/apps/blinky/blinky.elf
@@ -161,8 +161,7 @@ Check the value of the msp (main service pointer) register. If it is not 0x10010
(gdb) c
Continuing.
```
-
+
* Voil�! The board's LED should be blinking at 1 Hz. Success!
<br>
-
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/docs/os/tutorials/olimex.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/olimex.md b/docs/os/tutorials/olimex.md
index 740c293..398bfe1 100644
--- a/docs/os/tutorials/olimex.md
+++ b/docs/os/tutorials/olimex.md
@@ -10,12 +10,12 @@ This tutorial shows you how to create a runtime image for an Olimex board to mak
### What you need
-1. STM32-E407 development board from Olimex. You can order it from [http://www.mouser.com](http://www.mouser.com/ProductDetail/Olimex-Ltd/STM32-E407/?qs=UN6GZl1KCcit6Ye0xmPO4A%3D%3D), [http://www.digikey.com](http://www.digikey.com/product-detail/en/STM32-E407/1188-1093-ND/3726951), and other places.
+1. STM32-E407 development board from Olimex. You can order it from [http://www.mouser.com](http://www.mouser.com/search/ProductDetail.aspx?R=0virtualkey0virtualkeySTM32-E407), [http://www.digikey.com](http://www.digikey.com/product-detail/en/STM32-E407/1188-1093-ND/3726951), and other places.
2. ARM-USB-TINY-H connector with JTAG interface for debugging ARM microcontrollers (comes with the ribbon cable to hook up to the board)
3. USB A-B type cable to connect the debugger to your personal computer
4. Personal Computer with Mac OS (Mac: OS X Yosemite Version 10.10.5) or Linux box (Ubuntu 14.10: Utopic Unicorn)
5. An account on Github repository and *git* installed on your computer.
-6. It is assumed you have already installed newt tool.
+6. It is assumed you have already installed newt tool.
7. It is assumed you already installed native tools as described [here](../get_started/native_tools.md)
Also, we assume that you're familiar with UNIX shells. Let's gets started!
@@ -25,13 +25,13 @@ Also, we assume that you're familiar with UNIX shells. Let's gets started!
### Prepare the Software
-* Make sure the PATH environment variable includes the $HOME/dev/go/bin directory.
-
+* Make sure the PATH environment variable includes the $HOME/dev/go/bin directory.
+
<br>
### Create a project.
-Create a new project to hold your work. For a deeper understanding, you can read about project creation in
+Create a new project to hold your work. For a deeper understanding, you can read about project creation in
[Get Started -- Creating Your First Project](../get_started/project_create.md)
or just follow the commands below.
@@ -45,15 +45,15 @@ or just follow the commands below.
$cd myproj
- $ newt install -v
+ $ newt install -v
apache-mynewt-core
Downloading repository description for apache-mynewt-core... success!
...
apache-mynewt-core successfully installed version 0.7.9-none
-```
+```
<br>
-
+
### Create targets
Change directory to ~/dev/myproj directory and define the *blinky* target inside myproj, using the *newt* tool. Starting with the target name, assign specific aspects of the project, as shown below, to pull the appropriate packages and build the right bundle or list for the board. For example, we set the build_profile, board support package (bsp), and app.
@@ -64,13 +64,13 @@ Change directory to ~/dev/myproj directory and define the *blinky* target inside
$ newt target set blinky build_profile=debug
$ newt target set blinky bsp=@apache-mynewt-core/hw/bsp/olimex_stm32-e407_devboard
$ newt target set blinky app=apps/blinky
-
+
$ newt target create boot_olimex
$ newt target set boot_olimex app=@apache-mynewt-core/apps/boot
$ newt target set boot_olimex bsp=@apache-mynewt-core/hw/bsp/olimex_stm32-e407_devboard
$ newt target set boot_olimex build_profile=optimized
-
- $ newt target show
+
+ $ newt target show
targets/blinky
app=apps/blinky
bsp=@apache-mynewt-core/hw/bsp/olimex_stm32-e407_devboard
@@ -85,9 +85,9 @@ Change directory to ~/dev/myproj directory and define the *blinky* target inside
### Build the images
-Next, let's build the images for the above targets. Afer you build the target, you can find the executable *blinky.elf* in the project directory *~/dev/myproj/bin/blinky/apps/blinky/.*
-
-
+Next, let's build the images for the above targets. Afer you build the target, you can find the executable *blinky.elf* in the project directory *~/dev/myproj/bin/blinky/apps/blinky/.*
+
+
```no-highlight
$ newt build blinky
Compiling case.c
@@ -98,7 +98,7 @@ Next, let's build the images for the above targets. Afer you build the target, y
$ ls ~/dev/myproj/bin/blinky/apps/blinky/
blinky.elf blinky.elf.bin blinky.elf.cmd
blinky.elf.lst blinky.elf.map
-
+
$ newt build boot_olimex
Building target targets/boot_olimex
App successfully built: ~/dev/myproj/bin/boot_olimex/apps/boot/boot.elf
@@ -106,7 +106,7 @@ Next, let's build the images for the above targets. Afer you build the target, y
<br>
-### Sign and create the blinky application image
+### Sign and create the blinky application image
You must sign and version your application image to download it using newt to the board. Use the newt create-image command to perform this action. You may assign an arbitrary version (e.g. 1.0.0) to the image.
@@ -129,12 +129,12 @@ Build manifest: ~/dev/myproj/bin/blinky/apps/blinky/manifest.json
<br>
-* B1_1/B1_0 and B0_1/B0_0 are PTH jumpers. Note that because the markings on the board may not always be accurate, when in doubt, you should always refer to the manual for the correct positioning. Since the jumpers are a pair, they should move together, and as such, the pair is responsible for the boot mode when bootloader is present.
+* B1_1/B1_0 and B0_1/B0_0 are PTH jumpers. Note that because the markings on the board may not always be accurate, when in doubt, you should always refer to the manual for the correct positioning. Since the jumpers are a pair, they should move together, and as such, the pair is responsible for the boot mode when bootloader is present.
To locate the bootloader, the board searches in three places: User Flash Memory, System Memory or the Embedded SRAM. For this Blinky project, we will configure it to boot from flash by jumpering **B0_0** and **B1_0**.
-* Connect USB-OTG#2 in the picture above to a USB port on your computer (or a powered USB hub to make sure there is enough power available to the board).
+* Connect USB-OTG#2 in the picture above to a USB port on your computer (or a powered USB hub to make sure there is enough power available to the board).
-* The red PWR LED should be lit.
+* The red PWR LED should be lit.
* Connect the JTAG connector to the SWD/JTAG interface on the board. The other end of the cable should be connected to the USB port or hub of your computer.
@@ -158,12 +158,12 @@ Successfully loaded image.
<br>
-**But wait...not so fast.** Let's double check that it is indeed booting from flash and making the LED blink from the image in flash. Pull the USB cable off the Olimex JTAG adaptor, severing the debug connection to the JTAG port. Next power off the Olimex board by pulling out the USB cable from the board. Wait for a couple of seconds and plug the USB cable back to the board.
+**But wait...not so fast.** Let's double check that it is indeed booting from flash and making the LED blink from the image in flash. Pull the USB cable off the Olimex JTAG adaptor, severing the debug connection to the JTAG port. Next power off the Olimex board by pulling out the USB cable from the board. Wait for a couple of seconds and plug the USB cable back to the board.
The LED light will start blinking again. Success!
-
+
**Note #1:** If you want to download the image to flash and a gdb session opened up, use `newt debug blinky`. Type `c` to continue inside the gdb session.
-
+
```no-highlight
$ newt debug blinky
Debugging with ~/dev/myproj/hw/bsp/olimex_stm32-e407_...
@@ -175,7 +175,7 @@ Successfully loaded image.
(info)
...
target state: halted
- target halted due to debug-request, current mode: Thread
+ target halted due to debug-request, current mode: Thread
xPSR: 0x01000000 pc: 0x08000250 msp: 0x10010000
Info : accepting 'gdb' connection from 3333
Info : device id = 0x10036413
@@ -186,22 +186,22 @@ Successfully loaded image.
```
<br>
-
+
**Note #2:** If you want to erase the flash and load the image again you may use the following commands from within gdb. `flash erase_sector 0 0 x` tells it to erase sectors 0 through x. When you ask it to display (in hex notation) the contents of the sector starting at location 'lma,' you should see all f's. The memory location 0x8000000 is the start or origin of the flash memory contents and is specified in the olimex_stm32-e407_devboard.ld linker script. The flash memory locations is specific to the processor.
```no-highlight
(gdb) monitor flash erase_sector 0 0 4
erased sectors 0 through 4 on flash bank 0 in 2.296712s
(gdb) monitor mdw 0x08000000 16
- 0x08000000: ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff
- (0x08000020: ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff
- (0x08000000: ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff
+ 0x08000000: ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff
+ (0x08000020: ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff
+ (0x08000000: ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff
(0x08000020: ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff
(gdb) monitor flash info 0
```
### Conclusion
-Congratulations! You have now tried out a project on actual hardware. If this is your first time to embedded systems, this must feel like the best hands-on and low-level "Hello World" program ever.
+Congratulations! You have now tried out a project on actual hardware. If this is your first time to embedded systems, this must feel like the best hands-on and low-level "Hello World" program ever.
Good, we have more fun tutorials for you to get your hands dirty. Be bold and try other Blinky-like [tutorials](../tutorials/nRF52.md) or try enabling additional functionality such as [remote comms](project-target-slinky.md) on the current board.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/docs/os/tutorials/project-target-slinky.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/project-target-slinky.md b/docs/os/tutorials/project-target-slinky.md
index ca2d66a..bea8049 100644
--- a/docs/os/tutorials/project-target-slinky.md
+++ b/docs/os/tutorials/project-target-slinky.md
@@ -5,13 +5,13 @@
The goal of the project is to enable and demonstrate remote communications with the Mynewt OS via newt manager (newtmgr) by leveraging a sample app "Slinky" included under the /apps directory in the repository. In this project we will define a target for the STM32-E407 board and assign the app "Slinky" to it.
-If you have an existing project using a target that does not use the Slinky app and you wish to add newtmgt functonality to it, check out the tutorial titled [Enable newtmgr in any app](add_newtmgr.md).
+If you have an existing project using a target that does not use the Slinky app and you wish to add newtmgt functonality to it, check out the tutorial titled [Enable newtmgr in any app](add_newtmgr.md).
<br>
### What you need
-1. STM32-E407 development board from Olimex. You can order it from [http://www.mouser.com](http://www.mouser.com/ProductDetail/Olimex-Ltd/STM32-E407/?qs=UN6GZl1KCcit6Ye0xmPO4A%3D%3D), [http://www.digikey.com](http://www.digikey.com/product-detail/en/STM32-E407/1188-1093-ND/3726951), and other places.
+1. STM32-E407 development board from Olimex. You can order it from [http://www.mouser.com](http://www.mouser.com/search/ProductDetail.aspx?R=0virtualkey0virtualkeySTM32-E407), [http://www.digikey.com](http://www.digikey.com/product-detail/en/STM32-E407/1188-1093-ND/3726951), and other places.
2. ARM-USB-TINY-H connector with JTAG interface for debugging ARM microcontrollers (comes with the ribbon cable to hook up to the board)
3. USB A-B type cable to connect the debugger to your personal computer
4. A USB to TTL Serial Cable with female wiring harness. An example is [http://www.amazon.com/JBtek�-WINDOWS-Supported-Raspberry-Programming/dp/B00QT7LQ88/ref=lp_464404_1_9?s=pc&ie=UTF8&qid=1454631303&sr=1-9](http://www.amazon.com/JBtek�-WINDOWS-Supported-Raspberry-Programming/dp/B00QT7LQ88/ref=lp_464404_1_9?s=pc&ie=UTF8&qid=1454631303&sr=1-9)
@@ -26,18 +26,18 @@ The instructions assume the user is using a Bourne-compatible shell (e.g. bash o
* Install dependencies
* Define a target using the newt tool
* Build executables for the targets using the newt tool
-* Set up serial connection with the targets
+* Set up serial connection with the targets
* Create a connection profile using the newtmgr tool
* Use the newtmgr tool to communicate with the targets
### Install newt
-If you have not already installed `newt`, see the
+If you have not already installed `newt`, see the
[newt installation instructions](../get_started/get_started/) and ensure newt is installed an in your path.
### Install newtmgr
-If you have not already installed `newtmgr`, see the
+If you have not already installed `newtmgr`, see the
[newtmgr installation instructions](../../newtmgr/installing/) and ensure newtmgr is installed an in your path.
### Create a new project
@@ -116,11 +116,11 @@ Build manifest: /Users/paulfdietrich/dev/slinky/bin/stm32_slinky/apps/slinky/man
<br>
-### Using newtmgr with a remote target
+### Using newtmgr with a remote target
-* First make sure the USB A-B type cable is connected to the ARM-USB-TINY-H debugger connector on the Olimex board.
+* First make sure the USB A-B type cable is connected to the ARM-USB-TINY-H debugger connector on the Olimex board.
- Next go the to project directory and download the slinky project image to the flash of the Olimex board.
+ Next go the to project directory and download the slinky project image to the flash of the Olimex board.
```no-highlight
$ newt load stm32_bootloader
@@ -136,8 +136,8 @@ You can now disconnect the debugging cable from the board. You should see the gr
- * Connect the female RX pin of the USB-TTL serial cable to the TX of the UEXT connector on the board.
- * Connect the female TX pin of the USB-TTL serial cable to the RX of the UEXT connector on the board.
+ * Connect the female RX pin of the USB-TTL serial cable to the TX of the UEXT connector on the board.
+ * Connect the female TX pin of the USB-TTL serial cable to the RX of the UEXT connector on the board.
* Connect the GND pin of the USB-TTL serial cable to the GND of the UEXT connector on the board.
<br>
@@ -145,7 +145,7 @@ You can now disconnect the debugging cable from the board. You should see the gr
* Locate the serial connection established in the /dev directory of your computer. It should be of the type `tty.usbserial-<some identifier>`.
```no-highlight
- $ ls /dev/tty.usbserial-AJ03HAQQ
+ $ ls /dev/tty.usbserial-AJ03HAQQ
/dev/tty.usbserial-AJ03HAQQ
```
@@ -156,17 +156,17 @@ You can now disconnect the debugging cable from the board. You should see the gr
```no-highlight
$ pwd
/Users/<user>/dev/larva/project/slinky
- $ newtmgr conn add olimex01 type=serial connstring=/dev/tty.usbserial-AJ03HAQQ
+ $ newtmgr conn add olimex01 type=serial connstring=/dev/tty.usbserial-AJ03HAQQ
Connection profile olimex01 successfully added
$ newtmgr conn show
- Connection profiles:
+ Connection profiles:
sim1: type=serial, connstring='/dev/ttys007'
olimex01: type=serial, connstring='/dev/tty.usbserial-AJ03HAQQ'
```
<br>
-* Now go ahead and query the Olimex board to get responses back. The simplest command is the `echo` command to ask it to respond with the text you send it.
+* Now go ahead and query the Olimex board to get responses back. The simplest command is the `echo` command to ask it to respond with the text you send it.
```no-highlight
$ newtmgr echo -c olimex01 hello
@@ -182,13 +182,3 @@ You can now disconnect the debugging cable from the board. You should see the gr
idle (prio=255 tid=0 runtime=299916 cswcnt=313 stksize=32 stkusage=18 last_checkin=0 next_checkin=0)
shell (prio=3 tid=1 runtime=1 cswcnt=20 stksize=384 stkusage=60 last_checkin=0 next_checkin=0)
```
-
-
-
-
-
-
-
-
-
-
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/docs/os/tutorials/tutorials.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/tutorials.md b/docs/os/tutorials/tutorials.md
index ffc874b..b66222e 100644
--- a/docs/os/tutorials/tutorials.md
+++ b/docs/os/tutorials/tutorials.md
@@ -1,6 +1,6 @@
## Tutorials
-If the introduction to Mynewt has piqued your interest and you want to familiarize yourself with some of its functionality, this series of tutorials is for you. The lessons are aimed at the beginner.
+If the introduction to Mynewt has piqued your interest and you want to familiarize yourself with some of its functionality, this series of tutorials is for you. The lessons are aimed at the beginner.
The full list of tutorials can be seen in the navigation bar on the left. New ones are being constantly added and will show up there automatically.
@@ -10,14 +10,14 @@ The full list of tutorials can be seen in the navigation bar on the left. New on
* You have installed Docker container of Newt tool and toolchains or you have installed them natively on your machine
* You have created a new project space (directory structure) and populated it with the core code repository (apache-mynewt-core) or know how to as explained in [Creating Your First Project](../get_started/project_create).
-* You have at least one of the supported development boards:
+* You have at least one of the supported development boards:
* [STM32F3 discovery kit from ST Micro](STM32F303.md)
* [Arduino Zero hardware](arduino_zero.md)
* [Olimex/STM32F407ZGT6 Cortex-M4 hardware](olimex.md)
* [nRF52 Development Kit from Nordic Semiconductor](nRF52.md)
-
-The Nordic nrf52 developer kit supports Bluetooth Low Energy. We are always looking to add new hardware to the list, so if you want to develop the required Board Support Package (bsp) and/or Hardware Abstraction Layer (HAL) for a new board, you can look [here](../../core_os/porting/port_os/) to get started.
-
+
+The Nordic nrf52 developer kit supports Bluetooth Low Energy. We are always looking to add new hardware to the list, so if you want to develop the required Board Support Package (bsp) and/or Hardware Abstraction Layer (HAL) for a new board, you can look [here](../core_os/porting/port_os/) to get started.
+
<br>
@@ -30,14 +30,14 @@ The tutorials fall into a few broad categories. Some examples in each category a
* [Blinky on Olimex/STM32F407ZGT6 Cortex-M4 hardware](olimex.md)
* [Blinky on STM32F3 discovery kit from ST Micro](STM32F303.md)
* [Blinky on nRF52 Development Kit from Nordic Semiconductor](nRF52.md) **Note:** This supports BLE.
-
+
<br>
-
+
* Tweaking available apps to customize behavior e.g. making a more exciting LED blink pattern
* [Pinwheel Blinky on STM32F3 discovery board](pin-wheel-mods.md)
-
+
<br>
-
+
* Navigating the code and adding functionality
* [Adding more repositories to your project](repo/add_repos.md)
* [Adding a unit test for a package](unit_test.md)
@@ -51,7 +51,7 @@ The tutorials fall into a few broad categories. Some examples in each category a
<br>
-* Using NewtMgr
+* Using NewtMgr
* [Enabling remote communication with a device running Mynewt OS](project-slinky.md)
<br>
@@ -62,4 +62,3 @@ The tutorials fall into a few broad categories. Some examples in each category a
**Send us an email on the dev@ mailing list if you have comments or suggestions!** If you haven't joined the mailing list, you will find the links [here](../../community.md).
<br>
-
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/5c00cfff/docs/os/tutorials/wi-fi_on_arduino.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/wi-fi_on_arduino.md b/docs/os/tutorials/wi-fi_on_arduino.md
index 6d27114..977f6d8 100644
--- a/docs/os/tutorials/wi-fi_on_arduino.md
+++ b/docs/os/tutorials/wi-fi_on_arduino.md
@@ -1,13 +1,13 @@
## Start Wi-Fi on Arduino Zero
-This tutorial walks you through the steps to get your Arduino board on a Wi-Fi network.
+This tutorial walks you through the steps to get your Arduino board on a Wi-Fi network.
**Note:** Wi-Fi support is currently available in the `develop` branch of Mynewt only. It will be merged into `master` branch when version 0.10 is released.
### Prerequisites
-Before tackling this tutorial, it's best to read about Mynewt in the [Introduction](../get_started/introduction) section of this documentation.
+Before tackling this tutorial, it's best to read about Mynewt in the [Introduction](../get_started/get_started) section of this documentation.
### Equipment
@@ -24,7 +24,7 @@ You will need the following equipment
### Install Mynewt and Newt
-* If you have not already done so, install Newt as shown in the [Newt install tutorial](../../newt/install/newt_mac.md).
+* If you have not already done so, install Newt as shown in the [Newt install tutorial](../../newt/install/newt_mac.md).
* If you installed Newt previously but need to update it, go to the newt git repo directory, pull the latest code from `develop` branch, and install the updated code.
```
@@ -49,10 +49,10 @@ Let's say your new project is named `arduinowifi`. You will henceforth be workin
### Fetch External Packages, Set correct version to download
-Mynewt uses source code provided directly from the chip manufacturer for
+Mynewt uses source code provided directly from the chip manufacturer for
low level operations. Sometimes this code is licensed only for the specific manufacturer of the chipset and cannot live in the Apache Mynewt repository. That happens to be the case for the Arduino Zero board which uses Atmel SAMD21. Runtime's github repository hosts such external third-party packages and the Newt tool can fetch them.
-To fetch the package with MCU support for Atmel SAMD21 for Arduino Zero from the Runtime git repository, you need to add
+To fetch the package with MCU support for Atmel SAMD21 for Arduino Zero from the Runtime git repository, you need to add
the repository to the `project.yml` file in your base project directory (`arduinowifi`).
```
@@ -60,13 +60,13 @@ user@~/dev/arduinowifi$ vi project.yml
```
Here is an example ```project.yml``` file with the Arduino Zero repository
-added. The sections with ```mynewt_arduino_zero``` that need to be added to
-your project file are highlighted.
+added. The sections with ```mynewt_arduino_zero``` that need to be added to
+your project file are highlighted.
Also highlighted is the `0-dev` version for both the repositories to ensure code is downloaded from the `develop` branch.
```hl_lines="6 10 14 15 16 17 18"
-$ more project.yml
+$ more project.yml
project.name: "my_project"
project.repositories:
@@ -84,17 +84,17 @@ repository.mynewt_arduino_zero:
vers: 0-dev
user: runtimeinc
repo: mynewt_arduino_zero
-$
+$
```
<br>
-Once you've edited your ```project.yml``` file, the next step is to install the
-project dependencies, this can be done with the ```newt install``` command
-(to see more output, provide the ```-v``` verbose option.):
+Once you've edited your ```project.yml``` file, the next step is to install the
+project dependencies, this can be done with the ```newt install``` command
+(to see more output, provide the ```-v``` verbose option.):
```no-highlight
-$ newt install
+$ newt install
apache-mynewt-core
mynewt_arduino_zero
$
@@ -104,15 +104,15 @@ $
### Create your bootloader target
-Next, you need to tell Newt what to build. For the Arduino Zero, we are going to
+Next, you need to tell Newt what to build. For the Arduino Zero, we are going to
generate both a bootloader, and an image target.
-To generate the bootloader target, you need to specify the following options. The output of the commands (indicating success) have been suppressed for easier readability.
+To generate the bootloader target, you need to specify the following options. The output of the commands (indicating success) have been suppressed for easier readability.
```no-highlight
-$ newt target create arduino_boot
-$ newt target set arduino_boot bsp=@mynewt_arduino_zero/hw/bsp/arduino_zero
-$ newt target set arduino_boot app=@apache-mynewt-core/apps/boot
+$ newt target create arduino_boot
+$ newt target set arduino_boot bsp=@mynewt_arduino_zero/hw/bsp/arduino_zero
+$ newt target set arduino_boot app=@apache-mynewt-core/apps/boot
$ newt target set arduino_boot build_profile=optimized
```
@@ -121,13 +121,13 @@ $ newt target set arduino_boot build_profile=optimized
If you have an Arduino Zero Pro or M0 Pro, you have to set the following next:
```
-$ newt target set arduino_boot features=arduino_zero_pro
+$ newt target set arduino_boot features=arduino_zero_pro
```
If you have an Arduino Zero, you have to set the following instead:
```
-$ newt target set arduino_boot features=arduino_zero
+$ newt target set arduino_boot features=arduino_zero
```
<br>
@@ -138,7 +138,7 @@ $ newt target set arduino_boot features=arduino_zero
Once you've configured the bootloader target, the next step is to build the bootloader for your Arduino. You can do this by using the ```newt build``` command:
```no-highlight
-$ newt build arduino_boot
+$ newt build arduino_boot
Compiling boot.c
Archiving boot.a
Compiling fs_cli.c
@@ -149,32 +149,32 @@ Compiling fs_mkdir.c
App successfully built: ~/dev/arduinowifi/bin/arduino_boot/apps/boot/boot.elf
```
-If this command finishes successfully, you have successfully built the Arduino
-bootloader, and the next step is to build your application for the Arduino
+If this command finishes successfully, you have successfully built the Arduino
+bootloader, and the next step is to build your application for the Arduino
board.
<br>
-### Build your blinky app
+### Build your blinky app
To create and download your application, you create another target, this one pointing to the application you want to download to the Arduino board. In this tutorial, we will use the Wi-Fi application that comes in the arduino repository, `apps/winc1500_wifi`:
**Note**: Remember to set features to `arduino_zero` if your board is Arduino Zero and not a Pro!
```hl_lines="5"
-$ newt target create arduino_wifi
+$ newt target create arduino_wifi
$ newt target set arduino_wifi app=@mynewt_arduino_zero/apps/winc1500_wifi
$ newt target set arduino_wifi bsp=@mynewt_arduino_zero/hw/bsp/arduino_zero
-$ newt target set arduino_wifi build_profile=debug
-$ newt target set arduino_wifi features=arduino_zero_pro
+$ newt target set arduino_wifi build_profile=debug
+$ newt target set arduino_wifi features=arduino_zero_pro
```
<br>
-You can now build the target, with ```newt build```:
+You can now build the target, with ```newt build```:
```no-highlight
-$ newt build arduino_wifi
+$ newt build arduino_wifi
Building target targets/arduino_wifi
Compiling main.c
Archiving winc1500_wifi.a
@@ -204,13 +204,13 @@ The picture below shows the setup.
### Download the Bootloader
-Execute the command to download the bootloader.
+Execute the command to download the bootloader.
```c
$ newt load arduino_boot
```
-If the newt tool finishes without error, that means the bootloader has been
+If the newt tool finishes without error, that means the bootloader has been
successfully loaded onto the target.
<br>
@@ -219,7 +219,7 @@ successfully loaded onto the target.
<br>
-### Load the Application Image
+### Load the Application Image
Now that the bootloader is downloaded to the target, the next steps are to create an image and load it onto the target device.
@@ -246,7 +246,7 @@ $ minicom -D /dev/tty.usbmodem141122 -b 115200
Welcome to minicom 2.7
-OPTIONS:
+OPTIONS:
Compiled on Nov 24 2015, 16:14:21.
Port /dev/tty.usbmodem141122, 10:11:40
@@ -263,7 +263,7 @@ wifi_init : 0
Connect to the local Wi-Fi network. Then start network services. The commands to be issued are highlighted below. In the example below, the network interface on the Arduino board gets an IP address of `192.168.0.117`.
```hl_lines="1 8"
-wifi connect <Wi-Fi network name> <password>
+wifi connect <Wi-Fi network name> <password>
16906:wifi_request_scan : 0
17805:scan_results 16: 0
17816:wifi_connect : 0
@@ -291,4 +291,4 @@ $
One port echoes whatever is typed, one discards everything it gets, and the third spews out bits constantly. Type `wifi stop` to disable WiFi on the Arduino board.
-Hope you had fun!
\ No newline at end of file
+Hope you had fun!
[6/9] incubator-mynewt-site git commit: fix broken links
Posted by ad...@apache.org.
fix broken links
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/bbbda539
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/bbbda539
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/bbbda539
Branch: refs/heads/develop
Commit: bbbda5391078d7018ed1b64d1f274c01230ebb4b
Parents: e812d37
Author: Gavin Jefferies <ga...@runtime.io>
Authored: Fri Oct 7 14:26:31 2016 -0700
Committer: Gavin Jefferies <ga...@runtime.io>
Committed: Fri Oct 7 15:04:19 2016 -0700
----------------------------------------------------------------------
docs/about.md | 2 +-
docs/network/ble/ini_stack/ble_parent_ini.md | 2 +-
docs/os/core_os/porting/port_bsp.md | 20 ++---
docs/os/core_os/porting/port_os.md | 41 +++++-----
docs/os/introduction.md | 32 ++++----
docs/os/tutorials/arduino_zero.md | 98 +++++++++++------------
docs/os/tutorials/ibeacon.md | 2 +-
docs/quick-start.md | 2 +-
8 files changed, 99 insertions(+), 100 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/bbbda539/docs/about.md
----------------------------------------------------------------------
diff --git a/docs/about.md b/docs/about.md
index a7a9fd0..5ba9e00 100644
--- a/docs/about.md
+++ b/docs/about.md
@@ -18,7 +18,7 @@ Some upcoming features:
The WISHLIST at the top of the roadmap on [JIRA for Mynewt](https://issues.apache.org/jira/browse/MYNEWT/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel) features all the new ideas awaiting discussion and review. Once the community decides to go ahead with a request, it is scheduled into a release. Generally, effort is made to schedule a requested feature into a particular version no later than 6 weeks prior to the planned release date.
-If you have suggestions for a new feature, use case, or implementation improvements, file a JIRA ticket with Issue Type set to "Wish". Introduce it in the [dev@](dev@mynewt.incubator.apache.org) mailing list with a link to the JIRA ticket. This assumes you have signed up for an account on JIRA and submitted a request to the dev@ mailing list for your JIRA username to be added to the Apache Mynewt (MYNEWT) project.
+If you have suggestions for a new feature, use case, or implementation improvements, file a JIRA ticket with Issue Type set to "Wish". Introduce it in the [dev@](http://mail-archives.apache.org/mod_mbox/incubator-mynewt-dev/) mailing list with a link to the JIRA ticket. This assumes you have signed up for an account on JIRA and submitted a request to the dev@ mailing list for your JIRA username to be added to the Apache Mynewt (MYNEWT) project.
<br>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/bbbda539/docs/network/ble/ini_stack/ble_parent_ini.md
----------------------------------------------------------------------
diff --git a/docs/network/ble/ini_stack/ble_parent_ini.md b/docs/network/ble/ini_stack/ble_parent_ini.md
index 37054c5..463a6f0 100644
--- a/docs/network/ble/ini_stack/ble_parent_ini.md
+++ b/docs/network/ble/ini_stack/ble_parent_ini.md
@@ -6,7 +6,7 @@ application-specific work, the host parent task does work for NimBLE by
processing events generated by the host.
The process of creating an OS task is described in the [Add Task
-tutorial](#../../../../os/tutorials/event_queue/).
+tutorial](../../../../os/tutorials/event_queue/).
**Priority:**
It is up to you which priority to use for the host parent task. Unlike the
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/bbbda539/docs/os/core_os/porting/port_bsp.md
----------------------------------------------------------------------
diff --git a/docs/os/core_os/porting/port_bsp.md b/docs/os/core_os/porting/port_bsp.md
index 4747589..1a34a9d 100644
--- a/docs/os/core_os/porting/port_bsp.md
+++ b/docs/os/core_os/porting/port_bsp.md
@@ -1,5 +1,5 @@
-#Create a BSP for your Target
+#Create a BSP for your Target
###Introduction
@@ -24,8 +24,8 @@ Select a name for your BSP. For the remainder of this document, we'll assume th
Create a directory `hw/bsp/myboard` using the name chosen above. Within this BSP directory, create the following subdirectories:
-Select a name for your BSP. For the remainder of this document,
-well assume the bsp is named `myboard`. In general its best to select a
+Select a name for your BSP. For the remainder of this document,
+well assume the bsp is named `myboard`. In general its best to select a
name that describes the board/system you are creating.
* `include`
@@ -34,7 +34,7 @@ name that describes the board/system you are creating.
###Create a Target using Mynewt
-Create a newt target for your test project for the BSP. To learn how to create a target, see this **howto** [Tutorial](../../get_started/project1). Once you are familiar with creating targets, move on below to create a target to use to test your BSP.
+Create a newt target for your test project for the BSP. To learn how to create a target, see this **howto** [Tutorial](../../get_started/project_create). Once you are familiar with creating targets, move on below to create a target to use to test your BSP.
It is recommended that you use a simple `project` like `blinky` to minimize time to get a working Mynewt system. For this document, we will assume the `target` is called `myboard_blinky` and uses project `blinky`.
@@ -43,7 +43,7 @@ Set the `bsp` of the project to `/hw/bsp/myboard`. While creating your target, y
When you are complete, your `target` may look similar to this.
```c
- $newt target show
+ $newt target show
myboard_blinky
arch=cortex_m0
bsp=hw/bsp/myboard
@@ -80,7 +80,7 @@ Optionally, create these files as necessary to provide all functionality from My
###Fill Out your Package File
-Edit the package file to describe your BSP.
+Edit the package file to describe your BSP.
The package file must contain:
@@ -102,7 +102,7 @@ The package file typically contains:
pkg.linkerscript.bootloader.OVERWRITE: "myboard_boot.ld"
pkg.downloadscript: "myboard_download.sh"
pkg.debugscript: "myboard_debug.sh"
- pkg.deps:
+ pkg.deps:
- hw/mcu/mymcu/variant
```
where `mymcu/variant` should be replaced with the specific MCU and variant used in your design.
@@ -160,7 +160,7 @@ Create an alternate linker script for the bootloader since it is typically linke
###Add Functions and Defines
-At this point, it will be possible to run the `newt` tool to build your target.
+At this point, it will be possible to run the `newt` tool to build your target.
You may run into complaints from the linker script that a few Mynewt specific functions are missing. We will describe these below.
@@ -173,7 +173,7 @@ There are also several libc definitions that can be stubbed in your first BSP. E
| **Function** | **Description** |
|-----------|-------------|
-| _sbrk | Returns memory from heap (used by malloc) |
+| _sbrk | Returns memory from heap (used by malloc) |
* Implement `_sbrk()`
@@ -232,5 +232,5 @@ The `LICENSE` file is an ASCII text file that describes the source license for t
package.
The `README.md` is a [markdown](https://en.wikipedia.org/wiki/Markdown)
- file that contains any documentation you
+ file that contains any documentation you
want to provide for the BSP.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/bbbda539/docs/os/core_os/porting/port_os.md
----------------------------------------------------------------------
diff --git a/docs/os/core_os/porting/port_os.md b/docs/os/core_os/porting/port_os.md
index 1a3b779..0784fc4 100644
--- a/docs/os/core_os/porting/port_os.md
+++ b/docs/os/core_os/porting/port_os.md
@@ -1,35 +1,35 @@
# Porting Mynewt OS
-This chapter describes how to adapt the Mynewt OS to different platforms.
+This chapter describes how to adapt the Mynewt OS to different platforms.
###Description
-The Mynewt OS is a complete multi-tasking environment with scheduler, time
-control, buffer management, and synchronization objects. it also includes
-libraries and services like console, command shell, image manager,
+The Mynewt OS is a complete multi-tasking environment with scheduler, time
+control, buffer management, and synchronization objects. it also includes
+libraries and services like console, command shell, image manager,
bootloader, and file systems etc.
Thee majority of this software is platform independent and requires no
-intervention to run on your platform, but some of the components require
-support from the underlying platform.
+intervention to run on your platform, but some of the components require
+support from the underlying platform.
The platform dependency of these components can fall into several categories:
-* **CPU Core Dependencies** -- Specific code or
+* **CPU Core Dependencies** -- Specific code or
configuration to operate the CPU core within your target platform
-* **MCU Dependencies** -- Specific code or configuration to operate the MCU or
+* **MCU Dependencies** -- Specific code or configuration to operate the MCU or
SoC within your target platform
-* **BSP Dependencies** -- Specific code or configuration to accommodate the
-specific layout and functionality of your target platform
+* **BSP Dependencies** -- Specific code or configuration to accommodate the
+specific layout and functionality of your target platform
###BSP Dependency
-With all of the functionality provided by the core, MCU, and MCU HAL (Hardware Abstraction Layer), there are still some things that must be specified for your particular system. This
+With all of the functionality provided by the core, MCU, and MCU HAL (Hardware Abstraction Layer), there are still some things that must be specified for your particular system. This
is provided in Mynewt to allow you the flexibility to design for the exact
functionality, peripherals and features that you require in your product.
-In Mynewt, these settings/components are included in a Board Support Package
-(BSP). The BSP contains the information specific to running Mynewt on a target
+In Mynewt, these settings/components are included in a Board Support Package
+(BSP). The BSP contains the information specific to running Mynewt on a target
platform or hardware board. Mynewt supports some common open source hardware as well
as the development boards for some common MCUs. These development systems
might be enough for you to get your prototype up and running, but when building
@@ -37,13 +37,13 @@ a product you are likely going to have your own board which is slightly differen
from those already supported by Mynewt.
For example, you might decide on your system that 16 Kilobytes of flash space
-in one flash device is reserved for a flash file system. Or on your system
+in one flash device is reserved for a flash file system. Or on your system
you may decide that GPIO pin 5 of the MCU is connected to the system LED. Or
you may decide that the OS Tick (the underlying time source for the OS) should
-run slower than the defaults to conserve battery power. These types of
+run slower than the defaults to conserve battery power. These types of
behaviors are specified in the BSP.
-The information provided in the BSP (what you need to specify to get a
+The information provided in the BSP (what you need to specify to get a
complete executable) can vary depending on the MCU and its underlying core
architecture. For example, some MCUs have dedicated pins for UART, SPI etc,
so there is no configuration required in the BSP when using these peripherals.
@@ -51,14 +51,14 @@ However some MCUs have a pin multiplexor that allows the UART to be mapped to
several different pins. For these MCUs, the BSP must specify if and where
the UART pins should appear to match the hardware layout of your system.
-* If your BSP is already supported my Mynewt, there is no additional BSP work involved in porting to your platform. You need only to set the `bsp` attribute in your Mynewt target using the [newt command tool](../../../../newt/newt_intro).
+* If your BSP is already supported my Mynewt, there is no additional BSP work involved in porting to your platform. You need only to set the `bsp` attribute in your Mynewt target using the [newt command tool](../../../newt/newt_intro).
* If your BSP is not yet supported by Mynewt, you can add support following the instructions on [how to add BSP support to Mynewt](port_bsp.md)
###MCU Dependency
Some OS code depends on the MCU or SoC that the system contains. For example, the MCU may specify the potential memory map of the system - where code and data can reside.
-* If your MCU is already supported my Mynewt, there is no additional MCU work involved in porting to your platform. You need only to set the `arch` attribute in your Mynewt target using the [newt command tool](../../../../newt/newt_intro).
+* If your MCU is already supported my Mynewt, there is no additional MCU work involved in porting to your platform. You need only to set the `arch` attribute in your Mynewt target using the [newt command tool](../../../newt/newt_intro).
* If your MCU is not yet supported by Mynewt, you can add support following the instructions on[how to add MCU support to Mynewt](port_mcu.md)
@@ -67,10 +67,9 @@ Some OS code depends on the MCU or SoC that the system contains. For example, th
Mynewt's architecture supports a hardware abstraction layer (HAL) for common on or off-chip MCU peripherals such as GPIO, UARTs, flash memory etc. Even if your MCU is supported for the core OS, you may find that you need to implement the HAL functionality for a new peripheral. For a description of the HAL abstraction and implementation information,
see the [HAL API](../../modules/hal/hal.md)
-###CPU Core Dependency
+###CPU Core Dependency
Some OS code depends on the CPU core that your system is using. For example, a given CPU core has a specific assembly language instruction set, and may require special cross compiler or compiler settings to use the appropriate instruction set.
-* If your CPU architecture is already supported my Mynewt, there is no CPU core work involved in porting to your platform. You need only to set the `arch` and `compiler` attributes in your Mynewt target using the [newt command tool](../../../../newt/newt_intro).
+* If your CPU architecture is already supported my Mynewt, there is no CPU core work involved in porting to your platform. You need only to set the `arch` and `compiler` attributes in your Mynewt target using the [newt command tool](../../../newt/newt_intro).
* If your CPU architecture is not supported by Mynewt, you can add support following the instructions on [how to add CPU architecture support to Mynewt](port_cpu.md)
-
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/bbbda539/docs/os/introduction.md
----------------------------------------------------------------------
diff --git a/docs/os/introduction.md b/docs/os/introduction.md
index 22df5c9..4d83372 100644
--- a/docs/os/introduction.md
+++ b/docs/os/introduction.md
@@ -3,14 +3,14 @@
### Welcome to Apache Mynewt
Apache Mynewt is an operating system that makes it easy to develop
-applications for microcontroller environments where power and cost
-are driving factors. Examples of these devices are connected locks,
+applications for microcontroller environments where power and cost
+are driving factors. Examples of these devices are connected locks,
lights, and wearables.
-Microcontroller environments have a number of characteristics that
-makes the operating system requirements for them unique:
+Microcontroller environments have a number of characteristics that
+makes the operating system requirements for them unique:
-* Low memory footprint: memory on these systems range from
+* Low memory footprint: memory on these systems range from
8-16KB (on the low end) to 16MB (on the high end).
* Reduced code size: code often runs out of flash, and total available code size ranges from 64-128KB to 16-32MB.
@@ -22,7 +22,7 @@ battery power and maximize power usage.
As more and more devices get connected, these interconnected devices perform complex tasks. To
perform these tasks, you need low-level operational functionality built into the operating system.
-Typically, connected devices built with these microcontrollers perform a myriad of functions:
+Typically, connected devices built with these microcontrollers perform a myriad of functions:
* Networking Stacks: Bluetooth Low Energy and Thread
@@ -34,23 +34,23 @@ to keep time.
Apache Mynewt accomplishes all the above easily, by providing a complete
operating system for constrained devices, including:
-* A fully open-source Bluetooth Low Energy stack with both Host and
-Controller implementations.
+* A fully open-source Bluetooth Low Energy stack with both Host and
+Controller implementations.
* A pre-emptive, multi-tasking Real Time operating system kernel
-* A Hardware Abstraction Layer (HAL) that abstracts the MCU's
+* A Hardware Abstraction Layer (HAL) that abstracts the MCU's
peripheral functions, allowing developers to easily write cross-platform
code.
<br>
### Newt ###
-In order to provide all this functionality, and operate in an
-extremely low resource environment, Mynewt provides a very fine-grained source
-package management and build system tool, called *newt*.
+In order to provide all this functionality, and operate in an
+extremely low resource environment, Mynewt provides a very fine-grained source
+package management and build system tool, called *newt*.
-You can install and build *newt* for [Linux](..//newt/install/newt_linux/) or [Mac](../newt/install/newt_mac/).
+You can install and build *newt* for [Linux](../newt/install/newt_linux/) or [Mac](../newt/install/newt_mac/).
<br>
@@ -59,13 +59,13 @@ You can install and build *newt* for [Linux](..//newt/install/newt_linux/) or [M
In order to enable a user to communicate with remote instances of Mynewt OS and query, configure, and operate them, Mynewt provides an application tool called Newt Manager or `newtmgr`.
-You can install and build *newtmgr* from source code on [Linux or Mac](../newtmgr/installing/).
+You can install and build *newtmgr* from source code on [Linux or Mac](../newtmgr/installing/).
<br>
### Build your first Mynewt App with Newt ###
-With the introductions out of the way, now is a good time to [get set up and
-started](../get_started/get_started/) with your first Mynewt application.
+With the introductions out of the way, now is a good time to [get set up and
+started](get_started/get_started/) with your first Mynewt application.
Happy Hacking!
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/bbbda539/docs/os/tutorials/arduino_zero.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/arduino_zero.md b/docs/os/tutorials/arduino_zero.md
index 9926656..6f25374 100644
--- a/docs/os/tutorials/arduino_zero.md
+++ b/docs/os/tutorials/arduino_zero.md
@@ -6,13 +6,13 @@ This tutorial describes how to run Mynewt OS on Arduino Zero. Follow these simpl
### Prerequisites
-Before tackling this tutorial, it's best to read about Mynewt in the [Introduction](../get_started/introduction) section of this documentation.
+Before tackling this tutorial, it's best to read about Mynewt in the [Introduction](../get_started/get_started) section of this documentation.
### Equipment
You will need the following equipment
-* An Arduino Zero board. NOTE: There are many flavors of Arduino. Ensure that
+* An Arduino Zero board. NOTE: There are many flavors of Arduino. Ensure that
you have an Arduino Zero. See below for the versions of Arduino Zero that are
compatible with this tutorial
* A computer that can connect to the Arduino Zero over USB
@@ -34,20 +34,20 @@ Mynewt has not been tested on Arduino M0 which has no internal debugger support.
<br>
-### Fetch External Packages
+### Fetch External Packages
-Mynewt uses source code provided directly from the chip manufacturer for
+Mynewt uses source code provided directly from the chip manufacturer for
low level operations. Sometimes this code is licensed only for the specific manufacturer of the chipset and cannot live in the Apache Mynewt repository. That happens to be the case for the Arduino Zero board which uses Atmel SAMD21. Runtime's github repository hosts such external third-party packages and the Newt tool can fetch them.
-To fetch the package with MCU support for Atmel SAMD21 for Arduino Zero from the Runtime git repository, you need to add
+To fetch the package with MCU support for Atmel SAMD21 for Arduino Zero from the Runtime git repository, you need to add
the repository to the `project.yml` file in your base project directory.
Here is an example ```project.yml``` file with the Arduino Zero repository
-added. The sections with ```mynewt_arduino_zero``` that need to be added to
+added. The sections with ```mynewt_arduino_zero``` that need to be added to
your project file are highlighted.
```hl_lines="6 14 15 16 17 18"
-$ more project.yml
+$ more project.yml
project.name: "my_project"
project.repositories:
@@ -65,17 +65,17 @@ repository.mynewt_arduino_zero:
vers: 0-latest
user: runtimeinc
repo: mynewt_arduino_zero
-$
+$
```
<br>
-Once you've edited your ```project.yml``` file, the next step is to install the
-project dependencies, this can be done with the ```newt install``` command
-(to see more output, provide the ```-v``` verbose option.):
+Once you've edited your ```project.yml``` file, the next step is to install the
+project dependencies, this can be done with the ```newt install``` command
+(to see more output, provide the ```-v``` verbose option.):
```no-highlight
-$ newt install
+$ newt install
apache-mynewt-core
mynewt_arduino_zero
$
@@ -89,15 +89,15 @@ $
### Create your bootloader target
-Next, you need to tell Newt what to build. For the Arduino Zero, we are going to
+Next, you need to tell Newt what to build. For the Arduino Zero, we are going to
generate both a bootloader, and an image target.
-To generate the bootloader target, you need to specify the following options. The output of the commands (indicating success) have been suppressed for easier readability.
+To generate the bootloader target, you need to specify the following options. The output of the commands (indicating success) have been suppressed for easier readability.
```no-highlight
-$ newt target create arduino_boot
-$ newt target set arduino_boot bsp=@mynewt_arduino_zero/hw/bsp/arduino_zero
-$ newt target set arduino_boot app=@apache-mynewt-core/apps/boot
+$ newt target create arduino_boot
+$ newt target set arduino_boot bsp=@mynewt_arduino_zero/hw/bsp/arduino_zero
+$ newt target set arduino_boot app=@apache-mynewt-core/apps/boot
$ newt target set arduino_boot build_profile=optimized
```
@@ -106,24 +106,24 @@ $ newt target set arduino_boot build_profile=optimized
If you have an Arduino Zero Pro or M0 Pro, you have to set the following next:
```
-$ newt target set arduino_boot features=arduino_zero_pro
+$ newt target set arduino_boot features=arduino_zero_pro
```
If you have an Arduino Zero, you have to set the following instead:
```
-$ newt target set arduino_boot features=arduino_zero
+$ newt target set arduino_boot features=arduino_zero
```
<br>
-These commands do a few things:
+These commands do a few things:
* Create a target named ```arduino_boot```, in order to build the Arduino Zero Bootloader.
- * Set the application for the ```arduino_boot``` target to the default Apache Mynewt
+ * Set the application for the ```arduino_boot``` target to the default Apache Mynewt
bootloader (```@apache-mynewt-core/apps/boot```)
- * Set the board support package for the target to
- ```@mynewt_arduino_zero/hw/bsp/arduino_zero```. This is a reference to the downloaded
+ * Set the board support package for the target to
+ ```@mynewt_arduino_zero/hw/bsp/arduino_zero```. This is a reference to the downloaded
Arduino Zero support from Github.
* Use the "optimized" build profile for the `arduino_boot` target. This
instructs Newt to generate smaller and more efficient code for this target.
@@ -137,7 +137,7 @@ These commands do a few things:
Once you've configured the bootloader target, the next step is to build the bootloader for your Arduino. You can do this by using the ```newt build``` command:
```no-highlight
-$ newt build arduino_boot
+$ newt build arduino_boot
Compiling asprintf.c
Compiling atoi.c
Compiling atol.c
@@ -151,38 +151,38 @@ Compiling inline.c
App successfully built: myproject/bin/arduino_boot/apps/boot/boot.elf
```
-If this command finishes successfully, you have successfully built the Arduino
-bootloader, and the next step is to build your application for the Arduino
+If this command finishes successfully, you have successfully built the Arduino
+bootloader, and the next step is to build your application for the Arduino
board.
<br>
-### Build your blinky app
+### Build your blinky app
To create and download your application, you create another target, this one pointing to the application you want to download to the Arduino board. In this tutorial, we will use the default application that comes with your project, ```apps/blinky```:
**Note**: Remember to set features to `arduino_zero` if your board is Arduino Zero and not a Pro!
```hl_lines="9"
-$ newt target create arduino_blinky
+$ newt target create arduino_blinky
Target targets/arduino_blinky successfully created
-$ newt target set arduino_blinky app=apps/blinky
+$ newt target set arduino_blinky app=apps/blinky
Target targets/arduino_blinky successfully set target.app to apps/blinky
$ newt target set arduino_blinky bsp=@mynewt_arduino_zero/hw/bsp/arduino_zero
Target targets/arduino_blinky successfully set target.bsp to @mynewt_arduino_zero/hw/bsp/arduino_zero
-$ newt target set arduino_blinky build_profile=debug
+$ newt target set arduino_blinky build_profile=debug
Target targets/arduino_blinky successfully set target.build_profile to debug
-$ newt target set arduino_blinky features=arduino_zero_pro
+$ newt target set arduino_blinky features=arduino_zero_pro
Target targets/arduino_blinky successfully set pkg.features to arduino_zero_pro
-$
+$
```
<br>
-You can now build the target, with ```newt build```:
+You can now build the target, with ```newt build```:
```no-highlight
-$ newt build arduino_blinky
+$ newt build arduino_blinky
Compiling main.c
Archiving blinky.a
Compiling cons_fmt.c
@@ -201,9 +201,9 @@ App successfully built: myproject/bin/arduino_blinky/apps/blinky/blinky.elf
### Connect the Target
-Connect your computer to the Arduino Zero (from now on we'll call this the
-target) with the Micro-USB cable through the Programming Port as shown below.
-Mynewt will download and debug the target through this port. You should see a
+Connect your computer to the Arduino Zero (from now on we'll call this the
+target) with the Micro-USB cable through the Programming Port as shown below.
+Mynewt will download and debug the target through this port. You should see a
little green LED come on. That means the board has power.
No external debugger is required. The Arduino Zero comes with an internal
@@ -218,13 +218,13 @@ A image below shows the Arduino Zero Programming Port.
### Download the Bootloader
-Execute the command to download the bootloader.
+Execute the command to download the bootloader.
```c
$ newt load arduino_boot
```
-If the newt tool finishes without error, that means the bootloader has been
+If the newt tool finishes without error, that means the bootloader has been
successfully loaded onto the target.
<br>
@@ -233,18 +233,18 @@ successfully loaded onto the target.
<br>
-### Run the Image
+### Run the Image
-Now that the bootloader is downloaded to the target, the next step is to load
-your image onto the Arduino Zero. The easiest way to do this, is to use the
+Now that the bootloader is downloaded to the target, the next step is to load
+your image onto the Arduino Zero. The easiest way to do this, is to use the
```newt run``` command. ```newt run``` will automatically rebuild your program
(if necessary), create an image, and load it onto the target device.
-Here, we will load our ```arduino_blinky``` target onto the device, and we
+Here, we will load our ```arduino_blinky``` target onto the device, and we
should see it run:
```no-highlight
-$ newt run arduino_blinky 0.0.0
+$ newt run arduino_blinky 0.0.0
Debugging myproject/bin/arduino_blinky/apps/blinky/blinky.elf
Open On-Chip Debugger 0.9.0 (2015-09-23-21:46)
Licensed under GNU GPL v2
@@ -279,7 +279,7 @@ For help, type "help".
Type "apropos word" to search for commands related to "word"...
Reading symbols from myproject/bin/arduino_blinky/apps/blinky/blinky.elf...done.
target state: halted
-target halted due to debug-request, current mode: Thread
+target halted due to debug-request, current mode: Thread
xPSR: 0x21000000 pc: 0x0000030e msp: 0x20008000
Info : accepting 'gdb' connection on tcp/3333
Info : SAMD MCU: SAMD21G18A (256KB Flash, 32KB RAM)
@@ -292,18 +292,18 @@ Continuing.
<br>
-**NOTE:** The 0.0.0 specified after the target name to `newt run` is the version
-of the image to load. If you are not providing remote upgrade, and are just
+**NOTE:** The 0.0.0 specified after the target name to `newt run` is the version
+of the image to load. If you are not providing remote upgrade, and are just
developing locally, you can provide 0.0.0 for every image version.
-If you want the image to run without the debugger connected, simply quit the
+If you want the image to run without the debugger connected, simply quit the
debugger and restart the board. The image you programmed will come and run on the Arduino on next boot!
<br>
### Watch the LED blink
-Congratulations! You have created a Mynewt operating system running on the
+Congratulations! You have created a Mynewt operating system running on the
Arduino Zero. The LED right next to the power LED should be blinking. It is toggled by one task running on the Mynewt OS.
We have more fun tutorials for you to get your hands dirty. Be bold and try other Blinky-like [tutorials](../tutorials/nRF52.md) or try enabling additional functionality such as [remote comms](project-target-slinky.md) on the current board.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/bbbda539/docs/os/tutorials/ibeacon.md
----------------------------------------------------------------------
diff --git a/docs/os/tutorials/ibeacon.md b/docs/os/tutorials/ibeacon.md
index 1ff7a39..3b4fa4e 100644
--- a/docs/os/tutorials/ibeacon.md
+++ b/docs/os/tutorials/ibeacon.md
@@ -37,7 +37,7 @@ This function's parameters are documented below.
To demonstrate how the above function is used, we will now modify the *bleprph*
example application to send iBeacons. For some background behind the *bleprph*
app, we recommend you take a look at the [bleprph project
-tutorial](bleprph/bleprph_intro/). If you plan on making these modifications
+tutorial](bleprph/bleprph-intro/). If you plan on making these modifications
yourself, it might be a good idea to copy *bleprph* to your local repository
and work with the copy. In general, you should avoid changing a package that
newt downloads, as you will lose your changes the next time you upgrade the
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/bbbda539/docs/quick-start.md
----------------------------------------------------------------------
diff --git a/docs/quick-start.md b/docs/quick-start.md
index 002c487..3ad3afb 100644
--- a/docs/quick-start.md
+++ b/docs/quick-start.md
@@ -18,7 +18,7 @@ Start a new project as explained under [Create Your First Project](/DOCSLINK/os/
* When you [Create Your First Project](/DOCSLINK/os/get_started/project_create/) you define a simulated target and run Project Blinky, the Hello World equivalent in the embedded world.
-* If you have one of the supported [boards](../), you can make real LEDs blink in [Project Blinky](/DOCSLINK/os/tutorials/arduino_zero/). Simply choose the appropriate tutorial for the board and proceed.
+* If you have one of the supported [boards](/), you can make real LEDs blink in [Project Blinky](/DOCSLINK/os/tutorials/arduino_zero/). Simply choose the appropriate tutorial for the board and proceed.
<br>
[5/9] incubator-mynewt-site git commit: Updating Newt
Posted by ad...@apache.org.
Updating Newt
Added update instructions for newt for Mac and Linux
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/8800078d
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/8800078d
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/8800078d
Branch: refs/heads/develop
Commit: 8800078d6a525356f3d72f1b27668449344aea5c
Parents: 1c9901c
Author: David G. Simmons <sa...@mac.com>
Authored: Fri Oct 7 12:38:57 2016 -0400
Committer: David G. Simmons <sa...@mac.com>
Committed: Fri Oct 7 12:38:57 2016 -0400
----------------------------------------------------------------------
docs/newt/install/newt_linux.md | 23 +++++++++++++++++++++++
docs/newt/install/newt_mac.md | 25 +++++++++++++++++++++++++
2 files changed, 48 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8800078d/docs/newt/install/newt_linux.md
----------------------------------------------------------------------
diff --git a/docs/newt/install/newt_linux.md b/docs/newt/install/newt_linux.md
index dcc82a8..85ffad1 100644
--- a/docs/newt/install/newt_linux.md
+++ b/docs/newt/install/newt_linux.md
@@ -134,4 +134,27 @@ If you want to build the *newt* tool from its source code, follow the following
<br>
+#### 5. Updating the Newt tool
+
+* You will update the newt tool in the same place as you initially installed the newt tool.
+* Start by updating the git repository of the newt tool (you can change to a different branch using git checkout [branch] if you need to)
+* Then update each of the tools newt, newtmgr and newtvm as needed
+
+```no-highlight
+ $ cd $GOPATH/src/mynewt.apache.org/newt
+ $ git pull
+ $ cd newt
+ $ go install
+ $ cd ../newtmgr
+ $ go install
+ $ cd ../newtvm
+ $ go install
+ $ ls "$GOPATH"/bin/
+ newt newtmgr newtvm
+```
+
+That should have updated your newt, newtmgr and newtvm to the latest versions based on the git repository you used.
+
+<br>
+
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8800078d/docs/newt/install/newt_mac.md
----------------------------------------------------------------------
diff --git a/docs/newt/install/newt_mac.md b/docs/newt/install/newt_mac.md
index 7163f3f..89eb1c0 100644
--- a/docs/newt/install/newt_mac.md
+++ b/docs/newt/install/newt_mac.md
@@ -139,3 +139,28 @@ If you want to build the *newt* tool from its source code, follow the following
Use "newt help [command]" for more information about a command.
```
+<br>
+
+#### 5. Updating the Newt tool
+
+* You will update the newt tool in the same place as you initially installed the newt tool.
+* Start by updating the git repository of the newt tool (you can change to a different branch using git checkout [branch] if you need to)
+* Then update each of the tools newt, newtmgr and newtvm as needed
+
+```no-highlight
+ $ cd $GOPATH/src/mynewt.apache.org/newt
+ $ git pull
+ $ cd newt
+ $ go install
+ $ cd ../newtmgr
+ $ go install
+ $ cd ../newtvm
+ $ go install
+ $ ls "$GOPATH"/bin/
+ newt newtmgr newtvm
+```
+
+That should have updated your newt, newtmgr and newtvm to the latest versions based on the git repository you used.
+
+<br>
+
[4/9] incubator-mynewt-site git commit: Merge branch 'develop' of
github.com:gj262/incubator-mynewt-site into develop
Posted by ad...@apache.org.
Merge branch 'develop' of github.com:gj262/incubator-mynewt-site into develop
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/e812d372
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/e812d372
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/e812d372
Branch: refs/heads/develop
Commit: e812d372208ad7b432a40b6ed3b2723993c2d8bf
Parents: 9ffd55d c0101c4
Author: Gavin Jefferies <ga...@runtime.io>
Authored: Thu Oct 6 17:09:25 2016 -0700
Committer: Gavin Jefferies <ga...@runtime.io>
Committed: Thu Oct 6 17:09:25 2016 -0700
----------------------------------------------------------------------
README.md | 3 +++
1 file changed, 3 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/e812d372/README.md
----------------------------------------------------------------------
[3/9] incubator-mynewt-site git commit: fix link
Posted by ad...@apache.org.
fix link
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/9ffd55da
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/9ffd55da
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/9ffd55da
Branch: refs/heads/develop
Commit: 9ffd55da69f9ff695390297dcde78a9ce41dd9b9
Parents: 536e0da
Author: Gavin Jefferies <ga...@runtime.io>
Authored: Thu Oct 6 16:13:44 2016 -0700
Committer: Gavin Jefferies <ga...@runtime.io>
Committed: Thu Oct 6 17:08:59 2016 -0700
----------------------------------------------------------------------
README.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/9ffd55da/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 214108f..5295db4 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ The Apache MyNewt site is built using [MkDocs](http://www.mkdocs.org/).
1. Work on the `develop` branch.
1. Preview your changes using MkDocs.
* `mkdocs serve`
- * visit http://localhost:8000
+ * visit [http://localhost:8000](http://localhost:8000)
1. Submit a pull request.
## Releasing a versioned set of MyNewt documentation
@@ -33,7 +33,7 @@ When a new release of MyNewt OS and its associated tools occurs, the documentati
### Test
1. Run: `./serve.py`
-1. Visit http://localhost:8000
+1. Visit [http://localhost:8000](http://localhost:8000)
### Deploy
1. Run: `./deploy.sh`
[8/9] incubator-mynewt-site git commit: Merge branch 'fixBrokenLinks'
of https://github.com/gj262/incubator-mynewt-site into develop
Posted by ad...@apache.org.
Merge branch 'fixBrokenLinks' of https://github.com/gj262/incubator-mynewt-site into develop
This closes #116.
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/f48d3b19
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/f48d3b19
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/f48d3b19
Branch: refs/heads/develop
Commit: f48d3b19a1ab744e8148ecbe7c1a25851aa8f5da
Parents: 5001761 5c00cff
Author: aditihilbert <ad...@runtime.io>
Authored: Fri Oct 7 16:41:38 2016 -0700
Committer: aditihilbert <ad...@runtime.io>
Committed: Fri Oct 7 16:41:38 2016 -0700
----------------------------------------------------------------------
README.md | 11 ++-
build.py | 21 ++++-
custom-theme/base.html | 3 +-
docs/about.md | 2 +-
docs/network/ble/ini_stack/ble_parent_ini.md | 2 +-
docs/os/core_os/porting/port_bsp.md | 20 ++--
docs/os/core_os/porting/port_os.md | 41 ++++----
docs/os/core_os/time/os_time_tick.md | 8 +-
docs/os/introduction.md | 32 +++----
.../os/modules/hal/hal_cputime/hal_cpu_timer.md | 14 ++-
docs/os/modules/hal/hal_gpio/hal_gpio.md | 19 ++--
docs/os/tutorials/arduino_zero.md | 98 ++++++++++----------
docs/os/tutorials/blinky_sram_olimex.md | 41 ++++----
docs/os/tutorials/ibeacon.md | 2 +-
docs/os/tutorials/olimex.md | 56 +++++------
docs/os/tutorials/project-target-slinky.md | 38 +++-----
docs/os/tutorials/tutorials.md | 21 ++---
docs/os/tutorials/wi-fi_on_arduino.md | 70 +++++++-------
docs/quick-start.md | 2 +-
19 files changed, 253 insertions(+), 248 deletions(-)
----------------------------------------------------------------------