CYPRES WDG-6112 User manual

Page 1
OSDP-Wiegand
USB Data Wedge
WDG-6112
Product Manual
Cypress Integration Solutions 40 Years of Access Control Ingenuity CypressIntegration.com
©2023 Cypress Computer Systems 1778 Imlay City Road, Lapeer, MI 48446 800-807-2977
Firmware version 1.04!
WDG-6112_Manual_230615
Product Overview
The WDG-6112 connects a computer via USB-C to an OSDP or Wiegand credential reader. Once
the reader reads a credential, the credential data is sent to the WDG-6112. Then, data is output to
the computer as keystrokes. This can be used to interact with computer applications such as
spreadsheet or text programs. !
Applications
•Create credential databases during site takeovers!
•Use with an RFID reader to create an enrollment reader solution!
•Troubleshoot readers/credential output in the field

Page 2
•USB-C connection to computer!
•Includes 1 meter (~39 in.) USB-C extension cable (female to male)!
•Supports OSDP and Wiegand credential readers!
•+5 VDC output for powering credential readers!
•Default configuration processes any credential format, outputs number of bits and raw
credential data in hexadecimal!
•Custom configuration allows processing of up to 10 credential formats simultaneously
Specifications
Part Number
Part Number
WDG-6112
UPC
816684006135
Physical
Physical Dimensions (L x W x H)
2.675 x 1.04 x 0.636 inches | 6.80 x 2.64 x 1.62 cm
Weight
WDG-6112
1 oz. | 28.35 grams
USB-C Cable
1.2 oz. | 34.02 grams
Environmental
Operating Temperature Range
32ºF to 185ºF | 0ºC to 85ºC
Enclosure Rating
Not rated for water or dust intrusion. Circuit board is set in
epoxy resin.
USB
Features male USB-C port and can connect directly to computer
Supports USB 2.0
Appears as a USB keyboard during normal operation
Appears as USB Mass Storage Device when in configuration mode
Electrical
Powered by USB-C connection
Power draw from USB-C Port
5 VDC @ 50 mA max
Power output (for credential readers)
5 VDC @ 450 mA max
Wiegand Input Signal Voltage Rating
0-24 VDC
Additional
Features
Includes 1 meter (~39 in.) USB-C extension cable (female to male)
Supports OSDP and Wiegand credential readers
Automatically discovers connected OSDP reader’s device address and baud rate for simple setup
Removable 6-position screw terminal block for credential reader connection
Simple custom configuration method (see CypressIntegration.com)
Configuration allows processing of up to 10 different credential formats simultaneously
Configuration allows specifying multiple fields for credential data (typically facility code and card
number values). Additionally, keypresses of any key before, between, and after the multiple data
fields can be added.
WDG-6112 Manual - Features and Specification

Page 3
WDG-6112 Manual - Table of Contents
Table of Contents
Topic
Page
Overview and Specifications
1-2
Approximate Dimensions & Status LED
4
Reader Connection Diagrams
5
Connecting RFID Readers
6
General OSDP Information / Capabilities
7
OSDP Initialization Sequence
8
Test Mode
9
Troubleshooting
10
Checking Computer Connection
11-12
Known Issues
13
Default Configuration / Badge Peeler Mode
14
Configuration Mode
15
Configuration Tool Overview
16
Configuration Tool: Output Configuration
17-22
Configuration Tool: OSDP Options
23-24
Badge Peeler Mode Configuration
25-26
Creating a Configuration
27-33
Calculate Number of Fixed Characters
34-35
OSDP Terminology
36-37

Page 4
WDG-6112 Manual - Approximate Dimensions & Status LED
Normal & Test Mode
LED State
Description
Solid Red
WDG-6112 is powered on via the USB-C
interface
Flashing Red
WDG-6112 is communicating with an OSDP
reader
Solid Green
WDG-6112 has received credential data & is
sending the data to the connected computer
The WDG-6112 has a bi-color red and green Status LED. The LED states and descriptions are
listed in Table 1 below.
2.675 in.
1.04 in.
6 position removable
terminal block for credential
reader connection
USB-C male
plug for
computer
connection
0.636 in.
Height
Status
LED
Table 1: WDG-6112 LED States

Page 5
WDG-6112 Manual - Reader Connection Diagrams
WDG-6112 and OSDP Reader Diagram
WDG-6112 and Wiegand Reader Diagram
Computer
Wiegand
Reader
Computer
OSDP
Reader

Page 6
WDG-6112 Manual - Connecting RFID Readers
The WDG-6112 supports both Wiegand and OSDP RFID readers. In general, the RFID reader data
interface, power input, and ground are connected to the 6-pin header on the WDG-6112. The
WDG-6112 supplies 5 VDC and a maximum of 450 mA* to power the reader. The power supplied
to the reader is via the USB port. !
*Note: Some USB ports may be incapable of outputting the full 450 mA. !
Connecting a Wiegand Reader
Connect the reader’s Data 0, Data 1, Ground, and Power Input lines to appropriate pins on the 6-
pin header. The WDG-6112 status LED will be solid red whether or not a Wiegand reader is
connected. When credential data from the Wiegand reader is received and processed by the
WDG-6112, the status LED will flash green once. !
Connecting an OSDP Reader
Connect both the reader’s data lines (OSDP+ and OSDP—) , Power Input, and Ground to the
appropriate pins on the 6-pin header. The WDG-6112 acts as an OSDP ACU (Access Control Unit),
polling the OSDP reader (PD - Peripheral Device). The WDG-6112 automatically finds the OSDP
reader by cycling through baud rates, attempting to establish an unencrypted communication
session using the broadcast address. When the WDG-6112 is communicating with the OSDP
reader, the status LED will flash red. When the OSDP reader sends credential data to the
WDG-6112, the status LED will flash green once. !
Connecting Two Readers
Both a Wiegand and OSDP reader can be connected to the WDG-6112 at the same time. In the
event that both readers send credential data to the WDG-6112 simultaneously, the OSDP reader is
prioritized. The credential data from the OSDP reader is output to the computer, and the credential
data from the Wiegand reader is discarded. Only one OSDP reader can be connected to the
WDG-6112 at a time.

Page 7
WDG-6112 Manual - General ODSP Information / Capabilities
The WDG-6112 is an OSDP ACU (Access Control Unit) that will control the OSDP reader/PD
(Peripheral Device). The capabilities of the WDG-6112 as an ACU are detailed below. !
Supported Communication Baud Rates
9600!
19200!
38400!
57600!
115200!
230400!
Supported Device Addresses
Device address 0-126 (0x00 - 0x7E) are supported. The Broadcast Address 127 (0x7F) is
supported and used to discover the OSDP reader’s devices address. !
Supported OSDP Commands and Replies
As an ACU, the WDG-6112 will send commands to and receive replies from the OSDP reader (PD).
Because the functionality of the WDG-6112 is limited in scope compared to a full OSDP access
controller, it only sends the commands and processes replies shown in Table 2 below.
Commands
Replies
osdp_POLL
osdp_RAW
osdp_ID
osdp_KEYPAD
osdp_COMSET
osdp_NAK
osdp_CHLNG
osdp_CCRYPT
osdp_SCRYPT
osdp_RMAC_I
osdp_KEYSET
osdp_BUZZ
osdp_LED
Table 2: WDG-6112 OSDP commands & replies
Other replies that are not listed above will not be processed, meaning that the WDG-6112 will not
take any action based on those replies. The OSDP communication will not be interrupted.
Examples of common replies that are not processed are osdp_ISTATR, osdp_OSTATR, and
osdp_LSTATR. These replies report the status of the OSDP reader’s inputs, outputs, and tamper
status.

Page 8
WDG-6112 Manual - OSDP Initialization Sequence
When establishing communication with an OSDP reader, the WDG-6112 performs the sequence
outlined in the steps below. !
1. The WDG-6112 sends the osdp_POLL command on device address 0 at 9600 baud. !
2. Step 1 will be attempted 8 times. If a device is found, proceed to step 7. !
3. If no device is found, the WDG-6112 will send the osdp_ID command on device address 127
(0x7F, broadcast) at 9600 baud.!
4. If no device is found, the WDG-6112 will send the osdp_ID command on on device address
127 (0x7F, broadcast), cycling through all supported baud rates (9600, 19200, 57600, 115200,
and 230400). !
5. Step 4 is repeated until a device is found. !
6. When a device is found, the osdp_COMSET command is set to the device to set its device
address to 0 and the baud rate to 9600.!
7. If Secure Channel communication is not enabled, skip to step 10.!
8. If Secure Channel communication is enabled, the WDG-6112 will attempt to establish a SCS.
The osdp_CHLNG and osdp_SCRYPT commands are sent to the device, using the SCBK_D
value specified in the OSDP Configuration file.!
9. If a new key (SCBK) is required, the WDG-6112 sends the osdp_KEYSET command to the
device. This sets the device’s SCBK to the value specified in the OSDP Configuration file.!
10. An unencrypted or SCS has been established between the WDG-6112 and the OSDP reader.
The WDG-6112 sends the osdp_POLL command to the reader until credential data is received
in the form of the osdp_RAW or osdp_KEYPAD replies. !
Note: The WDG-6112 uses the OSDP device address and baud rate set in the OSDP config file. By
default, it uses device address 0 and 9600 baud.

Page 9
WDG-6112 Manual - Test Mode
Test Mode is used to verify the WDG-6112 is communicating with the computer. While in Test
Mode, the WDG-6112 outputs a test string (see Figure 1). Afterwards, the WDG-6112 enters
normal operation.
Using Test Mode
1. Before powering on the WDG-6112, connect the Data 0 line to Ground.!
2. On the computer, open a text editor, such as Notepad (Windows) or TextEdit (Mac).!
3. Plug in the WDG-6112 to the computer. It will appear on the computer as a USB keyboard.!
4. The test string will appear if the WDG-6112 is communicating with the computer.!
5. Disconnect the WDG-6112 from the computer (powering the device down). !
6. Remove the jumper wire connecting Data 0 to Ground.!
7. Reconnect the WDG-6112 to the computer. The WDG-6112 will perform its normal operations.!
Figure 2 below shows the WDG-6112 with a jumper between Data 0 and Ground; this wiring
scheme puts the WDG-6112 into Test Mode.
Figure 1: WDG-6112 Test Mode output
Figure 2: WDG-6112 Test Mode wiring

Page 10
If the WDG-6112 is not outputting data as anticipated, please follow the steps below:!
1. Communication: Verify the WDG-6112 is communicating with the computer using Test Mode
(see pg. 9).!
2. Power: If powering a Wiegand reader separately from the WDG-6112, ensure there is a
common ground between the reader and the WDG-6112. A common ground is not required for
an OSDP reader.!
3. Inverted Data Lines: Flip/reverse the reader data lines. !
A. Wiegand reader: Look for garbage data.!
B. OSDP reader: Will not communicate with the WDG-6112.!
4. Voltage (Wiegand Reader): Use a multi-meter to check that the Data 0 and Data 1 lines are at
5 VDC (or the typical idle voltage if using a Wiegand reader that operates at a higher voltage).!
A. Measure the DC voltage between Data 0 and Ground. Then, measure the DC voltage
between Data 1 and Ground.!
B. If the voltage levels of one or both data lines are at or below 4.5 VDC, then disconnect
the Wiegand reader from the WDG-6112. The Data 0 and Data 1 lines on the WDG-6112
should read 0 VDC while no Wiegand reader is connected.!
C. If the voltage levels of one or both of the data lines are at or below 4.5 VDC (while not
connected to the WDG-6112), then the Wiegand reader likely needs external pull-up
resistors. Connect a 1K to 2K through-hole resistor to the data line(s) and the +5V line.
The data line(s) should now be pulled up to 5 VDC.!
D. If the voltage level for a Wiegand data line is below 1 VDC, then the line is clamped to
ground and cannot be recovered.!
5. Configuration: Verify the configuration is correct.!
A. Apply the Output Configuration file to the WDG-6112 again (see pg. 15).!
B. Apply the OSDP Configuration file again (see pg. 15).!
C. Re-create the configuration file to ensure the parameters are correct.!
6. OSDP: Verify the OSDP reader connection.!
A. Check the OSDP reader’s device address and baud rate. The WDG-6112 should set
these parameters; however, some readers may not apply the osdp_COMSET parameters
because the readers may not support specific values. Verify the reader supports
osdp_COMSET, and select values within the supported range. !
B. If using Secure Channel, check that the WDG-6112’s SCBK_D matches the reader’s
SCBK_D.
WDG-6112 Manual - Troubleshooting

Page 11
WDG-6112 Manual - Checking Computer Connection
This section shows how the WDG-6112 appears on Windows 10, Windows 11, and macOS
Ventura.!
Windows 10 - The WDG-6112 can be found in the Settings menu and the Control Panel.
Alternatively, the WDG-6112
can be found in the Control
Panel. From the Control Panel
menu, click on “Devices and
Printers”. The WDG-6112 will
be listed in the “Devices”
section as shown in Figure 4.
In the Settings menu, click on
“Devices” and then “Bluetooth
& other devices”. The
WDG-6112 will be listed in the
“Mouse, keyboard, & pen”
section as shown in Figure 3.
Figure 3: WDG-6112 appears as USB keyboard
Figure 4: WDG-6112 appears as USB keyboard

Page 12
WDG-6112 Manual - Checking Computer Connection (Cont.)
Windows 11 - The WDG-6112 can be found in the Settings menu.
macOS Ventura 13.4 - The WDG-6112 can be found in the System Report.
In the Settings menu, click on
“View more devices”. The
WDG-6112 will be in the Input
section as a keyboard, as
shown in Figure 5.
Open the Apple menu, click on
“About this Mac”. In the new
window, click on “System
Report”. In the Hardware
sidebar menu, click on “USB”.
The WDG-6112 will be found on
one of the USB busses, as
shown in Figure 6. The System
Report gives specific
information about the
WDG-6112. This includes the
serial number, firmware version,
and manufacturer. Cypress
Computer Systems is Cypress
Integration Solutions.
Figure 5: WDG-6112 appears as USB keyboard
Figure 6: WDG-6112 appears as USB keyboard

Page 13
WDG-6112 Manual - Known Issues
This section notes minor known issues with the WDG-6112 firmware version 1.04.!
Windows
It may take 30 or more seconds for a Windows computer to recognize the WDG-6112 when it is in
Configuration Mode.!
Mac
When using a USB extension cable, the WDG-6112 can only be plugged into the cable in one
orientation. If the WDG-6112 is not recognized by the Mac, try plugging the WDG-6112 into the
extension cable in the opposite orientation.

Page 14
WDG-6112 Manual - Default Configuration / Badge Peeler Mode
From the factory, the WDG-6112 units use the Badge Peeler Mode configuration. Badge Peeler
Mode outputs the bit length and raw data of any credential; this makes it useful for troubleshooting
readers or verifying unknown credential data. When credential data is received, the WDG-6112 will
output two fields. The first field is the number of bits in decimal. An “=“ is used as a field separator
between the first and second fields. The second field is the credential data in hexadecimal. The
second field’s number of characters is variable based on the number of bits received from the
reader. After the second field, the Enter key is pressed.!
<credential length>=<credential data><enter key>
Field 1 - <credential length> (variable length in decimal)
Field Separator - “=“
Field 2 - <credential data> (variable length in hexadecimal)
Suffix Character - <enter key>
26-Bit Credential Example
Facility Code = 1 (dec) = 01 (hex) = 00000001 (binary)
Card Number = 84 (dec) = 0054 (hex) = 0000000001010100 (binary)
Bit Number - 01234567890123456789012345
Raw Bit Stream - 10000000100000000010101000
Bit Designation - PFFFFFFFFCCCCCCCCCCCCCCCCP
10 0000 0010 0000 0000 1010 1000 = 20200A8 (hex)
1 00000001 0000000001010100 0
P FFFFFFFF CCCCCCCCCCCCCCCC P
P = Parity Bit
F = Facility Code
C = Card Number
WDG-6112 Output: 26=20200A8
For information on configuring the WDG-6112 into Badge Peeler Mode, creating custom Badge
Peeler configurations, and using Badge Peeler Mode with user configurations see the Badge Peeler
Configuration section (see pg. 25).

Page 15
WDG-6112 Manual - Configuration Mode
Configuration Mode is used to upload configuration files created with the Configuration Tool to the
WDG-6112. While in Configuration Mode, the WDG-6112 will not accept or output credential data
from a Wiegand reader, or communicate with an OSDP reader.!
Configuration Mode is used to upload both Output Configuration and OSDP Configuration files.
Both types of configuration files can be loaded onto the WDG-6112 at the same time. !
Uploading a Configuration File
1. Before powering on the WDG-6112, connect the Data 1 line to Ground. !
2. Plug in the WDG-6112 to the computer. It will appear on the computer as a USB mass storage
device*.!
3. Drag and drop the WDG-6112 configuration file onto the WDG-6112 drive. Do NOT load other
files onto the WDG-6112 while in Configuration Mode. !
4. Once the configuration file is loaded onto the WDG-6112, unmount the WDG-6112.!
5. Disconnect the WDG-6112 from the computer (powering the device down). !
6. Remove the jumper wire connecting Data 1 to Ground.!
7. Reconnect the WDG-6112 to the computer. The new configuration is now applied. !
*Note: On Windows computers, the WDG-6112 will appear in File Explorer as “USB Drive (D:)”. The
drive letter may change based on other drives connected to the Windows computer. On Mac
computers, the WDG-6112 appears as “WDG-6112” in Finder. !
The configuration file is deleted from the WDG-6112 after it is applied. It is recommended to always
keep a copy of the configuration file for future use. !
Figure 7 below shows the WDG-6112 with a jumper between Data 1 and Ground; this wiring
scheme puts the WDG-6112 into Configuration Mode.
Figure 7: WDG-6112 Configuration Mode wiring

Page 16
WDG-6112 Manual - Configuration Tool Overview
The Configuration Tool allows users to create configuration files for the WDG-6112, and upload
them to it. This tool is an HTML file and is accessible in a web browser (e.g., Chrome, Firefox, or
Safari) on the WDG-6112 product page. The Configuration Tool can also be downloaded through a
web browser as an HTML file for use offline. !
The Configuration Tool is divided into two sections: Output Configuration and OSDP options.!
Output Configuration Features
•Specify multiple credential formats for processing.!
•Specify any credential format, and define multiple data fields (typically facility code and card
number). !
•Specify credential data output as decimal or hexadecimal.!
•Specify a fixed number of characters/digits output for each field, or make the number of
characters/digits for a field dynamic based on the size of the data. !
•Specify keypresses sent before, between, and after the two data fields. !
•Create, name, and download configuration files. !
OSDP Configuration Features
•Specify the OSDP reader’s device address. This is the device address the WDG-6112 will poll
when connected to an OSDP reader.!
•Specify the OSDP reader’s baud rate. This is the baud rate the WDG-6112 will use to
communicate with the OSDP reader.!
•Enable automatic I/O behavior on the OSDP Reader when a credential is received: beep-on-
read and blink-on-read (LED).!
•Enable Secure Channel communication with the OSDP reader. !
•Specify the Default Secure Channel Base Key (SCBK_D) and Secure Channel Base Key (SCBK).!
•Create, name, and download OSDP configuration files.

Page 17
The Output Configuration section creates badge format templates. Expected badges are then
parsed and output into the given human-readable format. Figure 8 below illustrates this section. !
In this section, there are six sub-sections: Badge Fields, New Badge Field, Badge Representation,
Output List, Output Formats, and Create Configuration.!
The Configuration Tool version number is displayed in the top right corner of the window.
WDG-6112 Manual - Configuration Tool: Output Configuration
Badge Fields
New Badge Field
Badge
Representation
Output
Formats
Create
Configuration
Output
String
Version Number
Figure 8: Configuration Tool overview

Page 18
WDG-6112 Manual - Configuration Tool: Output Configuration (Cont.)
Badge Fields
The Badge Field section shows a breakdown of each badge format. Badge fields allow the
WDG-6112 to pick out specific pieces or data fields of a badge. For example, a standard 26-bit
badge has two parity bits, one facility code field, and one card number field. As seen in Figure 9
below, standard 26-bit badges have two data fields. Up to five badge fields can be specified, and
their bits can overlap. Badge fields can be removed from the configuration via the “Remove Field”
button.
New Badge Fields
Badge fields can be added to the configuration via the “New Badge Field” input form. Below,
Figure 10 shows this input form.
Type - Designates how the badge field’s data is encoded when output to the computer. The data
can be encoded as either decimal or hexadecimal by selecting the desired encoding. !
Start Bit - Designates which bit this badge field begins.* The start bit begins counting at bit 0.!
Field Length - Designates how many bits are in this badge field.*!
*Note: Any unassigned bits are not included in the output.
Figure 9: Default 26-bit Badge Fields
Figure 10: New Badge Field section

Page 19
WDG-6112 Manual - Configuration Tool: Output Configuration (Cont.)
Fixed Characters - Forces a Badge Field to be output as the specified number of characters in the
“Fixed Characters” field; the Badge Field is zero-padded to match the required number of
characters. Specifying a value of zero will result in a dynamic output; the number of output
characters vary based upon the credential data received. Below is an example:!
26-Bit Credential with Fixed Characters
Field 0 (Facility Code): 4 fixed characters
Field 1 (Card Number): 6 fixed characters
WDG-6112 Output: 26=0001-000084
26-Bit Credential with Dynamic Characters
Field 0 (Facility Code): 0 fixed characters
Field 1 (Card Number): 0 fixed characters
WDG-6112 Output: 26=1-84
Badge Representation
The Badge Representation section shows a breakdown of each selected Badge Field. Badge
lengths determine which output format the WDG-6112 applies when it receives a card read. For
example, when 26-bit credential data is received from the reader, if a 26-bit output format is
specified by the current configuration, the data will be output according to the configuration. If a
26-bit output format is not specified, the credential data is ignored. Below, Figure 11 shows the
default 26-bit badge representation. !
The number of bits are specified in the Badge Length field, matching the length of the credential
format. The Bits diagram shows the full number of bits, each bit is numbered. Each Badge Field is
shown in red below the Bits diagram, aligned based on the starting bit value. Each bit in the Badge
Field diagrams contain the text “Dec” or “Hex” to indicate how the field is encoded. !
The WDG-6112 supports credential lengths of up to 256 bits.
Figure 11: Badge Representation section

Page 20
WDG-6112 Manual - Configuration Tool: Output Configuration (Cont.)
Output String
The Output String section allows users to specify the order of keypresses and Badge Fields output
in sequence when the WDG-6112 receives credential data matching the bit length of one of the
Output Formats. Figure 12 below shows this section.!
Keys - A list of all keys on a US keyboard. Selecting a key and clicking the “+” button below the list
will add the key to the Output List. Multiple keys can be added to the list. Capital letters, symbols,
and other special keys are a combination of standard and function keys. To add a special key,
check the appropriate function key. Then, select the standard key under the Keys list. Finally, click
the “+” button below the Keys list. The checked function key will stay checked after adding the
standard key to the list, if it is no longer required it needs to be unchecked. The supported function
keys are “Shift”, “Control”, “Alt”, and the Windows or CMD (depending on the operating system
being used). !
For example, an “!” can be added by following these steps. Click the “Shift” function key
checkbox. Then, select the “1” key from the Keys list. Next, click the “+” button under the keys list.
Now, “Shift+1” will appear in the Output List, and the WDG-6112 will output the “!” character. !
Badge Fields - A list of all created Badge Fields will appear here, along with the “LengthDecimal”
and “LengthHex” options. Selecting any of these options and clicking the “+” button below the
Badge Fields list will add the field to the Output List. The selected Badge Field data will be output
by the WDG-6112. The length options will output the number of bits received by the WDG-6112,
either in decimal or hexadecimal depending on the option selected. This feature can be used to
identify the credential format or length in the WDG-6112 output. !
Output List - A list of all selected keys and Badge Fields listed in output order. The items in this list
are output from top to bottom. Selecting an item in the list and clicking the “-“ button will remove it
from the list. !
Click on the Output List to select it. While selected, pressing any key on the keyboard will add it to
the Output List. Pressing a function key will automatically check or uncheck that function key’s
checkbox.
Figure 12: Output String section