Controlador da Sony FX30 (ILME-FX30) rodando no M5Stack Cardputer ADV (ESP32-S3), comunicando por Wi-Fi Direct → PTP-IP (TCP 15740).
Um controle de câmera de bolso pra set: liga, escolhe a câmera numa lista e já está com REC, ISO, shutter, íris, WB, timecode, bateria e tempo de cartão na mão — sem abrir o menu da FX30.
Estado: FUNCIONANDO na câmera real (FX30 fw 6.00 / protocolo v300) — conexão estável, status ao vivo, REC start/stop e ajustes confirmados comportamentalmente no set. Versão atual: v3.8 (2026-07-15).
- v3.8 — tela inicial = lista de câmeras cadastradas. Cada câmera tem
apelido + credenciais no NVS e conecta com um toque.
Enterconecta,krenomeia,delesquece; + Nova câmera escaneia o Wi-Fi, pede a senha e o apelido. Com exatamente uma cadastrada, o boot já conecta sozinho. - v3.7.x — timecode real, bateria e cartão. A síntese local de TC foi
removida (nada de TC "de mentira"): o topo mostra só o TC lido da câmera.
O rodapé mostra a bateria da câmera (
0xD218) além da do Cardputer, com aviso vermelho abaixo de 15% e faixa piscante em ≤5%, e o tempo restante de cartão (0xD24A, em segundos) formatado como a câmera mostra. - v3.6.x — ISO/shutter/íris por enum-walk (
0x9205, protocolo v300) e correção da direção do ajuste de ângulo de shutter. - v3.5 — ergonomia: zoom em
[/], navegação por SETAS (;/. ,//) na tela principal, tela sem flicker (sprite/double-buffer) e Playback experimental (i) pra rever o cartão sem tocar na câmera.
Detalhe versão a versão em PROGRESS.md.
Fonte de verdade do projeto: docs/FX30_Cardputer_Relatorio.md.
Estado por milestone: PROGRESS.md.
Achados de engenharia reversa (property/control codes reais): docs/RE_FX30.md
e docs/RE_FX30_v300.md.
O controlador fala PTP-IP sem criptografia. Na FX30:
Rede → Opções de Rede → Config. Autent. Acesso → Autent. Acesso = OFF
Com ON, o canal é SSH-cifrado e nada funciona (sintoma: cmd:init-ack-timeout
no log). Também: Rede → PC Remote → Método = Wi-Fi Direct, firmware 3.00+,
e apenas um cliente no AP da câmera (desconecte o celular).
Credenciais (v3.8): cadastradas no próprio Cardputer, nada de recompilar.
A tela inicial é a lista de câmeras salvas no NVS. Em + Nova câmera o
firmware escaneia as redes, você escolhe o DIRECT-… da câmera, digita a senha
(está em "Wi-Fi Direct Info." na FX30) e dá um apelido ("A-cam", "B-cam").
Daí em diante: Enter conecta, k renomeia, del esquece. Com só uma câmera
cadastrada, o boot conecta sozinho.
Alternativa de dev: preencher
CAM_SSID/CAM_PASSemsrc/main.cppantes de compilar. Não commite credenciais reais — os placeholders (DIRECT-xxFX30) são detectados e ignorados de propósito.
| Tecla | Ação | Estado |
|---|---|---|
a |
REC start/stop | ✅ confirmado na FX30 |
b / n |
ISO +1 / −1 passo | ✅ confirmado |
c / v |
Shutter +1 / −1 passo (ou ÂNGULO, se o modo for Angle) | ✅ confirmado (modo speed; em ângulo não responde) |
d / f |
Íris +1 / −1 passo | mecanismo idêntico; aguarda lente de íris eletrônica |
w / q |
WB Kelvin +100 / −100 | ✅ |
[ / ] |
Zoom OUT / IN (v3.5; era u/z) |
mecanismo idêntico ao D25C já usado |
; . , / |
Setas (v3.5): ;/. trocam o campo selecionado (ISO→SH→Iris→WB) na tela principal, ,// ajustam -1/+1 no campo selecionado. Mesmas teclas já eram as "setas" do Wi-Fi/Config/Vídeo/Início — agora também funcionam na tela principal |
não testado na FX30 ainda |
x |
Autofoco (meio-clique 800 ms) | aceito no protocolo |
s |
Still | aceito, sem efeito em modo filme |
r |
Menu VIDEO (fps/formato/rec/LUT/SteadyShot/TC/ângulo) | ✅ |
g |
Live View (~3 fps) | ✅ |
i |
Playback (v3.5, experimental): browser read-only das fotos/vídeos do cartão via PTP padrão (não é opcode Sony) — ` fecha, ;/./,// navegam |
não testado na FX30 — ver PROGRESS.md |
m |
Browser de props (RE no aparelho; mudanças em destaque) | ✅ |
k |
Câmeras (v3.8): cadastrar nova / renomear a selecionada na tela de início | ✅ |
e |
Configurações (brilho, cor, descanso) | ✅ |
? |
Ajuda (mapa de teclas) | ✅ |
h |
Dump de props (SD + serial) | ✅ |
o |
Sonda SDIO (v3.7): dispara read-only os opcodes 0x9203/04/06/08/0B/0C/0D e loga rc + 32 B de cada — ferramenta de RE pra caçar a fonte do TC correndo |
ferramenta de RE |
p |
Liga/desliga emissões de RE na serial | ✅ |
3 |
Fallback protocolo SDIO v200/v300 | experimental |
G0 (botão lateral) |
Monitor on/off (economia de bateria) | ✅ |
` |
Reconectar / voltar pra tela de início (fecha Live View/Playback) | ✅ |
Teclas de ajuste (b/n c/v d/f w/q [ ]) têm auto-repeat ao segurar.
Sem flicker (v3.5): o desenho agora vai pra um sprite off-screen em RAM
(M5Canvas, ver hal/Display.h) que só é mandado pro painel físico de uma vez
(present()) — antes cada repaint fazia fillScreen direto no LCD, visível
como um flash preto sempre que algo mudava (poll de status, cronômetro de REC).
src/
├─ main.cpp # bootstrap; task de rede (core 0) + loop de UI (core 1)
├─ core/ Transport.h Time.h AppState.h Events.h # interfaces + estado + fila
├─ hal/ Display Keyboard Power # Cardputer (M5)
├─ net/ WiFiManager WiFiTransport # Wi-Fi + ITransport no device
├─ protocol/
│ ├─ ptpip/ Framing.h PtpIp.* # transporte PTP-IP (framework-agnóstico)
│ ├─ ptp/ Ptp.* # containers/parsers ISO 15740
│ └─ sony/ SonyCamera.* # handshake SDIO + props/controls reais da FX30
├─ controller/ CameraController.* # cola UI<->protocolo (task de rede)
├─ ui/ ScreenMain.* Menus.h # telas
└─ storage/ Store.* # NVS (credenciais) + SD (dumps)
test/native/ # mock PTP-IP + testes; RealCaptures.h = blobs REAIS da FX30
tools/ # pcap_ptp_decode.py, parse_prop_dump.py, serial_dump_reassemble.py
docs/ # relatório (fonte de verdade) + RE_FX30 (códigos confirmados)
A camada protocol/ não depende do Arduino: compila e é testada no PC contra
um mock e contra blobs reais capturados da FX30 (regressão de verdade).
- Wi-Fi join no AP da câmera (
WiFi.setSleep(false)— sem isso o AP derruba o cliente). - Handshake PTP-IP (InitCommand + InitEvent, TCP 15740).
- Handshake Sony SDIO:
0x9201(1) → 0x9201(2) → 0x9202(0xC8) → 0x9201(3). - O
0x9202anuncia props e control codes (REC=0xD2C8, AF=0xD2C1, …). - Poll do
0x9209a cada 2 s = status na tela e keep-alive (sem tráfego a câmera desassocia em ~30 s). - Ajustes: por passo via
0x9207+ i8 ±1 (set absoluto via 0x9205 não funciona p/ ISO — clampa/AUTO).
# Testes de host (clang++/g++, sem hardware) — inclui regressão c/ blobs reais:
make test
# Firmware (PlatformIO):
pio run -e cardputer-adv
pio run -e cardputer-adv -t upload # upload via USB
# Se o upload falhar com "No serial data received" (stub do USB-JTAG do S3):
python3 ~/.platformio/packages/tool-esptoolpy/esptool.py --chip esp32s3 \
--port /dev/cu.usbmodemXXXX --no-stub write_flash 0x10000 \
.pio/build/cardputer-adv/firmware.bin
# Ferramentas de RE (offline):
python3 tools/pcap_ptp_decode.py sua_captura.pcapng # captura Wireshark
python3 tools/parse_prop_dump.py props.bin # dump 0x9209 (SD)
python3 tools/serial_dump_reassemble.py cap.txt --tag D -o props.bin # dump serialMonitor serial (115200): logs [net] (conexão), [stat] (status), [ctrl]
(comandos). No macOS, pio device monitor pode falhar sem TTY — use
stty -f /dev/cu.usbmodemXXXX 115200 raw -echo -hupcl && cat /dev/cu.usbmodemXXXX
(anexo passivo, não reseta a placa).
Interoperabilidade com hardware próprio, usando um ajuste documentado da própria câmera (Autent. Acesso OFF) e conhecimento open-source (Alpha-Fairy, libgphoto2, sequoia-ptpy). Sem burlar DRM e sem redistribuir binários da Sony.
Projeto independente, sem qualquer vínculo com a Sony ou a M5Stack. "Sony", "FX30" e "Cardputer" são marcas dos respectivos donos. Sem garantia de qualquer espécie: você aponta este firmware pra sua câmera por sua conta e risco.
MIT © 2026 @thiagolegrand.