Loading 3D model… large boards can take a moment.
Repositorio oficial del Badge DojoCon Panamá 2026. Aquí encontrarás el hardware (esquemático, PCB y footprints) y la documentación de uso del badge.
El badge es un dispositivo autónomo: se alimenta por USB-C (o batería en el portapilas J3), se maneja con sus 4 botones direccionales y muestra todo en su OLED. No necesita computadora ni aplicación para jugar; la PC sólo se usa para flashear y para la consola serie de diagnóstico.
El firmware que corre en el badge es PwnPet, un framework de mascota virtual
(tipo Tamagotchi) sobre BLE con retos de CTF integrados. Este badge corresponde
a la variante ch573/panama_dojocon_2026.
Para interactuar con el badge desde una computadora existe PwnPet_CLI, una herramienta de línea de comandos en Python que se conecta por BLE. Ver la sección CLI.
| Bloque | Parte |
|---|---|
| MCU | CH573F QFN28 (RISC-V, BLE 4.2, AES-128 por hardware, USB Full-Speed) |
| Antena | Antena embebida en el PCB (AE1) |
| Pantalla | OLED 128×64 en conector J2 (I²C @ 0x3C) — panel 1.3" SH1106 |
| LED de usuario | WS2812B RGB direccionable (D11) |
| Entrada botones | 4 push buttons direccionales (activo-bajo, sobre el header J1) |
| Alimentación | USB-C (P1) + portapilas / LiPo (J3), OR-ing por schottky y PMOS |
| Reguladores | AP2112K-3.3 (3.3 V) |
| Relojes | 32 MHz (BLE) + 32.768 kHz (RTC) |
| Depuración | Header SWD (J4) para WCH-LinkE |
panama_dojocon_2026)| Función | Pin | Nota |
|---|---|---|
| OLED SDA / SCL | PB12 / PB13 | I²C por software (SoftWire) @ 400 kHz |
| WS2812 DATA |
PA14 |
SPI0 MOSI (movido desde PB14 para liberar SWDIO) |
| Botón ARRIBA | PB7 |
| Botón ABAJO | PA8 |
| Botón IZQUIERDA | PA9 |
| Botón DERECHA | PA12 | Antes CS del breakout J1 |
| ADC de usuario | PA4 / PA5 | AIN0 / AIN1 libres en J1 |
| USB D+ / D− | PB11 / PB10 | Fijo por silicio |
| SWCLK / SWDIO | PB15 / PB14 | Programación SWD (J4) |
| BOOT / RESET | PB22 / PB23 | SW3 (ISP por ROM) / SW1 |
[!NOTE] Nota de panel OLED. Esta variante está configurada como SH1106 (
BOARD_OLED_CONTROLLER=1, offset de +2 columnas), que es el controlador real de la mayoría de paneles vendidos como "1.3 pulgadas 128×64". Si montas un panel 0.96" (SSD1306 auténtico) verás 2 columnas corridas: en ese caso hay que compilar conBOARD_OLED_CONTROLLER=0.
El badge cría una criatura (Pwn Cat, species_id 0x0002) con estadísticas
que evolucionan en el tiempo y sobreviven al apagado (se guardan en la
DataFlash del CH573):
| Estadística | Rango | Qué la afecta |
|---|---|---|
| Felicidad | 0–1000 | Acariciar, jugar, misiones |
| Hambre | 0–1000 | Alimentar (sube), decae sola con el tiempo |
| Salud | 0–1000 | Descuido prolongado la baja |
| XP | 0–… | Misiones, caricias, alimentar |
Estados de la criatura (se reflejan en el sprite del OLED y en el color del LED):
| Estado | Condición | LED |
|---|---|---|
| Temeroso | Estado inicial | Azul fijo |
| Curioso | Al acumular algo de XP | Amarillo fijo |
| Leal | Al acumular bastante más XP | Verde fijo |
| Paranoia | 3 passkeys incorrectos por BLE | Rojo parpadeante (60 s) |
| Hambriento | Salud crítica | Magenta parpadeante |
| Muerto | Descuido total o sobrealimentación | Apagado |
Sobrealimentar tiene consecuencias: al pasar de 600 / 750 / 900 de hambre la criatura se pone "gordita" (sprites y LED naranja en tres intensidades), y al saturar en 1000 muere de sobrealimentación. Después de morir hay una penalización de 3 minutos antes de poder revivirla (arise, con animación y LED naranja).
Con el panel de 128×64 los sprites son a pantalla completa y las cadenas de
estadísticas se muestran sin abreviar (HAP: / HUN:).
El sensor de la especie es la temperatura interna del chip: el badge la mide y reacciona a ella. Es la magnitud que alimenta las misiones de sensor y la característica de sensor del GATT.
| Acción | Efecto |
|---|---|
| ARRIBA (pulsación corta) | Acariciar la criatura (+5 XP) — muestra Petted! +5xp |
| ARRIBA (pulsación larga) | Muestra/oculta la pantalla completa con el nombre del dueño |
| ABAJO (pulsación corta) | Alimentar (+25 comida/felicidad, +5 XP) — muestra Fed! +25food |
| ABAJO (pulsación larga) | Muestra/oculta la placa con el nombre de la mascota en la esquina superior derecha (sin tapar el sprite) |
| IZQUIERDA | Overlay de estadísticas: HAP:<felicidad> HUN:<hambre> |
| DERECHA | Overlay de estadísticas: HP:<salud> XP:<xp> |
| IZQUIERDA + DERECHA ≥ 500 ms | Activa/desactiva el modo amistad (Friend mode ON/OFF) |
| ARRIBA con solicitud pendiente | Acepta la solicitud de amistad en pantalla |
Las pulsaciones largas de ARRIBA y ABAJO no generan un evento nuevo para las misiones de patrón de botones: el flanco de subida ya acarició o alimentó, la pulsación larga sólo añade el interruptor de pantalla.
Con la criatura muerta los botones de interacción quedan inhibidos hasta hacer
arisedesde la CLI.
El firmware incluye un conjunto de misiones integradas. Cada misión, cuando se
completa, otorga XP y pone a disposición una bandera (PWNPET{...}). Esta guía
no las resuelve; explica el marco para que sepas cómo abordarlas.
Cómo explorarlas desde la CLI:
missions — descubre qué misiones existen en tu badge y cuáles ya has completado.missions --hint <id> — solicita la pista oficial del firmware para una misión específica.flag <id> — recoge la bandera de una misión completada.Categorías de misión presentes en esta variante (dependen de los indicadores
HAS_*):
HAS_BUTTONS=1).Algunas misiones se pueden completar completamente desde la CLI; otras requieren interacción física con el hardware. Esto es intencional: el badge es a la vez un dispositivo físico y un objetivo BLE.
Recuerda: las características que contienen banderas no se nombran en la CLI y sólo devuelven datos cuando se cumplen sus condiciones. Descúbrelas usando las pistas del propio firmware, no aquí.
La numeración de misiones no es necesariamente contigua: depende de los flags
HAS_*de la variante. Lista siempre conmissionspara ver cuáles existen en tu badge.
Con el modo amistad activo (combo IZQ+DER sostenido ≥ 500 ms), el badge escanea
anuncios BLE de otros PwnPet cercanos. Cuando detecta uno con RSSI fuerte
(~−60 dBm, es decir, a pocos centímetros) muestra
Amigo? PwnPet_XXYY [↑=Aceptar]. Al presionar ARRIBA, ese badge queda guardado
en la lista de amigos.
El badge anuncia como PwnPet_XXXX (o PwnPet_<nombre> si se le puso nombre
personalizado) y expone un servicio paraguas 0xFEED al que se conecta
cualquier cliente BLE estándar (nRF Connect, bleak, etc.):
| Grupo | UUIDs | Contenido |
|---|---|---|
| Vida | 0xFE01–0xFE09 | species_id, nombre, felicidad, energía, estado, XP, salud, lista de misiones, nombre del dueño (todos de lectura) |
| Interacción | 0xC001–0xC009 | feed, pet, play, renombrar, pista de misión, factory reset, comando de amistad, set_owner |
| Estado | 0xDE02, 0xFA01 | all_missions_done, valor del sensor (lectura) |
El servicio expone más características de las que se documentan aquí. Las que no aparecen en esta tabla devuelven datos vacíos hasta que se cumplen sus condiciones de acceso. Enumerar el GATT y averiguar esas condiciones es parte del reto: usa las pistas del propio firmware (
missions --hint).
PWNPET{12hex} y se derivan por CMAC del UID del
chip, así que cada badge tiene flags distintas.Al conectar el USB-C aparece un puerto serie a 115200 baudios. Al arrancar imprime un banner de diagnóstico:
pwnpet F7 boot
chip_uid: XX-XX-XX-XX-XX-XX-XX-XX
AES-128 KAT: PASS
flag_derive KAT: PASS
BLE name: PwnPet_XXXX
type 'help' for commands
Escribe help para la lista de comandos. Sirve para diagnóstico; el juego real
se hace con los botones y por BLE.
El badge se juega solo, pero para inspeccionarlo, resolver misiones por BLE y recoger banderas existe PwnPet_CLI: una herramienta de línea de comandos en Python que habla BLE con el badge desde Linux, macOS o Windows.
La guía completa está en el README de PwnPet_CLI. Aquí sólo va lo esencial para usarla con este badge.
Requisitos: Python ≥ 3.10 y un adaptador Bluetooth BLE 4.0+.
git clone https://github.com/ElectronicCats/PWNPet_CLI.git
cd PWNPet_CLI
python3 -m venv .venv
source .venv/bin/activate # Linux / macOS
# .venv\Scripts\activate # Windows
pip install -r pwnpet_cli/requirements.txt
chmod +x pwnpet # Linux / macOS
./pwnpet --version
El script pwnpet se invoca desde la raíz del repositorio. Para llamarlo desde
cualquier directorio, agrégalo al PATH, crea un symlink en ~/.local/bin o define
un alias en tu shell.
En Linux, si hay problemas de permisos BLE:
sudo usermod -aG bluetooth $USER # cerrar sesión y volver a entrar
pwnpet scan # busca badges PwnPet cercanos
pwnpet target set AA:BB:CC:DD:EE:1A # guarda el badge objetivo (o por nombre)
pwnpet # abre la sesión interactiva (modo por defecto)
scan lista nombre, dirección MAC, especie y estado emocional de cada badge visible:
Name Address Species State
PwnPet_1A2B AA:BB:CC:DD:EE:1A 0x0002 (Pwn Cat) temeroso
La sesión interactiva (pwnpet session, o pwnpet a secas) mantiene la conexión
BLE abierta y evita pagar los ~5–10 s de reconexión por comando. Al conectar imprime
el estado actual y deja el prompt (pwnpet). Se cierra con exit, quit o Ctrl+D;
Ctrl+C sólo cancela el comando en curso.
| Comando | Qué hace |
|---|---|
status | Muestra todos los campos públicos: dueño, especie, nombre, felicidad, hambre, salud, estado, XP, sensor y misiones |
feed | Alimenta a la criatura (porción fija). Sube hungry y felicidad — cuidado con sobrealimentar |
pet | Acaricia: sube felicidad y otorga algo de XP |
play <hex> | Juega escribiendo un valor mágico de 32 bits y lee la respuesta; ciertos valores son parte de los retos |
rename <nombre> | Cambia el nombre de la criatura (máx. 16 bytes UTF-8) |
owner [<nombre>] | Lee o define el nombre del dueño del badge (máx. 20 bytes UTF-8) |
missions | Lista las misiones y su estado (completada / pendiente) |
missions --hint <id> | Pide al firmware la pista oficial de una misión |
flag <id> | Recoge la bandera de una misión ya completada |
passkey <código> | Envía el passkey mostrado en el OLED para desbloquear contenido protegido |
read <nombre|0xNNNN> | Lee una característica por nombre público o por UUID corto |
write <nombre|0xNNNN> <hex> | Escribe una característica |
friendship … | count, list, remove <MAC>, block <MAC>, proximity [on|off] |
arise | Restablecimiento de fábrica; sólo aparece si la criatura está muerta |
help | Lista completa de comandos |
Ejemplo:
(pwnpet) owner Ada Lovelace
owner: Ada Lovelace
(pwnpet) feed
ok
(pwnpet) missions
Missions (Pwn Cat):
[ ] mission 1
[X] mission 2
(pwnpet) flag 2
PWNPET{xxxxxxxxxxxx}
La CLI sólo nombra las características públicas. Las que contienen banderas no tienen nombre por diseño: se alcanzan únicamente por su UUID crudo (
read 0xNNNN) y devuelven datos vacíos hasta que se cumplen sus condiciones de acceso.
arise — revivir una criatura muertaSi la criatura muere (estado muerto (salud) o muerto (gordito)), el comando arise
aparece en la sesión:
(pwnpet) arise
WARNING: This will wipe all saved data and reboot the device.
Type yes to confirm: yes
Factory reset initiated. Device will reboot in ~1 s.
Es un restablecimiento completo de fábrica: borra XP, misiones, nombres y estado, y
reinicia el badge. La criatura renace en temeroso con todo en cero.
Si aparece
Arise blocked, la criatura murió hace demasiado poco. Espera 3 minutos y vuelve a intentarlo.
Para scripting, cada acción existe como subcomando independiente:
pwnpet status
pwnpet feed
pwnpet pet
pwnpet owner "Ada Lovelace"
pwnpet missions
pwnpet flag 2
pwnpet read happiness
pwnpet write 0xC001 32 # payload en hex (0x32 = 50 decimal)
Todos aceptan --target <addr|nombre> para sobrescribir el objetivo guardado, y
-d / --debug para ver el traceback completo. Cada invocación suelta paga la
latencia de escaneo + conexión + desconexión: para varias acciones seguidas, la
sesión interactiva es mucho más rápida.
| Código | Significado |
|---|---|
| 0 | OK |
| 1 | Error de uso (argumentos incorrectos) |
| 2 | Objetivo no encontrado (timeout de escaneo) |
| 3 | Fallo de conexión (adaptador BLE o timeout) |
| 4 | Error GATT (lectura/escritura rechazada por el firmware) |
| 5 | Timeout de notificación / valor mágico incorrecto |
El firmware evalúa las misiones en dos modos, y eso decide dónde se resuelve cada una:
play, write); las de botones exigen
tocar el badge.En resumen: la CLI es el camino para las misiones de interacción BLE y para observar el progreso de todas; las de sensor y las de botones se completan en el plano físico.
Con HTTPS:
git clone https://github.com/ElectronicCats/badge-dojocon-2026.git
Con SSH:
git clone git@github.com:ElectronicCats/badge-dojocon-2026.git
Los workflows de GitHub Actions detectan automáticamente los archivos de KiCad en
hardware/:
push y pull_request para validar el diseño.release.Para desactivar DRC/ERC, edita
hardware/electroniccats_sch.kibot.yaml:
run_erc: false
run_drc: false
Electronic Cats invests time and resources providing this open source design, please support Electronic Cats and open-source hardware by purchasing products from Electronic Cats!
Designed by Electronic Cats.
Hardware released under an CERN Open Hardware Licence v1.2. See the LICENSE file for more information.
Electronic Cats is a registered trademark, please do not use if you sell these PCBs.
No comments yet. Be the first to ask about this board.