Home Explore Help
Sign In
RT-Thread-packages
/
esp-idf
mirror of https://github-proxy.rt-thread.io/RT-Thread-packages/esp-idf.git
2
0
Fork 0
Files Issues 0 Wiki
Tree: a3cbc57c19
Branches Tags
esp-idf
/
docs
/
en
/
get-started
/
linux-setup.rst

linux-setup.rst 2.4 KB
History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364 
  1. *********************************************
    2. 

  2. Standard Setup of Toolchain for Linux
    3. 

  3. *********************************************
    4. 

  4. 

  5. :link_to_translation:`zh_CN:[中文]`
    6. 

  6. 

  7. Install Prerequisites
    8. 

  8. =====================
    9. 

  9. 

  10. To compile with ESP-IDF you need to get the following packages:
    11. 

  11. 

  12. - CentOS 7::
    13. 

  13. 

  14.     sudo yum install git wget ncurses-devel flex bison gperf python pyserial python-pyelftools cmake ninja-build ccache
    15. 

  15. 

  16. - Ubuntu and Debian::
    17. 

  17. 

  18.     sudo apt-get install git wget libncurses-dev flex bison gperf python python-pip python-setuptools python-serial python-click python-cryptography python-future python-pyparsing python-pyelftools cmake ninja-build ccache
    19. 

  19. 

  20. - Arch::
    21. 

  21. 

  22.     sudo pacman -S --needed gcc git make ncurses flex bison gperf python2-pip python2-pyserial python2-click python2-cryptography python2-future python2-pyparsing python2-pyelftools cmake ninja ccache
    23. 

  23. 

  24. .. note::
    25. 

  25.     CMake version 3.5 or newer is required for use with ESP-IDF. Older Linux distributions may require updating, enabling of a "backports" repository, or installing of a "cmake3" package rather than "cmake".
    26. 

  26. 

  27. Additional Tips
    28. 

  28. ===============
    29. 

  29. 

  30. Permission issues /dev/ttyUSB0
    31. 

  31. ------------------------------
    32. 

  32. 

  33. With some Linux distributions you may get the ``Failed to open port /dev/ttyUSB0`` error message when flashing the ESP32. :ref:`This can be solved by adding the current user to the dialout group<linux-dialout-group>`.
    34. 

  34. 

  35. ncurses 5 dependency
    36. 

  36. --------------------
    37. 

  37. 

  38. To run the precompiled gdb (xtensa-esp32-elf-gdb) in Linux requires ncurses 5, but some newer distributions only provide ncurses 6 by default.
    39. 

  39. 

  40. Consult your distribution's documentation to see if ncurses 5 libraries are available. Alternatively, use crosstool-NG to compile a gdb that links against ncurses 6.
    41. 

  41. 

  42. For Arch Linux users, ncurses 5 libraries are available in AUR_ for native and lib32 configurations:
    43. 

  43. 

  44. - https://aur.archlinux.org/packages/ncurses5-compat-libs/
    45. 

  45. - https://aur.archlinux.org/packages/lib32-ncurses5-compat-libs/
    46. 

  46. 

  47. Before installing these packages you might need to add the author's public key to your keyring as described in the "Comments" section at the links above.
    48. 

  48. 

  49. Next Steps
    50. 

  50. ==========
    51. 

  51. 

  52. To carry on with development environment setup, proceed to :ref:`get-started-get-esp-idf`.
    53. 

  53. 

  54. 

  55. Related Documents
    56. 

  56. =================
    57. 

  57. 

  58. .. toctree::
    59. 

  59.     :maxdepth: 1
    60. 

  60. 

  61.     linux-setup-scratch
    62. 

  62. 

  63. 

  64. .. _AUR: https://wiki.archlinux.org/index.php/Arch_User_Repository
    65.