## 1. 从点亮第一张图片开始：你的BPI-Centi-S3“数码相框”之旅 嘿，朋友！如果你刚拿到这块Banana Pi BPI-Centi-S3开发板，看着那块小巧精致的1.9英寸彩屏，是不是已经跃跃欲试，想让它展示点酷炫的东西了？我当初也是这么想的。这块板子最吸引我的地方，就是它把ESP32-S3的强大性能和一块即插即用的屏幕完美结合在了一起，省去了我们外接显示屏的麻烦。今天，我就带你用最简单、最“小白”的方式——MicroPython，来实现一个超实用的功能：JPG图片轮播。你可以把它想象成一个迷你的、可编程的数码相框，或者一个动态信息展示牌。整个过程，我会像拆解乐高积木一样，一步步告诉你每个零件怎么用，保证你即使没有太多编程经验，也能跟着做出来。 你可能听说过用C语言或者Arduino框架来玩转硬件，但那对新手来说，门槛确实有点高。MicroPython就友好多了，它让我们能用写Python脚本的方式去控制硬件，语法简单，交互即时，出错了也能快速看到反馈。BPI-Centi-S3的另一个巨大优势是，它的出厂固件已经为我们准备好了屏幕驱动，这意味着我们不用去折腾复杂的底层编译，可以直接调用现成的函数来显示图片。我们的目标很明确：准备几张喜欢的照片，写一段几十行的代码，让这些照片在屏幕上自动循环播放起来。这不仅是学习MicroPython和硬件交互的绝佳入门项目，其成果本身也很有成就感。想象一下，把你旅行的风景、家人的合影或者喜欢的动漫角色，放在这个掌心大小的设备上轮番展示，是不是很有趣？ 在开始动手之前，我们先快速了解一下手头的“武器”。BPI-Centi-S3核心是一颗ESP32-S3芯片，双核处理器，自带Wi-Fi和蓝牙，性能对于控制屏幕绰绰有余。板载的8MB PSRAM（伪静态随机存储器）是关键，因为显示图片，尤其是解码JPG，需要不少内存空间，这块PSRAM能很好地满足需求。那块1.9英寸、170x320分辨率的屏幕，驱动芯片是ST7789，通过8位并行接口与主芯片高速通信，确保画面流畅。官方开源社区（感谢russhughes等人的贡献）已经提供了完善的`st7789`驱动模块，其中就包含了我们今天要反复用到的`.jpg()`方法。所以，我们的任务不是从零造轮子，而是学会如何优雅地使用这个现成的“轮子”，让它按照我们的想法转动起来。 ## 2. 万事开头易：搭建你的MicroPython开发环境 很多朋友在第一步“搭建环境”上就容易打退堂鼓，觉得配置各种工具链太麻烦。别担心，给BPI-Centi-S3玩MicroPython，环境搭建可以说是最简单的那一类。你不需要安装庞大的IDE（集成开发环境），甚至一开始都不需要复杂的编译工具。核心就是两样东西：一个能往开发板里传文件的工具，和一个能写Python代码的文本编辑器。 首先，确保你的BPI-Centi-S3已经烧录了MicroPython固件。如果你拿到的是出厂状态的板子，它很可能已经预装了。如果不确定，可以去Banana Pi的官方Wiki页面，找到BPI-Centi-S3的板块，里面通常会有最新的MicroPython固件文件和烧录指南。烧录过程一般使用乐鑫官方的`esptool.py`工具，通过USB Type-C线连接电脑和开发板即可完成，步骤就是几条命令行，网上教程非常丰富。烧录成功后，当你用USB线连接电脑和开发板时，电脑会识别出一个新的串行端口（在Windows设备管理器中叫COM口，在Mac或Linux下是`/dev/tty.usbserial-XXX`之类的名字），这就成功了一大半。 接下来，我们需要一个能和开发板“对话”的工具。我强烈推荐使用`Thonny`这款IDE。它是一款专为Python教学和MicroPython开发设计的轻量级软件，界面清爽，功能直击要害。去Thonny官网下载安装后，打开软件，在右下角选择解释器。在解释器类型里选择“MicroPython (ESP32)”，然后在端口那一栏，选择你电脑识别到的那个BPI-Centi-S3的串口。点击连接，如果一切顺利，Thonny底部的Shell（交互式命令行）区域会出现`>>>`这样的MicroPython提示符。你可以在里面输入`print(“Hello, BPI-Centi-S3!”)`并回车，如果能看到返回信息，恭喜你，你的开发环境已经通了！Thonny的好处在于，它集成了文件管理和代码上传功能，你可以直接在它的编辑窗口写代码，然后一键保存到开发板或者从开发板打开文件，非常方便。 除了Thonny，另一个常用工具是`mpbridge`（MicroPython Bridge），它是一个命令行工具，能让你像操作本地文件夹一样操作开发板上的文件系统。对于喜欢用VS Code、Sublime Text等编辑器的朋友，用`mpbridge`会更灵活。你可以用`pip install mpbridge`安装它，然后通过`mpbridge mount /Volumes/BPI`（Mac/Linux）或`mpbridge mount Z:`（Windows）这样的命令，把开发板挂载为一个磁盘。之后，你就可以直接复制、粘贴文件了。我个人习惯是：用VS Code写代码，用`mpbridge`传文件，用Thonny的Shell做调试。你可以选择最适合自己工作流的方式。环境搭好，就像厨师备好了灶台和锅具，接下来就该准备“食材”——也就是我们的图片了。 ## 3. 图片准备：为小屏幕量身定制“美餐” 现在我们来处理要显示的图片。这是很多新手会忽略，但实际非常重要的一步。BPI-Centi-S3的屏幕分辨率是170像素（宽）x 320像素（高）。我们的图片必须适配这个尺寸，否则显示出来要么被裁剪，要么有黑边，效果大打折扣。你可以把屏幕想象成一个固定大小的相框，我们的照片必须裁剪或缩放成刚好放进这个相框。 首先，收集你喜欢的图片。风景、人像、宠物、抽象画……什么都可以。然后，我们需要一个图片编辑工具把它们变成170x320像素。如果你电脑上有Photoshop、GIMP这类专业软件，那自然没问题。但如果你不想装软件，完全可以用在线工具搞定。原始文章里提到了Pixlr X，它确实是个好选择，界面友好，功能足够。此外，像**Photopea**（一个几乎在线复刻Photoshop的网站）或者**Canva**的图片调整功能，都非常好用。操作的核心就两步：一是调整图像大小（Image Size），把宽度设为170，高度设为320（或者反过来，取决于你想要的横竖版式）；二是注意保持比例。如果你直接输入170和320，工具通常会强制拉伸图片，可能导致人脸变宽或风景变形。所以，我建议先使用“裁剪”功能，选择170:320的比例进行裁剪，保留图片最核心、最美的部分，然后再微调大小。 关于图片格式，我们当然选择JPG。因为`st7789`驱动库的`.jpg()`方法就是为解码JPG格式优化的。JPG是一种有损压缩格式，在保证可观画质的前提下，能显著减少文件体积，这对于存储空间有限的嵌入式设备至关重要。一张170x320的彩色JPG图片，优化后可能只有10-30KB，而同样尺寸的未压缩BMP位图可能要160KB以上。体积小意味着上传到开发板更快，加载显示时占用的内存也更少。在保存JPG时，你可以适当调整压缩质量（比如调到80%左右），在文件大小和画面细节之间找一个平衡点。我实测过，对于这块小屏幕，70%-85%的质量已经非常清晰，肉眼几乎看不出和100%质量的差别，但文件能小不少。 准备好图片后，给它们起个简单明了的名字，比如`pic1.jpg`, `pic2.jpg`, `family.jpg`, `landscape.jpg`等。名字最好按你想要的播放顺序来，方便后续代码调用。然后，我们需要把这些图片文件上传到BPI-Centi-S3的开发板文件系统中。如果你用Thonny，在左侧的文件浏览器窗口，上方通常有“此电脑”和“MicroPython设备”两个选项。切换到“MicroPython设备”，你会看到开发板根目录下的文件列表（比如`boot.py`, `main.py`）。直接把你的JPG图片从电脑文件夹拖拽到Thonny的这个文件列表区域，它就会自动上传。如果用`mpbridge`，就更简单了，直接把图片文件复制到你挂载的虚拟磁盘里就行。传完之后，可以在Thonny的Shell里输入`import os; os.listdir()`命令，检查一下图片文件是否已经在列表里了。确保它们和你的代码文件在同一个根目录下，这样调用时直接写文件名就行，不用加路径。 ## 4. 核心代码拆解：让第一张图片“亮”起来 环境有了，图片也传上去了，最激动人心的时刻到了：写代码让屏幕亮起来！我们先从最简单的开始——显示一张图片。别被“编程”吓到，这段代码短小精悍，而且我会逐行解释，保证你知其然也知其所以然。 我们先来看显示单张图片的完整代码，你可以直接在Thonny的编辑窗口里输入，或者新建一个`main.py`文件粘贴进去。记住，`main.py`是MicroPython设备上电后会自动运行的主脚本文件，所以我们把代码放这里。 ```python """ BPI-Centi-S3 显示单张JPG图片 """ import st7789 import tft_config import gc def main(): try: # 1. 初始化屏幕 tft = tft_config.config(rotation=1) tft.init() # 2. 显示图片 tft.jpg("pic1.jpg", 0, 0) tft.show() # 3. 清理内存 gc.collect() except BaseException as err: # 4. 错误处理 err_type = err.__class__.__name__ print('Err type:', err_type) from sys import print_exception print_exception(err) finally: # 5. 程序结束前的清理（这里通常不会执行，因为程序会停住） tft.deinit() print("tft deinit") main() ``` 现在，我们来像拆解机器一样，看看每一部分是怎么工作的。首先看开头的三行`import`，这是Python导入模块的语句。`st7789`是控制屏幕的核心驱动模块；`tft_config`是一个配置文件模块，它封装了初始化屏幕所需的参数（比如引脚定义、屏幕尺寸等），让我们不用自己去记复杂的引脚对应关系，直接调用`tft_config.config()`就能得到一个配置好的屏幕对象，非常方便。`gc`是垃圾回收模块，在内存紧张的单片机编程里，手动调用`gc.collect()`可以及时清理不再使用的内存，这是个好习惯。 在`main()`函数里，我们用一个`try...except...finally`结构把主要逻辑包裹起来。这是为了代码的健壮性，万一出错了，我们能知道错在哪里，而不是让屏幕直接卡死。核心步骤就三步：初始化、显示图片、清理内存。`tft = tft_config.config(rotation=1)`这一行，`rotation=1`参数是设置屏幕旋转方向的，你可以试试0, 1, 2, 3这几个值，看看你的图片朝向哪个方向最合适。`tft.init()`就是执行初始化，让屏幕准备就绪。 最关键的一行来了：`tft.jpg("pic1.jpg", 0, 0)`。这就是驱动库提供给我们的“魔法函数”。第一个参数是图片文件名，确保它和你上传的文件名一致（大小写敏感！）。后面两个参数`0, 0`是图片左上角在屏幕上的起始坐标。我们的屏幕坐标系，原点`(0,0)`在左上角，X轴向右增加，Y轴向下增加。所以`(0,0)`就是从左上角开始完整地显示图片。如果你写`tft.jpg("pic1.jpg", 10, 20)`，那么图片就会从距离左边10像素、距离顶部20像素的位置开始显示。调用`.jpg()`方法后，图片数据被解码并送到了屏幕的帧缓冲区，但此时屏幕还没更新。需要再调用一句`tft.show()`，才能真正把帧缓冲区的内容“刷”到屏幕上显示出来。这就好比你在画板上画好了画，`show()`就是把这画板举起来给大家看。 最后`gc.collect()`进行内存回收。代码最后的`main()`是调用这个函数，让程序运行起来。把这段代码保存为`main.py`并上传到开发板（在Thonny里点击“保存”，选择“保存到MicroPython设备”），然后按一下板子上的复位键（RST）或者重新上电，你应该就能在屏幕上看到`pic1.jpg`这张图片了！第一次成功点亮屏幕的喜悦，我相信你一定能体会到。这小小的成功，是你和硬件世界对话的第一步。 ## 5. 进阶实现：打造自动循环播放的图片轮播 显示一张图片很棒，但我们要的是轮播，是幻灯片效果！这其实就是在单张显示的基础上，加一个“循环”和“延时”的逻辑。代码结构几乎一样，只是把显示一张图片的动作，放到一个循环里重复执行。让我们来看轮播版本的代码，你会发现它其实更简单。 ```python """ BPI-Centi-S3 JPG图片轮播 """ import st7789 import tft_config import gc import time # 新增：用于控制延时 # 1. 定义图片列表 pic_list = ["pic1.jpg", "pic2.jpg", "pic3.jpg", "pic4.jpg", "pic5.jpg"] # 你也可以这样写：pic_list = ["family.jpg", "landscape.jpg", "cat.jpg"] def main(): try: # 2. 初始化屏幕 tft = tft_config.config(rotation=1) tft.init() # 3. 主循环：让轮播一直进行下去 while True: for pic_filename in pic_list: # 4. 显示列表中的每一张图片 tft.jpg(pic_filename, 0, 0) tft.show() gc.collect() # 每显示一张图就清理一次内存 # 5. 每张图片显示的时间（单位：秒） time.sleep(3) # 暂停3秒 except BaseException as err: # 错误处理（同上） err_type = err.__class__.__name__ print('Err type:', err_type) from sys import print_exception print_exception(err) finally: tft.deinit() print("tft deinit") main() ``` 这段代码的精髓在于两个循环。最外层的`while True:`是一个无限循环，它保证了除非我们断电或者拔掉电源，否则轮播会一直进行下去。在这个大循环里面，是一个`for`循环：`for pic_filename in pic_list:`。它会依次取出`pic_list`这个列表里的每一个文件名，赋值给变量`pic_filename`，然后执行下面缩进的代码块。于是，对于列表里的每一张图片，代码都会执行一遍`tft.jpg(pic_filename, 0, 0)`、`tft.show()`和`gc.collect()`。显示完一张后，`time.sleep(3)`让程序暂停3秒钟，这3秒就是这张图片在屏幕上停留的时间。3秒过后，`for`循环继续，取下一张图片，如此往复。当列表里最后一张图片显示完，`for`循环结束，但外层的`while True`又让它回到了开头，于是又从第一张图片开始，实现了无尽的轮播。 这里有几个非常实用的细节可以调整，让你的轮播效果更符合心意。首先是**播放间隔**，通过修改`time.sleep()`里的数字来实现。`time.sleep(1)`是1秒，`time.sleep(5)`是5秒。我建议设置在2到5秒之间，太快了看不清楚，太慢了又显得呆板。其次是**图片列表**，你可以随意增删`pic_list`里的文件名，改变播放顺序，或者增加新的图片。只需要把新的JPG文件上传到开发板，然后把文件名加到列表里就行。最后是**错误处理**，我们的代码包含了`try...except`块，如果在显示某张图片时出错（比如文件名写错了，或者图片格式不对），它会打印出错误信息，然后执行`finally`里的`tft.deinit()`关闭屏幕，这样你就知道该去检查哪里了，而不是面对一个黑屏不知所措。 你可以把这个轮播代码上传到开发板的`main.py`，然后复位。现在，你的BPI-Centi-S3就变成一个真正的自动图片轮播器了！看着自己精选的图片一张张划过屏幕，这种亲手创造出一个“活”的装置的感觉，是单纯写软件代码很难比拟的。到这里，核心功能已经完美实现。但作为一个爱折腾的开发者，我们肯定不满足于此，下面我们来聊聊怎么让这个轮播器变得更聪明、更强大。 ## 6. 优化与扩展：让你的轮播器更“聪明” 基础轮播跑起来后，我们可能会想：能不能随机播放？能不能加个渐变切换效果？图片太多内存不够怎么办？别急，这些想法都能实现。MicroPython的灵活性和ESP32-S3的性能给了我们很大的折腾空间。 **首先，我们来试试随机播放。** 这只需要引入一个`random`模块，然后稍微改动一下播放逻辑。把顺序播放的`for`循环，改成从列表中随机挑选一张播放。 ```python import st7789 import tft_config import gc import time import random # 新增随机模块 pic_list = ["pic1.jpg", "pic2.jpg", "pic3.jpg", "pic4.jpg", "pic5.jpg"] def main(): try: tft = tft_config.config(rotation=1) tft.init() while True: # 不再按顺序遍历，而是每次随机选择一张 random_pic = random.choice(pic_list) tft.jpg(random_pic, 0, 0) tft.show() gc.collect() time.sleep(3) except BaseException as err: # ... 错误处理同上 pass finally: tft.deinit() main() ``` 这样，每次循环都会从`pic_list`里随机抽一张图片显示，增加了不确定性带来的趣味性。不过，纯粹的随机可能会导致某张图片连续出现，而另一张很久不出现。如果你想要一个“洗牌”效果，即所有图片都播放一遍，但顺序是随机的，可以这样做：在每次大循环开始时，用`random.shuffle(pic_list)`把列表顺序打乱，然后再用`for`循环顺序播放这个被打乱的列表。播放完一遍后，下次循环再打乱一次。 **其次，是关于内存和性能的优化。** 如果你准备的图片很多、分辨率很高，可能会遇到内存不足的错误。除了之前提到的用`gc.collect()`手动回收，还有几个技巧：一是确保图片尺寸就是170x320，不要上传大图让驱动库在内存里缩放，那非常耗内存。二是在`tft.jpg()`方法之后立即调用`gc.collect()`，及时释放解码缓冲区。三是可以考虑降低JPG的压缩质量来减小文件体积。ESP32-S3有8MB的PSRAM，对于几十张优化后的小图轮播来说，压力不大，但养成良好的内存管理习惯总是好的。 **最后，我们来点更酷的扩展思路。** BPI-Centi-S3板子上不止有屏幕，还有一个旋转编码器和一个全彩色LED。我们完全可以把它们用起来！比如，用旋转编码器来控制播放速度：顺时针转加快切换，逆时针转减慢切换。这需要读取编码器的引脚状态，根据旋转方向动态调整`time.sleep()`里的延时值。再比如，用板载的RGB LED来营造氛围，显示不同图片时，让LED发出不同颜色的光。甚至，你可以利用ESP32-S3的Wi-Fi功能，做一个网络相册：开发板连接上家里的Wi-Fi，定期从指定的网络地址（比如你搭建的一个简单服务器）下载新的图片到文件系统，更新轮播列表。这样，你不需要用USB线，就能远程更新屏幕上显示的内容了。这些扩展涉及更多的模块和代码，但都是从我们这个基础的轮播项目生长出来的自然延伸，每一个都是很好的学习课题。 ## 7. 避坑指南与调试心得 在玩转BPI-Centi-S3和MicroPython的过程中，我踩过不少坑，也总结了一些经验。分享出来，希望能帮你节省时间，少走弯路。 **第一个常见坑：图片显示不出来，或者花屏。** 这个问题十有八九出在图片本身上。请按以下顺序检查：1. **文件名和路径**：代码里写的文件名必须和上传到开发板的文件名**完全一致**，包括后缀`.jpg`。MicroPython在嵌入式设备上通常对大小写敏感。确保文件在根目录，如果放在子文件夹，代码里要写相对路径如`”images/pic1.jpg”`。2. **图片格式**：虽然方法叫`.jpg()`，但它对JPG格式有一定的要求。最好用常见的图片编辑工具另存为标准的、基线优化的JPEG格式。避免使用渐进式JPEG，有些解码库可能不支持。一个简单的检验方法是，用电脑上的图片查看器能正常打开，一般就没问题。3. **图片尺寸**：确保图片宽度<=320，高度<=170。如果图片比屏幕大，它只会显示左上角的一部分，可能不是你预期的效果。4. **内存不足**：如果图片文件太大，解码时会报内存错误。可以在Thonny的Shell里看到具体的错误信息。解决办法就是优化图片尺寸和质量。 **第二个坑：代码上传后没反应，屏幕不亮。** 首先检查`main.py`文件是否成功上传到了开发板根目录。可以在Thonny的文件浏览器里确认。其次，检查代码是否有语法错误。一个快速测试的方法是，在Thonny的Shell里（连接着开发板），逐行输入核心代码，比如`import st7789`, `tft = tft_config.config(1)`, `tft.init()`，看有没有错误提示。如果有`ImportError`，可能是`st7789`或`tft_config`模块不存在，这需要你检查固件是否完整，或者手动上传这些模块文件到开发板。BPI-Centi-S3的出厂固件通常已经包含，但如果你刷了其他固件，可能需要自己装。 **第三个是关于硬件操作的小提示。** BPI-Centi-S3通过USB Type-C供电和通信。在进行文件上传或代码调试时，确保USB线连接稳定，最好使用数据线而非仅充电线。板子上的全彩色LED在正常工作时常亮或慢闪，如果它快速闪烁或熄灭，可能意味着程序崩溃或板子处于下载模式。当你想停止当前的`main.py`程序时，除了复位，还可以在Thonny的Shell里按`Ctrl+C`发送键盘中断，这会停止正在运行的脚本，并回到`>>>`提示符，方便你重新上传或调试代码。 调试是嵌入式开发的一部分，不要怕出错。Thonny的Shell是你最好的朋友，所有的`print()`输出和错误追踪信息都会显示在那里。养成在关键步骤后加`print(“Step 1 done”)`这样的调试语句的习惯，能帮你快速定位问题出在哪一行。最后，善用网络资源。Banana Pi的官方Wiki、GitHub仓库，以及MicroPython和ESP32的社区论坛，里面有大量的示例代码和问题讨论。遇到难题时去搜一搜，很可能别人已经遇到过并解决了。