【亲测免费】 M5Stack 开源项目教程

2026-01-17 09:31:23作者：裘旻烁

项目介绍

M5Stack 是一个基于 ESP32 的开源硬件平台，专注于快速、简单的物联网（IoT）开发。该项目提供了丰富的硬件模块、软件库和开发工具，旨在帮助开发者快速构建和部署物联网设备。M5Stack 的核心理念是模块化设计，通过堆叠不同的模块，开发者可以轻松实现复杂的功能。

项目快速启动

环境搭建

安装 Arduino IDE：
- 下载并安装 Arduino IDE。
- 在 Arduino IDE 中，进入 文件 -> 首选项，在 附加开发板管理器网址 中添加以下链接：
```
https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/arduino/package_m5stack_index.json
```
- 进入 工具 -> 开发板 -> 开发板管理器，搜索 M5Stack 并安装。
安装 M5Stack 库：
- 在 Arduino IDE 中，进入 项目 -> 加载库 -> 管理库，搜索 M5Stack 并安装。

示例代码

以下是一个简单的示例代码，用于在 M5Stack 设备上显示 "Hello, M5Stack!"：

#include <M5Stack.h>

void setup() {
  M5.begin();
  M5.Lcd.println("Hello, M5Stack!");
}

void loop() {
  // 主循环中不需要执行任何操作
}

上传代码

将 M5Stack 设备通过 USB 连接到电脑。
在 Arduino IDE 中，选择正确的开发板和端口（工具 -> 开发板 -> M5Stack-Core-ESP32，工具 -> 端口）。
点击 上传 按钮，将代码上传到 M5Stack 设备。

应用案例和最佳实践

环境监测站

使用 M5Stack 的 ENV 模块（集成 SHT30 温湿度传感器和 QMP6988 气压传感器），可以快速构建一个环境监测站。以下是一个简单的示例代码：

#include <M5Stack.h>
#include <Wire.h>
#include "Adafruit_Sensor.h"
#include "Adafruit_BMP280.h"
#include "Adafruit_SHT31.h"

Adafruit_BMP280 bmp;
Adafruit_SHT31 sht31 = Adafruit_SHT31();

void setup() {
  M5.begin();
  Wire.begin();
  if (!bmp.begin(0x76) || !sht31.begin(0x44)) {
    M5.Lcd.println("传感器初始化失败");
    while (1);
  }
  M5.Lcd.println("环境监测站启动");
}

void loop() {
  float temp = sht31.readTemperature();
  float hum = sht31.readHumidity();
  float pressure = bmp.readPressure() / 100.0F;

  M5.Lcd.clear();
  M5.Lcd.setCursor(0, 0);
  M5.Lcd.printf("温度: %.2f C\n", temp);
  M5.Lcd.printf("湿度: %.2f %%\n", hum);
  M5.Lcd.printf("气压: %.2f hPa\n", pressure);

  delay(2000);
}