windows-setup.rst 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. ***************************************
  2. Standard Setup of Toolchain for Windows
  3. ***************************************
  4. Introduction
  5. ============
  6. Windows doesn't have a built-in "make" environment, so as well as installing the toolchain you will need a GNU-compatible environment. We use the MSYS2_ environment to provide this. You don't need to use this environment all the time (you can use :doc:`Eclipse <eclipse-setup>` or some other front-end), but it runs behind the scenes.
  7. Toolchain Setup
  8. ===============
  9. The quick setup is to download the Windows all-in-one toolchain & MSYS zip file from dl.espressif.com:
  10. https://dl.espressif.com/dl/esp32_win32_msys2_environment_and_toolchain-20170330.zip
  11. Unzip the zip file to ``C:\`` (or some other location, but this guide assumes ``C:\``) and it will create an ``msys32`` directory with a pre-prepared environment.
  12. Check it Out
  13. ============
  14. Open a MSYS2 MINGW32 terminal window by running ``C:\msys32\mingw32.exe``. The environment in this window is a bash shell.
  15. .. figure:: ../_static/msys2-terminal-window.png
  16. :align: center
  17. :alt: MSYS2 MINGW32 shell window
  18. :figclass: align-center
  19. MSYS2 MINGW32 shell window
  20. Use this window in the following steps setting up development environment for ESP32.
  21. Next Steps
  22. ==========
  23. To carry on with development environment setup, proceed to section :ref:`get-started-get-esp-idf`.
  24. Related Documents
  25. =================
  26. .. toctree::
  27. :maxdepth: 1
  28. windows-setup-scratch
  29. .. _MSYS2: https://msys2.github.io/