[{"data":1,"prerenderedAt":632},["ShallowReactive",2],{"post-esp32-cam-snapshot-http-capture-jpeg-it":3,"related-posts-esp32-cam-snapshot-http-capture-jpeg-it":576,"related-categories-esp32-cam-snapshot-http-capture-jpeg-it":610,"blog-project-detail-card-gizmo-camera-it":623},{"id":4,"title":5,"author":6,"authorImageUrl":7,"authorUrl":8,"body":9,"categorySlug":538,"categoryText":539,"dateModified":540,"datePublished":540,"description":541,"extension":542,"faqs":543,"image":559,"imageAlt":560,"language":561,"meta":562,"navigation":563,"path":564,"seo":565,"sitemap":566,"stem":567,"summary":568,"tags":569,"__hash__":575},"blog\u002Fit\u002Fblog\u002Fesp32-cam-snapshot-http-capture-jpeg.md","Snapshot ESP32-CAM via URL: una richiesta, un JPEG","Mauro Brambilla","\u002Fimages\u002Fauthors\u002Fbruma.jpg","\u002Fabout",{"type":10,"value":11,"toc":524},"minimark",[12,25,56,60,65,89,92,97,100,104,112,117,133,148,152,155,165,184,189,195,199,233,240,244,264,268,276,294,305,309,324,327,331,334,340,348,354,365,379,383,404,408,418,422,425,438,446,455,459,475,491,495,512],[13,14,15,16,20,21,24],"p",{},"Lo snapshot di una ESP32-CAM è una singola richiesta HTTP GET che restituisce un singolo JPEG. Con il firmware di Gizmo Camera l'URL è ",[17,18,19],"code",{},"http:\u002F\u002Fgizmo-camera.local\u002Fapi\u002Fcapture?resolution=SVGA",": la ESP32-CAM scatta una foto nuova, la invia e chiude la connessione. La stessa richiesta funziona da browser, con ",[17,22,23],{},"curl",", da uno script o da Home Assistant.",[13,26,27,28,33,34,36,37,43,44,49,50,55],{},"Ti serve una foto dalla ESP32-CAM dentro uno script, e non una pagina video da tenere aperta? In questo post vediamo gli endpoint veri di ",[29,30,32],"a",{"href":31},"\u002Fit\u002Fprojects\u002Fgizmo-camera","Gizmo Camera",", i comandi ",[17,35,23],{}," da copiare e incollare, le opzioni di risoluzione e qualità, e cosa risponde la camera quando due client la interrogano insieme. Tutto arriva dal codice sorgente del firmware nel ",[29,38,42],{"href":39,"rel":40},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-camera",[41],"nofollow","repository gizmo-camera",", dall'",[29,45,48],{"href":46,"rel":47},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Ftree\u002Fmaster\u002Flibraries\u002FESP32\u002Fexamples\u002FCamera\u002FCameraWebServer",[41],"esempio Arduino CameraWebServer"," con cui lo confronto e dalla documentazione del ",[29,51,54],{"href":52,"rel":53},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Fesp32-camera",[41],"driver esp32-camera",". Non ho fatto benchmark, quindi qui non trovi numeri sulla velocità.",[57,58],"project-detail-card",{"project-slug":59},"gizmo-camera",[61,62,64],"h2",{"id":63},"che-differenza-cè-tra-snapshot-e-stream","Che differenza c'è tra snapshot e stream?",[13,66,67,68,72,73,76,77,80,81,84,85,88],{},"Uno ",[69,70,71],"strong",{},"snapshot"," è una richiesta e un'immagine: il client chiede, la camera cattura un frame e la connessione finisce. Uno ",[69,74,75],{},"stream"," è una connessione che resta aperta mentre la camera continua a mandare frame. Nell'esempio CameraWebServer standard, ",[17,78,79],{},"\u002Fcapture"," è lo snapshot (il suo handler non legge nessun parametro della query, quindi non ci sono opzioni da aggiungere all'URL), mentre ",[17,82,83],{},"\u002Fstream"," è una risposta ",[17,86,87],{},"multipart\u002Fx-mixed-replace"," che va avanti finché il client non se ne va, servita da un secondo server HTTP su una porta sopra la prima.",[13,90,91],{},"Sono quindi due strumenti diversi. La tabella confronta a cosa serve ciascuno, in base al sorgente di CameraWebServer e a quello di Gizmo Camera.",[93,94],"blog-table",{":headers":95,":rows":96},"[\"\",\"Snapshot (\u002Fcapture, \u002Fapi\u002Fcapture)\",\"Stream MJPEG (\u002Fstream)\"]","[[\"Connessione\",\"Chiusa dopo un JPEG\",\"Aperta finché il client non se ne va\"],[\"Codice del client\",\"Una GET, qualsiasi libreria HTTP\",\"Un client che sa leggere le parti multipart\"],[\"Lavoro della camera\",\"Solo quando qualcuno chiede\",\"Un ciclo che non si ferma mai finché c'è chi guarda\"],[\"Ideale per\",\"Script, cron job, Home Assistant, agenti\",\"Guardare dal vivo nel browser\"],[\"In Gizmo Camera\",\"Sì: \u002Fapi\u002Fcapture\",\"No: non c'è\"]]",[13,98,99],{},"Gizmo Camera non ha uno stream, ed è voluto: il suo README descrive una camera che \"answers every request with a fresh photo\". Se invece vuoi il video dal vivo, l'esempio CameraWebServer è il punto di partenza più semplice, e il resto di questo post riguarda la strada dello snapshot.",[61,101,103],{"id":102},"come-si-ottiene-un-jpeg-con-curl","Come si ottiene un JPEG con curl?",[13,105,106,107,111],{},"Ti serve una camera con il firmware di Gizmo Camera, sulla stessa rete del tuo computer. Se sei ancora alla fase del flashing, la ",[29,108,110],{"href":109},"\u002Fit\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide","guida alla ESP32-CAM-MB"," la spiega. Poi basta un comando:",[113,114],"terminal",{":commands":115,"title":116},"[\"curl -o photo.jpg \\\"http:\u002F\u002Fgizmo-camera.local\u002Fapi\u002Fcapture?resolution=SVGA\\\"\"]","Scatta una foto e salvala",[13,118,119,120,123,124,127,128,132],{},"È il comando del README del progetto. Apri ",[17,121,122],{},"photo.jpg",": dovresti vedere ciò che vede la camera, a 800 x 600. Se ",[17,125,126],{},"gizmo-camera.local"," non si risolve sul tuo computer, usa l'indirizzo IP della camera, che trovi nel router e nella pagina della camera della web app. I motivi sono nella ",[29,129,131],{"href":130},"\u002Fit\u002Fblog\u002Fesp32-mdns-local-hostname-not-working","guida all'hostname .local",".",[13,134,135,136,139,140,143,144,147],{},"Prima di esultare, guarda anche gli header. Aggiungi ",[17,137,138],{},"-D -"," per stamparli (l'opzione ",[17,141,142],{},"-D"," scrive gli header ricevuti in un file, e ",[17,145,146],{},"-"," significa standard output):",[113,149],{":commands":150,"title":151},"[\"curl -sS -D - -o \u002Fdev\u002Fnull \\\"http:\u002F\u002Fgizmo-camera.local\u002Fapi\u002Fcapture?resolution=SVGA\\\"\"]","Leggi gli header della risposta",[13,153,154],{},"La risposta dovrebbe essere simile a questa, con il tuo tempo di cattura:",[156,157,163],"pre",{"className":158,"code":160,"language":161,"meta":162},[159],"language-http","HTTP\u002F1.1 200 OK\nContent-Type: image\u002Fjpeg\nContent-Disposition: inline; filename=snapshot.jpg\nCache-Control: no-store\nX-Resolution: 800x600\nX-Capture-Time-Ms: \u003Cmilliseconds>\n","http","",[17,164,160],{"__ignoreMap":162},[13,166,167,168,171,172,175,176,179,180,183],{},"Arrivano direttamente da ",[17,169,170],{},"capture.get.cpp",": ",[17,173,174],{},"X-Resolution"," è la dimensione reale del frame restituito dal sensore, ",[17,177,178],{},"X-Capture-Time-Ms"," è il tempo che la cattura ha richiesto sulla camera (non il trasferimento) e ",[17,181,182],{},"Cache-Control: no-store"," dice ai proxy che ogni richiesta è una foto nuova.",[185,186,188],"h3",{"id":187},"quali-opzioni-accetta-apicapture","Quali opzioni accetta \u002Fapi\u002Fcapture?",[13,190,191,192,132],{},"Tre parametri della query, tutti facoltativi e combinabili. Il firmware li legge in ",[17,193,194],{},"capture_options.cpp",[93,196],{":headers":197,":rows":198},"[\"Parametro\",\"Valori\",\"Default\"]","[[\"resolution\",\"Un nome della tabella qui sotto, maiuscole o minuscole\",\"La più grande che il sensore supporta (UXGA sull'OV2640)\"],[\"quality\",\"Un numero intero da 4 a 63, più basso è più nitido e più pesante\",\"10\"],[\"flash\",\"1, true, 0 o false\",\"Spento\"]]",[13,200,201,202,205,206,209,210,213,214,217,218,221,222,225,226,229,230,132],{},"Un esempio completo è ",[17,203,204],{},"\u002Fapi\u002Fcapture?resolution=XGA&quality=12&flash=1",". Un valore sbagliato viene rifiutato con HTTP 400 e un errore JSON, e nessuna foto viene scattata: ",[17,207,208],{},"invalid_resolution",", ",[17,211,212],{},"resolution_not_supported"," (una dimensione più grande di quella che il sensore supporta), ",[17,215,216],{},"invalid_quality"," o ",[17,219,220],{},"invalid_flash",". Il corpo ha questa forma: ",[17,223,224],{},"{ \"errorId\": \"invalid_quality\", \"errorMessage\": \"...\", \"data\": null }",", la stessa di tutti i dispositivi OpenGizmo. Per sapere cosa supporta una camera in particolare, chiedi ",[17,227,228],{},"GET \u002Fapi\u002Fcamera",": restituisce il nome del sensore, l'elenco delle risoluzioni con le loro dimensioni, l'intervallo di qualità e ",[17,231,232],{},"hasFlash",[13,234,235],{},[236,237],"img",{"alt":238,"src":239},"I cinque passi di GET \u002Fapi\u002Fcapture: controllare le opzioni, prendere la camera, scartare i frame vecchi, catturare un JPEG, inviarlo e liberare il buffer","\u002Fimages\u002Fblog\u002Fit\u002Fesp32-cam-snapshot-http-capture-jpeg-request.webp",[61,241,243],{"id":242},"come-si-scelgono-risoluzione-e-qualità-jpeg","Come si scelgono risoluzione e qualità JPEG?",[13,245,246,247,250,251,255,256,259,260,263],{},"Le dimensioni sono i valori ",[17,248,249],{},"framesize_t"," del ",[29,252,54],{"href":253,"rel":254},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Fesp32-camera\u002Fblob\u002Fmaster\u002Fdriver\u002Finclude\u002Fsensor.h",[41],", che il firmware associa a dei nomi in ",[17,257,258],{},"capture_options.h"," e ",[17,261,262],{},"camera.cpp",". Il README elenca queste nove per l'OV2640; il firmware ne conosce di più grandi per sensori più capaci come l'OV3660 e l'OV5640, e taglia l'elenco a ciò che il sensore collegato dichiara.",[93,265],{":headers":266,":rows":267},"[\"Nome nell'URL\",\"Costante del driver\",\"Dimensione (px)\"]","[[\"QQVGA\",\"FRAMESIZE_QQVGA\",\"160 x 120\"],[\"QVGA\",\"FRAMESIZE_QVGA\",\"320 x 240\"],[\"CIF\",\"FRAMESIZE_CIF\",\"400 x 296\"],[\"VGA\",\"FRAMESIZE_VGA\",\"640 x 480\"],[\"SVGA\",\"FRAMESIZE_SVGA\",\"800 x 600\"],[\"XGA\",\"FRAMESIZE_XGA\",\"1024 x 768\"],[\"HD\",\"FRAMESIZE_HD\",\"1280 x 720\"],[\"SXGA\",\"FRAMESIZE_SXGA\",\"1280 x 1024\"],[\"UXGA\",\"FRAMESIZE_UXGA\",\"1600 x 1200\"]]",[13,269,270,271,275],{},"Come scegliere? Parti da SVGA: è ciò che la guida per gli agenti di Gizmo Camera consiglia per capire una scena, ed è il default del ",[29,272,274],{"href":273},"\u002Fit\u002Fblog\u002Fesp32-mcp-server-claude-code","server MCP",". Passa a UXGA solo quando ti servono i dettagli piccoli, perché il README avverte che un JPEG da 1600 x 1200 pesa qualche centinaio di KB via Wi-Fi. Scendi a VGA o QVGA per una miniatura di stato.",[13,277,278,279,283,284,286,287,290,291,132],{},"La qualità JPEG funziona al contrario di come molti si aspettano. Il ",[29,280,282],{"href":52,"rel":281},[41],"README di esp32-camera"," dice che l'intervallo va da 0 a 63 per i sensori OV e che \"lower number means higher quality\". Gizmo Camera accetta da 4 a 63, e un commento in ",[17,285,258],{}," spiega il limite: sotto 4 il frame buffer può andare in overflow alla risoluzione più alta. Anche la dimensione del file dipende dalla scena, quindi non do cifre: cambia ",[17,288,289],{},"quality"," e confronta tu ",[17,292,293],{},"Content-Length",[13,295,296,297,300,301,132],{},"Due dettagli su come la camera applica le tue opzioni vale la pena conoscerli. Dopo un cambio di risoluzione o di qualità, il firmware scarta tre frame prima di quello che invia, perché i primi frame dopo una modifica delle impostazioni possono essere corrotti o usare ancora le impostazioni vecchie. Per una richiesta invariata scarta un frame vecchio, così ricevi una foto scattata dopo la tua richiesta e non una rimasta nel buffer. Con ",[17,298,299],{},"flash=1"," ne scarta almeno due. Il LED su GPIO4 si accende 150 ms prima del frame e si spegne subito dopo. Quei 150 ms sono lo stesso ritardo dell'esempio CameraWebServer, e il flash è un picco di corrente: se la scheda si resetta quando scatta, leggi la ",[29,302,304],{"href":303},"\u002Fit\u002Fblog\u002Fesp32-brownout-detector-was-triggered","guida al brownout",[61,306,308],{"id":307},"perché-lo-snapshot-è-più-adatto-a-una-scheda-piccola-di-uno-stream","Perché lo snapshot è più adatto a una scheda piccola di uno stream?",[13,310,311,312,315,316,319,320,323],{},"Per una scheda piccola, la differenza sta in quanto a lungo tieni occupate la camera e la connessione. Il firmware di Gizmo Camera avvia il sensore con un solo frame buffer (",[17,313,314],{},"fb_count = 1",") in PSRAM e ",[17,317,318],{},"CAMERA_GRAB_WHEN_EMPTY",", e manda il JPEG al client direttamente da quel buffer, senza copiarlo. L'esempio CameraWebServer, quando trova la PSRAM, usa due buffer e ",[17,321,322],{},"CAMERA_GRAB_LATEST",". Il README di esp32-camera dice che più di un buffer in modalità JPEG tiene il driver in cattura continua, il che costa CPU e memoria in cambio di un frame rate più alto: va bene per uno stream, è più di quanto serva a uno snapshot.",[13,325,326],{},"Non ho misurato l'uso di memoria né i tempi dei frame, quindi prendila come un ragionamento di progetto basato sul sorgente, non come un benchmark. Ciò che il codice mostra è semplice: tra una richiesta e l'altra, una camera da snapshot sta ferma. Non c'è nessun ciclo che cattura frame per uno spettatore che magari se n'è andato, e non c'è una seconda porta per lo stream. Uno script che vuole una foto all'ora costa alla camera una cattura all'ora.",[61,328,330],{"id":329},"cosa-succede-quando-due-client-chiedono-insieme","Cosa succede quando due client chiedono insieme?",[13,332,333],{},"La camera risponde al secondo con un errore. Gizmo Camera tiene il frame buffer dal momento in cui scatta uno snapshot fino a quando la risposta è stata inviata, o il client se n'è andato, e si può tenere un solo snapshot alla volta. Una richiesta che arriva nel frattempo riceve HTTP 503 con questo corpo:",[13,335,336],{},[236,337],{"alt":338,"src":339},"Un telefono e un portatile mandano entrambi una richiesta a una sola ESP32-CAM su treppiede con il cartello busy, mentre la seconda richiesta aspetta con l'icona di un orologio","\u002Fimages\u002Fblog\u002Fesp32-cam-snapshot-http-capture-jpeg-illustration.webp",[156,341,346],{"className":342,"code":344,"language":345,"meta":162},[343],"language-json","{ \"errorId\": \"camera_busy\", \"errorMessage\": \"The camera is taking another snapshot\", \"data\": null }\n","json",[17,347,344],{"__ignoreMap":162},[13,349,350],{},[236,351],{"alt":352,"src":353},"La richiesta del client A occupa il frame buffer e riceve un JPEG 200, mentre quella del client B nel frattempo riceve 503 camera_busy","\u002Fimages\u002Fblog\u002Fit\u002Fesp32-cam-snapshot-http-capture-jpeg-busy.webp",[13,355,356,357,360,361,364],{},"Gli altri errori sono anch'essi JSON: ",[17,358,359],{},"camera_unavailable"," (503) quando il sensore non è partito, il che in pratica di solito significa il cavo flat, e ",[17,362,363],{},"capture_failed"," (500) quando il sensore non ha dato nessun frame. Il firmware continua a girare anche senza camera, così la web app può dire cosa non va.",[13,366,367,368,371,372,374,375,378],{},"Considera ",[17,369,370],{},"camera_busy"," come un \"riprova tra un attimo\", non come un guasto. ",[17,373,23],{}," può farlo per te: la sua documentazione elenca HTTP 503 tra gli errori transitori che ",[17,376,377],{},"--retry"," ripete, con un'attesa che cresce in modo esponenziale.",[113,380],{":commands":381,"title":382},"[\"curl --retry 3 -fsS -o photo.jpg \\\"http:\u002F\u002Fgizmo-camera.local\u002Fapi\u002Fcapture?resolution=SVGA\\\"\"]","Lascia che curl ritenti mentre la camera è occupata",[13,384,385,386,389,390,392,393,395,396,399,400,403],{},"Con ",[17,387,388],{},"-f"," curl fallisce con qualsiasi codice di errore invece di salvare l'errore JSON come ",[17,391,122],{},". Attenzione però: ritentare significa una foto nuova ogni volta, e con ",[17,394,299],{}," il LED scatta di nuovo. La web app fa il contrario di proposito: il suo ",[17,397,398],{},"useDeviceApi.js"," imposta ",[17,401,402],{},"retry: 0"," per gli snapshot.",[61,405,407],{"id":406},"come-prendono-limmagine-gli-script-e-home-assistant","Come prendono l'immagine gli script e Home Assistant?",[13,409,410,411,413,414,417],{},"Va bene qualsiasi client HTTP, perché è una semplice GET. Per un time-lapse basta un ciclo con ",[17,412,23],{}," e un timestamp nel nome del file, e una riga di ",[17,415,416],{},"cron"," fa lo stesso a orari programmati. Tieni un solo client per camera, oppure aggiungi il retry di prima, così due job non si scontrano. Un time-lapse con una foto al minuto è un breve ciclo di shell:",[113,419],{":commands":420,"title":421},"[\"while true; do curl -fsS -o \\\"shot-$(date +%s).jpg\\\" \\\"http:\u002F\u002Fgizmo-camera.local\u002Fapi\u002Fcapture?resolution=SVGA\\\"; sleep 60; done\"]","Una foto ogni 60 secondi",[13,423,424],{},"Fermalo con Ctrl+C. Ogni file ha nel nome l'ora Unix dello scatto.",[13,426,427,428,433,434,437],{},"Per Home Assistant, l'",[29,429,432],{"href":430,"rel":431},"https:\u002F\u002Fwww.home-assistant.io\u002Fintegrations\u002Fgeneric\u002F",[41],"integrazione Generic Camera"," ha un campo ",[69,435,436],{},"Still Image URL",", descritto come l'URL su cui la tua camera serve l'immagine. Mettici l'URL dello snapshot:",[156,439,444],{"className":440,"code":442,"language":443,"meta":162},[441],"language-text","http:\u002F\u002F192.168.1.50\u002Fapi\u002Fcapture?resolution=SVGA\n","text",[17,445,442],{"__ignoreMap":162},[13,447,448,449,452,453,132],{},"L'indirizzo IP è un esempio: usa quello della tua camera. Qui l'IP è la scelta più sicura, perché un host Home Assistant non sempre risolve i nomi ",[17,450,451],{},".local",". Non ho provato questa procedura su un'installazione di Home Assistant, e il modo in cui l'integrazione fa il polling non l'ho verificato, quindi controlla ogni quanto scarica l'immagine prima di puntarla su una camera aperta anche nella web app: una seconda richiesta durante una cattura è un ",[17,454,370],{},[61,456,458],{"id":457},"lurl-dello-snapshot-si-può-lasciare-aperto","L'URL dello snapshot si può lasciare aperto?",[13,460,461,462,467,468,471,472,474],{},"Nessuna autenticazione lo protegge. La camera non ha un login, quindi chiunque la raggiunga sulla tua rete può scattare una foto. Il firmware aggiunge due controlli dalla libreria condivisa ",[29,463,466],{"href":464,"rel":465},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-common",[41],"gizmo-common",": i browser su altri siti web vengono respinti (il controllo ",[17,469,470],{},"Origin","), e le richieste devono usare come host il nome o l'indirizzo della camera stessa, il che protegge dal DNS rebinding. Le richieste dirette da ",[17,473,23],{}," o da uno script, con il nome o l'IP della camera, funzionano. Questi controlli non sono un login.",[13,476,477,478,481,482,259,484,486,487,490],{},"Tienila su una rete di cui ti fidi e non inoltrare mai la sua porta sul router. Il ",[29,479,480],{"href":273},"post sull'MCP"," parla dello stesso limite per gli agenti AI. L'esempio CameraWebServer è simile nello spirito: i suoi ",[17,483,79],{},[17,485,83],{}," rispondono con ",[17,488,489],{},"Access-Control-Allow-Origin: *",", quindi qualsiasi pagina web può leggerli.",[61,492,494],{"id":493},"cosa-ricordare","Cosa ricordare",[13,496,497,498,501,502,505,506,509,510,132],{},"Una ",[17,499,500],{},"GET \u002Fapi\u002Fcapture"," restituisce un JPEG, scattato dopo la tua richiesta, alla risoluzione e qualità che indichi: ",[17,503,504],{},"?resolution=SVGA&quality=10"," è un buon punto di partenza, e gli header della risposta ti dicono dimensione reale e tempo di cattura. La camera scatta uno snapshot alla volta, quindi una seconda richiesta riceve ",[17,507,508],{},"503 camera_busy"," e deve semplicemente ritentare. Il flash si attiva con ",[17,511,299],{},[13,513,514,515,519,520],{},"I limiti: l'endpoint non ha autenticazione, non ho fatto benchmark dei tempi di cattura né delle dimensioni dei file, e i passaggi per Home Assistant qui non sono stati provati. Se una scheda si resetta quando chiedi foto con il flash, il primo sospettato è l'alimentazione. Per i pin che usa la camera, vedi ",[29,516,518],{"href":517},"\u002Fit\u002Fblog\u002Fesp32-cam-gpio-pins-free-to-use","quali GPIO della ESP32-CAM sono davvero liberi",", e per la famiglia di progetti, ",[29,521,523],{"href":522},"\u002Fit\u002Fblog\u002Fwhat-is-opengizmo","Cos'è OpenGizmo?",{"title":162,"searchDepth":525,"depth":525,"links":526},2,[527,528,532,533,534,535,536,537],{"id":63,"depth":525,"text":64},{"id":102,"depth":525,"text":103,"children":529},[530],{"id":187,"depth":531,"text":188},3,{"id":242,"depth":525,"text":243},{"id":307,"depth":525,"text":308},{"id":329,"depth":525,"text":330},{"id":406,"depth":525,"text":407},{"id":457,"depth":525,"text":458},{"id":493,"depth":525,"text":494},"builds","Build","2026-11-14T00:00:00Z","Come avere una foto dalla ESP32-CAM con una sola GET: l'URL \u002Fapi\u002Fcapture, risoluzione e qualità, la risposta busy, esempi con curl e Home Assistant.","md",[544,547,550,553,556],{"question":545,"answer":546},"Qual è l'URL per lo snapshot di una ESP32-CAM?","Dipende dal firmware. L'esempio Arduino CameraWebServer serve lo snapshot su \u002Fcapture. Gizmo Camera lo serve su \u002Fapi\u002Fcapture, per esempio http:\u002F\u002Fgizmo-camera.local\u002Fapi\u002Fcapture?resolution=SVGA, e restituisce un JPEG. Su Gizmo Camera puoi aggiungere le opzioni resolution, quality e flash. Apri l'URL nel browser oppure scaricalo con curl.",{"question":548,"answer":549},"Che differenza c'è tra snapshot e stream con la ESP32-CAM?","Lo snapshot è una richiesta che restituisce un solo JPEG e poi finisce. Lo stream è una connessione che la camera tiene aperta riempiendola di frame uno dopo l'altro, come il \u002Fstream multipart dell'esempio CameraWebServer. Lo snapshot non richiede connessioni aperte tra una richiesta e l'altra, quindi lo usano facilmente script e server.",{"question":551,"answer":552},"Quale risoluzione usare per lo snapshot della ESP32-CAM?","SVGA, 800 per 600, è un buon punto di partenza: basta per capire una scena e ha un quarto dei pixel di UXGA. Gizmo Camera usa di default la dimensione massima del sensore, UXGA a 1600 per 1200 sull'OV2640, e la sua guida per gli agenti consiglia UXGA solo per leggere i dettagli piccoli.",{"question":554,"answer":555},"Perché la mia ESP32-CAM risponde 503 camera_busy?","Gizmo Camera tiene il suo unico frame buffer finché lo snapshot non è stato inviato, quindi una seconda richiesta che arriva nel frattempo riceve 503 con l'errore camera_busy. Aspetta un attimo e riprova, oppure lascia che curl ritenti. Possono causarlo due client che interrogano insieme la camera, per esempio uno script e la web app.",{"question":557,"answer":558},"Come aggiungo lo snapshot della ESP32-CAM a Home Assistant?","Aggiungi l'integrazione Generic Camera e inserisci l'URL dello snapshot, per esempio http:\u002F\u002F192.168.1.50\u002Fapi\u002Fcapture?resolution=SVGA, nel campo Still Image URL. Usa l'indirizzo IP della camera se Home Assistant non risolve il nome .local. Non ho provato questa procedura su un'installazione di Home Assistant.","\u002Fimages\u002Fblog\u002Fesp32-cam-snapshot-http-capture-jpeg.jpg","Una ragazza con le treccine tiene una tazza mentre una ESP32-CAM inquadra una pianta e una finestra del browser con l'indirizzo \u002Fapi\u002Fcapture mostra la stessa pianta.","it",{},true,"\u002Fit\u002Fblog\u002Fesp32-cam-snapshot-http-capture-jpeg",{"title":5,"description":541},{"loc":564},"it\u002Fblog\u002Fesp32-cam-snapshot-http-capture-jpeg","Lo snapshot della ESP32-CAM è una richiesta GET che restituisce un JPEG. Gizmo Camera risponde a \u002Fapi\u002Fcapture?resolution=SVGA, scatta una foto alla volta e a una seconda richiesta risponde 503 camera_busy. Nessun login.",[570,571,572,573,574],"ESP32-CAM","IoT","Home Automation","OpenGizmo","Firmware","mqscIDh-O4A0MhctY4cXYP4eQfOZHXmwE2WAFFTUN3E",[577,584,594,603],{"title":578,"description":579,"image":580,"categoryText":539,"categorySlug":538,"tags":581,"path":273},"Server MCP su ESP32: Claude Code scatta le foto","Fai girare un server MCP su una ESP32-CAM e aggiungilo a Claude Code con un comando. Scopri il tool take_snapshot, la guida \u002Fllms.txt e perché resta nella LAN.","\u002Fimages\u002Fblog\u002Fesp32-mcp-server-claude-code.jpg",[570,582,571,573,583],"AI Agents","Open Source",{"title":585,"description":586,"image":587,"categoryText":588,"categorySlug":589,"tags":590,"path":593},"API CoinGecko su ESP32: limiti gratuiti e polling","Il piano Demo gratis di CoinGecko: 100 chiamate al minuto e 10.000 al mese. Ogni quanto interrogarlo con un ESP32, come mandare la key e cosa vuol dire 429.","\u002Fimages\u002Fblog\u002Fcoingecko-api-esp32-rate-limits.jpg","Guide","guides",[591,571,574,573,592],"ESP32","MAX7219","\u002Fit\u002Fblog\u002Fcoingecko-api-esp32-rate-limits",{"title":595,"description":596,"image":597,"categoryText":598,"categorySlug":599,"tags":600,"path":602},"ESPHome o firmware custom su ESP32: quale scegliere","ESPHome o firmware custom per ESP32? Una tabella per decidere, cosa ESPHome non sa fare e perché web app, portal e server MCP di OpenGizmo usano PlatformIO.","\u002Fimages\u002Fblog\u002Fesphome-vs-custom-esp32-firmware.jpg","Confronti","comparisons",[591,574,572,601,573],"PlatformIO","\u002Fit\u002Fblog\u002Fesphome-vs-custom-esp32-firmware",{"title":604,"description":605,"image":606,"categoryText":598,"categorySlug":599,"tags":607,"path":609},"OTA ESP32 a confronto: web, GitHub, HTTPS pull","Aggiornamento OTA dell'ESP32 a confronto: ArduinoOTA, upload web, HTTPS pull da GitHub Releases e USB, con partizioni, sicurezza e rollback.","\u002Fimages\u002Fblog\u002Fesp32-ota-update-methods-compared.jpg",[591,574,571,608,573],"Wi-Fi","\u002Fit\u002Fblog\u002Fesp32-ota-update-methods-compared",[611,614,617],{"name":588,"slug":589,"path":612,"count":613,"image":587},"\u002Fblog\u002Fcategories\u002Fguides",11,{"name":598,"slug":599,"path":615,"count":616,"image":606},"\u002Fblog\u002Fcategories\u002Fcomparisons",8,{"name":618,"slug":619,"path":620,"count":621,"image":622},"Risoluzione problemi","troubleshooting","\u002Fblog\u002Fcategories\u002Ftroubleshooting",5,"\u002Fimages\u002Fblog\u002Fesp32-brownout-detector-was-triggered.jpg",{"title":32,"badge":624,"description":625,"path":31,"image":626,"cardIcon":627,"highlights":628},"Progetto open-source ESP32-CAM","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.","\u002Fimages\u002Fprojects\u002Fgizmo-camera\u002Fcover.webp","Camera01Icon",[629,630,631],"Foto JPEG fino a 1600 × 1200","API HTTP semplice","Server MCP per agenti AI",1795018239423]