Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Reads data as text from the Matrix-Dongle.

Component Version macOS Windows Linux Server iOS SDK
MatrixDongle 5.2 ✅ Yes ✅ Yes ❌ No ✅ Yes, on macOS and Windows ❌ No


This function was deprecated.

MBS( "MatrixDongle.ReadText"; UserCode; Pos; Count { ; Encoding; DongleNumber; PortNumber } )   More


Parameter Description Example Flags
UserCode This is your personal UserCode and must correspond with the internal UserCode from the dongle.
Pos The position to write at. This value is in 4 byte data words, so for 12 bytes offset pass 3. 0
Count Number of data words to read. 4 bytes per data word. 1
Encoding The text encoding for text parameter.
Default is UTF-8.
Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ.
UTF8 Optional
DongleNumber This is the dongle number when several dongles are plugged in one after the other. The maximum number of dongles available can be determined via the MatrixDongle.Count function.
A maximum of 99 dongles can be connected to the LPT port and a maximum of 127 dongles to the USB connection.
The plugin uses 1 if you don't pass this parameter.
1 Optional
PortNumber With LPT dongles, this is the number of the LPT port to which the dongles are connected. With LPT dongles, the port number must be between 1 and 3. Example: 1 for LPT1, 2 for LPT2 or 3 for LPT3.
With USB, this parameter must be 85.
This variable is ignored with network calls.
Default for MBS Plugin is 85 for USB.
85 Optional


Returns text or error.


Reads data as text from the Matrix-Dongle.
Starts reading at the given position and reads count number of data words.

See also

This function does not need a paid license.

Created 1st August 2015, last changed 31st July 2020

MatrixDongle.ReadSerialNumber - MatrixDongle.Release

💬 Ask a question or report a problem