witnessmenow/ESP32-Cheap-Yellow-Display

GitHub: witnessmenow/ESP32-Cheap-Yellow-Display

这是一个围绕「廉价黄色显示屏」(CYD)——一款约15美元的ESP32触摸屏显示模块——构建的开源社区项目,旨在提供完善的文档、示例代码和开箱即用的项目,弥补该硬件软件生态薄弱的不足。

Stars: 3988 | Forks: 404

# ESP32-Cheap-Yellow-Display 有一款内置 320 x 240 2.8 英寸带触摸屏 LCD 显示屏的 ESP32,名为"ESP32-2432S028R",由于这个名字念起来不太顺口,我建议将其更名为"Cheap Yellow Display"(廉价黄色显示屏),简称 CYD。这款显示屏的到手价仅约 15 美元,我认为性价比非常高。 ![image](https://static.pigsec.cn/wp-content/uploads/repos/2026/05/9e15bf8bce202147.png) ## 功能特性 CYD 具有以下功能: - ESP32(支持 WiFi 和蓝牙) - 320 x 240 LCD 显示屏(2.8 英寸) - 触摸屏(电阻式) - USB 供电和编程接口 - SD 卡插槽、LED 以及部分额外引脚引出 ## 适合哪些人群? 我认为它对以下类型的人很有用: - **刚开始接触硬件的人** —— 因为所有部件已经连接好,无需焊接或额外组件 - **熟悉硬件但比较懒的人** ——(比如我)有时候你就是想做个项目,而不想动手组装任何硬件 - **并不想学什么,只想做出一些酷东西的人** —— 后面会详细介绍。 ## 这个页面的目的是什么? 这款硬件很不错,价格也很便宜,但围绕它的软件说明/支持却相当差。只有一个指向某个随机网站上 zip 文件的链接。 几年前我发布了 [ESP32 Trinity](https://github.com/witnessmenow/ESP32-Trinity),这是一款用于控制点阵面板的开源 ESP32 开发板。我认为人们从我开发的 Trinity 中获得的主要好处不是硬件本身,而是文档、示例代码和开箱即用的项目。 我不再开发硬件产品了,但我认为如果能围绕这款显示屏创建一个类似的社区会很有趣,大家可以在这里分享为该显示屏制作的示例和项目。 ## 如何判断一块显示屏是不是 CYD? ![CYD 判断流程图](http://www.plantuml.com/plantuml/png/RP0nJyCm48Nt_8gZNIb3fge3LD2b2q92235UamDRE7PaNuhyxxda7DGgJBs-zxtSE-yJO-IXSzKD6-e8UeVMLyQs1DJrdA6br4JRims-4fW9LiS4bY6JS-47qBTWC052QvEayyCAvA-wS-8vi01F7mS8SVevOxJeUK9zu55QzzP_Nw-exxPmz8tHJzRRsJq4cdo3Pu98oIQsCd4O6WDIbyXF4LN-JNMsYG7UNXyXUAUTLHDfqVeMJWClUfSPrY_OOyPtO_ivUPcfnoMV3iyXJh4cj_MGJd8lEleQkvQKi9TYUT_DvbukXnraIfTQURMT39Nu8kcrXInIwQYO-gCyNwgm6al-ZneTNIRqjLokqS2UV3jqxXS0) ## 在哪里购买? 从对你来说最便宜的地方购买: - [Aliexpress\*](https://s.click.aliexpress.com/e/_DkSpIjB) - [Aliexpress\*](https://s.click.aliexpress.com/e/_DkcmuCh) - [Aliexpress](https://www.aliexpress.com/item/1005004502250619.html) - [Makerfabs](https://www.makerfabs.com/sunton-esp32-2-8-inch-tft-with-touch.html) —— 似乎附带一张 16GB SD 卡。Makerfabs 也销售我的 [ESP32 Trinity](https://github.com/witnessmenow/ESP32-Trinity)(注意:从 Makerfabs 发货到欧盟会产生进口税) \* = 推广链接 ## 开始使用你的 CYD 有关如何开始使用 CYD 的详细信息,请查看[设置与配置](/SETUP.md)页面 ## 代码示例 ### 基础示例 一组展示如何使用 CYD 不同功能的示例,这是入门的好地方。[点击这里查看。](/Examples/Basics) ### 替代显示库 基础示例基于 TFT_eSPI 显示库,但 CYD 也可以与其他显示库配合使用。如果你更喜欢使用其他 Arduino 库,这里有一些示例代码。[点击这里查看。](/Examples/AlternativeLibraries) ### ESPHome 一些在 ESPHome 中使用 CYD 的示例。[点击这里查看。](/Examples/ESPHome) ## 附加信息与链接 ### Discord 加入 [我的 Discord 频道](https://discord.gg/nnezpvq) 参与 CYD 讨论 ### 3D 打印 一些 3D 打印支架和外壳的示例。[点击这里查看。](/3dModels) ### 引脚信息 [此页面](/PINS.md) 包含引脚使用位置以及哪些引脚可供自由使用的信息。 ### 扩展配件 [此页面](/ADDONS.md) 包含可为 CYD 增加功能的额外硬件扩展配件信息。 ### 故障排除 [此页面](/TROUBLESHOOTING.md) 包含如何对 CYD 设备进行故障排除的信息。 ### 硬件改装 [此页面](/Mods/README.md) 包含一些可以对 CYD 进行的硬件改装信息,以改进或改变其部分功能。 ### 媒体与视频提及 [此页面](/MEDIA.md) 列出了 CYD 项目被提及的所有地方! ## 许可证信息 本项目采用 MIT 许可证,详见[许可证文件](/LICENSE) 唯一的例外是 [OriginalDocumentation](/OriginalDocumentation/) 文件夹,我没有权利对其授权。 ## 其他语言 社区的一些成员已将部分信息翻译成了其他语言! 请注意:我无法保证翻译的准确性、更新及时性或页面内容的整体质量。 - [法语 / Française](https://github.com/usini/ESP32-Cheap-Yellow-Display-Documentation-FR) - [德语 / Deutsch](https://github.com/paelzer/ESP32-Cheap-Yellow-Display-Documentation-DE) 如果你想贡献翻译,请在仓库名称中使用语言名称或语言代码,然后你可以在这里添加链接。 ## 支持我的工作! [如果你喜欢我的工作,请考虑成为 Github 赞助者!](https://github.com/sponsors/witnessmenow/)
标签:Arduino兼容, DIY项目, ESP32, ESP32-CYD, IoT入门, LCD显示屏, MicroPython, SD卡, WiFi, 低成本开发板, 创客项目, 学习套件, 嵌入式硬件, 嵌入式系统, 开发板, 开发者社区, 开源硬件, 快速原型, 技术文档, 显示器模块, 物联网, 电子元件, 电子制作, 硬件开发, 硬件教程, 硬件编程, 示例代码, 社区建设, 蓝牙, 触摸屏, 通知系统, 项目分享