ESP32S3摄像头系统开发：MicroPython实现图像采集存储与显示

ESP32S3MicroPythonOV2640摄像头

于 2026-07-08 04:59:39 修改

·本内容遵循CC 4.0 BY-SA版权协议

在实际的嵌入式开发项目中，将摄像头、SD卡存储和显示屏集成到一个系统中是常见的需求。立创开发板ESP32S3配合摄像头扩展板，能够实现图像采集、存储和显示的全流程功能。本文将以MicroPython为主要开发环境，详细介绍如何基于ESP32S3开发板搭建完整的图像处理系统。

1. 硬件准备与连接

1.1 核心硬件组件

ESP32S3开发板作为主控制器，需要配合以下外围设备：

OV2640摄像头模块：200万像素CMOS传感器，支持JPEG压缩输出
SD卡模块：通过SPI接口进行数据存储
ST7789显示屏：2.4英寸240x320分辨率TFT LCD

1.2 硬件连接配置

各模块与ESP32S3的引脚连接关系如下：

摄像头模块连接：

TEXT

D0-GPIO21, D1-GPIO17, D2-GPIO18, D3-GPIO16

D4-GPIO40, D5-GPIO38, D6-GPIO1, D7-GPIO3

XCLK-GPIO2, PCLK-GPIO39, HREF-GPIO4, VSYNC-GPIO5

SIOC-GPIO6, SIOD-GPIO7

显示屏连接：

TEXT

SCK-GPIO41, MOSI-GPIO46, MISO-GPIO48

DC-GPIO42, RST-GPIO15, CS-GPIO45, BLK-GPIO44

SD卡模块连接：

TEXT

SCK-GPIO13, MOSI-GPIO12, MISO-GPIO14

CS-GPIO11

注意：实际连接时需确认扩展板的引脚定义，不同版本的扩展板可能存在差异。

2. 开发环境搭建

2.1 MicroPython固件编译

由于标准MicroPython固件不包含摄像头和显示屏驱动，需要自行编译定制固件。

环境准备：

BASH

# 安装必要的依赖包

sudo apt-get install git wget libncurses-dev flex bison gperf \

python3 python3-pip python3-setuptools python3-serial \

python3-click python3-cryptography python3-future \

python3-pyparsing python3-pyelftools cmake ninja-build \

ccache libffi-dev libssl-dev python-is-python3

# 配置pip镜像源

pip config set global.index-url http://mirrors.aliyun.com/pypi/simple

pip config set global.trusted-host mirrors.aliyun.com

获取源码并编译：

BASH

# 创建工作目录

mkdir -p ~/esp

cd ~/esp

# 克隆ESP-IDF和MicroPython源码

git clone https://gitee.com/EspressifSystems/esp-idf.git

git clone https://github.com/micropython/micropython.git

# 切换到稳定版本

cd esp-idf

git checkout v5.0.4

# 初始化子模块

git submodule update --init --recursive

# 安装ESP-IDF工具

./install.sh

source export.sh

# 编译MicroPython交叉编译器

cd ~/esp/micropython

make -C mpy-cross

# 添加摄像头驱动

cd ~/esp/esp-idf/components

git clone https://github.com/espressif/esp32-camera.git

# 添加显示屏驱动

cd ~/esp/micropython

git clone https://github.com/russhughes/st7789_mpy.git

配置编译选项： 修改 ~/esp/micropython/ports/esp32/Makefile 文件：

MAKEFILE

BOARD ?= ESP32_GENERIC_S3

执行编译：

BASH

cd ~/esp/micropython/ports/esp32

make submodules

make

编译成功后，在 build-ESP32_GENERIC_S3/ 目录下生成 firmware.bin 文件。

2.2 固件烧录

使用esptool.py工具烧录固件：

BASH

esptool.py --chip esp32s3 --port /dev/ttyUSB0 --baud 460800 \

--before default_reset --after hard_reset write_flash \

--flash_mode dio --flash_freq 80m --flash_size 16MB \

0x0 firmware.bin

注意：烧录前需要将开发板置于下载模式，通常需要按住BOOT按钮再按RESET按钮。

3. 基础功能验证

3.1 摄像头功能测试

连接开发板后，通过REPL界面测试摄像头功能：

PYTHON

import camera

import micropython

import esp

# 检查内存信息

micropython.mem_info()

print("Flash size:", esp.flash_size()//1024//1024, "MB")

# 初始化摄像头

camera.init(0,

d0=21, d1=17, d2=18, d3=16,

d4=40, d5=38, d6=1, d7=3,

format=camera.JPEG,

framesize=camera.FRAME_QVGA, # 320x240

fb_location=camera.PSRAM,

xclk_freq=camera.XCLK_20MHz,

href=4, vsync=5,

sioc=6, siod=7, xclk=2, pclk=39)

# 捕获一帧图像

frame = camera.capture()

print("Frame size:", len(frame), "bytes")

# 释放摄像头资源

camera.deinit()

3.2 显示屏功能测试

PYTHON

from machine import SPI, Pin

import st7789

import time

# 初始化SPI和显示屏

spi = SPI(2, baudrate=40000000, sck=Pin(41), mosi=Pin(46), miso=Pin(48))

tft = st7789.ST7789(spi, 240, 320,

reset=Pin(15, Pin.OUT),

dc=Pin(42, Pin.OUT),

cs=Pin(45, Pin.OUT),

inversion=False)

tft.init()

# 显示测试图案

tft.fill(st7789.RED) # 红色全屏

time.sleep(0.5)

tft.fill(st7789.GREEN) # 绿色全屏

time.sleep(0.5)

tft.fill(st7789.BLUE) # 蓝色全屏

# 绘制图形

tft.rect(10, 10, 100, 50, st7789.WHITE) # 白色矩形框

tft.fill_rect(15, 15, 90, 40, st7789.YELLOW) # 黄色填充矩形

3.3 SD卡功能测试

PYTHON

import sdcard

from machine import SoftSPI, Pin

import os

# 初始化SD卡

sd_spi = SoftSPI(2, sck=Pin(13), mosi=Pin(12), miso=Pin(14))

sd = sdcard.SDCard(sd_spi, Pin(11))

# 挂载文件系统

os.mount(sd, '/sd')

# 测试文件读写

with open('/sd/test.txt', 'w') as f:

f.write('Hello, SD Card!')

with open('/sd/test.txt', 'r') as f:

content = f.read()

print("File content:", content)

# 卸载文件系统

os.umount('/sd')

4. 完整系统集成

4.1 实时图像显示系统

将摄像头捕获的图像实时显示在屏幕上：

PYTHON

import camera

import st7789

from machine import SPI, Pin

import time

# 初始化显示屏

spi = SPI(2, baudrate=40000000, sck=Pin(41), mosi=Pin(46))

tft = st7789.ST7789(spi, 240, 320,

reset=Pin(15), dc=Pin(42), cs=Pin(45))

tft.init()

# 初始化摄像头

camera.init(0,

d0=21, d1=17, d2=18, d3=16,

d4=40, d5=38, d6=1, d7=3,

format=camera.JPEG,

framesize=camera.FRAME_QVGA,

fb_location=camera.PSRAM,

xclk_freq=camera.XCLK_20MHz,

href=4, vsync=5,

sioc=6, siod=7, xclk=2, pclk=39)

print("Starting real-time display...")

while True:

try:

# 捕获并显示图像

jpeg_data = camera.capture()

tft.jpg(jpeg_data, 0, 0)

time.sleep(0.1) # 控制帧率

except Exception as e:

print("Error:", e)

break

camera.deinit()

4.2 图像采集与存储系统

实现定时拍照并保存到SD卡的功能：

PYTHON

import camera

import sdcard

from machine import SoftSPI, Pin

import os

import time

# 初始化SD卡

sd_spi = SoftSPI(2, sck=Pin(13), mosi=Pin(12), miso=Pin(14))

sd = sdcard.SDCard(sd_spi, Pin(11))

os.mount(sd, '/sd')

# 初始化摄像头

camera.init(0,

d0=21, d1=17, d2=18, d3=16,

d4=40, d5=38, d6=1, d7=3,

format=camera.JPEG,

framesize=camera.FRAME_SVGA, # 800x600

fb_location=camera.PSRAM,

xclk_freq=camera.XCLK_20MHz,

href=4, vsync=5,

sioc=6, siod=7, xclk=2, pclk=39)

photo_count = 0

max_photos = 10 # 最大拍照数量

while photo_count < max_photos:

try:

# 生成文件名

filename = '/sd/photo_{:03d}.jpg'.format(photo_count)

# 捕获图像

jpeg_data = camera.capture()

# 保存到SD卡

with open(filename, 'wb') as f:

f.write(jpeg_data)

print('Photo saved:', filename)

photo_count += 1

# 间隔5秒

time.sleep(5)

except Exception as e:

print('Error capturing photo:', e)

break

# 清理资源

camera.deinit()

os.umount('/sd')

print('Image capture completed.')

5. 常见问题与解决方案

5.1 摄像头初始化失败

问题现象： camera.init() 返回 False 或抛出异常。

可能原因及解决方案：

引脚配置错误
- 检查D0-D7数据线连接是否正确
- 确认XCLK、PCLK时钟信号线连接
电源问题
- 确保摄像头模块供电稳定（3.3V）
- 检查电源电流是否足够（OV2640工作电流约120mA）
PSRAM配置
- 确认固件支持PSRAM
- 在初始化时设置 fb_location=camera.PSRAM

5.2 显示屏显示异常

问题现象： 花屏、颜色异常或无显示。

排查步骤：

检查SPI配置

PYTHON

# 确认SPI频率和模式

spi = SPI(2, baudrate=40000000, polarity=0, phase=0)
验证引脚连接
- 使用万用表检查SCK、MOSI、DC、RST等信号线
- 确认背光控制线连接正确
调整显示参数

PYTHON

# 尝试不同的颜色顺序和反转设置

tft = st7789.ST7789(spi, 240, 320, color_order=st7789.RGB, inversion=True)

5.3 SD卡读写错误

问题现象： 文件系统挂载失败或文件读写错误。

解决方案：

检查SD卡格式
- 使用FAT32文件系统格式化SD卡
- 避免使用exFAT或NTFS格式
调整SPI频率

PYTHON

# 降低SPI频率尝试

sd_spi = SoftSPI(2, sck=Pin(13), mosi=Pin(12), miso=Pin(14), baudrate=1000000)
电源稳定性
- SD卡模块需要稳定的3.3V供电
- 在数据线串联33Ω电阻改善信号质量

6. 性能优化建议

6.1 内存管理优化

MicroPython环境下需要特别注意内存使用：

PYTHON

import gc

# 在内存密集型操作后主动垃圾回收

def capture_and_process():

frame = camera.capture()

# 处理图像...

del frame # 及时删除大对象

gc.collect() # 强制垃圾回收

6.2 图像传输优化

对于实时应用，优化图像数据传输：

PYTHON

# 使用较低的图像分辨率提高帧率

camera.init(0, framesize=camera.FRAME_QVGA) # 320x240

# 或者使用灰度图像减少数据量

camera.init(0, format=camera.GRAYSCALE)

6.3 电源管理

对于电池供电的应用场景：

PYTHON

from machine import deepsleep

# 在空闲时进入深度睡眠

def sleep_until_next_capture():

# 保存状态并进入深度睡眠

camera.deinit()

# 睡眠10秒

deepsleep(10000)

7. 项目扩展方向

基于这个基础框架，可以进一步开发更复杂的应用：

7.1 运动检测监控系统

PYTHON

import camera

import time

class MotionDetector:

def __init__(self, threshold=1000):

self.threshold = threshold

self.last_frame = None

def detect_motion(self, current_frame):

if self.last_frame is None:

self.last_frame = current_frame

return False

# 简单的帧差法运动检测

diff = self.calculate_difference(current_frame, self.last_frame)

self.last_frame = current_frame

return diff > self.threshold

def calculate_difference(self, frame1, frame2):

# 实现图像差异计算

pass

7.2 时间 lapse摄影系统

PYTHON

import camera

import sdcard

import os

import time

class TimeLapse:

def __init__(self, interval=60): # 默认60秒间隔

self.interval = interval

self.photo_count = 0

def start_capture(self, duration=3600): # 默认拍摄1小时

start_time = time.time()

while time.time() - start_time < duration:

self.capture_photo()

time.sleep(self.interval)

7.3 无线图传系统

结合WiFi功能实现远程监控：

PYTHON

import network

import socket

import camera

class WirelessCamera:

def __init__(self, ssid, password):

self.wlan = network.WLAN(network.STA_IF)

self.connect_wifi(ssid, password)

def connect_wifi(self, ssid, password):

self.wlan.active(True)

self.wlan.connect(ssid, password)

while not self.wlan.isconnected():

time.sleep(1)

def start_streaming_server(self, port=8000):

# 实现HTTP视频流服务器

pass

这个完整的ESP32S3摄像头系统为各种嵌入式视觉应用提供了坚实的基础。通过MicroPython的高级抽象，开发者可以快速实现功能原型，而硬件的强大性能又保证了系统的实用性。在实际项目中，可以根据具体需求选择不同的优化策略和扩展方向。