Manual for Linea or Infinea device

Limitations

Detailed limits for the RFID cards are found here. We recommend to use NTAGs. Namely NFC Forum Type 2 Tags. (They fall into the category Mifare Ultralight but they are NDEF formatted)

Connecting the Linea or Infinea device

To successfully connect the Linea or Infinea device it is necessary to call function Gonector_Connect( "LineaInfinea" ) and press a hardware button. For Linea Pro 7 it is the button on the right hand side of the device.

Connection troubleshooting guide

Open Settings of the iOS device
Open the General tab on the iOS device
Open About on the iOS device
Scroll down and see if the device is mentioned in the list of options
If the device is not visible in the list of options, try to press the hardware button mentioned in the specification of the device as a startup button
If the device is still not visible in the list of options, try reconnecting the device by removing it completely
If the device is still not visible in the list of options, try to restart the iOS device
If the device is still not visible in the list of options, try upgrading the firmware of the iOS device
If the device is still not visible in the list of options, contact the supplier at https://stimare.net/contact-us/
If the device is visible in the list of options but it is not possible to use the function Gonector_Connect successfully, please contact our support at support@24usoftware.com

Solving issues with Linea or Infinea device

Device is connected to iOS, but i cannot use the device and cannot get firmwareVersion neither
Linea and Infinea devices use special protocol for communication, which has to be specified in your app. Into the .plist file of the project in Xcode, add new Row with the value "Supported external accessory protocol" and add the Strings:
- "com.datecs.linea.pro.msr"
- "com.datecs.linea.pro.bar"
I cannot read some of the supported barcodes
Barcodes Codabar, Code93 and ITF14 are disabled by default for Linea Pro 7. To initiate reading it is necessary to read following codes

Security

LineaInfinea stripe key guide

To manipulate the key for stripe reading you have two functions: Gonector_Set( "deviceStripeKey" ; ... ) and Gonector_Set( "connectionStripeKey" ; ... ).
Function Gonector_Set( "deviceStripeKey" ; ... ) stores the StripeKey directly in the device and so the plugin has no access to this key.
After every Gonector_Connect function you should set the same key with function Gonector_Set("connectionStripeKey" ; ... ) for stripe reading.
In fact the StripeKey is not used to decrypt the card. The StripeKey is used as a "Loading key" and at the same time a random session key is created and stored in the device and the plugin.
The StripeKey is never stored in the plugin.
SessionKey is not know to the user.
The device knows both keys and is able to provide handling for both keys.
As soon as the function Disconnect is called the session key disappears.
Those mechanics are provided by the device and they serve to protect the credit card data. The plugin was designed to comply with those rules.

Apple App Store Requirements

If you build an app for any Infinite Peripherals device and are going to distribute your app on the App Store, you will need to register the app with Infinite Peripherals in order to obtain MFi Authorization.

You can do so through the Infinite Peripherals website. Infinite Peripherals will provide you with an identification number (PPID) that you have to include in review notes when submitting your app. Select "Yes" for the "Bluetooth feature" option when registering your app as some of the supported devices use Bluetooth with a non-standard profile for communication. This should be performed only once for all LineaInfinea devices.

App Developer Key

Create an account at Infinite Peripherals developer portal
After you account is approved you can create an app developer key in your main profile page
Bundle ID Name for your generated key has to be the same as the bundle id of your app
Before you use any Linea or Infinea device you have to first call:
Gonector_Set("appDevKey" ; "LineaInfinea" ; "<your app dev key>")