跳到主要内容

Arduino 开发

本章节包含以下部分，请按需阅读：

Arduino 入门教程​

初次接触 Arduino ESP32 开发，想要快速上手？我们为您准备了一套通用的 入门教程。

请注意：该教程使用 ESP32-S3-Zero 作为教学示例，所有硬件代码均基于其引脚布局。在动手实践前，建议您对照手中的开发板引脚图，确认引脚配置无误。

配置开发环境​

1. 安装和配置 Arduino IDE​

请参考 安装和配置 Arduino IDE 教程 下载安装 Arduino IDE 并添加 ESP32 支持。

2. 运行示例​

创建示例​

  • 上方将项目文件夹更改为 c:\Users\Waveshare\AppData\Local\Arduino15\packages（其中 Waveshare 为计算机用户名）
  • 重新开启 Arduino IDE
  • 可通过文件下的项目文件夹中的示例进行例程创建
  • 以下演示创建 RGB 闪烁的示例（处于 File -> Sketchbook -> esp32 -> hardware -> esp32 -> 2.0.11 -> libraries -> ESP32 -> examples -> GPIO 下的 BlinkRGB）
    • 请将程序替换为以下内容
      #define PIN_NEOPIXEL 14
      void setup() {
      // No need to initialize the RGB LED
      }
      // the loop function runs over and over again forever
      void loop() {
      neopixelWrite(PIN_NEOPIXEL, RGB_BRIGHTNESS, 0, 0);  // Red
      delay(1000);
      neopixelWrite(PIN_NEOPIXEL, 0, RGB_BRIGHTNESS, 0);  // Green
      delay(1000);
      neopixelWrite(PIN_NEOPIXEL, 0, 0, RGB_BRIGHTNESS);  // Blue
      delay(1000);
      neopixelWrite(PIN_NEOPIXEL, 0, 0, 0);  // Off / black
      delay(1000);
      }

程序烧录​

  • 请注意，需要将引脚修改为对应的 RGB 引脚才可使用
  • 选择开发板和端口
  • 搜索 esp32s3 , 选择 ESP32S3 Dev Module 和 下载端口
  • 选择完成，点击上传，Arduino IDE 将编译并烧录该程序
  • 上传完成，即可在开发板上看到现象

示例演示​

注意

请注意，灯珠亮度不要调至过大，亮度过高会导致温度急速上升，从而导致板子损坏

库安装​

  • 安装 Adafruit NeoPixel 库（请选择下方对应版本的库文件，否则可能于示例程序不兼容）
  • 安装 Adafruit NeoMatrix 库（请选择下方对应版本的库文件，否则可能于示例程序不兼容）
  • 选择安装所有
  • 安装 Adafruit GFX Library 库（请选择下方对应版本的库文件，否则可能于示例程序不兼容）
  • 选择安装所有
  • 安装 FastLED 库（请选择下方对应版本的库文件，否则可能于示例程序不兼容）
  • 安装 SensorLib 库用于 QMI8658（请选择下方对应版本的库文件，否则可能于示例程序不兼容）

显示字符​

注意

请注意，灯珠亮度不要调至过大，亮度过高会导致温度急速上升，从而导致板子损坏

  • 安装相应库文件
  • 下载 示例程序，示例中的 Font 文件夹下的示例为流动显示字符
  • 如下，当前为显示 26 个小写字符
  • 可通过修改引号内的字符以在 ESP32-S3-Matrix 上显示相应字符
  • 修改后 烧录程序 即可使用

随动游戏​

注意

请注意，灯珠亮度不要调至过大，亮度过高会导致温度急速上升，从而导致板子损坏

  • 安装相应库文件
  • 下载 示例程序，示例中的 Game 文件夹下的示例为一个灯珠随 ESP32-S3-Matrix 倾斜跟随移动的小游戏
  • 烧录程序 即可使用
  • 成功烧录程序后，将在靠近中心位置点亮一个灯珠
  • 亮灯会根据设备当前倾斜角度进行移动
  • 可根据需求修改程序以实现更复杂的操作

酷炫颜色​

  • 安装相应库文件
  • 下载 示例程序，示例中的 Color 文件夹下的示例为一个较为酷炫的颜色流动
  • 烧录程序 即可使用
  • 成功烧录程序后，面板将以流动状态显示彩色
  • 可根据需求修改程序以实现更复杂的操作

Web 页面控制​

注意

请注意，灯珠亮度不要调至过大，亮度过高会导致温度急速上升，从而导致板子损坏

  • 安装相应库文件
  • 下载 示例程序，示例中的 HTTP 文件夹下的示例为通过 Web 页操作 ESP32-S3-Matrix 进行显示
  • 烧录程序 即可使用，程序烧录成功后可按下方操作进行
  • 控制设备（手机、电脑等）连接名为 ESP32-S3-Matrix 的 WIFI
  • 成功连接 WIFI 后，在浏览器中搜索 10.10.10.1 可进入 ESP32-S3-Matrix 控制页面 
    10.10.10.1
  • Web 页面存在两个控制 ESP32-S3-Matrix 全局刷新按钮，以及一个文本框和提交按钮
  • 在文本框中输入字符，然后点击 Submit 按钮，文本框中的字符将在 ESP32-S3-Matrix 上流动显示
最后由 Wulu 于 更新