Sign In
Upload
Download
Table of Contents
Contents
Add to my manuals
Delete from my manuals
Share
URL of this page:
HTML Link:
Bookmark this page
Add
Manual will be automatically added to "My Manuals"
Print this page
×
Bookmark added
×
Added to my manuals
Manuals
Brands
AUTOMATROM Manuals
Vending machines
PICOBRIDGE RS232
Manual
AUTOMATROM PICOBRIDGE RS232 Manual
Executive ↔ mdb bridge mode
Hide thumbs
1
Table Of Contents
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
page
of
26
Go
/
26
Contents
Table of Contents
Bookmarks
Table of Contents
Table of Contents
Device Overview
Hardware Overview
Connectors Description
Power Supply Requirements
Device Memory Map
Low Level Communication Protocol
Serial Port Settings
Low Level Protocol Messages
Write to Memory
Read from Memory
Device Reset
Get Device Status
Send some Credit to the Machine
Return Change to the Customer
Request Current Credit
Product Selected - Unsolicited Message
Transaction Result - Unsolicited Message
Bill Accepted by the Vending Machine - Unsolicited Message
Coin Accepted by the Vending Machine - Unsolicited Message
Cashless in Session - Unsolicited Message
Cashless Finished Session - Unsolicited Message
Change Requested - Unsolicited Message
High Level Protocol
Overview
Protocol Description
Write to Memory - METWRITEMEM
Read from Memory - METREADMEM
Send Credit to the Machine - METSENDCREDIT(Value)
Return Change from the Machine - METSENDCHANGE(Value)
Get Device Status - METGETSTATUS
Device Reset - METRESET
Read Product Price - METREADPRICE(N)
Write Product Price - METWRITEPRICE(N,Value)
Read Maximum Credit Setting - METREADMAXCREDIT
Write Maximum Credit Setting - METWRITEMAXCREDIT(Value)
Read Maximum Change Setting - METREADMAXCHANGE
Write Maximum Change Setting - METWRITEMAXCHANGE(Value)
Read Scaling Factor - METREADSCALINGFACTOR
Write Scaling Factor - METWRITESCALINGFACTOR(Value)
Read Decimal Point - METREADDECIMALPOINT
Write Decimal Point - METWRITEDECIMALPOINT(Value)
Read Coins Counter - METREADCOINSCOUNTER
Write Coins Counter - METWRITECOINSCOUNTER(Value)
Read Bills Counter - METREADBILLSCOUNTER
Write Bills Counter - METWRITEBILLSCOUNTER(Value)
Read Change Counter - METREADCHANGECOUNTER
Write Change Counter - METWRITECHANGECOUNTER(Value)
Read Cashless Counter - METREADCASHLESSCOUNTER
Write Cashless Counter - METWRITECASHLESSCOUNTER(Value)
Read Product Counter - METREADPRODUCTCOUNTER(N)
Write Product Counter - METWRITEPRODUCTCOUNTER(N,Value)
Read Vending Settings - METREADVENDINGSETTINGS
Write Vending Settings - METWRITEVENDINGSETTINGS(Value)
Read Current Credit - METREADCURRENTCREDIT
Setting RTC
Reading RTC
Unsolicited Messages
Vend Request
Vend Result
Bill Accepted
Coin Accepted
Change Requested
Cashless Finish Session
Cashless Start Session
Button Pressed
Notes
Advertisement
Quick Links
Download this manual
PICOBRIDGE RS232
(Executive ↔ MDB bridge mode)
v06.05.2018
© - 2018 – AUTOMATROM SRL –
www.automatrom.ro
Page 1/26
Table of
Contents
Previous
Page
Next
Page
1
2
3
4
5
Advertisement
Table of Contents
Need help?
Do you have a question about the PICOBRIDGE RS232 and is the answer not in the manual?
Ask a question
Questions and answers
Summary of Contents for AUTOMATROM PICOBRIDGE RS232
Page 1
PICOBRIDGE RS232 (Executive ↔ MDB bridge mode) v06.05.2018 © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 1/26...
Page 2: Table Of Contents
19. Read bills counter - METREADBILLSCOUNTER..........19 20. Write bills counter – METWRITEBILLSCOUNTER(value)........19 21. Read change counter - METREADCHANGECOUNTER........20 22. Write change counter – METWRITECHANGECOUNTER(value)......20 23. Read cashless counter - METREADCASHLESSCOUNTER........20 © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 2/26...
Page 3
C. Unsolicited messages....................23 1. Vend request......................23 2. Vend result.......................23 3. Bill accepted......................23 4. Coin accepted......................24 5. Change requested....................25 6. Cashless finish session...................25 7. Cashless start session.....................25 8. Button pressed......................25 Notes:...........................26 © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 3/26...
Page 4: Device Overview
(vend success, vend failed); • reading informations about the cash inserted and about the change returned to the; • reading informations about the VMC status; • resetting the device. • © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 4/26...
Page 5: Hardware Overview
J4 – RS232 DB9 female connector. You need a straight cable or you can connect • an USB to RS232 cable. Please make sure your USB to RS232 cable/converter can correctly handle hardware flow (RTS/CTS). Best results were obtained using FTDI © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 5/26...
Page 6: Power Supply Requirements
The PICOBRIDGE can be powered with 24V AC/DC or 12V AC/DC, depending on your MDB PERIPHERALS. NOTE: If you apply 24AC, please make sure that your MDB peripherals can support 34VDC input. Otherwise, use a DC power supply. © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 6/26...
Page 7: Device Memory Map
Bill counter (accumulated bill accepted value) 827 → 830 Coins counter (accumulated coins accepted value) 831 → 1023 Products counters (2 bytes for each product, from selection 1 to 96) © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 7/26...
Page 8: Low Level Communication Protocol
As a convention for the protocol description tables, B0, B1, … Bn represents “byte number” and b0, b1, … bn represents “bit number”. Also, we will refer to this interface as “device” or as “bridge” © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 8/26...
Page 9: Write To Memory
0. <HEADER> <CMD> <PARAMETERS> <CRC> (B0) (B1) (B2 to Bn) (Bn + 1) 0xFA 0x03 No parameters 0xF9 Device response ACK or NACK, according to the command execution result © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 9/26...
Page 10: Get Device Status
- B76 – B87 – device serial number (ASCII representation of HEX serial number) Most of the above values may be modified by using writemem command at the right address (see memory map table) © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 10/26...
Page 11: Send Some Credit To The Machine
- B6 → B9 – The value (not scaled) of the current cashless credit on the machine (if an MDB cashless device is connected and the cashless media is inserted). © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 11/26...
Page 12: Product Selected - Unsolicited Message
- B2 – B5 – the value (not scaled) of the credit available on cashless media For example, for EUR1.00 the values will be: - B2 = 0x00 - B3 = 0x00 - B4 = 0x00 - B5 = 0x64 © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 12/26...
Page 13: Cashless Finished Session - Unsolicited Message
- if the change operation is inhibited in the interface settings Pressing changer escrow lever while the current credit is 0 will be ignored. No message sent in this situation. © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 13/26...
Page 14: High Level Protocol
First parameter of this function is the address to start reading, the second parameter is the length (in bytes) to read Device response "{DeviceMessage": "ReadMemory", "StartAddress": 0, "DataLegth": 10, "MemoryData": [0,0,0,100,0,0,0,150,0,0]} © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 14/26...
Page 15: Send Credit To The Machine - Metsendcredit(Value)
This device has no temperature sensor, it will always return 0.00 – kept for protocol compatibility 6. Device reset - METRESET This command will reset the device Command METRESET Device response {"DeviceResponse": "Acknowledge","MessageID": 101} {"Error": "Syntax Error","ErrorCode": 1001} {"Error": "Unknown command","ErrorCode": 1002} © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 15/26...
Page 16: Read Product Price - Metreadprice(N)
For example set max credit to EUR 5:.00 value is loaded only once, at start-up METWRITEMAXCREDIT(500) Device response {"DeviceResponse": "Acknowledge","MessageID": 101} {"Error": "Syntax Error","ErrorCode": 1001} {"Error": "Unknown command","ErrorCode": 1002} © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 16/26...
Page 17: Read Maximum Change Setting - Metreadmaxchange
Command Description METREADSCALINGFACTOR - Reads the SCALING FACTOR settings credit and price display. Below is the an example answer to the METREADSCALINGFACTOR command (where scaling factor is Device response {"DeviceResponse":"ReadScalingFactor","ScalingFactorValue":"10"} © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 17/26...
Page 18: Write Scaling Factor - Metwritescalingfactor(Value)
- Writes the DECIMAL POINT. For example set decimal point to 2: Requires METRESET after issuing this command, since the METWRITESCALINGFACTOR(2) value is loaded only once, at start-up Device response {"DeviceResponse": "Acknowledge","MessageID": 101} {"Error": "Syntax Error","ErrorCode": 1001} {"Error": "Unknown command","ErrorCode": 1002} © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 18/26...
Page 19: Read Coins Counter - Metreadcoinscounter
Command Description METWRITEBILLSCOUNTER(value) - Writes the bills counter. For example resetting the counter on cash-collect: METWRITEBILLSCOUNTER(0) Device response {"DeviceResponse": "Acknowledge","MessageID": 101} {"Error": "Syntax Error","ErrorCode": 1001} {"Error": "Unknown command","ErrorCode": 1002} © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 19/26...
Page 20: Read Change Counter - Metreadchangecounter
Command Description METWRITECASHLESSCOUNTER(value) - Writes the cashlesscounter. For example resetting the counter on cash-collect: METWRITECASHLESSCOUNTER(0) Device response {"DeviceResponse": "Acknowledge","MessageID": 101} {"Error": "Syntax Error","ErrorCode": 1001} {"Error": "Unknown command","ErrorCode": 1002} © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 20/26...
Page 21: Read Product Counter - Metreadproductcounter(N)
Writes the vending settings in the device’s memory Requires METRESET after issuing this command, since the value is loaded only once, at start-up Device response {"DeviceResponse": "Acknowledge","MessageID": 101} {"Error": "Syntax Error","ErrorCode": 1001} {"Error": "Unknown command","ErrorCode": 1002} © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 21/26...
Page 22: Read Current Credit - Metreadcurrentcredit
- y = year - 00-99 - wd = week day – 1-7 (1 for Sunday, 2 for Monday, etc.) Device response {"DeviceResponse": "Acknowledge","MessageID": 101} {"Error": "Syntax Error","ErrorCode": 1001} {"Error": "Unknown command","ErrorCode": 1002} © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 22/26...
Page 23: Reading Rtc
This message is send by the device, every time a bill is inserted into the bill validator and stacked. Message {DeviceMessage": "BillAccepted","BillAcceptedValue": 500} Description “BillAcceptedValue” is the value of the last accepted bill (in this example, bill of EUR5.00). © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 23/26...
Page 24: Coin Accepted
This message is send by the device, every time a coin is inserted into the coin acceptor and sorted to a tube or to the cash-box. Message {DeviceMessage": "CoinAccepted","CoinAcceptedValue": 50} Description “CoinAcceptedValue” is the value of the last accepted coin (in this example, coin of EUR0.50). © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 24/26...
Page 25: Change Requested
This message is send by the device, every time a button is pressed. Message {"DeviceMessage": "ButtonPressed","ButtonNumber": 1} Description - “ButtonNumber” is the number of the pressed button (in this example, button #1) © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 25/26...
Page 26: Notes
Notes: © - 2018 – AUTOMATROM SRL – www.automatrom.ro Page 26/26...
Table of Contents
Print
Rename the bookmark
Delete bookmark?
Delete from my manuals?
Login
Sign In
OR
Sign in with Facebook
Sign in with Google
Upload manual
Upload from disk
Upload from URL
Need help?
Do you have a question about the PICOBRIDGE RS232 and is the answer not in the manual?
Questions and answers