Marshall Java SDK Release Notes

Track Marshall Java SDK changes as they ship.

Nayax logs Marshall Java SDK changes on this page as they ship. Subscribe to the RSS feed using the icon at the top of the page to get notified of new entries.

Some features shipped in the 0.1.6.x patch line require VPOS version 4.0.8.23-RC3 or newer. Check the table below for the patch that introduced the feature you’re using.

​

Java 0.1.6.23 (Current)

Every Java SDK patch is listed below, from the current version down to the first release.

Version	Summary
0.1.6.23 (Current)	Fixed the missed-ack issue.
0.1.6.22	Fixed a link-down issue where a missed ack stopped keepalive
0.1.6.21	Improved link reliability Fixed false retransmissions
0.1.6.20	Fixed a race condition between the rx and tx threads on m_pending_tx_msg access
0.1.6.19	Added: The pre_auth_amount_config (0x8c) vend sub-command, including the message class, decode/encode support, a factory method, and event handling in the public API A demo application menu option to test pre-authorization amount configuration
0.1.6.18	Fixed the session_end timeout expiring too soon, which caused reader_always_on to fire too early
0.1.6.17	Fixed: msg_remote_selection_t encode was an empty stub; now encodes all fields (funds available, payment media ID, payment type, payment data, item number, item options) msg_setup_max_min_prices_t encode was missing its sub-command byte and had a currency-code encoding typo msg_expansion_t now null-checks the body before decode/encode, preventing a crash on the FTL-retry-deny case msg_mdb_rsp_t decode now correctly instantiates msg_ftl_retry_deny_t
0.1.6.16	Added an external reader command Fixed the reader state command to also work in always-idle mode
0.1.6.15	Added a sanity check to vend_request and close_session: both now return a boolean value, and reject a price exceeding the permitted amount (65k when long_price is disabled)
0.1.6.14	Added real-time price-change support for always-idle mode, even after the reader is already enabled Updated the multi-vend request log
0.1.6.13	Fixed vend_multi_close_session encoding
0.1.6.12	Added protection against vend, socket, and general actions being issued when there is no link, preventing unnecessary crashes Optimized eth_port logging
0.1.6.11	Fixed incorrect session ID encoding in multi-vend multi-session close
0.1.6.10	Added file-system management support, now that VPOS provides those services Fixed a bug where card info from a previous session was not cleared once a session completed Improved vmc_link buffer management, fixing a possible retransmission and frame loss from buffer overflow
0.1.6.09	Added support for extended display control The SDK version string now also reports the SDK language
0.1.6.08	Fixed frame-size detection to support varying Marshall message sizes Added a flush() call to the port interface
0.1.6.07	Added site ID and brand name transfer to the machine via transfer data Added a technician-mode command to open the door remotely Updated the logger
0.1.6.06	Fixed: fw_info string copy, which could append garbage to the end of strings A msg_alert string decode error
0.1.6.05	Machine sub type can now be set explicitly instead of being hard-coded Fixed an encoding bug affecting multi-session multi-vend frames Updated the entry_type enum
0.1.6.04	Added long_price support, a 4-byte price capability relevant for VPOS Media, and fixed the display of negative prices Added support for the QR-code card type and third-party authorization for QR-code readers Fixed the Marshall max message length, relevant for VPOS Media vend_session_data_t now exposes all nullable fields, so the caller can tell whether a value was assigned Added a brands-selection bit for the Japanese market Multi-session now works together with multi-vend in the same session Added a final_price field to onSessionInfo Added a link-ready check to all vend APIs to prevent crashes when called with no link The version string now appends “rc” for unofficial builds
0.1.6.03	Removed a false warning on vmc_vend_t when no callback handler was registered, replacing it with a null check shared between marshall_sdk and marshall_master_sdk
0.1.6.02	Fixed: The VPOS serial number is now provided as a correctly arranged string instead of raw bytes A typo in marshall_func_code_transfer_data
0.1.6.01	The SDK no longer bundles lowlevel_serial.java directly; you now inject a serial_port_i implementation (a certified FTDI and PC-port implementation is provided) The display control API signature now takes a layout_t instance directly
0.1.5.27	Fixed a re-transmission bug where two packets arriving at once could be lost, plus fixes in mdb_rsp parsing and lowlevel_serial buffer management
0.1.5.26	Added session_id to vend_session_t for multi-session reference, more logging, fixed a msg_display_event_t parsing error that skipped the user callback
0.1.5.25	Fixed card_balance decoding, transfer_data parsing crashes, and final_price parsing; added logs to decoded transfer_data fields
0.1.5.24	Fixed a stall/deadlock while waiting for end_session, added transfer data messages throughout the transaction, added SDK configuration logging
0.1.5.23	Fixed an undefined state machine state when on_begin_session arrived without a session actually starting
0.1.5.22	Logs a possible exception in case it occurs
0.1.5.20-21	Fixed a possible crash when losing communication while sending reader_enable; cleaned up logs
0.1.5.19	Fixed a race condition between rx/tx threads causing retransmission of an already-acked packet; improved log readability
0.1.5.18	Fixed e-receipt on multi-session setups; can now switch to info session on always-idle setups
0.1.5.17	Added check-balance session type, card sub type and card balance transfer_data, and vend discount/final price calculation
0.1.5.16	Fixed item price/code API type (integer to short); fixed a crash when cancelling a session after card presented but before vend requested
0.1.5.15	Fixed session cancel on always-idle mode and unfilled transaction_id_len; session_status is now filled by the SDK; optimized low_level_serial CPU usage
0.1.5.14	Dumps packets on rx re-arrangement for debugging; improved lowlevel_serial handling under stress
0.1.5.13	Added vend_status(bool) for explicit vend success, fixed a vend-cancel timing bug, added total charged/discount on the session, absolute POSIX timestamps in logs, and an aux logging callback
0.1.5.12	onStatus gained an extra data parameter, added device_not_available_reason enums, fixed faulty transfer_data parsing, improved sample app status reporting
0.1.5.11	Added Log.console(boolean), new transfer_data fields (firmware versions), new device status enums, and the onSessionTimeout(id) event
0.1.5.10	Fixed vend-deny persist mode staying on after successful transactions; added unit_of_measure enum values and new device status enums
0.1.5.9	Fixed fw_info field arrangement and a vend session status request bug; improved low_level_serial link reliability; added remote vend support
0.1.5.8	Fixed vmc_socket busy/retransmit timeout handling
0.1.5.7	Fixed a race condition on user cancel right after a card swipe, a lowlevel_serial hang on faulty packet length, and a vmc_socket busy-modem retransmit bug
0.1.5.6	Removed the EV extension, fixed minor API bugs and a CPU starvation detection print bug
0.1.5.5	Aligned with Marshall 3.0: session status query, reader state API, entry type enum, QR e-receipt, and a device Marshall-version query
0.1.5.4	Fixed a UI API bug, improved CPU profiling, added VMC info fields to fw_info, limited multi-vend products to avoid buffer overflow
0.1.5.3	Added VMC info fields to fw_info, limited multi-vend products to avoid buffer overflow
0.1.5.2	Added CPU monitoring for starvation debugging; logs the packet byte stream on CRC error
0.1.5.1	Fixed a UI event callback API bug
0.1.5.0	Added the onStatus vend callback and updated close-session status messages
0.1.4.8	Updated to the latest Marshall spec, adding product code and product price TLV fields
0.1.4.7	Enabled multi-instance SDK use, connecting several VPOSes to a single VMC machine
0.1.4.6	Special encoding handling for Mifare card UIDs
0.1.4.5	Improved MSR handling for cards encoded as integer or ASCII string
0.1.4.4	Updated the EV extension; onReady() now returns the ended session; renamed requestTime/setDisplayText; added display control to vmc_general
0.1.4.2	Updated the sample application’s paymarket demo
0.1.4.1	Added log redirection to a file stream; fixed an invalid date from get_transaction_id() in onTransactionInfo
0.1.4.0	Added a serial packet dump-level parameter and a vend-denied policy parameter
0.1.3.5	Updated to the latest Marshall protocol; link establishment now reports merchant ID, terminal ID, and machine location; sample app got multi-session/multi-vend demos
0.1.3.4	Fixed an always-idle bug requiring the reader to stay enabled
0.1.3.3	Fixed a crash on the alert API; fixed reader_always_on to apply only when always-idle is explicitly disabled
0.1.3.2	Added a debug flag to silence log output and always-idle sample code
0.1.3.1	Updated libjserial in the demo application
0.1.3.0	Reorganized sample code and added documentation to the folder
0.1.2.9	Fixed the always-on feature, which had been removed by mistake
0.1.2.8	Minor cleanup; added the paymarket machine type; changed the EV-charger machine type
0.1.2.7	Added socket MTU/timeout configuration, Marshall protocol 2.0 support, always-idle MDB mode, a comm-timeout fix, and a fund-available conversion fix
0.1.2.6	Added an SDK version method, a TCP socket sample, machine type configuration, and improved logging
0.1.2.5	Improved socket handling, removed a false mismatch warning, added a lowlevel reset on CRC error for reliability
0.1.2.4	Fixed a link bug transmitting from an empty queue; SDK now ships as a .JAR with a demo application
0.1.2.3	Updated the pay API
0.1.2.2	Added transfer_data structure parsing on vend sessions for readable data; updated the sample application
0.1.2.1	Improved logging, added a multi-vend example, added the multi_vend_support flag, fixed an onReady API bug
0.1.2.0	Unified the multi-vend API into a single vend_request for both single and multi-vend cases
0.1.1.6	Handles async socket-close and session-close requests from VPOS; fixed cancel/close timing bugs
0.1.1.5	Reports quantity to DCS (requires VPOS 4.0.1.5 rc9+); added a transaction ID report API
0.1.1.4	Aligned close session to the new format
0.1.1.3	Fixed model/version reporting to DCS; separated the keep-alive timer from the configured timeout
0.1.1.2	Added link statistics, fixed a tight-timing retransmission issue and a buffer-index parsing bug
0.1.1.1	Fixed issues in the low-level serial template file
0.1.1.0	Fixed a re-transmit index bug
0.1.0.9	Handles piggy-back Marshall messages
0.1.0.8	Improved lowlevel_serial and response time during heavy socket work
0.1.0.7	Added multi-vend support, a prepaid pay API, and CC last-4-digits transfer data
0.1.0.6	Fixed a rare high-load bug causing out-of-order Marshall messages
0.1.0.5	Added the reader_always_on configuration parameter
0.1.0.4	Added a cash sale notification API and link event callbacks; fixed an incorrect session status bug
0.1.0.3	Added socket callbacks for session control and display message/alert/time-request messages
0.1.0.2	Moved lowlevel_serial outside the SDK as an application-specific concern; added configuration reporting to the vending client
0.1.0.1	Fixed an FTP socket closing issue; added VPOS configuration notification for the client