Skip to content

Commit 16b192d

Browse files
greg-feranangl
authored andcommitted
doc: install: pre-packaged sdk and toolchain
Edit Install toolchain section to better accound for pre-packaged SDK and Toolchain option in the extension. VSC-3082. Signed-off-by: Grzegorz Ferenc <[email protected]>
1 parent f7e073c commit 16b192d

File tree

1 file changed

+19
-15
lines changed

1 file changed

+19
-15
lines changed

doc/nrf/installation/install_ncs.rst

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -98,24 +98,27 @@ Depending on your preferred development environment, complete the following step
9898
.. note::
9999
If you prefer, you can now `start VS Code walkthrough`_ and install the toolchain and the SDK from there.
100100

101-
1. Open the nRF Connect extension in |VSC| by clicking its icon in the :guilabel:`Activity Bar`.
102-
#. In the extension's :guilabel:`Welcome View`, click on :guilabel:`Manage toolchains`.
103-
The list of actions appears in the |VSC|'s quick pick.
104-
#. Click :guilabel:`Install Toolchain`.
105-
The list of available stable toolchain versions appears in the |VSC|'s quick pick.
106-
#. Select the toolchain version to install.
107-
The toolchain version should match the |NCS| version you are going to work with.
108-
|install_latest_version|
101+
You can install the toolchain together with or separately from the SDK code:
109102

110-
.. note::
111-
If you have received a custom URL for installing the toolchain, you can provide it using the :guilabel:`Change Toolchain Index` button in the quick pick's header (wrench icon).
112-
If you are working with a development tag, disable the filter in the quick pick's header to list all available toolchains.
103+
* When you install the toolchain together with the SDK code, you can download a pre-packaged bundle from the Nordic Semiconductor server that installs both the SDK and the toolchain.
104+
Skip to :ref:`cloning_the_repositories` step now.
105+
* When you install the toolchain separately from the SDK code, you can later install the SDK code from a GitHub tag.
106+
To install the toolchain separately from the SDK code, complete the following steps:
113107

114-
The toolchain installation starts in the background, as can be seen in the notification that appears.
108+
1. Open the nRF Connect extension in |VSC| by clicking its icon in the :guilabel:`Activity Bar`.
109+
#. In the extension's :guilabel:`Welcome View`, click on :guilabel:`Manage toolchains`.
110+
The list of actions appears in the |VSC|'s quick pick.
111+
#. Click :guilabel:`Install toolchain`.
112+
The list of available stable toolchain versions appears in the |VSC|'s quick pick.
113+
#. Select the toolchain version to install.
114+
The toolchain version should match the |NCS| version you are going to work with.
115+
|install_latest_version|
115116

116-
When you install the toolchain for the first time, the installed version is automatically selected for your project.
117+
.. note::
118+
If you have received a custom URL for installing the toolchain, you can provide it using the :guilabel:`Change Toolchain Index` button in the quick pick's header (wrench icon).
119+
If you are working with a development tag, disable the filter in the quick pick's header to list all available toolchains.
117120

118-
After installing the toolchain, you can access the :guilabel:`Install Toolchain` option by clicking on :guilabel:`Manage toolchains`.
121+
The toolchain installation starts in the background, as can be seen in the notification that appears.
119122

120123
.. group-tab:: Command line
121124

@@ -236,7 +239,8 @@ For more information about the repository and development model, see the :ref:`d
236239
#. Select the SDK type to install.
237240
The list of available stable SDK versions for the selected SDK type appears in the |VSC|'s quick pick, grouped into two categories:
238241

239-
* Pre-packaged SDKs - Bundled by Nordic Semiconductor.
242+
* Pre-packaged SDKs & Toolchains - Available on the Nordic Semiconductor server.
243+
The package downloads both the SDK and Toolchain, but skips the Toolchain if you have it already installed.
240244
Available mostly for stable releases and some preview tags.
241245
Recommended for faster and more reliable download and installation.
242246
* GitHub - Taken from the `nRF Connect by Nordic Semiconductor GitHub organization <nrfconnect GitHub organization_>`_.

0 commit comments

Comments
 (0)