从零开始设置 Linux 环境下的工具链

[English]

注解

安装工具链的标准流程可以通过阅读文档 Linux 平台工具链的标准设置 来获得,工具链的自定义设置 章节会介绍哪些情况下我们必须要重新定义工具链。

安装必要的工具

要想使用 ESP-IDF 进行编译,您需要获取以下软件包:

  • Ubuntu 和 Debian:

    sudo apt-get install git wget libncurses-dev flex bison gperf python3 python3-pip python3-setuptools python3-serial python3-cryptography python3-future python3-pyparsing python3-pyelftools cmake ninja-build ccache libffi-dev libssl-dev
    
  • Arch:

    sudo pacman -Sy --needed gcc git make ncurses flex bison gperf python-pyserial python-cryptography python-future python-pyparsing python-pyelftools cmake ninja ccache
    

注解

一些旧的(2014年之前)Linux 发行版中使用的 pyserial 版本可能是 2.x , ESP-IDF并不支持。 在这种情况下,请参考 安装依赖的 Python 软件包 章节,通过 pip 工具来安装支持的版本。

从源代码编译工具链

  • 安装依赖:

    • CentOS 7:

      sudo yum install gawk gperf grep gettext ncurses-devel python3 python3-devel automake bison flex texinfo help2man libtool
      
    • Ubuntu pre-16.04:

      sudo apt-get install gawk gperf grep gettext libncurses-dev python python-dev automake bison flex texinfo help2man libtool
      
    • Ubuntu 16.04:

      sudo apt-get install gawk gperf grep gettext python python-dev automake bison flex texinfo help2man libtool libtool-bin
      
    • Debian 9:

      sudo apt-get install gawk gperf grep gettext libncurses-dev python python-dev automake bison flex texinfo help2man libtool libtool-bin
      
    • Arch:

      sudo pacman -Sy --needed python-pip
      

新建工作目录,然后进入:

mkdir -p ~/esp
cd ~/esp

下载 crosstool-NG 然后编译:

git clone -b xtensa-1.22.x https://github.com/espressif/crosstool-NG.git
cd crosstool-NG
./bootstrap && ./configure --enable-local && make install

编译工具链:

./ct-ng xtensa-esp32-elf
./ct-ng build
chmod -R u+w builds/xtensa-esp32-elf

编译得到的工具链会被保存到 ~/esp/crosstool-NG/builds/xtensa-esp32-elf。根据 Linux 下设置环境变量的标准方法 中的介绍,将工具链添加到 PATH 中。

停用 Python 2

Python 2 已经 结束生命周期,ESP-IDF 很快将不再支持 Python 2。请安装 Python 3.6 或以上版本。可参考上面列出的目前主流 Linux 发行版的安装说明。

下一步

继续设置开发环境,请前往 获取 ESP-IDF 章节。