Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Master Terminal Config:  

#Setting 1 for 5C:

Use this terminal config to get started: (allows all msr swipes, output fallback reason is off, default transaction amount is a non-zero amount, fallback behavior on bad chip insert / no matching AID)

9F 02 06 00 00 00 00 01 00 5F 36 01 02 9F 1A 02 08 40 9F 35 01 21 9F 33 03 60 28 C8 9F 40 05 F0 00 F0 A0 01 9F 1E 08 54 65 72 6D 69 6E 61 6C 9F 15 02 12 34 9F 16 0F 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 9F 1C 08 38 37 36 35 34 33 32 31 9F 4E 22 31 30 37 32 31 20 57 61 6C 6B 65 72 20 53 74 2E 20 43 79 70 72 65 73 73 2C 20 43 41 20 2C 55 53 41 2E DF 26 01 01 DF 10 08 65 6E 66 72 65 73 7A 68 DF 11 01 00 DF 27 01 00 DF EE 15 01 01 DF EE 16 01 00 DF EE 17 01 05 DF EE 18 01 80 DF EE 1E 08 D0 9C 20 D0 C4 1E 16 00 DF EE 1F 01 80 DF EE 1B 08 30 30 30 31 35 31 30 30 DF EE 20 01 3C DF EE 21 01 0A DF EE 22 03 32 3C 3C DF EF 4B 03 7F 00 00 DF EF 62 01 00 DF EF 7D 01 03 DF EF 7E 06 50 01 50 05 50 36 DF ED 0A 01 00 DF EF 5A 62 4F 50 56 57 5A 82 84 87 8A 95 9A 9B 9C 5F 24 5F 2A 5F 30 5F 34 9F 02 9F 03 9F 06 9F 07 9F 08 9F 09 9F 11 9F 0D 9F 0E 9F 0F 9F 10 9F 12 9F 1A 9F 1E 9F 21 9F 26 9F 27 9F 33 9F 34 9F 35 9F 36 9F 37 9F 38 9F 39 9F 3C 9F 40 9F 41 9F 53 9F 6E 9F 7C 5F 20 5F 28 5F 2D 5F 56 DF EE 23 DF EE 26 FF EE 01

#Setting 2 for 5C

Use this terminal config to get started: (disalllow swipe for chip cards except on fallback, default transaction amount is a non-zero amount, fallback behavior on bad chip insert / no matching AID)

9F 02 06 00 00 00 00 01 00 5F 36 01 02 9F 1A 02 08 40 9F 35 01 21 9F 33 03 60 28 C8 9F 40 05 F0 00 F0 A0 01 9F 1E 08 54 65 72 6D 69 6E 61 6C 9F 15 02 12 34 9F 16 0F 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 9F 1C 08 38 37 36 35 34 33 32 31 9F 4E 22 31 30 37 32 31 20 57 61 6C 6B 65 72 20 53 74 2E 20 43 79 70 72 65 73 73 2C 20 43 41 20 2C 55 53 41 2E DF 26 01 01 DF 10 08 65 6E 66 72 65 73 7A 68 DF 11 01 00 DF 27 01 00 DF EE 15 01 01 DF EE 16 01 00 DF EE 17 01 05 DF EE 18 01 80 DF EE 1E 08 D0 9C 20 D0 C4 1E 16 00 DF EE 1F 01 80 DF EE 1B 08 30 30 30 31 35 31 30 30 DF EE 20 01 3C DF EE 21 01 0A DF EE 22 03 32 3C 3C DF EF 4B 03 7F 00 00 DF EF 62 01 01 DF EF 7D 01 03 DF EF 7E 06 50 01 50 05 50 36 DF EF 5A 62 4F 50 56 57 5A 82 84 87 8A 95 9A 9B 9C 5F 24 5F 2A 5F 30 5F 34 9F 02 9F 03 9F 06 9F 07 9F 08 9F 09 9F 11 9F 0D 9F 0E 9F 0F 9F 10 9F 12 9F 1A 9F 1E 9F 21 9F 26 9F 27 9F 33 9F 34 9F 35 9F 36 9F 37 9F 38 9F 39 9F 3C 9F 40 9F 41 9F 53 9F 6E 9F 7C 5F 20 5F 28 5F 2D 5F 56 DF EE 23 DF EE 26 FF EE 01

Master List of Available Custom Configs:  

...

Premise:

The Augusta is capable of outputting both chip card and swipe data in a keyboard emulation format.

This allows the product to be used in a plug & play situation!

This is a general FAQ for the Augusta when it is used in the QC KB format.

For more detailed support / questions, please email support@idtechproducts.com



Common Custom Configs / Output:  

For the most up to date list, all of these tags should be covered in the 80000503-001 ID TECH TLV Tag Reference Guide document.


TagDefinitionLengthRecommended DefaultExampleDescription / Usage
DFEF62Controls whether MSR card with a chip on it can be swiped100DFEF6201000: Allows swipe from chip card. 1: Disallows swipe from chip card.
DFED0AOutputs Fallback Reason101DFED0A01010: Switch is off, does not output fallback reason. 1: Switch is on, does output fallback reason
DFEF65 Controls Error Reporting101DFEF6501010: Switch is off, does not output errors / mutes. 1: Switch is on, does output errors
DFEF62Controls whether MSR card with a chip on it can be swiped100DFEF6201000: Allows swipe from chip card. 1: Disallows swipe from chip card.
DFEF7D Controls the number of times the reader will allow another insert after a bad insert103DFEF7D0103

Configure up to 5 maximum times for the fallback. More information is available on the IDTECH KB:

Product Integration Topic - Augusta QuickChip KeyBoard fallback behavior

DFEF7E Controls the status messages returned by the device while the device is in fallback.650 01 50 05 50 36DFEF7E06500150055036Leave as the recommended default value.
DFEF5A Controls output of tags in QC KB modevariableSee belowSee below

This tag is utilized for the Augusta QC KB's output. The contents of the tag should include all tags that you'd like to see output on a successful dip.

We recommend that you put only the bare minimum necessary, as each tag added will increase the time spent / amount of information to process.

DFED20Company Name0-1669 64 74 65 63 68DFED2006696474656368

To use, Add this to the DFEF5A output (see further below) after you specify this in the terminal configurations.

Use this TLV for meta data for company name - recommended to use this to store some identifier to track who configured the device.


DFED21Configure Date3042018DFED2103042018

To use, Add this to the DFEF5A output (see further below) after you specify this in the terminal configurations.

Use this TLV for tracking the configuration date - recommended to use this to track date of config if the key injection / config are done at separate dates.

Noe that the output in HEX is the actual value, does not need to be converted.

DFED22Current Configuration Version / Misc field0-3268 65 6C 6C 6F 2D 74 68 69 73 2D 69 73 2D 69 64 74 65 63 68 2D 63 6F 6E 66 69 67 75 72 65 64 21DFED222068 65 6C 6C 6F 2D 74 68 69 73 2D 69 73 2D 69 64 74 65 63 68 2D 63 6F 6E 66 69 67 75 72 65 64 21

To use, Add this to the DFEF5A output (see further below) after you specify this in the terminal configurations.

Use this TLV for anything that might help you uniquely identify the terminal and device.


DFEF57FW Version for QC KBvariableN / ADF EF 57 0A 56 31 2E 30 32 2E 30 30 32 2A

To use, Add this to the DFEF5A output (see further below). This value will be pulled from the device.

DFEE17Terminal Entry Mode output control105DFEE170105This configured the output value for 9F39, which is the POS entry mode. If you include 9F39 in the DFEF5A tag, you can expect to see the contents of DFEE17 returned.



How do I configure Augusta QC KB?  

You can consult our guide on the IDTECH KB -

How Do I Enable/Disable Quick Chip for KeyBoard Emulation (QCKB) on the Augusta?

How does the Augusta QC KB behave on a successful swipe, bad swipe, bad dip, successful dip, fallback swipe, etc?  

Proposed behavior implementation is here: Add user feedback (LEDs and Beeps )for any card interaction

Current behavior is not documented.



Terminal entry mode (9F39) is returning the incorrect value. How come? How do I resolve this?  

We can modify this in our terminal configs - IDTECH defined tag DFEE17 to set the value of 9F39.

In your current terminal configs (example below), change the value of DFEE17 from 7 -> 5. 
This tag was set to 7 in our default example as we have the same EMV L2 kernel being used across our contact/contactless family.

5F 36 01 02 9F 1A 02 08 40 9F 35 01 21 9F 33 03 60 28 C8 9F 40 05 F0 00 F0 A0 01 9F 1E 08 54 65 72 6D 69 6E 61 6C 9F 15 02 12 34 9F 16 0F 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 9F 1C 08 38 37 36 35 34 33 32 31 9F 4E 22 31 30 37 32 31 20 57 61 6C 6B 65 72 20 53 74 2E 20 43 79 70 72 65 73 73 2C 20 43 41 20 2C 55 53 41 2E DF 26 01 01 DF 10 08 65 6E 66 72 65 73 7A 68 DF 11 01 00 DF 27 01 00 DF EE 15 01 01 DF EE 16 01 00 DF EE 17 01 05 DF EE 18 01 80 DF EE 1E 08 D0 9C 20 D0 C4 1E 16 00 DF EE 1F 01 80 DF EE 1B 08 30 30 30 31 35 31 30 30 DF EE 20 01 3C DF EE 21 01 0A DF EE 22 03 32 3C 3C DF EF 4B 03 7F 00 00 DF EF 62 01 01 DF EF 7D 01 03 DF EF 7E 06 50 01 50 05 50 36 DF EF 5A 62 4F 50 56 57 5A 82 84 87 8A 95 9A 9B 9C 5F 24 5F 2A 5F 30 5F 34 9F 02 9F 03 9F 06 9F 07 9F 08 9F 09 9F 11 9F 0D 9F 0E 9F 0F 9F 10 9F 12 9F 1A 9F 1E 9F 21 9F 26 9F 27 9F 33 9F 34 9F 35 9F 36 9F 37 9F 38 9F 39 9F 3C 9F 40 9F 41 9F 53 9F 6E 9F 7C 5F 20 5F 28 5F 2D 5F 56 DF EE 23 DF EE 26 FF EE 01

To modify this, just pull up your existing terminal configurations and edit the value of DFEE17.
That should cause all your transactions to be flagged correctly as 5 rather than 7.



9F02 is returning the wrong amount / 0. What should I do?  

9F02 is set to 00 00 00 00 00 00 by default. You can add this to your terminal configs to update the default amount to a non-zero amount, or the amount that you need.

Add this to your terminal config: So you can add this to your terminal config for ($1): 9F02 06 0000000000100

This output tag value is not documented in the documentation!  

Our documentation needs to be updated to clearly reflect all possible scenarios, and error codes. This is a work in progress as we are working on getting this product EMV L3 certified, as well as preparing a small booklet.

Current behavior is not documented.

ToDo: DFEF65 (output mute)

What are all these proprietary tags? Where do I find more information about these?  

Proprietary tags are documented in ID TECH document 800000503-001, the TLV Tag Reference Guide.

I want particular tags to show up in the Augusta QC KB output. How do I go about doing this?  


IDTECH has defined tag DFEF5A tag DFEF5A to allow you to control which TLVs are returned during a transaction. Use

You can use this custom tag to specify the tags you want returned. You can read or write this tag when you read or write Terminal Settings. For example, consider the Terminal Settings block shown below.

5F3601029F1A0208409F3501219F33036028C89F4005F000F0A0019F1E085465726D696E616C9F150212349F160F3030303030303030303030303030309F1C0838373635343332319F4E2231303732312057616C6B65722053742E20437970726573732C204341202C5553412EDF260101DF1008656E667265737A68DF110100DF270100DFEE150101DFEE160100DFEE170107DFEE180180DFEE1E08D09C20D0C41E1600DFEE1F0180DFEE1B083030303135313030DFEE20013CDFEE21010ADFEE2203323C3CDFEF4B037F0000DFEF620101DFEF7D0103DFEF7E06500150055036DFEF5A624F5056575A8284878A959A9B9C5F245F2A5F305F349F029F039F069F079F089F099F119F0D9F0E9F0F9F109F129F1A9F1E9F219F269F279F339F349F359F369F379F389F399F3C9F409F419F539F6E9F7C5F205F285F2D5F56DFEE23DFEE26FFEE01

As you can see in the large blob of text - DFEF5A is there! How do I use it?DFEF5A is a TLV that defines ALL the output tags for the Augusta. The default value of DFEF5A is what comes out of the Augusta QC KB on an insert when this value has not been defined.

...

For another example - let's say we only wanted a single tag (9F1E) output in the return tags.

...

We'd do the following for our terminal config: (sample)

5F3601029F1A0208409F3501219F33036028C89F4005F000F0A0019F1E085465726D696E616C9F150212349F160F3030303030303030303030303030309F1C0838373635343332319F4E2231303732312057616C6B65722053742E20437970726573732C204341202C5553412EDF260101DF1008656E667265737A68DF110100DF270100DFEE150101DFEE160100DFEE170107DFEE180180DFEE1E08D09C20D0C41E1600DFEE1F0180DFEE1B083030303135313030DFEE20013CDFEE21010ADFEE2203323C3CDFEF4B037F0000DFEF620101DFEF7D0103DFEF7E06500150055036DFEF5A029F1E

...

Our output from the Augusta QC KB would now only have 9F1E.


I need a custom set of TLVs to be output as part of every Quick Chip transaction. The length of DFEF5A depends on the TLVs you are including.


So if you wanted to include 3 tags in the output, you'd add DFEF5A as follows:



9F02 is returning the wrong amount / 0. What should I do?  

9F02 indicates the pre-agreed upon amount. This value is typically discussed between you and your acquirer. 

9F02 is set to 00 00 00 00 00 00 by default. You can add this to your terminal configs to update the default amount to a non-zero amount, or the amount that you need.

Add this to your terminal config: So you can add this to your terminal config for ($1): 9F02 06 0000000000100



What are all these proprietary tags? Where do I find more information about these?  

Proprietary tags are documented in ID TECH document 800000503-001, the TLV Tag Reference Guide.



Can I have IDTECH create a custom part number reader, with my custom tags, to save me time, or can I order this custom configuration from distribution?  

...

Either way is possible. However,  your sales rep and our support engineers will have to work with you to ensure that we understand exactly what your requirements are.

This will need to go through our internal CPR process, to be qualified by our sales, operations, and engineering departments, before there is a specific part number you can order – a process that may take upwards of a month.

The process can be made simpler by creating your own configurator tool (using ID TECH's freely available Universal SDK) to scale your production pipeline and also afford you much more control in the long run.

We additionally have a configuration utility that we equip our distribution partners with! Contact your sales rep to learn more about this, or email support@idtechproducts.com 



I swiped a card on the Augusta QC KB, and I'm getting no response from the reader. Why?  

...

The followings tags and implementation are heavily covered in this documentProduct Integration Topic : - Augusta QuickChip KeyBoard fallback behavior

At a high level, you need to specify the following terminal configurations:

  • DF EF 62 01 01
  • DF EF 7D 01 03
  • DF EF 7E 06 50 01 50 05 50 36

Current behavior is not documented.



If the card fails to read (bad ICC card), what does the device do? How do I allow a swipe (with same chip card) as a backup method?  

...

So to answer your question - the device will allow a swipe or insert the first 3 times. On the last time, the transaction will terminate.
For the status codes, we return F2 22 on the 3rd try so your application can return a different code.

Current behavior is not documented.



The length of the fallback output doesn't match up with BER-TLV standard?  

...

The length you see is a character count rather than the actual length, including a carriage return. I

We performed a bit of a proof below on this guide - Product Integration Topic : - Augusta QuickChip KeyBoard fallback behavior

Current behavior is not documented.



How do I parse out DFEE23 when it is returned in a fallback swipe?  

...

I'd like to configure my device to support add a carriage return after the data on both swipe and/or dip. How do I do that?  26 Jul  

First, read this: I'm using Keyboard Quick Chip and the reader isn't sending a carriage return, pressing the enter key, after card presentation. Can the reader do this?

...

0206007253012a010d06fe03 // ICC Carriage return
0253d302010d038f // MSR Carriage return

After both commands have been run with the older version of the demo, do a swipe and an insert to verify the behavior.

Current behavior is not documented, and has issues.

Use uDemo to send these commands




To Enable ICC Carriage return:

Image Added

Send "7253012a010D" command via uDemo with the Augusta in the HID mode using "Wrap NGA" option (Check the setting with 7252012a)

To enable MSR Carriage return:

Image Added

Send "53d302010D" command via uDemo with the Augusta in the KB mode using the "Wrap ITP" option. (check the setting with 52d3)



------------------------------------------------

To Disable ICC Carriage return:

Send "7253012a0100" command via uDemo with the Augusta in the HID mode using "Wrap NGA" option. (Check the setting with 7252012a)

To disable MSR Carriage return:

Send "53d30100" command via uDemo with the Augusta in the KB mode using the "Wrap ITP" option. (check the setting with 52d3)



I'm seeing only HEX data or I'm only seeing HEX + ASCII data in my MSR swipes and fallback swipes. What is going on?  

...

02CE00801D370000A089B8FA611F97EE301D99DC1C54E3DE5C47F1FC8F181DEBA1BED1D4552263EA52A4751FBF871A34249F046D66870C16D9640F7614BBBCEB6E400000000000000000000000000000000000000000363235543730303135346299490000000000003B01FD03



Last Updated: