Gonector 2.1 Syntax

Supported Bluetooth devices:	Zebra CS4070 Zebra ZQ630 Zebra DS3678 qIDmini with Apple profile (R1170IEAPLP) produced by CAENRFID skID - R1280I Custom MyPrinter A Custom MY3 Alien ALR-S350 Ingenico Bluetooth devices connected via PCL driver tested with Link/2500 ČSOB version BlueSnap Smart (RS232 to Bluetooth adapter) Infinea mPos Flat DPP-255 Mobile Printer
Supported RS232 via BlueSnap Smart adapter (Bluetooth 4.0) devices:	Scales with RS232 interface configured via Gonector_Set with selectors "scaleReadCommand" and "scaleWeightPattern" Tested on: Traveler TA301 OHAUS scale LESAK J1-RWP scale
Supported directly connected devices:	Linea and Infinea product line from Infinite Peripherals Tested on: LINEA PRO 7 encrypted Infinea mPos BP500 Infinea X
Supported iOS devices for native RFID/NFC tag reading:	iPhone 7 and higher with iOS 11 and newer
Supported iOS devices for native NFC tag writing:	iPhone 7 and higher with iOS 13 and newer
Supported NFC cards:	ISO 14443A (Mifare Classic 1k, Mifare Ultralight) ISO 15693 cards

Supported OS for development and testing in desktop version of the plug-in:

Windows	Windows 7 and newer, FileMaker 16.0 and higher
macOS	macOS Sierra 10.12, FileMaker 16.0 and higher

Functions return either default testing values or "notImplemented". This has to be set with function Gonector_Set.
The plugin used for desktop integration does not require SNLib verification

Gonector_Register( selector )

Provides special functionality to operate with plugin serial numbers

Parameter values for selector

SerialNumber	Register given SerialNumber and return an error code
"Status"	Return the actual registration state of the plug-in: Demo, Demo expired, Trial, Trial Expired, Registered or Dead.
"Unregister"	Unregister all serial numbers related to the product and return an error code
EmailAddress	Tries to activate Plug-In with given email address and return an error code. Trial version is valid only after you confirm email.
"Info"	Returns current plugin status and its registered serial numbers.
"Activation"	Returns generated challenge string. A string to send to 24U.

Gonector_Connect( deviceName )

Connect to the device specified

Parameters

deviceName

To connect to native iPhone RFID/NFC Reader use "iPhone" as deviceName To connect to Linea or Infinea product line use "LineaInfinea" as deviceName To connect to Infinea mPos use "mPosInfinea" as deviceName To connect to Zebra scanners please check out device manual: CS4070 or DS3678 deviceName for connectable bluetooth devices can be received through the function Gonector_Get( "devices" ; deviceType)

Description

This function will try to find device with provided deviceName and connect to it.
In case of CustomPrinter, IngenicoTerminal, Infinea mPos Flat, Zebra ZQ630 via Bluetooth Classic and qIDmini device has to be paired via bluetooth.

Result

Function returns 0 if connected. In case of error the function will return "?". Use Gonector_Get( "lastError" ) to get the specific error code.

Examples

Gonector_Connect( "MYPrinterA_1" )
This command connects the plugin to the bluetooth device MYPrinterA_1.

Gonector_Connect( "MYS350Reader_1ALR350" )
This command connects the plugin to the bluetooth device MYS350Reader_1ALR350.

Gonector_Connect( "LineaInfinea" )
This command connects the plugin to the device of Linea or Infinea type.
If You have troubles connecting to the device please check the LineaInfinea troubleshooting guide

Gonector_Connect( "dppPrinter" )
This command connects the plugin to the DPP-255.

Gonector_Connect( "iPhone" )
This command connects the plugin to the iPhone.

Gonector_Disconnect( deviceName )

Disconnect from the device

Parameters

deviceName

Use the particular name to disconnect solely this device

Description

This function is used to disconnect from the device.

Result

Function returns 0. In case of error the function will return "?". Use Gonector_Get( "lastError" ) to get the specific error code.

Examples

Gonector_Disconnect( "MYPrinterA_1" )
This command disconnects the device MYPrinterA_1.

Gonector_Disconnect( "MYS350Reader_1ALR350" )
This command disconnects the device MYS350Reader_1ALR350.

Gonector_Disconnect( "LineaInfinea" )
This command disconnects the device of Linea or Infinea type.

Gonector_Disconnect( "dppPrinter" )
This command disconnects the device DPP-255.

Examples

Gonector_Get( "inlineDocumentation" )
This command returns "on" or "off".

Gonector_Get( "devices" ; "customPrinter" )
This command returns all customPrinter devices divided by "¶".

Gonector_Get( "fontAlignment" ; "MYPrinterA_1" )
This command returns "left" if the device MYPrinterA_1 has default alignment.

Gonector_Get( "fontAlignment" ; "dppPrinter" )
This command returns "left" if the device DPP-255 has default alignment.

Gonector_Get( "randomKey" ; "LineaInfinea" )
This command returns string such as "16465168765168416845198645316551".

Gonector_Get( "barcodeHri" ; "MYPrinterA_1" )
This command returns "bottom" if the device MYPrinterA_1 has HRI set to default.

Gonector_Get( "barcodeHri" ; "dppPrinter" )
This command returns "bottom" if the device DPP-255 has HRI set to default.

Gonector_Get( "devices" ; "ZebraPrinter" )
This command returns all ZebraPrinter devices divided by "¶".

	(Point size) x (Dots per inch of Printer)
Dots =  -----------------------------------------
			72

Gonector_PrintText( deviceName ; text { ; printMode { ; x ; y } } )

Sends a text to print

Parameters

deviceName	Unique name of the device
text	Text to print Note: Supported printers only print ASCII character set
printMode	This parameter is used to change different print modes
x	This parameter specifies x coordinate(horizontal) of printing starting point(upper-left corner of text area). Every tag has coordinate system that uses dots(pixels). Point (0, 0) is located at upper left corner of the tag. You can calculate maximum width(or height) as [dpi of printer] * [width(or height) of tag in inches]. Default: 0. Only Zebra ZQ630 supported
y	This parameter specifies y coordinate(vertical) of printing starting point(upper-left corner of text area). Default: 0. Only Zebra ZQ630 supported

Possible values for printMode.

"buffer"

This printMode can be used to print various fonts in one line. The printer will store the text in a buffer. Text is added to the buffer and currently set formatting is remembered along with it. If the text in the buffer contains line ending (¶) or if the text fulfils width of the printable line, it is automatically printed and the remaining part of the text will stay in the buffer. Combining multiple text alignments on one row is not possible. Overwriting of the line alignment for text in buffer is not possible. In case of Zebra ZQ630, this mode will allow to store in buffer raw commands, barcodes, texts and RFIDdata if we want to print them to one RFID tag.

"immediate"

This printMode will automatically add line ending at the end of provided text which means that buffer (first) and the text (second) will be printed immediately. If buffer and text is empty printer will print empty line. In case of Zebra ZQ630, this mode will flush everything in buffer and print it on RFID tag. This is default printMode.

Description

This function uses a printer to print text. Various font settings can be changed using Gonector_Set function

Result

Function returns 0 in case of success. In case of error the function will return "?". Use Gonector_Get( "lastError" ) to get the specific error code.

Examples

Gonector_PrintText( "MYPrinterA_1" ; "Hello!!!" )
This prints "Hello!!!" on the device MYPrinterA_1.

Gonector_PrintText( "dppPrinter" ; "Hello!!!" )
This prints "Hello!!!" on the device DPP-255.

Gonector_PrintText( "MYPrinterA_1" ; "Name: " ; "buffer" ) & ¶ & Gonector_Set( "fontUnderline" ; "MYPrinterA_1" ; "on" ) & ¶ & Gonector_PrintText( "MYPrinterA_1" ; "name@example.com" )
This prints "Name: name@example.com" on the device MYPrinterA_1.

Gonector_PrintText( "dppPrinter" ; "Name: " ; "buffer" ) & ¶ & Gonector_Set( "fontUnderline" ; "dppPrinter" ; "on" ) & ¶ & Gonector_PrintText( "dppPrinter" ; "name@example.com" )
This prints "Name: name@example.com" on the device DPP-255.

Gonector_PrintText( "ZebraPrinter" ; "Hello!!!" ; 150 ; 50 )
This prints "Hello!!!" on the device Zebra ZQ630. Upper-left corner of text field is located 150 dots horizontaly and 50 dots verticaly from upper-left corner of the tag.

Gonector_Read( deviceName { ; selector { ; options { ; extra/memBank { ; address ; length { ; tagID } } } } } )

Reads data from a device.

Parameters

Possible values for selector:

deviceName	Unique name of the device
selector	Used to specify the request
options	Additional selector for some requests. Check possible values for options to see supported devices.
extra	For Infinea mPos only, enter total amount (in cents e.g.: 5.00 has to be entered as 500)
memBank	Tag memory bank. For skID and ALR-S350 only.
address	From what address to read tag. For skID and ALR-S350 only.
lenght	How many bytes should be read. For skID and ALR-S350 only.
tagID	Defines tag from which memory will be read. If ommited, memory will be read from all available tags.

Selector	Supported device	Description
"single"	qIDmini/skID gIDScale iPhone LineaInfinea mPosInfinea ALR-S350 Zebra CS4070 Zebra DS3678	Read dialog will be shown for iPhone and Linea or Infinea device. This dialog closes after one item read. This is the default Note: Read dialog for iPhone will close after 60 seconds of inactivity and return all read cards
"multiple"	qIDmini/skID gIDiPhone LineaInfinea mPosInfinea ALR-S350 Zebra CS4070 Zebra DS3678	Read dialog will be shown for iPhone and Linea or Infinea device. This dialog closes when "Done" button is hit Note: Read dialog for iPhone will close after 60 seconds of inactivity and return all read cards
"unique"	qIDmini/skID gIDiPhone LineaInfinea mPosInfinea ALR-S350 Zebra CS4070 Zebra DS3678	Read dialog will be shown for iPhone and Linea or Infinea device. This dialog closes when "Done" button is hit. The plugin guarantees that no value will be returned twice Note: Read dialog for iPhone will close after 60 seconds of inactivity and return all read cards
"last"	qIDmini/skID gIDScale iPhone LineaInfinea (barcodes, RFID cards, magnetic stripes) mPosInfinea ALR-S350 Zebra CS4070 Zebra DS3678	Returns the last value received from the device Data from magnetic stripe is only kept for 10 seconds to match the PCI compliance

Some scales (such as tested LESAK J1-RWP) have to be manually configured to enable this function.

Possible values for options:

Options	Supported device	Description
"stripe"	LineaInfinea mPosInfinea	Reads a magnetic stripe. To successfully read the magnetic stripe, a stripe key must be set
"rfidCard"	LineaInfinea ALR-S350 skID qIDmini	Reads an RFID card
"barcode"	LineaInfinea mPosInfinea ALR-S350 Zebra CS4070 Zebra DS3678	Reads a barcode
"smartCard"	mPosInfinea	Reads a smart card. This option can be used only with selector "single".
"tagSpecific"	iPhone	Reads MiFare, FeliCa, ISO15693 or ISO7816 tags on iPhone.

Description

Plugin sends a request to one of the supported devices to respond with data.

Result

Function returns JSON string if everything is OK. In case of error the function will return "?". Use Gonector_Get( "lastError" ) to get the specific error code.
The JSON string contains an array of items read (cards, tags…). The items are wrapped in arrays which contain one or more objects. Each object represents one chunk of items data (e.g. in case of localised rfid cards one object would be for data in English and another object for data in German). Each object has at least “type” and “data” or “base64Data” properties.

skID and ALR-S350 also contain object RSSI (Received signal strength indicator):

• In case of skID the RSSI value is actuall RSSI (in dBm). Value closer to 0 indicates stronger signal
• In case of ALR-S350 RSSI value is in range 0 - 100 where 100 represents the strongest signal

Examples

Gonector_Read( "qIDmini R1170" ; "multiple" ; "rfidCard" )
This returns a JSON string such as [ { "type": "qIDminiTag", "data": "123456" }, { "type": "qIDminiTag", "data": "654321" } ] or "?" in case of an error.

Gonector_Read( "skID" ; "multiple" ; "rfidCard" ; 3 ; 0 ; 6 )
This returns a JSON string such as [ { "type": "skIDTag", "data": "123456", "tagID": "0" "membank":"3", "address": "0", "length": "6" RSSI": "-101" }, { "type": "skIDTag", "data": "654321" "tagID": "1" "membank":"3", "address": "0", "length": "6" RSSI": "-99" } ] or "?" in case of an error.

Gonector_Read( "MYS350Reader_1ALR350" ; "multiple" ; "rfidCard" ; 3 ; 0 ; 6 )
This returns a JSON string such as [ { "type": "alienTag", "data": "123456", "tagID": "0" "membank":"3", "address": "0", "length": "6" "scaledRssi" : 50 }, { "type": "alienTag", "data": "654321" "tagID": "1" "membank":"3", "address": "0", "length": "6" "RSSI": 15 } ] or "?" in case of an error. RSSI is number between 0 - 100 and represents relative strenght of the signal.

Gonector_Read( "MIN-7943" )
This returns a JSON string such as [ { "type": "weight", "data": "0.05¶g" } ] or [ { "type": "rawData", "data": "ERROR 2" } ] or "?" in case of an error.

Gonector_Read( "LineaInfinea" ; "single" ; "stripe" )
This returns a JSON string such as [ { "type": "stripe", "data": "cardholderName¶cardholderFirstName¶cardholderLastName¶accountNumber¶serviceCode¶discretionaryData¶expirationMonth¶expirationYear" } ] or "?" in case of an error.

Gonector_Read( "LineaInfinea" ; "last" ; "rfidCard" )
This returns a JSON string such as [ { "language": "en", "type": "ndefText", "data": "Hello", "deviceName": "LineaInfinea" }, { "language": "cs", "type": "ndefText", "data": "Vítejte", "deviceName": "LineaInfinea" } ], [ { "type": "image/jpeg", "base64Data": "SGVsbG8=" } ] or "?" in case of an error.

Gonector_Read( "LineaInfinea" ; "unique" ; "barcode" )
This returns a JSON string such as [ { "deviceName": "deviceName", "type": "barcode", "barcodeType": "CODE128", "data": "Hello 1d code" }, { "deviceName": "deviceName", "type": "barcode", "barcodeType": "QRCODE", "data": "Hello 2d code" } ] or "?" in case of an error.

Gonector_Read( "iPhone" )
This returns a JSON string such as [ { "type": "text/plain", "data": "Hello" } ] or "?" in case of an error.

Gonector_Read("mPosInfinea" ; "single" ; "smartCard" ; "5000")
This reads the smart card chip and returns the JSON string with the data from the chip. Terminal might ask for PIN code.

Gonector_Read("Zebra CS4070" ; "single" ; "barcode")
This returns a JSON string such as [ { "deviceName": "Zebra CS4070", "type": "barcode", "barcodeType": "QRCODE", "data": "Hello 1d code" } ] or "?" in case of an error.

Gonector_Read("ALR-S350" ; "single" ; "barcode")
This returns a JSON string such as [ { "deviceName": "ALR-S350", "type": "barcode", "barcodeType": "QRCODE", "data": "Hello 1d code" } ] or "?" in case of an error.

Gonector_Write( deviceName ; options ; value { ; cardLocking { ; tagID ; memBank ; address ; lenght } } )

Writes data to the device.

Parameters

deviceName	Unique name of the device
options	Specific options
value	The value to be written
cardLocking	Can be "lock" or empty string. In case of "lock" read/write card will be locked and cannot be rewritten in the future. Default value is "". This is a one way process. Locked card cannot be unlocked
tagID	Defines tag to which memory will be written. If ommited, memory will be written to all available tags.
memBank	Tag memory bank
address	Address from where to write data
length	Length of the data written

Possible values for options:

Options	Supported device	Description
"rawData"	LineaInfinea, skID, ALR-S350, qIDmini	Writes raw data onto the card. Write dialog will be shown
"ndefText"	LineaInfinea and iPhone	Writes an NDEF message formatted as a Well Known text to the NFC card. Write dialog will be shown
"ndefUri"	LineaInfinea and iPhone	Writes an NDEF message formatted as a Well Known URI to the NFC card according to the RTD. Write dialog will be shown
"ndefMime"	LineaInfinea and iPhone	Writes an NDEF message formatted as a MIME data to the NFC card. Images and other data based MIME types should be passed as container. Write dialog will be shown
"ndefMultiple"	iPhone	Writes multiple NDEF messages. Works only on iPhone. Parameter "value" has to be JSON see more in Writing multiple records from iPhone section. Write dialog will be shown
"iso15693"	iPhone	Writes data to ISO15693 tag. Write dialog will be shown
"iso7816"	iPhone	Writes data to iso7816 tag. Write dialog will be shown
"felica"	iPhone	Writes data to FeliCa tag. Write dialog will be shown
"mifare"	iPhone	Writes data to MiFare tag. Write dialog will be shown
"terminalMessage"	Ingenico terminals	Writes a message to the terminal. Catch replies with Gonector_SetScriptEvent

Writing multiple records from iPhone

• on iPhone you can write multiple NDEF records
• to do this set parameter "options" to "ndefMultiple" and parameter "value" to JSON string
• this JSON has to be an Array of Objects and every object has to contain two keys: "type" and "value":
  • "type" should be set to NSDef type you want to use: "ndefText", "ndefUri" or "ndefMime"
  • "value" should be set to value you want to write to tag:
    • in case of "ndefText" it should be text you want to write
    • in case of "ndefUri" it should be url you want to write
    • in case of "ndefMime" is should be base64 encoded string of data you want to write, in this case you also may optionally define key "mime_type" to set mime type of written value otherwise mime type will not be set

Example: Gonector_Write("iPhone" ; "ndefMultiple" ; "[{"type": "ndefText", "value": "text to write"}, {"type": "ndefUri", "value": "https://24usoftware.com"}, {"type": "ndefMime", "value": "dGVzdA==", "mime_type": "text\/plain"}]"
This will write 3 NDef messages to the tag.

Description

Plugin writes data through the selected device. In case of NDEF format, the card is formatted so that it is iPhone 7+ readable. The card will be completely rewritten.

Result

Function returns 0. In case of error the function will return "?". Use Gonector_Get( "lastError" ) to get the specific error code.

Examples

Gonector_Write( "LineaInfinea" ; "ndefUri" ; "https://www.24usoftware.com")
This writes an NDEF message as a URI to the present NFC card through the Linea or Infinea device.

Gonector_Write( "LineaInfinea" ; "ndefMime" ; test::container )
This writes an NDEF message as a MIME to the present NFC card through the Linea or Infinea device.

Gonector_Write( "LineaInfinea" ; "ndefText" ; "Hello World" ; "lock")
This writes an NDEF message as a Text to the present NFC card through the Linea or Infinea device and lock it.

Gonector_Write( "skID" ; "rawData" ; "Hello World" ; "" ; "1" ; 3 ; 0 ; 11)
This writes "Hello World" to user memory bank from addres 0 on RFID card.

Gonector_Write( "MYS350Reader_1ALR350" ; "rawData" ; "Hello World" ; "" ; "1" ; 3 ; 0 ; 11)
This writes "Hello World" to user memory bank from addres 0 on RFID card.

Gonector_Write( "iPhone" ; "ndefText" ; "Hello World" )
This writes an NDEF message as a Text to the present NFC card through the iPhone.

Gonector_Write( "iPhone" ; "iso15693" ; "Hello World" )
This writes data to ISO15693 tag through the iPhone.

Gonector_Write( "iPhone" ; "iso7816" ; "Hello World" )
This writes data to ISO7816 tag through the iPhone.

Gonector_Write( "iPhone" ; "felica" ; "Hello World" )
This writes data to FeliCa tag through the iPhone.

Gonector_Write( "iPhone" ; "mifare" ; "Hello World" )
This writes data to MiFare tag through the iPhone.

Gonector_RawCommand( deviceName ; value { ; option })

Sends raw data to the BlueSnap Smart or Zebra ZQ630 device

Parameters

deviceName	Unique name of the device
value	String of the data to be sent
option	Adds various options to raw command

Possible values for option.

"buffer"

This option can be used to store multiple raw commands in buffer. Supported only on Zebra ZQ630, this option will allow to store in buffer raw commands, barcodes, texts and RFIDdata if we want to print them to one RFID tag.

Description

This function is used to send raw data to the scale. See the scale's manual to see what kind of messages the scale supports.
In case of Zebra ZQ630, this function is used to send raw ZPL commands to the printer. See printer's manual for more info.

Result

Function returns 0. In case of error the function will return "?". Use Gonector_Get( "lastError" ) to get the specific error code.

Examples

Gonector_RawCommand( "MIN-7943" ; "R" )
This command sends RawCommand "R" to the BlueSnap Smart device

Gonector_RawCommand( "ZQ630" ; "^XA^FO50,50^A0N,40^FDSimple write example^FS^XZ" )
This command sends RawCommand to ZebraPrinter that will print "Simple write example" on position (50, 50) and size 40

Gonector_DoTransaction( deviceName ; posNumber ; amount ; transactionType ; currency ; applicationNumber ; authorization { ; extendedData { ; privateData } } )

Processes a transaction

Parameters

deviceName	Unique name of the device
posNumber	POS Number
amount	Amount of the transaction. 500 means 5.00 with the ČSOB Link/2500
transactionType	Transaction Type ( Debit = "0", Credit = "1", Annulation = "2", Duplicata = "3" ). It can also be something else depending on the agreement with the provider (bank)
currency	The currency code in ISO4217 format. E.g. "978" for EUR
applicationNumber	The number of the terminal application that should be invoked to handle the transaction. If this parameter is set to 0, the payment application will be implicitly selected
authorization	Authorization flag: force or not the application to do an online authorization call. Pass a "0", "1" or "2". "0" is no authorization. You can obtain the correct value from your provider (bank). The tested Link/2500 ČSOB version was functional with "0">
extendedData	Certain banks require extended data to be sent. Pass a TLV encoded container or text string. Use function Gonector_Prepare to prepare string into TLV data if needed
privateData	Application specific data to be passed to payment application. Max size 10 bytes

Description

This function is used to process a transaction.

Result

This function returns always a 0. Use Gonector_SetScriptEvent to receive the reply.

Examples

Gonector_DoTransaction( "Link/2500-163637313071041701279653" ; "1" ; "500" ; "0" ; "203" ; 0 ; 0 ; "INVOICENUM=0" )
This function call issues a command to the terminal to make a payment of 5,00 CZK on the ČSOB version of Ingenico Link/2500.

Gonector_Submit( deviceName ; selector ; value )

Submits a request

Parameters

deviceName	Unique name of the device
selector	Selects an action type
value	The value to be submitted

Possible values for selector:

Options	Supported device	Description
"signature"	Ingenico terminals	Value must be a container containing an image. Use function Gonector_Prepare to resize the image into the height and width received through Gonector_SetScriptEvent

Description

This function is used to submit a request typically received through Gonector_SetScriptEvent.

Result

Function returns 0 in case of success. In case of error the function returns "?". Use Gonector_Get( "lastError" ) to get the specific error code.

Examples

Gonector_Submit( "Link/2500-163637313071041701279653" ; "signature" ; test::signature )
This submits a signature from container test::signature.

Gonector_Prepare( deviceName ; selector ; item { ; parameter1 { ; parameter2 } } )

This function helps to prepare data for specific tasks needed by other functions such as Write("terminalMessage") and Submit("signature")

Parameters

deviceName	Unique name of the device
selector	Selects a type of preparation
item	The item to be prepared

Possible values for selector:

Options	Supported device	Description
"imageResize"	Ingenico terminals	Item must be a container containing an image. Pass width as a parameter1 and height as parameter2
"tlvEncode"	Ingenico terminals	Takes a type as a parameter1 and returns a JSON with TLV encoded Base64 data. Only one byte type/tag is supported. Constructed TLV is not supported
"tlvDecode"	Ingenico terminals	Takes a container with TLV encoded data and returns a JSON with data and type representing the TLV extracted data based on X.690

Description

This function is used to prepare data.

Result

Function returns a modified value based on the selector.
In case the result is a string it is passed as "data". In case the result is binary then the actual result is passed as "base64Data". The result format is a JSON string such as this:
[ { "deviceName": "", "type": "", "base64Data": "Data returned", "data": "Data returned" } ]
In case of error the function will return "?". Use Gonector_Get( "lastError" ) to get the specific error code.

Examples

Gonector_Prepare( "Link/2500-163637313071041701279653" ; "imageResize" ; test::signature ; 40 ; 20 )
This prepares a signature from container test::signature and returns a JSON with base64Data containing the resized image.

Gonector_Prepare( "Link/2500-163637313071041701279653" ; "tlvEncode" ; "INVOICENUM=0" ; 12 )
This prepares text INVOICENUM=0 as a UTF-8 String type conforming to the X.690 standard.