Loading files…
Repositorio oficial del Badge UnknownSecurity Conference 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/unknownSecurityConference-2026, cuya criatura es la Pwn Llama
(species_id 0x0003).
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 0.96" SSD1306 |
| LED de usuario | WS2812B RGB direccionable (D11) |
| Sensor de luz | LTR-303ALS-01 (I²C @ 0x29, comparte el bus del OLED) |
| 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 |
unknownSecurityConference-2026)| Función | Pin | Nota |
|---|---|---|
| OLED SDA / SCL | PB12 / PB13 | I²C por software (SoftWire) @ 400 kHz |
| LTR-303 SDA / SCL | PB12 / PB13 | Comparte el bus I²C del OLED (0x29) |
| 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 no define
BOARD_OLED_CONTROLLER, por lo que el firmware compila en modo SSD1306 (sin offset de columna), que es el controlador real de los paneles de 0.96" 128×64. Si montas un panel de 1.3" (que casi siempre es un SH1106) verás 2 columnas corridas: en ese caso hay que añadir#define BOARD_OLED_CONTROLLER 1apwnpet_variant.h.
El badge cría una criatura (Pwn Llama, species_id 0x0003) 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 LTR-303 es el sensor secundario de la especie: el badge mide luz ambiental
en lux y reacciona a ella (hay un sprite de "iluminado" y el LED parpadea en
amarillo mientras la condición se sostiene). El sensor primario sigue siendo la
temperatura interna del chip, que es la que se publica como sensor_value.
| Control | Etiqueta en PCB | Función |
|---|---|---|
| Interruptor slide | SW2 | Encendido principal |
| Botón táctil | SW1 (RST) | Reset del sistema |
| Botón táctil | SW3 (BOOT) | Bootloader ISP por ROM (mantener al conectar el USB) |
| Botones direccionales | ARRIBA/ABAJO/IZQUIERDA/DERECHA | Juego, estadísticas, amistad y retos |
| 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.
Presionar IZQUIERDA o DERECHA por separado retrasa su overlay ~200 ms, para dar tiempo a que el otro botón se una al combo de modo amistad.
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).Como HAS_TOUCH=0, la misión de patrón táctil de otras variantes no existe
en este badge. Por eso la numeración de misiones no es contigua: lista siempre
con missions para ver cuáles existen realmente.
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í.
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 suficiente
(umbral −80 dBm, es decir, badges a corta distancia) muestra
Amigo? PwnPet_XXYY [^]. Al presionar ARRIBA, ese badge queda guardado en la
lista de amigos y aparece +Amigo: PwnPet_XXYY.
El badge anuncia como PwnPet_XXXX (derivado del UID del chip) 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, bandera y pista de misión, factory reset, comando de amistad, set_owner |
| Estado | 0xDE02, 0xFA01 | all_missions_done, valor del sensor (lectura) |
Además, el anuncio BLE lleva un payload de fabricante con species_id, el estado
actual de la criatura y 3 bytes derivados de la flag, así que pwnpet scan puede
mostrar especie y estado sin conectarse.
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_3C4D AA:BB:CC:DD:EE:2B 0x0003 (Pwn Llama) 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 Llama):
[ ] 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.
El firmware vive en el repositorio ElectronicCats/pwnpet,
en la variante ch573/unknownSecurityConference-2026.
Descarga el .bin correspondiente a unknownSecurityConference-2026 de la página
de releases de pwnpet y
flashéalo con un programador WCH-LinkE por SWD (header J4).
Requisitos: Linux x64, curl, git, python3 >= 3.10 y un programador WCH-LinkE.
git clone https://github.com/ElectronicCats/pwnpet.git
cd pwnpet
./scripts/bootstrap.sh # instala arduino-cli, wlink y el core fijado
PWNPET_VARIANT=ch573/unknownSecurityConference-2026 ./scripts/build.sh
./scripts/flash_swd.sh # flasheo por SWD (camino canónico)
PWNPET_VARIANTes obligatorio para este badge: el valor por defecto del script de compilación esch573/panama_dojocon_2026, que genera una Pwn Cat con el panel configurado como SH1106.
Variables de compilación útiles:
| Variable | Por defecto | Para qué sirve |
|---|---|---|
PWNPET_VARIANT | ch573/panama_dojocon_2026 | Usar ch573/unknownSecurityConference-2026 para este badge |
PWNPET_SPECIES_SPEC | example_spec | Especie instanciada (example_spec + HAS_LLAMA = "Pwn Llama") |
PWNPET_DEV_MODE | 1 | 0 para build de producción (quita los comandos DEV:) |
Para el badge de evento se recomienda PWNPET_DEV_MODE=0, que elimina los
comandos de depuración capaces de forzar misiones y flags.
Documentación completa del firmware: build, protocolo BLE/CDC, seguridad y flags, hardware.
Con HTTPS:
git clone https://github.com/ElectronicCats/Badge-UnknownSecurity-Conference-2026.git
Con SSH:
git clone git@github.com:ElectronicCats/Badge-UnknownSecurity-Conference-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.