Page 3
SAFETY FIRST Protect yourself. Follow these precautions: • This Manual contains information about the proper procedures for preparing this product for its use and care. • Follow the instructions of other manufacturer’s equipment when used in conjunction with this product. •...
Page 4
• Electric shock hazard. If unit is not functioning properly, DO NOT OPEN. Please refer to the Maintenance and Troubleshooting section of this manual. • Use only properly functioning cables that are made for system instrument connectors. • Light sources produce high intensity light. Thermal burns can result from improper use of the light source. •...
Page 5
INSTRUMENT CERTIFICATION Gamma Scientific, Inc., certifies that this instrument was thoroughly tested, inspected and found to meet its published specifications when it was shipped from the factory. Gamma Scientific, Inc., further certifies that its calibration measurements are traceable to the U. S. National Institute of Standards and Technology (NIST) formerly National Bureau of Standards to the extent permitted by the Bureau's calibration facility.
Page 6
Department, Stock Room and ISO/IEC 17025 NVLAP Accredited Calibration Facility (Lab Code 200823-0) are employed at the factory. In the event the instrument does not function properly or is damaged, Gamma Scientific Inc. should be contacted with regard to the specific symptoms of the problem.
SECTION 1 INTRODUCTION 1.1 General Information Gamma Scientific’s SpectralLED® Tunable LED Light Source (Model: RS-7) is a multi-channel light source capable of providing single channel illumination or broadband illumination using multiple channels. It is designed to simulate broadband illuminants or any arbitrary spectrum by precisely combining the output of its LED channels closely recreate real-world spectra.
Page 12
Table 1. RS-7 System Specifications continued Electrical Resolution 16 bit DAC for channel current drivers (32 independent DACs, 1 for each LED channel) 24 bit ADC for internal radiance monitor/feedback Dynamic Range Spectrum dependent, 4-5 decades typical Adjustment LED Control Pure DC constant current with floating differential sensing Software Firmware contains full spectral calibration, handles spectral fitting, preset storage,...
SECTION 2 OPERATING PROCEDURES 2.1 Principle of Operation 2.1.1 Overall Design The SpectralLED® RS-7 Tunable Light Source uses light emitting diodes driven by digitally controlled constant current sources. The use of precision voltage references, along with active optical feedback, enables a stable output with extremely linear brightness adjustment.
Page 15
Step 3. Connect the USB cable to the host computer, drivers should automatically install on Windows and OSX. a. If drivers do not automatically install, please use the drivers provided by Gamma Scientific. Step 4. On the host computer, determine the COM port assigned to the RS-7.
Page 16
Step 5. On the host computer, start terminal emulation software of your choice, and set the following serial connection parameters (e.g. Tera Term for Windows, CoolTerm for OSX). a. Baud rate: 460,800 (note that the RS-7 may be optionally configured for 115,200 baud operation) b.
SECTION 3 SPECTRALLED - SPECTRAL SIMULATION ASSISTANT Getting Started To connect to the RS-7, click on the Settings menu (2) and then select the a COM port by clicking on the down- arrow and selecting the appropriate COM port going to the RS-7. Don’t know which COM port to select? Click on the Windows Start button, then right-click Computer, then click Manage.
3.1 SpectralLED Assistant Main Window CLICK ON THE ARROW AND SELECT FROM DROP-DOWN LIST to load an existing spectral preset (1k). DRAG the individual channel power controls (1c) up and down to manually create/modify a spectrum. DRAG the main power level control (1b) up and down to change the current spectrum’s overall power level. CLICK, TYPE IN A NUMBER, and PRESS ENTER to input a specific power level, CCT, or chromaticity in the boxes (1a).
Page 19
1a. Output Pane Power Level shows the output power of the currently generated spectrum as a percentage between 0 and the RS-7’s Soft Limit (see the SLM command, section 4.6.19) which represents the maximum possible power that can be achieved for the current spectrum. Radiance (or Irradiance), Luminance (or Illuminance), CCT (Correlated Color Temperature in degrees Kelvin), and 1931 x,y chromaticity are also reported.
Page 20
changing to relative power levels, the controls are all scaled relative to the channel which is set to the highest output power; in this way, the actual spectrum as shown by the controls’ relative positions to each other can be seen regardless of the RS-7’s Main Output Power.
Page 21
list, enter a description in the Enter Description box, and click Ok. To delete a preset, select one of the presets from the list, and press the DELETE key. Note that the RS-7 always loads preset #0 at power-on, so you can specify the initial power-on state of the RS-7 by merely saving the desired configuration, spectrum, &...
3.2 Settings Menu Select COM Port: Connects to the RS-7 Disconnect From COM Port: Disconnects to the RS-7, freeing the COM port for another program to use Select COM Port: Click on the arrow to display a list of available COM ports, then click on the appropriate COM port in order to connect to the RS-7.
Page 23
Disconnect From COM Port: Click to release the COM port, in order to allow another program to access it. SpectralLED Assistant will re-connect to the RS-7 automatically whenever you perform any operation that requires SpectralLED Assistant to communicate with the unit. Tristimulus is 2°...
Page 24
Center, which represents the wavelength exactly midway between the two half-power points (i.e. the midpoint of the two wavelengths that define FWHM): (ASCII Command API reference PTY Section 4.2.3) Include White Channels in Spectral Fit When performing a least-squares spectral fit of multiple RS-7 channels to a target spectrum (see section 3), the RS-7 can be instructed to include broadband white channels as part of the solution.
Page 25
(µW/cm²) and Illuminance (lm/m², also called lux, or optionally in footcandles; see 2c). In order to operate as an Irradiant source, SpectralLED Assistant must be told the working distance from the output port plane in order to scale the irradiance units appropriately. Click on the box, type in the desired working distance in millimeters, and press ENTER.
Page 26
Normally SpectralLED Assistant performs all of the math-intensive calculations involved in spectral matching and colorimetric spectral modifications itself (locally), both for execution speed and to support enhanced functionality. This can be disabled, in which case the RS-7 will be commanded to perform the functions itself (remotely).
3.3 Target Spectrum/Spectral Matching The RS-7 can match any arbitrary spectrum by using a least-squares-fit algorithm to set the individual Channel Power Levels (1c). The spectrum the RS-7 attempts to match is called the Target Spectrum. When the Target Spectrum menu is clicked, the CIE 1931 x,y chromaticity chart (1i) disappears and is replaced by the Target Spectrum pane (see Target Spectrum “Is Visible”...
Page 28
(3g) multiplied by the Target Spectrum Scale Factor (3h) multiplied by an Illuminant (3i). Here it appears as a flat line (all spectral data points = 1.0) because the Base Target Spectrum (3g) is Unity (all Spectral Data Points = 1.0), the Target Spectrum Scale Factor (3h) is set to 1.0, and no Illuminant is being applied (3i) (meaning the effective illuminant is actually unity at all wavelengths as well.) 3b.
Page 29
3e. X-Rite® MacBeth® ColorChecker® This will load the illuminant-corrected spectral reflectance of one of the 24 ColorChecker® patches into the Base Target Spectrum (3g). 3f. Create Base Spectrum From Current Output This will simply copy the RS-7’s current Output Spectrum (1f) into the Base Target Spectrum (3g), correcting for (removing) any Target Spectrum Scale Factor (3h) and Illuminant (3i) being applied.
Page 30
The value displayed in this box is used to scale the entire Target Spectrum (3a) up or down. Click in the box, type in a new number, and press ENTER to scale the Target Spectrum up or down as desired. The final Target Spectrum (3a) is the combination of the Base Target Spectrum (3g) multiplied by the Target Spectrum Scale Factor (3h) multiplied by an Illuminant (3i).
weighting functions in order to obtain the exact same chromaticity as the Target Spectrum (this will necessarily worsen the least-squares-fit spectral match to a small degree but guarantees a perfect colorimetric match). 3n, 3o. Wavelength Range For Spectral Operations When performing the least-squares-fit spectral matching (3k, 3l) to the Target Spectrum (3a), the beginning and ending wavelengths of the part of the spectrum you wish to match is shown here, and are also shown as graphic brackets on the Spectral Display Plot.
SECTION 4 ASCII COMMAND API 4.1 Overview Communication with the RS-7 is performed over an FTDI USB UART, with the nominal baud rate of 460.8K baud. The unit can be optionally configured to operate at 115.2K baud instead. UART format is 8 data bits, 1 stop bit, no parity.
Page 33
For a command which cannot be completed due to an error, the RS-7 will instead respond with ?nn - [Explanatory String]<CR><LF> where nn represents an error code, and [Explanatory String] expands on the error with a human-readable explanation. Issuing CTRL-A (ASCII code 0x01) will re-execute the previous command (“Again”) SpectralLED®...
Page 34
Command List 4.2 Individual Channel Control 4.2.1 Set Channel output Power level 4.2.2 Pulse channel 4.2.3 Peak Type 4.2.4 Request (optional) Wavelength Monitor System wavelength, irradiance 4.2.5 Get LED channel Information 4.2.6 Scan channels one at a time 4.2.7 Set Nominal output Power Level used by SCA, LIN 4.2.8 Channel Grouping disable/enable 4.2.9...
Page 35
4.6 Hardware & Housekeeping 4.6.1 Display help text 4.6.1 HELP Synonym for above 4.6.2 Calibration Type, Radiant or Irradiant souce 4.6.3 Calibration information string 4.6.4 Accessory Transfer Function 4.6.5 Irradiance mode working distance, millimeters 4.6.6 Output settling Threshhold, Percent 4.6.7 LED board Serial Number 4.6.8 RS-7 Unit Serial Number...
4.2 Individual Channel Control 4.2.1 - SCP - Set Channel Power Level Sets or reports the power level for one or more channels using the units set by UNI. When setting the output level, the “Ok” response will not be returned until the RS-7 output has settled to an accuracy of STP percent. If channel grouping has been enabled (see GRP), setting any channel that is a member of a group (see CGL) will set all channels of that group identically.
change to radiometric units µW/cm or µW/cm uni0 report power level of channel #2 in radiometric units scp2 68.723 report total integrated output of RS-7 in radiometric units identical because there’s only a single channel operating 68.723 set channel #3 to 40 µW/cm or µW/cm scp3,40 report total integrated output of RS-7 in radiometric units...
centroid of pulse was 707.8 nm, normalized steady-state (ir)radiance worked out to 87.51 707.8,87.51 4.2.3 – PTY - Peak type When the RS-7 reports an LED channel’s wavelength (commands such as SCA, LIN, MON), the manner in which the wavelength is calculated can be set to one of three types: Type 0: Centroid, which is the amplitude-weighted average of all wavelengths of the spectrum.
4.2.4 - MON – Wavelength Monitor System Query If the RS-7 is equipped with the optional Wavelength Monitor System, this command requests centroid/peak/center wavelength (see PTY) and (ir)radiance of the currently active wavelength (only a single wavelength must be active). Syntax: query Monitor System MON C...
4.2.6 - SCA - Scan Thru Individual Channels/Channel Groups by Increasing Wavelength Activates channels one at a time at the NPL power in order of increasing centroid/peak/center wavelength (see PTY). If two or more channels share the same wavelength, then they are output in order of increasing FWHM. The currently operating channel number(s), wavelength, FWHM, and output (ir)radiance in µW/cm µW/cm /sr (see CTY, IRR) are reported each time, and are not returned until the RS-7 output has settled to an...
query the current Nominal Power Level Nominal Power Level is 70% increase Nominal Power Level to 90% npl90 4.2.8 GRP - Channel Grouping Enable/Disable Multiple channels can be populated with the same LEDs, and operated in parallel in order to increase effective output power for certain wavelengths.
4.2.10 – OCL - Offending Channels List In response to an error message such as “channel power unreachable” or “SLM exceeded”, you can ask the RS-7 for a list of those channels which were attempted to operate beyond their limits, or otherwise generated an error.
4.3 Presets A “preset” is defined as a complete set of all 64 channel power level settings (see the SCP command, Set Channel Power). 4.3.1 - PRE - Recall Preset Loads a previously stored preset & sets the RS-7 to output the associated spectrum. When loading a preset, the “Ok”...
load next higher preset pren 3,Bob’s test spectrum load next higher preset pren 4,Blackbody to 1000nm@75uW 4.3.2 - SPR - Store Preset Stores the current RS-7 output state as a preset, with an optional descriptive ASCII string attached. Syntax: SPR [preset],[preset name as ASCII string up to 63 characters] where [preset] is an integer between 0 and 99, and [preset name] is a descriptive string that may include delimiters (such as spaces or commas) as this argument is treated literally and is not parsed.
Page 45
request list of stored presets pre* 0,sample1/D65@200lux 3,Bob’s test spectrum … 23,Warm white LED@2500lux extra <CR><LF> terminates list SpectralLED® RS-7 USER MANUAL Page 44...
4.4 Spectral Operations 4.4.1 - WLR - Set Wavelength Range Sets or reports the operating wavelength range for spectral operations, including spectral data transfers to and from the RS-7. Syntax: WLR [startWL],[endWL] set wavelength range [startWL] to [endWL] report currently set wavelength range where [startWL] and [endWL] are integers between 360 and 1100, representing nanometers, with [startWL] <...
Page 47
2. followed by a comma 3. followed by unsigned 16-bit integers as binary byte pairs, big-endian (most significant byte first), the number of byte pairs determined by the current WLR i.e number of byte pairs = [endWL] – [startWL] + 1 4.
1.4857E-6,G7as87GH&s8c9Hjh(*89dhv8duov8d9vy8D7igvIUG(7fgt79T3rgi93h8f8(*Hvp8H#g8h#hf78f6<CR><LF> …scale factor, followed by comma, followed by [endWL] – [startWL] + 1 byte pairs with a final <CR><LF> at the end set TSP tsp1.5893e-3,^%!7Ybd7Pdp9fTP(D7tfgp9DfPDTfp…DFDFp9YP(YyP(FY(DYFDFFYY*(FydDuhDUHDHG&a …scale factor, followed by comma, followed by [endWL] – [startWL] + 1 byte pairs 4.4.3 - OSP - Output Spectrum Outputs the spectral data of the current RS-7 output spectrum, either the combined total spectrum or the spectrum of an individual channel.
STS. The data are sent from/to the RS-7 in the format specified by STM over the wavelength range specified by WLR. When sending a target spectrum to the RS-7, data points outside the WLR are set to 0. Syntax: transmit the current target spectrum to host send target spectrum to RS-7 using STM 0 TSP [data],[data],…,[data] send target spectrum to RS-7 using STM 1...
set wavelength range 380 – 650nm wlr380,650 send the target spectrum tsp1.129,1.38,2.2818,…,0.084 select photometric units (lux or nits) uni1 scale target spectrum to 2000 lux/nits sts2000 perform the fit report the spectral mismatch error between TSP and OSP as %RMS 3.481 get the final resultant output spectrum 5.939613,4.743708,7.146379,35.52672,28.65044,39.23233,2440.087,519.4869,712.7541,2044.095,281.0387,20...
modify chromaticity to CIE xy of (0.2750,0.4044) ccs0.2750,0.4044 report final chromaticity 0.2750,0.4044 4.4.7 - RPE - Report RMS Error % OSP vs. TSP Reports the spectral mismatch as the RMS of the deltas between the target spectrum TSP and the output spectrum OSP divided by the mean of the target spectrum TSP, over the wavelength range WLR.
Page 52
perform the fit color-correct for perfect color match save the result as preset #23 spr23,Light Skin under D50 @150lux SpectralLED® RS-7 USER MANUAL Page 51...
4.5 Integrated Absolute Units, Colorimetry 4.5.1 UNI – Set Units: Radiometric (irradiance or radiance, µW/cm² or µW/cm²/sr), Photometric (illuminance or luminance, lm/m [lux] or cd/m [nits]), or Internal Units (0-100%) Selects between radiometric (irradiance, radiance), photometric (illuminance, luminance), and internal (0-100%) as units of integrated energy.
Examples: request current calibration type RS-7 is operating as an Irradiant source set units UNI to irradiance/radiance uni0 report current output level µW/cm or µW/cm 272.12 set units UNI to illuminance/luminance uni1 lm/m (lux) or cd/m (nits) 519.852 set output to 300 lux (lm/m out300 Note that changing the output level using OUT can result in a chromaticity shift in the final output spectrum OSP, as OUT merely adjusts all channels’...
chromaticity is now unchanged from the original 0.4481,0.4077 4.5.4 - OUTA - Report Actual (sampled) Output power level as UNI While the OUT command is used to set & report the nominal, or intended optica output power level, one can read the RS-7’s actual power level, as sampled by the unit’s internal monitor photodiode, in units of UNI, at any time.
7920.6 outa 7891.9 4.5.5 - SOB - Standard observer select, 2 degree or 10 degree Sets or reports the current CIE Tristimulus Standard Observer Included Angle as 2 degrees or 10 degrees. The default at power-on is always 2 degrees. Syntax: SOB [2|10] set standard observer to 2 or 10 degrees...
power level in photometric units (lm/m , cd/m ), identical to what the OUT command would report when UNI = Syntax: OXYZ report output spectrum OSP tristimulus Returns three ASCII floats separated by a comma indicating the (X, Y, Z) tristimulus. Examples: report tristimulus of current output spectrum OSP oxyz...
Examples: report tristimulus of target spectrum TSP txyz tristimulus X, Y, and Z 678.5079,683.7131,518.6062 4.5.10 - CCT - Correlated Color Temperature of OSP in degrees Kelvin Reports the Correlated Color Temperature of the current output spectrum OSP in degrees Kelvin. Syntax: report output spectrum OSP correlated color temperature Examples:...
4.6 Hardware & Housekeeping 4.6.1 - HLP or HELP - Display Help text Displays a brief listing of the RS-7’s command set. Syntax: display help text synonym HELP 4.6.2 - CTY - Calibration Type, Radiant or Irradiant source This command is used to query the RS-7 as to the type of calibration currently active, either an Irradiant source (absolute units of µW/cm or lm/m [lux]), or a Radiant source (absolute units of µW/cm...
Calibration Type unit is currently a Radiant souce enable ATF #1 atf1 unit restarts Gamma Scientific RS-7 Firmware Version 1.00 request currently active ATF’s Accessory Transfer Function 1 is now active request current Calibration Type unit is now an Irradiant source with a working distance of 300 mm Note that the unit will restart when the active ATF(s) are changed, in order to re-load the spectral calibration data with the Accessory Transfer Function(s) applied.
RS-7 can also be operated as an Irradiant source, with units of µW/cm² and lm/m (lux). The IRR command is used to specify the working distance, in millimeters, from the outer face of the RS-7 to the target under illumination. The irradiance units will automatically be scaled based on the specified working distance (and also the iris position, for RS-7’s equipped with the optional motorized iris, see the IRI command).
4.6.7 - LSN - LED board serial number Reports the serial number as stored in the LED board’s on-board read-only-memory. This serial number cannot be altered. Syntax: report LED board serial number Example: LHX0152 4.6.8 - USN - RS-7 unit serial number Reports the serial number as stored in the RS-7 non-volatile memory.
Syntax: perform integrity check ICK V perform integrity check, verbose mode (reports all operations step-by-step) 4.6.10 - BAT - Basic assurance test This will cause the RS-7 to rapidly sequence through all channels in order to verify basic functionality. This is intended to execute as quickly as possible and is not intended as a comprehensive audit of each channel’s performance.
Examples: report latest channel power audit results channel power level relative to calibrated/expected level, as percentages 1,-1.4 2,-0.3 3,+0.31 4,-2.94 … 62,-.04 Final extra <CR><LF> terminates list 4.6.12 - PDI - Read photodiode(s) response Reads the output of the A/D converter monitoring the internal photodiode. The results are displayed as a 24-bit signed integer (range: -8,388,608 - +8,388,607).
2784021 2784421 4.6.14 - SDC - Spectral calibration data CRC32 Calculates the CRC32 of the currently stored LED spectral calibration, and the CRC32 of the currently stored Wavelength Monitor System spectral calibration. These can be compared to the CRC32 values stored in the Calibration Information String (see CAL).
4.6.17 - FBK - Optical feedback enable/disable Enables or disables the real-time optical feedback. Normally enabled by default, the feedback can be disabled in order to provide direct control over the constant-current sources driving each channel. Syntax: report feedback setting FBK [0|1] disable [0] or enable [1] feedback Examples:...
SLM [limit] set soft limit to [limit] %, where [limit] is an integer between 0 and 100 Examples: query soft limit decrease soft limit to 80% slm80 4.6.20 - ALA - Query/reset alarms Reports the presence of an alarm condition, or resets (clears) the alarm (if possible). A description of the various alarms can be found in Section 4.7.2.
?F1 - initialization fault restart unit to see what errors occur during initialization channel #14’s calibration appears corrupt CH14 ERROR/CALIBRATION DATA: CRC or structure error Gamma Scientific RS-7 Firmware Version 1.07 attempt preset #12 again pre12 still won’t function because of the initialization error...
operation permitted although channel #14 is suspect 4.6.23 - UDB - User Data Block Reads or writes a user block of binary data from/to internal EEPROM. The data is accessed as one of 20 4K blocks, providing 80K bytes total user storage. The data is transferred as 4096 bytes of binary data. Syntax: UDBR [block] read 4K user data block [block]...
Page 70
mode command (IRR), the absolute units of irradiance (UNI 0, µW/cm², and UNI 1, lm/m ) will be automatically scaled to reflect the proper irradiance at the target (at the working distance of IRR millimeters) accordingly. Syntax: report current iris position as percentage of closed (0 – 100%) IRI [%] set iris position as percentage closed (0 –...
4.7 Error Codes and Alarm Messages 4.7.1 Error Codes: ?01 - missing argument ?02 - argument out of range ?03 - unrecognized command ?04 - buffer overflow Exceeded the RS-7 input buffer size of 8192 bytes when a command is being received ?05 - LSQ fault FTS failed to find a solution ?06 - channel power unreachable...
Page 72
zeros ?16 - OSP is zero Attempt made to change RS-7 output level via OUT command, when all channels are set to zero ?17 - preset not found Attempt made to load a nonexistent preset (available presets can be queried via PRE*) ?18 - output level lock timeout The RS-7 failed to achieve the requested RS-7 output within STP percent after ½...
4.7.2 Alarm Codes: ?A1 - channel power limit The realtime optical feedback wants to drive one or more channels past 100% power in an attempt to maintain RS-7 output optical lock within STP% of PDT ?A2 - channel power ADP limit The realtime optical feedback wants to drive one or more channels past ADP% allowable power deviation ?A3 - excessive feedback correction indicated...
4.7.3 Fault Codes: ?F1 – initialization fault A critical problem such as corrupted data, invalid calibration, or an internal hardware failure was detected during initialization. The unit will refuse all future commands except RST, ICK, and CFC. The CFC command can be used to forcibly clear the fault and allow the RS-7 to continue operating (albeit in a compromised/unknown state).
SECTION 5 GLOSSARY < > Symbols used to indicate a key on the keyboard. ASCII ASCII stands for American Standard Code for Information Interchange. ASCII code is the numerical representation of a character such as 'a' or '@' or an action of some sort.
Page 76
forward biased. Light Electromagnetic radiant energy that is visually detectable by the normal human observer, radiant energy having wavelengths from about 380 nm to about 780 nm. Linearity Refers to a mathematical relationship or function that graphically represents as a straight line, as in two quantities that are directly proportional to each other, such as voltage and current in an RLC circuit, or the mass and weight of an object.
Routine A series of actions allowing data to be calculated or manipulated. Operations controlled by menu selection. Source An object that produces light or other radiant flux. Spectral Range is the spacing in optical frequency or wavelength between two Spectral Range successive reflected or transmitted optical intensity maxima or minima of an interferometer or diffractive optical element.
Page 78
2006/95/EC EU Low Voltage Directive 2004/108/EC EU Electromagnetic Compatibility Directive The undersigned hereby declares, on behalf of Gamma Scientific of San Diego, California, that the above-referenced product, to which this declaration relates, is in conformity with the provisions shown. Signed:...
Page 79
San Diego, CA 92131 United States of America RoHS CERTIFICATE Product Family: SpectralLED® RS-7 Series Products Manufacturer: Gamma Scientific 9925 Carroll Canyon Road San Diego, California 92131 United States of America Object of Declaration: Conformity with Relevant Standards Used 2000/53/EC...