Collection of tools used to interact with a ccTalk bus
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Teensy/server Removed debug info Jul 16, 2013
.gitignore changed .gitignore Sep 8, 2013
README Add README Nov 4, 2012
ccJack.py Code cleanup Sep 14, 2013
ccParse.py i. Sep 14, 2013
ccSniff.py Code cleanup Sep 14, 2013
ccTalk.py Added raw() CRC usage. Changed __len__() calculation Sep 20, 2013

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).