1********************************************************
2Standard Setup of Toolchain for Mac OS (Legacy GNU Make)
3********************************************************
4:link_to_translation:`zh_CN:[中文]`
5
6.. include:: ../gnu-make-legacy.rst
7
8Install Prerequisites
9=====================
10
11- install pip::
12
13    sudo easy_install pip
14
15.. note::
16
17    ``pip`` will be used later for installing :ref:`the required Python packages <get-started-get-packages-legacy>`.
18
19Toolchain Setup
20===============
21
22.. include-build-file:: inc/download-links.inc
23
24ESP32 toolchain for macOS is available for download from Espressif website:
25
26|download_link_osx|
27
28Download this file, then extract it in ``~/esp`` directory:
29
30.. include-build-file:: inc/unpack-code-osx.inc
31
32.. _setup-macos-toolchain-add-it-to-path-legacy:
33
34The toolchain will be extracted into ``~/esp/xtensa-esp32-elf/`` directory.
35
36To use it, you will need to update your ``PATH`` environment variable in ``~/.profile`` file. To make ``xtensa-esp32-elf`` available for all terminal sessions, add the following line to your ``~/.profile`` file::
37
38    export PATH=$HOME/esp/xtensa-esp32-elf/bin:$PATH
39
40Alternatively, you may create an alias for the above command. This way you can get the toolchain only when you need it. To do this, add different line to your ``~/.profile`` file::
41
42    alias get_esp32="export PATH=$HOME/esp/xtensa-esp32-elf/bin:$PATH"
43
44Then when you need the toolchain you can type ``get_esp32`` on the command line and the toolchain will be added to your ``PATH``.
45
46
47Next Steps
48==========
49
50To carry on with development environment setup, proceed to section :ref:`get-started-get-esp-idf-legacy`.
51
52
53Related Documents
54=================
55
56.. toctree::
57    :maxdepth: 1
58
59    macos-setup-scratch
60