ProxUSB (módulo OEM) Manual del usuario
Contents
1. O 2006 Sitepro S A 5 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 Descripci n del programa demo ProxUSB EXE El programa ProxUSB EXE es una peque a demostraci n del potencial de la placa Se trata de un ejecutable residente que permanece activo en background interrogando cada 2 segundos a la interfaz Si se detecta que hubo una lectura de tarjeta satisfactoria el programa obtiene la hora y fecha del RTC propio y va almacenando dichos datos en un buffer que puede consultarse por pantalla ProxUSB Interf z Wiegand USB v1 4 Interf z Wiegand a USB y l Sitepro 5 4 Copyright 2004 Derechos Reservados ProxUSB j a Monitor de lecturas en tiempo real 000001645 14701 2006 13 50 44 1 05 05 0071 Guardar Lecturas Yaciar listado 14 01 2006 19 50 53 Cantidad de lectores on line 1 w26b STD 1 El bot n Guardar Lecturas abre una ventana interrogando por un nombre de archivo donde salvar la informaci n almacenada en el buffer de lecturas El bot n Vaciar listado sirve para borrar toda la informaci n acumulada en el buffer de lecturas y dejar el listado en blanco En la barra de estado inferior se puede ver la hora y fecha del reloj interno de la placa el estado del lector y la cantidad de lecturas almacenadas en el buffer Atenci n el buffer de lecturas se arma en forma din mica en al memoria RAM de la PC Dicha informaci n se pierde si se sale del programa sin usar la o2. Este password es necezaro para realizar todas las 00000000 operaciones de configuraci n Configurar Fecha y Hora Protocolo del lector 0171172004 13 19 03 Leer Grabar Grabar gt Cambiar password m Informaci n E Memoria 4000 SENEN Muewa Password Dalas DS 1302 Reloj Firmware un Cambiar Password a e 0 411 0001 Estado La fecha se ha leido correctamente La password que viene pre configurada de f brica son ocho ceros 00000000 Se puede usar hasta ocho caracteres n meros s mbolos o letras Se debe tener presente que las letras en may sculas y min sculas se asumen como caracteres distintos Si su aplicaci n es sensible al cambio de hora y fecha por parte de un usuario final es recomendable cambiar la password de f brica por una propia antes de entregar el producto Tambi n esta previsto en el futuro la posibilidad de contemplar m s formatos en el protocolo de comunicaci n del lector lo cual se podr configurar mediante este utilitario O 2006 Sitepro S A 4 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 Descripci n del utilitario emulador de teclado El utilitario ProxUSBtec exe es un peque o programa residente que se encarga de monitorear la lectura de tarjetas y presentarle al sistema operativo los datos le dos como si hubieran ingresado por el teclado Esto es muy til para integrar de forma inmediata la captura de datos en aplicaciones existentes sin necesida
3. mantiene la fecha y hora Para configurar la hora y fecha actual se puede usar la funci n GrabarFechaHora indicando en sus par metros d a mes a o hora minutos y segundos Adem s para modificar el horario del reloj es necesario pasarle como par metro a esta funci n el password de habilitaci n A partir de ese momento el reloj interno de la llave mantiene la fecha y hora actualizada aunque se apague la PC Para leer la hora y fecha del reloj utilice la funci n LeerfFechaHora Desde la versi n 2 0 que contempla manejo de varios ProxUSB en paralelo es necesario especificar como primer par metro el ID del lector del cual se leer el n mero de tarjeta Formato unsigned long int GrabarFechaHora char num_serie unsigned short dia unsigned short mes unsigned short anio unsigned short hora unsigned short min unsigned short seg char password Par metros char num_serie ID del lector sobre el cual se realiza la operaci n unsigned long dia en este par metro debe indicarse el d a a grabar debe ser un valor entre 1y 31 unsigned long mes en este par metro debe indicarse el mes a grabar debe ser un valor entre 1 y 12 unsigned long anio en este par metro debe indicarse el ano a grabar se almacenan los dos ltimos d gitos del a o solamente El valor debe pertenecer al rango O 99 unsigned long hora en este par metro debe indicarse la hora a grabar debe ser un valor entre 0 y 24 u
4. realiz correctamente pero no hubo lectura O 2006 Sitepro S A 9 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 PROX_USB_FICHADA_OK 1 si hubo una lectura de tarjeta correcta En este caso el par metro num_tarjeta devuelve una cadena de 10 caracteres num ricos con la informaci n de la tarjeta Si el n mero es menor a diez d gitos se completa con ceros a la izquierda La cadena retornada tiene la siguiente estructura FFFFENNNNN Po NNNNN FFFFF Facility Code se completa con ceros a la izquierda Card Number se completa con ceros a la izquierda PROX_USB_ERROR_PARIDADFICHADA 2 si hubo algun error al validar la paridad de la informaci n obtenida Nota La forma normal de implementar una aplicaci n que requiere la lectura de una tarjeta es armar un loop donde se invoca a la funci n LeerTarjeta y monitorear el valor retornado hasta que sea 1 Cuando este es el caso procesar el valor de la tarjeta retornado en num_ tarjeta 2006 Sitepro S A 10 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 Cada dispositivo PROX USB cuenta con un reloj interno que funciona como reloj y calendario Esta funci n retorna la fecha y hora del reloj del m dulo Si la operaci n se realiz exitosamente la funci n retorna 0 en caso contrario retorna un c digo de error A partir de la versi n 2 0 que contempla manejo de varios ProxUSB en paralelo es necesario especificar como primer p
5. Manual del usuario ProxUSB Release 06 01 12 ProxUSB m dulo OEM Conversor de protocolo wiegand a interfaz USB para lectores de RFID Manual del usuario Revisi n 2 0 O 2006 Sitepro S A 1 www proxusb com ar Contenido Descripci n del m dulo Descripci n del utilitario de configuraci n Descripci n del utilitario emulador de teclado Descripci n del programa demo ProxUSB EXE Detalle de conexiones Detalle de la librer a Prox USB DLL Funci n BuscarLertor Funci n BuscarSiguienteLector Funci n LeerTarjeta Funci n LeerFechaHora Funci n GrabarFechaHora Funci n LeerMemoria Funci n GrabarMemoria C digos de resultado Especificaciones t cnicas O 2006 Sitepro S A Manual del usuario ProxUSB Release 06 01 12 11 12 13 13 15 16 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 Descripci n del m dulo El m dulo ProxUSB permite conectar cualquier lector de tarjetas de proximidad con salida wiegand a una PC o laptop con interfaz USB De esta forma se puede incorporar de forma pr ctica y sencilla la tecnolog a RFID en aplicaciones que requieran el uso de tarjetas de proximidad para identificaci n de visitas empleados procesos de producci n etc Tarjeta Lector ProxUSB Computadora Diagrama de implementaci n t pica El protocolo soportado para lectores de tarjetas de proximidad es wiegand 26 bits Standard Esto asegura compatibilidad con
6. ar metro el ID del lector del cual se leer el n mero de tarjeta Formato unsigned long int LeerFechaHora char num_serie unsigned short dia unsigned short mes unsigned short ano unsigned short hora unsigned short minutos unsigned short segundos Par metros char num_serie ID del lector sobre el cual se realiza la operaci n unsigned short dia en este par metro se retorna un valor entre 1 y 31 que indica el d a del mes que tiene el calendario del reloj unsigned short mes este par metro retorna valores entre 1 y 12 el valor que tome indica el mes del a o que tiene el calendario del reloj unsigned short ano este par metro retorna valores entre 2000 y 2099 indica el a o que tiene el calendario del reloj unsigned short hora retorna la hora que se encuentra configurada en el reloj Los valores posibles son entre O y 23 unsigned short minutos retorna los minutos que tiene configurados el reloj Los valores posibles son entre O y 59 unsigned short segundos retorna los segundos actuales que han pasado en el relos Los valores posibles son entre O y 59 Valores Retornados Retorna PROX_USB_OK 0 si encuentra un m dulo Prox USB conectado en caso contrario retorna un c digo de errror ver cuadro C digos de resultado O 2006 Sitepro S A 11 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 ON Cada m dulo PROX USB cuenta con un reloj calendario interno que
7. d de modificar el c digo fuente Una vez ejecutado el programa se visualiza como un peque o icono en la barra de tareas del Windows junto a la esquina donde se muestra la hora de la PC cono del programa ProxUSBtec exe p EN l As 12 02 p m Haciendo click con el bot n derecho del mouse sobre el icono se accede a un men de configuraci n donde es posible configurar la forma en que se presentan los datos a la aplicaci n La siguiente pantalla muestra el aspecto de la ventana de configuraci n Configuraci n ProxlUiSBtec c 2004 Sitepro 5 4 Yersi n 1 0 Emulador de teclado para m dulo Frox SE ProxUSB Formato de la cadena de salida i H mero de Tarjeta Caracteres finales Enter M Tabulaci n Password Salvar Configuraci n Desde aqu se puede configurar b sicamente la forma en que el emulador presenta la informaci n al buffer de teclado Como se puede apreciar delante y atr s del campo con el n mero de tarjeta hay dos cuadros donde se pueden agregar hasta diez caracteres num ricos fijos que agregar n al n mero le do Esto permite adaptarse f cilmente a cualquier aplicaci n existente donde se requiera completar con ceros para que el n mero generado tenga un largo determinado Atenci n el emulador pone la informaci n le da en la cola de mensajes de teclado del Windows o sea que dichos caracteres ingresaran en el campo de la aplicaci n que este activa y tenga el foco del Windows en ese momento
8. la gran mayor a de implementaciones de RFID La tensi n del m dulo y del lector de tarjetas se toma de la propia interfaz USB con lo cual no se requiere el uso de fuentes de alimentaci n externas ver caracter sticas t cnicas para m s detalle de consumos admitidos El m dulo contiene adem s un reloj de tiempo real y una memoria no vol til para el desarrollador que pueden ser accedidos a trav s de una librer a para Windows Diagrama en bloques Interfaz Wiegand La configuraci n del reloj se realiza mediante un utilitario protegido por una password que el desarrollador puede configurar seg n su criterio De esta forma no puede ser accedida por el usuario final lo cual es muy til en aplicaciones de control auditoria tiempo y asistencia etc O 2006 Sitepro S A 3 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 Descripci n del utilitario de configuraci n El utilitario ProxUSBconfig exe permite ver y o cambiar la hora y fecha que maneja el reloj interno de la interfase En el primer campo del utilitario se debe ingresar el password de acceso que permite grabar los cambios al poner en hora y fecha el reloj Este password tambi n es requerido para la funci n que permite grabar un password nuevo La funci n que permite leer la configuraci n del reloj no requiere password alguno 2 ProxUSBConfig Utilitario de configuraci n v1 0 X E ProxUSB TOR Fe Conversor RFID USB Password de accezo
9. lamadas a una DLL La librer a Prox USB DLL exporta una serie de funciones que permiten Obtener informaci n del m dulo Consultar si fue le da alguna tarjeta Obtener los datos de la tarjeta de proximidad le da Consultar o actualizar la hora y fecha del reloj de tiempo real del m dulo Leer o grabar informaci n en la memoria no vol til propia del m dulo En el CD encontrara un ejemplo en VisualBasic 6 0 de c mo declarar y utilizar las funciones de esta librer a para obtener la informaci n del reloj y la lectura de tarjetas Tambi n se incluye un demo en VisulaC 6 0 donde se detalla como usar cada una de las funciones A continuaci n se detalla la sintaxis y los par metros espec ficos de cada funci n en formato VisualC Esta funci n busca un m dulo Prox USB v lido que est conectado a alg n puerto USB de la PC Es la primera funci n que debe invocarse para verificar que haya alg n lector conectado y a su vez dejar iniciada una conexi n para luego leer las tarjetas Formato unsigned long int BuscarLector char num_serie Par metros char num_serie en este par metro devuelve el n mero de serie del lector En caso que la funci n retorne error devuelve la string vac a Valores Retornados Retorna PROX_USB_OK 0 si encuentra un lector de proximidad Prox USB v lido en caso contrario retorna un c digo de error ver cuadro C digos de resultado O 2006 Sitepro S A 8 www proxusb co
10. lor Descripci n PROX_USB_OK 0 No hubo errores PROX_USB_ERROR_ESCRITURA 1 Error al escribir la informaci n en el i dispositivo PROX_USB_ERROR_LECTURA 2 Error al leer el dispositivo PROX_USB_ERROR 3_ Error indefinido PROX_USB_ERROR_MODELO 4 El dispositivo conectado no es una placa PROX USB PROX USB ERROR SI NRELOJ ener 5 ener erre ee E i a dispositivo detectado carece d e reloj 2 de PANAIA e e tiempo real RTC o el reloj no est A funcionando correctamente ____ PROX_USB_ERROR_SINLECTOR 0 6 El dispositivo detectado no soporta el e manejo de lectores de tarjetas RFID PROX_USB Fl CHADA OK a 1 AT a S a HE ha descargado nae afichada IEEE correctamente PROXUSE ERROR PARIDADFICHADA TO TE 2 a m i i paridad de la fichada PROX USB ERROR OUTOFRANGE AA 7 enarerrna rr rnaarrnnanes SER La e lectura escritura de a memora a no ce A i pudo realizar porque los l mites est n O 2006 Sitepro S A 15 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 Especificaciones t cnicas AT Detalle 0 Dimensiones de la placa 67 x 67 mm de lado altura 15 mm A j ER A dal ona co al USB e Ono N o E Lo a aan Oe Ta herem a CATE PERS a 7E ninos mermas NE IIT IEE ENTE Buzzer E as ml re o e ras y A _ IO La alimentaci n del lector de tarjetas se toma de la propia interfaz USB Es importante contemplar que el con
11. m ar Manual del usuario ProxUSB Release 06 01 12 Esta funci n busca un m dulo Prox USB que sigue al m dulo con n mero de serie enviado como par metro Formato unsigned long int BuscarSiguienteLector char num_serie Par metros char num_serie en este par metro se env a el n mero de serie del lector a partir del cual se busca el lector que le sigue Valores Retornados Retorna PROX_USB_OK 0 si encuentra un lector de proximidad Prox USB v lido que sigue al n mero de serie pasado por par metro Esta funci n se utiliza para comprobar si fue le da alguna tarjeta de proximidad En el caso de que se haya realizado una lectura tambi n retorna el n mero de la tarjeta Una vez que la funci n retorno estos datos el m dulo queda listo para la pr xima lectura Mientras tiene en memoria un n mero de tarjeta sin descargar no sigue leyendo otras tarjetas que se aproximen A partir de la versi n 2 0 que contempla manejo de varios ProxUSB en paralelo es necesario especificar como primer par metro el ID del lector del cual se leer el n mero de tarjeta Antes de utilizar esta funci n es necesario usar BuscarLector Formato unsigned long int LeerTarjeta char num_serie char num_ tarjeta Par metros char num_serie ID del lector sobre el cual se realiza la operaci n char num_tarjeta es el n mero de la tarjeta que se aproxim al lector Valores Retornados PROX_USB_OK 0 si la operaci n se
12. moria unsigned long cantidad cantidad de bytes a leer La suma entre el byte de inicio y cantidad no debe ser mayor a la memoria disponible del m dulo Valores Retornados PROX_USB_OK 0 si se ha podido realizar la operaci n de lectura correctamente de lo contrario retorna un c digo de error ver cuadro C digos de resultado Esta funci n permite grabar strings en la memoria no vol til del lector Se puede usar la funci n LeerMemoria para recuperar las cadenas almacenadas A partir de la versi n 2 0 O 2006 Sitepro S A 13 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 que contempla manejo de varios ProxUSB en paralelo es necesario especificar como primer par metro el ID del lector del cual se leer el n mero de tarjeta Formato unsigned long int GrabarMemoria char num_ serie unsigned long inicio unsigned long cantidad char cadena Par metros char num_serie ID del lector sobre el cual se realiza la operaci n unsigned long inicio n mero de byte donde se comenzar a escribir la memoriaa unsigned long cantidad longitud de la cadena expresada en cantidad de caracteres char cadena puntero a los datos de la cadena a grabar O 2006 Sitepro S A 14 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 C digos de resultado Esta p gina contiene los c digos de error posible que retornan las funciones exportadas por la librer a Prox USB DLL Nombre Va
13. nsigned long min en este par metro debe indicarse los minutos a grabar debe ser un valor entre O y 59 unsigned long seg en este par metro debe indicarse los segundos a grabar debe ser un valor entre O y 59 O 2006 Sitepro S A 12 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 unsigned long password en este par metro indique el password del lector de proximidad Este par metro solo es requerido para modificar la fecha y hora del lector Valores Retornados Retorna PROX_USB_OK 0 si la operaci n se pudo completar correctamente en caso contrario retorna un c digo de error ver cuadro C digos de resultado El dispositivo PROX USB cuenta con un bloque de memoria no vol til donde el programador puede almacenar informaci n que requiera posteriormente La funci n LeerMemoria permite leer la informaci n almacenada en esta memoria La cadena le da se retorna en una string la cual debe ser creada antes de invocar a la funci n A partir de la versi n 2 0 que contempla manejo de varios ProxUSB en paralelo es necesario especificar como primer par metro el ID del lector del cual se leer el n mero de tarjeta Formato unsigned long int LeerMemoria char num_serie unsigned long inicio unsigned long cantidad char cadena Par metros char num_serie ID del lector sobre el cual se realiza la operaci n unsigned long inicio n mero de byte a partir del cual se comenzar a leer la me
14. pci n Guardar Lecturas o si la PC se apaga abruptamente O 2006 Sitepro S A 6 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 Detalle de conexiones El m dulo ProxUSB tiene una bornera que sirve para realizar la conexi n del lector de tarjetas y una ficha polarizada para la conexi n del cable USB que va a la computadora A continuaci n se detalla las se ales disponibles en cada conector Bornera B1 conexi n del lector de tarjetas Tensi n de 5 volts para alimentar el lector de tarjetas de proximidad Esta tensi n se obtiene de la propia interfaz USB por lo tanto verifique que la interfaz utilizada sea capaz de entregar la corriente que requiere el lector El consumo del lector de proximidad no deber superar los 80 mA en ning n caso Se al de masa para conectar el lector de tarjetas Se al Data0 del lector de proximidad Se al Datal del lector de proximidad Ficha J1 conexi n USB a la computadora Tensi n de 5 volts Rojo Se al D de la interfaz USB Verde OV B Se alD dela interfaz USB Blanco E Se al de masa Negro ey 11Useb AY O 2006 Sitepro S A 7 www proxusb com ar Manual del usuario ProxUSB Release 06 01 12 Detalle de la librer a ProxUSB DLL El m dulo ProxUSB puede manejarse desde una aplicaci n propia para Windows a trav s de una librer a que es compatible con cualquier lenguaje de programaci n que soporte l
15. sumo del lector no supere los 80 ma Tambi n se debe verificar que la salida USB utilizada pueda suministrar la corriente necesaria para alimentar la placa ProxUSB m s el lector de tarjetas O 2006 Sitepro S A 16 www proxusb com ar
Download Pdf Manuals
Related Search