This is an old revision of the document!
小贴士
1. 项目目录统一为~/ESP/下，“~”代表用户文件夹。
2. 如果无特殊说明，$代表当前用户下执行的命令。
3. Windows下的串口号以映射到msys2中的为准。
4. 默认工程esp-idf路径为用户目录／ESP／esp-idf。
准备工作
1.一台PC，系统可以是Windows，macOS，Linux。
2. ESP32编译工具链。
3. 下载ESP-IDF工程。
4. 一个你喜欢的编辑器工具，例如ATOM，VSCODE，Eclipse。
5. 连接AIR的USB线到电脑。
安装串口驱动
串口是下载调试ESP32的不二之选，按照自己的操作系统下载驱动程序：
- Linux：系统自带
安装完后，检查是否正确识别串口：
macOS下：
$ ls /dev/cu.* /dev/cu.Bluetooth-Incoming-Port /dev/cu.SLAB_USBtoUART
Linux下：
$ ls /dev/ttyUSB* /dev/ttyUSB0
windows下： 在计算机管理→设备管理器中可以查看：
安装交叉编译工具链
交叉编译工具可以运行在三个系统平台上，但安装过程有些区别，下面我们区分系统来讲解。
macOS
终端中安装xcode command line tool
xcode-select --install
接下来按照引导步骤一步一步安装即可。
安装homebrew homebrew是mac上很好用的一款软件包管理工具 homebrew官网：https://brew.sh 安装方法：打开终端，将如下命令拷贝到终端后回车执行：
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
安装编译依赖包 终端执行命令：
$ brew install gnu-sed gawk binutils gperftools gettext wget help2man libtool autoconf automaake git
安装python的串口扩展：
$ pip install pyserial
下载安装编译工具链 假设我们要把工具链放到本用户目录的ESP文件夹下，创建文件夹：
$ mkdir ~/ESP $ cd ESP $ pwd /Users/mango/ESP
用wget命令下载工具链到此并解压：
$ wget https://dl.espressif.com/dl/xtensa-esp32-elf-osx-1.22.0-61-gab8375a-5.2.0.tar.gz $ tar xzf xtensa-esp32-elf-osx-1.22.0-61-gab8375a-5.2.0.tar.gz $ ls xtensa-esp32-elf xtensa-esp32-elf-osx-1.22.0-61-gab8375a-5.2.0.tar.gz
添加环境变量，这一步就是告诉电脑在使用到esp的命令行时知道去~/ESP/xtensa-esp32-elf/bin中找。编辑~/.bash_profile，在末尾添加如下两行后保存：
export PATH=$PATH:$HOME/ESP/xtensa-esp32-elf/bin export IDF_PATH=$HOME/ESP/esp-idf
用source命令使生效：
$ source ~/.bash_profile
用gcc命令验证是否成功，提示如下算成功，否则会提示找不到此命令，这时你就要仔细看看是否哪里目录设置不对。
$ xtensa-esp32-elf-gcc -v Using built-in specs. ...... gcc version 5.2.0 (crosstool-NG crosstool-ng-1.22.0-61-gab8375a)