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 美元,我认为性价比非常高。

## 功能特性
CYD 具有以下功能:
- ESP32(支持 WiFi 和蓝牙)
- 320 x 240 LCD 显示屏(2.8 英寸)
- 触摸屏(电阻式)
- USB 供电和编程接口
- SD 卡插槽、LED 以及部分额外引脚引出
## 适合哪些人群?
我认为它对以下类型的人很有用:
- **刚开始接触硬件的人** —— 因为所有部件已经连接好,无需焊接或额外组件
- **熟悉硬件但比较懒的人** ——(比如我)有时候你就是想做个项目,而不想动手组装任何硬件
- **并不想学什么,只想做出一些酷东西的人** —— 后面会详细介绍。
## 这个页面的目的是什么?
这款硬件很不错,价格也很便宜,但围绕它的软件说明/支持却相当差。只有一个指向某个随机网站上 zip 文件的链接。
几年前我发布了 [ESP32 Trinity](https://github.com/witnessmenow/ESP32-Trinity),这是一款用于控制点阵面板的开源 ESP32 开发板。我认为人们从我开发的 Trinity 中获得的主要好处不是硬件本身,而是文档、示例代码和开箱即用的项目。
我不再开发硬件产品了,但我认为如果能围绕这款显示屏创建一个类似的社区会很有趣,大家可以在这里分享为该显示屏制作的示例和项目。
## 如何判断一块显示屏是不是 CYD?

## 在哪里购买?
从对你来说最便宜的地方购买:
- [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, 低成本开发板, 创客项目, 学习套件, 嵌入式硬件, 嵌入式系统, 开发板, 开发者社区, 开源硬件, 快速原型, 技术文档, 显示器模块, 物联网, 电子元件, 电子制作, 硬件开发, 硬件教程, 硬件编程, 示例代码, 社区建设, 蓝牙, 触摸屏, 通知系统, 项目分享