Working in Service Mode

After a service card has been scanned successfully, the Vending Unit switches to Service Mode. This mode provides maintenance personnel with access to diagnostic tools, service functions, device status information, and operational statistics.

The Service Mode interface consists of several screens, each dedicated to a specific subsystem of the Vending Unit.

---

Dashboard

The Dashboard is the main entry point of the Service Mode.

It displays:

• Current system status
• MQTT broker connection status
• Installed services and their versions
• Language selection
• Statistical information
• Logout button for leaving Service Mode

The list of services provides a quick overview of all software components currently running on the Vending Unit.

---

Controller

The Controller screen displays the status of all internal services managed by the Vending Unit controller.

Available services typically include:

• Machine Service
• Card Terminal
• Kiosk Service
• Printer Service
• Scanner Service
• Cash Payment Service
• Card Dispenser Service

For each service, the following information is shown:

• Current status
• Error reason (if any)
• Software version
• Firmware version

This screen is useful for troubleshooting communication and software issues.

---

Machine Service

The Machine Service screen displays all machines connected to the Vending Unit.

For each machine the following information is available:

• Machine number
• Machine name
• Current status
• Assigned product
• Program currently running

Starting Programs

When a machine is idle, the service technician can manually start a program.

Select the desired machine.

Choose one of the available programs.

The selected program will immediately start on the machine.

Monitoring Active Programs

When a machine is running, the interface displays:

• Program name
• Remaining time
• Progress bar
• Stop button

The stop button can be used to terminate the program if required.

---

Printer Service

The Printer Service screen provides diagnostic and testing functions for the receipt printer.

Displayed information includes:

• Printer status
• MQTT connection status
• Device status
• Firmware version
• Printer model

Printer Status Indicators

The following indicators may be displayed:

• Paper End
• Paper Near End
• Document Presented
• Busy Printing

Test Print

The Test Print button sends a test receipt to the printer.

Advanced Mode

Advanced mode provides access to receipt source data.

Available formats include:

• PDF Base64
• Image Data URL
• Image Base64
• Plain XML

The receipt preview can be reviewed and printed directly from this screen.

---

Card Terminal Service

The Card Terminal Service screen is used to diagnose and test the card payment terminal.

Displayed information includes:

• Terminal status
• MQTT connection status
• Current payment transaction status
• Last receipt received from the terminal

Executive Tests

Executive Tests provide access to maintenance functions.

Available actions:

• Start Payment
• Cancel Payment
• Request Status
• Request Last Receipt
• Activate Service Mode
• Perform End of Day

These functions are intended for authorized service personnel only.

---

Scanner Service

The Scanner Service screen is used to test barcode and RFID scanner functionality.

Displayed information includes:

• Scanner status
• MQTT connection status
• Device status

Executive Tests

When Executive Tests are enabled, additional controls become available.

Available actions:

• Activate
• Deactivate

These controls allow testing scanner communication and hardware functionality.

---

Kiosk Service

The Kiosk Service screen is used to diagnose and test the kiosk application.

The screen displays:

• Kiosk status
• MQTT connection status
• Device status

Executive Tests

When Executive Tests are enabled, the service technician can change the kiosk URL.

This feature is primarily intended for testing and development environments.

---

Cash Payment Service

The Cash Payment Service screen displays information about all connected cash handling devices.

Supported devices may include:

• Coin Acceptors
• Smart Hoppers
• Coin Cashboxes
• Banknote Acceptors

For each device, the following information is displayed:

• Device name
• Current amount
• Allowed denominations
• Payout denominations
• Firmware version

Available actions:

• Enable Accepting Money
• Skimming

This screen is primarily used for diagnostics and cash management.

---

Card Dispenser Service

The Card Dispenser Service screen provides diagnostics and control functions for the RFID card dispenser.

Displayed information includes:

• Device status
• Card availability
• Retract bin status
• Container filling level
• Last card read

Status indicators may include:

• Out of Cards
• Cards Near End
• Card Presented
• Busy Processing
• Card Retracted
• Empty Retract Bin
• Retract Bin Near Full
• Retract Bin Full

Available actions:

• Dispense
• Activate Retraction
• Deactivate Retraction
• Eject
• Collect
• Clear Retract Bin

These functions allow maintenance personnel to test dispenser operation and resolve hardware issues.

---

Detergent Dispenser Calibration

The Detergent Dispenser can contain two dispensing lines (channels). Depending on the device type, these can be used for:

• one dry and one liquid detergent, or
• two liquid detergents.

In the backend, the Detergent Dispenser is assigned a program template. Each program defines how long the detergent is dispensed through the corresponding channel. A program can use either one channel or both channels.

The configurable parameter for each active channel is the dispensing time in seconds.

However, different detergents have different physical properties. The same operating time can therefore result in different quantities being dispensed. For example, the dispenser may need to supply 100 ml of a particular liquid detergent into the container placed in the Vending Unit by the customer.

For this reason, the dispensing time must be calibrated for the detergent actually used in the machine.

Opening the Calibration Interface

In Service Mode, select the Detergent Dispenser from the machine list.

Select the program that you want to calibrate.

The calibration interface opens for the selected program.

The header shows the selected dispenser and program, for example:

Calibration: Dispenser machine 13 — Program 1

For each channel used by the selected program, the interface provides:

• the channel number;
• the current dispensing time in seconds;
• − and + buttons for adjusting the dispensing time;
• Start and Stop buttons for measuring the dispensing time;
• Test for testing the configured value;
• Save for saving the calibrated value.

Measuring the Dispensing Time

To calibrate a channel:

1. Place a suitable measuring container under the corresponding detergent outlet in the Vending Unit.
2. Press Start.
3. The dispenser starts dispensing the detergent and the time counter between the − and + buttons starts counting the dispensing time in seconds.
4. Observe the amount of detergent collected in the measuring container.
5. When the required quantity has been reached, press Stop.
6. The time counter stops and displays the measured dispensing time.
7. Press Save.

The measured time is saved as the dispensing time for the selected program and channel.

Note

Calibration must be performed with the detergent that will actually be used in the dispenser. Different detergents may require different dispensing times to provide the same quantity.

Testing the Calibration

After saving the value, the calibration can be checked using Test.

1. Press Test for the channel to be checked.
2. Place the measuring container under the corresponding detergent outlet in the Vending Unit.
3. Start detergent dispensing on the Vending Unit.
4. Wait until the dispensing program has finished.
5. Check the amount of detergent in the measuring container.

If the dispensed quantity does not match the required quantity, adjust the dispensing time using the − or + button.

Each press changes the dispensing time by 0.1 seconds.

Repeat the test until the required amount of detergent is dispensed, then press Save to store the corrected value.

Programs Using Two Channels

A detergent program can be configured to use both dispensing channels.

If both channels are active for the selected program, the calibration interface displays separate settings for Channel 0 and Channel 1.

Each channel has its own dispensing time and can be measured, adjusted, tested, and saved separately.

This makes it possible to calibrate each detergent independently, even when two different detergents are dispensed during the same program.

---

Statistics

The Statistics screen provides access to operational and financial information collected by the Vending Unit.

Two sections are available:

• Orders
• Events

Orders

The Orders section displays completed sales transactions.

Available filters:

• Last 24 Hours
• Last 5 Days
• Last 7 Days
• Last 30 Days
• Custom Period

For each order the following information is available:

• Creation date
• Synchronization date
• Purchased products
• Total amount

Order Details

Selecting an order opens the order details window.

Displayed information includes:

• Order ID
• Location
• Creation date
• Order amount
• Purchased products
• Receipt preview

Receipt Preview

The receipt preview displays the exact receipt generated for the customer.

---

Events

The Events section provides access to machine and system events.

Available filters:

• Period
• Event Type

Typical event types include:

• Ready
• Program
• Door Open
• Service
• Barcode Read

Events are useful for troubleshooting, auditing, and analyzing machine activity.

Event Details

Selecting an event opens the Event Details window.

The event details screen provides complete information about the selected event.

The Event Information section includes:

• Event Name
• Event Code
• Source Device or Service
• Event Time
• Receive Time
• Event Status
• Human-readable Description