Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5   8.0   8.1    Statistic  


Reads data as text from the Matrix-Dongle.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
MatrixDongle 5.2 Yes Yes Yes No Yes

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


Parameter Description Example value
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 Optional
The text encoding for text parameter.
Default is UTF-8.
Possible encoding names: ANSI, Arabic-Mac, Arabic-Win, Baltic-Win, CentralEurope-Mac, ChineseSimp-Mac, ChineseSimp-Win, ChineseTrad-Mac, ChineseTrad-Win, Cyrillic-Mac, Cyrillic-Win, EasternEurope-Win, Greek-Mac, Greek-Win, Hebrew-Mac, Hebrew-Win, ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-15, Korean-Johab, Korean-Mac, Korean-Win, Latin1, Mac, Native, ShiftJIS-Mac, ShiftJIS-Win, Turkish-Mac, Turkish-Win, UTF-8, DOS or Windows. Pass native to use the native encoding of the current platform.
DongleNumber Optional
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.
PortNumber Optional
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.


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

Example Databases

MatrixDongle.ReadSerialNumber   -   MatrixDongle.Release

Feedback: Report problem or ask question.

MBS FileMaker blog