AI创客项目开发教程 -AID101-1-1-01 – 学习本系列教程的准备工作

导航栏：首页 / AI教程目录 / AI创客项目开发教程目录 / 第1篇 基础知识篇 / AID101-1-1-01 – 学习本系列教程的准备工作

本节课程内容简介

在正式开始学习AI创客项目开发之前，充分的准备工作是成功的关键。本章将为您详细介绍学习本系列教程所需的知识储备、硬件设备和软件环境。通过本章的学习，您将明确自己是否已经具备了学习后续章节的基础条件，并了解如何获取和配置所需的各项资源。

只有做好了这些准备工作，您才能在后续的学习过程中专注于理解AI与硬件交互的核心概念，而不被环境配置等基础问题所困扰。

知识要求

为了顺利学习本教程，您需要具备以下基础知识：

1. 基础的C/C++或Arduino编程经验

本教程采用Arduino语言（基于C/C++）来讲解ESP32控制程序的开发。因此，您需要对以下编程概念有基本了解：

• 变量声明与数据类型
• 条件语句（if/else）
• 循环结构（for/while）
• 函数定义与调用
• 基本的串口操作（如Serial.print等语句的理解）

如果您尚未掌握这些基础知识，强烈建议您先学习太极创客制作的《零基础入门学用Arduino – 基础知识篇》教程，该教程将帮助您快速掌握Arduino编程的核心概念。该教程的具体内容如下：

太极创客制作了一系列免费的Arduino入门教程，其中《零基础入门学用Arduino教程 – 基础知识篇》是所有太极创客制作的教程中最基础的系列教程内容，该教程为完全没有任何编程经验的朋友设计，带您一起进入Arduino创客世界。

您可以通过点击以下链接前往《零基础入门学用Arduino教程 – 基础知识篇》

http://www.taichi-maker.com/homepage/arduino-basic-tutorial-index/

2. 了解Arduino开发环境的基本使用

虽然目前市面上有许多开发Arduino的集成开发环境（如PlatformIO、VS Code插件等），但为了确保本教程能够普遍适用于广大用户，我们将统一采用Arduino官方出品的Arduino IDE进行讲解。

您需要了解Arduino IDE的基本操作，包括：

• 如何创建和保存项目
• 如何选择正确的开发板和端口
• 如何编译和上传代码
• 如何查看串口监视器输出

如果您对Arduino IDE不熟悉，同样可以参考本文之前提到的《零基础入门学用Arduino教程 – 基础知识篇》中的相关章节。

3. 对HTTP协议和JSON格式有基本认识

在本教程中，ESP32需要通过HTTP协议与AI大模型API服务器进行通信，而数据交换的格式主要采用JSON（JavaScript Object Notation）。

• HTTP协议：是互联网上应用最广泛的应用层协议，用于客户端与服务器之间的数据传输
• JSON格式：是一种轻量级的数据交换格式，易于人阅读和编写，也易于机器解析和生成

我们会在教程中对HTTP请求方法（GET/POST）、请求头、请求体等概念进行简单介绍，也会解释JSON的基本语法结构。但如果您在学习过程中对这部分内容感到理解困难，建议您提前了解相关基础知识。

太极创客制作了一系列免费的创客教程，其中《物联网教程》中有一节详细介绍了JSON基础知识，供没有接触过JSON的创客朋友学习使用。

您可以通过点击以下链接前往《物联网教程 – JSON基础知识》

http://www.taichi-maker.com/homepage/esp8266-nodemcu-iot/iot-c/esp8266-nodemcu-web-client/json-basics/

API Key的作用是什么？

API-Key 是调用人工智能大模型服务平台接口的专属身份密钥，用于完成身份验证和权限校验；这很像我们在使用某个网站服务时，需要先使用密码登录网站才能使用该网站的服务。

对于类似ESP32这类硬件来说，当我们编写的控制程序需要调用人工智能平台服务时，平台需要我们的控制程序正确提供API Key，才能允许我们使用平台服务。

硬件要求

★ 硬件要求 – 1：ESP32开发板（本教程使用ESP32-S3-DevKitC-1开发板）

本教程选择ESP32-S3-DevKitC-1开发板作为主要硬件平台，原因如下：

更强的硬件性能：

• ESP32-S3 芯片搭载双核 Xtensa® LX7 处理器，主频最高 240MHz，运算性能优于初代 ESP32 的 LX6 内核
• 芯片内置 512KB 片上 SRAM，开发板板载外挂 PSRAM（通常 8MB），充足内存可承载复杂 AI 模型、缓存大体积 AI 接口返回数据；
• 无线通信支持 Wi-Fi 4（802.11 b/g/n）与 Bluetooth 5.0 Low Energy（BLE）可实现稳定无线联网与低功耗蓝牙交互；

相比初代 ESP32 系列开发板，ESP32-S3 拥有更强运算内核、更大内存规格，同时内置 AI 向量运算加速指令，更适合本地 AI 推理、智能语音等 AI 类创客项目开发。

内置WS2812 LED的优势：

• ESP32-S3-DevKitC-1开发板上集成了可编程RGB LED（WS2812）
• 无需额外接线即可直观观察AI平台对硬件的控制效果
• LED控制是智能家居中最基础且重要的应用场景之一
• 对于初学者来说，LED是最容易理解和调试的输出设备

📌 购买建议：如果您需要购买ESP32-S3-DevKitC-1开发板，可以通过以下渠道：

★ 硬件要求 – 2：USB数据线

USB数据线的主要作用是：

• 将电脑上的程序上传到ESP32开发板
• 为开发板提供工作电源
• 传输串口调试信息

重要提醒：购买ESP32-S3-DevKitC-1开发板时，通常不包含USB数据线。此外，并非所有USB线都支持数据传输功能——有些USB线仅能提供充电功能（内部缺少数据传输线芯）。

请确保您使用的USB线确实具有数据传输功能，否则将无法上传程序或进行串口调试。

📌 购买建议：如果您需要购买合适的USB数据线，可以通过以下渠道：

以下是USB数据线的获取渠道

您可以通过淘宝搜索关键词‘USB数据线’获取该商品的购买信息

请注意尽量购买值得信赖的商家的产品，并且确认该数据线接口适配您的ESP32-S3-DevKitC-1开发板

★ 硬件要求 – 3：电脑（Windows/Mac/Linux均可）

本教程主要采用Arduino IDE进行开发，该IDE目前提供Windows、Mac和Linux三个平台的版本，因此您可以根据自己的使用习惯选择相应的操作系统。

考虑到大部分用户使用Windows系统，本教程的所有截图和操作步骤将以Windows系统为例进行说明。如果您使用Mac或Linux系统，操作界面可能略有不同，但整体流程基本一致。

软件要求

Arduino IDE

Arduino IDE是Arduino官方提供的集成开发环境，具有界面简洁、安装简单、兼容性好等特点。我们在前面的知识要求部分已经介绍了该IDE的基本情况。

Arduino IDE上安装ESP32开发环境

Arduino IDE 默认仅支持官方 Arduino 系列开发板。若要使用功能强大的 ESP32 芯片编写和上传代码，必须先为其添加专用的开发板支持包。该支持包包含了编译器、库文件和烧录工具，使 Arduino IDE 能够识别 ESP32、正确编译程序并将其上传到ESP32开发板上。

您可以点击以下链接，前往本站文章，了解如何实现这一操作：

如何在Arduino IDE上安装ESP32开发环境

Arduino IDE上安装相关库文件（教程中会介绍安装方法）

本教程将使用一系列第三方Arduino库来简化开发过程，包括：

• ArduinoJSON库 – 专为 Arduino 平台优化的轻量级 C++ 库，用于高效地解析和生成 JSON 数据。
• FastLED库 – 一款快速、高效且易于使用的 Arduino 库，用于编程可寻址的 LED 灯带和LED灯板，例如 WS2810、WS2811、LPD8806、Neopixel 等。

我们会在每个需要使用特定库的章节中，详细介绍如何在Arduino IDE中安装这些库文件。安装过程通常非常简单，只需几个点击操作即可完成。

如果您在库安装过程中遇到困难，网上有大量相关的图文和视频教程可供参考。Arduino社区也非常活跃，您可以在相关论坛中寻求帮助。

阿里云百炼AI服务平台API-Key

API Key的作用是什么？

API-Key 是调用人工智能大模型服务平台接口的专属身份密钥，用于完成身份验证和权限校验；这很像我们在使用某个网站服务时，需要先使用密码登录网站才能使用该网站的服务。

对于类似ESP32这类硬件来说，当我们编写的控制程序需要调用人工智能平台服务时，平台需要我们的控制程序正确提供API Key，才能允许我们使用平台服务。

阿里云百炼平台是什么？

阿里云百炼是阿里云推出的人工智能大模型服务平台，该平台汇聚通义千问等多款主流人工智能大模型，面向开发者与企业提供人工智能大模型服务。该平台支持通过 API 快速将 AI 能力接入程序，适合开发、办公等各类场景。

本教程将采用阿里云百炼人工智能大模型服务平台进行学习开发使用。

为了使用本教程学习，您需要首先注册一个阿里云百炼平台的API-Key。

具体操作方法，可参考以下本站页面说明：

如何获取阿里云百炼人工智能大模型服务平台API-Key

关于学习本教程所需的网络基础知识

学习本教程需要您具备一定的互联网基础知识储备，这些知识内容包括：

• TCP/IP协议的基本知识
• IP协议的基本原理
• 网络设备如何通过HTTP协议进行通讯

如果您对以上内容不甚了解，可以通过以下太极创客制作的免费视频教程了解这些知识内容。以下链接中的视频是太极创客早前制作的物联网教程中，专门针对互联网基础知识制作的免费视频教程。建议您在开始本教程学习以前先观看以下链接中的视频教程并掌握了互联网知识后，再学习后续教程。

请注意，学习本教程所需的互联网知识，只需要您完成观看以下的两个视频教程就够了。也就是“互联网基础知识-1”和“互联网基础知识-2”这两部分内容。另外由于该教程针对的是ESP8266开发板，因此您只需要在观看教程的时候，将教程中所提及的ESP8266开发板在脑海中平替为ESP32教程即可。以下视频教程中所提及的互联网基础知识适用于所有物联网硬件。

点击这里前往观看太极创客制作的“互联网教程基础知识-1”视频教程

点击这里前往观看太极创客制作的“互联网教程基础知识-2”视频教程

结束语

恭喜您完成了学习准备工作的梳理！现在您已经清楚地了解了学习本系列教程所需的知识、硬件和软件要求。

请花一些时间检查您的准备情况：

• ✅ 是否具备必要的编程基础？
• ✅ 是否已准备好ESP32-S3-DevKitC-1开发板和USB数据线？
• ✅ 是否已安装Arduino IDE？

当您确认所有准备工作都已完成，就可以信心满满地开始我们的AI创客之旅了！在接下来的章节中，我们将从最基础的AI API交互开始，逐步构建出令人惊叹的智能硬件项目。

记住，每一个复杂的AI系统都是由简单的组件构成的。只要您按照教程的步骤认真学习和实践，一定能够掌握AI与硬件交互的核心技能。

让我们开始吧！