mynewt-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ccoll...@apache.org
Subject [2/3] incubator-mynewt-blinky git commit: Add build instructions to README.
Date Thu, 17 Mar 2016 05:31:10 GMT
Add build instructions to README.


Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-blinky/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-blinky/commit/bc7adabf
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-blinky/tree/bc7adabf
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-blinky/diff/bc7adabf

Branch: refs/heads/master
Commit: bc7adabf5ecbee59d9ba613525a5a154f4456d8d
Parents: 5cb2248
Author: Christopher Collins <ccollins@apache.org>
Authored: Wed Mar 16 19:56:14 2016 -0700
Committer: Christopher Collins <ccollins@apache.org>
Committed: Wed Mar 16 19:56:14 2016 -0700

----------------------------------------------------------------------
 README.md | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-blinky/blob/bc7adabf/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 9c6dd01..e94c1ac 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,28 @@
 #
 -->
 
-# README 
+# Apache Blinky
 
-Welcome!  This is your new Apache Mynewt project.  For more information
-on Apache Mynewt, please visit https://mynewt.apache.org/.
+## Overview
+
+Apache Blinky is a skeleton for new Apache Mynewt projects.  This directory
+struture is downloaded when the user issues a "newt new" command.  Apache
+blinky also contains an example Apache Mynewt app and target to help you get
+started.
+
+## Building
+
+Apache Blinky contains an example Apache Mynewt application called blinky.  This application
blinks an LED on the host board.  The below procedure describes how to build this application
for the Apache Mynewt simulator.
+
+1. Download Apache Newt.
+
+You will need to download the Apache Newt tool, as documented in the [Getting Started Guide](http://mynewt.apache.org/os/get_started/introduction/).
+
+2. Build the blinky app for the sim platform using the "my_blinky_sim" target
+(executed from the blinky directory).
+
+```no-highlight
+    $ newt build my_blinky_sim
+```
+
+The Apache Newt tool should indicate the location of the generated blinky executable.  Since
the simulator does not have an LED to blink, this version of blinky is not terribly exciting
(no observable behavior!).  To learn how to build blinky for actual harder, please see the
[Getting Started Guide](http://mynewt.apache.org/os/get_started/introduction/).


Mime
View raw message