Skip to content

About

Controlador da Sony FX30 (ILME-FX30) no M5Stack Cardputer ADV — REC, ISO, shutter, iris, WB, timecode e Live View por Wi-Fi Direct + PTP-IP. Inclui as notas de engenharia reversa do protocolo Sony SDIO.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

55 Commits

Folders and files

Repository files navigation

FX30 Controller — M5Stack Cardputer ADV

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).

O que a v3.6 → v3.8 trouxe

  • v3.8 — tela inicial = lista de câmeras cadastradas. Cada câmera tem apelido + credenciais no NVS e conecta com um toque. Enter conecta, k renomeia, del esquece; + 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.


⚠️ Pré-requisitos na câmera

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_PASS em src/main.cpp antes de compilar. Não commite credenciais reais — os placeholders (DIRECT-xxFX30) são detectados e ignorados de propósito.


Teclas (Cardputer)

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).


Arquitetura (resumo)

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).

Como funciona a conexão (validado na FX30)

  1. Wi-Fi join no AP da câmera (WiFi.setSleep(false) — sem isso o AP derruba o cliente).
  2. Handshake PTP-IP (InitCommand + InitEvent, TCP 15740).
  3. Handshake Sony SDIO: 0x9201(1) → 0x9201(2) → 0x9202(0xC8) → 0x9201(3).
  4. O 0x9202 anuncia props e control codes (REC=0xD2C8, AF=0xD2C1, …).
  5. Poll do 0x9209 a cada 2 s = status na tela e keep-alive (sem tráfego a câmera desassocia em ~30 s).
  6. Ajustes: por passo via 0x9207 + i8 ±1 (set absoluto via 0x9205 não funciona p/ ISO — clampa/AUTO).

Build & testes

# 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 serial

Monitor 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).


Ética / legalidade

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.


Licença

MIT © 2026 @thiagolegrand.

About

Controlador da Sony FX30 (ILME-FX30) no M5Stack Cardputer ADV — REC, ISO, shutter, iris, WB, timecode e Live View por Wi-Fi Direct + PTP-IP. Inclui as notas de engenharia reversa do protocolo Sony SDIO.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages