Cypress Wedge Programming String Generator
Cypress' WDG family of products offer user-programming via their builtin RS-232 interface. However, unless the user is very familiar with the language, programming these devices can be confusing. This tool will generate programming strings for the WDG command language based on the parameters below.
To begin, input the credential information using the sliders or their corresponding number inputs. Changes in one input will be reflected in the others. Bit formats are specified with the most significant bit (labeled bit 0) on the left. Two bit formats can be specified by selecting the checkbox below, but they must be different lengths.
The output formatting settings can be modified using the combination boxes at the bottom of the page. A complete list of the keyboard signals the wedge can generate can be found in the box labeled "Available Keys". Select one or more keys from this box, and click the plus button underneath any of the other boxes. This will add the selected keys to that field. Check the "Shift +" checkbox under the Available keys box to access capital letters and symbols. The "Header" field is typed before the Facility Code, "Middle" is typed between the Facility Code and Badge ID, and "Trailer" is typed after the Badge ID. Please note that the wedgie has only been tested with an English locale, and the actual results of these keys may vary.
Finally, the number inputs labeled "Facility Code Output", and "Badge ID Output" control the number of characters typed for each respective field, and in what radix they are typed. This tool will suggest the minimum field lengths based on the bit formats specified. If the output lengths specified are smaller than the calculated minimum, not all of the field's data will be typed. Click the generate button to create the settings using the specified parameters. The settings will be displayed at the bottom of the page, and a file containing these settings will be created. Save this file if your serial terminal emulator supports sending line-delayed files, or if you want to save the settings for later use.
To program a wedge with these settings, connect the Jumper J4 on the wedge PCB (you will need to take the case apart). This will cause the wedge to load its default settings when it powers up. Connect the wedge's serial port to a serial port on your computer (or to a USB to RS-232 adapter), using a null-modem DB-9 cable. Start a terminal emulator, and connect it to that serial port using 9600 baud, 8 data bits, 1 stop bit, no parity, and no hardware flow control. The wedge programming interface is best viewed using a VT-100 (ANSI) terminal emulator, with echo on.
Power the wedge by connecting it to a USB port on your computer. The terminal should display a declaration of the wedge's part and version numbers. To enter programming mode, quickly send several plus signs. The wedge will announce when it has entered programming mode. At this point, the configuration settings can be sent line-by-line to the wedge. If you are using a terminal emulator capable of sending files with a line delay, send the file now. Otherwise, copy and paste each line from the list of configuration settings into the terminal. The wedge will indicate that a setting has been accepted with two right angle brackets (>>). To view the input settings, type backslash r (\r). To view the output settings, type backslash s (\s). When you have finished programming, you may disconnect the wedge from the serial port, and from the USB. Remove the jumper J4 to preserve the settings.
We recommend using the RealTerm utility to program a wedge using the Windows operating system. This utility includes a line-delayed file transfer feature that works well with the text file this tool generates. To use RealTerm with the wedge, run the program. In the "Display" tab, set "Display as" to "Ansi". In the "Port" tab, set "Baud" to 9600, and select the appropriate serial port from the "Port" drop down. Click the "Change" button to apply the settings. To send the settings file, open the "Send" tab. Select the settings file by clicking the "..." button in the "Dump File to Port" area. Set the second "Delay" value (delay between lines) to 200, and click the "Send File" button.
On Unix-like operating systems such as Mac OS or Linux, we recommend using the GNU Screen command line utility, which is available pre-installed on many systems. Users attempting to use screen should be aware that screen does not appear to support local echo when connecting to TTYs, nor does it support line-delayed file transfer. To use screen as a serial terminal emulator, open a terminal and type
at the prompt. To exit screen gracefully, type control+a, then k, then y.
screen /dev/tty.<serial port name>
I need to use two different Wiegand formats