Lines Matching +full:add +full:- +full:apt +full:- +full:repository
8 - Set up a command-line Zephyr development environment on Ubuntu, macOS, or
11 - Get the source code
12 - Build, flash, and run a sample application
23 .. group-tab:: Ubuntu
28 .. code-block:: bash
30 sudo apt update
31 sudo apt upgrade
33 .. group-tab:: macOS
39 <https://support.apple.com/en-us/HT201541>`_.
41 .. group-tab:: Windows
46 .. _install-required-tools:
55 .. list-table::
56 :header-rows: 1
58 * - Tool
59 - Min. Version
61 * - `CMake <https://cmake.org/>`_
62 - 3.20.5
64 * - `Python <https://www.python.org/>`_
65 - 3.10
67 * - `Devicetree compiler <https://www.devicetree.org/>`_
68 - 1.4.6
72 .. group-tab:: Ubuntu
76 #. If using an Ubuntu version older than 22.04, it is necessary to add extra
79 the Kitware archive script to add the Kitware APT repository to your
81 A detailed explanation of ``kitware-archive.sh`` can be found here
82 `kitware third-party apt repository <https://apt.kitware.com/>`_:
84 .. code-block:: bash
86 wget https://apt.kitware.com/kitware-archive.sh
87 sudo bash kitware-archive.sh
89 #. Use ``apt`` to install the required dependencies:
91 .. code-block:: bash
93 sudo apt install --no-install-recommends git cmake ninja-build gperf \
94 ccache dfu-util device-tree-compiler wget \
95 python3-dev python3-pip python3-setuptools python3-tk python3-wheel xz-utils file \
96 make gcc gcc-multilib g++-multilib libsdl2-dev libmagic1
100 .. code-block:: bash
102 cmake --version
103 python3 --version
104 dtc --version
110 .. group-tab:: macOS
116 .. code-block:: bash
118 … /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
120 #. After the Homebrew installation script completes, follow the on-screen
121 instructions to add the Homebrew installation to the path.
125 .. code-block:: bash
134 .. code-block:: bash
136 brew install cmake ninja gperf python3 python-tk ccache qemu dtc libmagic wget openocd
138 #. Add the Homebrew Python folder to the path, in order to be able to
141 .. code-block:: bash
143 … (echo; echo 'export PATH="'$(brew --prefix)'/opt/python/libexec/bin:$PATH"') >> ~/.zprofile
146 .. group-tab:: Windows
153 <https://msdn.microsoft.com/en-us/commandline/wsl/install_guide>`_
174 type ``cmd.exe``, right-click the :guilabel:`Command Prompt` search result, and choose
180 .. code-block:: bat
182 choco feature enable -n allowGlobalConfirmation
186 .. code-block:: bat
188 choco install cmake --installargs 'ADD_CMAKE_TO_PATH=System'
189 choco install ninja gperf python311 git dtc-msys2 wget 7zip
202 .. _clone-zephyr:
217 .. group-tab:: Ubuntu
219 #. Use ``apt`` to install Python ``venv`` package:
221 .. code-block:: bash
223 sudo apt install python3-venv
227 .. code-block:: bash
229 python3 -m venv ~/zephyrproject/.venv
233 .. code-block:: bash
248 .. code-block:: bash
254 .. code-block:: bash
264 .. code-block:: bash
266 west zephyr-export
271 .. code-block:: bash
273 west packages pip --install
275 .. group-tab:: macOS
279 .. code-block:: bash
281 python3 -m venv ~/zephyrproject/.venv
285 .. code-block:: bash
300 .. code-block:: bash
306 .. code-block:: bash
316 .. code-block:: bash
318 west zephyr-export
323 .. code-block:: bash
325 west packages pip --install
327 .. group-tab:: Windows
333 .. code-block:: bat
336 python -m venv zephyrproject\.venv
340 .. code-block:: bat
355 .. code-block:: bat
361 .. code-block:: bat
371 .. code-block:: bat
373 west zephyr-export
378 .. code-block:: bat
380 west packages pip --install
396 .. group-tab:: Ubuntu
400 .. code-block:: bash
409 See ``west sdk install --help`` for details.
411 .. group-tab:: macOS
415 .. code-block:: bash
424 See ``west sdk install --help`` for details.
426 .. group-tab:: Windows
430 .. code-block:: bat
439 See ``west sdk install --help`` for details.
453 :zephyr:code-sample:`blinky` is compatible with most, but not all, :ref:`boards`. If your board
454 does not meet Blinky's :ref:`blinky-sample-requirements`, then
455 :zephyr:code-sample:`hello_world` is a good alternative.
460 Build the :zephyr:code-sample:`blinky` with :ref:`west build <west-building>`, changing
461 ``<your-board-name>`` appropriately for your board:
465 .. group-tab:: Ubuntu
467 .. code-block:: bash
470 west build -p always -b <your-board-name> samples/basic/blinky
472 .. group-tab:: macOS
474 .. code-block:: bash
477 west build -p always -b <your-board-name> samples/basic/blinky
479 .. group-tab:: Windows
481 .. code-block:: bat
484 west build -p always -b <your-board-name> samples\basic\blinky
486 The ``-p always`` option forces a pristine build, and is recommended for new
487 users. Users may also use the ``-p auto`` option, which will use
497 For example to build :zephyr:code-sample:`blinky` for the ``cpuapp`` core on
508 Then flash the sample using :ref:`west flash <west-flashing>`:
510 .. code-block:: shell
516 You may need to install additional :ref:`host tools <flash-debug-host-tools>`
524 Please also see :ref:`setting-udev-rules`.
528 .. figure:: img/ReelBoard-Blinky.png
530 :name: reelboard-blinky
539 * Try other :zephyr:code-sample-category:`samples`
541 * Find out about west's :ref:`flashing and debugging <west-build-flash-debug>`
543 * Check out :ref:`beyond-GSG` for additional setup alternatives and ideas
544 * Discover :ref:`project-resources` for getting help from the Zephyr
609 .. _GitHub issues: https://github.com/zephyrproject-rtos/zephyr/issues