Progetto open-source ESP32-CAM

Gizmo Camera

Una fotocamera Wi-Fi con ESP32-CAM che scatta una foto JPEG a ogni richiesta, con una web app per configurarla dal telefono e un server MCP per gli agenti AI.

  • Foto JPEG fino a 1600 × 1200
  • API HTTP semplice
  • Server MCP per agenti AI
Difficoltà
Principiante
Tempo di montaggio
15 min
Saldatura
Nessuna saldatura
La Gizmo Camera nel suo case stampato bianco e arancione sul supporto a snodo sferico, e smontata nel guscio, nell'ESP32-CAM sulla sua scheda MB, nel pannello posteriore, nelle quattro viti M3 e nel supporto.

Panoramica del progetto

Una panoramica rapida dell'hardware, del firmware e del comportamento che rendono utile questa build.

Fotocamera

01

Il sensore OV2640 e il LED flash bianco dell'ESP32-CAM AI Thinker, con foto da 160 × 120 fino a 1600 × 1200 e qualità JPEG regolabile.

API HTTP

02

Ogni foto è una richiesta GET a /api/capture che restituisce un JPEG, con risoluzione, qualità e flash come opzioni, così browser, script e server di domotica possono usarla allo stesso modo.

Agenti AI

03

Un server MCP su /mcp permette ad agenti come Claude Code di guardare attraverso la fotocamera con lo strumento take_snapshot, e una guida in Markdown su /llms.txt spiega come usarlo.

Setup iniziale

04

Caricamento del firmware dal browser, poi configurazione da un hotspot al primo avvio e accesso locale con gizmo-camera.local sulle reti supportate. Nessun codice da modificare e nessuna credenziale nel firmware.

Panoramica

Gizmo Camera dà a un modulo ESP32-CAM economico un vero lavoro: una fotocamera sulla tua rete che risponde a ogni richiesta con una foto appena scattata. Puntala su una stampante 3D, una pianta o una porta, e qualunque cosa possa fare una richiesta HTTP vede quello che vede lei. Gli agenti AI la trovano come server MCP, così possono guardare attraverso di essa anche loro.

  • Foto JPEG su richiesta, fino a 1600 × 1200 con l'OV2640, e il LED flash per le scene buie
  • Una web app integrata nel firmware, per configurare la fotocamera e scattare foto dal telefono
  • Una piccola API HTTP che script e altri dispositivi possono chiamare direttamente
  • Un server MCP e una guida in Markdown, così gli agenti AI possono usare la fotocamera da soli

Come funziona

Ogni foto, chiunque la chieda, segue lo stesso breve percorso.

PassoCosa succede
RichiestaLa web app, uno script o qualsiasi client HTTP chiama /api/capture con risoluzione, qualità e flash. Un agente AI chiede lo stesso chiamando take_snapshot sul server MCP.
ScattoIl firmware applica le opzioni al sensore, accende il flash se richiesto e scatta un fotogramma nuovo.
InvioIl JPEG viene trasmesso direttamente dalla memoria della fotocamera al client, con risoluzione e tempo di scatto negli header della risposta.

La fotocamera scatta una foto alla volta: una richiesta che arriva mentre ne sta scattando un'altra riceve una risposta chiara di fotocamera occupata, così può semplicemente riprovare poco dopo.

Perché è utile

Gizmo Camera trasforma pochi euro di hardware in una fotocamera che persone, script e agenti AI possono usare allo stesso modo. È anche un modello compatto per qualsiasi dispositivo ESP32 che deve essere facile da usare dal codice.

  • Controlla una stampa, una pianta o una porta dal telefono, senza app né account cloud.
  • Prendi foto da script e domotica con una sola richiesta HTTP.
  • Dai a un agente AI occhi sul mondo fisico, sulla tua rete.

La web app

Quello che vedi sul telefono quando il dispositivo è collegato al tuo Wi-Fi.

La schermata della fotocamera nella web app, con l'ultima foto (un'immagine di prova a 1600 × 1200), il suo peso e il tempo di scatto, e i pulsanti per scattarne una nuova e salvarla.
La schermata della fotocamera prima della prima foto, con il pulsante per scattare e le opzioni di risoluzione e qualità.
La schermata del Wi-Fi, con la rete attuale e le reti nelle vicinanze.

Cosa ti serve

I componenti da procurarti prima di iniziare, e a cosa fare attenzione quando li compri.

  • 1×

    ESP32-CAM AI Thinker

    Con la fotocamera OV2640 e i 4 MB di PSRAM che servono al firmware: ogni modulo AI Thinker li ha entrambi.

  • 1×

    Scheda USB ESP32-CAM-MB

    L'adattatore USB in cui si inserisce l'ESP32-CAM, per caricare il firmware e alimentarla: l'ESP32-CAM non ha una porta USB propria.

  • 1×

    Cavo USB dati micro-USB

    Un cavo dati, non solo di ricarica, su una buona porta USB o un alimentatore da 5 V: il LED flash e il Wi-Fi assorbono picchi di corrente.

Flusso di setup

Segui questi passaggi per avviare il progetto, dai primi step locali fino al primo upload o alla prima configurazione.

  1. 01

    Passaggio 1

    Inserisci l'ESP32-CAM nella sua scheda MB e collegala via USB

    L'ESP32-CAM non ha una porta USB propria: inseriscila nella sua scheda USB ESP32-CAM-MB e collegala al computer con un cavo USB dati. Usa Chrome o Edge, così lo strumento di caricamento nel browser trova la sua porta seriale.

  2. 02

    Passaggio 2

    Carica il firmware già compilato da questa pagina

    Scorri fino alla scheda di caricamento del firmware, avvia il trasferimento dal browser e attendi che finisca. Se lo strumento non riesce a collegarsi, tieni premuto IO0 sulla scheda MB, premi e rilascia RST, poi rilascia IO0 e riprova. Alla fine, premi RST per avviare il nuovo firmware.

  3. 03

    Passaggio 3

    Collega la fotocamera al tuo Wi-Fi

    Al primo avvio, collegati all'hotspot Gizmo-Camera con il telefono e scegli la tua rete nella pagina che si apre. Il Wi-Fi viene salvato sulla scheda, mai nel firmware.

  4. 04

    Passaggio 4

    Apri gizmo-camera.local e scatta una foto

    Quando la fotocamera si collega al Wi-Fi, apri gizmo-camera.local, o il suo indirizzo IP, scegli risoluzione, qualità e flash, e scatta una foto. Salvala come JPEG, oppure prendine una da uno script con una semplice richiesta HTTP.

    Terminale
    curl -o photo.jpg "http://gizmo-camera.local/api/capture?resolution=SVGA"

Domande frequenti

Alcune risposte pratiche su come funziona il progetto, come si configura e cosa aspettarsi dall'hardware.

Per tutto ciò che vuoi controllare ogni tanto: una stampante 3D, una pianta, una porta o un posto auto. Scatta una foto nuova ogni volta che qualcuno la chiede, dalla web app, da uno script, da un server di domotica o da un agente AI.

Codice sorgente

Guarda Gizmo Camera su GitHub

Apri il repository per vedere firmware, note hardware e dettagli di implementazione dietro questa build.

Apri GitHub
Illustrazione del progetto OpenGizmo su GitHub
Open source

Vedi anche

Altri progetti ESP32 open source da costruire dopo questo.