IDVT LED-Wiz Installation manual

MultipleLED-WizActiveXControl
CommandReference
Copyright 2006, IDVT Inc. / www.GroovyGameGear.com
Advance Release v.89
.

1
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com
User License:
Multiple LED-Wiz Control
Copyright © 2006, IDVT Inc. / GroovyGameGear.com
All rights reserved.
Web site: http://www.groovygamegear.com
LICENSE AGREEMENT
NOTICE TO USERS: CAREFULLY READ THE FOLLOWING LEGAL AGREEMENT. USE OF THE SOFTWARE PROVIDED WITH THIS AGREEMENT (THE
"SOFTWARE") CONSTITUTES YOUR ACCEPTANCE OF THESE TERMS. IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, DO NOT INSTALL
AND/OR USE THIS SOFTWARE. USER'S USE OF THIS SOFTWARE IS CONDITIONED UPON COMPLIANCE BY USER WITH THE TERMS OF THIS
AGREEMENT.
1. LICENSE GRANT. Ithaca Digital Visual Technologies, Inc. ("IDVT") grants you a license to use this SOFTWARE on any Personal Computer ("PC") to which an
LED-Wiz™ is physically connected. "You" means the company, entity or individual to whom the aforementioned PC belongs. "Use" means storing, loading,
installing, executing or displaying the SOFTWARE. Distribution of components of the SOFTWARE, as a part of another software package, is only permissible when
accompanied by this agreement and when permission is expressed in writing from an officer of IDVT. This license is not transferable to any other hardware product
or other company, entity, or individual. Permission to distribute the SOFTWARE is not transferable, assignable, saleable, or franchisable. Each entity wishing to use
or distribute the package must independently satisfy the terms of this license.
2. OWNERSHIP. The SOFTWARE is owned and copyrighted by IDVT. Your license confers no title or ownership in the SOFTWARE and should not be construed as a
sale of any right in the SOFTWARE.
3. COPYRIGHT. The SOFTWARE is protected by United States copyright law and international treaty provisions. You acknowledge that no title to the intellectual
property in the SOFTWARE is transferred to you. You further acknowledge that title and full ownership rights to the SOFTWARE will remain the exclusive property of
IDVT and you will not acquire any rights to the SOFTWARE except as expressly set forth in this license. You agree that any copies of the SOFTWARE will contain the
same proprietary notices which appear on and in the SOFTWARE.
4. REVERSE ENGINEERING. You agree that you will not attempt to reverse compile, modify, translate, or disassemble the SOFTWARE in whole or in part.
5. UNAUTHORIZED USE. You may not use, copy, rent, lease, sell, modify, decompile, disassemble, otherwise reverse engineer, or transfer the SOFTWARE except
as provided in this agreement. Any such unauthorized use shall result in immediate and automatic termination of this license.
6. U.S. GOVERNMENT INFORMATION. Use, duplication, or disclosure by the U.S. Government of the computer software and documentation in this package shall
be subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.277-7013 (Oct 1988)
and FAR 52.227-19 (Jun 1987). The Contractor is IDVT.
7. NO OTHER WARRANTIES. IDVT DOES NOT WARRANT THAT THE SOFTWARE IS ERROR FREE. IDVT DISCLAIMS ALL OTHER WARRANTIES WITH
RESPECT TO THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION
OF IMPLIED WARRANTIES OR LIMITATIONS ON HOW LONG AN IMPLIED WARRANTY MAY LAST, OR THE EXCLUSION OR LIMITATION OF INCIDENTAL
OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATIONS OR EXCLUSIONS MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC
LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM JURISDICTION TO JURISDICTION.
8. LIMITED WARRANTY. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS. IDVT DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE,
WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE. NEITHER IDVT NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS
SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
SUCH SOFTWARE, EVEN IF IDVT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THE PERSON USING THE SOFTWARE
BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE.
SOME JURISDICTIONS DO NOT ALLOW LIMITATION OR EXCLUSION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATIONS
OR EXCLUSION MAY NOT APPLY TO YOU TO THE EXTENT THAT LIABILITY IS BY LAW INCAPABLE OF EXCLUSION OR RESTRICTION.
9. SEVERABILITY. In the event of invalidity of any provision of this license, the parties agree that such invalidity shall not affect the validity of the remaining portions of
this license.
10. NO LIABILITY FOR CONSEQUENTIAL DAMAGES. IN NO EVENT SHALL IDVT OR ITS SUPPLIERS BE LIABLE TO YOU FOR ANY CONSEQUENTIAL,
SPECIAL, INCIDENTAL OR INDIRECT DAMAGES OF ANY KIND ARISING OUT OF THE DELIVERY, PERFORMANCE OR USE OF THE SOFTWARE, EVEN IF
IDVT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENT WILL IDVT'S LIABILITY FOR ANY CLAIM, WHETHER IN CONTRACT,
TORT OR ANY OTHER THEORY OF LIABILITY, EXCEED THE LICENSE FEE PAID BY YOU, IF ANY.
11. GOVERNING LAW. This agreement shall be governed by the laws of the New York State, excluding the application of its conflicts of law rules and shall inure to
the benefit of IDVT and any successors, administrators, heirs and assigns. Any action or proceeding brought by either party against the other arising out of or related
to this agreement shall be brought only in a STATE or FEDERAL COURT of competent jurisdiction located in Tompkins County, NY. The parties hereby consent to in
personam jurisdiction of said courts.
12. ENTIRE AGREEMENT. This is the entire agreement between you and IDVT which supersedes any prior agreement or understanding, whether written or oral,
relating to the subject matter of this license.
13. RESERVED RIGHTS. All rights not expressly granted here are reserved to IDVT.

Installation:
Demo Program:
Control Usage:
Copy the OCX file to your hard-drive and follow the directions
for using ActiveX controls.
Included in the “Demo” folder is a simple Visual Basic 6 application that will demonstrate
how to use the control to:
Select the LED-Wiz Device you wish to control
Send Commands to the LED-Wiz command parser.
Simply place the control anywhere on the main form of your application. This will expose
allow you to control as many as 16 LED-Wiz devices directly
from your own programs..
provided by your
development platform / OS
Identify the quantity and ID numbers of LED-Wiz™ devices connected.
an
“LED-Wiz” Object, which will
!
!
!
2
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com

Properties:
Command
Detected
DeviceNumber
!
!
!
This property is a String which is set to a command intended for the LED-
Wiz command parser.
The format is <three letter command>:<parameter>,<parameter>,<...>
Example: LED_Wiz.Command = “RGB:1,13,22,40”
Refer to the for commands recognized by the
parser.
This property is a 16 character, string that represents the quantity
and device numbers of LED-Wiz devices present on the system. A “1”in the leftmost,
or first, position of the string indicates the presence of an LED-Wiz with a device
number of “1”. A “1” at the second position from the left indicates the presence of
an LED-Wiz with a device number of “2”, and so on. A “0” indicates no LED-Wiz is
present at that location.
Example: MyString = LED_Wiz.Detected
This is an Integer value between 1 and 16 inclusive. It represents the device number of
the LED-Wiz you wish to control. Writing to a non-existant LED-Wiz will generate an
error.
Example: LED_Wiz.DeviceNumber = 2
write-only
LED-Wiz™ Command Parser Reference
read-only
3
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com

LED-Wiz™ Command Parser Reference
Output States:
Command:
Parameters:
Description:
Example:
Command:
Parameters:
Description:
Example:
SBA
Sets the state of all outputs plus Global Pulse Speed.
The values are 8-bit representations of on/off states for banks . Value is the Global
Pulse Speed setting (1 through 7).
Sets the state of all outputs to , and sets the Global Pulse Speed to
Sets the state of all outputs to , and sets the Global Pulse Speed to
SB
Sets the states of a Bank of 8 outputs.
Bank 1 addresses the first 8 outputs, Bank 2, the second 8 and so on.
= Bank 1 through 4, = 0 to 255 (8-bit addressing)
Sets the state of outputs #1 through #8 to .
Sets the state of outputs #26 through #31 to , and outputs #25 and #32 to
x,x,x,x,y
x 1-4 y
SBA:255,255,255,255,2
on 2
SBA:0,0,0,0,1
off 1
x
y
X y
SB1:255
on
SB4:129
off on.
4
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com
Most
Efficient!

LED-Wiz™ Command Parser Reference
Output States:
Command:
Parameters:
Description:
Example:
Command:
Parameters:
Description:
Example:
(continued)
xx
y
x y
on off
S01:1
on.
S32:0
off.
rl,rh
rl rh
RDS:12,24
S
Sets the State of a Single Output
The value is an output number from 01 to 32 inclusive. Value is the state of the output,
1= and 0= .
Sets the state of the #1 Output to
Sets the state of the #32 Output to
RDS
Sets random on/off states to a range of outputs.
The value is the lower output number in the range and the value is the high end of the
range.
Sets the state of outputs numbered 12 through 24 to on or off conditions randomly.
5
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com

LED-Wiz™ Command Parser Reference
Output Profile Settings:
Command:
Parameters:
Description:
Example:
NOTE
PBA
Profile Settings for All Outputs.
Each of the 32 parameters coincide with the outputs numbered 1-32. A value of 0 to
inclusive, sets the brightness or intensity of each LED using Pulse Width Modulation (PWM). A
value of indicates an automated pulse mode as follows:
= Ramp Up / Ramp Down
= On / Off
= On / Ramp Down
= Ramp Up / On
The speed is controlled by the parameter.
Output 4 set to a "sawtooth" pulse, output 14 is set to an intensity of 20 and the rest of the outputs
are set to full brightness settings.
: Profile Settings commands should not be used as controls. They are for setting up
the behavior profile for each output. Use the more efficient “state” commands for switching
inputs on and off. Profile commands should only be used when the behavior profile of an output
needs to be changed.
x,x,x,x,......x
x 48
129-132
129
130
131
132
Global Pulse Speed
on/off
PBA:48,48,48,129,48,48,48,48,48,48,48,48,48,20,48,48,48,48,48,48,48,48,48,48,48,48,48,48,48,48,48,48
6
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com
Most
Efficient!

LED-Wiz™ Command Parser Reference
Output Profile Settings:
Command:
Parameters:
Description:
Example:
Command:
Parameters:
Description:
Example:
(continued)
x
y,y,y,y,y,y,y,y
x y
PB1:16,16,16,16,48,48,48,48
SB4:129,129,129,129,10,10,20,20
xx
y
xx
y
P01:27
P32:130
PB
Sets the behavior profiles for a bank of 8 outputs. Bank 1 addresses the first 8
outputs, Bank 2, the second 8 and so on. = Bank 1 through 4, = 0 through 48 or 129
through 132 (as in previous command)
Sets outputs #1 through #4 to intensity level 16 and sets outputs #5 through #8 to intensity
level 48 (full intensity.)
Sets outputs #25 through #28 to pulse, outputs #29 and #30 to intensity level 10 and outputs
#31 and #32 to intensity level 20.
P
Sets the behavior profile of an individual output. = Output 01 through 32,
= 0 through 48 or 129 through 132 (as in previous commands)
Sets the #1 output to brightness level 27
Sets the #32 output to blink.
7
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com

LED-Wiz™ Command Parser Reference
Output Profile Settings:
Command:
Parameters:
Description:
Example:
(continued)
rl,rh,y
rl rh
y 0
y 1 on.
RDI:5,20,1
RDI
Sets random intensity / brightness to a range of outputs and optionally affects
the states of the outputs in that range.
The value is the lower output number in the range and the is high end of the range. The
y value is the “Affect State” parameter. When = the current state of outputs is unaffected.
When = , the three corresponding inputs are set to
Sets the intensity of outputs numbered 5 through 20 to values from 0 to 48 randomly and
turns on the associated outputs.
8
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com

LED-Wiz™ Command Parser Reference
Special Commands:
Command:
Parameters:
Description:
Example:
Command:
Parameters:
Description:
Example:
RGB
Sets the Intensity (Red, Green and Blue) values of an RGB LED and then turns
on the three corresponding outputs.
To properly use this command, the LED must be connected with the Red leg at output and
the Green and Blue at outputs and respectively.
The value is the first, or Red, output. The and values are intensity levels from 0 to 48
inclusive.
Produces a “warm yellow” color on an RGB LED connected starting at output #4.
RDC
Sets an RGB LED to a random color when connected as explained in the RGB
command and optionally activates the outputs.
The x value is the first, or Red, output. The y value is the “Affect State” parameter. When
= the current state of outputs is unaffected. When = , the three corresponding inputs are
set to
Produces a random color on an RGB LED connected starting at output #4.
x,r,g,b
x
x+1 x+2
x r,g b
RGB:4,48,30,0
x,y
y 0 y 1
on.
RDC:4,1
9
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com

LED-Wiz™ Command Parser Reference
Special Commands:
Command:
Parameters:
Description:
Example:
(continued)
GPS
Sets the for the automated pulse modes of the LED-Wiz
hardware. This parameter affects all outputs with automated pulse modes active.
The value can be a number from to , with 1 being the fastest pulse speed and 7 being the
slowest.
Will cause any outputs with their behavior profile set to use a hardware pulse mode to pulse
at the maximum possible speed.
x
Global Pulse Speed
x 1 7
GPS:1
10
Multiple LED-Wiz™ ActiveX Control V.89 Documentation (Preliminary) Ithaca Digital Visual Technologies Inc / www.GroovyGameGear.com
Copyright 2006, IDVT Inc. / www.GroovyGameGear.com