Windows, Linux, Mac, Raspberry Pi
Instalación
Desde binario compilado
- Descargar el binario correspondiente a la plataforma desde la carpeta dist/:
- macOS (Apple Silicon): SDConn_arm64.app
- macOS (Intel): SDConn_amd64.app
- Windows: sdconn_windows_amd64.exe
- Linux:
- sdconn_linux_amd64 -- PC o Linux tradicional
- sdconn_linux_arm64 — Raspberry Pi 3/4/5 con OS de 64 bits (Raspberry Pi OS 64-bit)
- sdconn_linux_armv7 — Raspberry Pi 3/4 con OS de 32 bits (Raspberry Pi OS 32-bit)
- En macOS, mover el .app a la carpeta Aplicaciones o ejecutar desde cualquier ubicación. En Windows, ejecutar el .exe directamente.
- (Opcional) Colocar un archivo config.json en el mismo directorio del ejecutable para personalizar el puerto:
Si no se provee este archivo, el servicio usa los valores por defecto (puerto 8484).
Primer inicio
Al ejecutar SDConn por primera vez:
- Aparece un ícono en la bandeja del sistema (menú bar en macOS, system tray en Windows/Linux).
- Se abre automáticamente el panel de administración en el navegador (http://localhost:8484/admin).
- Si el navegador no se abre automáticamente, hacer click en el ícono de la bandeja y seleccionar "Panel de Administración".
Configurar credenciales
Las credenciales son la Clave API y el Token de Acceso de Mobbex. Son necesarias para que SDConn pueda crear operaciones de pago.
- En el panel de administración, completar los campos:
- Clave API — La API Key de Mobbex
- Token de Acceso — El Access Token de Mobbex
- Presionar "Guardar Credenciales".
- Las credenciales se almacenan de forma segura en el llavero del sistema operativo (Keychain en macOS, Credential Manager en Windows, Secret Service en Linux). No se guardan en archivos.
- Una vez guardadas, el panel avanza al paso de selección de conexión.
Borrar credenciales
Se pueden borrar desde:
- El panel de administración (botón "Borrar Credenciales")
- El menú de la bandeja del sistema (opción "Borrar Credenciales")
Al borrar las credenciales, el servicio queda en espera hasta que se configuren nuevas.
Conectar un dispositivo
Opción 1: Serial (USB)
- Conectar el dispositivo POS al equipo con un cable USB.
- En el panel de administración, seleccionar "Serial (USB)".
- El servicio busca automáticamente el dispositivo en los puertos USB.
- Cuando lo encuentra, la pantalla cambia a "Dispositivo Conectado".
El dispositivo se pone automáticamente en modo pinpad y queda listo para recibir operaciones.
Opción 2: Red (HTTP)
- Asegurarse de que el dispositivo POS y el equipo estén en la misma red Wi-Fi.
- En el panel de administración, seleccionar "Red (HTTP)".
- El panel muestra la IP local del equipo y ofrece dos formas de encontrar el dispositivo:Escaneo automático:IP manual:
- Presionar "Escanear Red".
- SDConn busca dispositivos en la subred local (puerto 5000).
- Seleccionar el dispositivo de la lista.
- Ingresar la IP del dispositivo y el puerto (por defecto 5000).
- Presionar "Conectar".
- El dispositivo muestra un PIN de 6 dígitos en su pantalla.
- Ingresar el PIN en el panel de administración y presionar "Confirmar".
- Si el PIN es correcto, el dispositivo queda conectado y en modo pinpad.
Reconexión automática
Una vez emparejado un dispositivo por red, SDConn guarda un token de confianza. En futuros inicios del servicio, se reconecta automáticamente sin pedir el PIN nuevamente.
Si el dispositivo cambia de IP o no está disponible, el servicio vuelve a solicitar la selección de conexión.
Verificar estado
Desde la bandeja del sistema
El menú del ícono muestra el estado actual:
- Dispositivo: Serie — /dev/cu.usbmodemN621 (conexión serial activa)
- Dispositivo: Red — POS N62 (192.168.1.50:5000) (conexión por red activa)
- Dispositivo: Sin conexión (sin dispositivo)
Desde el panel de administración
Abrir http://localhost:8484/admin en cualquier momento. Si hay un dispositivo conectado, el panel muestra directamente la pantalla de "Dispositivo Conectado" con los detalles de conexión.
Desde la API
Respuesta:
Desconectar
Desde el panel de administración, en la pantalla de dispositivo conectado, presionar "Desconectar". Esto:
- Libera la conexión con el dispositivo
- Borra el token de confianza guardado
- Vuelve a la pantalla de selección de modo de conexión
Detener el servicio
Desde el menú de la bandeja del sistema, seleccionar "Salir". El servicio cierra la conexión serial (si aplica), detiene el servidor HTTP y termina el proceso.