doc: rewrite SES installation info

Reworked SES installation section. Added licence registering info.

Signed-off-by: Grzegorz Ferenc <[email protected]>

Author: greg-fer

doc/nrf/gs_ins_linux.rst

@@ -62,6 +62,14 @@ If you use Ubuntu, install v1.4.7 from Cosmic by entering the following commands
 
 
 
+.. _installing_ses_linux:
+
+.. include:: gs_ins_windows.rst
+   :start-after: installing_ses_start
+   :end-before: installing_ses_end
+
+
+
 .. _build_environment_linux:
 
 .. include:: gs_ins_windows.rst

doc/nrf/gs_ins_mac.rst

@@ -51,6 +51,14 @@ Install Homebrew and install the required tools using the ``brew`` command line
 
 
 
+.. _installing_ses_mac:
+
+.. include:: gs_ins_windows.rst
+   :start-after: installing_ses_start
+   :end-before: installing_ses_end
+
+
+
 .. _build_environment_mac:
 
 .. include:: gs_ins_windows.rst

doc/nrf/gs_ins_windows.rst

@@ -265,6 +265,54 @@ To install those, open a |bash| in the ``ncs`` folder and enter the following co
 
 .. add_deps_end
 
+.. _installing_ses_win:
+
+.. installing_ses_start
+
+Installing |SES|
+****************
+
+You must install a special version of |SES| (SES) to be able to open and compile projects in the |NCS|.
+
+|SES| is free of charge for use with Nordic Semiconductor devices.
+
+To install |SES|, complete the following steps:
+
+1. Download the package for your operating system from the following links:
+
+    * `SEGGER Embedded Studio (Nordic Edition) - Windows x86`_
+    * `SEGGER Embedded Studio (Nordic Edition) - Windows x64`_
+    * `SEGGER Embedded Studio (Nordic Edition) - Mac OS x64`_
+    * `SEGGER Embedded Studio (Nordic Edition) - Linux x86`_
+    * `SEGGER Embedded Studio (Nordic Edition) - Linux x64`_
+
+#. Extract the downloaded package in the directory of your choice.
+#. Register and activate a free license.
+   |SES| is free of charge for use with Nordic Semiconductor devices, but you still need to request and activate a license.
+   Complete the following steps:
+
+    a. Run the file :file:`bin/emStudio`.
+       |SES| will open the Dashboard window and inform you about the missing license.
+
+        .. figure:: images/ses_license.PNG
+           :alt: SEGGER Embedded Studio Dashboard notification about missing license
+
+           No commercial-use license detected SES prompt
+
+    #. Click :guilabel:`Activate Your Free License`.
+       A request form appears.
+
+    #. Fill in your information and click :guilabel:`Request License`.
+       The license is sent to you in an email.
+
+    #. After you receive your license key, click :guilabel:`Enter Activation Key` to activate the license.
+
+    #. Copy-paste the license key and click :guilabel:`Install License`.
+       The license activation window will close and SES will open the Project Explorer window.
+
+
+
+.. installing_ses_end
 
 .. _build_environment_win:
 
@@ -273,8 +321,41 @@ To install those, open a |bash| in the ``ncs`` folder and enter the following co
 Setting up the build environment
 ********************************
 
+Before you start :ref:`building and programming a sample application <gs_programming>`, you must set up your build environment.
+
+Setting up the SES environment
+==============================
+
+If you plan to :ref:`build with SEGGER Embedded Studio <gs_programming_ses>`, the first time you import an |NCS| project, SES will prompt you to set the paths to the Zephyr Base directory and the GNU ARM Embedded Toolchain.
+This must be done only once per project.
+
+Complete the following steps to set up the |SES| environment:
+
+1. Run the file :file:`bin/emStudio`.
+
+#. Select :guilabel:`File` -> :guilabel:`Open nRF Connect SDK Project`.
+
+    .. figure:: images/ses_open.png
+       :alt: Open nRF Connect SDK Project menu
+
+       Open nRF Connect SDK Project menu
+
+#. Set the Zephyr Base directory to the full path to ``ncs\zephyr``.
+   The GNU ARM Embedded Toolchain directory is the directory where you installed the toolchain (for example, ``c:\gnuarmemb``).
+
+    .. figure:: images/ses_notset.png
+       :alt: Zephyr Base Not Set prompt
+
+       Zephyr Base Not Set prompt
+
+
+If you want to change these settings later, click :guilabel:`Tools` -> :guilabel:`Options` and select the :guilabel:`nRF Connect` tab (see :ref:`ses_options_figure`).
+
+
+Setting up the command line build environment
+=============================================
+
 If you want to build and program your applications from the command line, you must set up your build environment by defining the required environment variables every time you open a new |bash|.
-If you plan to :ref:`build with SEGGER Embedded Studio <gs_programming>`, you can skip this step.
 
 To define the environment variables, navigate to the ``ncs`` folder and enter the following command: |envfile|
 

doc/nrf/gs_programming.rst

@@ -6,28 +6,19 @@ Building and programming a sample application
 The recommended way of building and programming an |NCS| sample is to use
 the Nordic Edition of the SEGGER Embedded Studio (SES) IDE.
 
-SEGGER Embedded Studio is free of charge for use with Nordic Semiconductor
-devices. After downloading it, you can register and activate a free license.
-
 
 .. note::
 	If you prefer to build your applications from the command line,
 	see :ref:`zephyr:getting_started_run_sample`.
 
+.. _gs_programming_ses:
+
 Building with SES
 *****************
 
-You must install a special version of SEGGER Embedded Studio to be able to open
-and compile the projects in the |NCS|.
-You can download it from the following links:
+Complete the following steps to build |NCS| projects with SES after :ref:`installing SEGGER Embedded Studio <installing_ses_win>` and :ref:`completing the first time setup <build_environment_win>`:
 
-* `SEGGER Embedded Studio (Nordic Edition) - Windows x86`_
-* `SEGGER Embedded Studio (Nordic Edition) - Windows x64`_
-* `SEGGER Embedded Studio (Nordic Edition) - Mac OS x64`_
-* `SEGGER Embedded Studio (Nordic Edition) - Linux x86`_
-* `SEGGER Embedded Studio (Nordic Edition) - Linux x64`_
-
-1. Extract the downloaded package and run the file :file:`bin/emStudio`.
+1. Run the file :file:`bin/emStudio`.
 
 #. Select **File -> Open nRF Connect SDK Project**.
 
@@ -36,17 +27,6 @@ You can download it from the following links:
 
        Open nRF Connect SDK Project menu
 
-#. The first time you import an |NCS| project, SES will prompt you to set the paths to the Zephyr Base directory and the GNU ARM Embedded Toolchain.
-   Set the Zephyr Base directory to the full path to ``ncs\zephyr``.
-   The GNU ARM Embedded Toolchain directory is the directory where you installed the toolchain (for example, ``c:\gnuarmemb``).
-
-    .. figure:: images/ses_notset.png
-       :alt: Zephyr Base Not Set prompt
-
-       Zephyr Base Not Set prompt
-
-   If you want to change these settings later, click **Tools -> Options** and select the **nRF Connect** tab (see :ref:`ses_options_figure`).
-
 #. To import a project into SES, you must specify the following information:
 
 	- **CMakeLists.txt** - the location of the :file:`CMakeLists.txt` project file of the sample that you want to work with