1. Manuals
  2. Brands
  3. Dot Origin Manuals
  4. Network Hardware
  5. VTAP50
  6. Configuration manual

Dot Origin VTAP50 Configuration Manual

Hide thumbs Also See for VTAP50:
Table of Contents

Advertisement

Quick Links

Download this manual
Configuration Guide
Firmware from v2.2.5.0
VTAP50 and VTAP100
Revised July 2024 v3.83

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the VTAP50 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Dot Origin VTAP50

Summary of Contents for Dot Origin VTAP50

  • Page 1 Configuration Guide Firmware from v2.2.5.0 VTAP50 and VTAP100 Revised July 2024 v3.83...
  • Page 2 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 VTAP reader only. No liability can be accepted under any circumstances relating to the operation of the user’s own PC, network or infrastructure.

  • Page 3: Table Of Contents

    6.3 Software lock to prevent local firmware or configuration change 28 6.4 Hardware lock to disable USB mass storage device 6.5 Hardware reset to use factory firmware 6.6 Reboot, remount, refresh commands A  Default Config.txt file B  Default leds.ini file [VTAP50 v2 only] CONFIGURATION GUIDE © DOT ORIGIN PAGE I...

  • Page 4: Using This Guide

    VTAP MOBILE WALLET READERS 1   Using this guide This guide is for first-time users of the VTAP50 and VTAP100, and anyone using a VTAP reader with a simple USB connection to a PC. It will help you configure your VTAP reader for a simple applications.

  • Page 5: How A Vtap Reader Works

    (The Wiegand model, VTAP100-PAC-W, is also configured over USB from a PC. After configuration it is connected to an access controller, and will send pass data over the Wiegand interface to the controller, like any other reader.) CONFIGURATION GUIDE © DOT ORIGIN PAGE 2...

  • Page 6: Configure A Vtap Reader

    1. First, check that the VTAP reader delivers Default operation. 2. Then set up for reading mobile passes only, with a keyboard emulation output, which is described in Start reading your own passes. CONFIGURATION GUIDE © DOT ORIGIN PAGE 3...

  • Page 7: Default Operation

    3. Only then add in capability to Read cards or tags or Connect to other systems using other interfaces. If you are an integrator or developer, and need to go further in controlling VTAP50 and VTAP100 behaviour from other systems, you will find that information in the VTAP Application Notes, VTAP Serial Integration Guide and VTAP Commands Reference Guide.

  • Page 8: Start Reading Your Own Passes

    Check status in Boot.txt. If the key file does not disappear and there is an error in Boot.txt, check your .pem file as it is likely it did not adhere to the standard - perhaps it was not an ECC key? CONFIGURATION GUIDE © DOT ORIGIN PAGE 5...
  • Page 9 3. Save the amended config.txt file and these changes will take effect immediately. (A small number of changes to the config.txt file require a reboot to take effect, for instance to the status of the virtual COM port, but these are highlighted in later sections). CONFIGURATION GUIDE © DOT ORIGIN PAGE 6...
  • Page 10 In this case, Google Smart Tap data will be received and sent on by the VTAP reader, only if the pass does not require authentication by the terminal. CONFIGURATION GUIDE © DOT ORIGIN PAGE 7...

  • Page 11: Edit Config.txt

    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 CONFIGURATION GUIDE © DOT ORIGIN PAGE 8...

  • Page 12: Send Pass Data As Keyboard Emulation Over Usb

    Extract only part of the pass data. 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. CONFIGURATION GUIDE © DOT ORIGIN PAGE 9...

  • Page 13: Extract Only Part Of The Pass Data

    Here you specify which section separators to find, and count sections and characters from 0, to extract the right data. In this case: Figure 3-2 Separator |, Section 2, Start 5, Length 10 CONFIGURATION GUIDE © DOT ORIGIN PAGE 10...
  • Page 14 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 CONFIGURATION GUIDE © DOT ORIGIN PAGE 11...
  • Page 15 WiegandMode=1           ; Enable Wiegand interface WiegandPassMode=1       ; Choose to extract only                         ;  a part of the pass payload WiegandPassSeparator=|  ; Set the separator character the VTAP should                         ;  use to separate the payload into sections WiegandPassSection=2    ; Section number to read based on that                          ;  WiegandPassSeparator PassWiegandBits=32                          Figure 3-4 Separator |, Section 2 for Wiegand data (on VTAP100-PAC-W only) Full pass payload: 3|653POAwglifBwdJq|B2000080|Andrew Pass payload sent over the Wiegand interface: B2000080 CONFIGURATION GUIDE © DOT ORIGIN PAGE 12...

  • Page 16: Control Led And Buzzer Feedback

    These can show any hex RGB colour. There is also a buzzer on both VTAP50 and VTAP100. You control how the LEDs and buzzer react to passes, cards or tags by setting parameters including LED or Beep in the config.txt file.

  • Page 17: Vtap50 Serial Leds

    3.4.1 VTAP50 serial LEDs On VTAP50 v2 boards with firmware from v2.1.11.2, a chain of serial LEDs can be connected to the serial LED connection on the expansion header.

  • Page 18: Playing Beep Sequences Or Tunes

    3.4.2 Playing beep sequences or tunes On VTAP100 v5 or VTAP50 v2 hardware onwards, the buzzer frequencies can be changed by specifying a sequence, in a very similar way to specifying sequences for serial LEDs.
  • Page 19 100ms beep at default frequency, simply ignoring the sequence part of the configuration line.) This example includes a variety of notes, specified in a variety of different ways. The syntax used is described below. CONFIGURATION GUIDE © DOT ORIGIN PAGE 16...
  • Page 20 4 from the named MIDI file. (Note: If the MIDI file cannot be found, the PassBeep action would default to a single 100ms beep at default frequency, simply ignoring the sequence part of the configuration line.) CONFIGURATION GUIDE © DOT ORIGIN PAGE 17...

  • Page 21: Read Cards Or Tags

    VTAP MOBILE WALLET READERS 4   Read cards or tags VTAP50 and VTAP100 are primarily designed to read mobile passes, not cards and tags. You can choose to allow VTAP reader to read particular NFC or MIFARE Classic card or tag types in addition to mobile passes, by making changes in config.txt.
  • Page 22 TagRead to Extract only part of the card or tag data. You can also upload keys to read secured data from DESFire cards. This option is addressed in VTAP Application Notes. CONFIGURATION GUIDE © DOT ORIGIN PAGE 19...

  • Page 23: Extract Only Part Of The Card Or Tag Data

    The simplest situation is to set NFCType#=U or MIFAREClassic=U to send the whole UID or NFCType#=N to send all NDEF records. CONFIGURATION GUIDE © DOT ORIGIN PAGE 20...
  • Page 24 0, and the length of data to take. The output format is set to 'd'ecimal. So, in this case: Figure 4-1 Block 8, Offset 5, Length 4 bytes CONFIGURATION GUIDE © DOT ORIGIN PAGE 21...

  • Page 25: Connect To Other Systems

    5.2 Using a VTAP reader with the latest Read-a-Card software Read-a-Card software from Dot Origin can act as a VTAP software agent, providing a simple means of transferring pass or card read information from your VTAP reader to your web site or application, when you enable a Read-a-Card Web Server.
  • Page 26 ComPort... settings included in your config.txt file and adjust them, if needed, to match the example below. Save the updated config.txt file, then reboot the VTAP reader, by briefly removing power. The VTAP reader needs its virtual COM port enabled to work with Read-a-Card. CONFIGURATION GUIDE © DOT ORIGIN PAGE 23...
  • Page 27 The VTAP reader is recognised by Read-a-Card software as a proprietary reader, 'VTAP Mobile Pass Reader' type on the Reader Type tab. This gives you an expanded facility to check and manipulate data stored in passes, tags or cards. CONFIGURATION GUIDE © DOT ORIGIN PAGE 24...

  • Page 28: More Advanced Features

    COM port in passive mode. They can request particular data, direct data to be sent over another interface, alter configuration of the VTAP reader, lock or unlock the device with a password, or drive the user feedback LEDs [VTAP100 or VTAP50 v2 only] and buzzer.

  • Page 29: Maintenance Features

    Smart Tap passes. Helps you check whether you have uploaded the necessary ECC private keys, which can be unclear as the files are deleted when they are uploaded. These two examples show how to read this information: CONFIGURATION GUIDE © DOT ORIGIN PAGE 26...

  • Page 30: Update Firmware

    BOOT.TXT or use the ?b command over a serial interface.) Note: Configuration is exactly the same for VTAP50 and VTAP100, but the firmware files are specific to the type and version of VTAP reader and not interchangeable.

  • Page 31: Software Lock To Prevent Local Firmware Or Configuration Change

    Windows cache on remount, reboot or power cycle. When you need to remove the software lock: 1. Place another text file called lock.txt on to the VTAP reader mass storage device containing the unlock command. CONFIGURATION GUIDE © DOT ORIGIN PAGE 28...

  • Page 32: Hardware Lock To Disable Usb Mass Storage Device

    COM port will behave as a composite USB device consisting of HID keyboard and USB virtual COM port.) Note: On VTAP50 OEM modules, although the contact is present, connector pins and jumpers will need to be supplied.

  • Page 33: Hardware Reset To Use Factory Firmware

    If your VTAP reader board has a daughter board on top, as is the case for a VTAP50 and VTAP100, you will need to lift the daughter board off, to reach these jumpers. When you start the VTAP reader, the presence of this jumper means the connected PC will not detect a USB mass storage device, only a keyboard (or keyboard and virtual COM port).

  • Page 34: Reboot, Remount, Refresh Commands

    VTAP reader, but if you use the remount command, Windows will re-read all of the files. Refresh will force the VTAP reader to re-read config.txt. This is needed if you have renamed a file to be config.txt, as renaming is not otherwise noticed. CONFIGURATION GUIDE © DOT ORIGIN PAGE 31...

  • Page 35: A  Default Config.txt File

    Config.txt variations for other VTAP models: VTAP100-USB-SQ is the almost the same, but with LEDSelect=2. VTAP50 models will have LEDSelect=3 to control both external and on-board serial LEDs by default. Note: Since firmware version v1.1.9.1 all serial communications interfaces are enabled by default, to ensure that serial communications are always possible even if the configuration file config.txt is missing or damaged.
  • Page 36 Note: Since firmware version v1.1.9.1 all serial communications interfaces are enabled by default, to ensure that serial communications are always possible even if the configuration file config.txt is missing or damaged. To take advantage of this, remove the line ComPortEnable=0. CONFIGURATION GUIDE : APPENDIX © DOT ORIGIN PAGE A-2...
  • Page 37 Serial2Settings=115200,n,8,1 BTKeyboardMode=1 Note: It is possible to ‘break’ the VTAP50 and VTAP100 if an incorrect config.txt or file is uploaded, for instance switching off Cloud mode when the reader is intended to work through VTAP Cloud. Contact vtap-support@dotorigin.com if you need Dot Origin to help recover your device.

  • Page 38: B  Default Leds.ini File [Vtap50 V2 Only

    Copy and paste the text from the blue box to a file called leds.ini. Put that file on to a VTAP50 with serial LED chain, then amend the file to suit your own LED signalling preferences. (You will then need to add the line such as LEDDefaultRGB=FFFFFF:seq.comet@leds.ini in config.txt to call the sequence...
  • Page 39 ; this generic section is used. Any entries with name "rgb" will receive the ; colour of the original RGB value. ; Note: the rgb field does not need to exist. ; Note: Other fields can specify different colours for other LEDs. [leds.rgb] rgb=1,3,5 00ff00=9   ; Sequence sections always start with "seq." and supply a sequence of frames ; that specify the LED pattern and how long it is shown for. Each frame must ; have the key name "frame". Frames are shown in the order they are ; specified in this file. The duration is in milliseconds. The pattern ; references a section in the same file. Ideally the section should start ; with "[leds." to indicate it is a pattern specification, but this is not ; enforced. ; Note if the pattern section doesn't exist, the LEDs will be switched off ; for the duration of the frame. ; The number of frames is only limited by available RAM. ; The "repeat" key specifies how many times to repeat the sequence ; (currently limited to 255 repeats). If the "repeat" entry is not given, ; the sequence is shown once. A value of "forever" or "0" for the repeat ; entry will show the sequence continuously (until another sequence is ; started). [seq.flash_red] repeat=3 frame=500,leds.red frame=500,leds.off   [seq.flash_red_forever] repeat=forever frame=500,leds.red CONFIGURATION GUIDE : APPENDIX © DOT ORIGIN PAGE B-2...
  • Page 40 100000=4 200000=5  300000=6 400000=7   [leds.comet5] 100000=5 200000=6  300000=7 400000=8   [leds.comet6] 100000=6 200000=7  300000=8 400000=9   [leds.comet7] 100000=7 200000=8  300000=9 400000=10   [leds.comet8] 100000=8 200000=9  300000=10 400000=11   [leds.comet9] 100000=9 CONFIGURATION GUIDE : APPENDIX © DOT ORIGIN PAGE B-3...
  • Page 41   [leds.comet13] 100000=13 200000=14  300000=15 400000=16   [leds.comet14] 100000=14 200000=15  300000=16 400000=17   [leds.comet15] 100000=15 200000=16  300000=17 400000=18   [leds.comet16] 100000=16 200000=17  300000=18 400000=19   [leds.comet17] 100000=17 200000=18  300000=19 400000=20   CONFIGURATION GUIDE : APPENDIX © DOT ORIGIN PAGE B-4...
  • Page 42 100000=23 050000=24   [leds.comet22] 100000=22 200000=23  300000=24 400000=1   [leds.comet23] 100000=23 200000=24  300000=1 400000=2   [leds.comet24] 100000=24 200000=1  300000=2 400000=3   [seq.comet] repeat=forever frame=100,leds.comet1 frame=100,leds.comet2 frame=100,leds.comet3 frame=100,leds.comet4 frame=100,leds.comet5 frame=100,leds.comet6 frame=100,leds.comet7 frame=100,leds.comet8 CONFIGURATION GUIDE : APPENDIX © DOT ORIGIN PAGE B-5...
  • Page 43 VTAP MOBILE WALLET READERS frame=100,leds.comet9 frame=100,leds.comet10 frame=100,leds.comet11 frame=100,leds.comet12 frame=100,leds.comet13 frame=100,leds.comet14 frame=100,leds.comet15 frame=100,leds.comet16 frame=100,leds.comet17 frame=100,leds.comet18 frame=100,leds.comet19 frame=100,leds.comet20 frame=100,leds.comet21 frame=100,leds.comet22 frame=100,leds.comet23 frame=100,leds.comet24 CONFIGURATION GUIDE : APPENDIX © DOT ORIGIN PAGE B-6...

This manual is also suitable for:

Vtap100

Table of Contents