客户端环境

1383字约5分钟

2024-11-07

如果你是个人玩家或者新手，更推荐使用 ESP-AI 开放平台提供的固件与服务，只需要在线烧录即可，无需搭建本地复杂繁琐的环境。ESP-AI开放平台

一、Arduino IED 环境

1.1、基本软件准备

环境	版本	备注
`Arduino IDE`	>= v2.x	如果你想用 platformio 来开发客户端，也可以选择 VsCode 等IDE

不想用 Arduino IED ?

群文件中已经整理好了 Vscode 和 Cursor 编辑器的配置和资料，直接加QQ群下载吧。
除了 Vscode 您也可以使用 Clion 进行开发和烧录环境准备，如果使用 Clion 请直接从：二、Clion开发环境 开始

1.2、Arduino 依赖库安装

1. 下载第三方依赖 点击下载依赖

只是在第一次准备环境时需要这个依赖，升级时候只需要去下面发布页面下载最新 ESP-AI 依赖即可。

2. 将依赖解压到 `C:\Users\[用户名]\Documents\Arduino\libraries` (注意用户名自己改成你电脑用户名，并且删除中括号。)

这个地址在 Arduino IDE 中此处可以获取到：

3. 确认你的 `libraries` 目录中有如下几个文件夹

4. 下载 ESP-AI 库

打开仓库发布页面，下载最新的客户端发布版本即可：发布页面。
一般第一个就是最新的，下面截图只是想表达需要点击哪里下载，并不代表图中是新版本。

将下载的 zip 文件一样解压到 libraries 目录中，并保证libraries\esp-ai目录的存在。

1.3、Arduino 开发板环境安装

设置开发板地址，打开菜单： 文件->首选项->其他开发板管理器，并将地址填入
https://github.com/espressif/arduino-esp32/releases/download/2.0.4/package_esp32_index.json
然后等待编辑器下载完文件。

下载 ESP32 开发板

注意：版本必须是 2.x 版本，不能大于 3.0 否则会报错。

Arduino IDE 设置，下图中的三个选项必须如图设置。

二、Clion 环境

注意：配置过程对新手有一定难度，谨慎选择。Clion开发环境，适合对环境有要求的程序员，Clion开发环境成熟度高，操作友好，有利于加快研发效率

2.1、硬件以及软件准备

适配硬件：ESP32-S3-N16R8
软件：Clion、PlatformIO

2.2、安装 Clion 和 PlatformIO

下载地址：https://www.jetbrains.com/clion/
打开 Clion 官网，点击右上角 Download 进入下载界面，选择对应版本进行下载
建议您选择相对新的版本，新版本可以自行下载部署工具链，免去您手动下载和设置
下载成功后安装 Clion ，安装时注意勾选[Add"bin"folder to the PATH]将 Clion 添加到环境变量中
激活 Clion，您可以选择试用30天或者购买正版授权，也可以尝试万能的淘宝
激活后打开 Clion，下载 PlatformIO for Clion 插件，下载成功后重启 Clion

2.3、创建项目，配置 PlatformIO

打开 Clion，选择新建项目
这时可以看到新建项目界面左侧有 Platform 标志，点击 PlatformIO 后会发现右侧没有开发板列表，只显示“找不到PlatformIO实用程序”
对于此问题我们需要按照提示点击安装指南进入 PlatformIO 官网Wiki,点击 [Installer Script] 进入另一个界面，页面地址 installation
在该界面点击installer script进入Github界面
找到 get-platformio.py 并下载到电脑
运行 python get-platformio.py 脚本，等待下载完成（如果您没有python环境请自行下载安装）
运行完成后找到 C:\Users\{用户名} 该路径下的文件中多出来 .platformio 文件证明python脚本运行成功
将 C:\Users\{用户名}\.platformio\penv\Scripts 下的文件加入到环境变量
重启Clion，可以看到Clion加载出了开发板列表

2.4、程序下载，安装

点击创建项目，选择 PlatformIO, 选择对应开发框架
等待自动下载环境依赖
下载第三方依赖点击下载依赖，只是在第一次准备环境时需要这个依赖，升级时候只需要去下面发布页面下载最新 ESP-AI 依赖即可。
打开仓库发布页面，下载最新的客户端发布版本即可：发布页面。
将下载好的第三方依赖和客户端发布版本复制到项目的 lib 目录下
修改 platformio.ini 配置，可以copy下方配置，注意修改 lib_extra_dirs 为您的目录路径

[env:esp32-s3-devkitc-1]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
lib_extra_dirs =
    /Users/{用户名}/.platformio/packages/framework-arduinoespressif32/libraries
lib_deps =
    HTTPClient

board_build.arduino.partitions = default_16MB.csv
board_build.arduino.memory_type = qio_opi
build_flags = -DBOARD_HAS_PSRAM
board_upload.flash_size = 16MB
monitor_speed = 115200