SCHOTT ColdVision Light Source Operating instructions

SCHOTT ColdVision Light Source
Programming Guide
D20980.026 Rev B –DCN 21617
March 2017
SCHOTT North America, Inc.
122 Charlton Street, Southbridge, MA 01550-1960
Phone: [phone], Fax: [phone]
Email: mach[email protected]
Website: http://moritex.com/products/mv/light_sources

Table of Contents
D20980.026 Rev B CV-LS Programming Guide Page 2
Table of Contents
Introduction........................................................................................................3
Downloads.....................................................................................................................................3
Comments .....................................................................................................................................3
Remote Operation ..............................................................................................4
Legacy Protocol...................................................................................................5
Command Structure .......................................................................................................................5
Negative Acknowledgements .........................................................................................................5
Command Index.............................................................................................................................6
Command Details...........................................................................................................................9

Introduction
D20980.026 Rev B CV-LS Programming Guide Page 3
Introduction
This Programming Guide is to explain the use of advanced interfaces of the Schott ColdVision Light
Source. This document will be updated as new features are added to the software.
Downloads
The CV-LS Dashboard described in the User Manual is maintained in a GitHub repository located at:
https://github.com/SCHOTTNorthAmerica/CVLS-Dashboard/releases
The DLLs used in the dashboard can be found in GitHub repositories located at:
https://github.com/SCHOTTNorthAmerica/SCHOTT.Core
https://github.com/SCHOTTNorthAmerica/SCHOTT.WinForms
https://github.com/SCHOTTNorthAmerica/SCHOTT.CVLS
https://github.com/SCHOTTNorthAmerica/SCHOTT.CVLS.Dashboard
All data sheets, manuals, firmware updates, and example software can be downloaded at:
http://moritex.com/products/mv/light_sources
Comments
We welcome your feature requests and comments about this document.
You can reach us by e-mail at [e-mail]

Introduction
D20980.026 Rev B CV-LS Programming Guide Page 4
Remote Operation
The CV-LS has several remote operation interfaces. Any interface using the legacy protocol can be
connected to using most terminal applications. Possible interfaces and their default connection
information can be found below:
Legacy Protocol
Ethernet Socket
Set terminal application to Telnet
Port 50811
Static IP Address 192.168.0.2
DHCP Enabled
UART
9600 Baud
8 Bit
1 Stop Bit
No Parity
RX, TX, and GND must be connected through the Multiport
USB
CV-LS USB Driver must be installed
Terminal application will show the CV-LS as a RS232 port, but no additional settings are
needed
Binary Protocol
Ethernet Socket
Port 5000
Static IP Address 192.168.0.2
DHCP Enabled

Legacy Protocol
D20980.026 Rev B CV-LS Programming Guide Page 5
Legacy Protocol
Command Structure
The Legacy Protocol has followed the same structure as the LLS3 command protocol whenever possible.
If there is a command from the LLS3 that has been removed from the CV-LS, you can contact us at
[e-mail] with a request to restore a particular function. Please include a
description of the command that is missing, and how you need it to interface with your legacy
application.
All commands start with the ampersand character “&” and end with a carriage return “\r”. There is a
string representing the command immediately after the “&”, followed by the desired value.
The unit will discard all characters until it receives an “&” start character. Once the carriage return “\r” is
received, the unit will process the command. If a valid command is not found, the unit will return “&n”
followed by the command string with an indicator of which character was not recognized.
Negative Acknowledgements
Negative acknowledgements are used to indicate that a received command was invalid. The following
negative acknowledgements are supported.
INVALID
COMMAND:
Return string format: &nXpY
&n = Negative acknowledgement
X = Received characters parsed correctly
p = Invalid character location start
Y = Invalid character received
INVALID
PARAMETER:
Return string format: &nXpYYY
&n = Negative acknowledgement
X = Received characters parsed correctly
p = Invalid parameter location start
Y = Invalid parameter received

Legacy Protocol
D20980.026 Rev B CV-LS Programming Guide Page 6
Command Index
1System Status ...............................................................................................9
1.1 Temperature.......................................................................................................................9
1.1.1 Board..................................................................................................................................... 9
1.1.2 LED ........................................................................................................................................ 9
1.2 Voltage Monitors ..............................................................................................................10
1.2.1 Input.................................................................................................................................... 10
1.2.2 Reference 5V Output .......................................................................................................... 10
1.3 Fan ...................................................................................................................................10
1.3.1 Speed................................................................................................................................... 10
1.3.2 Status .................................................................................................................................. 11
1.4 Equalizer...........................................................................................................................11
1.4.1 Stability ............................................................................................................................... 11
1.4.2 Status .................................................................................................................................. 11
1.5 System Information...........................................................................................................11
1.5.1 System Mode ...................................................................................................................... 11
1.5.2 User Mode........................................................................................................................... 11
1.5.3 Time .................................................................................................................................... 12
1.6 Light Feed Back Raw..........................................................................................................12
1.7 Error Flags.........................................................................................................................12
1.8 Inputs ...............................................................................................................................12
1.8.1 Analog ................................................................................................................................. 12
1.8.2 Digital .................................................................................................................................. 12
1.9 Identification ....................................................................................................................13
1.9.1 Product Name ..................................................................................................................... 13
1.9.2 Firmware Revision............................................................................................................... 13
1.9.3 Serial Number .....................................................................................................................13
1.9.4 Model ..................................................................................................................................13
1.9.5 Model:Serial........................................................................................................................ 13
1.10 Memory Write Cycles ........................................................................................................14
1.10.1 Factory Settings................................................................................................................... 14
1.10.2 User Settings .......................................................................................................................14
1.10.3 SPI (Firmware Uploads)....................................................................................................... 14
1.10.4 Error Logs ............................................................................................................................14
2Configurations ............................................................................................15
2.1 Persistent Memory............................................................................................................15
2.1.1 Save Settings .......................................................................................................................15
2.1.2 Restore Settings ..................................................................................................................15

Legacy Protocol
D20980.026 Rev B CV-LS Programming Guide Page 7
2.2 Factory Defaults ................................................................................................................15
2.2.1 Restore All Factory Defaults................................................................................................ 15
2.2.2 Restore Factory Defaults (Preserving Network Settings).................................................... 15
2.2.3 Erase Exception Logs...........................................................................................................15
2.2.4 Reboot System .................................................................................................................... 15
3Controls ......................................................................................................16
3.1 Control Mode....................................................................................................................16
3.1.1 Last Command Interface.....................................................................................................16
3.2 LED Channel Settings.........................................................................................................16
3.2.1 Demo Mode (RGBW Model Only)....................................................................................... 16
3.2.2 Combined Trigger................................................................................................................ 16
3.2.3 Knob Mode.......................................................................................................................... 16
3.2.4 Single Channel Operation ...................................................................................................16
3.2.5 Shut-Down Pin ....................................................................................................................17
3.2.6 Output Enable (Front Switch) ............................................................................................. 17
3.2.7 Output Power (Front Knob) ................................................................................................18
3.3 Continuous Strobe.............................................................................................................19
3.3.1 Continuous Strobe Enable................................................................................................... 19
3.3.2 Single Channel Operation ...................................................................................................19
3.3.3 Frequency............................................................................................................................ 19
3.3.4 Duty Cycle ........................................................................................................................... 19
3.3.5 Phase Shift........................................................................................................................... 20
3.3.6 Waveform Polarity .............................................................................................................. 20
3.4 Triggered Strobe ...............................................................................................................21
3.4.1 Triggered Strobe Enable...................................................................................................... 21
3.4.2 Combined Trigger................................................................................................................ 21
3.4.3 Single Channel Operation ...................................................................................................21
3.4.4 Delay ................................................................................................................................... 21
3.4.5 On Time...............................................................................................................................22
3.4.6 Trigger Edge ........................................................................................................................ 22
3.5 Equalizer...........................................................................................................................23
3.5.1 Equalizer Enable.................................................................................................................. 23
3.5.2 Start-up Delay .....................................................................................................................23
3.5.3 Target Light Output............................................................................................................. 23
3.5.4 Current Light Output........................................................................................................... 23
3.5.5 Equalizer Output ................................................................................................................. 23
3.6 Fan Settings ......................................................................................................................24
3.6.1 Manual Fan Control ............................................................................................................ 24

Legacy Protocol
D20980.026 Rev B CV-LS Programming Guide Page 8
3.6.2 Fan Speed............................................................................................................................ 24
4Settings.......................................................................................................25
4.1 General.............................................................................................................................25
4.1.1 Login Timeout ..................................................................................................................... 25
4.1.2 Require Login ......................................................................................................................25
4.1.3 Allow Browser Save Password ............................................................................................25
4.1.4 Controls Lockout .................................................................................................................26
4.2 Network............................................................................................................................27
4.2.1 Connection Status ...............................................................................................................27
4.2.2 Hostname............................................................................................................................27
4.2.3 DHCP ................................................................................................................................... 27
4.2.4 IP Address............................................................................................................................ 27
4.2.5 Subnet Mask........................................................................................................................28
4.2.6 Gateway .............................................................................................................................. 28
4.2.7 Preferred DNS ..................................................................................................................... 29
4.2.8 Alternate DNS......................................................................................................................29
4.3 Sockets .............................................................................................................................30
4.3.1 Legacy Ethernet Socket.......................................................................................................30
4.3.2 Binary Ethernet Socket........................................................................................................31
4.4 UART ................................................................................................................................32
4.4.1 Baud Rate............................................................................................................................ 32
4.4.2 Parity ................................................................................................................................... 32
4.4.3 Stop Bits .............................................................................................................................. 32
4.4.4 Restart.................................................................................................................................32
5Other Commands........................................................................................33
5.1 Erase Error Logs.................................................................................................................33
5.2 System Reboot..................................................................................................................33

Legacy Protocol
System Status
D20980.026 Rev B CV-LS Programming Guide Page 9
Command Details
1System Status
1.1 Temperature
1.1.1 Board
&?BM
Get current thermistor status of the main PCB
Return string: &?bmX
Return value (X): 1 = Good, 2 = Warning, 3 = Error
&?BS
Get status of the temperature sensor on the main PCB
Return string: &?bsX
Return value (X): 1 = Fully Functional, 0 = Warning or Error
&?BT
Get current temperature of the main PCB in Celsius
Return string: &?btX
Return value (X): 0.0 –100.0
1.1.2 LED
1.1.2.1 Legacy
&CT?
Get current temperature of the LED PCB in Celsius (Legacy Command, See &?lt).
Return string: &ctX
Return value (X): LED Temp in “XX” format.
Note: Unit will accept command without (?) for backwards compatibility.
1.1.2.2 CV-LS
&?LM
Get current thermistor status of the LED PCB
Return string: &?lmX
Return value (X): 1 = Good, 2 = Warning, 3 = Error
&?LS
Get status of the temperature sensor on the LED PCB
Return string: &?lsX
Return value (X): 1 = Fully Functional, 0 = Warning or Error
&?LT
Get current temperature of the LED PCB in Celsius
Return string: &?ltX
Return value (X): 0.0 –100.0

Legacy Protocol
System Status
D20980.026 Rev B CV-LS Programming Guide Page 10
1.2 Voltage Monitors
1.2.1 Input
1.2.1.1 Voltage
&?VI
Get the voltage of the input rail. This will be the higher voltage of the 2 inputs to the
unit.
Input Voltage is rated for 18 - 28V.
Return string: &?viX.XX
Return value (X.XX): Floating Point Voltage with 2 decimal places
1.2.1.2 Status
&?VIS
Gets the status of the input rail. This will report a warning as the voltage nears its range,
then turn to an error before the unit shuts down.
Warning = V > 28 or V < 19
Error = V > 30 or V < 18
System shutdown will occur near 17.5V and will not turn on again below 18V. Voltage
above 33V will damage the LED driver circuit.
Return string: &?visX
Return value (X): 1 = Good, 2 = Warning, 3 = Error
1.2.2 Reference 5V Output
1.2.2.1 Voltage
&?VO
Get the actual voltage of the 5V reference pin on the multiport.
Output Reference Voltage is 5V +/- 0.1V.
Return string: &?voX.XX
Return value (X.XX): Floating Point Voltage with 2 decimal places
1.2.2.2 Status
&?VOS
Gets the status of the 5V reference rail. This will report a warning as the voltage is
pulled out of regulation. This would generally be caused by overloading the output
regulator.
Warning = >10%
Error = >25%
Return string: &?vosX
Return value (X): 1 = Good, 2 = Warning, 3 = Error
1.3 Fan
1.3.1 Speed
&?G
Gets the current fan speed in RPM
Return string: &?gX
Return value (X): 0 –24000

Legacy Protocol
System Status
D20980.026 Rev B CV-LS Programming Guide Page 11
1.3.2 Status
&?GS
Gets the current fan status
Return string: &?gsX
Return value (X):
0 = Off
1 = Good
2 = Warning
3 = Error
4 = Info
1.4 Equalizer
1.4.1 Stability
&ES?
Gets the Equalizer Stability
Return string: &esX
Return value (X):
0 = non stable
1 = Locked (stable)
2 = Waiting for delay to start
4 = intensity low
6 = intensity high
8 = over range (intensity too low to maintain stability)
10 = under range (intensity too high to maintain stability)
1.4.2 Status
&ESD?
Gets the Equalizer Status
Return string: &esdX
Return value (X):
0 = Off
1 = Good
2 = Warning
3 = Error
4 = Info
1.5 System Information
1.5.1 System Mode
&?SM
Gets the current operating mode of the system
Return string: &?smX
Return value (X):
1.5.2 User Mode
&?SU
Gets the current user mode. This can be overridden with individual commands.
Return string: &?suX
Return value (X):

Legacy Protocol
System Status
D20980.026 Rev B CV-LS Programming Guide Page 12
1.5.3 Time
&?ST
Gets the current system time in seconds from the epoch.
Return string: &?stX
Return value (X):
1.6 Light Feed Back Raw
&?I
Gets the current raw value of the Light Feed Back sensor.
Return string: &?iX
Return value (X): 0 –4096
1.7 Error Flags
&C?
Reports any error flags for the system.
Return string: &cX
Return value (X): 8 bit value, Bit 0 = Fan Error, Bit 1 = LED Temp Error, Bit 8 = Any Faults.
Bit values: 1 = Fault Exists, 0 = No Fault Exists.
Note: Unit will accept command without (?) for backwards compatibility.
1.8 Inputs
1.8.1 Analog
&?A#
Gets current value of an analog channel specified by #.
Input Options (#): 0 = Front Knob, 1-4 = Multiport Analog Channel Input
Return string: &?a#X
Return value (X): 0 –1000
1.8.2 Digital
&?D#
Gets current value of a digital channel specified by #.
Input Options (#): 0 = Front Switch, 1-4 = Multiport Digital Channel Input
Return string: &?d#X
Return value (X): 0 –1000

Legacy Protocol
System Status
D20980.026 Rev B CV-LS Programming Guide Page 13
1.9 Identification
1.9.1 Product Name
&Q
Gets a string containing the product name.
Return value: &qSCHOTT ColdVision Light Source
1.9.2 Firmware Revision
&F?
Gets the firmware revision of the unit.
Return String: &fX.XX
Return value (X.XX): Firmware Revision
Note: Unit will accept command without (?) for backwards compatibility.
1.9.3 Serial Number
&Z?
Gets unit Serial Number.
Return string: &zXXXXXX
Return value (XXXXXX): 6 digit serial number
Note: Unit will accept command without (?) for backwards compatibility.
1.9.4 Model
&ZM?
Gets unit Model
Return string: &zmY
Return value (Y): Model String
Note: Unit will accept command without (?) for backwards compatibility.
1.9.5 Model:Serial
&ZF?
Gets unit Model:Serial number.
Return string: &zfY:XXXXXX
Return value (Y): Model String
Return value (XXXXXX): 6 digit serial number
Note: Unit will accept command without (?) for backwards compatibility.

Legacy Protocol
System Status
D20980.026 Rev B CV-LS Programming Guide Page 14
1.10 Memory Write Cycles
1.10.1 Factory Settings
&?MF
Get the number of times the Factory Settings have been stored to memory.
Rated for 1,600,000 write cycles.
Return string: &?mfX
Return value (X): Write Count
1.10.2 User Settings
&?MS
Get the number of times the User Settings have been stored to memory.
Rated for 40,000,000 write cycles.
Return string: &?msX
Return value (X): Write Count
1.10.3 SPI (Firmware Uploads)
&?MP
Get the number of times the user has written to the firmware flash memory.
Rated for 10,000 write cycles.
Return string: &?mpX
Return value (X): Write Count
1.10.4 Error Logs
&?ML
Get the number of times an Error Log has been stored to memory.
Rated for 25,600,000 write cycles.
Return string: &?mlX
Return value (X): Write Count

Legacy Protocol
Configurations
D20980.026 Rev B CV-LS Programming Guide Page 15
2Configurations
2.1 Persistent Memory
2.1.1 Save Settings
&S
Command forces the unit to store the current settings to non-volatile memory.
Return string: &s
2.1.2 Restore Settings
&T
Command forces the unit to restore the current settings to those stored in non-volatile.
Return string: &t
2.2 Factory Defaults
2.2.1 Restore All Factory Defaults
&O
This command causes the unit to return to all settings stored at the factory.
Return string: &o
2.2.2 Restore Factory Defaults (Preserving Network Settings)
&O2
This command causes the unit to return to all settings stored at the factory, but will
keep the current network settings.
Return string: &o2
2.2.3 Erase Exception Logs
&O3
This command causes the unit to erase any current exceptions from the log.
Return string: &o3
2.2.4 Reboot System
&O4
This command causes the unit to reboot the processor. This has the same effect as
power cycling the unit.
Return string: &o4

Legacy Protocol
Controls
D20980.026 Rev B CV-LS Programming Guide Page 16
3Controls
3.1 Control Mode
3.1.1 Last Command Interface
&M#
Gets which interface was the last to accept a command change to the system.
Input Options (#):0 = Front, 1 = Multiport, 2 = RS232, 3 = Legacy Socket,
4 = USB, 5 = Web Interface, 6 = Binary Socket, ? = Query
Return string: &mX
Return value (X): 0 = Front, 1 = Multiport, 2 = RS232, 3 = Legacy Socket,
4 = USB, 5 = Web Interface, 6 = Binary Socket
3.2 LED Channel Settings
3.2.1 Demo Mode (RGBW Model Only)
&D#
Gets/Sets if the unit is operating in demo mode. This command is for RGBW units to
demonstrate color mixing possibilities.
Input Options (#): 0 = Disable, 1 = Enable, ? = Query
Return string: &dX
Return value (X): 0 = Disable, 1 = Enable
3.2.2 Combined Trigger
&J0,#
Control to combine all inputs together. When enabled, input to any channel behaves as
if all inputs were wired together.
Input Option (#): 0 = Disabled, 1 = Enabled, ? = Query
Return string: &j0,X
Return value (X): 0 = Disabled, 1 = Enabled
3.2.3 Knob Mode
&N#
Gets/Sets the function of the front knob.
Input Options (#): 0 = Common, 1 –4 = Channel, 5 = Demo Mode,
? = Query
Return string: &nX
Return value (X): 0 = Common, 1 –4 = Channel, 5 = Demo Mode
3.2.4 Single Channel Operation
&B#
Gets/Sets if the driver is single or quad channel.
Input Options (#): 0 = Quad, 1 = Single, ? = Query
Return string: &bX
Return value (X): 0 = Quad, 1 = Single
3.2.5

Legacy Protocol
Controls
D20980.026 Rev B CV-LS Programming Guide Page 17
3.2.6 Shut-Down Pin
&J#,#
Gets/Sets the behavior of the digital inputs on the Multiport connector. Default is Active
Low, where a low signal (GND) will turn off that channel of the LED.
First Input Option (#): 1 –4 = Channel
Second Input Option (#): 0 = Active Low, 1 = Active High, ? = Query
Return string: &jX,Y
Return value (X): 1 –4 = Channel
Return value (Y): 0 = Active Low, 1 = Active High
3.2.7 Output Enable (Front Switch)
3.2.7.1 Legacy
&L#
Gets/Sets if the LED control loop is active. This is equivalent to pressing the button on
the front of the unit.
Input Options (#): 0 = Disabled, 1 = Enabled, ? = Query
Return string: &lX
Return value (X): 0 = Disabled, 1 = Enabled
3.2.7.2 CV-LS
&L#,#
Gets/Sets if the LED control loop is active.
First Input Option (#): 0 = Common, 1 –4 = Channel
Second Input Option (#): 0 = Disabled, 1 = Enabled, ? = Query
Return string: &lX,Y
Return value (X): 0 = Common, 1 –4 = Channel
Return value (Y): 0 = Disabled, 1 = Enabled

Legacy Protocol
Controls
D20980.026 Rev B CV-LS Programming Guide Page 18
3.2.8 Output Power (Front Knob)
3.2.8.1 Legacy
&I#
Gets/Sets the common power limit for the LED. This has the same effect as turning the
front knob.
Input Options (#): 0 –FF = LED Power in HEX, ? = Query
Return string: &iX
Return value (X): 00 –FF = LED Power in 2 digit HEX
&IP#
Gets/Sets the common power limit for the LED with High Resolution. This has the same
effect as turning the front knob.
Input Options (#): 0 –7FF = LED Power in HEX, ? = Query
Return string: &ipX
Return value (X): 000 –7FF = LED Power in 3 digit HEX
3.2.8.2 CV-LS
&I#,#
Gets/Sets the power limit for the LED.
First Input Option (#): 0 = Common, 1 –4 = Channel
Second Input Option (#): 0 –1000 = Channel Power, ? = Query
Return string: &iX,Y
Return value (X): 0 = Common, 1 –4 = Channel
Return value (Y): 0 –1000 = Channel Power

Legacy Protocol
Controls
D20980.026 Rev B CV-LS Programming Guide Page 19
3.3 Continuous Strobe
3.3.1 Continuous Strobe Enable
&RM#
Gets/Sets if the continuous strobe mode is enabled.
Input Options (#): 0 = Disabled, 1 = Enabled, ? = Query
Return string: &rmX
Return value (X): 0 = Disabled, 1 = Enabled
3.3.2 Single Channel Operation
&RB#
Gets/Sets if the unit will behave as a single channel device during continuous strobe.
Input Options (#): 0 = Quad Channel Mode, 1 = Single Channel Mode,
? = Query
Return string: &rbX
Return value (X): 0 = Quad Channel Mode, 1 = Single Channel Mode
3.3.3 Frequency
&RF#
Gets/Sets the frequency that the continuous strobe operates at.
Input Options (#): 6 –20000 = Frequency in Hz, ? = Query
Return string: &rfX
Return value (X): 6 –20000 = Frequency in Hz
3.3.4 Duty Cycle
3.3.4.1 Legacy
&RD#
Gets/Sets the time that the LED is active during the strobe event.
Input Options (#): 0 –1000 = Duty Cycle, ? = Query
Return string: &rdX
Return value (X): 0 –1000 = Duty Cycle
3.3.4.2 CV-LS
&RD#,#
Gets/Sets the time that the LED channel is active during the strobe event.
First Input Option (#): 1 –4 = Channel
Second Input Option (#): 0 –1000 = Duty Cycle, ? = Query
Return string: &rdX,Y
Return value (X): 1 –4 = Channel
Return value (Y): 0 –1000 = Duty Cycle

Legacy Protocol
Controls
D20980.026 Rev B CV-LS Programming Guide Page 20
3.3.5 Phase Shift
3.3.5.1 Legacy
&RP#
Gets/Sets the amount of offset from the internal trigger.
Input Options (#): 0 –1000 = Phase Shift, ? = Query
Return string: &rpX
Return value (X): 0 –1000 = Phase Shift
3.3.5.2 CV-LS
&RP#,#
Gets/Sets the amount of offset per channel from the internal trigger.
First Input Option (#): 1 –4 = Channel
Second Input Option (#): 0 –1000 = Phase Shift, ? = Query
Return string: &rpX,Y
Return value (X): 1 –4 = Channel
Return value (Y): 0 –1000 = Phase Shift
3.3.6 Waveform Polarity
&RJ#,#
Gets/Sets whether the active part of the waveform has the LED On or Off. The LED will
be on with an Active High setting, or Off with an Active Low setting, during the set Duty
Cycle %.
First Input Option (#): 1 –4 = Channel
Second Input Option (#): 0 = Active Low, 1 = Active High, ? = Query
Return string: &rjX,Y
Return value (X): 1 –4 = Channel
Return value (Y): 0 = Active Low, 1 = Active High