This program is designed for the ESP32-S3-EYE development kit.
Upload a jpeg image to Adafruit IO at regular intervals
This example requires:
- ESP32-S3-EYE development kit from Espressif
To use, you must set up WiFi and Adafruit IO:
- On io.adafruit.com, create a feed named "image" and turn OFF history
- On io.adafruit.com, create a dashboard and add an "image" block using the feed "image" as its data
- Set up CIRCUITPY/.env with WiFI and Adafruit IO credentials
Your project will use a specific set of CircuitPython libraries and the code.py file. To get everything you need, click on the Download Project Bundle link below, and uncompress the .zip file.
Drag the contents of the uncompressed bundle directory onto your Feather board's CIRCUITPY drive, replacing any existing files or directories with the same names, and adding any new ones that are necessary.
When the new code starts, it will upload an image to Adafruit IO approximately every 10 seconds.
# SPDX-FileCopyrightText: Copyright (c) 2022 Jeff Epler for Adafruit Industries
#
# SPDX-License-Identifier: MIT
"""
Upload a jpeg image to Adafruit IO at regular intervals
This example requires:
* ESP32-S3-EYE development kit from Espressif
To use:
* On io.adafruit.com, create a feed named "image" and turn OFF history
* On io.adafruit.com, create a dashboard and add an "image" block
using the feed "image" as its data
* Set up CIRCUITPY/.env with WiFI and Adafruit IO credentials
* Copy the project bundle to CIRCUITPY
"""
import binascii
import io
import os
import ssl
import time
import adafruit_minimqtt.adafruit_minimqtt as MQTT
from adafruit_io.adafruit_io import IO_MQTT
import board
import espcamera
import socketpool
import wifi
aio_username = os.getenv('AIO_USERNAME')
aio_key = os.getenv('AIO_KEY')
image_feed = "image"
cam = espcamera.Camera(
data_pins=board.CAMERA_DATA,
external_clock_pin=board.CAMERA_XCLK,
pixel_clock_pin=board.CAMERA_PCLK,
vsync_pin=board.CAMERA_VSYNC,
href_pin=board.CAMERA_HREF,
pixel_format=espcamera.PixelFormat.JPEG,
frame_size=espcamera.FrameSize.SVGA,
i2c=board.I2C(),
external_clock_frequency=20_000_000,
grab_mode=espcamera.GrabMode.WHEN_EMPTY)
cam.vflip = True
pool = socketpool.SocketPool(wifi.radio)
print("Connecting to Adafruit IO")
mqtt_client = MQTT.MQTT(
broker="io.adafruit.com",
username=aio_username,
password=aio_key,
socket_pool=pool,
ssl_context=ssl.create_default_context(),
)
mqtt_client.connect()
io = IO_MQTT(mqtt_client)
while True:
frame = cam.take(1)
if isinstance(frame, memoryview):
jpeg = frame
print(f"Captured {len(jpeg)} bytes of jpeg data")
# b2a_base64() appends a trailing newline, which IO does not like
encoded_data = binascii.b2a_base64(jpeg).strip()
print(f"Expanded to {len(encoded_data)} for IO upload")
io.publish("image", encoded_data)
time.sleep(10)
How it works
Many parts of this example are similar to the previous one, but the explanations are not repeated.
For this example you'll need to configure your CIRCUITPY/.env file properly. It will need to contain the following keys. The values depend on your WiFi and adafruit io settings.
AIO_KEY=YourAioKey AIO_USERNAME=YourAioUsername CIRCUITPY_WEB_API_PASSWORD=YourWebApiPassword CIRCUITPY_WIFI_PASSWORD=YourWifiPassword CIRCUITPY_WIFI_SSID=YourWifiName
Adafruit IO Credentials
Adafruit IO Credentials are stored in the CIRCUITPY/.env file and retrieved using dotenv:
aio_username = os.getenv('/.env', 'AIO_USERNAME')
aio_key = os.getenv('/.env', 'AIO_KEY')
The WiFi interface is assumed to be configured for the web workflow, so we skip making a connection ourselves and skip directly to creating the connection to Adafruit IO:
pool = socketpool.SocketPool(wifi.radio)
print("Connecting to Adafruit IO")
mqtt_client = MQTT.MQTT(
broker="io.adafruit.com",
username=aio_username,
password=aio_key,
socket_pool=pool,
ssl_context=ssl.create_default_context(),
)
mqtt_client.connect()
io = IO_MQTT(mqtt_client)
We wait for a JPEG image capture to be ready from the camera. Then, we encode it in a specific way that Adafruit IO understands, and upload it. This repeats forever, waiting 10 seconds between image captures.
while True:
frame = cam.take(1)
if isinstance(frame, memoryview):
jpeg = frame
print(f"Captured {len(jpeg)} bytes of jpeg data")
# b2a_base64() appends a trailing newline, which IO does not like
encoded_data = binascii.b2a_base64(jpeg).strip()
print(f"Expanded to {len(encoded_data)} for IO upload")
io.publish("image", encoded_data)
time.sleep(10)
Text editor powered by tinymce.
