innovative technology SMART Coin System User manual

INNOVATIVETECHNOLOGYLTD

ProtocolManual

SSP

SMARTHOPPER,SMARTSYSTEM

versionGA138_2_2_223A

SSPProtocolManualGA138_2_2_223A
Contents
Descriptions
Introduction ........
GeneralDescription ........
Hardwarelayer ........
TransportLayer ........
EncryptionLayer ........
EncryptionKeys ........
GenericCommandsandResponses ........
ProtocolVersions ........
SMARTHopper ........
SmartSystem ........
Command/EventTables
SMARTHOPPERCommandTable ........
SMARTHOPPEREventTable ........
SMARTSYSTEMCommandTable ........
SMARTSYSTEMEventTable ........
Commands
Sync ........
Reset ........
HostProtocolVersion ........
Poll ........
GetSerialNumber ........
Disable ........
Enable ........
GetFirmwareVersion ........
GetDatasetVersion ........
SetInhibits ........
SetupRequest ........
PollWithAck ........
EventAck ........
SetDenominationRoute ........
GetDenominationRoute ........
PayoutAmount ........
GetDenominationLevel ........
SetDenominationLevel ........
HaltPayout ........
FloatAmount ........
GetMinPayout ........
SetCoinMechInhibits ........
PayoutByDenomination ........
FloatByDenomination ........
EmptyAll ........
SetOptions ........
GetOptions ........
CoinMechGlobalInhibit ........
SmartEmpty ........
CashboxPayoutOperationData ........
GetAllLevels ........
GetCounters ........
ResetCounters ........
SetGenerator ........
SetModulus ........
RequestKeyExchange ........
CoinMechOptions ........
GetBuildRevision ........

CommsPassThrough ........
SetBaudRate ........
SspSetEncryptionKey ........
SspEncryptionResetToDefault ........
GetRealTimeClockConfiguration ........
SetRealTimeClock ........
GetRealTimeClock ........
SetCashboxPayoutLimit ........
CoinStir ........
PayoutAmountByDenomination ........
Events
SlaveReset ........
Disabled ........
FraudAttempt ........
Initialising ........
Dispensing ........
Dispensed ........
CoinsLow ........
HopperJammed ........
Halted ........
Floating ........
Floated ........
Timeout ........
IncompletePayout ........
IncompleteFloat ........
CashboxPaid ........
CoinCredit ........
CoinMechJammed ........
CoinMechReturnActive ........
Emptying ........
Emptied ........
SmartEmptying ........
SmartEmptied ........
CalibrationFailed ........
DeviceFull ........
CoinMechError ........
AttachedCoinMechDisabled ........
AttachedCoinMechEnabled ........
ValueAdded ........
PayinActive ........

Introduction

SSPProtocolManualGA138_2_2_223A

<<backtoindex



ThismanualdescribestheoperationoftheSmiley®SecureProtocolSSP.

ITLrecommendthatyoustudythismanualastherearemanynewfeaturespermittingnewusesandmore

secureapplications.

IfyoudonotunderstandanypartofthismanualpleasecontacttheITLforassistance.Inthiswaywemay

continuetoimproveourproduct.

Alternativelyvisitourwebsiteatwww.innovativetechnology.co.uk

EnhancementsofSSPcanberequestedbycontacting:

support@innovativetechnology.co.uk

MAINHEADQUARTERS

InnovativeTechnologyLtd

DerkerStreet,Oldham,England.OL14EQ

Tel:+441616269999Fax:+441616202090

Email:support@innovativetechnology.co.uk

Website:www.innovativetechnology.co.uk

Smiley®andtheITLLogoareinternationalregisteredtrademarksandtheyarethepropertyof

InnovativeTechnologyLimited.

InnovativeTechnologyhasanumberofEuropeanandInternationalPatentsandPatentsPendingprotecting

thisproduct.IfyourequirefurtherdetailspleasecontactITL®.

InnovativeTechnologyisnotresponsibleforanyloss,harm,ordamagecausedbytheinstallation

anduseofthisproduct.

Thisdoesnotaffectyourlocalstatutoryrights.

Ifindoubtpleasecontactinnovativetechnologyfordetailsofanychanges.



GeneralDescription

SSPProtocolManualGA138_2_2_223A

<<backtoindex

Smiley®SecureProtocol(SSP)isasecureinterfacespecificallydesignedbyITL®toaddresstheproblems

experiencedbycashhandlingsystemsingamingmachines.Problemssuchasacceptorswapping,

reprogrammingacceptorsandlinetappingarealladdressed.

Theinterfaceusesamasterslavemodel,thehostmachineisthemasterandtheperipherals(noteacceptor,

coinacceptororcoinhopper)aretheslaves.

Datatransferisoveramultidropbususingclockasynchronousserialtransmissionwithsimpleopencollector

drivers.Theintegrityofdatatransfersisensuredthroughtheuseof16bitCRCchecksumsonallpackets.

EachSSPdeviceofaparticulartypehasauniqueserialnumber;thisnumberisusedtovalidateeachdevice

inthedirectionofcredittransferbeforetransactionscantakeplace.Itisrecommendedthattheencryption

systembeusedtopreventfraudthroughbusmonitoringandtapping.Thisiscompulsoryforallpayout

devices.

Commandsarecurrentlyprovidedforcoinacceptors,noteacceptorsandcoinhoppers.Allcurrentfeaturesof

thesedevicesaresupported.

FEA TURES:

SerialcontrolofNote/CoinValidatorsandHoppers

4wire(Tx,Rx,+V,Gnd)system

Opencollectordriver,similartoRS232

HighSpeed9600BaudRate

16bitCRCerrorchecking

DataTransferMode

Encryptionkeynegotiation

128BitAESEncryptedMode

BENEFITS:

Proveninthefield

Simpleandlowcostinterfacingoftransactionperipherals.

Highsecuritycontrolofpayoutperipherals.

Defenceagainstsurrogatevalidatorfraud.

Straightforwardintegrationintohostmachines.

Remoteprogrammingoftransactionperipherals

Openstandardforuniversaluse.



TohelpinthesoftwareimplementationoftheSSP,ITLcanprovide,C/C++Code,C#.NetCode,DLLcontrols

availableonrequest.Pleasecontact:support@innovativetechnology.co.uk

Hardwarelayer

SSPProtocolManualGA138_2_2_223A

<<backtoindex

Communicationisbycharactertransmissionbasedonstandard8bitasynchronousdatatransfer.

OnlyfourwiresarerequiredTxD,RxD,+Vandground.Thetransmitlineofthehostisopencollector,the

receivelineofeachperipheralhasa10Kohmpullupto5volts.Thetransmitoutputofeachslaveisopen

collector,thereceiveinputofthehosthasasingle3k3ohmpullupto5volts.

Thedataformatisasfollows:



Encoding NRZ

BaudRate 9600

Duplex Full

Startbits 1

DataBits 8

Parity none

Stopbits 2



Caution:Powertoperipheraldeviceswouldno rmallybeviatheserialbus.Howeverdevicesthat

requireahig hcurrentsupplyinexcessof1.5Amps,e.g.hoppers,wouldbeexpectedtobe

suppliedviaaseparateconnector.

TransportLayer

SSPProtocolManualGA138_2_2_223A

<<backtoindex

Dataandcommandsaretransportedbetweenthehostandtheslave(s)usingapacketformatasshown

below:

STX SEQ/SLAVEID LENGTH DATA CRCL CRCH



STX Singlebyteindicatingthestartofamessage0x7Fhex

SEQ/

Slave

ID

Bit7isthesequenceflagofthepacket,bits60representtheaddressoftheslavethe

packetisintendedfor,thehighestallowableslaveIDis0x7D

LENGTH

ThelengthofthedataincludedinthepacketthisdoesnotincludeSTX,theCRCorthe

slaveID

DATA Commandsanddatatobetransferred

CRCL,

CRCH

LowandhighbyteofaforwardCRC16algorithmusingthePolynomial(X16+X15+X2

+1)calculatedonallbytes,exceptSTX.Itisinitialisedusingtheseed0xFFFF.TheCRC

is

calculatedbeforebytestuffing.

PACKETSEQUENCING

BytestuffingisusedtoencodeanySTXbytesthatareincludedinthedatatobetransmitted.If0x7F(STX)

appearsinthedatatobetransmittedthenitshouldbereplacedby0x7F,0x7F.

BytestuffingisdoneaftertheCRCiscalculated,theCRCitsselfcanbebytestuffed.Themaximumlengthof

datais0xFFbytes.

Thesequenceflagisusedtoallowtheslavetodeterminewhetherapacketisaretransmissionduetoitslast

replybeinglost.Eachtimethemastersendsanewpackettoaslaveitalternatesthesequenceflag.Ifaslave

receivesapacketwiththesamesequenceflagasthelastone,itdoesnotexecutethecommandbutsimply

repeatsit'slastreply.Inareplypackettheaddressandsequenceflagmatchthecommand

packet.

Thisensuresthatnootherslavesinterpretthereplyasacommandandinformsthemasterthatthecorrect

slavereplied.Afterthemasterhassentacommandtooneoftheslaves,itwillwaitfor1secondforareply.

Afterthat,itwillassumetheslavedidnotreceivethecommandintactsoitwillretransmititwiththesame

sequenceflag.Thehostshouldalsorecordthefactthatagapintransmissionhasoccurredandprepareto

polltheslaveforitsserialnumberidentityfollowingthecurrentmessage.Inthisway,thereplacementofthe

hostsvalidatorbyafraudulentunitcanbedetected.

Thefrequencyofpollingshouldbeselectedtominimisethepossibilityofswappingavalidatorbetweenpolls.

Iftheslavehasnotreceivedtheoriginaltransmission,itwillseetheretransmissionasanewcommandsoit

willexecuteitandreply.Iftheslavehadseentheoriginalcommandbutitsreplyhadbeencorruptedthen

theslavewillignorethecommandbutrepeatitsreply.Aftertwentyretries,themasterwillassumethatthe

slavehascrashed.Aslavehasnotimeoutorretrylimit.Ifitreceivesalonesyncbytepartwaythrough

receivingapacketitwilldiscardthepacketreceivedsofarandtreatthenextbyteasanaddressbyte.

EncryptionLayer

SSPProtocolManualGA138_2_2_223A

<<backtoindex

PACKETFORMAT

Encryptionismandatoryforallpayoutdevicesandoptionalforpayindevices.Encrypteddataandcommands

aretransportedbetweenthehostandtheslave(s)usingthetransportmechanismdescribedabove,the

encryptedinformationisstoredinthedatafieldintheformatshownbelow:

STX SEQ/SLAVEID LENGTH DATA CRCL CRCH

DATA

STEX EncryptedData

EncryptedData

eLENGTH eCOUNT eDATA ePACKING eCRCL eCRCH



STEX Singlebyteindicatingthestartofanencrypteddatablock0x7E

eLENGTH

ThelengthofthedataincludedinthepacketthisdoesnotincludeSTEX,COUNT,

the

packingortheCRC

eCOUNT

Afourbyteunsignedinteger.Thisisasequencecountofencryptedpackets,itis

incrementedeachtimeapacketisencryptedandsent,andeachtimeanencrypted

packet

isreceivedanddecrypted.

eDATA Commandsordatatobetransferred

ePACKING

Randomdatatomakethelengthofthelength+count+data+packing+CRCL+

CRCH

tobeamultipleof16bytes

eCRCL/eCRCH

LowandhighbyteofaforwardCRC16algorithmusingthepolynomial(X16+X15

+X2

+1)calculatedonallbytesexceptSTEX.Itisinitialisedusingtheseed0xFFFF



Afterpowerupandresettheslavewillstaydisabledandwillrespondtoallcommandswiththegeneric

responseKEY_NOT_SET(0xFA),withoutexecutingthecommand,untilthekeyhasbeennegotiated.There

aretwoclassesofcommandandresponse,generalcommandsandcommandsinvolvedincredittransfer.

Generalcommandsmaybesentwithorwithoutusingtheencryptionlayer.Theslavewillreplyusingthe

samemethod,unlesstheresponsecontainscreditinformation,inthiscasethereplywillalwaysbeencrypted.

Credit

transfercommands,ahopperpayoutforexample,willonlybeacceptedbytheslaveifreceivedencrypted.

Commandsthatmustbeencryptedonanencryptionenabledproductareindicatedonthecommand

descriptionsforeachcommand.TheSTEXbyteisusedtodeterminethepackettype.Ideallyall

communicationswillbeencrypted.

AfterthedatahasbeendecryptedtheCRCalgorithmisperformedonallbytesincludingtheCRC.Theresult

ofthiscalculationwillbezeroifthedatahasbeendecryptedwiththecorrectkey.Iftheresultofthis

calculationisnonzerothentheperipheralshouldassumethatthehostdidnotencryptthedata(transmission

errorsaredetectedbythetransportlayer).Theslaveshouldgooutofserviceuntilitis

reset.

Thepacketsaresequencedusingthesequencecount;thisisresetto0afterapowercycleandeachtimethe

encryptionkeysaresuccessfullynegotiated.Thecountisincrementedbythehostandslaveeachtimethey

successfullyencryptandtransmita

packet.AfterapacketissuccessfullydecryptedtheCOUNTinthepacketshouldbecomparedwiththe

internalCOUNT,iftheydonotmatchthenthepacketisdiscarded.



EncryptionKeys

SSPProtocolManualGA138_2_2_223A

<<backtoindex

Theencryptionkeylengthis128bits.Howeverthisisdividedintotwoparts.Thelower64bitsarefixedand

specifiedbythemachinemanufacturer,thisallowsthemanufacturercontrolwhichdevicesareusedintheir

machines.

Thehigher64bitsaresecurelynegotiatedbytheslaveandhostatpowerup,thisensureseachmachineand

eachsessionareusingdifferentkeys.ThekeyisnegotiatedbytheDiffieHellmankeyexchangemethod.

See:en.wikipedia.org/wiki/DiffieHellman



Theexchangemethodissummarisedinthetablebelow.Ccodefortheexchangealgorithmisavailablefrom

ITL.



Step Host Slave

1 GenerateprimenumberGENERATOR 

2

UsecommandSetGeneratortosendto

slaveCheckGENERATORisprimeandstore

CheckGENERATORisprimeandstore

3 GenerateprimenumberMODULUS 

4

UsecommandSetModulustosendtoslave

CheckMODULUSisprimeandstore

5 GenerateRandomNumberHOST_RND 

6

CalculateHostInterKey:=GENERATOR

^HOST_RNDmodMODULUS



7

UsecommandRequestKeyExchangeto

sendtoslave.

GenerateRandomNumberSLAVE_RND

8 

CalculateSlaveInterKey:=GENERATOR^

SLAVE_RNDmodMODULUS

9 

SendtohostasreplytoRequestKey

Exchange

10

CalculateKey:=SlaveInterKey^

HOST_RNDmodMODULUS

CalculateKey:=HostInterKey^

SLAVE_RNDmod

MODULUS

Note:^representstothepowerof



GenericCommandsandResponses

SSPProtocolManualGA138_2_2_223A

<<backtoindex

AlldevicesmustrespondtoalistofsocalledGenericCommandsasshowinthetablebelow.

Command Code

Reset 0x01

HostProtocolVersion 0x06

GetSerialNumber 0x0C

Sync 0x11

Disable 0x09

Enable 0x0A

GetFirmwareVersion 0x20

GetDatasetVersion 0x21



AdevicewillrespondtoallcommandswiththefirstdatabyteasoneoftheGenericresponseslistbelow..

GenericResponse Code Description

OK 0xF0

Returnedwhenacommandfromthehostisunderstood

and

hasbeen,orisintheprocessof,beingexecuted.

COMMANDNOTKNOWN 0xF2

Returnedwhenaninvalidcommandisreceivedbya

peripheral.

WRONGNoPARAMETERS 0xF3

Acommandwasreceivedbyaperipheral,butan

incorrect

numberofparameterswerereceived.

PARAMETERS 0xF4

Oneoftheparameterssentwithacommandisoutof

range.

COMMANDCANNOTBE

PROCESSED

0xF5

Acommandsentcouldnotbeprocessedatthattime.

E.g.

sendingadispensecommandbeforethelastdispense

operationhascompleted.

SOFTWAREERROR 0xF6

Reportedforerrorsintheexecutionofsoftwaree.g.

Divide

byzero.Thismayalsobereportedifthereisaproblem

resultingfromafailedremotefirmwareupgrade,inthis

case

thefirmwareupgradeshouldberedone.

FAIL 0xF8 Commandfailure

KEYNOTSET 0xFA

Theslaveisinencryptedcommunicationmodebutthe

encryptionkeyshavenotbeennegotiated.



ProtocolVersions

SSPProtocolManualGA138_2_2_223A

<<backtoindex

AnSSPPollcommandreturnsalistofeventsanddatathathaveoccurredinthedevicesincethelastpoll.

Thehostmachinethenreadsthiseventlisttakingnoteofthedatalength(ifany)ofeachevent.

Onordertointroducenewevents,SSPusesasystemofProtocolVersionlevelstoidentifytheeventtypes

andsizesamachinecanexpecttoseeinreponsetoapoll.Ifthiswerenotdone,newunknowneventswith

unknowndatasizetoamachinenotsetupforthesewouldcausetheeventreadingtofail.

Ahostsystemshouldtakenoteoftheprotocolversionofthedeviceconnectedandensurethatitisnotset

forahigerversionthattheoneitisexpectingtouse.

Thehostcanalsocheckthatthedevicecanalsobesettothehigherprotocollevel,enusringthatexpected

eventswillbeseen.

Thelistedeventsinthismanualshowtheprotocolversionlevelofeachevent.

Aspartofthestartupprocedure,thehostshouldreadthecurrentprotocollevelofthedevice(usingtheset

uprequestcommand).



SMARTHopper

SSPProtocolManualGA138_2_2_223A

<<backtoindex

SMARTHopperisacoinpayoutdevicecapableofdiscriminatingandpayingoutmultidenominationsof

storedcoinsfromitsinternalstoragehopper.

Coinsaddedtothehoppercanbedesignatedtoberoutedtoanexternalcashboxondetectionorrecycledand

storedinthehopperunittobeavailableforarequestedpayout.

SMARTHopperalsosupportstheadditionofaconnectedcctalk™oreSSP™coinmechanismwhichwill

automaticallyadditsvalidatedcoinstotheSMARTHoppersystemlevels.

Notethatpayoutvaluesareintermsoftheofthepennyvalueofthatcurrency.Sofor5.00,thevaluesent

andreturnedbythehopperwouldbe500.AlltransactionswithaSMARThoppermustbeencryptedto

preventdispensecommandsbeingrecordedandreplayedbyanexternaldevice.

Addressing

TheSMARTHopperhasadefaultSSPAddressof16dec0x10hex.

Thesetuprequestreponsetableforcoinhoppertypes:

Protocolversion lessthan6 :

Data byteoffset

size

(bytes)

notes

Unittype 0 1 3=SMARTHopper

Firmware

version

1 4 ASCIIdataofdevicefirmwareversion(e.g.'0110'=1.10)

Countrycode 5 3 ASCIIcodeofthedevicedataset(e.g.'EUR')

Protocol

Version

8 1 Thecurrentprotocolversionsetforthisdevice

Numberof

coinvalues

9 1

Thenumberofcoindenominationsinthisdevicedataset.

[n]

Coinvalues 10 n*2

2byteeachvalueforthecoindenominations(e.g.0.05

coin=0x05,0x00)



Protocolversion greaterorequalto6:

Data byteoffset

size

(bytes)

notes

Unittype 0 1 3=SMARTHopper

Firmware

version

1 4 ASCIIdataofdevicefirmwareversion(e.g.'0110'=1.10)

Countrycode 5 3 ASCIIcodeofthedevicedataset(e.g.'EUR')

Protocol

Version

8 1 Thecurrentprotocolversionsetforthisdevice

Numberof

coinvalues

9 1 Thenumberofcoindenominationsinthisdevicedataset.[n]

Coinvalues 10 n*2

2byteeachvalueforthecoindenominations(e.g.0.05coin

=0x05,0x00)

Countrycodes 10+(n*2) 

Anobsoletevalueshowingsecuritylevel.Thisissetto2if

thevaluemultiplieris>0otherwise0.

SmartSystem

SSPProtocolManualGA138_2_2_223A

<<backtoindex

TheSmartSystemdeviceisamulticoinpayin,payoutsystemwithdetachablefastcoinpayinfeeder.

Coinsfedintothepayinheadwillbevalidatedandcountedandrecognisedcoinsareroutedtotheattached

hopperwhilerejectedcoinsarefedoutofthefrontofthesystem.

Coinhopperlevelsareadjustedinternally.

Thesystemcanfunctionasastandalonehopperpayoutsystemifthepayinfeederheadisremoved.

TheSMARTSystemhasadefaultSSPAddressof16dec0x10hex

Thesetuprequestreponsetableforcoinhoppertypes:

Protocolversion lessthan6 :

Data byteoffset

size

(bytes)

notes

Unittype 0 1 3=SMARTHopper

Firmware

version

1 4 ASCIIdataofdevicefirmwareversion(e.g.'0110'=1.10)

Countrycode 5 3 ASCIIcodeofthedevicedataset(e.g.'EUR')

Protocol

Version

8 1 Thecurrentprotocolversionsetforthisdevice

Numberof

coinvalues

9 1

Thenumberofcoindenominationsinthisdevicedataset.

[n]

Coinvalues 10 n*2

2byteeachvalueforthecoindenominations(e.g.0.05

coin=0x05,0x00)



Protocolversion greaterorequalto6:

Data byteoffset

size

(bytes)

notes

Unittype 0 1 3=SMARTHopper

Firmware

version

1 4 ASCIIdataofdevicefirmwareversion(e.g.'0110'=1.10)

Countrycode 5 3 ASCIIcodeofthedevicedataset(e.g.'EUR')

Protocol

Version

8 1 Thecurrentprotocolversionsetforthisdevice

Numberof

coinvalues

9 1 Thenumberofcoindenominationsinthisdevicedataset.[n]

Coinvalues 10 n*2

2byteeachvalueforthecoindenominations(e.g.0.05coin

=0x05,0x00)

Countrycodes 10+(n*2) 

Anobsoletevalueshowingsecuritylevel.Thisissetto2if

thevaluemultiplieris>0otherwise0.

SSPProtocolManualGA138_2_2_223A
<<backtoindex
SMARTHOPPERCommandTable
Headercode(hex) dec
Sync 0x11 17
Reset 0x01 1
HostProtocolVersion 0x06 6
Poll 0x07 7
GetSerialNumber 0x0C 12
Disable 0x09 9
Enable 0x0A 10
GetFirmwareVersion 0x20 32
GetDatasetVersion 0x21 33
SetupRequest 0x05 5
PollWithAck 0x56 86
EventAck 0x57 87
SetDenominationRoute 0x3B 59
GetDenominationRoute 0x3C 60
PayoutAmount 0x33 51
GetDenominationLevel 0x35 53
SetDenominationLevel 0x34 52
HaltPayout 0x38 56
FloatAmount 0x3D 61
GetMinPayout 0x3E 62
SetCoinMechInhibits 0x40 64
PayoutByDenomination 0x46 70
FloatByDenomination 0x44 68
EmptyAll 0x3F 63
SetOptions 0x50 80
GetOptions 0x51 81
CoinMechGlobalInhibit 0x49 73
SmartEmpty 0x52 82
CashboxPayoutOperationData 0x53 83
GetAllLevels 0x22 34
SetGenerator 0x4A 74
SetModulus 0x4B 75
RequestKeyExchange 0x4C 76
CoinMechOptions 0x5A 90
GetBuildRevision 0x4F 79
CommsPassThrough 0x37 55
SetBaudRate 0x4D 77
SspSetEncryptionKey 0x60 96
SspEncryptionResetToDefault 0x61 97
SetCashboxPayoutLimit 0x4E 78

SSPProtocolManualGA138_2_2_223A
SMARTHOPPEREventTable
Headercode(hex) dec
SlaveReset 0xF1 241
Disabled 0xE8 232
FraudAttempt 0xE6 230
Initialising 0xB6 182
Dispensing 0xDA 218
CoinsLow 0xD3 211
HopperJammed 0xD5 213
Halted 0xD6 214
Floating 0xD7 215
Floated 0xD8 216
Timeout 0xD9 217
IncompletePayout 0xDC 220
IncompleteFloat 0xDD 221
CashboxPaid 0xDE 222
CoinCredit 0xDF 223
CoinMechJammed 0xC4 196
CoinMechReturnActive 0xC5 197
Emptying 0xC2 194
Emptied 0xC3 195
SmartEmptying 0xB3 179
SmartEmptied 0xB4 180
CalibrationFailed 0x83 131
CoinMechError 0xB7 183
AttachedCoinMechDisabled 0xBD 189
AttachedCoinMechEnabled 0xBE 190

SSPProtocolManualGA138_2_2_223A
<<backtoindex
SMARTSYSTEMCommandTable
Headercode(hex) dec
Sync 0x11 17
Reset 0x01 1
HostProtocolVersion 0x06 6
Poll 0x07 7
GetSerialNumber 0x0C 12
Disable 0x09 9
Enable 0x0A 10
GetFirmwareVersion 0x20 32
GetDatasetVersion 0x21 33
SetInhibits 0x02 2
SetupRequest 0x05 5
PollWithAck 0x56 86
EventAck 0x57 87
SetDenominationRoute 0x3B 59
GetDenominationRoute 0x3C 60
PayoutAmount 0x33 51
GetDenominationLevel 0x35 53
SetDenominationLevel 0x34 52
HaltPayout 0x38 56
FloatAmount 0x3D 61
GetMinPayout 0x3E 62
SetCoinMechInhibits 0x40 64
PayoutByDenomination 0x46 70
FloatByDenomination 0x44 68
EmptyAll 0x3F 63
SetOptions 0x50 80
GetOptions 0x51 81
CoinMechGlobalInhibit 0x49 73
SmartEmpty 0x52 82
CashboxPayoutOperationData 0x53 83
GetAllLevels 0x22 34
GetCounters 0x58 88
ResetCounters 0x59 89
SetGenerator 0x4A 74
SetModulus 0x4B 75
RequestKeyExchange 0x4C 76
CoinMechOptions 0x5A 90
GetBuildRevision 0x4F 79
CommsPassThrough 0x37 55
SetBaudRate 0x4D 77
SspSetEncryptionKey 0x60 96
SspEncryptionResetToDefault 0x61 97
GetRealTimeClockConfiguration 0x62 98
SetRealTimeClock 0x64 100
GetRealTimeClock 0x63 99
SetCashboxPayoutLimit 0x4E 78
CoinStir 0x5D 93
PayoutAmountByDenomination 0x39 57

SSPProtocolManualGA138_2_2_223A
SMARTSYSTEMEventTable
Headercode(hex) dec
SlaveReset 0xF1 241
Disabled 0xE8 232
FraudAttempt 0xE6 230
Initialising 0xB6 182
Dispensing 0xDA 218
Dispensed 0xD2 210
HopperJammed 0xD5 213
Halted 0xD6 214
Floating 0xD7 215
Floated 0xD8 216
Timeout 0xD9 217
IncompletePayout 0xDC 220
IncompleteFloat 0xDD 221
CashboxPaid 0xDE 222
CoinMechJammed 0xC4 196
CoinMechReturnActive 0xC5 197
Emptying 0xC2 194
Emptied 0xC3 195
SmartEmptying 0xB3 179
SmartEmptied 0xB4 180
CalibrationFailed 0x83 131
DeviceFull 0xCF 207
CoinMechError 0xB7 183
AttachedCoinMechDisabled 0xBD 189
AttachedCoinMechEnabled 0xBE 190
ValueAdded 0xBF 191
PayinActive 0xC1 193

Setseqbitto1

SSPProtocolManualGA138_2_2_223A

<<backtoindex

Command Codehex Codedecimal

Sync 0x11 17

Implementedon EncryptionRequired

SMARTHOPPER,SMARTSYSTEM optional

Description

SSPusesasystemofsequencebitstoensurethatpacketshavebeenreceivedbytheslave

andthereplyreceivedbythehost.Iftheslavereceivesthesamesequencebitasthe

previouscommandpacketthenthisissignaltoretransmitthelastreply.

Amechanismisrequiredtoinitiallysetthehostandslavetothesamesequencebitsand

thisisdonebytheuseoftheSYNCcommand.

ASynccommandresetstheseqbitofthepacketsothattheslavedeviceexpectsthenext

seqbittobe0.Thehostthensetsitsnextseqbitto0andtheseqsequenceis

synchronised.

TheSYNCcommandshouldbethefirstcommandsenttotheslaveduringasession.

Packetexamples

Hosttransmit: 7 F 8 0 01 11 65 82

SlaveReply: 7 F 8 0 01 F0 23 80

Nodataparameters,sequencebitsetandaddress0

SSPProtocolManualGA138_2_2_223A

<<backtoindex

Command Codehex Codedecimal

Reset 0x01 1

Implementedon EncryptionRequired

SMARTHOPPER,SMARTSYSTEM optional

Description

Performsasoftwareandhardwareresetofthedevice.

AfterthiscommandhasbeenacknowledgedwithOK(0xF0),anyencryption,baudrate

changes,etcwillberesettodefaultsettings.

Packetexamples

Hosttransmit: 7 F 8 0 01 01 06 02

SlaveReply: 7 F 8 0 01 F0 23 80

Theslavesupportstheprotocolversion8

Hostprotocolversion9notsupported

SSPProtocolManualGA138_2_2_223A

<<backtoindex

Command Codehex Codedecimal

HostProtocolVersion 0x06 6

Implementedon EncryptionRequired

SMARTHOPPER,SMARTSYSTEM optional

Description

ITLSSPdevicesuseasystemofprotocollevelstocontroltheeventresponsestopollsto

ensurethatchangeswouldnotaffectsystemswithfinitestatemachinesunabletotestfor

neweventswithnondefineddatalengths.

Usethiscommandtoallowthehosttosetwhichprotocolversiontooperatetheslave

device.

IfthedevicesupportstherequestedprotocolOK(0xF0)willbereturned.IfnotthenFAIL

(0xF8)willbereturned



Packetexamples

Hosttransmit: 7 F 8 0 02 06 08 03 94

SlaveReply: 7 F 8 0 01 F0 23 80

Hosttransmit: 7 F 8 0 02 06 09 06 14

SlaveReply: 7 F 8 0 01 F8 10 00

Page is loading ...

innovative technology SMART Coin System, Twin SMART Coin System User manual

Related papers

Other documents