README

ccTools, a collection of tools to interact with a ccTalk bus

= Intro

ccTalk is a protocol designed to communicate with money-related devices like coin acceptors.
You can get more information about this at www.cctalk.org

= Tools

== ccSniff
ccSniff is meant to be used as a ccTalk bus sniffer. Just connect a UART (like a bus pirate) and start ccSniff.

Usage: ccSniff.py [options]

Options:
  -h, --help            show this help message and exit
  -i DEVICE, --interface=DEVICE
                        Serial port to use
  -w FILE, --write=FILE
                        File name to write data
  -b, --bus-pirate      Use this switch to tell the serial port is a bus
                        pirate

The ccTalk messages will be displayed in the console.


== ccParse
ccParse can read a data dump made by ccSniff to actually parse the data in a more comprehensive way.
Just launch ccParse with a dump file as a parameter.

ccParse uses the urwid library.

== ccJack
ccJack is used to hijack a ccTalk device on a bus. You will need a UART with both RX and TX connected to the but for it to work.
ccJack works by firstly listening for data, then learn responses made by the device to be hijacked. Then it sends out an "Address change" request to the device and starts to respond instead of the hijacked device.

Usage: ccJack.py [options]

Options:
  -h, --help            show this help message and exit
  -i DEVICE, --interface=DEVICE
                        Serial port to use
  -b, --bus-pirate      Use this switch to tell the serial port is a bus
                        pirate
  -s SOURCE, --source=SOURCE
                        Source address of the device to hijack
  -d DESTINATION, --destination=DESTINATION
                        Destination address of the device to hijack
  -t TIME, --time=TIME  Time to listen for packets
  -r FILE, --read=FILE  File to read responses from

You can optionaly provide a ccSniff capture file for ccJack to learn responses. As responses can sometimes change, it will always take the last responses it read on the bus.

== Teensy server
This file is meant to be used woth the arduino software and a Teensy device.
You will need to tweak the channelValue[] table to actually set how many credits (well, how many keystrokes) to send.

Just upload it to your Teensy, then connect the UART pins (look there for the correct pins http://www.pjrc.com/teensy/td_uart.html).