ACT TI103 X10 Driver

The ACT TI103-RS232 (and TI203, TI213) is a power line carrier transceiver with a serial data communication port. It can be used to monitor and control X10, ACT, Leviton, and many other power line control modules. The recommended DIP switch settings for North American users should have all dip switches set to OFF except #7 should be ON. If you live in a country which uses 50Hz power then set #7 to OFF. To use the Set Light Level action you must first set the appropriate dimming type (none, standard dimming, preset dimming, extended direct dim) for each x10 module in the device's Device List setting.

Manufacturer: Advanced Control Technologies (ACT)

Primary Communications Port: Serial

Table of Contents [Hide/Show] Configuration Settings Events    Light Level Changed    Light On/Off State Changed    Ready State Changed    Received X10 Command    Received X10 Preset Dim Command Instance Properties    Connected    LightLevels    LightOnOffs    LightNames    DeviceDisplayName    DeviceStartTime    DeviceLifecycleStage    DeviceIsRunningAndReady Instance Methods    SendRawCommand ( String )    SendX10Command ( String, Number, Number )    SendX10PresetDimCommand ( String, Number, Number )    TurnOnLight ( String, Number )    TurnOnLight ( Number )    TurnOffLight ( String, Number )    TurnOffLight ( Number )    SetLightLevel ( String, Number, Number )    SetLightLevel ( Number, Number )    TurnOnAllLights    TurnOnAllLights ( String )    TurnOffAllLights    TurnOffAllLights ( String )    AllUnitsOff ( String )    Brighten ( String, Number, Number )    Brighten ( Number, Number )    Dim ( String, Number, Number )    Dim ( Number, Number )    TurnOnLightByName ( String )    TurnOffLightByName ( String )    SetLightLevelByName ( String, Number )    SetLightLevelForDuration ( Number, TimeSpan, Number, Number )    TurnOnLightForDuration ( Number, TimeSpan )    SimulateReceivedData ( String )    SetPropertyForDuration ( String, TimeSpan, Object, Object )    SetPropertyForDuration ( String, Number, TimeSpan, Object, Object )

Configuration Settings

• Serial Port Name : The name of the serial port that the hardware is connected to. Ex. COM1
• Serial Port Speed : (optional) Baud rate for serial port, 9600 or 19200 (default value is 9600). Check the dip switch 8 in the TI103, OFF=9600, ON=19200. 9600 is more reliable and is the default DIP switch setting.
• Device List : (optional) Enter the name and dimming type of each X10 device next to its ID. If a device does not support dimming then choose none. You may need to refer to the device manual or try different dimming types to determine which are supported. Extended Direct Dim is the best, then Preset Dim then Standard Dimming.
  

Events

Light Level Changed

Occurs when a light's level changes.

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.
  

Light On/Off State Changed

Occurs when the light changes from on to off or off to on. Any level greater than zero is considered on.

Whenever Filter:

• PropertyIndex : Enter the device id which is the numeric form of the house/unit codes. You can get the ID by viewing the Device List configuration setting on the device and cross referencing the house code/unit code. For example A1 is 1, B1 is 17.
  

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:


EventArgs:

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

Received X10 Command

Occurs when an X10 command code is received (except the preset dim command which has it's own event).

Whenever Filter:

• DeviceCode : (optional) The device code (1-16).
• CommandCode : (optional) The command code.
• HouseCode : (optional) The X10 house code (A-P).
  

EventArgs:

• Number DeviceCode : The device code (1-16).
• String HouseCode : The X10 house code (A-P).
• Number CommandCode : The command code.
  

Received X10 Preset Dim Command

Occurs when an X10 preset dim command code is received.

Whenever Filter:

• HouseCode : (optional) The X10 house code (A-P).
• DeviceCode : (optional) The device code (1-16).
• Level : (optional) The preset dim level value. (1-32)
  

EventArgs:

• Number Level : The preset dim level value. (1-32)
• String HouseCode : The X10 house code (A-P).
• Number DeviceCode : The device code (1-16).
  

Instance Properties

Connected

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

Accessibility : Read Only

Type: Boolean

LightLevels

Gets the percent on level of the lights. 0-100

Accessibility : Read Only

Type: Array

LightOnOffs

Gets or sets the light to a fully on state or fully off.

Accessibility : Read Only

Type: Array

LightNames

Gets the names of the lights.

Accessibility : Read Only

Type: Array

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

SendRawCommand ( String )

Sends a command that may otherwise not be supported by the driver. Most commands start with a'$>28001' prefix. You do not need to include the checksum or ending '#'.

Syntax


Parameters

SendX10Command ( String, Number, Number )

Sends a full X10 Command to the powerline.

Syntax


Parameters

SendX10PresetDimCommand ( String, Number, Number )

Sends an X10 preset dim command to the powerline.

Syntax


Parameters

TurnOnLight ( String, Number )

Turns on the specified light.

Syntax


Parameters

TurnOnLight ( Number )

Turns on the specified light.

Syntax


Parameters

TurnOffLight ( String, Number )

Turns off the specified light.

Syntax


Parameters

TurnOffLight ( Number )

Turns off the specified light.

Syntax


Parameters

SetLightLevel ( String, Number, Number )

Sets the % level of the specified light (or PLC device) by house code and unit code. You must have set the appropriate dimming type (none, standard dimming, preset dimming, extended direct dim) for each x10 module in the device's Device List setting to use this action.

Syntax


Parameters

SetLightLevel ( Number, Number )

Sets the specified light's level to the specified percent. You must have set the appropriate dimming type (none, standard dimming, preset dimming, extended direct dim) for each x10 module in the device's Device List setting to use this action.

Syntax


Parameters

TurnOnAllLights

Turns all lights on.

Syntax


Parameters

TurnOnAllLights ( String )

Turn on all lights for the specified house code.

Syntax


Parameters

TurnOffAllLights

Turns all lights off.

Syntax


Parameters

TurnOffAllLights ( String )

Turn off all lights for the specified house code.

Syntax


Parameters

AllUnitsOff ( String )

Turns off all units in the specified house code.

Syntax


Parameters

Brighten ( String, Number, Number )

Brightens an X10 device.

Syntax


Parameters

Brighten ( Number, Number )

Brighten an X10 device.

Syntax


Parameters

Dim ( String, Number, Number )

Dims an X10 device.

Syntax


Parameters

Dim ( Number, Number )

Dims an X10 device.

Syntax


Parameters

TurnOnLightByName ( String )

Turns on the specified light.

Syntax


Parameters

TurnOffLightByName ( String )

Turns off the specified light.

Syntax


Parameters

SetLightLevelByName ( String, Number )

Sets the specified light's % level to the specified percent. You must have set the appropriate dimming type (none, standard dimming, preset dimming, extended direct dim) for each x10 module in the device's Device List setting to use this action.

Syntax


Parameters

SetLightLevelForDuration ( Number, TimeSpan, Number, Number )

Sets a light's level for a duration of time and then sets the light to a subsequent level.

Syntax


Parameters

TurnOnLightForDuration ( Number, TimeSpan )

Turns a light fully on for a duration of time and then turns the light off.

Syntax


Parameters

SimulateReceivedData ( String )

Simulate data being received from the serial port. The data will be processed as if it were actually received as incoming data from the serial ports. This is useful for testing.

Syntax


Parameters

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


Parameters

SetPropertyForDuration ( String, Number, 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


Parameters