MacOS+VSCODE 安装esp-adf详细流程

  1. 安装python3,省略
  2. vscode安装ESP-IDF插件,选择v5.2.5 版本,电脑需要能够访问github,esp-idf安装后的默认目录是:
/Users/***/esp/v5.2.5/esp-idf

# 启动***为省略名称
  1. 在/Users/***/esp/ 目录下使用git clone 下载 esp-adf
# 国内用户推荐 Gitee 镜像
git clone https://gitee.com/EspressifSystems/esp-adf.git
  1. esp-idf 子模块下载
# 手动下载子模块(解决 GitHub 访问问题):# 安装esp-adf-libs:
git clone https://gitee.com/du-jianmin/esp-adf-libs.git 
# → 放入 esp-adf/components/# 安装esp-sr:
git clone https://gitee.com/du-jianmin/esp-sr.git 
# → 放入 esp-adf/components/
​注意​:无需处理 esp-idf 子模块(已独立安装)
  1. 创建esp-idf 软链接指向esp-idf,重要.
    这里吐槽一下esp32官方的环境搭建,很麻烦,因为在esp-adf目录下有esp-idf子目录(空目录),因为esp-adf依赖esp-idf,而前面我们已经安装了esp-idf,所以我们不需要再次clone esp-idf,而是通过软链接的方式指向真正的esp-idf即可,这一步非常重要,否则在执行export.sh 的时候会报错。
# 7.1 删除esp-adf/esp-idf
rm -rf esp-idf
# 7.2 创建esp-idf 软链接
ln -s /User/***/esp/v5.2.5/esp-idf /User/***/esp/esp-adf/esp-idf
  1. 创建 ADF_PATH 变量
cd ~/esp/esp-adf
. /User/***/esp/esp-adf/export.sh
  1. 配置vscode路径,重要
  • 10.1 vscode 选择esp-idf插件,set按钮
    在这里插入图片描述
  • 10.2 选择settings
  • 10.3 设置esp-idf、esp-adf的路径,重要
    在这里插入图片描述
### 如何在 VSCode安装和配置 ESP-IDF 开发环境 #### 1. 基础准备工作 为了成功搭建基于 VSCodeESP-IDF 开发环境,需完成以下基础工作: - **操作系统支持**:ESP-IDF 支持 Windows、Linux 和 macOS 系统。确保你的操作系统已更新至最新版本以避免潜在的兼容性问题[^3]。 - **安装 Visual Studio Code (VSCode)**:访问 [VSCode 官网](https://code.visualstudio.com/) 并根据你的操作系统下载并安装 VSCode。 #### 2. Python 环境设置 ESP-IDF 需要依赖于 Python 来运行其构建系统和其他工具链功能。因此需要满足以下条件: - 安装 Python 版本至少为 3.7 或更高版本。可以从 [Python官网](https://www.python.org/downloads/) 下载并安装 Python,在安装过程中务必勾选“Add Python to PATH”选项,这使得可以在命令行中直接调用 Python。 #### 3. ESP-IDF 工具链安装 ESP-IDF 提供了一套完整的工具来简化开发流程,具体步骤如下: - 访问乐鑫官方提供的工具页面,选择适合的操作系统的安装包进行下载,并按照提示完成一键安装过程。 - 对于 Linux 用户或者熟悉终端操作的开发者来说,可以通过克隆 ESP-IDF 到本地仓库的方式获取源码,并运行 `./install.sh` 脚本来自动安装所需的工具链及相关依赖项[^5]。 #### 4. 在 VSCode 中集成 ESP-IDF 插件 为了让 VSCode 更好地支持 ESP-IDF 开发体验,可以采取以下措施: - 打开 VSCode 后转到扩展市场搜索栏输入 "Espressif IDF" 关键词找到对应插件完成安装- 如果之前已经手动完成了idf相关脚本初始化,则可能无需再次单独安装该插件因为部分情况下它会被默认包含进去。 #### 5. 创建项目与初始配置 当上述所有前置条件都完成后就可以着手建立第一个工程项目了: - 使用命令 `idf.py create-project <project_name>` 可快速生成一个新的空白模板工程结构[^4]; - 当进入某个具体的工程目录后再利用快捷组合键 Ctrl+Shift+P 调出全局命令面板选取菜单中的 'ESP-IDF: Add Configuration Folder' 动作将会自动生成必要的.vscode隐藏文件夹及其内部json格式设定文档比如 c_cpp_properties.json 文件用于定义编译器路径以及其他重要参数从而消除可能出现的各种语法错误标记显示情况。 #### 6. 自定义组件添加 随着项目的深入发展往往还需要引入额外的功能模块即所谓的“components”,此时只需简单复制目标库文件夹放置到当前工程根节点下的 components 子目录里即可被识别加载参与后续整个构建链条之中。 ```bash # 示例代码片段展示如何切换到指定工程位置再执行初始化动作 cd /path/to/your/project/directory/ idf.py set-target esp32s3 # 设置目标硬件平台型号为例句形式给出实际应用时应依据个人需求调整 ``` --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值