Logo

Configuration Tool

External Devices Tab:

Security Device

KioWare has the capability to have a security mat or proximity switch start and stop a users session.  The use of a security device takes precedence (ie, overrides) the Inactivity Timer and Timeout/Warning settings on the Attract/Inactivity page.

Enable Security Devices

If checked, a security device will be used to initiate user session start and stop.  The use of a security device takes precedence (ie, overrides) the Inactivity Timer and Timeout/Warning settings on the Attract/Inactivity page.

Security Device

Used to select the type of security device attached to the computer.  If your device is not listed, then contact KioWare Support for more information.

Device COM Port

For serial devices (not USB), enter the COM port assigned to the device.  If unknown, this information can be found by opening Windows Device Manager.  To find the Device Manager open the Windows Control Panel, click the System icon, click the hardware tab, then click the Device Manager button.

Test Security Device

If the device is attached to the computer, the above settings can be tested by clicking this button.

Device Sensitivity

Some devices support another option called sensitivity.  If the device does not support it, this control will be disabled.


Input Devices

KioWare has the capability to read an input device such as a barcode scanner, magnetic stripe reader, check reader or proximity reader and pass the data to a specified URL.

Input Devices

A list of all current input devices is displayed.

Remove Selection

To remove an input device from the list, select the device, then click the Remove Selection button.

Edit Selection

To edit an existing input device, select the device, then click the Edit Selection button.

Add New

To add a new input device, click the Add New button.  Note that the WIA device needs at least Windows XP to work.  Before XP, WIA did not exist.

Edit Input Device

Input Device

Select the type of input device attached to the computer.  For Symbol Barcode Scanners, select Symbol SSI Barcode Scanner if you are using a Symbol MiniScan xx04 scanner, otherwise select OPOS Barcode Scanner and enter the Profile Name below.

Profile Name

If required, the Profile Name is used by KioWare to specific which OPOS device setup to use.  For example, Symbol's driver installer creates profiles called STI_SCANNER and STI_USBSCANNER, but Metrologic's driver installer requires to you run a configuration program to create your own profile, as may other devices.  The name of the profile that you create to use must be entered in this box.  For Symbol's scanners, enter either STI_SCANNER or if using a USB scanner, then enter STI_USBSCANNER.

The Profile Name is also used to support monitoring a device from your web page.

Device COM Port

For serial devices (not USB), enter the COM port assigned to the device.  If unknown, this information can be found by opening Window's Device Manager.  To find the Device Manager open the Window's Control Panel, click the System icon, click the hardware tab, then click the Device Manager button.

Navigate Page Data via

What format to send the data:

  • Post Data - passes as form data.  This is the recommended way to pass data for two reasons:
    1. Data is not shown in the address bar.
    2. Data is not in browsing/stats history.
  • Get Data - passes as querystring.  Normally, passing by Get is just a bad idea, especially if users are swiping credit cards.

Refer to the KioWare Design Guide for more details.

Input Navigate URL

The URL to navigate to with the input data.

Refer to the KioWare Design Guide for more details on how the data is passed and subsequently accessed by the Input Navigate Page.

One way to test your input device is by setting the navigate URL to the page below:
Input Device Test Page
A text version of the page so that you can copy the source:
Input Device Test Page (Source)

Navigate URL Target

This is an optional parameter that is used when you are passing data to a window or frame name.  The list is prepopulated with two targets: _TOP and _BLANK; however, any valid window or frame name can be entered.

Credit Card Form Parse

With this feature, any major credit card can be configured in KioWare to auto populate a form on your page.

Text Field IDCard holders name HTML id.
Card Number Field IDCard number HTML id.
Card Type Mode Mode 1: DropDown with values (MasterCard=1, Visa=2, Amex=4, Discover=8, DinersClub=32).
Mode 2: DropDown with values (MasterCard=MC, Visa=VISA, Amex=AMEX, Discover=DISC).
Mode 3: DropDown with values (MasterCard=MC, Visa=VI, Amex=AM, Discover=DI, DinersClub=DC).
Card Type Field IDCard type (Discover, MasterCard, Visa...) HTML id.
Card Exp. Date Mode Mode 1: DropDown with values (Jan-Dec=1-12, 2008=2008).
Mode 2: DropDown with values (Jan-Dec=1-12, 2008=2,008).
Mode 3: DropDown with values (Jan-Dec=01-12, 2008=08).
Mode 4: DropDown with values (Jan-Dec=01-12, 2008=2008).
Card Exp. Month Field IDCard expiration month HTML id.
Card Exp. Year Field IDCard expiration year HTML id.
EnabledEnables and disables the feature.

Input Access

For security and application useability reasons, KioWare can control which domains and pages can accept data from an input device.

Access Type


No Restrictions

If selected, the KioWare will accept data from any domain without restriction.

Allow List

If selected, a list of domains to which KioWare will accept data; ie, a white list.

Deny List

If selected, a list of domains to which KiOWare will not accept data; ie, a black list.

Add Domain

Click this button to add a new domain entry to the domain list.

Add Page

Click this button to add a new page entry to the selected domain.  By default, pages added to a domain are defined as a revoke page list (ie, black list).  To change the page filter type, edit the domain.

Edit

To edit a domain, highlight the domain and click the Edit button.  You can change the domain name.  You can also change the page filter type.

To edit a page, highlight the page and click the Edit button.  The page will become editable.

Domain Rules

The domain you enter should not have a 'http://' preceding the name, and you can enter any portion of the domain name depending on how restrictive you wish to be.
For example:

  • Entering 'foo' will match 'www.foo.com', 'www2.foo.com', 'www.foo.net', 'www.foodeat.com'; ie, anything with a 'foo' in it.
  • Entering 'foo.com' will match 'www.foo.com', 'www2.foo.com' and 'www.twofoo.com', but won't match 'www2.foo.net'
  • Entering '.foo.com' will match 'www.foo.com', 'www2.foo.com' but won't match 'www.twofoo.com' or ' www2.foo.net'
  • Entering 'www.foo.com' will only match 'www.foo.com' and won't match 'www2.foo.com' or 'www.foo.net'
  • Entering '.com' will match 'www2.foo.com', 'www.foo.com' and 'www.twofoo.com', but won't match 'www2.foo.net'

Page Rules

The path/filename you enter should not have any domain information (ex, http://www.foo.com), and you can enter any portion of the path/filename depending on how restrictive you wish to be.
For example:

  • Entering 'foo' will match 'main/foo.html', 'product/foo.html', 'main/foo.asp', 'foo/default.asp'; ie, anything with a 'foo' in it.
  • Entering 'foo.html' will match 'main/foo.html' and 'product/foo.html'.
  • Entering 'ads/foo.html' will match 'english/ads/foo.html' and 'spanish/ads/foo.html', but not 'main/ads/foo.html'.
  • Entering '/ads/' will match any page in any directory that has '/ads/' in it path such as 'english/ads/active/ or 'spanish/ads/active/'.

Note: Pages that are part of a Revoke List will have a red X through their page icon.

Default Page

For circumstances where you wish to block or allow a page that is defined as a default document on the web server and therefore the URL may not have the page name included, we have a special page placeholder $$$Default$$$ that can be used to tell KioWare Browser that any URLs that don't have page information should be treated as a page list match.

Output Devices

Like input devices, KioWare supports what we call, output devices.  An example of such a device is a cash dispenser that divvies out cash.  They are set up in basically the same way as input devices.  Normally they require custom JavaScript programming in your pages to function, so there is no navigate URL like there is for input devices.  Examples of interacting with these devices is found here.

Device Specific Notes

This secion contains important notes on specific devices that have unusual settings.

Larco Security Devices (HID)

Larco HID security devices such as the Larco mat, act like a keyboard.  KioWare requires that the mat be configured to use the keys below in order to work.
Larco has a program called SonicGuard.exe that can be used to configure the proper keys.

Larco HID

Keyset 1:
Use Keyset 2 instead.  Some keyboard keys, such as the Windows key, cannot be blocked when using this keyset.
Walk-Away - Only RShft should be selected.
Walk-To - Only LShft should be selected.

Keyset 2 (recommended):
Walk-Away - LShift, RShift, LCTL, RCTL and F12 need selected.
Walk-To - LShift, RShift, LCTL, RCTL and F11 need selected.

Note: If using Keyset 2, you will not be able to press the test button in the Config Tool to test your device.  The device should work fine in KioWare though, as long as you've set up the keys properly.

Direct Show Web Cam

The web cam has many new settings that do not apply to other devices.

Also see Design Guide - Video Capture

Web Cam

Input DirectoryDirectory to save captured data to.
File Name TemplatePattern used to name each file.
%date% will be replaced with the current date in ISO standard format.
%time% will be replaced with the current time.
%index% will be replaced with an increasing number.
Bit Rate (bps)Video capture bit rate in bytes per second.  256,000 is about 256 kb.
BrightnessLevel to offset brightness.  0 uses the device default.
Video Width (px) and HeightMUST match a supported size of the video card.  Check the Windows application event log to see supported sizes dumped out by KioWare.
Also see Note at the bottom of this table.
Audio Device NameFill in with the audio device name from Control Panel - Sounds.
Video Sub TypeAdvanced.  This is used to specify the color format transferred from the device.  See your device manual for valid values.
Image FormatUsed when taking pictures with the camera.  Does not apply to video at all.
JPEG QualityThe JPG format gives highest compression for real life photos but throws out data to compress better.  This slider determines how much data you want to allow throwing out.
Image Width (px) and HeightUsed when taking pictures with the camera.  Does not apply to video at all.  Just like video, must match a supported size of the video card.
Also see Note at the bottom of this table.
Note: Even if you only only using video capture, both Video Width/Height and Image Width/Height need to have valid sizes because KioWare will validate both before doing either operation.
Drivers License OCRThis device type uses the ScanShell OCR scanner device to scan drivers license information to text format.
See ScanShell OCR on KioWare.com for very VERY important setup details and an example page.
WIA Scanner

The WIA scanner device shares settings with the web cam.  See above.

Also see Design Guide - Scanner Capture

WIA

See settings for the web cam above.  Also, a value of 0 means to use the devices default value, which varies among devices.

If KioWare will not scan this could mean that you have entered an invalid value for any one of the settings.  In this case you can check the Windows application event log and KioWare will usually list what the valid range is.  For instance, if you choose a resolution of 150 and set the max width/height values (by looking in the event log after running KioWare); if you then lower the resolution to 100, the width/height will be too high.

MEI Bill AcceptorMust be interacted with through JavaScript on your page.  See the Design Guide section for more information.
Magtek Serial Check ReaderFor this device to work at all in KioWare, you need to make sure that serial communication is set up as such:
Baud: 9600
Parity: None
StopBits: 1
ByteSize: 8
CTS: On
CommandSeperator: Carriage Return