AUTOMATROM PICOBRIDGE RS232 Manual

Executive ↔ mdb bridge mode
Table of Contents

Advertisement

Quick Links

PICOBRIDGE RS232
(Executive ↔ MDB bridge mode)
v06.05.2018
© - 2018 – AUTOMATROM SRL –
www.automatrom.ro
Page 1/26

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the PICOBRIDGE RS232 and is the answer not in the manual?

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