Dot Origin VTAP 100, Basic Configuration Manual

Page 1: ...Basic Configuration Guide Firmware from v1 1 10 2 Revised July 2022 v2 4 ...

Page 2: ...hen please contact our support team The product is constantly being reviewed and improved and we value feedback about your experience Copyright 2022 Dot Origin Ltd All rights reserved No part of this Configuration Guide may be published or reproduced without the written permission of Dot Origin Ltd except for personal use This Configuration Guide relates to correct use of the VTAP100 only No liabi...

Page 3: ... only part of the card or tag data 15 5 Connect to other systems 17 5 1 Send pass data over a virtual COM port 17 5 2 Using VTAP100 with Read a Card software 18 5 3 More advanced features 19 6 Maintenance features 21 6 1 Check status in BOOT TXT 21 6 2 Update firmware 22 6 3 Software lock to prevent local firmware or configuration change 22 6 4 Hardware lock to disable USB mass storage device 23 6...

Page 4: ...tegrate VTAP100 outputs with other systems will need the additional information contained in the Advanced Configuration and Commands Reference Guide The Default Config txt file is included as an Appendix so that you can always revert to factory configuration should you make mistakes or delete guidance comments you later need You must be running firmware v1 1 10 2 or later to access all of these co...

Page 5: ...ass reading parameters and define the format to send data per interface You can optionally define LED or buzzer actions required when a pass is detected By default the VTAP100 is fully upgradable in the field using a file based method for distributing firmware updates in a secure manner However the VTAP100 hardware can be optionally locked before deploying the unit so that operation is no longer e...

Page 6: ...exible in supporting different data formats for different media and different interfaces So we would recommend you follow an incremental approach to setting up and testing your settings 1 First check that the VTAP100 delivers Default operation on factory settings 2 Then set up for reading mobile passes only with a keyboard emulation output which is described in Start reading your own passes ...

Page 7: ...tor such as Windows Notepad 4 When you tap the OriginPass on the VTAP100 l Pass contents will be displayed in the open text editor l The diagnostic LEDs on the VTAP100 PCB will flash together l Your smartphone may signal with a buzz or beep Note Some Android phones will only interact if their screen is on although it does not need to be unlocked You may need to enable NFC in the settings for the s...

Page 8: ...e are stored in a file with the name private pem following the pem format where is replaced with a number from 1 to 6 matching the key slot you will save it in The demo passes are accessed using the key in KeySlot 6 so don t overwrite this one unless you are finished with demo passes Note You cannot use more than 6 key files 2 Load your keys by copying these files onto your VTAP100 which shows up ...

Page 9: ... of parameters does not matter to the VTAP100 but could help other people who need to edit the file Start any comment lines in the config txt file that the VTAP100 should ignore with a semicolon Each parameter should only appear once if it accidentally appears more than once then only the last instance will take effect Example Settings in config txt to interact with both Apple VAS and Google Smart...

Page 10: ...If the data received by the VTAP100 cannot be decrypted the Apple iphone will register a pass read but the data will not be output Note If an ST KeySlot parameter is omitted or set to 0 then authentication will be omitted and decryption will not be performed In this case Google Pay Smart Tap data will be received and sent on by the VTAP100 only if the pass does not require authentication by the te...

Page 11: ...e 3 Open the file config txt file in a text editor such as Windows Notepad Note If local security settings prevent or limit the use of removable storage devices or the connection of additional keyboards an administrator may need to alter those permissions The groups of parameters in your config txt file are summarised in the following figure Figure 3 1 Overview of config txt BASIC CONFIGURATION GU...

Page 12: ...ses This is already enabled in the default configuration with KBLogMode 1 for all mobile passes or NFC tags cards that the VTAP100 can read using KBSource 81 So if you open a text editor on the PC connected to the VTAP100 any successful pass read will result in pass contents appearing in that open text editor If you need to switch off sending pass data as keyboard emulation set KBLogMode 0 There a...

Page 13: ... prefixes such as ComPortPass or WiegandPass to control the mobile pass data sent over those other interfaces To extract only a part of the data use KBPassMode 1 The following examples extract data in different ways Example Changes to config txt to extract a fixed length of data from a particular start point VTAPconfig KBPassMode 1 KBPassSeparator KBPassSection 2 KBPassStart 5 KBPassLength 10 Here...

Page 14: ...eparators to extract data VTAPconfig KBPassMode 1 KBPassSeparator KBPassSection 2 KBPassContentMode 1 KBPassContentSeparator KBPassContentSection 1 In this case there are separators to identify sections and content separators within the target section Figure 3 3 Separator Section 2 Content Separator Section 1 ...

Page 15: ...ent expected from the pass is a hex number which represents an H10301 26 bit card ID an even parity bit calculated over the 12 most significant bits a facility code and then the card number ending with an odd parity bit calculated over the 12 least significant bits Data will be encoded after being padded with trailing zeros to make a whole number of bytes Figure 3 4 Separator Section 2 WiegandPass...

Page 16: ...for user feedback but you could use LEDSelect 2 to use the LED that is visible through a square case SQ instead LEDDefaultRGB 1EEBCF sets the colour that the feedback LED s show constantly but can be set 0 if you would rather LEDs were off when a pass is not being read PassLED chooses the hex colour for the LEDs to flash when there is a mobile pass read along with the flash on time interval and nu...

Page 17: ...e Don t forget that you also need a setting such as KBSource 81 to send this card tag data in addition to mobile pass data over your preferred interface It may help to know the NFC Types are often referred to as Topaz Type 1 Ultralight Type 2 Felica Type 3 and DESFire Type 4 ISO15693 Type 5 is not yet supported There are advanced settings such as NDEFTagExtractType and NDEFTagExtractID described i...

Page 18: ...ored in a fixed location within the first block of the card or tag s memory depending on tag type l NFC data A stream of NDEF records encoded and stored in the card or tag s memory area according to the NFC Forum specification for the tag type Extracted by NDEF record type or ID l Block data A sequence of up to 16 bytes of data stored in a particular location in the card or tag s memory area and a...

Page 19: ...a particular start point VTAPconfig MIFAREClassic B TagReadBlockNumber 8 TagReadKey 123ABC456DEF TagReadKeyType A TagReadOffset 5 TagReadLength 4 TagReadFormat d Here you specify which block to read with the key and key type to use if needed the offset within the block to start taking data counting from 0 and the length of data to take The output format is set to d ecimal So in this case Figure 4 ...

Page 20: ...Send pass data over a virtual COM port A virtual COM port setting for the USB interface will mean that the VTAP100 is treated by the connected PC as a COM port as well as a mass storage device The COM port will be active and will send any pass data received as soon as it is read Refer to the Advanced Configuration and Commands Reference Guide if you want to collect pass data only in response to qu...

Page 21: ... driver VTAP100 inf in the VTAP100 file system Pass data will now be sent over the COM port automatically when it is received Note If you would rather receive pass and status data only in response to a request over the COM port refer to the Advanced Configuration Guide and Commands Reference on how to Use the virtual COM port in passive mode 5 2 Using VTAP100 with Read a Card software There are a ...

Page 22: ...Card e license is on your VTAP100 you will need to make this change then close and reopen the Read a Card application for that license to be recognised Step 3 Test operation by presenting a pass to your VTAP100 You should see that it is detected on the Read a Card Status tab 5 3 More advanced features There are several advanced features which may be needed by integrators for more complex applicati...

Page 23: ...implement their own code with actions that trigger a Zmodem transfer Example code for these situations can be provided in C C Python Java l Use serial interfaces An RS232 serial interface is available on some OEM hardware and RS485 on others These interfaces are used in a similar manner to others but again with some special settings l Use a Wiegand interface There is model of VTAP100 called VTAP10...

Page 24: ...AP100 hardware version in use l KeySlots used a useful check that you have uploaded the necessary key files since these are deleted when they are uploaded These two examples show how to read this information o KeySlots used shows that no keys have been uploaded o KeySlots used 12 56 shows that key files 1 and 2 have been successfully uploaded in addition to the defaults 5 and 6 l VCP enabled indic...

Page 25: ...oftware or simply disable the mass storage device in hardware A Hardware lock to disable USB mass storage device would mean no files from the VTAP100 are visible A software lock will ensure you can still read boot txt and log txt locally You will still able to make changes to firmware or configuration over the command interface on any serial ports that have been enabled including the USB virtual C...

Page 26: ...o disable USB mass storage device You can lock the VTAP100 so that its firmware and configuration cannot be changed You can either do this in software or simply disable the mass storage device in hardware A Software lock to prevent local firmware or configuration change prevents changes but leaves some files visible A hardware lock means that the VTAP100 will no longer be detected as a USB mass st...

Page 27: ...Figure 6 2 Jumper positions on VTAP100 PCB v2 hardware Figure 6 3 Jumper positions on VTAP100 PCB v3a hardware Figure 6 4 Jumper positions on VTAP100 PCB v4a hardware BASIC CONFIGURATION GUIDE PAGE 24 ...

Page 28: ... power This is important because momentarily connecting HWB while the VTAP100 is powered will reset the software password lock 2 Connect a jumper across HWB 3 Apply power connect the USB cable to a PC and wait for the unit to reboot 4 Remove the jumper across HWB 6 6 Reboot remount refresh commands The VTAP100 supports a few direct commands that are sent by creating and saving a text file called c...

Page 29: ...l Refresh will force the VTAP100 to re read config txt This is needed if you have renamed a file to be config txt as renaming is not otherwise noticed BASIC CONFIGURATION GUIDE PAGE 26 ...

Page 30: ...rchantID pass com pronto originpass demo VAS1KeySlot 6 ST1CollectorID 80644855 ST1KeySlot 6 ST1KeyVersion 1 NFCType2 1 KBLogMode 1 KBSource 81 KBDelayMS 2 KBPassMode 0 LEDSelect 1 LEDDefaultRGB 1EBBCF PassLED 00FF00 200 1 1 PassBeep 100 100 2 TagLED 00FF00 200 TagBeep 100 ComPortEnable 0 ComPortMode 1 ComPortSource 81 The factory default configuration for a VTAP100 USB SQ is the almost the same bu...

Page 31: ...n 1 NFCType2 U MIFAREClassic U WiegandMode 1 WiegandSource 81 WiegandPassMode 1 WiegandPassSeparator WiegandPassSection 2 LEDDefaultRGB 1EBBCF LEDSelect 1 PassBeep 50 50 2 TagBeep 100 100 1 KBLogMode 0 KBSource 81 KBDelayMS 2 KBPassMode 0 ComPortEnable 0 ComPortMode 1 ComPortSource 81 StartupDelayMS 5000 The factory default configuration for a VTAP100 PACW SQ is the almost the same but with LEDSel...