03 abril 2013

ANÁLISIS DE TRAMA DE COMUNICIÓN CCTALK CON UN SELECTOR DE MONEDAS

(EN) CcTalk communication frame analysis with a coin acceptor.
(FR) Analyse de trame de communication cctalk avec un monnayeur.
(PT) Análise da trama de comunicação cctalk com um selector de moedas.
----------------------------------------------------------------------------------------------------------------------

PARA REPASAR: Protocolo cctalk. He usado un selector modular Z6 de Azkoyen. No es igual pero el protocolo se parece mucho al que puedes encontrar googleando por "modular x6 cctalk".

   emoreno en un comentario a la entrada "Descifrar trama de comunicación cctalk" me solicitaba una trama con un selector de monedas.

Sat2ep en un comentario a la entrada "Obtener tramas cctalk" habla de un programa para probar selectores de monedas cctalk llamado "cctalk demo".

Es gratuito y lo he encontrado. (Googleando por "cctalk demo" hay enlaces a nri que es fabricante de monederos. De ahí acabo redirigido a una web de Crane Payment Solutions. En Suport/NRI suport/Other accesories/ccTalk-Demo-Software, v.3.1.0.0 for PC-based applications of ccTalk coin validators).
coin acceptor test
Probador monederos cctalk de NRI
 Así que he estado trasteando con él. Es un programa para windows pero yo lo he usado con linux (Ubuntu) con Wine sin problemas.
Y he monitorizado la actividad del puerto serie. Otra vez con una demo del programa Docklight. Se trata de algo parecido a lo de la entrada "Obtener tramas cctalk" pero ahora no hay máquina tragaperras. Un ordenador maneja al selector con el cctalk demo y la placa interface pc-cctalk. Y con otro monitorizo las dos lineas Rx y Tx del puerto serie.

Reading cctalk frames from coin aceptor
Esquema para leer tramas cctalk de un selector de monedas

He ejecutado el "cctalk demo" y he introducido una moneda que ha sido aceptada. He recortado una captura de pantalla del escaneo de la linea Rx entre el ordenador1 y el interface cctalk. Esta vez los códigos de los bytes están en decimal (en una entrada anterior estaban en hexadecimal),

Una anotación curiosa y supongo que importante para los que quieran programar: observarás que solo aparecen códigos de la linea Rx. Eso es porque el interface Pc-cctalk que yo he montado es "con eco". Explicaré esto brevemente. Si observas el esquema de "mi conexión cctalk a pc" verás que en el punto "cctalk data" se generan los pulsos a masa o a tensión positiva a través del transistor BC546 gobernado a su vez por el otro transistor y el MAX232 por la linea Tx del PC. Pero todo lo generado por esa linea Tx del pc se une a través del diodo BAT54 y el MAX232 a la linea Rx del pc. Es decir, todo lo que el pc "envía" a través del buffer de Tx a la linea de datos cctalk, es "leído" a través del buffer de Rx del mismo pc. Para no liarnos entonces con numeritos repetidos y tener que interpertar si "van o vienen", mejor solo leemos Rx que coíncide exactamente con la linea de "cctalk DATA". Esto pasa con este interface pero a lo mejor otro que haya por ahí, es sin eco...

Dejo por aquí los datos capturados. Y los analizaré brevemente.

cctalk frames coin selector
Trama cctalk selector de monedas
No vuelvo a explicar generalidades sobre le protocolo cctalk. Si no entiendes lo que comento tal vez debieras leerte primero mis entradas anteriores: "Obtener tramas cctalk" y  "Descifrar trama de comunicación cctalk". Podeis profundizar más buscando las directivas del protocolo por cctalk.org.

Leamos los datos:

002 000 001 254 255-----001 000 002 000 253
Para el dispositivo 002 (selector de monedas), 000 datos, desde la cpu 001, orden 254 ( SIMPLE POLL, "encuesta simple o sencilla"), y checksum.
Pretende confirmar la presencia de un dispositivo en la dirección 2. El dispositivo 2 contesta OK(000).
----------------------------------------------------------------------------------------------------------------------

002 000 001 246 007------001 003 002 000 065 090 075 020
Para el dispositivo 002 (selector), 000 datos, desde cpu 001, orden 246 REQUEST MANUFACTURER ID.  ("pedir identificación del fabricante"), y checksum.
Para la cpu 001, se envían 003 datos, desde el selector 002, como 000 (respuesta), 065="A", 090="Z", 075="K" (AZK en ascii), y checksum. El fabricante es AZKoyen.
---------------------------------------------------------------------------------------------------------------------

002 000 001 244 009------001 002 002 000 090 054 107
Para el 002 (selector), 000 datos, desde cpu 001, orden 244 REQUEST PRODUCT CODE ("pedir código del producto"), y checksum.
De la misma forma que antes en selector contesta en código ascii 090="Z", 054="6". Modular Z6 es el nombre del modelo del selector.
--------------------------------------------------------------------------------------------------------------------

002 000 001 242 011-----001 003 002 000 243 088 029 146
Para el 002, 000 datos, desde cpu 001, orden 242 REQUEST SERIAL NUMBER ("petición del número de serie), y el checksum.
Se envían a la cpu 001, 003 datos, desde el selector 002, como respuesta 000. Primero los bits menos significativos y luego los más significativos. Hay que pensar que son tres bytes en binario. 243d=11110011b; 088d=01011000b; 029d=00011101b. Que ordenando como de más significativo a menos (como hacemos cuando contamos en decimal) sería 29-88-243 o   000111010101100011110011 en binario, 1D58F3 en hexadecimal, y 1923315 en decimal.
----------------------------------------------------------------------------------------------------------------------
  
002 000 001 241 012-------001 014 002 000 090 054 032 099 099 116 097 108 107 032 086 055 046 051 191
Para el 002, 000 datos, desde la cpu 001, orden 241 REQUEST SOFTWARE REVISION ("petición de la versión del software") y cheksum.
El dispositivo 002 (selector) responde (000) al 001 (cpu) con 014 datos. En ascii 090="Z"; 054="6"; 032=" "; 099="c"; 099="c"; 116="t"; 097="a"; 108="l"; 107="k"; 032=" "; 086="V"; 055="7"; 046="."; 051="3"; y el checksum. Z6 cctalk V7.3 es el software programado en el selector de monedas.
-----------------------------------------------------------------------------------------------------------------------

002 000 001 213 040-------001 001 002 000 000 252
La cpu ordena 213 REQUEST OPTION FLAGS, preguntando de que forma se envían los valores de las monedas.
El selector contesta con 001 dato, el 000, que indica que las monedas se indicarán por la posición de cada moneda en la memoria del selector.
------------------------------------------------------------------------------------------------------------------------

002 002 001 231 255 255 022-------001 000 002 000 253
La cpu 001 envía 002 datos al selector 002. Mediante la orden 231 MODIFY INHIBIT STATUS indica que monedas se habilitan y cuales están inhibidas. Cada bit de los dos bytes está asociado a una moneda. El primer byte son las monedas del 1 al 8. El segundo las monedas del 9 al 16. Después de un reset y al arrancar todos los bits valen 0 y por lo tanto todas las monedas están inhibidas. Aquí se envían dos bytes 255, es decir, todo unos. Todas las monedas están habilitadas.
La respuesta 000 confirma que todo OK.
--------------------------------------------------------------------------------------------------------------------------

002 001 001 228 001 023-------001 000 002 000 253
La orden 228 MODIFY MASTER INHIBIT STATUS activa o desactiva la  aceptación de monedas (inhibición maestra). Sólo se usa el bit menos significativo del byte "dato" (001) si está a cero no se aceptan monedas. Si está a 1 sí se aceptan. Cuando se hace un reset o un encendido se inicializa (creo que a 0). Aquí es 001, por lo tanto 1 y se aceptan monedas.
---------------------------------------------------------------------------------------------------------------------------

002 000 001 227 026-------001 001 002 000 001 251
La orden 227 REQUEST MASTER INHIBIT STATUS consulta el estado actual del bit "inhibición maestra". Si el bit menos significativo del dato devuelto es 0 no se aceptan monedas. Si es 1 se aceptan. Aquí, como lo hemos puesto en la trama anterior, está a 1 (001).
-----------------------------------------------------------------------------------------------------------------------------

002 001 001 184 001 067-------001 006 002 000 069 085 048 048 053 065 135
184 REQUEST COIN ID. Petición del identificativo de la moneda situada en la posición indicada por el dato. En este caso 001.
La respuesta consta de 006 datos en ascii: "EU005A". (Será la moneda de 5 céntimos de euro).
---------------------------------------------------------------------------------------------------------------------------

002 001 001 184 002 066-------001 006 002 000 069 085 048 049 048 065 139
Otra vez 184 REQUEST COIN ID. pero esta vez de la moneda 002
Y la respuesta otros 006 datos en ascii: "EU010A". (Será la moneda de 10 céntimos de euro).
--------------------------------------------------------------------------------------------------------------------------

(...)
Y se repiten varias tramas con la orden 184 REQUEST COIN ID. pidiendo el identificativo de las sucesivas monedas hasta la última posición 16.
La moneda 3="EU020A" (20céntimos de euro)
La moneda 4="EU050A" (50 céntimos de euro)
La moneda 5="EU100A" (100 céntimos de euro, es decir 1 euro)
La moneda 6="EU200A" (2 euros)
La moneda 7="......"
La moneda 8="......"
La moneda 9="......"
La moneda 10="......"
La moneda 11="......"
La moneda 12="......"
La moneda 13="......"
La moneda 14="......"
La moneda 15="TK    " (cuatro espacios después de TK)
La moneda 16="TK    "(cuatro espacios después de TK)

Lo de TK hace referencia a "Token" o algún tipo de ficha que el monedero puede reconocer y no es una moneda.
--------------------------------------------------------------------------------------------------------------------------

002 001 001 209 001 042-------001 004 002 000 004 004 004 004 233
El comando 209 REQUEST SORTER PATHS consulta al selector que canal de salida se le asigna a la moneda que indica el dato. En este caso 001. El selector Z6 puede manejar unas bobinas que modificarán el camino de salida de la moneda una vez aceptada pudiendo ser enviadas diferentes monedas a diferentes cajones.
Se responden 004 datos. Según preferencia serán enviadas al canal que se indique en primer lugar y si por algo no está permitido ese canal será desviada respectivamente al siguiente. En este caso los cuatro datos son el canal 004.
---------------------------------------------------------------------------------------------------------------------------

002 001 001 209 002 041-------001 004 002 000 003 003 004 004 235
Otra vez la orden 209 REQUEST SORTER PATHS pero esta vez se consulta sobre la moneda 002. La moneda 2 sale por el canal 003 y si está ocupado por el 004.
---------------------------------------------------------------------------------------------------------------------------

(...)
Y sucesivamente se van consultando los caminos de salida de las siguientes monedas.
La moneda 3 sale por el canal 3 y si está ocupado por el canal 4.
La moneda 4 sale por el canal 3 y si está ocupado por el canal 4.
La moneda 5 sale por el canal 2 y si está ocupado por el canal 4.
La moneda 6 sale por el canal 1 y si está ocupado por el canal 4.
---------------------------------------------------------------------------------------------------------------------------

002 001 001 209 007 036-------
002 001 001 209 008 035-------
(...)
Para las monedas 7, 8, 9, 10, 11, 12, 13, 14 no hay respuesta. Se pasa el tiempo y se consulta la siguiente.
---------------------------------------------------------------------------------------------------------------------------

002 001 001 209 015 028-------001 004 002 000 000 000 000 000 249
002 001 001 209 016 027-------001 004 002 000 000 000 000 000 249
El valor de canal igual a 0 significa canal por defecto. Que se modifica con el comando 189 Modify default sorter path, y se consulta con 188 Request default sorter path. Aquí sabemos que la moneda (o token en este caso) 15 y 16 van al canal por defecto, aunque no sepamos todavía cuál es.
----------------------------------------------------------------------------------------------------------------------------

 002 000 001 230 023-------001 002 002 000 255 255 253
230 REQUEST INHIBIT STATUS solicita información sobre la configuración de los bits de inhibición de monedas. Cada moneda está asociada a un bit de inhibición. Hay 16 monedas. Por lo tanto los bits de las 16 monedas ocupan dos bytes. Un 0 indica moneda inhibida. Un 1 indica moneda habilitada. Estos bits se pueden modificar con 231 Modify inhibit status
La respuesta son dos datos 255 255. Es decir todos 1. El primer byte son las monedas del 1 al 8. El segundo son las monedas del 9 al 16. La contestación del selector de monedas indica que todas las monedas están habilitadas. Tras un reset todos los bits valdrán 0.
----------------------------------------------------------------------------------------------------------------------------

 002 000 001 221 032-------001 001 002 000 255 253
221 REQUEST SORTER OVERRIDE STATUS consulta sobre qué canales de salida están permitidos. Podrían haber sido modificados con 222 Modify sorter override status. El dato en cuestión (aquí 255), es un byte en donde el bit 0 menos significativo indica si el canal 1 está permitido o no. El bit1 indica el canal 2 y así correlativamente. Un 1 indica permitido. Un 0 indica que no está permitido y la moneda será enviada a otro canal o al canal por defecto.
La respuesta 255 (todo 1) indica que todos los canales de salida están permitidos
---------------------------------------------------------------------------------------------------------------------------

002 000 001 188 065-------001 001 002 000 004 248
188 REQUEST DEFAULT SORTER PATH solicita información sobre el canal por el que saldrán las monedas por defecto. Esto puede programarse con la orden 189 Modify default sorter path
En este caso el canal de clasificación al que se encaminan las monedas por defecto es el 004.
---------------------------------------------------------------------------------------------------------------------------

002 000 001 229 024-------001 011 002 000 006 000 254 000 254 000 254 000 254 000 254 246
 229 READ BUFFERED CREDIT OR ERROR CODES los eventos que suceden de aceptación de monedas o de errores se guardan en un buffer de 10 bytes, indicando los últimos cinco sucesos. Así se puede consultar al selector a menor velocidad que la introducción de monedas y no perder información de créditos. Al añadirse un evento nuevo se perderá el último. Para saber que no se han perdido eventos se debería vigilar el contador de eventos. Cada vez que hay un evento nuevo el contador se incrementa en una unidad hasta 255. Después de 255 pasará a ser 1. Será 0 sólo después de un corte de alimentación o un reset.
El selector no acepta monedas hasta que recibe un primer comando 229. Luego tendrá que recibir otro antes de un segundo. Si no recibe otro antes el selector volverá a dejar de aceptar monedas. Y no volverá a aceptar hasta otro comando 229

La respuesta son 011 datos. El primero (aquí 006), es el contador de eventos. Desde que se le ha dado tensión al selector de monedas y se ha hecho esta consulta ha habido 6 eventos. Los últimos cinco se nos indica en parejas. El siguiente dato (aquí 000), será 0 si indica un error, y un número de 1 a 16 si se ha aceptado una moneda indicando de cual se trata. El siguiente dato (aquí 254),  indica el tipo de error si el dato anterior era 0 (aquí es este caso), o el canal por el que se ha clasificado la moneda si el dato anterior era una moneda del 1 al 16.
En este caso particular tenemos que ha habido 006 eventos desde que se ha encendido el selector. Los cinco últimos han sido 000 254. Es decir "un error", el 254 (mecanismo de recuperación activado).  Antes de monitorizar la comunicación e introducir una moneda, es verdad que he estado jugando con la palanca de recuperación y probablemente tuviese el selector con tensión.     
Algunos códigos de error posibles son:  
0 - evento vacío
1 - moneda rechazada (fuera de parámetros)
2 - moneda inhibida
5 - moneda rechazada (demasiado tiempo en ser analizada)
6 - demasiado tiempo es pasar la moneda por la salida
8 - dos monedas demasiado juntas
13-módulo sensor no funciona bien
14-atasco en detector de salida
20-activado el sistema antihilo
23-moneda demasiado rápida
127+n - moneda n inhibida por el registro de inhibiciones
254-mecanismo de recuperación activado
255-error no especificado
--------------------------------------------------------------------------------------------------------------------------

002 000 001 229 024-------001 011 002 000 006 000 254 000 254 000 254 000 254 000 254 246
Se sigue leyendo el buffer de créditos o eventos.
(...)
---------------------------------------------------------------------------------------------------------------------------

002 000 001 229 024-------001 011 002 000 007 001 004 000 254 000 254 000 254 000 254 238
Ha habido un evento nuevo (007). La moneda 001 a sido aceptada y clasificada por el canal 004. La moneda 1 habíamos visto que era la de 5 céntimos de euro.
--------------------------------------------------------------------------------------------------------------------------


002 000 001 229 024-------001 011 002 000 007 001 004 000 254 000 254 000 254 000 254 238
(...)
Y así, leyendo el buffer, sin eventos nuevos, hasta el final de la trama analizada...
---------------------------------------------------------------------------------------------------------------------------