Lines Matching +full:zephyr +full:- +full:sdk +full:-
3 Zephyr SDK
6 The Zephyr Software Development Kit (SDK) contains toolchains for each of
7 Zephyr's supported architectures. It also includes additional host tools, such
10 Use of the Zephyr SDK is highly recommended and may even be required under
16 The Zephyr SDK supports the following target architectures:
18 * ARC (32-bit and 64-bit; ARCv1, ARCv2, ARCv3)
19 * ARM (32-bit and 64-bit; ARMv6, ARMv7, ARMv8; A/R/M Profiles)
20 * MIPS (32-bit and 64-bit)
22 * RISC-V (32-bit and 64-bit; RV32I, RV32E, RV64I)
23 * x86 (32-bit and 64-bit)
31 The Zephyr SDK bundle supports all major operating systems (Linux, macOS and
34 script. Additional OS-specific instructions are described in the sections below.
36 If no toolchain is selected, the build system looks for Zephyr SDK and uses the toolchain
38 :envvar:`ZEPHYR_TOOLCHAIN_VARIANT` to ``zephyr``.
40 If you install the Zephyr SDK outside any of the default locations (listed in
42 of the Zephyr SDK, then you must register the Zephyr SDK in the CMake package registry
43 by running the setup script. If you decide not to register the Zephyr SDK in the CMake registry,
44 then the :envvar:`ZEPHYR_SDK_INSTALL_DIR` can be used to point to the Zephyr SDK installation
48 containing multiple Zephyr SDKs, allowing for automatic toolchain selection. For
52 * ``/company/tools/zephyr-sdk-0.13.2``
53 * ``/company/tools/zephyr-sdk-a.b.c``
54 * ``/company/tools/zephyr-sdk-x.y.z``
56 This allows the Zephyr build system to choose the correct version of the SDK,
57 while allowing multiple Zephyr SDKs to be grouped together at a specific path.
61 Zephyr SDK version compatibility
64 In general, the Zephyr SDK version referenced in this page should be considered
65 the recommended version for the corresponding Zephyr version.
67 For the full list of compatible Zephyr and Zephyr SDK versions, refer to the
68 `Zephyr SDK Version Compatibility Matrix`_.
72 Zephyr SDK installation
77 .. note:: You can change |sdk-version-literal| to another version in the instructions below
78 if needed; the `Zephyr SDK Releases`_ page contains all available
79 SDK releases.
81 .. note:: If you want to uninstall the SDK, you may simply remove the directory
86 .. group-tab:: Ubuntu
90 #. Download and verify the `Zephyr SDK bundle`_:
92 .. parsed-literal::
95 wget |sdk-url-linux|
96 wget -O - |sdk-url-linux-sha| | shasum --check --ignore-missing
98 If your host architecture is 64-bit ARM (for example, Raspberry Pi), replace ``x86_64``
99 with ``aarch64`` in order to download the 64-bit ARM Linux SDK.
101 #. Extract the Zephyr SDK bundle archive:
103 .. parsed-literal::
105 tar xvf zephyr-sdk- |sdk-version-trim| _linux-x86_64.tar.xz
108 It is recommended to extract the Zephyr SDK bundle at one of the following locations:
117 The Zephyr SDK bundle archive contains the ``zephyr-sdk-<version>``
119 installation path will be ``$HOME/zephyr-sdk-<version>``.
121 #. Run the Zephyr SDK bundle setup script:
123 .. parsed-literal::
125 cd zephyr-sdk- |sdk-version-ltrim|
129 You only need to run the setup script once after extracting the Zephyr SDK bundle.
131 You must rerun the setup script if you relocate the Zephyr SDK bundle directory after
135 allow you to flash most Zephyr boards as a regular user:
137 .. parsed-literal::
139 …sudo cp ~/zephyr-sdk- |sdk-version-trim| /sysroots/x86_64-pokysdk-linux/usr/share/openocd/contrib/…
140 sudo udevadm control --reload
142 .. group-tab:: macOS
146 #. Download and verify the `Zephyr SDK bundle`_:
148 .. parsed-literal::
151 curl -L -O |sdk-url-macos|
152 curl -L |sdk-url-macos-sha| | shasum --check --ignore-missing
154 If your host architecture is 64-bit ARM (Apple Silicon), replace
155 ``x86_64`` with ``aarch64`` in order to download the 64-bit ARM macOS SDK.
157 #. Extract the Zephyr SDK bundle archive:
159 .. parsed-literal::
161 tar xvf zephyr-sdk- |sdk-version-trim| _macos-x86_64.tar.xz
164 It is recommended to extract the Zephyr SDK bundle at one of the following locations:
173 The Zephyr SDK bundle archive contains the ``zephyr-sdk-<version>``
175 installation path will be ``$HOME/zephyr-sdk-<version>``.
177 #. Run the Zephyr SDK bundle setup script:
179 .. parsed-literal::
181 cd zephyr-sdk- |sdk-version-ltrim|
185 You only need to run the setup script once after extracting the Zephyr SDK bundle.
187 You must rerun the setup script if you relocate the Zephyr SDK bundle directory after
190 .. group-tab:: Windows
196 #. Download the `Zephyr SDK bundle`_:
198 .. parsed-literal::
201 wget |sdk-url-windows|
203 #. Extract the Zephyr SDK bundle archive:
205 .. parsed-literal::
207 7z x zephyr-sdk- |sdk-version-trim| _windows-x86_64.7z
210 It is recommended to extract the Zephyr SDK bundle at one of the following locations:
215 The Zephyr SDK bundle archive contains the ``zephyr-sdk-<version>``
217 installation path will be ``%HOMEPATH%\zephyr-sdk-<version>``.
219 #. Run the Zephyr SDK bundle setup script:
221 .. parsed-literal::
223 cd zephyr-sdk- |sdk-version-ltrim|
227 You only need to run the setup script once after extracting the Zephyr SDK bundle.
229 You must rerun the setup script if you relocate the Zephyr SDK bundle directory after
232 .. _Zephyr SDK Releases: https://github.com/zephyrproject-rtos/sdk-ng/tags
233 .. _Zephyr SDK Version Compatibility Matrix: https://github.com/zephyrproject-rtos/sdk-ng/wiki/Zeph…