首次在macOS上搭建ESP32环境及解决串口连接故障

1. macOS上正确搭建ESP32开发环境 #

方案A：使用ESP-IDF（官方原生框架） #

• 安装Homebrew（若未安装）：

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

• 安装依赖工具：

  brew install cmake ninja dfu-util
  

• 克隆ESP-IDF仓库并初始化：

  git clone --recursive https://github.com/espressif/esp-idf.git
  cd esp-idf
  ./install.sh esp32
  

• 设置环境变量（每次打开终端都需执行，或添加到shell配置文件）：

  . ./export.sh
  

方案B：使用Arduino IDE（适合快速上手） #

• 打开Arduino IDE，进入文件 > 首选项，在附加开发板管理器网址中添加：

  https://dl.espressif.com/dl/package_esp32_index.json
  

• 进入工具 > 开发板 > 开发板管理器，搜索esp32并安装最新版的ESP32板包。

2. 识别ESP32对应的正确串口 #

• 精准定位步骤：
  1. 断开ESP32开发板，在终端执行：

     ls /dev/cu.*
     

     记录当前列出的所有设备。
  2. 重新连接ESP32，再次执行上述命令，对比两次结果，新增的设备即为ESP32的串口（通常为/dev/cu.usbmodemXXXX或/dev/cu.SLAB_USBtoUART）。
• 解决Resource is busy错误：
  该提示说明串口被其他程序占用，需关闭所有可能占用串口的应用（如Arduino IDE的串口监视器、其他终端串口工具、串口调试软件等），再重新尝试连接。

3. CP210x驱动的安装判断与步骤 #

• 是否需要安装：
  ESP32开发板的串口芯片常见有CP210x、CH340、FTDI三种。若你的开发板使用CP210x芯片（可查看板上串口模块的标识），macOS 10.14及以上版本通常自带驱动，但如果无法识别串口，仍需手动安装。
• 安装步骤：
  1. 下载对应版本的CP210x驱动。
  2. 打开下载的dmg镜像文件，运行安装程序。
  3. 安装完成后重启电脑，重新连接ESP32，再次检查串口是否正常识别。

额外解决screen命令的"Sorry, could not find a PTY"错误 #

若关闭占用程序后仍出现该错误，可尝试以下方法：

• 更换串口工具：使用Arduino IDE的串口监视器，或安装minicom（通过brew install minicom安装），执行命令：

  minicom -D /dev/cu.usbmodem14301 -b 115200
  

• 检查权限：确保当前用户对串口设备有读写权限，可执行：

  sudo chmod 666 /dev/cu.usbmodem14301
  

内容的提问来源于stack exchange，提问作者CoDe