v1_3_0/os/tutorials/nRF52/index.html - mynewt-site - Git at Google

 <!DOCTYPE html>
 <html lang="en">
     <head>
         <meta charset="utf-8">
         <meta http-equiv="X-UA-Compatible" content="IE=edge">
         <meta name="viewport" content="width=device-width, initial-scale=1.0">


         <!-- This is broken by doc revisioning.
          -->
         <link rel="shortcut icon" href="../../../img/favicon.ico">

         <title>Blinky on nRF52 DK - Apache Mynewt</title>

         <link href="../../../css/bootstrap-3.0.3.min.css" rel="stylesheet">
         <link rel="stylesheet" href="../../../css/highlight.css">
         <link href="../../../css/base.css" rel="stylesheet">
         <link href="../../../css/custom.css" rel="stylesheet">
         <link href="../../../css/v2.css" rel="stylesheet">
         <link href="https://fonts.googleapis.com/css?family=Lato" rel="stylesheet">
         <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">

         <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
         <!--[if lt IE 9]>
             <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
             <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
         <![endif]-->


             <script>
             (function(i, s, o, g, r, a, m) {
     i["GoogleAnalyticsObject"] = r;
     (i[r] =
         i[r] ||
         function() {
             (i[r].q = i[r].q || []).push(arguments);
         }),
         (i[r].l = 1 * new Date());
     (a = s.createElement(o)), (m = s.getElementsByTagName(o)[0]);
     a.async = 1;
     a.src = g;
     m.parentNode.insertBefore(a, m);
 })(window, document, "script", "//www.google-analytics.com/analytics.js", "ga");

 ga("create", "UA-72162311-1", "auto");
 ga("send", "pageview");
 </script>

     </head>


     <body class="Blinky on nRF52 DK">


         <div class="container">
     <div class="row v2-main-banner">
         <a class="logo-cell" href="/">
             <img class="logo" src="/img/logo.png">
         </a>
         <div class="tagline-cell">
             <h4 class="tagline">An OS to build, deploy and securely manage billions of devices</h4>
         </div>
         <div class="news-cell">
             <div class="well">
                 <h4>Latest News:</h4> <a href="/download">Apache Mynewt 1.12.0, Apache NimBLE 1.7.0 </a> released (April 4, 2024)
             </div>
         </div>
     </div>
 </div>


 <nav id="navbar" class="navbar navbar-inverse affix-top" data-spy="affix" data-offset-top="150" role="navigation">
     <div class="container">
         <!-- Collapsed navigation -->
         <div class="navbar-header">
             <!-- Expander button -->
             <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
                 <span class="sr-only">Toggle navigation</span>
                 <span class="icon-bar"></span>
                 <span class="icon-bar"></span>
                 <span class="icon-bar"></span>
             </button>

         </div>

         <!-- Expanded navigation -->
         <div class="navbar-collapse collapse">
             <!-- Main navigation -->
             <ul class="nav navbar-nav navbar-right">
                 <li
   class=""
 >
                     <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
                 </li>
                 <li
   class="important"
 >
                     <a href="/quick-start/">Quick Start</a>
                 </li>
                 <li
   class=""
 >
                     <a href="/about/">About</a>
                 </li>
                 <li
   class=""
 >
                     <a href="/talks/">Talks</a>
                 </li>
                 <li
   class="active"
 >
                     <a href="/documentation/">Documentation</a>
                 </li>
                 <li
   class=""
 >
                     <a href="/download/">Download</a>
                 </li>
                 <li
   class=""
 >
                     <a href="/community/">Community</a>
                 </li>
                 <li
   class=""
 >
                     <a href="/events/">Events</a>
                 </li>
             </ul>

         </div>
     </div>
 </nav>


         <div class="container">

                 <div class="row">
                     <div class="col-md-3 v2-sidebar sidebar-container"><div id="docSidebar" class="hidden-print" role="complementary">
     <div class="top">
         <div role="search">
             <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
                 <div class="form-group">
                     <input type="text" name="q" class="form-control" placeholder="Search documentation" />
                 </div>
             </form>
         </div>
     </div>
     <ul class="toc-nav">
       <li class="doc-version"><select class="form-control" onchange="if (this.value) window.location.href=this.value">
   <option value="/latest">
     Version: master
   </option>
   <option value="/v1_12_0/" >
     Version: 1.12.0
   </option>
   <option value="/v1_11_0/" >
     Version: 1.11.0
   </option>
   <option value="/v1_10_0/" >
     Version: 1.10.0
   </option>
   <option value="/v1_9_0/" >
     Version: 1.9.0
   </option>
     <option value="/v1_8_0/" >
     Version: 1.8.0
   </option>
   <option value="/v1_7_0/" >
     Version: 1.7.0
   </option>
   <option value="/v1_6_0/" >
     Version: 1.6.0
   </option>
   <option value="/v1_5_0/" >
     Version: 1.5.0
   </option>
   <option value="/v1_4_0/" >
     Version: 1.4.0
   </option>
   <option value="/v1_3_0/os/introduction" selected="selected" >
     Version: 1.3.0
   </option>
   <option value="/v1_2_0/os/introduction" >
     Version: 1.2.0
   </option>
   <option value="/v1_1_0/os/introduction" >
     Version: 1.1.0
   </option>
   <option value="/v1_0_0/os/introduction" >
     Version: 1.0.0
   </option>
   <option value="/v0_9_0/os/introduction" >
     Version: 0.9.0
   </option>
 </select></li>


     <li ><a href="../../introduction/">Mynewt Documentation</a>


     <ul>


     <li ><a href="../../get_started/get_started/">Basic Setup</a>


     </li>


   <li >
     <a href="../../get_started/vocabulary/">Concepts</a>
   </li>


     <li ><a href="../tutorials/">Tutorials</a>


     <ul>


     <li ><a href="../blinky/">Project Blinky</a>


     <ul>


   <li >
     <a href="../arduino_zero/">Blinky on Arduino Zero</a>
   </li>


   <li >
     <a href="../blinky_primo/">Blinky on Arduino Primo</a>
   </li>


   <li >
     <a href="../olimex/">Blinky on Olimex</a>
   </li>


   <li class="active">
     <a href="./">Blinky on nRF52 DK</a>
   </li>


   <li >
     <a href="../rbnano2/">Blinky on RedBear Nano 2</a>
   </li>


   <li >
     <a href="../blinky_stm32f4disc/">Blinky on STM32F4-Discovery</a>
   </li>


   <li >
     <a href="../blinky_console/">Add Console and Shell to Blinky</a>
   </li>


     </ul>

     </li>


     <li ><a href="../repo/add_repos/">Work with repositories</a>


     </li>


     <li ><a href="../project-slinky/">Project Slinky for Remote Comms</a>


     </li>


     <li><a href="
   ../ble_bare_bones/
 ">Bluetooth Low Energy</a>


     </li>


     <li><a href="
   ../lora/lorawanapp/
 ">LoRa</a>


     </li>


     <li><a href="
   ../event_queue/
 ">OS Fundamentals</a>


     </li>


     <li><a href="
   ../add_newtmgr/
 ">Remote Device Management</a>


     </li>


     <li><a href="


   ../sensors/sensors/

 ">Sensors</a>


     </li>


     <li><a href="
   ../segger_rtt/
 ">Tooling</a>


     </li>


     <li><a href="
   ../codesize/
 ">Other</a>


     </li>


     </ul>

     </li>


     <li ><a href="../../os_user_guide/">OS User Guide</a>


     </li>


     <li><a href="
   ../../../network/ble/ble_intro/
 ">BLE User Guide</a>


     </li>


     <li ><a href="../../../newt/newt_intro/">Newt Tool Guide</a>


     </li>


     <li ><a href="../../../newtmgr/overview/">Newt Manager Guide</a>


     </li>


   <li >
     <a href="../../../known_issues/">Known Issues</a>
   </li>


     </ul>

     </li>


     <li><a href="
   ../../../newt/install/prev_releases/
 ">Appendix</a>


     </li>


     </ul>
 </div></div>

                     <div class="col-md-9" role="main">
                         <div class="doc-header">
                             <div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
     <li><a href="/documentation/">Docs</a></li>


           <li>&raquo; <a href="os/tutorials/blinky/">Project Blinky</a></li>


           <li>&raquo; <a href="os/tutorials/tutorials/">Tutorials</a></li>


           <li>&raquo; <a href="os/introduction/">Mynewt Documentation</a></li>


         <li>&raquo; Blinky on nRF52 DK</li>


       <li class="wy-breadcrumbs-aside">

           <a href="https://github.com/apache/mynewt-site/blob/master/docs/os/tutorials/nRF52.md"
             class="icon icon-github"> Edit on GitHub</a>

       </li>

   </ul>
 </div>
                         </div>


                             <div class="alert alert-warning">
                                 <p>
                                     Version 1.3.0 is not the most recent version of the Apache Mynewt
                                     documentation. Click <a href="/latest">here</a> to read the latest
                                     version.
                                 </p>
                             </div>


                             <h2 id="blinky-your-hello-world-on-a-nrf52-development-kit">Blinky, your "Hello World!", on a nRF52 Development Kit</h2>
 <p>This tutorial shows you how to create, build, and run the Blinky application on a nRF52 Development Kit.
 <br></p>
 <p>Note that there are several versions of the nRF52 Development Kit in the market. The boards tested with this tutorial are listed under "Prerequisites".</p>
 <p><br></p>
 <h3 id="prerequisites">Prerequisites</h3>
 <ul>
 <li>Meet the prerequisites listed in <a href="/os/tutorials/blinky.md">Project Blinky</a>.</li>
 <li>Have a nRF52 Development Kit (one of the following)<ul>
 <li>Nordic nRF52-DK Development Kit - PCA 10040</li>
 <li>Rigado BMD-300 Evaluation Kit - BMD-300-EVAL-ES</li>
 </ul>
 </li>
 <li>Install the <a href="https://www.segger.com/jlink-software.html">Segger JLINK Software and documentation pack</a>.</li>
 </ul>
 <p>This tutorial uses the Nordic nRF52-DK board.</p>
 <h3 id="create-a-project">Create a Project</h3>
 <p>Create a new project if you do not have an existing one.  You can skip this step and proceed to <a href="#create_targets">create the targets</a> if you already have a project created.  </p>
 <p>Run the following commands to create a new project:</p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>    $ mkdir ~/dev
     $ cd ~/dev
     $ newt new myproj
     Downloading project skeleton from apache/mynewt-blinky...
     Installing skeleton in myproj...
     Project myproj successfully created.
     $ cd myproj
     $ newt install
     apache-mynewt-core
     $
 </code></pre></div>

 <p><br></p>
 <h3 id="create-the-targets"><a name="create_targets"></a>Create the Targets</h3>
 <p>Create two targets for the nRF52-DK board - one for the bootloader and one for the Blinky application.</p>
 <p>Run the following <code>newt target</code> commands, from your project directory, to create a bootloader target. We name the target <code>nrf52_boot</code>:</p>
 <p><font color="#F2853F">
 Note: This tutorial uses the Nordic nRF52-DK board.  You must specify the correct bsp for the board you are using. </font> </p>
 <ul>
 <li>For the Nordic Dev Kit choose @apache-mynewt-core/hw/bsp/nrf52dk instead (in the highlighted lines)</li>
 <li>For the Rigado Eval Kit choose @apache-mynewt-core/hw/bsp/bmd300eval instead (in the highlighted lines)</li>
 </ul>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt target create nrf52_boot
 $ newt target set nrf52_boot app=@apache-mynewt-core/apps/boot
 <span style="background-color: #ffffcc">$ newt target set nrf52_boot bsp=@apache-mynewt-core/hw/bsp/nrf52dk
 </span>$ newt target set nrf52_boot build_profile=optimized
 </code></pre></div>

 <p><br>
 Run the following <code>newt target</code> commands to create a target for the Blinky application. We name the target <code>nrf52_blinky</code>.</p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt target create nrf52_blinky
 $ newt target set nrf52_blinky app=apps/blinky
 <span style="background-color: #ffffcc">$ newt target set nrf52_blinky bsp=@apache-mynewt-core/hw/bsp/nrf52dk
 </span>$ newt target set nrf52_blinky build_profile=debug
 </code></pre></div>

 <p><br>
 You can run the <code>newt target show</code> command to verify the target settings:</p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt target show
 targets/nrf52_blinky
     app=apps/blinky
     bsp=@apache-mynewt-core/hw/bsp/nrf52dk
     build_profile=debug
 targets/nrf52_boot
     app=@apache-mynewt-core/apps/boot
     bsp=@apache-mynewt-core/hw/bsp/nrf52dk
     build_profile=optimized
 </code></pre></div>

 <p><br></p>
 <h3 id="build-the-target-executables">Build the Target Executables</h3>
 <p>Run the <code>newt build nrf52_boot</code> command to build the bootloader:</p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt build nrf52_boot
 Building target targets/nrf52_boot
 Compiling repos/apache-mynewt-core/boot/bootutil/src/image_ec256.c
 Compiling repos/apache-mynewt-core/boot/bootutil/src/image_ec.c
 Compiling repos/apache-mynewt-core/boot/bootutil/src/image_rsa.c
 Compiling repos/apache-mynewt-core/crypto/mbedtls/src/aes.c
 Compiling repos/apache-mynewt-core/boot/bootutil/src/loader.c
 Compiling repos/apache-mynewt-core/boot/bootutil/src/image_validate.c
 Compiling repos/apache-mynewt-core/boot/bootutil/src/bootutil_misc.c
 Compiling repos/apache-mynewt-core/apps/boot/src/boot.c
     ...

 Archiving sys_mfg.a
 Archiving sys_sysinit.a
 Archiving util_mem.a
 Linking ~/dev/myproj/bin/targets/nrf52_boot/app/apps/boot/boot.elf
 Target successfully built: targets/nrf52_boot
 </code></pre></div>

 <p><br>
 Run the <code>newt build nrf52_blinky</code> command to build the Blinky application:</p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt build nrf52_blinky
 Building target targets/nrf52_blinky
 Assembling repos/apache-mynewt-core/hw/bsp/nrf52dk/src/arch/cortex_m4/gcc_startup_nrf52_split.s
 Compiling repos/apache-mynewt-core/hw/bsp/nrf52dk/src/sbrk.c
 Compiling repos/apache-mynewt-core/hw/cmsis-core/src/cmsis_nvic.c
 Compiling repos/apache-mynewt-core/hw/drivers/uart/uart_hal/src/uart_hal.c
 Assembling repos/apache-mynewt-core/hw/bsp/nrf52dk/src/arch/cortex_m4/gcc_startup_nrf52.s
 Compiling apps/blinky/src/main.c

     ...

 Archiving sys_mfg.a
 Archiving sys_sysinit.a
 Archiving util_mem.a
 Linking ~/dev/myproj/bin/targets/nrf52_blinky/app/apps/blinky/blinky.elf
 Target successfully built: targets/nrf52_blinky
 </code></pre></div>

 <p><br></p>
 <h3 id="sign-and-create-the-blinky-application-image">Sign and Create the Blinky Application Image</h3>
 <p>Run the <code>newt create-image nrf52_blinky 1.0.0</code> command to create and sign the application image. You may assign an arbitrary version (e.g. 1.0.0) to the image.</p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt create-image nrf52_blinky 1.0.0
 App image succesfully generated: ~/dev/myproj/bin/targets/nrf52_blinky/app/apps/blinky/blinky.img
 </code></pre></div>

 <p><br></p>
 <h3 id="connect-to-the-board">Connect to the Board</h3>
 <ul>
 <li>Connect a micro-USB cable from your computer to the micro-USB port on the nRF52-DK board.</li>
 <li>Turn the power on the board to ON. You should see the green LED light up on the board.</li>
 </ul>
 <h3 id="load-the-bootloader-and-the-blinky-application-image">Load the Bootloader and the Blinky Application Image</h3>
 <p>Run the <code>newt load nrf52_boot</code> command to load the bootloader onto the board: </p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt load nrf52_boot
 Loading bootloader
 $
 </code></pre></div>

 <p><br>
 Run the <code>newt load nrf52_blinky</code> command to load the Blinky application image onto the board.</p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt load nrf52_blinky
 Loading app image into slot 1
 </code></pre></div>

 <p>You should see the LED1 on the board blink!</p>
 <p>Note: If the LED does not blink, try resetting your board.</p>
 <p><br></p>
 <p>If you want to erase the flash and load the image again, you can run <code>JLinkExe</code> to issue an <code>erase</code> command.</p>
 <p><strong>Note:</strong> On Windows: Run the <code>jlink</code> command with the same arguments from a Windows Command Prompt terminal.</p>
 <p><br></p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ JLinkExe -device nRF52 -speed 4000 -if SWD
 SEGGER J-Link Commander V5.12c (Compiled Apr 21 2016 16:05:51)
 DLL version V5.12c, compiled Apr 21 2016 16:05:45

 Connecting to J-Link via USB...O.K.
 Firmware: J-Link OB-SAM3U128-V2-NordicSemi compiled Mar 15 2016 18:03:17
 Hardware version: V1.00
 S/N: 682863966
 VTref = 3.300V


 Type &quot;connect&quot; to establish a target connection, &#39;?&#39; for help
 J-Link&gt;erase
 Cortex-M4 identified.
 Erasing device (0;?i?)...
 Comparing flash   [100%] Done.
 Erasing flash     [100%] Done.
 Verifying flash   [100%] Done.
 J-Link: Flash download: Total time needed: 0.363s (Prepare: 0.093s, Compare: 0.000s, Erase: 0.262s, Program: 0.000s, Verify: 0.000s, Restore: 0.008s)
 Erasing done.
 J-Link&gt;exit
 $
 </code></pre></div>

                         <div class="row">


 <ul class="nav nav-pills" style="margin-bottom: 10px">
     <li>

     </li>
     <li class="pull-right">

     </li>
 </ul>
                         </div>
                         <footer class="row">
     <div class="col-xs-12">

             <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>

     </div>
     <div class="col-xs-12">
         <div class="logos">
             <a href="https://www.apache.org/">
                 <img src="/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
             </a>
             <p>
                 Copyright © 2015-2021 The Apache Software Foundation.<br>
                 <small class="footnote">
                     Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt
                     project logo are either registered trademarks or trademarks of the Apache
                     Software Foundation in the United States and other countries.
                 </small>
             </p>
             <a href="">
                 <img src="https://www.countit.com/images/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
             </a>
         </div>
     </div>
     <a href="https://www.apache.org/licenses/">
         <button class="button-footer-asf">
             License
         </button>
     </a>
     <a href="https://www.apache.org/foundation/sponsorship.html">
         <button class="button-footer-asf">
             Sponsorship
         </button>
     </a>
     <a href="https://www.apache.org/foundation/thanks.html">
         <button class="button-footer-asf">
             Thanks
         </button>
     </a>
     <a href="https://www.apache.org/security/">
         <button class="button-footer-asf">
             Security
         </button>
     </a>
     <a href="https://apache.org/events/current-event">
         <button class="button-footer-asf">
             ASF Events
         </button>
     </a>
 </footer>
                     </div>
                 </div>


         </div>

         <script src="../../../js/jquery-1.10.2.min.js"></script>
         <script src="../../../js/bootstrap-3.0.3.min.js"></script>
         <script src="../../../js/highlight.pack.js"></script>
         <script src="../../../js/base.js"></script>
         <script src="../../../js/custom.js"></script>
             <script src="search/main.js"></script>

     </body>
 </html>
	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="utf-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">


	<!-- This is broken by doc revisioning.
	-->
	<link rel="shortcut icon" href="../../../img/favicon.ico">

	<title>Blinky on nRF52 DK - Apache Mynewt</title>

	<link href="../../../css/bootstrap-3.0.3.min.css" rel="stylesheet">
	<link rel="stylesheet" href="../../../css/highlight.css">
	<link href="../../../css/base.css" rel="stylesheet">
	<link href="../../../css/custom.css" rel="stylesheet">
	<link href="../../../css/v2.css" rel="stylesheet">
	<link href="https://fonts.googleapis.com/css?family=Lato" rel="stylesheet">
	<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">

	<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
	<!--[if lt IE 9]>
	<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
	<script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
	<![endif]-->


	<script>
	(function(i, s, o, g, r, a, m) {
	i["GoogleAnalyticsObject"] = r;
	(i[r] =
	i[r] \|\|
	function() {
	(i[r].q = i[r].q \|\| []).push(arguments);
	}),
	(i[r].l = 1 * new Date());
	(a = s.createElement(o)), (m = s.getElementsByTagName(o)[0]);
	a.async = 1;
	a.src = g;
	m.parentNode.insertBefore(a, m);
	})(window, document, "script", "//www.google-analytics.com/analytics.js", "ga");

	ga("create", "UA-72162311-1", "auto");
	ga("send", "pageview");
	</script>

	</head>


	<body class="Blinky on nRF52 DK">


	<div class="container">
	<div class="row v2-main-banner">
	<a class="logo-cell" href="/">
	<img class="logo" src="/img/logo.png">
	</a>
	<div class="tagline-cell">
	<h4 class="tagline">An OS to build, deploy and securely manage billions of devices</h4>
	</div>
	<div class="news-cell">
	<div class="well">
	<h4>Latest News:</h4> <a href="/download">Apache Mynewt 1.12.0, Apache NimBLE 1.7.0 </a> released (April 4, 2024)
	</div>
	</div>
	</div>
	</div>








	<nav id="navbar" class="navbar navbar-inverse affix-top" data-spy="affix" data-offset-top="150" role="navigation">
	<div class="container">
	<!-- Collapsed navigation -->
	<div class="navbar-header">
	<!-- Expander button -->
	<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
	<span class="sr-only">Toggle navigation</span>
	<span class="icon-bar"></span>
	<span class="icon-bar"></span>
	<span class="icon-bar"></span>
	</button>

	</div>

	<!-- Expanded navigation -->
	<div class="navbar-collapse collapse">
	<!-- Main navigation -->
	<ul class="nav navbar-nav navbar-right">
	<li
	class=""
	>
	<a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
	</li>
	<li
	class="important"
	>
	<a href="/quick-start/">Quick Start</a>
	</li>
	<li
	class=""
	>
	<a href="/about/">About</a>
	</li>
	<li
	class=""
	>
	<a href="/talks/">Talks</a>
	</li>
	<li
	class="active"
	>
	<a href="/documentation/">Documentation</a>
	</li>
	<li
	class=""
	>
	<a href="/download/">Download</a>
	</li>
	<li
	class=""
	>
	<a href="/community/">Community</a>
	</li>
	<li
	class=""
	>
	<a href="/events/">Events</a>
	</li>
	</ul>

	</div>
	</div>
	</nav>



	<div class="container">

	<div class="row">
	<div class="col-md-3 v2-sidebar sidebar-container"><div id="docSidebar" class="hidden-print" role="complementary">
	<div class="top">
	<div role="search">
	<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
	<div class="form-group">
	<input type="text" name="q" class="form-control" placeholder="Search documentation" />
	</div>
	</form>
	</div>
	</div>
	<ul class="toc-nav">
	<li class="doc-version"><select class="form-control" onchange="if (this.value) window.location.href=this.value">
	<option value="/latest">
	Version: master
	</option>
	<option value="/v1_12_0/" >
	Version: 1.12.0
	</option>
	<option value="/v1_11_0/" >
	Version: 1.11.0
	</option>
	<option value="/v1_10_0/" >
	Version: 1.10.0
	</option>
	<option value="/v1_9_0/" >
	Version: 1.9.0
	</option>
	<option value="/v1_8_0/" >
	Version: 1.8.0
	</option>
	<option value="/v1_7_0/" >
	Version: 1.7.0
	</option>
	<option value="/v1_6_0/" >
	Version: 1.6.0
	</option>
	<option value="/v1_5_0/" >
	Version: 1.5.0
	</option>
	<option value="/v1_4_0/" >
	Version: 1.4.0
	</option>
	<option value="/v1_3_0/os/introduction" selected="selected" >
	Version: 1.3.0
	</option>
	<option value="/v1_2_0/os/introduction" >
	Version: 1.2.0
	</option>
	<option value="/v1_1_0/os/introduction" >
	Version: 1.1.0
	</option>
	<option value="/v1_0_0/os/introduction" >
	Version: 1.0.0
	</option>
	<option value="/v0_9_0/os/introduction" >
	Version: 0.9.0
	</option>
	</select></li>























	<li ><a href="../../introduction/">Mynewt Documentation</a>


	<ul>







	<li ><a href="../../get_started/get_started/">Basic Setup</a>


	</li>





	<li >
	<a href="../../get_started/vocabulary/">Concepts</a>
	</li>







	<li ><a href="../tutorials/">Tutorials</a>


	<ul>







	<li ><a href="../blinky/">Project Blinky</a>


	<ul>





	<li >
	<a href="../arduino_zero/">Blinky on Arduino Zero</a>
	</li>





	<li >
	<a href="../blinky_primo/">Blinky on Arduino Primo</a>
	</li>





	<li >
	<a href="../olimex/">Blinky on Olimex</a>
	</li>





	<li class="active">
	<a href="./">Blinky on nRF52 DK</a>
	</li>





	<li >
	<a href="../rbnano2/">Blinky on RedBear Nano 2</a>
	</li>





	<li >
	<a href="../blinky_stm32f4disc/">Blinky on STM32F4-Discovery</a>
	</li>





	<li >
	<a href="../blinky_console/">Add Console and Shell to Blinky</a>
	</li>



	</ul>

	</li>







	<li ><a href="../repo/add_repos/">Work with repositories</a>


	</li>







	<li ><a href="../project-slinky/">Project Slinky for Remote Comms</a>


	</li>







	<li><a href="
	../ble_bare_bones/
	">Bluetooth Low Energy</a>


	</li>







	<li><a href="
	../lora/lorawanapp/
	">LoRa</a>


	</li>







	<li><a href="
	../event_queue/
	">OS Fundamentals</a>


	</li>







	<li><a href="
	../add_newtmgr/
	">Remote Device Management</a>


	</li>







	<li><a href="


	../sensors/sensors/

	">Sensors</a>


	</li>







	<li><a href="
	../segger_rtt/
	">Tooling</a>


	</li>







	<li><a href="
	../codesize/
	">Other</a>


	</li>



	</ul>

	</li>







	<li ><a href="../../os_user_guide/">OS User Guide</a>


	</li>







	<li><a href="
	../../../network/ble/ble_intro/
	">BLE User Guide</a>


	</li>







	<li ><a href="../../../newt/newt_intro/">Newt Tool Guide</a>


	</li>







	<li ><a href="../../../newtmgr/overview/">Newt Manager Guide</a>


	</li>





	<li >
	<a href="../../../known_issues/">Known Issues</a>
	</li>



	</ul>

	</li>







	<li><a href="
	../../../newt/install/prev_releases/
	">Appendix</a>


	</li>



	</ul>
	</div></div>

	<div class="col-md-9" role="main">
	<div class="doc-header">
	<div role="navigation" aria-label="breadcrumbs navigation">
	<ul class="wy-breadcrumbs">
	<li><a href="/documentation/">Docs</a></li>



	<li>» <a href="os/tutorials/blinky/">Project Blinky</a></li>



	<li>» <a href="os/tutorials/tutorials/">Tutorials</a></li>



	<li>» <a href="os/introduction/">Mynewt Documentation</a></li>



	<li>» Blinky on nRF52 DK</li>



	<li class="wy-breadcrumbs-aside">

	<a href="https://github.com/apache/mynewt-site/blob/master/docs/os/tutorials/nRF52.md"
	class="icon icon-github"> Edit on GitHub</a>

	</li>

	</ul>
	</div>
	</div>














	<div class="alert alert-warning">
	<p>
	Version 1.3.0 is not the most recent version of the Apache Mynewt
	documentation. Click <a href="/latest">here</a> to read the latest
	version.
	</p>
	</div>



	<h2 id="blinky-your-hello-world-on-a-nrf52-development-kit">Blinky, your "Hello World!", on a nRF52 Development Kit</h2>
	<p>This tutorial shows you how to create, build, and run the Blinky application on a nRF52 Development Kit.
	<br></p>
	<p>Note that there are several versions of the nRF52 Development Kit in the market. The boards tested with this tutorial are listed under "Prerequisites".</p>
	<p><br></p>
	<h3 id="prerequisites">Prerequisites</h3>
	<ul>
	<li>Meet the prerequisites listed in <a href="/os/tutorials/blinky.md">Project Blinky</a>.</li>
	<li>Have a nRF52 Development Kit (one of the following)<ul>
	<li>Nordic nRF52-DK Development Kit - PCA 10040</li>
	<li>Rigado BMD-300 Evaluation Kit - BMD-300-EVAL-ES</li>
	</ul>
	</li>
	<li>Install the <a href="https://www.segger.com/jlink-software.html">Segger JLINK Software and documentation pack</a>.</li>
	</ul>
	<p>This tutorial uses the Nordic nRF52-DK board.</p>
	<h3 id="create-a-project">Create a Project</h3>
	<p>Create a new project if you do not have an existing one. You can skip this step and proceed to <a href="#create_targets">create the targets</a> if you already have a project created. </p>
	<p>Run the following commands to create a new project:</p>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code> $ mkdir ~/dev
	$ cd ~/dev
	$ newt new myproj
	Downloading project skeleton from apache/mynewt-blinky...
	Installing skeleton in myproj...
	Project myproj successfully created.
	$ cd myproj
	$ newt install
	apache-mynewt-core
	$
	</code></pre></div>

	<p><br></p>
	<h3 id="create-the-targets"><a name="create_targets"></a>Create the Targets</h3>
	<p>Create two targets for the nRF52-DK board - one for the bootloader and one for the Blinky application.</p>
	<p>Run the following <code>newt target</code> commands, from your project directory, to create a bootloader target. We name the target <code>nrf52_boot</code>:</p>
	<p><font color="#F2853F">
	Note: This tutorial uses the Nordic nRF52-DK board. You must specify the correct bsp for the board you are using. </font> </p>
	<ul>
	<li>For the Nordic Dev Kit choose @apache-mynewt-core/hw/bsp/nrf52dk instead (in the highlighted lines)</li>
	<li>For the Rigado Eval Kit choose @apache-mynewt-core/hw/bsp/bmd300eval instead (in the highlighted lines)</li>
	</ul>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt target create nrf52_boot
	$ newt target set nrf52_boot app=@apache-mynewt-core/apps/boot
	<span style="background-color: #ffffcc">$ newt target set nrf52_boot bsp=@apache-mynewt-core/hw/bsp/nrf52dk
	</span>$ newt target set nrf52_boot build_profile=optimized
	</code></pre></div>

	<p><br>
	Run the following <code>newt target</code> commands to create a target for the Blinky application. We name the target <code>nrf52_blinky</code>.</p>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt target create nrf52_blinky
	$ newt target set nrf52_blinky app=apps/blinky
	<span style="background-color: #ffffcc">$ newt target set nrf52_blinky bsp=@apache-mynewt-core/hw/bsp/nrf52dk
	</span>$ newt target set nrf52_blinky build_profile=debug
	</code></pre></div>

	<p><br>
	You can run the <code>newt target show</code> command to verify the target settings:</p>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt target show
	targets/nrf52_blinky
	app=apps/blinky
	bsp=@apache-mynewt-core/hw/bsp/nrf52dk
	build_profile=debug
	targets/nrf52_boot
	app=@apache-mynewt-core/apps/boot
	bsp=@apache-mynewt-core/hw/bsp/nrf52dk
	build_profile=optimized
	</code></pre></div>

	<p><br></p>
	<h3 id="build-the-target-executables">Build the Target Executables</h3>
	<p>Run the <code>newt build nrf52_boot</code> command to build the bootloader:</p>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt build nrf52_boot
	Building target targets/nrf52_boot
	Compiling repos/apache-mynewt-core/boot/bootutil/src/image_ec256.c
	Compiling repos/apache-mynewt-core/boot/bootutil/src/image_ec.c
	Compiling repos/apache-mynewt-core/boot/bootutil/src/image_rsa.c
	Compiling repos/apache-mynewt-core/crypto/mbedtls/src/aes.c
	Compiling repos/apache-mynewt-core/boot/bootutil/src/loader.c
	Compiling repos/apache-mynewt-core/boot/bootutil/src/image_validate.c
	Compiling repos/apache-mynewt-core/boot/bootutil/src/bootutil_misc.c
	Compiling repos/apache-mynewt-core/apps/boot/src/boot.c
	...

	Archiving sys_mfg.a
	Archiving sys_sysinit.a
	Archiving util_mem.a
	Linking ~/dev/myproj/bin/targets/nrf52_boot/app/apps/boot/boot.elf
	Target successfully built: targets/nrf52_boot
	</code></pre></div>

	<p><br>
	Run the <code>newt build nrf52_blinky</code> command to build the Blinky application:</p>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt build nrf52_blinky
	Building target targets/nrf52_blinky
	Assembling repos/apache-mynewt-core/hw/bsp/nrf52dk/src/arch/cortex_m4/gcc_startup_nrf52_split.s
	Compiling repos/apache-mynewt-core/hw/bsp/nrf52dk/src/sbrk.c
	Compiling repos/apache-mynewt-core/hw/cmsis-core/src/cmsis_nvic.c
	Compiling repos/apache-mynewt-core/hw/drivers/uart/uart_hal/src/uart_hal.c
	Assembling repos/apache-mynewt-core/hw/bsp/nrf52dk/src/arch/cortex_m4/gcc_startup_nrf52.s
	Compiling apps/blinky/src/main.c

	...

	Archiving sys_mfg.a
	Archiving sys_sysinit.a
	Archiving util_mem.a
	Linking ~/dev/myproj/bin/targets/nrf52_blinky/app/apps/blinky/blinky.elf
	Target successfully built: targets/nrf52_blinky
	</code></pre></div>

	<p><br></p>
	<h3 id="sign-and-create-the-blinky-application-image">Sign and Create the Blinky Application Image</h3>
	<p>Run the <code>newt create-image nrf52_blinky 1.0.0</code> command to create and sign the application image. You may assign an arbitrary version (e.g. 1.0.0) to the image.</p>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt create-image nrf52_blinky 1.0.0
	App image succesfully generated: ~/dev/myproj/bin/targets/nrf52_blinky/app/apps/blinky/blinky.img
	</code></pre></div>

	<p><br></p>
	<h3 id="connect-to-the-board">Connect to the Board</h3>
	<ul>
	<li>Connect a micro-USB cable from your computer to the micro-USB port on the nRF52-DK board.</li>
	<li>Turn the power on the board to ON. You should see the green LED light up on the board.</li>
	</ul>
	<h3 id="load-the-bootloader-and-the-blinky-application-image">Load the Bootloader and the Blinky Application Image</h3>
	<p>Run the <code>newt load nrf52_boot</code> command to load the bootloader onto the board: </p>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt load nrf52_boot
	Loading bootloader
	$
	</code></pre></div>

	<p><br>
	Run the <code>newt load nrf52_blinky</code> command to load the Blinky application image onto the board.</p>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ newt load nrf52_blinky
	Loading app image into slot 1
	</code></pre></div>

	<p>You should see the LED1 on the board blink!</p>
	<p>Note: If the LED does not blink, try resetting your board.</p>
	<p><br></p>
	<p>If you want to erase the flash and load the image again, you can run <code>JLinkExe</code> to issue an <code>erase</code> command.</p>
	<p><strong>Note:</strong> On Windows: Run the <code>jlink</code> command with the same arguments from a Windows Command Prompt terminal.</p>
	<p><br></p>
	<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%;"><span></span><code>$ JLinkExe -device nRF52 -speed 4000 -if SWD
	SEGGER J-Link Commander V5.12c (Compiled Apr 21 2016 16:05:51)
	DLL version V5.12c, compiled Apr 21 2016 16:05:45

	Connecting to J-Link via USB...O.K.
	Firmware: J-Link OB-SAM3U128-V2-NordicSemi compiled Mar 15 2016 18:03:17
	Hardware version: V1.00
	S/N: 682863966
	VTref = 3.300V


	Type "connect" to establish a target connection, '?' for help
	J-Link>erase
	Cortex-M4 identified.
	Erasing device (0;?i?)...
	Comparing flash [100%] Done.
	Erasing flash [100%] Done.
	Verifying flash [100%] Done.
	J-Link: Flash download: Total time needed: 0.363s (Prepare: 0.093s, Compare: 0.000s, Erase: 0.262s, Program: 0.000s, Verify: 0.000s, Restore: 0.008s)
	Erasing done.
	J-Link>exit
	$
	</code></pre></div>

	<div class="row">




	<ul class="nav nav-pills" style="margin-bottom: 10px">
	<li>

	</li>
	<li class="pull-right">

	</li>
	</ul>
	</div>
	<footer class="row">
	<div class="col-xs-12">

	<p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>

	</div>
	<div class="col-xs-12">
	<div class="logos">
	<a href="https://www.apache.org/">
	<img src="/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
	</a>
	<p>
	Copyright © 2015-2021 The Apache Software Foundation.<br>
	<small class="footnote">
	Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt
	project logo are either registered trademarks or trademarks of the Apache
	Software Foundation in the United States and other countries.
	</small>
	</p>
	<a href="">
	<img src="https://www.countit.com/images/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
	</a>
	</div>
	</div>
	<a href="https://www.apache.org/licenses/">
	<button class="button-footer-asf">
	License
	</button>
	</a>
	<a href="https://www.apache.org/foundation/sponsorship.html">
	<button class="button-footer-asf">
	Sponsorship
	</button>
	</a>
	<a href="https://www.apache.org/foundation/thanks.html">
	<button class="button-footer-asf">
	Thanks
	</button>
	</a>
	<a href="https://www.apache.org/security/">
	<button class="button-footer-asf">
	Security
	</button>
	</a>
	<a href="https://apache.org/events/current-event">
	<button class="button-footer-asf">
	ASF Events
	</button>
	</a>
	</footer>
	</div>
	</div>


	</div>

	<script src="../../../js/jquery-1.10.2.min.js"></script>
	<script src="../../../js/bootstrap-3.0.3.min.js"></script>
	<script src="../../../js/highlight.pack.js"></script>
	<script src="../../../js/base.js"></script>
	<script src="../../../js/custom.js"></script>
	<script src="search/main.js"></script>

	</body>
	</html>