FAQ

FAQ

¿Es legal usar esto?

EMVy Controller es para pruebas de seguridad autorizadas con tarjetas propias o de laboratorio (pentest, laboratorio, CTF, investigación). No lo uses contra tarjetas ajenas ni para fraude. La herramienta lee y explora; los valores de "terminal" son de laboratorio y no generan transacciones válidas. El uso indebido es responsabilidad exclusiva de quien lo realiza. Ver SECURITY.md.

¿Está listo para producción?

No: está en BETA. Funciona y está probado (238 tests + hardware real), pero la API, la CLI y los formatos de datos pueden cambiar entre versiones.

emvy readers no lista mi lector de chip

• Instala el driver CCID y pcscd (ver Instalación).
• Verifica el hardware: lsusb | grep -i reader.
• Arranca el socket si la app no pudo: sudo systemctl enable --now pcscd.socket.
• Asegúrate de usar el Python del venv (.venv/bin/python), no el del sistema.

La GUI revienta al arrancar (SIGSEGV) en KDE/GNOME/Arch

PySide6 trae su propio Qt; los plugins de tema del sistema compilados contra otra build de Qt pueden reventarlo. La GUI ya lo neutraliza automáticamente. Si el compositor Wayland sigue dando problemas: QT_QPA_PLATFORM=xcb ./emvyctl.py gui.

El BomberCat aparece como "Nano RP2040 Connect"

Es un bug cosmético de packaging del core electroniccats:mbed_rp2040 v2.0.0 (VID/nombre hardcodeados). El hardware es correcto; no uses el VID/PID reportado como señal de qué placa es. Ver BomberCat.

arduino-cli upload falla con "try sudo or check your permissions"

Falta una regla udev para el RP2040. Ver la sección de gotchas en BomberCat.

La captura por BomberCat vuelve vacía / ERR:TXFAIL

El NFC del BomberCat es de rango milimétrico sostenido a mano; un barrido largo pierde la tarjeta a media lectura. La captura por BomberCat usa un flujo EMV mínimo (PPSE→SELECT→GPO→AFL). Mantén la tarjeta firme y cerca; para lecturas exhaustivas usa un lector de contacto.

¿Dónde se guardan mis proyectos y capturas?

En el directorio XDG del sistema: ~/.local/share/emvy/projects/<nombre>/ (config en ~/.config/emvy/). Nunca se empaquetan en el binario ni se versionan en el repo. Ver Variables y perfiles.

¿Cómo contribuyo?

Lee CONTRIBUTING.md: convenciones (núcleo puro, inmutabilidad, efectos en los bordes), cómo correr los tests, y qué nunca subir (datos de tarjeta/cliente). La wiki de arquitectura para contribuir es CLAUDE.md.

¿Qué licencia tiene?

GNU AGPL-3.0-or-later. El código de terceros vendorizado en vendor/ conserva su propia licencia.