iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

49
iCAT LED Analyser User Guide ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com 1 iCAT LED Analyser User Guide ShenZhen iCAT Technology CO.,Ltd Website: http://www.icatprog.com E-Mail: [email protected] [email protected] Manual version: 5.0 Updated date: Sept.,2017

Transcript of iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

Page 1: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

1

iCAT LED Analyser

User Guide

ShenZhen iCAT Technology CO.,Ltd

Website: http://www.icatprog.com

E-Mail: [email protected]

[email protected]

Manual version: 5.0

Updated date: Sept.,2017

Page 2: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

2

About the User Guide:

Shenzhen iCAT Technology Co., Ltd. continued to focus on development of the iCAT

series LED analyser, Shenzhen iCAT Technology Co., Ltd. reserves the right to modify

and upgrade the relevant product information without notifying the customer. At the same

time reserves the right to make any changes and upgrades of the document at any time

without prior notice.

iCAT LED analyser is divided into two types according to the output format, data

output is mainly used in the iCATFT series of the function test system, and the voltage

output is mainly used in the iCATOV series on the ICT analyses, the iCATFT series

consists of 3 models, namely, they are iCATFT04 of 4 channel, iCATFT08 of 8 channel,

and iCATFT16 of 16 channel. This manual corresponds to iCAT LED analyser of the

iCATFT series.

Page 3: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

3

CHAPTER1 PRODUCT INTRODUCTION ....................................................................................................................... 5

1. PRODUCT FEATURES .............................................................................................................................................................. 6

2. SCOPE OF APPLICATION ......................................................................................................................................................... 6

3. BASIC FRAMEWORK OF ICAT LED ANALYSER ..................................................................................................................... 7

4. ICAT APPEARANCE DIAGRAM ............................................................................................................................................... 7

5. LED INDICATION ................................................................................................................................................................... 8

6. PRODUCT SPECIFICATION ...................................................................................................................................................... 9

7. PHYSICAL INTERFACE SPECIFICATION ................................................................................................................................ 10

8. PACKING LIST OF PRODUCT ................................................................................................................................................. 13

9. MAIN SUPPORTED SOFTWARE TOOLS OF ICAT ................................................................................................................... 14

CHAPTER2 LED COLOR AND BRIGHTNESS ANALYSIS .......................................................................................... 15

1.LED COLOR TEST ................................................................................................................................................................. 15

1.1 Hue and Saturation ....................................................................................................................................................... 15

1.2 CIE1931 xy chromaticity .............................................................................................................................................. 15

1.3 White LED Test ............................................................................................................................................................. 16

2.LED LUMINOUS INTENSITY ANALYSIS .................................................................................................................................. 16

3.THE WORK MODE AND SETTING OF THE ICAT LED ANALYSER .......................................................................................... 18

CHAPTER3 ICAT LED ANALYSER COMMAND FORMAT......................................................................................... 19

1. COMMAND FORMAT ............................................................................................................................................................. 19

2. SUMMARY OF COMMAND LIST ............................................................................................................................................. 21

2.1Command parameter settings ........................................................................................................................................ 25

(1)Set I2C Address ............................................................................................................................................................... 25

(2)Set CH##.xoffset ............................................................................................................................................................. 25

(3)Set CH##.yoffset ............................................................................................................................................................. 26

(4)Set CH##.wloffset ........................................................................................................................................................... 26

(5)Set CH##.intoffset ........................................................................................................................................................... 26

(6)Set CH##.Gain ................................................................................................................................................................ 27

(7)Set CH##.Intetime .......................................................................................................................................................... 28

(8)SetDefault XX ................................................................................................................................................................. 28

2.2 Read setting parameter command ................................................................................................................................ 29

(1)Get I2C Address .............................................................................................................................................................. 29

(2)Get CH##.xoffset ............................................................................................................................................................ 29

(3)Get CH##.yoffset ............................................................................................................................................................. 30

(4)Get CH##.wloffset ........................................................................................................................................................... 30

(5)Get CH##.intoffset .......................................................................................................................................................... 30

(6)Get CH##.GAIN ............................................................................................................................................................. 31

(7)Get CH##.intetime .......................................................................................................................................................... 31

(8)Get CH##.Setting ............................................................................................................................................................ 31

(9)Get Model ........................................................................................................................................................................ 32

(10)Get SN ........................................................................................................................................................................... 32

Page 4: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

4

(11)Get FW.VER ................................................................................................................................................................. 32

(12)Get HW.VER ................................................................................................................................................................. 33

2.3 Functional command .................................................................................................................................................... 33

(1)Get CH##.RGB ............................................................................................................................................................... 33

(2)Get CH##.HSI ................................................................................................................................................................ 33

(3)Get CH##.HSI2 .............................................................................................................................................................. 34

(4)Get CH##.Wavelength .................................................................................................................................................... 34

(5)Get CH##.Int .................................................................................................................................................................. 35

(6)Get CH##.xy.................................................................................................................................................................... 35

(7)Get CH##.RGBI .............................................................................................................................................................. 36

(8)Get CH##.CCT ................................................................................................................................................................ 36

(9)Get CH##.xyI .................................................................................................................................................................. 37

2.4 The whole read command ............................................................................................................................................. 37

(1)Get RGB.All .................................................................................................................................................................... 37

(2)Get HSI.AX ..................................................................................................................................................................... 38

(3)Get WL.All ...................................................................................................................................................................... 39

(4)Get XYI.AX ..................................................................................................................................................................... 39

(5)Get Int.All ....................................................................................................................................................................... 40

(6)Get CH##.All .................................................................................................................................................................. 40

2.5 Blinking LED reads command ..................................................................................................................................... 41

(1)Get CHXX.PWM ............................................................................................................................................................ 41

CHAPTER4 MULTIPLE DEVICES PARALLEL USE .................................................................................................... 42

1.USB connection schematic diagram ................................................................................................................................ 42

2.Multiple devices in parallel through I2C bus .................................................................................................................. 42

CHAPTER5 THE MAIN SOFTWARE TOOLS OF ICAT LED ANALYSER.................................................................. 43

CHAPTER6 INSTALLATION OF ICAT LED ANALYSER ............................................................................................ 44

CHAPTER7 LED ANALYSIS USING THE ICAT LED ANALYSER .............................................................................. 45

Page 5: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

5

Chapter1 Product Introduction

iCAT series LED analyser is a new generation of automatic LED analyser developed by Shenzhen iCAT

Technology Co., Ltd., mainly used in LED color and intensity automatic test for electronic products, such

as the LED on the RJ45 interface, the status indicator on the laptop, the status indicator on the car, and so

on. iCAT LED analyser has the advantages of high accuracy, repeatability, rich output interface, multiple output

formats and strong software functions,etc. It also provides the solution and combined with rapid analysis

system, which is an excellent solution for the automatic analyzing of LED color and intensity on the

analysis system.

According to the quantity of supportive fiber channel, LED analyser of iCAT series is divided into three

types:

Model Output type Description

1 iCATFT04 USB/RS232/I2C Support 4 test channels

2 iCATFT08 USB/RS232/I2C Support 8 test channels

3 iCATFT16 USB/RS232/I2C Support 16 test channels

4 iCATOV04 Voltage output 4 channels

5 iCATOV08 Voltage output 8 channels, One-to-Two optical fiber

6 iCATOV16 Voltage output 16 channels, One-to-Two optical fiber

This document describes LED analyser of three types of iCATFT04, iCATFT08, iCATFT16, and the

voltage output version of the document can download on the web site(http://www.icatprog.com).

LED analyser of iCAT series provides the outputs of USB, RS232 and I2C interfaces. Through the USB

interface, you can easily communicate with the PC analysis program. At the same time through the RS232

and I2C interfaces, iCAT can be easily combined with the self-developed test control platform. LED

analyser of iCAT series provides abundant debugging software and integration tools, so that customers

quick and accurate debugging and integration of LED automatic test in the system debugging with half

the effort. LED analyser of iCAT series provides many kind numerical output of RGB, HSI, XY, Color,

WaveLength, and make the analyses are more reliable and stable.

Page 6: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

6

1. Product features

◆Supports USB, RS232, and I2C interfaces

◆Adopts high light insulation mechanical design to make sure high accuracy test

◆The device comes with embedded operating system, and the device has the function of automatic

determination

◆Support multiple ICT test platforms of Teradyne, Agilent, and TRI

◆The device can be cascaded through I2C, which supports up to 256 devices cascaded and supports up

to 4096 LED tests at the same time.

◆High test speed, the standard brightness of LED is tested at around 100 milliseconds

◆Provides free device driver, debugging programs, and command line tools to make easier of debugging

and system integration

◆Supports RGB, Hue, Saturation, Intensity, XY, and Color output

◆Provides test program that the turnkey model has really been achieved

2. Scope of application

LED analyser of iCAT series is mainly used in the following aspects:

◆Test the color and brightness of all LED on the PCA

◆The color and brightness test of RJ45 network status indication LED

◆Mobile phones, notebooks, TVs and other screen color and brightness test

◆Color and brightness testing of related LED in automotive products

◆Color and brightness testing of instructions LED in industrial products and medical products

◆LED color and brightness test of system products

◆LED color and brightness of ICT platforms

Page 7: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

7

3. Basic framework of iCAT LED analyser

Taking iCATFT04 as a sample, the iCAT architecture diagram is as follows. The difference between the 8

channel and 16 channel is the difference in the supported fiber channel.\

LED1

4. iCAT appearance diagram

iCATFT04: 0—3 channels are available iCATFT08: 0—7 channels are available

iCATFT16: 0—15 channels are available

Fiber1

Fiber2

Fiber3

Fiber4

Sensor

Sensor

Sensor

Sensor

Controller

USB I2C

RS232

LED2

LED3

LED4

0 3 7

8 15

RS232

Power in

USB

I2C

Page 8: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

8

5. LED indication

There are two LED on the iCAT LED analyser, which are the USB status indication LED and the Power

status indication LED. When power on, the Power status LED is light, indicating power on, and the USB

status indicates LED is light that indicating USB connection is normal. As shown in the following figure:

Page 9: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

9

6. Product specification

Type Item Parameter

Electrical

specification

Input voltage

USB interface power supply

External power supply

Operating voltage: DC 6~12V

Working current 120mA

Communication

interface USB、 RS232、 I2C

Data output format RGB, Hue, Saturation, Intensity,

CIE1931xy, WaveLength, Color

Maximum parallel

quantity 256

Maximum test

quantity of LED 4096(adopt 16 channel model)

Optical Testable optical

wavelength 450nm to 650nm

Accuracy Chromaticity – Typical + 0.01 @ x=0.33, y=0.33

Repeatability

Chromaticity xy <1%

Hue <1%

Saturation <1%

Intensity <3%

Mechanical

Spec

Dimension 110mm X 88mm X 25mm(L*W*H)

Length of fiber Standard of 0.8m (customized

according to customer requirements)

Diameter of fibre Outside diameter: 1.3mm, inner

diameter: 1.0mm

Working temperature 0˚C to +80˚ C

Page 10: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

10

7. Physical interface specification

7.1 The iCAT LED analyser has fiber channels, and the quantity of fiber channel is related to the model of

products. And the product is connected to the LED to be tested via the fiber channel. See below figure:

7.2 The right side of the iCAT LED analyser is an external power interface and RS232 interface. See

below figure:

7.3 iCAT LED 测试仪左侧面为 USB及 I2C 接口,详细如下图所示:

RS232 interface

Power interface

16 fiber channel

Page 11: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

11

The iCAT LED analyser supports the USB, I2C, and RS232 interfaces.

USB interface:

When using the USB port, you need to install the USB driver, and the driver can download from our

company's website. After you install the driver, USB will be virtual into serial port, and its port number

can be changed as required. When communicating with the USB port, the analyser will not require an

external power supply, and will preferentially use the power supply on the USB as the power supply. USB

supports multiple operating systems such as Windows, Linux, Android, MAC, OS, and so on.

After connecting to the PC, the system will prompt the driver installation (the download link of driver:

http://www.icatprog.com/col.jsp?id=125), after you install the driver, you can see the USB Serial Port

project on the computer management, and this is the iCAT device.

USB interface

I2C interface

Page 12: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

12

RS232 interface:

The default supported arguments parameter is 19200 baud, 8 data bits, and 1 stop bit, there is no parity,

when using RS232 as a communication interface, please use the 9PIN serial port to connect line

equivalence (there is no need to exchange RX and TX signals), at the same time to provide the external

power supply to the iCAT LED analyser.

To connect through the RS232 interface, you only need to use RXD and TXD signals. Because the iCAT

has already made the signal connection in the interior, so the connection line just needs to use the direct

connection serial port signal line, does not need to make the intersection.

PIN Explain Main control terminal

RS232 interface

iCAT LED analyser

PIN2 RXD RXD TXD

PIN3 TXD TXD RXD

PIN5 GND GND GND

Note that the serial baud rate is 19200

The commands of serial port transmission need to take carriage return (16 hexadecimal number 0D) as

end mark, iCAT returns information take \n (16 decimal number 0A) as the end mark.

For PLC devices that cannot send ASCII characters, you can directly send 16 hexadecimal number, and

translate the characters of the commands directly into the corresponding 16 hexadecimal number. For

example, the Get sn command: Send 67 65 74 20 73 6E 0D, iCAT return 25457272 6F 72 0A

I2C interface:

iCAT LED analyser can be connected to any I2C master controller from a device as a I2C, and the iCAT

LED analyser can be easily integrated with controllers such as the MCU class using this interface. Before

communication need to use the SetAddr command to set the I2C address of the device in the use of I2C

interface and iCAT LED analyser.

Page 13: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

13

I2C interface definition:

Pin Definition

Pin1 SDA

Pin2 Ground

Pin3 SCL

Pin4 Ground

8. Packing list of product

Model Packing list

iCATFT04

4 channel iCAT LED analyser

4 fiber lines

1 Type B USB cable

4 fiber optic connectors

iCATFT08

8 channel iCAT LED analyser

8 fiber lines

1 Type B USB cable

8 fiber optic connectors

iCATFT16

16 channel iCAT LED analyser

16 fiber lines

1 Type B USB cable

16 fiber optic connectors

Controller

iCAT iCAT iCAT iCAT

SDA

SCL

Page 14: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

14

9. Main supported software tools of iCAT

No. Name Description

1 USB Driver Windows、Linux、MAC OS、Android

2 iCAT XP

User debugger supports functions of equipment

configuration, data reading, sending commands,

color restore

3 iCAT Test Program

User testing procedures support functions of test

program creation, upper and lower learning and

setup, and running test program

4 iCATComm Windows command line tools support the

dispatch and execution of commands

The related software of iCAT are available download the latest version of the manual on website

download center of http://www.icatprog.com.

Page 15: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

15

Chapter2 LED color and brightness analysis

1.LED color test

The iCAT LED analyser supports a variety of formats to represent colors, including RGB, Hue, Saturation,

CIE1931 xy and wavelength,etc. Each representation can be expressed in color.

1.1 Hue and Saturation

Hue uses 360 degrees to represent colors. Hue uses a degree value to represent the color value of RGB,

which is the most convenient in LED color testing. For example, the red Hue value is near 0 degrees, the

green Hue value is near 120 degrees, and the blue Hue value is near 240 degrees. As shown in the

following figure:

Saturation indicates the purity of color, the boundary of the Hue circle indicates saturation of 1, and the

center of the circle represents the saturation value of 0. the Saturation value is higher that indicates the

color is more pure. Pure color saturation value of 1. Pure white saturation is 0.

Usually, using two parameters of Hue and Saturation can determine the color of a LED, which is

recommended by the LED test parameters.

1.2 CIE1931 xy chromaticity

CIE is short for the Conseil International de Illumination. CIE formulated a range of colorimetric

standards. Using color coordinate of xy to determine the color in the 2D coordinates, the chromaticity

diagram is CIE1931 chromaticity diagram. For example the coordinates of a point in a chromaticity

diagram is x=0.4832, y=0.3045, then its color matches the color of red apple. The white xy value

coordinate is (0.33,0.33); the color surrounding the edge of the color space is spectral color, the maximum

saturation boundary represents the spectral color, and the number on the boundary indicates the

wavelength of the spectral color, and the outline contains all the perceived tones. As its shown in the

Page 16: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

16

following figure:

1.3 White LED Test

For ordinary LED testing, we usually use the color and brightness ways to test, but the white LED

test is different from the ordinary LED test. White is not a kind color, white is the color of a mix of all

colors. When the three colors of R, G, and B are mixed in a similar proportion, they appear white color.

When testing white LED, saturation must be used. The value of saturation is between 0% and 100%.

When the saturation is 0%, it is expressed as pure white, and 100% is expressed as pure other colors.

In the actual test, white saturation values are usually changes in the range of 30%. The white saturation

value is the purity of white, saturation values closer to 0 represent more pure white. However, the specific

value should be determined according to the actual white LED test value.

Most LED manufacturers use the chromaticity of x,y coordinate values to identify the white LED, the x,y

coordinate values between 0 and 1. The x, y coordinates of white LED at about 0.33,0.33. But the value is

not entirely certain. Because there are some white LED is cool tone, and there are some white LED is

warm tone.

When using iCAT LED analyser to test white LED, it is recommended to use saturation and x, y

chromaticity coordinate value to test as the criterion.

2.LED luminous intensity analysis

Intensity is used to test the test index of luminous intensity of LED. The iCAT LED analyser supports

multiple instruction outputs test LED value of Intensity, which consists of two commands, Get,

CHXX.HSI2, and Get CHXX.INT, and the command output is output in 0-99999 form. While retaining

the Get CHXX.HIS command, this command provides the output format of luminous intensity

Page 17: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

17

percentage.

The LED Intensity test of the iCAT LED analyser is a relative value test. First, we need to study the

standard product and read the Intensity value of the standard products, then, according to this standard,

the upper and lower limits are set as test criteria.

The test value of Intensity can be affected by many factors. The following factors affect the final test

value.

◆The internal diameter of the used fiber. The internal diameter is greater that the light-guide quantity is

higher, and the test value of Intensity is greater.

◆The distance and angle of the fiber from the LED. The distance and angle of the fiber from the LED

will affect the import of light, which will affect the test value.

◆The influence of ambient light. The intensity of ambient light also affects the value of Intensity

◆A light emitting LED to around the test LED affects the accuracy of test LED test

◆Blinking LED

◆The selected work mode, the iCAT LED analyser supports different working modes and corresponding

parameters

◆The choice of different patterns, and the test results will be different

◆whether using an optical fiber connector

In order to ensure the stability of test, recommend the use of iCAT optical fiber connector. The test as

shown in the following figure:

Page 18: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

18

3.The work mode and setting of the iCAT LED analyser

For different luminous intensity LED test, iCAT LED analyser provides 3 initial settings of standard light

source, bright light, weak light,etc. Setting command format is: SetDefault XX. XX is 01,02,03. The

corresponding initial values of each parameter are as follows:

XX

value

Light source Gain Intetime x y wavelength Intensity

01 Standard light source 16X 100ms 0.000 0.000 000 00000

02 Bright light 1X 25ms 0.000 0.000 000 00000

03 Weak light 60X 200ms 0.000 0.000 000 00000

Among them, Gain is gain times, Intetime is the sensor integration time. The iCAT LED analyser

provides 4 gain multiples that can be set to the gain multiples of the specified channel by a separate set

command. The corresponding relation and setting commands are as follows:

Gain times Set command Corresponds to the value of X

1X Set CH##.Gain=X 1

4X Set CH##.Gain=X 2

16X Set CH##.Gain=X 3

60X Set CH##.Gain=X 4

iCAT LED analyser provides 5 kinds of sensor Intetime. Similarly, you can set the intetime of the

specified channel by a separate set command. The corresponding relation and setting commands are as

follows:

Intetime Set command Corresponds to the value of X

25ms Set CH##.Intetime=X 1

50ms Set CH##.Intetime=X 2

100ms Set CH##.Intetime=X 3

200ms Set CH##.Intetime=X 4

500ms Set CH##.Intetime=X 5

Page 19: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

19

Chapter3 iCAT LED analyser command format

1. Command format

The command of iCAT LED analyser is no need to case sensitive, and% represents output in the

command format. At the same time also need to pay attention to the blank in the command.

If the command format is wrong, the iCAT LED analyser will return to %Error. If the format is correct,

the corresponding value is returned. It is recommended to use the iCAT XP tools in the input command.

the Terminal page of ICAT XP supports command debug mode. As shown in the following figure:

You can also use the serial port tool for debugging commands, due to the iCAT LED analyser needs to use

the carriage return as end of command, so the serial tools need to support this setting, we recommend the

use of UartAsssist as a debugging tool, the tool can be downloaded in http://www.icatprog.com/col.jsp?

Id=125 page. When using the UartAsssist for command debugging, need to the following settings

Page 20: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

20

Select this item

Select this item

Page 21: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

21

2. Summary of command list

All commands of iCAT LED analyser are no need to case sensitive, but pay attention to the blank in the

command, such as: Get Model, for users who develop independently for two times should pay attention to

each command finally needs to add carriage return \R (16 decimal number 0D), and iCAT returns the

message with \n (16 Decimal 0A) as the end mark.

No

.

Command

type Command format Command function

1

Set Param

Set I2C Address=0xAA Set I2C address

2 Set CH##.xoffset=+(-)0. XXX Set the X offset value

3 Set CH##.yoffset=+(-)0. XXX Set the Y offset value

4 Set CH##.wloffset=+(-)XXX Set the wavelength offset

5 Set CH##.intoffset=+(-)XXXXX Set Intensity offset

6 Set CH##.Gain=X Set gain multiples

7 Set CH##.Intetime=X Set the sensor integration time

8 SetDefault XX Set the initial value of analyser

9

Read the set

param

Get I2C Address Read the I2C address

10 Get CH##.xoffset Read the X offset value

11 Get CH##.yoffset Read the Y offset value

12 Get CH##.wloffset Read the wavelength offset

13 Get CH##.intoffset Read the Intensity offset

14 Get CH##.Gain Read the gain multiple

15 Get CH##.intetime Read intetime

16 Get CH##.Setting Read the parameter settings

17 Get Model Read device type

18 Get SN Read Serial Number

19 Get FW.Ver Read the Firmware version

Page 22: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

22

20 Get HW.Ver Read the hardware version

21

Functional

command

Get CH##.RGB Read the RGB value of the

specified channel

22 Get CH##.HSI

Read the HSI value of the

specified channel

(Intensity:0-100)

23 Get CH##.HSI2

Read the HSI value of the

specified channel

(Intensity:0-99999)

24 Get CH##.Wavelength Read the wavelength value of

the specified channel.

25 Get CH##.Int Read the light intensity value

of the specified channel

26 Get CH##.xy

Read the CIE1931 xy

coordinate value of the

specified channel

27 Get CH##.RGBI

Read the values of RGB and

Intensity for the specified

channel

28 Get CH##.CCT Read the CCT value of the

specified channel

29 Get CH##.xyI

Read the CIE1931 xy

coordinate and Intensity value

of the specified channel

30

The whole

read command

Get RGB.All Read the value of the RGB for

all channels

31 Get HSI.AX Read the HSI value ofpartial

channel

32 Get WL.All Read Wavelength value of

partial channel

33 Get XYI.AX Read the values of xy and

Intensity for partial channels

34 Get Int.All Read the Intensity value of the

partial channel

35 Get CH##.All Read all values of the specified

channel

36 Blinking LED Get CH##.PWM Read the value of blinking

LED

Page 23: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

23

For users who use PLC or microcontroller, the string command may need to be converted into sixteen

hexadecimal. The following table for converting all of the above commands, users can follow each

command detailed and ASCII code character comparison table. Note that each command ends with

carriage return (16 hexadecimal number 0D), iCAT returns the message with the newline character (16

hexadecimal number 0A) as the end mark. Because the string command is not case sensitive, so pay

attention to the corresponding ASCII code in convert to 16 hexadecimal. The red characters in the

following table represent variable parameters.

No. String command 16 hexadecimal command

1 Set I2C Address=0xAA 53 65 74 20 49 32 43 20 41 64 64 72 65 73 73

3D 30 78 41 41 0D

2 Set CH00.xoffset=+0.050 53 65 74 20 43 48 30 30 2E 78 6F 66 66 73 65

74 3D 2B 30 2E 30 35 30 0D

3 Set CH00.yoffset=-0.010 53 65 74 20 43 48 30 30 2E 79 6F 66 66 73 65

74 3D 2D 30 2E 30 31 30 0D

4 Set CH00.wloffset=-123 53 65 74 20 43 48 30 30 2E 77 6C 6F 66 66 73

65 74 3D 2D 31 32 33 0D

5 Set CH00.intoffset=+12345 53 65 74 20 43 48 30 30 2E 69 6E 74 6F 66 66

73 65 74 3D 2B 31 32 33 34 35 0D

6 Set CH00.Gain=1 53 65 74 20 43 48 30 30 2E 47 61 69 6E 3D 31

0D

7 Set CH00.Intetime=2 53 65 74 20 43 48 30 30 2E 49 6E 74 65 74 69

6D 65 3D 32 0D

8 SetDefault 01 53 65 74 44 65 66 61 75 6C 74 20 30 31 0D

9 Get I2C Address 47 65 74 20 49 32 43 20 41 64 64 72 65 73 73

0D

10 Get CH00.xoffset 47 65 74 20 43 48 30 30 2E 78 6F 66 66 73 65

74 0D

11 Get CH00.yoffset 47 65 74 20 43 48 30 30 2E 79 6F 66 66 73 65

74 0D

12 Get CH00.wloffset 47 65 74 20 43 48 30 30 2E 77 6C 6F 66 66 73

65 74 0D

13 Get CH00.intoffset 47 65 74 20 43 48 30 30 2E 69 6E 74 6F 66 66

73 65 74 0D

Page 24: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

24

14 Get CH00.Gain 47 65 74 20 43 48 30 30 2E 47 61 69 6E 0D

15 Get CH00.intetime 47 65 74 20 43 48 30 30 2E 69 6E 74 65 74 69

6D 65 0D

16 Get CH00.Setting 47 65 74 20 43 48 30 30 2E 53 65 74 74 69 6E

67 0D

17 Get Model 47 65 74 20 4D 6F 64 65 6C 0D

18 Get SN 47 65 74 20 53 4E 0D

19 Get FW.Ver 47 65 74 20 46 57 2E 56 65 72 0D

20 Get HW.Ver 47 65 74 20 48 57 2E 56 65 72 0D

21 Get CH00.RGB 47 65 74 20 43 48 30 30 2E 52 47 42 0D

22 Get CH00.HSI 47 65 74 20 43 48 30 30 2E 48 53 49 0D

23 Get CH00.HSI2 47 65 74 20 43 48 30 30 2E 48 53 49 32 0D

24 Get CH00.Wavelength 47 65 74 20 43 48 30 30 2E 57 61 76 65 6C 65

6E 67 74 68 0D

25 Get CH00.Int 47 65 74 20 43 48 30 30 2E 49 6E 74 0D

26 Get CH00.xy 47 65 74 20 43 48 30 30 2E 78 79 0D

27 Get CH00.RGBI 47 65 74 20 43 48 30 30 2E 52 47 42 49 0D

28 Get CH00.CCT 47 65 74 20 43 48 30 30 2E 43 43 54 0D

29 Get CH00.xyI 47 65 74 20 43 48 30 30 2E 78 79 49 0D

30 Get RGB.All 47 65 74 20 52 47 42 2E 41 6C 6C 0D

31 Get HSI.A0 47 65 74 20 48 53 49 2E 41 30 0D

32 Get WL.All 47 65 74 20 57 4C 2E 41 6C 6C 0D

33 Get XYI.A0 47 65 74 20 58 59 49 2E 41 30 0D

34 Get Int.All 47 65 74 20 49 6E 74 2E 41 6C 6C 0D

35 Get CH00.All 47 65 74 20 43 48 30 30 2E 41 6C 6C 0D

36 Get CH00.PWM 47 65 74 20 43 48 30 30 2E 50 57 4D 0D

Page 25: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

25

2.1Command parameter settings

(1)Set I2C Address

This command is used to set the I2C address of the device.

Command format:Set I2C Address=0xAA

AA: The address of device that I2C needs to set is 2 bits, sixteen hexadecimal integers, the value must be

even numbers, such as A-F must be uppercase.

Command return:

Success return is %OK

Error return is %Error

Example:

Set I2C Address=0x06

%OK

(2)Set CH##.xoffset

This command is used to set the offset of the x value of each channel. When we tested the LED test, the x

value has a desired test value we want, For example, the LED test in the four channel, the expected value

of X is 0.300. But in the actual debugging, four channel test values were 0.310 ; 0.280; 0.320;0.340. At

this time, the offset can take advantage of x command set to modify the x value. As shown above, the

offset of x is -0.010; +0.020; -0.020; -0.040. The offset settings for xy, wavelength, and Intensity

mentioned in this chapter are all commands based on this requirement. The Set CH##.xoffset command

format is as follows:

Command format:Set CH##.xoffset=+(-)0.XXX

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel. + is

positive, and- is negative. XXX is between 000-127.

Command return:

Success return is %OK

Error return is %Error

Example:

Set the offset of x in 7 channel to -0.030

Set CH06.xoffset=-0.030

Device return:

%OK

Page 26: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

26

(3)Set CH##.yoffset

This command is used to set the offset of the y for each channel. The command format is as follows:

Command format: Set CH##.yoffset=+(-)0.XXX

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel. + is

positive, and- is negative. XXX is between 000-127.

Command return:

Success return is %OK

Error return is %Error

Example:

Set the offset of y in 3 channel to +0.020

Set CH02.yoffset=+0.020

Device return:

%OK

(4)Set CH##.wloffset

This command is used to set the wavelength offset for the specified channel. The command format is as

follows:

Command format: Set CH##.wloffset=+(-)XXX

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel. + is

positive, and- is negative. XXX is between 000-127.

Command return:

Success return is %OK

Error return is %Error

Example:

Set the offset of wavelength in 10 channel to +080

Set CH09.wloffset=+080

Device return:

%OK

(5)Set CH##.intoffset

Page 27: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

27

This command is used to set the Intensity offset for the specified channel. The command format is as

follows:

Command format: Set CH##.intoffset=+(-)XXXXX

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel. + is

positive, and- is negative. XXXXX is between 00000-32767.

Command return:

Success return is %OK

Error return is %Error

Example:

Set the offset of Intensity in 1 channel to +01200

Set CH00.intoffset=+01200

Device return:

%OK

(6)Set CH##.Gain

This command is used to set the gain multiples of the specified channel. The command format is as

follows:

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel. The

relationship between the value of x and gain multiples is shown below:

The value of X Gain multiples

1 1X

2 4X

3 16X

4 60X

Command return:

Success return is %OK

Error return is %Error

Example:

Set the gain multiples of 1 channel to 4X

Set CH00.gain=2

Device return:

Page 28: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

28

%OK

(7)Set CH##.Intetime

This command is used to set the sensor intetime for the specified channel. The command format is as

follows:

Command format: Set CH##.Intetime=X

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel. The

value of X and the corresponding sensor intetime are as follows:

The value of X The sensor intetime

1 25ms

2 50ms

3 100ms

4 200ms

5 500ms

Command return:

Success return is %OK

Error return is %Error

Example:

Set the sensor intetime of 1 channel to 5ms

Set CH00.intetime=2

Device return:

%OK

(8)SetDefault XX

This command is used to set the initial value of analyser. The command format is as follows:

Command format:SetDefault XX

Parameter specification: XX is 01,02,03. The corresponding initial values of each parameter are as

follows:

Page 29: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

29

The value of

XX

Light source Gain Intetime x y wavelengt

h

Intensity

01 Standard light

source

16X 100ms 0.000 0.000 000 00000

02 Bright light 1X 25ms 0.000 0.000 000 00000

03 Weak light 60X 200ms 0.000 0.000 000 00000

Command return:

Success return is %OK

Error return is %Error

Example:

SetDefault 03

%OK

2.2 Read setting parameter command

(1)Get I2C Address

This command is used to read the I2C address of the device.

Command format: Get I2C Address

Command return:

Success return is 0xAA

AA: the I2C address of the device

Error return is %Error

Example:

Read the address of I2C device

Get I2C Address

%0x02

(2)Get CH##.xoffset

This command is used to read x offset value of the device specified channel.

Command format: Get CH##.xoffset

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Example:

Read the offset value of x in the 7 channel of the device

Page 30: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

30

Get CH06.xoffset

%-0.000

(3)Get CH##.yoffset

This command is used to read y offset value of the device specified channel.

Command format: Get CH##.yoffset

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Example:

Read the offset value of x in the 3 channel of the device

Get CH02.yoffset

%-0.000

(4)Get CH##.wloffset

This command is used to read wavelength offset value of the specified channel device.

This command is used to read y offset value of the device specified channel.

Command format: Get CH##.wloffset

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Example:

Read the offset value of x in the 10 channel of the device

Get CH09.wloffset

%-0.000

(5)Get CH##.intoffset

This command is used to read Intensity offset value of the specified channel device.

Command format: Get CH##.intoffset

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Example:

Read the Intensity offset of the first channel of the device

Get CH00.intoffset

%-00000

Page 31: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

31

(6)Get CH##.GAIN

This command is used to read gain multiples of the specified channel of device.

Command format: Get CH##.GAIN

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Example:

Reads the Intensity offset of the first channel of the device

Get CH00.gain

%4

(7)Get CH##.intetime

This command is used to read the sensor integration time of the specified channel for device.

Command format: Get CH##.intetime

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Example:

Read the intetime of first channels for device

Get CH00.intetime

%2

(8)Get CH##.Setting

This command is used to read the various parameter setting of the specified channel for device.

Command format: Get CH##.Setting

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%AA;TTT;+(-)0.XXX;+(-)0.YYY;+(-)WWW;+(-)IIIII.

AA: gain multiples

TTT: sensor intetime

+(-)0.XXX: offset of x

+(-)0.YYY: offset of y

Page 32: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

32

+(-)WWW: offset of wavelength

+(-)IIIII: offset of Intensity

Example:

Get CH00.setting

%60;025;-0.050;-0.050;-100;+01200

(9)Get Model

This command is used to read the device type

Command format: Get Model

Example:

Get Model

%iCATFT16

(10)Get SN

This command is used to read Serial Number.

Command format: Get SN

Example:

Get SN

%2017060103

(11)Get FW.VER

This command is used to read the Firmware version of the device

Command format: Get FW.VER

Command returns

Successfully returned to version FW of the device

Error return is%Error

Example:

Read the firmware version of the device

Get FW.VER

%Firmware is Ver 5.00

Page 33: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

33

(12)Get HW.VER

Read the hardware version of device

Command format:Get HW.VER

Command returns

Successfully returned is the version number of device hardware

Error return is%Error

Example:

Read the hardware version information of the device

Get HW.VER

%iCATFT16 V3.0

2.3 Functional command

(1)Get CH##.RGB

This command reads the value of RGB for measure LED of each channel

Command format:Get CH##.RGB

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%RRR,GGG,BBB

RRR is an integer of 3 bits, indicating the value of returns RED, and between 0-255.

GGG is an integer of 3 bits, indicating the value of returns GREEN, and between 0-255.

BBB: is an integer of 3 bits, indicating the value of returns BLUE, and between 0-255.

If the command failed to return%Error

Example:

Read RGB numerical test of 2 channel

Get CH01.RGB

Device return:

%221,010,024

(2)Get CH##.HSI

This command reads the value of the Hue, Saturation, and Intensity of the measure for each channel.

Command format:Get CH##.HSI

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

Page 34: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

34

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%HHH,SSS,III

HHH is an integer of 3 bits, indicating the value of returns Hue, and between 0-360.

SSS is an integer of 3 bits, indicating the value of returns Saturation, and between 0-100.

III is an integer of 3 bits, indicating the value of returns Intensity, and between 0-100.

If the command failed to return%Error

Example:

Read the Hue, Saturation and I numerical test of 2 channel

Get CH01.HSI

Device return:

%121,067,028

(3)Get CH##.HSI2

This command reads the value of the Hue, Saturation, and Intensity of the measure for each channel. It is

recommended to read the value of HSI using this command.

Command format:Get CH##.HSI2

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%HHH,SSS,IIIII

HHH is an integer of 3 bits, indicating the value of return to Hue, and between 0-360.

SSS is an integer of 3 bits, indicating the value of return to Saturation, and between 0-100.

IIIII is an integer of 5 bits, indicating the value of return to Intensity, and between 0-99999.

If the command failed to return%Error

Example:

Read the Hue, Saturation and I numerical test of 2 channel

Get CH01.HSI2

Device return:

%185,007,33442

(4)Get CH##.Wavelength

This command reads LED wavelength of the specified channel.

Command format:Get CH##.Wavelength

Page 35: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

35

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%WWW

WWW is an integer of 3 bits, indicating the value of return wavelength.

Read the wavelength of the first channel.

Get CH00.Wavelength

Device return:

%480

(5)Get CH##.Int

This command reads the Intensity value of measure LED for each channel

Command format:Get CH##.int

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%IIIII

IIIII is an integer of 5 bits, indicating the value of return Intensity, and between 0-99999.

If the command failed to return%Error

Example:

Read the Intensity numerical test of 2 channel

Get CH01.Int

Device return:

%33279

(6)Get CH##.xy

This command reads the Chromaticity xy(CIE1931) value of measure LED for each channel

Command format:Get CH##.xy

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%0.xxx,0.yyy

Page 36: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

36

0.xxx is an integer of 3 bits, and between 0-1.

0.yyy is an integer of 3 bits, and between 0-1.

If the command failed to return%Error

Example:

Read the x numerical test of 2 channel

Get CH01.xy

Device return:

%0.306,0.335

(7)Get CH##.RGBI

This command reads the Intensity value of measure LED for specified channel.

Command format:Get CH##.RGBI

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%RRR,GGG,BBB,IIIII

RRR is an integer of 3 bits, indicating the value of returns RED, and between 0-255.

GGG is an integer of 3 bits, indicating the value of returns GREEN, and between 0-255.

BBB: is an integer of 3 bits, indicating the value of returns BLUE, and between 0-255.

IIIII is an integer of 5 bits, indicating the value of return Intensity, and between 0-99999.

If the command failed to return%Error

Example:

Read the RGB and Intensity value of 2 channel

Get CH00.RGBI

Device return:

%070,099,085,01213

(8)Get CH##.CCT

This command reads the value of the CCT for the specified channel.

Command format:Get CH##.CCT

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%CCCCCk

Page 37: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

37

CCCCC is an integer of 5 bits, indicating the value of returns CCT.

If the command failed to return%Error

Example:

Read the CCT value of 1 channel

Get CH00.CCT

Device return:

%04291k

(9)Get CH##.xyI

This command reads the Chromaticity xy (CIE1931) and Intensity value of specified channel.

Command format:Get CH##.xyI

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

%0.xxx,0.yyy,IIIII

0.xxx is an integer of 3 bits, and between 0-1.

0.yyy is an integer of 3 bits, and between 0-1.

IIIII is an integer of 5 bits, indicating the value of return Intensity, and between 0-99999.

If the command failed to return%Error

Example:

Read the Chromaticity xy (CIE1931) and Intensity value of 1 channel

Get CH00.xyI

%0.261,0.303,01210

2.4 The whole read command

(1)Get RGB.All

This command is used to read the value of the RGB for all channels.

Command format:Get RGB.All

Input returns: if the command succeeds, return to the value of N group RGB value in the following

format:

%RRR,GGG,BBB;RRR,GGG,BBB;……RRR,GGG,BBB;

(iCATFT04: outputs 4 sets data, iCATFT08: outputs 8 sets data, and iCATFT16: outputs 16 sets data)

RRR is an integer of 3 bits, indicating the value of returns RED, and between 0-255.

GGG is an integer of 3 bits, indicating the value of returns GREEN, and between 0-255.

Page 38: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

38

BBB: is an integer of 3 bits, indicating the value of returns BLUE, and between 0-255.

If the command failed to return%Error

Example:

Get RGB.All

Device return:

%078,098,078;078,090,085;078,087,088;080,091,082;081,091,082;079,088,086;079,085,090;075,096,08

2;078,088,087;083,087,083;080,087,086;080,089,085;084,082,087;083,083,087;081,085,088;080,087,08

7;

(2)Get HSI.AX

This command is used to read the HSI value of partial channel.

Command format:Get HSI.AX

Parameter Description: AX is A0 or A1, as follows:

If it's a 16 channel analyser:

Get HSI.A0 reads the HSI value of 0-7 channels.

Get HSI.A1 reads the HSI value of 8-15 channels.

If it's a 8 channel analyser:

Get HSI.A0 reads the HSI value of 0-7 channels.

If it's a 4 channel analyser:

Get HSI.A0 reads the HSI value of 0-4 channels.

Input return:

If the command succeeds, return to the following format:

%HHH,SSS,IIIII;HHH,SSS,IIIII;……HHH,SSS,IIIII

HHH is an integer of 3 bits, indicating the value of return to Hue, and between 0-360.

SSS is an integer of 3 bits, indicating the value of return to Saturation and between 0-100.

IIIII is an integer of 5 bits, indicating the value of return to Intensity, and between 0-99999.

If the command failed to return%Error

Example:

Reads the HIS value of the iCATFT16 for 0-7 channel of the device.

Get HSI.A0

Device return:

%138,014,01221;155,007,33238;180,007,33436;129,005,33256;120,003,33438;166,005,33364;206,006,3

3274;142,011,33236;

.

Page 39: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

39

(3)Get WL.All

This command is used to read the Wavelength value of partial channel.

Command format:Get WL.All

Input returns: if the command succeeds, return to the following format:

%WWW,WWW,WWW,……,WWW,

WWW is an integer of 3 bits, indicating the value of return to wavelength.

If the command failed that return to %Error

Example:

Get WL.All

Device return:

%395,493,490,496,497,491,487,497,490,574,490,493,485,486,489,493,

(4)Get XYI.AX

This command is used to read the xy and Intensity value of partial channel.

Command format:Get XYI.AX

Parameter Description: AX is A0 or A1, as follows:

If it's a 16 channel analyser:

Get XYI.A0 reads the XY1 value of 0-7 channels.

Get XYI.A1 reads the XY1 value of 8-15 channels.

If it's a 8 channel analyser:

Get XYI.A0 reads the XY1 value of 0-7 channels.

If it's a 4 channel analyser:

Get XYI.A0. reads the XY1 value of 0-4 channels.

Input return:

If the command succeeds, return to the following format:

%0.xxx,0.yyy,IIIII; 0.xxx,0.yyy,IIIII;……; 0.xxx,0.yyy,IIIII ;

0.xxx is an integer of 3 bits, and between 0-1.

0.yyy is an integer of 3 bits, and between 0-1.

IIIII is an integer of 5 bits, indicating the value of return to Intensity, and between 0-99999.

If the command failed to return%Error

Example:

GET XYI.A0

Device return:

Page 40: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

40

%0.261,0.300,01222;0.306,0.336,33243;0.304,0.347,33437;0.310,0.340,33255;0.312,0.341,33438;0.306,

0.331,33365;0.274,0.322,33279;0.305,0.344,33235;

(5)Get Int.All

This command is used to read the Intensity value of partial channel.

Command format:Get Int.All

Input return:

If the command succeeds, return to the following format:

%IIIII;IIIII;……;IIIII;

IIIII is an integer of 5 bits, indicating the value of return to Intensity, and between 0-99999.

If the command failed to return%Error

Example:

Get Int.All

%01220;33244;33443;33256;33438;33371;33279;33239;

(6)Get CH##.All

This command is used to read the RGB, Hue, Saturation, Intensity, xy, wavelength,color value of measure

LED for each channel.

Command format:Get CH##.all

Input return:

If the command succeeds, return to the following format:

%IIIII;IIIII;……;IIIII;

IIIII is an integer of 5 bits, indicating the value of return to Intensity, and between 0-99999.

If the command failed to return%Error

Example:

Get Int.All

%01220;33244;33443;33256;33438;33371;33279;33239;

Parameter specification: ## The channel number that needs to be set, values from 00 to 15, such as 00,

which indicates the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input returns: if the command succeeds, return to the following format:

% RRR,GGG,BBB,HHH,SSS,IIIIII,0.XX,0.YY

RRR is an integer of 3 bits, indicating the value of returns RED, and between 0-255.

GGG is an integer of 3 bits, indicating the value of returns GREEN, and between 0-255.

BBB: is an integer of 3 bits, indicating the value of returns BLUE, and between 0-255.

Page 41: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

41

HHH is an integer of 3 bits, indicating the value of return to Hue, and between 0-360.

SSS is an integer of 3 bits, indicating the value of return to Saturation and between 0-100.

IIIII is an integer of 5 bits, indicating the value of return to Intensity, and between 0-99999.

0.xxx is an integer of 3 bits, and between 0-1.

0.yyy is an integer of 3 bits, and between 0-1.

If the command failed to return%Error

Example:

Read the the numerical test of all formats for 2 channel.

Get CH01.all

Device return:

%079,090,085,153,006,33240,0.307,0.335

2.5 Blinking LED reads command

(1)Get CHXX.PWM

This command is used to read the values of the RGB and HSI for the blinking LED.

Command format:Get CHXX.PWM

Parameter specification: XX is the LED fiber channel, values from 00 to 15, such as 00, which indicates

the value of the first channel, and 15 indicates the value of the sixteenth channel.

Input return:

If the command succeeds, return to the following format:

%RRR,GGG,BBB;HHH,SSS,IIIII;Y/N

RRR is an integer of 3 bits, indicating the value of returns RED, and between 0-255.

GGG is an integer of 3 bits, indicating the value of returns GREEN, and between 0-255.

BBB: is an integer of 3 bits, indicating the value of returns BLUE, and between 0-255.

HHH is an integer of 3 bits, indicating the value of return to Hue, and between 0-360.

SSS is an integer of 3 bits, indicating the value of return to Saturation and between 0-100.

IIIII is an integer of 5 bits, indicating the value of return to Intensity, and between 0-99999.

Y/N: Y stands for blinking LED, and N stands for non blinking LED

If the command failed that return to %Error

Example:

Read the the blinking LED value of 1 channel.

Get CH00.PWM

Device return:

%086,152,017;089,080,00099;N

Page 42: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

42

Chapter4 Multiple devices parallel use

When need to test a larger number of LED at the same time, it need to use parallel use for iCAT, iCAT

supports up to 256 devices in parallel, if all 16 channel models are used, at most to support 4096 LEDs

for testing at the same time, It is suggested that the iCAT be paralleled in two ways, one way is to connect

through multiple USB ports, and if the master side such as PC is not enough, USB Hub can be used to

extend the USB port. The second is use the I2C port to connect, connect multiple iCAT devices via the

I2C bus.

1.USB connection schematic diagram

2.Multiple devices in parallel through I2C bus

If you use PC, you can use USB transfer I2C control card to expand the I2C master controller. To connect

in parallel through I2C, you need to set the I2C address of the LED analyser.

PC

Controller

iCAT iCAT iCAT iCAT

SDA

SCL

USB Hub

iCAT

iCAT

iCAT

…… ……

USB

USB

USB

USB

Page 43: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

43

Chapter5 The main software tools of iCAT LED analyser

iCAT LED provides three applications, mainly iCAT XP, iCAT TestProgram and iCATComm. These three

applications can provide good help for users to quickly use the iCAT LED analyser, for detailed

description of these three softwares can refer to the corresponding software user manual. The latest

version of the software can be downloaded from the download center of the http://www.icatprog.com.

Name of software Major function

iCAT XP

◆Device debugging, direct reading of test values

◆Device settings

◆Color reduction test, the output values of all formats

◆Command terminal, send the command and receive

return information

iCAT TestProgram

◆The creation of the LED test program

◆Upper and lower settings of test program

◆Run the test program as specified

iCATComm

◆Command line terminal under Windows

◆Sending and receiving of results for iCAT command

◆Can run the test project created by the iCAT TestProgram

and returns the result

Page 44: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

44

Chapter6 Installation of iCAT LED analyser

iCAT LED analyser consists of analyser, fiber optic cables, fiber optic connectors, and USB data lines.

Installation and notice of the LED analyser are as follows:

1. First, insert the fiber line into the analyser, and the fiber line is inserted into the depth of the analyser to

be suitable for the 1 mm from the bottom, you can insert the fiber line at the bottom, and then pull it out

about 1 mm.

2. Tighten the fiber line after the fiber line is inserted.

3. The other end is inserted into the optical fiber joint line, note that plug the fiber line into the bottom of

the fiber connector and screw it down.

4. The optical fiber connector is fixed on the fixture, the fiber optic connector shall be 3-4 mm away from

the test LED, and the optical fiber connector is required to test LED.

Notes:

1. Using the optical fiber joint will be attenuated to light, so, for weak light LED, try not to use the fiber

optic connector.

2. When insert the fiber line into the LED analyser, don't plug the fiber in the end. It's better to leave the

fiber line about 1 millimeter from the bottom of the analyser.

3. The accuracy of testing is closely related to the installation, and consistency should be maintained

during installation.

Page 45: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

45

Chapter7 LED analysis using the iCAT LED analyser

Automatic test LED color and intensity completed by the iCAT LED analyser mainly in two ways, one is

to read the values directly in the command mode, and then the upper computer judges the test result

according to the reading value. The other one is to create a test project using iCAT TestProgram on the

Windows platform, and then execute the project using the iCATComm command line tool, and

iCATComm will directly output the test results.

1.THE WAY TO READ TEST RESULTS DIRECTLY WITH COMMANDS

(1) Read the test value of the testing LED using the read command. It is recommended that Hue and

saturation be used as the criteria for color determination, Intensity is used as the criterion for the Intensity

of LED. Read the value of HSI, using the Get CHXX.HSI command, you can also read the test values of

all channels of the analyser at once with the Get HSI.All command.

(2) The upper computer judges the value of the read HSI to determine whether the LED color and

Intensity in the preset range.

2.USE THE SOFTWARE TOOLS PROVIDED BY ICAT TO COMPLETE THE TEST

iCAT LED analyser provides a complete set of supporting software that allows users to complete settings

and integration of the test software with the most simple way. Here's one of the easiest things to do.

For example:There are 3 LED on a PCBA need to test, there are two green LED (LED0, LED1) and one

is two colors LED (LED2), which is red and yellow. To complete the test automation test, the operating

system is Windows 10. The test step is to test whether LED0 and LED1 are green and its Intensity first,

then light the third LED to the red state, and test whether it is red and Intensity, then re-activate LED2 to

yellow, and test its color and Intensity.

Solution: Select the iCAT LED analyser of 4 channel. Software settings method are as follows:

Step 1: To generate the LED0, LED1 test file, named LED01.cat

Opening iCAT TestProgram. and select Project. (For more details on iCAT TestProgam, please refer to

<iCAT TestProgram User Guide>).

Then, as shown in the following figure:

Page 46: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

46

Enter a project name of LED01.CAT, and then select the model of LED analyser, to select the

communication interface. Then select the test items. As shown in the following figure:

Test items generally recommend HUE, Saturation and Intensity. When you have chosen, click the Add

command button to enter the parameter setting interface. As shown in the following figure: If the iCAT

LED analyser has been connected, you can use the method of learning, otherwise manual setting will be

used.

Page 47: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

47

Click on OK, enter the following interface: then Save Project the project file as LED01.cat.

Step 2: Follow the step 1 to create two other project files for LED2Red.cat and LED2Yellow.cat.

Step 3: Diagnostics adopts method for loading an external program to load iCATComm.exe. When testing

LED0 and LED1, first light the LED0 and LED1, and then run iCATComm - F LED01.cat. If testing

PASS, iCATComm returns to 0, If the program runs FAIL, iCATComm returns to -1. In addition,

iCATComm generates a LEDTest.log file that represents the results of each LED test. If all LED tests are

PASS, mark PASS at the last line of LEDTest.log, otherwise FAIL. At the same time, iCATComm will

generate a test.log file, the file records the test data in detail, If need to analyze the cause of the test failure,

you can get the test data from the test.log file.

Page 48: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

48

Step 4: light the LED2 to the red state, such as described in step 3 to load the LED2Red.cat file. And then

light LED2 to yellow light state again and load the LED2Yellow.cat file. That is to complete automated

testing of LED0, LED1, LED2, three LED colors and Intensity.

Page 49: iCAT LED Analyser User Guide - 9794418.s21d-9.faiusrd.com

iCAT LED Analyser User Guide

ShenZhen iCAT Technology CO.,Ltd http://www.icatprog.com

49

Warranty:

1. Shenzhen iCAT Technology Co., Ltd. is responsible for one year warranty on the sale of

iCAT LED products analyser and its accessories. The warranty start time is based on the

date of delivery to the customer.

2. The following conditions are not covered by warranty:

Damage caused by all human factors or damage caused by use in an abnormal

environment.

Users privately assemble and disassemble products without our company's consent.

The warranty number is damaged.

The condition of an unstable test that is not caused by our company.

3. If you have warranty requirements, please contact our customer service. Service e-mail:

[email protected]