PixelGotchi v0.1.0

PixelGotchi v0.1.0 — primeira versão · first release

Português · English

Português

Bichinho virtual em pixel art para a Waveshare ESP32-S3-Matrix (8×8 LEDs,
acelerômetro, botão BOOT), com site, editor de bichinhos e case para
impressão 3D. Experimente no navegador: https://pantojinho.github.io/PixelGotchi/guia.html

O que tem

• 6 bichos: capivara, gato, sapo, pintinho, coelho e axolote, cada um com
  comida favorita, expressões e versão selvagem. E mais o seu, criado no
  editor e enviado pela USB, sem compilar.
• Ciclo de vida: escolha → ovo que choca com 5 min de movimento → eclosão
  animada com nome próprio → vida → descuido em estágios → selvagem → RIP.
  Bem cuidado, vive para sempre. Tudo fica salvo na placa.
• Cuidados: comer, brincar, limpar, remédio, dormir, carinho e status.
  Clique alimenta; segurar e soltar abre o menu no cuidado mais urgente;
  chacoalhar brinca; virar de cara para baixo dorme; inclinar faz andar.
• Animações contínuas: o pet nunca some; refeição com comida à frente da
  boca, mastigação e coração; pequenas intenções (farejar, observar, seguir
  borboleta, cochilar) que cedem a qualquer cuidado.
• Sonhos de Conway: bolha que sai da cabeça e vira o mundo, capítulos de
  20–40 s (gliders, pulsações, grupos nascendo), e Conway ao redor do pet
  quando ele está sozinho.
• Site bilíngue (PT/EN): guia "Comece aqui", simulador com os mesmos
  desenhos do firmware, editor de bichinhos e instalador USB.
• LEDs seguros: brilho 5/255, corrente 400 mA, curva gama e brilho por cor.
• Case 3D: 28,7 × 28,7 × 8,6 mm, sem suporte, pinos para BOOT/RESET,
  argolinha de chaveiro, versão com difusor e versão com bateria.

Instalar

• Mais fácil: o instalador pelo navegador
  (Chrome/Edge + cabo USB-C de dados).
• Pelos arquivos desta release (PixelGotchi-v0.1.0.zip, pasta firmware/):
  • Do zero (apaga o pet salvo e o bichinho do editor):
    esptool.py --chip esp32s3 write_flash 0x0 PixelGotchi-v0.1.0-esp32s3-4MB-merged.bin
  • Atualizar mantendo o pet: esptool.py --chip esp32s3 write_flash 0x10000 firmware.bin
• Ou compile com PlatformIO: veja docs/INSTALAR.md.

Se a porta não responder: segure BOOT, aperte e solte RESET, solte BOOT e
tente de novo. Confira os arquivos com SHA256SUMS.txt. A pasta case/ tem
os STLs e o guia de impressão e montagem.

Limitações conhecidas

• Tudo foi verificado em software (testes do firmware com hardware
  simulado, do site e do editor, e o build); o ensaio completo na placa
  física ainda está em andamento. Relatos são muito bem-vindos nas issues.
• Com a placa desligada o tempo do bichinho fica pausado (não há relógio com
  bateria).
• As medidas da case vieram de desenho e fotos: a primeira impressão é um
  teste de encaixe.
• A placa guarda um bichinho do editor por vez; o instalador completo apaga-o.

English

A pixel-art virtual pet for the Waveshare ESP32-S3-Matrix (8×8 LEDs,
accelerometer, BOOT button), with a website, a pet editor and a 3D-printable
case. Try it in your browser: https://pantojinho.github.io/PixelGotchi/guia.html?lang=en

What's in it

• 6 pets: capybara, cat, frog, chick, bunny and axolotl, each with a
  favorite food, expressions and a wild version. Plus your own, created
  in the editor and sent over USB, with no compiling.
• Life cycle: pick → egg that hatches after 5 min of movement → animated
  hatching with its own name → life → neglect in stages → wild → RIP. Well
  cared for, it lives forever. Everything is saved on the board.
• Care: food, play, clean, medicine, sleep, petting and status. Click
  feeds; hold and release opens the menu on the most urgent care; shaking
  plays; face down sleeps; tilting makes it walk.
• Continuous animations: the pet never disappears; meals with food in
  front of the mouth, chewing and a heart; small intentions (sniffing,
  watching, following a butterfly, napping) that yield to any care.
• Conway dreams: a bubble rises from its head and becomes the world,
  20–40 s chapters (gliders, pulses, groups being born), and Conway around the
  pet when it is alone.
• Bilingual website (PT/EN): "Start here" guide, a simulator with the same
  drawings as the firmware, the pet editor and a USB installer.
• Safe LEDs: brightness 5/255, current 400 mA, gamma curve and per-color
  brightness.
• 3D case: 28.7 × 28.7 × 8.6 mm, no supports, pins for BOOT/RESET, a
  keychain loop, a diffuser version and a battery version.

Install

• Easiest: the browser installer
  (Chrome/Edge + USB-C data cable).
• From this release's files (PixelGotchi-v0.1.0.zip, firmware/ folder):
  • Fresh install (erases the saved pet and the editor pet):
    esptool.py --chip esp32s3 write_flash 0x0 PixelGotchi-v0.1.0-esp32s3-4MB-merged.bin
  • Update keeping the pet: esptool.py --chip esp32s3 write_flash 0x10000 firmware.bin
• Or build with PlatformIO: see docs/en/INSTALL.md.

If the port does not answer: hold BOOT, press and release RESET, release BOOT
and try again. Check the files with SHA256SUMS.txt. The case/ folder has
the STLs and the printing and assembly guide.

Known limitations

• Everything was verified in software (firmware tests with simulated
  hardware, website and editor tests, and the build); full testing on a
  physical board is still in progress. Reports are very welcome in the issues.
• While the board is off, the pet's time is paused (there is no battery-backed
  clock).
• The case measurements came from drawings and photos: the first print is a
  fit test.
• The board holds one editor pet at a time; the full installer erases it.