AGENTE LOCAL - LECTOR IPICO IP-X
==================================

QUÉ HACE
--------
Este script PHP corre en la PC de Windows donde está conectado el lector
por cable serial/USB. Lee cada chip detectado y lo manda por internet a
tu API en cPanel.

PASO 1: IDENTIFICAR EL PUERTO COM
----------------------------------
1. Conecta el lector por USB (si es adaptador USB-serial) o el cable RS232.
2. Abre "Administrador de dispositivos" > "Puertos (COM y LPT)".
3. Busca el puerto que aparece al conectar el lector (ej. "COM3").
4. Anota ese número y ponlo en config.php -> 'com_port'.

PASO 2: CONFIGURAR
-------------------
Edita config.php:
  - com_port: el puerto COM que anotaste
  - api_url: la URL real de tu api/lectura.php en cPanel
  - api_key: una llave que tú inventes (debe coincidir con la que
    pongas en backend-cpanel/config.php del lado del servidor)

PASO 3: PROBAR MANUALMENTE
----------------------------
Abre CMD y ejecuta (ajusta la ruta a tu XAMPP si es distinta):

  C:\xampp\php\php.exe C:\ruta\a\lector_agente.php

Pasa un chip cerca del lector. Deberías ver "Chip detectado: ..." en pantalla.
Si no aparece nada, revisa debug.log (déjalo en 'debug' => true en config.php)
para ver exactamente qué líneas está mandando tu lector, y ajusta la función
extraer_chip_id() en lector_agente.php si el formato no coincide.

PASO 4: DEJARLO CORRIENDO SIEMPRE
-----------------------------------
Usa el Programador de tareas de Windows:
  1. Crear tarea básica.
  2. Desencadenador: "Al iniciar sesión".
  3. Acción: iniciar programa
     Programa: C:\xampp\php\php.exe
     Argumentos: C:\ruta\a\lector_agente.php
  4. Marca "Ejecutar tanto si el usuario inició sesión como si no" si quieres
     que arranque solo, sin depender de que alguien inicie sesión.

Revisa agente.log de vez en cuando para confirmar que sigue funcionando.
