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 2015/11/07 02:09:54 UTC
[4/4] incubator-mynewt-site git commit: add subcription details,
change blinky instructions for flash download
add subcription details, change blinky instructions for flash download
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/60d6afb2
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/60d6afb2
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/60d6afb2
Branch: refs/heads/asf-site
Commit: 60d6afb2eb68769f76bf175a8216850944c8bc9e
Parents: 3cc2217
Author: aditihilbert <ad...@runtime.io>
Authored: Fri Nov 6 17:08:47 2015 -0800
Committer: aditihilbert <ad...@runtime.io>
Committed: Fri Nov 6 17:08:47 2015 -0800
----------------------------------------------------------------------
css/font-awesome-4.0.3.css | 1338 ------------------
css/screen.css | 165 ---
docs/chapter1/newt_concepts.md | 23 +-
docs/chapter1/project1.md | 164 +--
docs/chapter3/newt_tool_reference.md | 8 +-
docs/index.md | 8 +-
images/content-bg.png | Bin 0 -> 155 bytes
images/egg-logo.png | Bin 0 -> 8626 bytes
index.html | 163 ++-
mkdocs.yml | 1 +
site/chapter1/newt_concepts/index.html | 22 +-
site/chapter1/project1/index.html | 160 +--
site/chapter3/newt_tool_reference/index.html | 20 +
site/index.html | 10 +-
site/mkdocs/search_index.json | 16 +-
site/sitemap.xml | 16 +-
style.css | 84 ++
test/egg-logo.png | Bin 0 -> 8626 bytes
test/index.html | 77 +
test/mjt-125x125.gif | Bin 0 -> 7046 bytes
test/perfect-2-column-left-menu-dimensions.gif | Bin 0 -> 3158 bytes
...perfect-2-column-left-menu-div-structure.gif | Bin 0 -> 2955 bytes
test/screen.css | 149 ++
23 files changed, 610 insertions(+), 1814 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/css/font-awesome-4.0.3.css
----------------------------------------------------------------------
diff --git a/css/font-awesome-4.0.3.css b/css/font-awesome-4.0.3.css
deleted file mode 100644
index 048cff9..0000000
--- a/css/font-awesome-4.0.3.css
+++ /dev/null
@@ -1,1338 +0,0 @@
-/*!
- * Font Awesome 4.0.3 by @davegandy - http://fontawesome.io - @fontawesome
- * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
- */
-/* FONT PATH
- * -------------------------- */
-@font-face {
- font-family: 'FontAwesome';
- src: url('../fonts/fontawesome-webfont.eot?v=4.0.3');
- src: url('../fonts/fontawesome-webfont.eot?#iefix&v=4.0.3') format('embedded-opentype'), url('../fonts/fontawesome-webfont.woff?v=4.0.3') format('woff'), url('../fonts/fontawesome-webfont.ttf?v=4.0.3') format('truetype'), url('../fonts/fontawesome-webfont.svg?v=4.0.3#fontawesomeregular') format('svg');
- font-weight: normal;
- font-style: normal;
-}
-.fa {
- display: inline-block;
- font-family: FontAwesome;
- font-style: normal;
- font-weight: normal;
- line-height: 1;
- -webkit-font-smoothing: antialiased;
- -moz-osx-font-smoothing: grayscale;
-}
-/* makes the font 33% larger relative to the icon container */
-.fa-lg {
- font-size: 1.3333333333333333em;
- line-height: 0.75em;
- vertical-align: -15%;
-}
-.fa-2x {
- font-size: 2em;
-}
-.fa-3x {
- font-size: 3em;
-}
-.fa-4x {
- font-size: 4em;
-}
-.fa-5x {
- font-size: 5em;
-}
-.fa-fw {
- width: 1.2857142857142858em;
- text-align: center;
-}
-.fa-ul {
- padding-left: 0;
- margin-left: 2.142857142857143em;
- list-style-type: none;
-}
-.fa-ul > li {
- position: relative;
-}
-.fa-li {
- position: absolute;
- left: -2.142857142857143em;
- width: 2.142857142857143em;
- top: 0.14285714285714285em;
- text-align: center;
-}
-.fa-li.fa-lg {
- left: -1.8571428571428572em;
-}
-.fa-border {
- padding: .2em .25em .15em;
- border: solid 0.08em #eeeeee;
- border-radius: .1em;
-}
-.pull-right {
- float: right;
-}
-.pull-left {
- float: left;
-}
-.fa.pull-left {
- margin-right: .3em;
-}
-.fa.pull-right {
- margin-left: .3em;
-}
-.fa-spin {
- -webkit-animation: spin 2s infinite linear;
- -moz-animation: spin 2s infinite linear;
- -o-animation: spin 2s infinite linear;
- animation: spin 2s infinite linear;
-}
-@-moz-keyframes spin {
- 0% {
- -moz-transform: rotate(0deg);
- }
- 100% {
- -moz-transform: rotate(359deg);
- }
-}
-@-webkit-keyframes spin {
- 0% {
- -webkit-transform: rotate(0deg);
- }
- 100% {
- -webkit-transform: rotate(359deg);
- }
-}
-@-o-keyframes spin {
- 0% {
- -o-transform: rotate(0deg);
- }
- 100% {
- -o-transform: rotate(359deg);
- }
-}
-@-ms-keyframes spin {
- 0% {
- -ms-transform: rotate(0deg);
- }
- 100% {
- -ms-transform: rotate(359deg);
- }
-}
-@keyframes spin {
- 0% {
- transform: rotate(0deg);
- }
- 100% {
- transform: rotate(359deg);
- }
-}
-.fa-rotate-90 {
- filter: progid:DXImageTransform.Microsoft.BasicImage(rotation=1);
- -webkit-transform: rotate(90deg);
- -moz-transform: rotate(90deg);
- -ms-transform: rotate(90deg);
- -o-transform: rotate(90deg);
- transform: rotate(90deg);
-}
-.fa-rotate-180 {
- filter: progid:DXImageTransform.Microsoft.BasicImage(rotation=2);
- -webkit-transform: rotate(180deg);
- -moz-transform: rotate(180deg);
- -ms-transform: rotate(180deg);
- -o-transform: rotate(180deg);
- transform: rotate(180deg);
-}
-.fa-rotate-270 {
- filter: progid:DXImageTransform.Microsoft.BasicImage(rotation=3);
- -webkit-transform: rotate(270deg);
- -moz-transform: rotate(270deg);
- -ms-transform: rotate(270deg);
- -o-transform: rotate(270deg);
- transform: rotate(270deg);
-}
-.fa-flip-horizontal {
- filter: progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1);
- -webkit-transform: scale(-1, 1);
- -moz-transform: scale(-1, 1);
- -ms-transform: scale(-1, 1);
- -o-transform: scale(-1, 1);
- transform: scale(-1, 1);
-}
-.fa-flip-vertical {
- filter: progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1);
- -webkit-transform: scale(1, -1);
- -moz-transform: scale(1, -1);
- -ms-transform: scale(1, -1);
- -o-transform: scale(1, -1);
- transform: scale(1, -1);
-}
-.fa-stack {
- position: relative;
- display: inline-block;
- width: 2em;
- height: 2em;
- line-height: 2em;
- vertical-align: middle;
-}
-.fa-stack-1x,
-.fa-stack-2x {
- position: absolute;
- left: 0;
- width: 100%;
- text-align: center;
-}
-.fa-stack-1x {
- line-height: inherit;
-}
-.fa-stack-2x {
- font-size: 2em;
-}
-.fa-inverse {
- color: #ffffff;
-}
-/* Font Awesome uses the Unicode Private Use Area (PUA) to ensure screen
- readers do not read off random characters that represent icons */
-.fa-glass:before {
- content: "\f000";
-}
-.fa-music:before {
- content: "\f001";
-}
-.fa-search:before {
- content: "\f002";
-}
-.fa-envelope-o:before {
- content: "\f003";
-}
-.fa-heart:before {
- content: "\f004";
-}
-.fa-star:before {
- content: "\f005";
-}
-.fa-star-o:before {
- content: "\f006";
-}
-.fa-user:before {
- content: "\f007";
-}
-.fa-film:before {
- content: "\f008";
-}
-.fa-th-large:before {
- content: "\f009";
-}
-.fa-th:before {
- content: "\f00a";
-}
-.fa-th-list:before {
- content: "\f00b";
-}
-.fa-check:before {
- content: "\f00c";
-}
-.fa-times:before {
- content: "\f00d";
-}
-.fa-search-plus:before {
- content: "\f00e";
-}
-.fa-search-minus:before {
- content: "\f010";
-}
-.fa-power-off:before {
- content: "\f011";
-}
-.fa-signal:before {
- content: "\f012";
-}
-.fa-gear:before,
-.fa-cog:before {
- content: "\f013";
-}
-.fa-trash-o:before {
- content: "\f014";
-}
-.fa-home:before {
- content: "\f015";
-}
-.fa-file-o:before {
- content: "\f016";
-}
-.fa-clock-o:before {
- content: "\f017";
-}
-.fa-road:before {
- content: "\f018";
-}
-.fa-download:before {
- content: "\f019";
-}
-.fa-arrow-circle-o-down:before {
- content: "\f01a";
-}
-.fa-arrow-circle-o-up:before {
- content: "\f01b";
-}
-.fa-inbox:before {
- content: "\f01c";
-}
-.fa-play-circle-o:before {
- content: "\f01d";
-}
-.fa-rotate-right:before,
-.fa-repeat:before {
- content: "\f01e";
-}
-.fa-refresh:before {
- content: "\f021";
-}
-.fa-list-alt:before {
- content: "\f022";
-}
-.fa-lock:before {
- content: "\f023";
-}
-.fa-flag:before {
- content: "\f024";
-}
-.fa-headphones:before {
- content: "\f025";
-}
-.fa-volume-off:before {
- content: "\f026";
-}
-.fa-volume-down:before {
- content: "\f027";
-}
-.fa-volume-up:before {
- content: "\f028";
-}
-.fa-qrcode:before {
- content: "\f029";
-}
-.fa-barcode:before {
- content: "\f02a";
-}
-.fa-tag:before {
- content: "\f02b";
-}
-.fa-tags:before {
- content: "\f02c";
-}
-.fa-book:before {
- content: "\f02d";
-}
-.fa-bookmark:before {
- content: "\f02e";
-}
-.fa-print:before {
- content: "\f02f";
-}
-.fa-camera:before {
- content: "\f030";
-}
-.fa-font:before {
- content: "\f031";
-}
-.fa-bold:before {
- content: "\f032";
-}
-.fa-italic:before {
- content: "\f033";
-}
-.fa-text-height:before {
- content: "\f034";
-}
-.fa-text-width:before {
- content: "\f035";
-}
-.fa-align-left:before {
- content: "\f036";
-}
-.fa-align-center:before {
- content: "\f037";
-}
-.fa-align-right:before {
- content: "\f038";
-}
-.fa-align-justify:before {
- content: "\f039";
-}
-.fa-list:before {
- content: "\f03a";
-}
-.fa-dedent:before,
-.fa-outdent:before {
- content: "\f03b";
-}
-.fa-indent:before {
- content: "\f03c";
-}
-.fa-video-camera:before {
- content: "\f03d";
-}
-.fa-picture-o:before {
- content: "\f03e";
-}
-.fa-pencil:before {
- content: "\f040";
-}
-.fa-map-marker:before {
- content: "\f041";
-}
-.fa-adjust:before {
- content: "\f042";
-}
-.fa-tint:before {
- content: "\f043";
-}
-.fa-edit:before,
-.fa-pencil-square-o:before {
- content: "\f044";
-}
-.fa-share-square-o:before {
- content: "\f045";
-}
-.fa-check-square-o:before {
- content: "\f046";
-}
-.fa-arrows:before {
- content: "\f047";
-}
-.fa-step-backward:before {
- content: "\f048";
-}
-.fa-fast-backward:before {
- content: "\f049";
-}
-.fa-backward:before {
- content: "\f04a";
-}
-.fa-play:before {
- content: "\f04b";
-}
-.fa-pause:before {
- content: "\f04c";
-}
-.fa-stop:before {
- content: "\f04d";
-}
-.fa-forward:before {
- content: "\f04e";
-}
-.fa-fast-forward:before {
- content: "\f050";
-}
-.fa-step-forward:before {
- content: "\f051";
-}
-.fa-eject:before {
- content: "\f052";
-}
-.fa-chevron-left:before {
- content: "\f053";
-}
-.fa-chevron-right:before {
- content: "\f054";
-}
-.fa-plus-circle:before {
- content: "\f055";
-}
-.fa-minus-circle:before {
- content: "\f056";
-}
-.fa-times-circle:before {
- content: "\f057";
-}
-.fa-check-circle:before {
- content: "\f058";
-}
-.fa-question-circle:before {
- content: "\f059";
-}
-.fa-info-circle:before {
- content: "\f05a";
-}
-.fa-crosshairs:before {
- content: "\f05b";
-}
-.fa-times-circle-o:before {
- content: "\f05c";
-}
-.fa-check-circle-o:before {
- content: "\f05d";
-}
-.fa-ban:before {
- content: "\f05e";
-}
-.fa-arrow-left:before {
- content: "\f060";
-}
-.fa-arrow-right:before {
- content: "\f061";
-}
-.fa-arrow-up:before {
- content: "\f062";
-}
-.fa-arrow-down:before {
- content: "\f063";
-}
-.fa-mail-forward:before,
-.fa-share:before {
- content: "\f064";
-}
-.fa-expand:before {
- content: "\f065";
-}
-.fa-compress:before {
- content: "\f066";
-}
-.fa-plus:before {
- content: "\f067";
-}
-.fa-minus:before {
- content: "\f068";
-}
-.fa-asterisk:before {
- content: "\f069";
-}
-.fa-exclamation-circle:before {
- content: "\f06a";
-}
-.fa-gift:before {
- content: "\f06b";
-}
-.fa-leaf:before {
- content: "\f06c";
-}
-.fa-fire:before {
- content: "\f06d";
-}
-.fa-eye:before {
- content: "\f06e";
-}
-.fa-eye-slash:before {
- content: "\f070";
-}
-.fa-warning:before,
-.fa-exclamation-triangle:before {
- content: "\f071";
-}
-.fa-plane:before {
- content: "\f072";
-}
-.fa-calendar:before {
- content: "\f073";
-}
-.fa-random:before {
- content: "\f074";
-}
-.fa-comment:before {
- content: "\f075";
-}
-.fa-magnet:before {
- content: "\f076";
-}
-.fa-chevron-up:before {
- content: "\f077";
-}
-.fa-chevron-down:before {
- content: "\f078";
-}
-.fa-retweet:before {
- content: "\f079";
-}
-.fa-shopping-cart:before {
- content: "\f07a";
-}
-.fa-folder:before {
- content: "\f07b";
-}
-.fa-folder-open:before {
- content: "\f07c";
-}
-.fa-arrows-v:before {
- content: "\f07d";
-}
-.fa-arrows-h:before {
- content: "\f07e";
-}
-.fa-bar-chart-o:before {
- content: "\f080";
-}
-.fa-twitter-square:before {
- content: "\f081";
-}
-.fa-facebook-square:before {
- content: "\f082";
-}
-.fa-camera-retro:before {
- content: "\f083";
-}
-.fa-key:before {
- content: "\f084";
-}
-.fa-gears:before,
-.fa-cogs:before {
- content: "\f085";
-}
-.fa-comments:before {
- content: "\f086";
-}
-.fa-thumbs-o-up:before {
- content: "\f087";
-}
-.fa-thumbs-o-down:before {
- content: "\f088";
-}
-.fa-star-half:before {
- content: "\f089";
-}
-.fa-heart-o:before {
- content: "\f08a";
-}
-.fa-sign-out:before {
- content: "\f08b";
-}
-.fa-linkedin-square:before {
- content: "\f08c";
-}
-.fa-thumb-tack:before {
- content: "\f08d";
-}
-.fa-external-link:before {
- content: "\f08e";
-}
-.fa-sign-in:before {
- content: "\f090";
-}
-.fa-trophy:before {
- content: "\f091";
-}
-.fa-github-square:before {
- content: "\f092";
-}
-.fa-upload:before {
- content: "\f093";
-}
-.fa-lemon-o:before {
- content: "\f094";
-}
-.fa-phone:before {
- content: "\f095";
-}
-.fa-square-o:before {
- content: "\f096";
-}
-.fa-bookmark-o:before {
- content: "\f097";
-}
-.fa-phone-square:before {
- content: "\f098";
-}
-.fa-twitter:before {
- content: "\f099";
-}
-.fa-facebook:before {
- content: "\f09a";
-}
-.fa-github:before {
- content: "\f09b";
-}
-.fa-unlock:before {
- content: "\f09c";
-}
-.fa-credit-card:before {
- content: "\f09d";
-}
-.fa-rss:before {
- content: "\f09e";
-}
-.fa-hdd-o:before {
- content: "\f0a0";
-}
-.fa-bullhorn:before {
- content: "\f0a1";
-}
-.fa-bell:before {
- content: "\f0f3";
-}
-.fa-certificate:before {
- content: "\f0a3";
-}
-.fa-hand-o-right:before {
- content: "\f0a4";
-}
-.fa-hand-o-left:before {
- content: "\f0a5";
-}
-.fa-hand-o-up:before {
- content: "\f0a6";
-}
-.fa-hand-o-down:before {
- content: "\f0a7";
-}
-.fa-arrow-circle-left:before {
- content: "\f0a8";
-}
-.fa-arrow-circle-right:before {
- content: "\f0a9";
-}
-.fa-arrow-circle-up:before {
- content: "\f0aa";
-}
-.fa-arrow-circle-down:before {
- content: "\f0ab";
-}
-.fa-globe:before {
- content: "\f0ac";
-}
-.fa-wrench:before {
- content: "\f0ad";
-}
-.fa-tasks:before {
- content: "\f0ae";
-}
-.fa-filter:before {
- content: "\f0b0";
-}
-.fa-briefcase:before {
- content: "\f0b1";
-}
-.fa-arrows-alt:before {
- content: "\f0b2";
-}
-.fa-group:before,
-.fa-users:before {
- content: "\f0c0";
-}
-.fa-chain:before,
-.fa-link:before {
- content: "\f0c1";
-}
-.fa-cloud:before {
- content: "\f0c2";
-}
-.fa-flask:before {
- content: "\f0c3";
-}
-.fa-cut:before,
-.fa-scissors:before {
- content: "\f0c4";
-}
-.fa-copy:before,
-.fa-files-o:before {
- content: "\f0c5";
-}
-.fa-paperclip:before {
- content: "\f0c6";
-}
-.fa-save:before,
-.fa-floppy-o:before {
- content: "\f0c7";
-}
-.fa-square:before {
- content: "\f0c8";
-}
-.fa-bars:before {
- content: "\f0c9";
-}
-.fa-list-ul:before {
- content: "\f0ca";
-}
-.fa-list-ol:before {
- content: "\f0cb";
-}
-.fa-strikethrough:before {
- content: "\f0cc";
-}
-.fa-underline:before {
- content: "\f0cd";
-}
-.fa-table:before {
- content: "\f0ce";
-}
-.fa-magic:before {
- content: "\f0d0";
-}
-.fa-truck:before {
- content: "\f0d1";
-}
-.fa-pinterest:before {
- content: "\f0d2";
-}
-.fa-pinterest-square:before {
- content: "\f0d3";
-}
-.fa-google-plus-square:before {
- content: "\f0d4";
-}
-.fa-google-plus:before {
- content: "\f0d5";
-}
-.fa-money:before {
- content: "\f0d6";
-}
-.fa-caret-down:before {
- content: "\f0d7";
-}
-.fa-caret-up:before {
- content: "\f0d8";
-}
-.fa-caret-left:before {
- content: "\f0d9";
-}
-.fa-caret-right:before {
- content: "\f0da";
-}
-.fa-columns:before {
- content: "\f0db";
-}
-.fa-unsorted:before,
-.fa-sort:before {
- content: "\f0dc";
-}
-.fa-sort-down:before,
-.fa-sort-asc:before {
- content: "\f0dd";
-}
-.fa-sort-up:before,
-.fa-sort-desc:before {
- content: "\f0de";
-}
-.fa-envelope:before {
- content: "\f0e0";
-}
-.fa-linkedin:before {
- content: "\f0e1";
-}
-.fa-rotate-left:before,
-.fa-undo:before {
- content: "\f0e2";
-}
-.fa-legal:before,
-.fa-gavel:before {
- content: "\f0e3";
-}
-.fa-dashboard:before,
-.fa-tachometer:before {
- content: "\f0e4";
-}
-.fa-comment-o:before {
- content: "\f0e5";
-}
-.fa-comments-o:before {
- content: "\f0e6";
-}
-.fa-flash:before,
-.fa-bolt:before {
- content: "\f0e7";
-}
-.fa-sitemap:before {
- content: "\f0e8";
-}
-.fa-umbrella:before {
- content: "\f0e9";
-}
-.fa-paste:before,
-.fa-clipboard:before {
- content: "\f0ea";
-}
-.fa-lightbulb-o:before {
- content: "\f0eb";
-}
-.fa-exchange:before {
- content: "\f0ec";
-}
-.fa-cloud-download:before {
- content: "\f0ed";
-}
-.fa-cloud-upload:before {
- content: "\f0ee";
-}
-.fa-user-md:before {
- content: "\f0f0";
-}
-.fa-stethoscope:before {
- content: "\f0f1";
-}
-.fa-suitcase:before {
- content: "\f0f2";
-}
-.fa-bell-o:before {
- content: "\f0a2";
-}
-.fa-coffee:before {
- content: "\f0f4";
-}
-.fa-cutlery:before {
- content: "\f0f5";
-}
-.fa-file-text-o:before {
- content: "\f0f6";
-}
-.fa-building-o:before {
- content: "\f0f7";
-}
-.fa-hospital-o:before {
- content: "\f0f8";
-}
-.fa-ambulance:before {
- content: "\f0f9";
-}
-.fa-medkit:before {
- content: "\f0fa";
-}
-.fa-fighter-jet:before {
- content: "\f0fb";
-}
-.fa-beer:before {
- content: "\f0fc";
-}
-.fa-h-square:before {
- content: "\f0fd";
-}
-.fa-plus-square:before {
- content: "\f0fe";
-}
-.fa-angle-double-left:before {
- content: "\f100";
-}
-.fa-angle-double-right:before {
- content: "\f101";
-}
-.fa-angle-double-up:before {
- content: "\f102";
-}
-.fa-angle-double-down:before {
- content: "\f103";
-}
-.fa-angle-left:before {
- content: "\f104";
-}
-.fa-angle-right:before {
- content: "\f105";
-}
-.fa-angle-up:before {
- content: "\f106";
-}
-.fa-angle-down:before {
- content: "\f107";
-}
-.fa-desktop:before {
- content: "\f108";
-}
-.fa-laptop:before {
- content: "\f109";
-}
-.fa-tablet:before {
- content: "\f10a";
-}
-.fa-mobile-phone:before,
-.fa-mobile:before {
- content: "\f10b";
-}
-.fa-circle-o:before {
- content: "\f10c";
-}
-.fa-quote-left:before {
- content: "\f10d";
-}
-.fa-quote-right:before {
- content: "\f10e";
-}
-.fa-spinner:before {
- content: "\f110";
-}
-.fa-circle:before {
- content: "\f111";
-}
-.fa-mail-reply:before,
-.fa-reply:before {
- content: "\f112";
-}
-.fa-github-alt:before {
- content: "\f113";
-}
-.fa-folder-o:before {
- content: "\f114";
-}
-.fa-folder-open-o:before {
- content: "\f115";
-}
-.fa-smile-o:before {
- content: "\f118";
-}
-.fa-frown-o:before {
- content: "\f119";
-}
-.fa-meh-o:before {
- content: "\f11a";
-}
-.fa-gamepad:before {
- content: "\f11b";
-}
-.fa-keyboard-o:before {
- content: "\f11c";
-}
-.fa-flag-o:before {
- content: "\f11d";
-}
-.fa-flag-checkered:before {
- content: "\f11e";
-}
-.fa-terminal:before {
- content: "\f120";
-}
-.fa-code:before {
- content: "\f121";
-}
-.fa-reply-all:before {
- content: "\f122";
-}
-.fa-mail-reply-all:before {
- content: "\f122";
-}
-.fa-star-half-empty:before,
-.fa-star-half-full:before,
-.fa-star-half-o:before {
- content: "\f123";
-}
-.fa-location-arrow:before {
- content: "\f124";
-}
-.fa-crop:before {
- content: "\f125";
-}
-.fa-code-fork:before {
- content: "\f126";
-}
-.fa-unlink:before,
-.fa-chain-broken:before {
- content: "\f127";
-}
-.fa-question:before {
- content: "\f128";
-}
-.fa-info:before {
- content: "\f129";
-}
-.fa-exclamation:before {
- content: "\f12a";
-}
-.fa-superscript:before {
- content: "\f12b";
-}
-.fa-subscript:before {
- content: "\f12c";
-}
-.fa-eraser:before {
- content: "\f12d";
-}
-.fa-puzzle-piece:before {
- content: "\f12e";
-}
-.fa-microphone:before {
- content: "\f130";
-}
-.fa-microphone-slash:before {
- content: "\f131";
-}
-.fa-shield:before {
- content: "\f132";
-}
-.fa-calendar-o:before {
- content: "\f133";
-}
-.fa-fire-extinguisher:before {
- content: "\f134";
-}
-.fa-rocket:before {
- content: "\f135";
-}
-.fa-maxcdn:before {
- content: "\f136";
-}
-.fa-chevron-circle-left:before {
- content: "\f137";
-}
-.fa-chevron-circle-right:before {
- content: "\f138";
-}
-.fa-chevron-circle-up:before {
- content: "\f139";
-}
-.fa-chevron-circle-down:before {
- content: "\f13a";
-}
-.fa-html5:before {
- content: "\f13b";
-}
-.fa-css3:before {
- content: "\f13c";
-}
-.fa-anchor:before {
- content: "\f13d";
-}
-.fa-unlock-alt:before {
- content: "\f13e";
-}
-.fa-bullseye:before {
- content: "\f140";
-}
-.fa-ellipsis-h:before {
- content: "\f141";
-}
-.fa-ellipsis-v:before {
- content: "\f142";
-}
-.fa-rss-square:before {
- content: "\f143";
-}
-.fa-play-circle:before {
- content: "\f144";
-}
-.fa-ticket:before {
- content: "\f145";
-}
-.fa-minus-square:before {
- content: "\f146";
-}
-.fa-minus-square-o:before {
- content: "\f147";
-}
-.fa-level-up:before {
- content: "\f148";
-}
-.fa-level-down:before {
- content: "\f149";
-}
-.fa-check-square:before {
- content: "\f14a";
-}
-.fa-pencil-square:before {
- content: "\f14b";
-}
-.fa-external-link-square:before {
- content: "\f14c";
-}
-.fa-share-square:before {
- content: "\f14d";
-}
-.fa-compass:before {
- content: "\f14e";
-}
-.fa-toggle-down:before,
-.fa-caret-square-o-down:before {
- content: "\f150";
-}
-.fa-toggle-up:before,
-.fa-caret-square-o-up:before {
- content: "\f151";
-}
-.fa-toggle-right:before,
-.fa-caret-square-o-right:before {
- content: "\f152";
-}
-.fa-euro:before,
-.fa-eur:before {
- content: "\f153";
-}
-.fa-gbp:before {
- content: "\f154";
-}
-.fa-dollar:before,
-.fa-usd:before {
- content: "\f155";
-}
-.fa-rupee:before,
-.fa-inr:before {
- content: "\f156";
-}
-.fa-cny:before,
-.fa-rmb:before,
-.fa-yen:before,
-.fa-jpy:before {
- content: "\f157";
-}
-.fa-ruble:before,
-.fa-rouble:before,
-.fa-rub:before {
- content: "\f158";
-}
-.fa-won:before,
-.fa-krw:before {
- content: "\f159";
-}
-.fa-bitcoin:before,
-.fa-btc:before {
- content: "\f15a";
-}
-.fa-file:before {
- content: "\f15b";
-}
-.fa-file-text:before {
- content: "\f15c";
-}
-.fa-sort-alpha-asc:before {
- content: "\f15d";
-}
-.fa-sort-alpha-desc:before {
- content: "\f15e";
-}
-.fa-sort-amount-asc:before {
- content: "\f160";
-}
-.fa-sort-amount-desc:before {
- content: "\f161";
-}
-.fa-sort-numeric-asc:before {
- content: "\f162";
-}
-.fa-sort-numeric-desc:before {
- content: "\f163";
-}
-.fa-thumbs-up:before {
- content: "\f164";
-}
-.fa-thumbs-down:before {
- content: "\f165";
-}
-.fa-youtube-square:before {
- content: "\f166";
-}
-.fa-youtube:before {
- content: "\f167";
-}
-.fa-xing:before {
- content: "\f168";
-}
-.fa-xing-square:before {
- content: "\f169";
-}
-.fa-youtube-play:before {
- content: "\f16a";
-}
-.fa-dropbox:before {
- content: "\f16b";
-}
-.fa-stack-overflow:before {
- content: "\f16c";
-}
-.fa-instagram:before {
- content: "\f16d";
-}
-.fa-flickr:before {
- content: "\f16e";
-}
-.fa-adn:before {
- content: "\f170";
-}
-.fa-bitbucket:before {
- content: "\f171";
-}
-.fa-bitbucket-square:before {
- content: "\f172";
-}
-.fa-tumblr:before {
- content: "\f173";
-}
-.fa-tumblr-square:before {
- content: "\f174";
-}
-.fa-long-arrow-down:before {
- content: "\f175";
-}
-.fa-long-arrow-up:before {
- content: "\f176";
-}
-.fa-long-arrow-left:before {
- content: "\f177";
-}
-.fa-long-arrow-right:before {
- content: "\f178";
-}
-.fa-apple:before {
- content: "\f179";
-}
-.fa-windows:before {
- content: "\f17a";
-}
-.fa-android:before {
- content: "\f17b";
-}
-.fa-linux:before {
- content: "\f17c";
-}
-.fa-dribbble:before {
- content: "\f17d";
-}
-.fa-skype:before {
- content: "\f17e";
-}
-.fa-foursquare:before {
- content: "\f180";
-}
-.fa-trello:before {
- content: "\f181";
-}
-.fa-female:before {
- content: "\f182";
-}
-.fa-male:before {
- content: "\f183";
-}
-.fa-gittip:before {
- content: "\f184";
-}
-.fa-sun-o:before {
- content: "\f185";
-}
-.fa-moon-o:before {
- content: "\f186";
-}
-.fa-archive:before {
- content: "\f187";
-}
-.fa-bug:before {
- content: "\f188";
-}
-.fa-vk:before {
- content: "\f189";
-}
-.fa-weibo:before {
- content: "\f18a";
-}
-.fa-renren:before {
- content: "\f18b";
-}
-.fa-pagelines:before {
- content: "\f18c";
-}
-.fa-stack-exchange:before {
- content: "\f18d";
-}
-.fa-arrow-circle-o-right:before {
- content: "\f18e";
-}
-.fa-arrow-circle-o-left:before {
- content: "\f190";
-}
-.fa-toggle-left:before,
-.fa-caret-square-o-left:before {
- content: "\f191";
-}
-.fa-dot-circle-o:before {
- content: "\f192";
-}
-.fa-wheelchair:before {
- content: "\f193";
-}
-.fa-vimeo-square:before {
- content: "\f194";
-}
-.fa-turkish-lira:before,
-.fa-try:before {
- content: "\f195";
-}
-.fa-plus-square-o:before {
- content: "\f196";
-}
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/css/screen.css
----------------------------------------------------------------------
diff --git a/css/screen.css b/css/screen.css
deleted file mode 100644
index c727448..0000000
--- a/css/screen.css
+++ /dev/null
@@ -1,165 +0,0 @@
-*|body {
- border: none;
- margin: 0;
- padding: 0;
- background: #ffffff none repeat scroll 0% 50%;
- width: 100%;
- min-width: 600px;
- font-size: 90%;
- font-family: FontAwesome;
-}
-*|a {
- color: #336699;
- font-family: FontAwesome;
-}
-*|a:hover {
- background: #336699 none repeat scroll 0% 50%;
- color: #ffffff;
- text-decoration: none;
- font-family: FontAwesome;
-}
-*|h1, *|h2, *|h3 {
- margin: 0.8em 0 0.2em;
- padding: 0;
- font-family: FontAwesome;
-}
-*|p {
- margin: 0.4em 0 0.8em;
- padding: 0;
- font-family: FontAwesome;
-}
-*|img {
- margin: 10px 0 5px;
- font-family: FontAwesome;
-}
-*|#ads *|img {
- display: block;
- padding-top: 10px;
-}
-*|#header {
- clear: both;
- float: left;
- width: 100%;
- font-family: FontAwesome;
-}
-*|#header {
- border-bottom: 1px solid #000000;
- font-family: FontAwesome;
-}
-*|#header *|p, *|#header *|h1, *|#header *|h2 {
- margin: 0;
- padding: 0.4em 15px 0;
- background-color: #268bd2;
- color: white;
-}
-*|#header *|ul {
- margin: 10px 0 0;
- padding: 0;
- float: left;
- list-style-type: none;
- list-style-position: outside;
- clear: left;
- width: 100%;
- list-style-image: none;
- font-family: fontawesome;
-}
-*|#header *|ul *|li {
- margin: 0;
- padding: 0;
- display: inline;
- list-style-type: none;
- list-style-image: none;
- list-style-position: outside;
- font-family: FontAwesome;
-}
-*|#header *|ul *|li *|a {
- margin: 0 0 0 1px;
- padding: 3px 10px;
- background: #eeeeee none repeat scroll 0% 50%;
- display: block;
- float: left;
- text-align: center;
- color: #000000;
- text-decoration: none;
- position: relative;
- left: 15px;
- line-height: 1.3em;
- font-family: FontAwesome;
-}
-*|#header *|ul *|li *|a:hover {
- background: #336699 none repeat scroll 0% 50%;
- color: #ffffff;
- font-family: fontawesome;
-}
-*|#header *|ul *|li *|a.active, *|#header *|ul *|li *|a.active:hover {
- background: #000000 none repeat scroll 0% 50%;
- color: #ffffff;
- font-weight: bold;
- font-family: fontawesome;
-}
-*|#header *|ul *|li *|a *|span {
- display: block;
- font-family: fontawesome;
-}
-*|#layoutdims {
- border-top: 4px solid #000000;
- margin: 0;
- padding: 6px 15px ! important;
- background: #eeeeee none repeat scroll 0% 50%;
- clear: both;
- text-align: right;
- font-family: fontawesome;
-}
-*|.colmask {
- overflow: hidden;
- position: relative;
- clear: both;
- float: left;
- width: 100%;
- font-family: fontawesome;
-}
-*|.colright, *|.colmid, *|.colleft {
- float: left;
- width: 100%;
- position: relative;
- font-family: fontawesome;
-}
-*|.col1, *|.col2, *|.col3 {
- padding: 0 0 1em;
- overflow: hidden;
- position: relative;
- float: left;
- font-family: fontawesome;
-}
-*|.leftmenu {
- background: #ffffff none repeat scroll 0% 50%;
- font-family: fontawesome;
-}
-*|.leftmenu *|.colleft {
- background: #268bd2 none repeat scroll 0% 50%;
- right: 75%;
- color: black;
- font-family: fontawesome;
-}
-*|.leftmenu *|.col1 {
- width: 71%;
- left: 102%;
- font-family: fontawesome;
-}
-*|.leftmenu *|.col2 {
- width: 21%;
- left: 6%;
- font-family: fontawesome;
-}
-*|#footer {
- border-top: 1px solid #000000;
- clear: both;
- float: left;
- width: 100%;
- font-family: FontAwesome;
-}
-*|#footer *|p {
- margin: 0;
- padding: 10px;
- font-family: fontawesome;
-}
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/docs/chapter1/newt_concepts.md
----------------------------------------------------------------------
diff --git a/docs/chapter1/newt_concepts.md b/docs/chapter1/newt_concepts.md
index cd29531..6ac28da 100644
--- a/docs/chapter1/newt_concepts.md
+++ b/docs/chapter1/newt_concepts.md
@@ -4,7 +4,7 @@ This page introduces the basic terms you will need to find your way around the M
### Basic components in the ecosystem
-* NewtOS is an open-source RTOS (Real Time Operating System) that is not tied to any particular hardware but can be tuned to the hardware component mix of the user's choosing. It has support for multitasking, synchronization of tasks, scheduling and buffering of operations, memory management,file systems, networking, security, power management, and other advanced features. Naturally, it involves several packages such as the Core RTOS, a flash file system, utility functions, a variety of board support packages, packages of microcontrollers etc.
+* NewtOS is an open-source RTOS (Real Time Operating System) that works on a variety of hardware. The goal is to develop a pre-emptive, multitasking OS that is highly modular, making it possible to mix and match components to enable desired features and capabilities on multiple hardware architectures. Examples of components being worked on are the Core RTOS, a flash file system, utility functions, a variety of board support packages, packages of microcontrollers etc.
* Network protocol stacks such as Bluetooth Low Energy, and more
@@ -15,23 +15,22 @@ This page introduces the basic terms you will need to find your way around the M
### Terminology
-In the mynewt lifecycle, a project grows in a nest. A nest may house multiple projects. The nest is, therefore, a repository where various component packages for one or more projects reside. Each package is an egg, naturally. However, an egg may consist of other eggs!
+A Mynewt user starts with a project in mind that defines the application or utility that he or she wants to implement on an embedded device. Making an LED blink on an electronics prototyping board is a common starter project. Enabling a BLE (Bluetooth Low Energy) peripheral mode on a development board is a more complex project. Specifying a project requires naming it, at the very least, and then adding the desired properties or attributes. In order to actualize a project, it needs to be applied to a target which is essentially a combination of some specified hardware and the execution environment.
-A nest can be given any name. You will see a nest named "tadpole" in mynewt. It contains all the core libraries of the operating system for distribution. Each of these directories contain one or more eggs where an egg is a basic unit of implementation of any aspect of the RTOS.
+In the mynewt lifecycle, a project grows in a nest. A nest may house multiple projects. The nest is, therefore, a repository where various component packages for one or more projects reside. Each package is an egg (naturally!). However, in the world of Mynewt an egg may consist of other eggs! For example, the starter project Blinky is an egg consisting of several constituent eggs that enable core features. The egg form is suitable for elemental units of code as it explicitly exposes characteristics such as dependencies, versions, capabilities, requirements etc., thus making assembling appropriate components for a project and building an image for it easy to follow, modular, and robust.
-* libs/os: The core RTOS which ports to all supported chip platforms.
-* hw/hal: The hardware abstraction layer (HAL) API definitions that all BSP and MCU implementations must support
-* hw/mcu/native: A MCU implementation for the native platform
-* hw/bsp/native: A BSP implementation for the native platform
-* compiler/native: The definition of compiler support for the native platform.
+A nest can be given any name. For example, you will see a nest named "tadpole" in Mynewt ([https://git-wip-us.apache.org/repos/asf?p=incubator-mynewt-tadpole.git](https://git-wip-us.apache.org/repos/asf?p=incubator-mynewt-tadpole.git)). It contains all the core libraries of the operating system for the native platform which currently supports compilation on Mac OS X. The core libraries are contained in the form of eggs where an egg is a basic unit of implementation of any aspect of the RTOS. The eggs are distributed in the following directory structure inside the nest:
-Each of the above directories contain one or more eggs where an egg is a basic unit of implementation of any aspect of the RTOS. For example, the libs/os directory holds eggs such as the bootloader, flash file system, the kernel for process/thread/memory management, tools for testing etc. The hw/hal directory holds an egg that provides abstraction for physical hardware components such as GPIO (general purpose input/output), network adapters, timers, and universal asynchronous receiver-transmitters (UARTs). All these physical interfaces are defined in various header files in hw/hal, and are designed to make device driver specification simpler.
+* libs: contains the two eggs `os` and `testutil`
+* hw: contains three eggs - (i) `hal` which has the abstraction layer (HAL) API definitions that all BSP and MCU implementations must support, (ii) `/mcu/native` which in an MCU implementation for the native platform (a simulator, in this case), and (iii) `bsp/native` which is a BSP implementation for the native platform
+* compiler: contains the `sim` egg which bundles the compiler specifications for the native platform.
-You can see another nest in the mynewt ecosystem called the "larva". It was spawned from the "tadpole" nest using the newt tool. Spawning is easy - ` $ newt create nest <your_nest_name> `. "larva" is the developer's test repository containing all sorts of eggs being incubated, including ones to enhance the core operating system which should eventually make their way into the "tadpole" nest. There is a `hatch_tadpole` script to update the "tadpole" nest when the core OS related eggs in "larva" are ready.
+Let's explore this sample nest a bit further. The `libs/os` egg contains code for scheduler, process/thread/memory management, semaphores etc. It is the core RTOS which ports to all supported chip platforms.The `libs/testutil` egg contains code for testing packages on hardware or simulated environment. The `hw/hal` egg contains header files that provide abstraction for physical hardware components such as GPIO (general purpose input/output), network adapters, timers, and UARTs. This `hw/hal` egg is an MCU peripheral abstraction designed to make it easy to port to different MCUs (microcontrollers). The `hw/mcu/native` egg contains code for microcontroller operations on the native platform. The `hw/bsp/native` egg contains the board support package for the native platform. And finally, the sixth egg `sim` contains the compiler specifications such as path and flags. Currently the compilation is supported on Mac OS X.
-There is a third nest named "newt" that contains all the eggs needed to support the build and release process of mynewt software.
+You can see another nest in the mynewt ecosystem called the "larva". It was spawned from the skeletal "tadpole" nest using the newt tool. Spawning is easy - ` $ newt create nest <your_nest_name> `. "larva" is the developer's test repository containing all sorts of eggs being written and incubated, including ones to enhance the core operating system which should eventually make their way into the "tadpole" nest. There is a `hatch_tadpole` script to update the "tadpole" nest when the core OS related eggs in "larva" are ready.
+
+There is a third nest named "newt" that contains all the eggs needed to support the build and release process of mynewt software. In the future, there will also be pre-built nests for certain common hardware devices to enable a user to quickly get started with a project.
-There will also be pre-built nests for certain common hardware devices to enable a user to quickly get started with a project.
### A Mynewt contributor
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/docs/chapter1/project1.md
----------------------------------------------------------------------
diff --git a/docs/chapter1/project1.md b/docs/chapter1/project1.md
index f14ddb0..100ce27 100644
--- a/docs/chapter1/project1.md
+++ b/docs/chapter1/project1.md
@@ -4,7 +4,7 @@
We will show you how you can use eggs from a nest on Mynewt to make an LED on a target board blink. We will call it ** Project Blinky**. The goals of this tutorial are threefold:
-1. First, you will learn how to set up your environment to be ready to use the various eggs that you will download from Mynewt.
+1. First, you will learn how to set up your environment to be ready to use Mynewt OS and newt tool.
2. Second, we will walk you through a download of eggs for building and testing [on a simulated target](#building-test-code-on-simulator) on a non-Windows machine.
3. Third, you will download eggs and use tools to create a runtime image for a board to [make its LED blink](#making-an-led-blink).
@@ -59,11 +59,11 @@ case, simply skip the corresponding installation step in the instructions under
Note that you need to add export statements to ~/.bash_profile to export variables permanently.
$ vi ~/.bash_profile
-* The next step is to set up the repository for the package building tool "newt" on your local machine. First create the appropriate directory for it and then clone the newt tool repository from github.com into this newly created directory. Check the installation.
+* The next step is to set up the repository for the package building tool "newt" on your local machine. First create the appropriate directory for it and then clone the newt tool repository from the online apache repository (or its github.com mirror) into this newly created directory. Check the installation.
$ mkdir -p $GOPATH/src/github.com/mynewt
$ cd $GOPATH/src/github.com/mynewt
- $ git clone https://github.com/mynewt/newt.git
+ $ git clone https://git-wip-us.apache.org/repos/asf/incubator-mynewt-newt.git newt
$ ls
newt
$ cd newt
@@ -228,11 +228,11 @@ Note: If you are going to be be modifying the newt tool itself often and wish to
$ go get github.com/tools/godep
-* Set up the repository for the package building tool "newt" on your local machine. First create the appropriate directory for it and then clone the newt tool repository from github.com into this newly created directory. Check the contents of the directory.
+* Set up the repository for the package building tool "newt" on your local machine. First create the appropriate directory for it and then clone the newt tool repository from the online apache repository (or its github.com mirror) into this newly created directory. Check the contents of the directory.
$ mkdir -p $GOPATH/src/github.com/mynewt
$ cd $GOPATH/src/github.com/mynewt
- $ git clone https://github.com/mynewt/newt.git
+ $ git clone https://git-wip-us.apache.org/repos/asf/incubator-mynewt-newt.git newt
$ ls
newt
$ cd newt
@@ -422,11 +422,11 @@ tutorial for a Windows machine assumes the specified folders.
$ go get github.com/tools/godep
-* Set up the repository for the package building tool "newt" on your local machine. First create the appropriate directory for it and then clone the newt tool repository from github.com into this newly created directory. Check the contents of the directory.
+* Set up the repository for the package building tool "newt" on your local machine. First create the appropriate directory for it and then clone the newt tool repository from the online apache repository (or its github.com mirror) into this newly created directory. Check the contents of the directory.
$ mkdir %GOPATH%\src\github.com\mynewt
$ cd %GOPATH%\src\github.com\mynewt
- $ git clone https://github.com/mynewt/newt.git
+ $ git clone https://git-wip-us.apache.org/repos/asf/incubator-mynewt-newt.git newt
$ ls
newt
$ cd newt
@@ -506,28 +506,30 @@ tutorial for a Windows machine assumes the specified folders.
#### Proceed to the [Building test code on simulator on Windows machine](#building-test-code-on-simulator) section.
-Note: Currently, the simulator cannot be run in the Windows machine. We are working on it. In the meantime proceed to the [Making an LED blink](#making-an-led-blink) on the Olimex hardware directly.
+Note: Currently, the simulator cannot be run in the Windows machine. We are still working on it. So you will go ahead and [make an LED blink](#making-an-led-blink) on the Olimex hardware directly.
+
+However, before you skip to the hardware target, you still need to build your first nest as outlined in step 1 in the [Building test code on simulator](#building-test-code-on-simulator).
+
### Building test code on simulator
-Note: Currently, the simulator cannot be run in the Windows machine. We are working on it. If you are on a Windows machine proceed to the [Making an LED blink](#making-an-led-blink) on the Olimex hardware directly.
+Note: Currently, the simulator cannot be run in the Windows machine. We are working on it. If you are on a Windows machine, do step 1 below and then proceed to the [Making an LED blink](#making-an-led-blink) on the Olimex hardware directly.
-1. First, you have to create a repository for the project i.e. build your first nest! Go to ~/dev and clone the larva repository from github. The URL used below is the HTTPS clone URL from the github.com repository for the Newt Operating System.
+1. First, you have to create a repository for the project i.e. build your first nest! Go to ~/dev and clone the larva repository from the apache git repository into a local directory named `larva`.
Substitute DOS commands for Unix commands as necessary in the following steps if your machine is running Windows. The newt tool commands do not change.
$ cd ~/dev
- $ git clone https://github.com/mynewt/larva.git
+ $ git clone https://git-wip-us.apache.org/repos/asf/incubator-mynewt-larva.git larva
$ ls
go larva
$ cd larva
$ ls
- LICENSE hw project
- README.md libs repo.yml
- compiler pkg setup-remotes.sh
+ LICENSE clutch.yml hw nest.yml project
+ README.md compiler libs net scripts
-2. You will now create a new project using the newt tool. You can either use the compiled binary `newt` or run the newt.go program using `$newt` (assuming you have stored the command in a variable in your .bash_profile or .bashrc). When you do a `newt target show` or `$newt target show` it should list all the projects you have created so far.
+2. You will now create a new target using the newt tool. You can either use the compiled binary `newt` or run the newt.go program using `$newt` (assuming you have stored the command in a variable in your .bash_profile or .bashrc). When you do a `newt target show` or `$newt target show` it should list all the projects you have created so far.
$ newt target create sim_test
Creating target sim_test
@@ -622,7 +624,7 @@ Coming soon.
Substitute DOS commands for Unix commands as necessary in the following steps if your machine is running Windows. The newt tool commands do not change.
-2. Again, you first have to create a repository for the project. Go to the ~dev/larva directory and build out a second project inside larva. The project name is "blinky", in keeping with the objective. Starting with the target name, you have to specify the different aspects of the project to build the right package for the board. In this case that means setting the architecture (arch), compiler, board support package (bsp), project, and compiler mode.
+2. You first have to create a repository for the project. Go to the ~dev/larva directory and build out a second project inside larva. The project name is "blinky", in keeping with the objective. Starting with the target name, you have to specify the different aspects of the project to pull the appropriate eggs and build the right package for the board. In this case that means setting the architecture (arch), compiler, board support package (bsp), project, and compiler mode.
$ newt target create blinky
Creating target blinky
@@ -646,8 +648,14 @@ Coming soon.
name: blinky
arch: cortex_m4
-3. Now you have to build the image package. Once built, you can find the executable "blinky.elf" in the project directory at ~/dev/larva/project/blinky/bin/blink. It's a good idea to take a little time to understand the directory structure.
+3. Now you have to build the image. The linker script within the `hw/bsp/olimex_stm32-e407_devboard` egg builds an image for flash memory by default. Therefore, you need to switch that script with `run_from_sram.ld` in order to get the egg to produce an image for SRAM. <font color="red"> We are working on making it easier to specify where the executable will be run from for a particular project and automatically choose the correct linker scripts and generate the appropriate image. It will be specified as a project identity e.g. bootloader, RAM, flash (default) and the target will build accordingly. </font>.
+
+ Once the target is built, you can find the executable "blinky.elf" in the project directory at ~/dev/larva/project/blinky/bin/blinky. It's a good idea to take a little time to understand the directory structure.
+ $ cd ~/dev/larva/hw/bsp/olimex_stm32-e407_devboard
+ $ diff olimex_stm32-e407_devboard.ld run_from_sram.ld
+ $ cp run_from_sram.ld olimex_stm32-e407_devboard.ld
+ $ cd ~/dev/larva/project/blinky/bin/blinky
$ newt target build blinky
Building target blinky (project = blinky)
Compiling case.c
@@ -845,7 +853,7 @@ Coming soon.
You will have to reset the board once the image is uploaded to it.
-2. By now you know that you have to build a new package. First, the olimex_stm32-e407_devboard.ld linker script which was previously the same as run_from_sram.ld will now need the contents of run_from_flash.ld. Then the target has to be rebuilt. You will simply replace the blinky project contents with the eggs needed to boot from flash instead of creating a new nest.
+2. By now you know that you have to build a new package that will run from flash. First, the olimex_stm32-e407_devboard.ld linker script which was previously made the same as run_from_sram.ld will now need the contents of run_from_flash.ld. Then the target has to be rebuilt.
$ cd ~/dev/larva/hw/bsp/olimex_stm32-e407_devboard
$ diff olimex_stm32-e407_devboard.ld run_from_sram.ld
@@ -854,101 +862,67 @@ Coming soon.
$ newt target build blinky
-3. Go to the openocd directory under blink and use OpenOCD to open up a session with the board as done while booting from SRAM.
+3. Go to the project directory and download the image to flash ... in a flash!
- $ cd ~/dev/larva/project/blinky/bin/blinky/openocd
- $ openocd -f olimex-arm-usb-tiny-h-ftdi.cfg -f ocd-8888.cfg -f stm32f4x.cfg -c "reset halt"
+ $ cd ~/dev/larva/project/blinky/bin/blinky
+ $ newt target download blinky
+ Downloading with ~/dev/larva/hw/bsp/olimex_stm32-e407_devboard/olimex_stm32-e407_devboard_download.sh
+
+4. The LED should be blinking!
+
+5. But wait...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. The debug connection to the JTAG port is now severed. 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 target debug blinky` instead of `newt target download blinky`.
+
+ $ newt target debug blinky
+ Debugging with ~/dev/larva/hw/bsp/olimex_stm32-e407_devboard/olimex_stm32-e407_devboard_debug.sh blinky
+ Debugging ~/dev/larva/project/blinky/bin/blinky/blinky.elf
+ GNU gdb (GNU Tools for ARM Embedded Processors) 7.8.0.20150604-cvs
+ Copyright (C) 2014 Free Software Foundation, Inc.
+ License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
+ This is free software: you are free to change and redistribute it.
+ There is NO WARRANTY, to the extent permitted by law. Type "show copying"
+ and "show warranty" for details.
+ This GDB was configured as "--host=x86_64-apple-darwin10 --target=arm-none-eabi".
+ Type "show configuration" for configuration details.
+ For bug reporting instructions, please see:
+ <http://www.gnu.org/software/gdb/bugs/>.
+ Find the GDB manual and other documentation resources online at:
+ <http://www.gnu.org/software/gdb/documentation/>.
+ For help, type "help".
+ Type "apropos word" to search for commands related to "word"...
+ Reading symbols from /Users/aditihilbert/dev/larva/project/blinky/bin/blinky/blinky.elf...done.
Open On-Chip Debugger 0.8.0 (2015-09-22-18:21)
Licensed under GNU GPL v2
For bug reports, read
http://openocd.sourceforge.net/doc/doxygen/bugs.html
Info : only one transport option; autoselect 'jtag'
adapter speed: 1000 kHz
- adapter_nsrst_assert_width: 500
adapter_nsrst_delay: 100
jtag_ntrst_delay: 100
+ Warn : target name is deprecated use: 'cortex_m'
+ DEPRECATED! use 'cortex_m' not 'cortex_m3'
cortex_m reset_config sysresetreq
Info : clock speed 1000 kHz
Info : JTAG tap: stm32f4x.cpu tap/device found: 0x4ba00477 (mfg: 0x23b, part: 0xba00, ver: 0x4)
Info : JTAG tap: stm32f4x.bs tap/device found: 0x06413041 (mfg: 0x020, part: 0x6413, ver: 0x0)
Info : stm32f4x.cpu: hardware has 6 breakpoints, 4 watchpoints
- target state: halted
- target halted due to debug-request, current mode: Thread
- xPSR: 0x01000000 pc: 0x0800408c psp: 0x20003c60
Info : JTAG tap: stm32f4x.cpu tap/device found: 0x4ba00477 (mfg: 0x23b, part: 0xba00, ver: 0x4)
Info : JTAG tap: stm32f4x.bs tap/device found: 0x06413041 (mfg: 0x020, part: 0x6413, ver: 0x0)
target state: halted
target halted due to debug-request, current mode: Thread
- xPSR: 0x01000000 pc: 0x0800053c msp: 0x10010000
-
-4. Run the GNU debugger for ARM in a different window. Specifying the script gdb-8888.cfg tells it what image to load. You should now have a (gdb) prompt inside the debugger.
-
- $ cd ~/dev/larva/project/blinky/bin/blinky/openocd
- $ arm-none-eabi-gdb -x gdb-8888.cfg
- GNU gdb (GNU Tools for ARM Embedded Processors) 7.8.0.20150604-cvs
- Copyright (C) 2014 Free Software Foundation, Inc.
- License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
- This is free software: you are free to change and redistribute it.
- There is NO WARRANTY, to the extent permitted by law. Type "show copying"
- and "show warranty" for details.
- This GDB was configured as "--host=x86_64-apple-darwin10 --target=arm-none-eabi".
- Type "show configuration" for configuration details.
- For bug reporting instructions, please see:
- <http://www.gnu.org/software/gdb/bugs/>.
- Find the GDB manual and other documentation resources online at:
- <http://www.gnu.org/software/gdb/documentation/>.
- For help, type "help".
- Type "apropos word" to search for commands related to "word".
-
- *** Set target charset ASCII
-
- *** Connecting to OpenOCD over port #8888 ***
- 0x20000580 in ?? ()
-
- *** loading nic.out.elf ***
- Loading section .text, size 0x65d4 lma 0x20000000
- Loading section .ARM.extab, size 0x24 lma 0x200065d4
- Loading section .ARM.exidx, size 0xd8 lma 0x200065f8
- Loading section .data, size 0x8f8 lma 0x200066d0
- Start address 0x20000580, load size 28616
- Transfer rate: 78 KB/sec, 2861 bytes/write.
+ xPSR: 0x01000000 pc: 0x08000250 msp: 0x10010000
+ Info : accepting 'gdb' connection from 3333
+ Info : device id = 0x10036413
+ Info : flash size = 1024kbytes
+ Reset_Handler () at startup_STM32F40x.s:199
+ 199 ldr r1, =__etext
(gdb)
-
-5. From within gdb check the registers. Set the msp register to the value expected. Finally, hit `c` to continue... and your green LED should blink!
-
- (gdb) info reg all
- r0 0x0 0
- r1 0x0 0
- r2 0x0 0
- r3 0x0 0
- r4 0x0 0
- r5 0x0 0
- r6 0x0 0
- r7 0x0 0
- r8 0x0 0
- r9 0x0 0
- r10 0x0 0
- r11 0x0 0
- r12 0x0 0
- sp 0x10010000 0x10010000
- lr 0xffffffff -1
- pc 0x20000580 0x20000580 <Reset_Handler>
- xPSR 0x1000000 16777216
- msp 0x10010000 0x10010000
- psp 0x0 0x0
- primask 0x0 0
- basepri 0x0 0
- faultmask 0x0 0
- control 0x0 0
- (gdb) set $msp=0x10010000
- (gdb) c
- Continuing.
-
-6. The LED should be blinking! But wait...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. The debug connection to the JTAG port is now severed. 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: If you want to erase the flash and load the image again you may use the following commands from within gdb. `flash erase 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 therefore 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.
+
+
+ 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 therefore 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.
(gdb) monitor flash erase_sector 0 0 4
erased sectors 0 through 4 on flash bank 0 in 2.296712s
@@ -956,3 +930,5 @@ Coming soon.
0x8000000 <__isr_vector>: 0xffffffff 0xffffffff 0xffffffff 0xffffffff
0x8000010 <__isr_vector+16>: 0xffffffff 0xffffffff 0xffffffff 0xffffffff
...
+
+
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/docs/chapter3/newt_tool_reference.md
----------------------------------------------------------------------
diff --git a/docs/chapter3/newt_tool_reference.md b/docs/chapter3/newt_tool_reference.md
index f17caa1..27cf442 100644
--- a/docs/chapter3/newt_tool_reference.md
+++ b/docs/chapter3/newt_tool_reference.md
@@ -193,6 +193,8 @@ Available Commands:
test Test target
export Export target
import Import target
+ download Download image to target
+ debug Download image to target and start an openocd/gdb session
Flags:
@@ -219,8 +221,8 @@ test | Test an egg on the target named `input1`. The egg is either supplied as
export | Exports the configurations of the specified target `input1`. If -a or -export-all flag is used, then all targets are exported and printed out to standard out. You may redirect the output to a file.
import | Import one or more target configuration from standard input or a file. Each target starts with `@target=<target-name>` followed by the attributes. The list of targets should end with `@endtargets`.
size | Outputs the RAM and flash consumption by the components of the specified target `input1`.
-
-
+download | Downloads the binary executable `<target-name>.elf.bin` to the board.
+debug | Downloads the binary executable `<target-name>.elf.bin` to the board and starts up the openocd/gdb combination session. gdb takes over the terminal.
Command-specific flags
@@ -249,6 +251,8 @@ export | newt target export my_target | Export only target named 'my_target' an
import | newt target import ex_tgt_1 < exported_targets.txt | Imports the target configuration for 'ex_tgt_1' in 'exported_targets.txt'.
import | newt target import -a < in_targets.txt | Imports all the targets specified in the file named `in_targets.txt`. A sample file is shown after this table.
size | newt target size blink_nordic | Inspects and lists the RAM and Flash memory use by each component (object files and libraries) of the target.
+download | newt target -v -lVERBOSE download blinky | Downloads `blinky.elf.bin` to the hardware in verbose mode with logging turned on at VERBOSE level.
+debug | newt target debug blinky | Downloads `blinky.elf.bin` to the hardware, opens up a gdb session with `blinky.elf` in the terminal, and halts for further input in gdb.
Example content for `in_targets.txt` file used for importing targets `test3` and `test4`.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/docs/index.md
----------------------------------------------------------------------
diff --git a/docs/index.md b/docs/index.md
index 3a02772..9175ab1 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,18 +1,18 @@
## Objective of Mynewt
-Mynewt is an open source initiative to build a stack of modularized control, networking, and monitoring software for embedded devices. The modular implementation allows the user the flexibility to mix and match hardware components and customize the software stack depending on the feature and performance requirements of the particular application he or she has in mind.
+Mynewt is an open source initiative to build a stack of modularized control, networking, and monitoring software for embedded devices. The modular implementation allows the user the flexibility to mix and match hardware components and software stack depending on the feature and performance requirements of the particular application he or she has in mind.
The world of Mynewt, therefore, has three primary collaborative goals:
* Build a modularized real-time operating system for a rich set of hardware components
-* Offer a suite of software for efficient and secure two-way communications with an embedded device
-* Develop method and tools necessary to create an optimized execution environment for the selected software on the desired hardware
+* Offer a suite of open-source software for efficient and secure two-way communications with an embedded device
+* Develop method and tools necessary to build an optimized executable image on the desired hardware
The chapter organization is outlined below. Each Chapter has one or more tutorials for hands-on experience with the material in each chapter.
* [Chapter 1: Getting Started](chapter1/newt_concepts.md) introduces some key terms in this initiative and includes a tutorial for a quick project to show how to work with some of the products.
-* [Chapter 2: Getting Acclimatized](chapter2/vocabulary.md) delves deeper into the concepts crucial to the software development effort.
+* [Chapter 2: Getting Acclimated](chapter2/vocabulary.md) delves deeper into the concepts crucial to the software development effort.
* [Chapter 3: Newt Tool Reference](chapter3/newt_ops.md) describes the command structure and details all the available commands to help you with your project.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/images/content-bg.png
----------------------------------------------------------------------
diff --git a/images/content-bg.png b/images/content-bg.png
new file mode 100644
index 0000000..8829c20
Binary files /dev/null and b/images/content-bg.png differ
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/images/egg-logo.png
----------------------------------------------------------------------
diff --git a/images/egg-logo.png b/images/egg-logo.png
new file mode 100644
index 0000000..c04e70d
Binary files /dev/null and b/images/egg-logo.png differ
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/index.html
----------------------------------------------------------------------
diff --git a/index.html b/index.html
index 5d1ba5d..b4639b0 100644
--- a/index.html
+++ b/index.html
@@ -1,93 +1,116 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-GB"><head>
- <title>Mynewt: RTOS to make device management easy</title>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
-
-
- <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8">
+<head>
+<title>Super Simple Two Column from CSS-Tricks</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<link rel="stylesheet" type="text/css" href="style.css" />
+</head>
-
- <meta name="description" content="Mynewt: The RTOS for easy management of constrained devices">
-
-
- <meta name="keywords" content="Mynewt: The RTOS for easy management of constrained devices">
-
-
- <meta name="robots" content="index, follow">
-
-
- <link rel="shortcut icon" href="/favicon.ico" type="image/x-icon">
+<body>
-
- <link rel="stylesheet" type="text/css" href="./css/screen.css" media="screen">
- <link href="./css/font-awesome-4.0.3.css" rel="stylesheet">
+<div id="header1">
+ <p><a href="http:mynewt.incubator.apache.org"> </a></p>
+ <a href="http://incubator.apache.org/"><img src="images/egg-logo.png" alt="Apache Incubator" border="0"></a>
+ </div>
+
+<div id="header2">
+ <h1> Mynewt </h1>
+ <p> The RTOS for easy management of constrained devices.</p>
+ </div>
-
+<div id="content">
+ <div id="sidebar">
+ <div class="verticalLine">
+ <ul>
+ <li><a href="index.html">Welcome</a> </li>
+ <li><a href="https://wiki.apache.org/incubator/MynewtProposal">Project
+Proposal</a> </li>
+ <li><a href="https://issues.apache.org/jira/browse/MYNEWT/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel">Issue
+Tracking</a> </li>
+ <li><a href="http://incubator.apache.org/projects/mynewt.html">Project
+Status</a> </li>
+ <li><a href="site/index.html">Documentation</a> </li>
+ </ul>
+ </div>
+ </div>
+<br>
-</head><body>
-<div id="header">
-<p><a href="http:mynewt.incubator.apache.org"> </a></p>
-<a href="http://incubator.apache.org/"><img src="egg-logo.png" alt="Apache Incubator" border="0"></a>
-</div>
+ <div id="main-content">
-<div class="colmask leftmenu">
-<h1> Mynewt </h1>
-<p> The RTOS for easy management of constrained devices.</p>
-<div class="colleft">
-<div class="col1"><!-- Column 1 start -->
-<h2>Introduction</h2>
-<br>
-<p> Welcome to the Apache Mynewt project.</p>
-<p> Mynewt is a real-time operating system for constrained embedded
+ <h2>Introduction</h2>
+ <br>
+ <p> Welcome to the Apache Mynewt project.</p>
+ <p> Mynewt is a real-time operating system for constrained embedded
systems like wearables, lightbulbs, locks, and doorbells. It is
designed to work on a variety of microcontrollers. It comes with the
Newt tool to help you build and distribute embedded projects using
-Mynewt. Together, they make the process of selecting driver interfaces,
-managing board support packages, and developing applications uniformly
-simple. </p>
-<p> We are still building this site. If you're interested in
+Mynewt. Together, they make the process of selecting driver interfaces, managing board support packages, and developing applications uniformly simple. </p>
+ <p> We are still building this site. If you're interested in
contributing you may check out the available documentation from the
menu on the left. Join one or more of the mailing lists below, and say
hi! </p>
-<h2> Project GIT Repository </h2>
<br>
-<li><a href="https://git-wip-us.apache.org/repos/asf/incubator-mynewt-site.git">
+<hr color="#B3B3B3">
+<br>
+ <h2> Project GIT Repository </h2>
+ <ul>
+ <li><a href="https://git-wip-us.apache.org/repos/asf/incubator-mynewt-site.git">
Documentation repo</a>
-</li>
-<li><a href="https://git-wip-us.apache.org/repos/asf/incubator-mynewt-larva.git">
+ </li>
+ <li><a href="https://git-wip-us.apache.org/repos/asf/incubator-mynewt-larva.git">
Main development repo including all major packages </a>
-</li>
-<li><a href="https://git-wip-us.apache.org/repos/asf/incubator-mynewt-newt.git">
+ </li>
+ <li><a href="https://git-wip-us.apache.org/repos/asf/incubator-mynewt-newt.git">
Newt Tool repo</a>
+ </li>
+ </ul>
+ <br>
+ <hr>
+<br>
<h2> Mailing Lists </h2>
+ <br>
+ <ul>
+ <li> dev@mynewt.incubator.apache.org
+ <p id="indent"> This is for both contributors and users. In order to subscribe to the dev list, send an email to: </p1>
+ <p id="indent"> dev-subscribe@mynewt.incubator.apache.org </p>
+ </li>
+ <li> commits@mynewt.incubator.apache.org
+ <p id="indent"> This is mainly for contributors to code or documentation. In order to subscribe to the commits list, send an email to: <p1>
+ <p id="indent"> commits-subscribe@mynewt.incubator.apache.org </p1>
+ </li>
+ <li> notifications@mynewt.incubator.apache.org
+ <p id="indent"> This is for all autogenerated mail except commits e.g. JIRA notifications. In order to subscribe to the notifications list, send an email to: </p1>
+ <p id="indent"> notifications-subscribe@mynewt.incubator.apache.org </p>
+ <br>
+
+To subscribe to a mailing list, you simply send an email to a special subscription address.
+
+To subscribe to the dev list, send an email to:
+
+dev-subscribe@mynewt.incubator.apache.org .
+
+For the issues list, the address would be:
+
+issues-subscribe@mynewt.incubator.apache.org .
+
+You should then get an automated email which details how to confirm your subscription.
+
+ </li>
+ </ul>
<br>
-</li>
-<li> dev@mynewt.incubator.apache.org (contributers and users)
-</li>
-<li> commit@mynewt.incubator.apache.org (contributers to code or
-documentation)
-</li>
-<li> notifications@mynewt.incubator.apache.org (autogenerated mail
-except commits e.g. JIRA notifications)<!-- Column 1 end --> </li>
-</div>
-<div class="col2"><!-- Column 2 start -->
-<ul class="navbar">
- <li><a href="index.html">Welcome</a> </li>
- <li><a href="https://wiki.apache.org/incubator/MynewtProposal">Project
-Proposal</a> </li>
- <li><a href="https://issues.apache.org/jira/browse/MYNEWT/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel">Issue
-Tracking</a> </li>
- <li><a href="http://incubator.apache.org/projects/mynewt.html">Project
-Status</a> </li>
- <li><a href="site/index.html">Documentation</a> </li>
-</ul>
-<!-- Column 2 end --> </div>
-</div>
+ </div>
+
+<div class="clear"></div>
+
</div>
<!-- Nothing in footer for now -->
-<div id="footer">
-<p> <a href="https://runtime.io"> </a></p>
+<div id="footer">
+<hr>
</div>
-</body></html>
+</body>
+</html>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index 8d5d79d..720f846 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,4 +1,5 @@
site_name: Mynewt
+site_url: http://mynewt.incubator.apache.org/index.html
pages:
- Doc Home: index.md
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/60d6afb2/site/chapter1/newt_concepts/index.html
----------------------------------------------------------------------
diff --git a/site/chapter1/newt_concepts/index.html b/site/chapter1/newt_concepts/index.html
index c1894ab..f413b51 100644
--- a/site/chapter1/newt_concepts/index.html
+++ b/site/chapter1/newt_concepts/index.html
@@ -179,7 +179,7 @@
<h3 id="basic-components-in-the-ecosystem">Basic components in the ecosystem<a class="headerlink" href="#basic-components-in-the-ecosystem" title="Permanent link">¶</a></h3>
<ul>
<li>
-<p>NewtOS is an open-source RTOS (Real Time Operating System) that is not tied to any particular hardware but can be tuned to the hardware component mix of the user's choosing. It has support for multitasking, synchronization of tasks, scheduling and buffering of operations, memory management,file systems, networking, security, power management, and other advanced features. Naturally, it involves several packages such as the Core RTOS, a flash file system, utility functions, a variety of board support packages, packages of microcontrollers etc.</p>
+<p>NewtOS is an open-source RTOS (Real Time Operating System) that works on a variety of hardware. The goal is to develop a pre-emptive, multitasking OS that is highly modular, making it possible to mix and match components to enable desired features and capabilities on multiple hardware architectures. Examples of components being worked on are the Core RTOS, a flash file system, utility functions, a variety of board support packages, packages of microcontrollers etc.</p>
</li>
<li>
<p>Network protocol stacks such as Bluetooth Low Energy, and more</p>
@@ -189,19 +189,17 @@
</li>
</ul>
<h3 id="terminology">Terminology<a class="headerlink" href="#terminology" title="Permanent link">¶</a></h3>
-<p>In the mynewt lifecycle, a project grows in a nest. A nest may house multiple projects. The nest is, therefore, a repository where various component packages for one or more projects reside. Each package is an egg, naturally. However, an egg may consist of other eggs!</p>
-<p>A nest can be given any name. You will see a nest named "tadpole" in mynewt. It contains all the core libraries of the operating system for distribution. Each of these directories contain one or more eggs where an egg is a basic unit of implementation of any aspect of the RTOS.</p>
+<p>A Mynewt user starts with a project in mind that defines the application or utility that he or she wants to implement on an embedded device. Making an LED blink on an electronics prototyping board is a common starter project. Enabling a BLE (Bluetooth Low Energy) peripheral mode on a development board is a more complex project. Specifying a project requires naming it, at the very least, and then adding the desired properties or attributes. In order to actualize a project, it needs to be applied to a target which is essentially a combination of some specified hardware and the execution environment. </p>
+<p>In the mynewt lifecycle, a project grows in a nest. A nest may house multiple projects. The nest is, therefore, a repository where various component packages for one or more projects reside. Each package is an egg (naturally!). However, in the world of Mynewt an egg may consist of other eggs! For example, the starter project Blinky is an egg consisting of several constituent eggs that enable core features. The egg form is suitable for elemental units of code as it explicitly exposes characteristics such as dependencies, versions, capabilities, requirements etc., thus making assembling appropriate components for a project and building an image for it easy to follow, modular, and robust.</p>
+<p>A nest can be given any name. For example, you will see a nest named "tadpole" in Mynewt (<a href="https://git-wip-us.apache.org/repos/asf?p=incubator-mynewt-tadpole.git">https://git-wip-us.apache.org/repos/asf?p=incubator-mynewt-tadpole.git</a>). It contains all the core libraries of the operating system for the native platform which currently supports compilation on Mac OS X. The core libraries are contained in the form of eggs where an egg is a basic unit of implementation of any aspect of the RTOS. The eggs are distributed in the following directory structure inside the nest:</p>
<ul>
-<li>libs/os: The core RTOS which ports to all supported chip platforms.</li>
-<li>hw/hal: The hardware abstraction layer (HAL) API definitions that all BSP and MCU implementations must support</li>
-<li>hw/mcu/native: A MCU implementation for the native platform</li>
-<li>hw/bsp/native: A BSP implementation for the native platform</li>
-<li>compiler/native: The definition of compiler support for the native platform.</li>
+<li>libs: contains the two eggs <code>os</code> and <code>testutil</code></li>
+<li>hw: contains three eggs - (i) <code>hal</code> which has the abstraction layer (HAL) API definitions that all BSP and MCU implementations must support, (ii) <code>/mcu/native</code> which in an MCU implementation for the native platform (a simulator, in this case), and (iii) <code>bsp/native</code> which is a BSP implementation for the native platform </li>
+<li>compiler: contains the <code>sim</code> egg which bundles the compiler specifications for the native platform.</li>
</ul>
-<p>Each of the above directories contain one or more eggs where an egg is a basic unit of implementation of any aspect of the RTOS. For example, the libs/os directory holds eggs such as the bootloader, flash file system, the kernel for process/thread/memory management, tools for testing etc. The hw/hal directory holds an egg that provides abstraction for physical hardware components such as GPIO (general purpose input/output), network adapters, timers, and universal asynchronous receiver-transmitters (UARTs). All these physical interfaces are defined in various header files in hw/hal, and are designed to make device driver specification simpler.</p>
-<p>You can see another nest in the mynewt ecosystem called the "larva". It was spawned from the "tadpole" nest using the newt tool. Spawning is easy - <code>$ newt create nest <your_nest_name></code>. "larva" is the developer's test repository containing all sorts of eggs being incubated, including ones to enhance the core operating system which should eventually make their way into the "tadpole" nest. There is a <code>hatch_tadpole</code> script to update the "tadpole" nest when the core OS related eggs in "larva" are ready.</p>
-<p>There is a third nest named "newt" that contains all the eggs needed to support the build and release process of mynewt software.</p>
-<p>There will also be pre-built nests for certain common hardware devices to enable a user to quickly get started with a project.</p>
+<p>Let's explore this sample nest a bit further. The <code>libs/os</code> egg contains code for scheduler, process/thread/memory management, semaphores etc. It is the core RTOS which ports to all supported chip platforms.The <code>libs/testutil</code> egg contains code for testing packages on hardware or simulated environment. The <code>hw/hal</code> egg contains header files that provide abstraction for physical hardware components such as GPIO (general purpose input/output), network adapters, timers, and UARTs. This <code>hw/hal</code> egg is an MCU peripheral abstraction designed to make it easy to port to different MCUs (microcontrollers). The <code>hw/mcu/native</code> egg contains code for microcontroller operations on the native platform. The <code>hw/bsp/native</code> egg contains the board support package for the native platform. And finally, the sixth egg <code>sim</code> contains the compiler specifications such as path and flags. Currently the compilation is supported on
Mac OS X.</p>
+<p>You can see another nest in the mynewt ecosystem called the "larva". It was spawned from the skeletal "tadpole" nest using the newt tool. Spawning is easy - <code>$ newt create nest <your_nest_name></code>. "larva" is the developer's test repository containing all sorts of eggs being written and incubated, including ones to enhance the core operating system which should eventually make their way into the "tadpole" nest. There is a <code>hatch_tadpole</code> script to update the "tadpole" nest when the core OS related eggs in "larva" are ready.</p>
+<p>There is a third nest named "newt" that contains all the eggs needed to support the build and release process of mynewt software. In the future, there will also be pre-built nests for certain common hardware devices to enable a user to quickly get started with a project.</p>
<h3 id="a-mynewt-contributor">A Mynewt contributor<a class="headerlink" href="#a-mynewt-contributor" title="Permanent link">¶</a></h3>
<p>A contributor can choose to work on any area(s) of the Mynewt endeavor that appeals to him or her. Hence, you can work on one or more eggs or an entire nest. You can create your own nest (master) or create a branch in an existing nest. For now, Runtime contributors will review any new areas of support that you may wish to introduce e.g. a new board support package (BSP) or a new network protocol. </p>
<p>A contributer role necessarily implies he or she is a Mynewt user (see below) of some or all of the products developed.</p>