Quality Kits QK108 Serial Isolated Input/Output Module

RSS

This driver controls 8 relay ouputs and 4 opto-isolated inputs on the following devices: Carl's Electronics (# CK1610), Ozitronics (# K108), QKits (# QK108), Quasar Electronics Limited (# 3108)

Manufacturer: Multiple Manufacturers (See Description)

Primary Communications Port: Serial

Table of Contents [Hide/Show]

Configuration Settings

Serial Port Name : The name of the serial port that the driver is connected to. Ex. COM1
Input Polling Interval : (optional) Interval time in milliseconds for inputs polling. Default value is 2000. Set to 0 to disable the polling.

Events

Input State Changed

Occurs when the state changes on an input.

Whenever Filter:

PropertyIndex : The index in the property's array. This is used for device properties that represent an array (or list) of values.

EventArgs:

Number Index : The index within the property array.
Number NewValue : The new property value.
Number PreviousValue : The previous property value.

Ready State Changed

The device's running and ready state changed.

Whenever Filter:

none

EventArgs:

Number NewValue : The new property value.
Number PreviousValue : The previous property value.

Instance Properties

OutputStates

Get the relay states.

Accessibility : Read Only

Type: Array

OutputNames

Get the relay names. The QK108 does not provide configurable names so they are predefined.

Accessibility : Read Only

Type: Array

InputStates

Get the input states.

Accessibility : Read Only

Type: Array

InputNames

Get the input names. The QK108 does not provide configurable names so they are predefined.

Accessibility : Read Only

Type: Array

Version

Get the QK108 version.

Accessibility : Read Only

Type: String

Connected

Gets a value indicating if a connection is established with the QK108.

Accessibility : Read Only

Type: Boolean

DeviceDisplayName

The display name for this device.

Accessibility : Read Only

Type: String

DeviceStartTime

The date and time when this device was started.

Accessibility : Read Only

Type: DateTime

DeviceLifecycleStage

The current lifecycle stage of the device. The stages in order are: Pending Start, Starting, Running, Stopping

Accessibility : Read Only

Type: Number

DeviceIsRunningAndReady

Indicates if the device is ready for use, ie it is in the Running lifecycle stage and all properties are valid and all methods are ready to be used.

Accessibility : Read Only

Type: Boolean

Instance Methods

TurnOnOutput ( Number )

Turn on the specified relay if it is not already on.

Syntax

void TurnOnOutput( Number relayNumber )

Parameters

relayNumber : Relay Number

TurnOffOutput ( Number )

Turn off the specified relay if it is not already off.

Syntax

void TurnOffOutput( Number relayNumber )

Parameters

relayNumber : Relay Number

ToggleOutput ( Number )

Toggle relay state. On to off or off to on.

Syntax

void ToggleOutput( Number relayNumber )

Parameters

relayNumber : Relay Number

RefreshAllRelayStates

Requests all the relay states from the QK108.

Syntax

void RefreshAllRelayStates( )

Parameters

none

RefreshAllInputStates

Requests all the input states from the QK108.

Syntax

void RefreshAllInputStates( )

Parameters

none

SetPropertyForDuration ( String, TimeSpan, Object, Object )

Sets a property for a duration of time and then sets the property to a subequent value asynchronously. This action returns after setting the first value and the timer and subsequent property set run in the background. Subsequent sets of the same property will reset the timer if the subsequent value has not yet been set. This is an advanced feature, be sure to set the property name correctly.

Syntax

void SetPropertyForDuration( String propertyName, unknown duration, Object initialValue, Object finalValue )

Parameters

propertyName : The name of the property to set.

duration : The amount of time to wait after setting the initial value to set the subsequent value.

initialValue : The value to set the property to initially.

finalValue : The value to set the property to after the duration of time has passed.

SetPropertyForDuration ( String, Number, TimeSpan, Object, Object )

void SetPropertyForDuration( String propertyName, Number arrayIndex, unknown duration, Object initialValue, Object finalValue )

Parameters

propertyName : The name of the property to set.

arrayIndex : The property's array index to set.

duration : The amount of time to wait after setting the initial value to set the subsequent value.

initialValue : The value to set the property to initially.

finalValue : The value to set the property to after the duration of time has passed.