M5Stack 制造的硬件可以单手握住并开箱即用：打开包装时，屏幕、按钮、扬声器和电池都已就位。这正是模拟器必须在每个细节上都做到准确无误的板子类型，否则它就毫无用处，因为没有面包板可以推卸责任。这篇文章讲述的是 M5Stack 硬件如何进入 Velxio，目前能运行什么，以及我们在此过程中为自己设定的小测试：M5Stack 自己的示例草图能否在浏览器中运行而不修改一行代码？
答案是肯定的。让我们从这里开始。
M5Stack 官方显示测试，未经修改
M5Stack 随 Cardputer 库附带了一个显示示例：随机彩色矩形和文本永远散布在屏幕上，作为快速查看 LCD 路径全速运行的方法。我们将其原样放入画廊。
要亲自查看：
- 打开 velxio.dev/example/cardputer-adv-m5-display。无需注册。
- 在顶部工具栏上，点击播放按钮。该草图将针对与 Arduino IDE 中相同的 arduino-esp32 内核和 M5Cardputer 库进行编译。冷构建需要几分钟；热构建则快得多。
- 当板子启动时，屏幕会以面板的全 240x135 分辨率填充矩形。
- 点击键盘，或点击板子并使用您自己的键盘，然后打开文章末尾列出的键盘示例之一，即可看到按键操作到达草图。
该草图是画廊中十五个官方 M5Stack 示例之一。在 Cardputer ADV 上，它们是文本终端、按钮、蜂鸣器、显示、IR NEC 发送、单键、多键、文本输入、microSD 和 REPL 猜谜游戏示例。在 Core 上，它们是 HelloWorld、Button、Display、Speaker 和 TFCard。如果某个示例使用了经典的 M5Stack 库（该库在 arduino-esp32 3.x 内核上已无法编译，无论是在 Arduino IDE 还是其他任何地方），则已移植到 M5Unified，这是 M5Stack 目前推荐的库。其他一切均未改动。
两块板子
M5 Cardputer ADV。 卡片大小的计算机：ESP32-S3、1.14 英寸 240x135 屏幕、56 键键盘、IMU、通过 ES8311 编解码器的麦克风和扬声器、IR 发射器、microSD 插槽和电池。在 Velxio 中，屏幕在板子上绘制，整个键盘可以输入（点击按键，或聚焦板子并在您自己的键盘上输入），扬声器通过您的计算机播放，当您在画布标题中打开 Mic 开关时，麦克风会传输您计算机的麦克风。旁边的 Sensors 按钮会倾斜 BMI270 IMU 并设置电池电量，因此可以测试对这两者做出反应的代码。IR 发射器也有响应：板子上的一个点会随着每次解码的传输而闪烁。microSD 是一张带有上传面板的真实 FAT 卡。Wi-Fi 和 MicroPython 可用；BLE 无线电未被模拟。
M5Stack Core（Basic v2.7）。 经典的 54x54 毫米可堆叠 ESP32，带有 2 英寸 320x240 玻璃后屏幕、三个前面按钮、一个扬声器、一个 TF 插槽和一个 Grove 端口。屏幕绘制，三个按钮可点击（低电平有效，如接线所示），扬声器音调以草图的真实音高播放，TF 插槽是一张真实的卡。M-Bus 引脚卡印在板子的四个边缘上，颜色编码与真实外壳相同，并且其上的每个引脚都可接线，因此 Core 与任何 DevKit 一样，都是外部部件的好宿主。
两块板子都支持 Arduino C++ 和 MicroPython，并且都带有组件选择器中的悬停数据表，其中列出了引脚排列并链接到 M5Stack 的商店。
Chain 矩阵
目录中还有两个 M5Stack Chain 模块：Chain RGB Matrix（64 个 WS2812E LED）和 Chain Mono Matrix（64 个白色 LED）。在 Velxio 中，它们作为普通的 WS2812 矩阵在其 DIN 引脚上驱动，这就是五个画廊示例从 Arduino Uno 使用它们的方式：彩虹、白色扫描、计数数字、弹跳球和火焰效果。真实的基于 UART 的 Chain 协议在此阶段未被模拟；这已在计划中。
与 M5Stack 合作
M5Stack 支持了这项工作并提供了硬件。这在这里比平时更重要，因为使这些板子有用的很多东西都在板子本身。Velxio 中的 Cardputer ADV 是针对物理单元进行调试的：M5GFX 读取以检测显示器的面板 ID、区分 ADV 版本与原始版本的 GPIO 签名、键盘扫描、I2C 上的编解码器。当模拟板子像真实板子一样回答这些问题时，M5Stack 的库会完成其余工作，这就是为什么他们的示例无需编辑即可运行的原因。
我们感谢 M5Stack 团队支持一个让人们可以在购买前在浏览器标签页中试用其硬件的项目，并感谢开源库（M5Unified、M5GFX、M5Cardputer）使集成成为正确获取硬件而非重写软件的问题。
如果您想要实体板子，它们位于 shop.m5stack.com： Cardputer ADV、 Basic Core v2.7、 Chain RGB Matrix 和 Chain Mono Matrix。M5Stack 文档位于 docs.m5stack.com。
Velxio 中所有 M5Stack 内容均在免费计划上运行。打开组件选择器，选择 Boards，Cardputer ADV 和 Core 就在其他 ESP32 板子旁边。
画廊中的每个 M5Stack 示例
每个链接都会打开准备运行的项目。
M5 Cardputer ADV
- M5 Cardputer ADV：LCD + 键盘回显
- M5 Cardputer ADV：文本终端（官方 M5Stack 示例）
- M5 Cardputer ADV：硬件导览（显示、键盘、microSD、IMU、LED、电池、麦克风）
- M5 Cardputer ADV：Brick Blaster，带声音的游戏
- M5 Cardputer ADV：按钮（官方示例）
- M5 Cardputer ADV：蜂鸣器（官方示例）
- M5 Cardputer ADV：显示（官方示例）
- M5 Cardputer ADV：IR NEC 发送（官方示例）
- M5 Cardputer ADV：单键按下（官方示例）
- M5 Cardputer ADV：多键按下（官方示例）
- M5 Cardputer ADV：文本输入（官方示例）
- M5 Cardputer ADV：microSD（官方示例）
- M5 Cardputer ADV：REPL 猜谜游戏（官方示例）
M5Stack Core
- M5Stack Core：Hello LCD + 按钮
- M5Stack Core：LCD（Adafruit_ILI9341）
- M5Stack Core：内置 microSD + LCD
- M5Stack Core：按钮钢琴（扬声器）
- M5Stack Core：HelloWorld（官方示例）
- M5Stack Core：Button（官方示例）
- M5Stack Core：Display（官方示例）
- M5Stack Core：Speaker（官方示例）
- M5Stack Core：TFCard（官方示例）
Chain 矩阵（在 Arduino Uno 上）
- M5Stack Chain RGB Matrix：彩虹
- M5Stack Chain RGB Matrix：计数数字
- M5Stack Chain RGB Matrix：弹跳球
- M5Stack Chain RGB Matrix：火焰
- M5Stack Chain Mono Matrix：白色扫描
文档中的板子页面包含完整的引脚排列：M5 Cardputer ADV 和 M5Stack Core。本系列之前的文章介绍了 Seeed Studio。
