OYO 3000 Controller Ethernet Communication Protocol (V1.0.0)

Chapter One: General Informations

This communication protocol is based on the TCP IP protocol. For a better understanding of the following content, the reader is invited to learn about TCP IP from other documents.

TCP IP protocol is a data flow protocol. It is only responsible for sending and receiving data. It is not responsible for explaining the content and structure of data flow. The communication of this agreement is based on the frame implementation, so the following regulations are made on the format of the data stream:

Frames are the basic unit of communication. The unit of data sent and received in one communication is one frame.

The frame consists of a frame header, a frame body, and a CRC16 checksum. The frame header occupies two bytes, which indicates the length of the frame. The frame body is used to save the valid data that needs to be transmitted. The CRC16 check code occupies two bytes to ensure the integrity of the frame. The structure diagram is as follows:

Communication Protocol

Example: The frame length is FL, Then DL=FL-2-2.

The controller is implemented as a TCPIP server (communication parameters are set in the controller. Because TCPIP itself is a reliable communication protocol, CRC16 is not enabled by default). After the client establishes a connection with the controller, The frame can be constructed according to the above frame format and sent to the controller.

For example, send the hexadecimal data “00 01 02 03 04 05 06 07 08 09” to the controller, Then the frame “00 0c 04 05 06 07 08 09” is constructed. And send the controller, After the controller receives this frame, it will remove “00 0c”. Then get “00 01 02 03 04 05 06 07 08 09”.

What does “00 01 02 03 04 05 06 07 08 09” mean? The following begins to introduce the controller after receiving valid data, How to identify and process these valid data. The controller supports two types of frames: read register frame and write register frame.

Read Register Frame:

OYO 3000 Controller Ethernet Communication Protocol

Write Register Frame:

OYO 3000 Controller Ethernet Communication Protocol

This communication protocol supports reading and writing of the register data area. Communication implementation regulations: The register is a 16-bit data and the number of registers is 65536.

Chapter Two: Device Information (Register Offset 0)
RegisterNameOperationDescription
0Device TypeRead
0x0000: Invalid initialization value.
0x1111: Single temperature test controller.
0x2222: Temperature and humidity test controller.
0x3333: Thermal shock test controller
0x4444: UV test controller.
0x5555: Xenon arc lamp test controller.
0x6666: Sand dust test controller
0x7777: Rain test controller.
0x8888: Salt spray test controller
1Device ModelReadPlease refer to the specific model device manual.
2Device NumberRead0~9999 Multiple devices that distinguish between the same device type and device model.
3Communication Protocol VersionRead100:1.0.0 version.
Chapter Three: Device Status and Manipulation (Register Offset 100)
RegisterNameOperationDescription
0Device StatusRead
1: stop the end of the state.
2: The normal state of the stop.
3: The status of the reservation for stop.
4: The hold state of the test.
5: The progress of the test.
6: The pause state of the test.
7: Standby state of the test.
1Operation CommandWrite
Writing the following value will execute the corresponding command:
ValueDescription
0x0001Manual operation
0x0002Manual stop
0x0003hold
0x0004Cancels hold
0x0005skip
0x0006Pause
0x0007Unpause
0x0008Disables an appointment
0x0009Enable appointment
According to its own conditions, the device decides whether to execute the command given by the upper computer. Therefore, the command may not be executed. The host computer can read the device status or operation information to confirm whether the command is executed.
Regardless of whether the value is valid or not, the device automatically clears it after executing this command.
2Test ModeRead0: Fixed value. 1: program.
3Current Running Program NumberRead1~120
4The Program Sets the Number of CyclesRead0~9999
5The Number of Program LoopsRead0~9999
6Currently Running Program LinksRead0~120
7Current Segment NumberRead1~120
8Segment Test Set Time (Hours)ReadUser settings.
9Segment Test Set Time (Minutes and Seconds)ReadUser settings.
10Segment Test Remaining Time (Hours)Read 
11Segment Test Remaining Time (Minutes and Seconds)Read 
12Total Operating Time (Hours)Read0 to 65,535.
13Total Running Time (Minutes and Seconds)ReadThe high 8 bits are minutes (0 to 59) and the low 8 bits are seconds (0 to 59).
14Timing FunctionRead
0: Disabled. 1: Enabled.
When disabled, the total test set time and the total test remaining time are invalid.
15Total Test Set Time (Hours)Read0~65535。
16Total Test Set Time (Minutes and Seconds)ReadThe high 8 bits are minutes (0 to 59) and the low 8 bits are seconds (0 to 59).
17Total Test Remaining Time (Hours)Read0~65535。
18Total Test Remaining Time (Minutes and Seconds)ReadThe high 8 bits are minutes (0 to 59) and the low 8 bits are seconds (0 to 59).
19Test PID NumberRead1~15
Note 1: In program test mode, The register (offset +3 to offset +19) is valid.
 
Note 2: In the constant test mode, The register (offset +3 to offset +11) is invalid. The valid registers are divided into the following two cases:

(a) Register (offset +14) takes a value of 0: the timer function is disabled, At this time, the register (offset +15 to offset +18) is invalid. Register (offset 19 valid).

(b) The register (offset +14) has a value of 1: Enable timing function. In this case, the register (offset +15-offset +19) is valid.

OYO 3000 Controller Ethernet Communication Protocol

Chapter Four: Device Monitoring Parameters (Register Offset 200)
RegisterNameOperationDescription
0Temperature ValidRead
0: Invalid. 1: effective.
1Temperature MeasurementReadZoom in 100 times.
2Current Temperature SettingRead100 times magnification.
3Temperature Target SettingRead100 times magnification.
4Temperature OutputRead100 times magnification.
5Temperature DirectionRead1: Up. 2: Down. 3: Keep it.
6Humidity is EffectiveRead0: Invalid. 1: effective.
7Humidity MeasurementsRead100x magnification.
8Humidity Current SettingRead100 times magnification.
9Humidity Target SettingRead100x magnification.
10Humidity ReadingRead100 times magnification.
11Direction of HumidityRead1: Up. 2: Down. 3: Keep it.
Note 1: Current settings, This is when the program is running or when it is running with a slope setting. The time-dependent setpoint generated internally by the device due to the need for ramp operation.

Note 2: Target setting, It is the value set by the user, If this value is set, it will not change. When running without slope, The current setting is equal to the target setting.

Chapter Five: General Setting Parameters (Register Offset 300)
RegisterNameOperationDescription
0Test ModeRead/Write0: Fixed value. 1: program.
In the test state (hold/travel/pause/standby), the write is invalid.
1Re-start the Power-up Mode after Power offRead/Write0: Stop the test. 1: Retest. 2: Continue testing.
2Reservation FunctionRead/Write0: Disabled. 1: fixed appointment. 2: Program appointment.
The appointment time is reasonable, and in the normal state of stop, enabling the reservation function can be successful.
3Year of ReservationRead/Write2000~2099.
4Appointment MonthsRead/Write1~12.
5Appointment DateRead/Write1~30.
6When making an AppointmentRead/Write0~23.
7ReservationsRead/Write0~59.
8Display LanguageRead/Write0: Chinese. 1: English.
9Keyboard LockRead/Write0: Disabled. 1: Enabled.
10Screensaver FunctionRead/Write0: Disabled. 1: Enabled.
11Screen Saver TimeRead/Write1 to 9999 minutes.
Chapter Six: Set Test Setting Parameters (Register Offset 400)
RegisterNameOperationDescription
0Temperature SettingRead/Write-10000~30000
1Humidity SettingRead/Write0~10000
2Timing FunctionRead/Write0: Disabled. 1: Enabled.
3Regular Time (Hours)Read/Write0~9999
4Regular Time (Minutes and Seconds)Read/WriteThe high 8 bits are minutes(0~59)and the low 8 bits are seconds (0~59)
5Slope FunctionRead/Write0: Disabled. 1: Enabled.
6Temperature SlopeRead/Write0~10000
7Humidity SlopeRead/Write0~10000
8Standby FunctionRead/Write0: Disabled. 1: Enabled.
9Standby TemperatureRead/Write0~10000
10Standby HumidityRead/Write0~10000
11Standby Time (Hours)Read/Write1~9999hours
12Standby Time (Minutes and Seconds)Read/Write0-59 minutes
13Protective FunctionRead/Write0: Disabled. 1: Enabled.
14Low Temperature Alarm RangeRead/Write-10000~30000
15High Temperature Alarm RangeRead/Write-10000~30000
16Low Temperature Pause RangeRead/Write-10000~30000
17High Temperature Pause RangeRead/Write-10000~30000
18TS1 FunctionRead/Write0: Disabled. 1: Enabled.
19TS1 ON TimeRead/Write0~9999 seconds
20TS1 OFF TimeRead/Write0~9999 seconds
21TS2 FunctionRead/Write0: Disabled. 1: Enabled.
22TS2 ON TimeRead/Write0~9999seconds.
23TS2 OFF TimeRead/Write0~9999seconds.
Chapter Seven: Program Test Setting Parameters (Register Offset 500)
RegisterNameOperationDescription
0Program Test Start Program NumberRead/Write1~120.
1Standby TemperatureRead/Write0~10000
2Standby HumidityRead/Write0~10000
3Standby Time (Hours)Read/Write1~9999 hours.
4Standby Time (Minutes and Seconds)Read/Write0~59 minutes.
5Protective FunctionRead/Write0: Disabled. 1: Enabled.
6Low Temperature Alarm RangeRead/Write-10000~30000
7High Temperature Alarm RangeRead/Write-10000~30000。
8Low Temperature Pause RangeRead/Write-10000~30000
9High Temperature Pause RangeRead/Write-10000~30000
10TS1 FunctionRead/Write0: Disabled. 1: Enabled
11TS1 ON TimeRead/Write0~9999 seconds
12TS1 OFF TimeRead/Write0~9999seconds.
13TS2 FunctionRead/Write0: Disabled. 1: Enabled.
14TS2 ON TimeRead/Write0~9999seconds.
15TS2 OFF TimeRead/Write0~9999 seconds
Chapter Eight: Program Library (Register Offset 1000)
RegistersThe NameOperationsInstructions
0~63Program NameRead/WriteUnicode string.
64Cycle FrequencyRead/Write1~9999.
65Linked ProgramRead/Write0~120. 0 means no link.
66Segment 1, Temperature SettingRead/Write-10000~30000.
67Segment 1, Humidity SettingRead/Write0~10000.
68Segment 1, Timing Time (Hours)Read/Write0~9999.
69Segment 1, Timing (Minutes and Seconds)Read/WriteThe high 8 bits are minutes (0 to 59) and the low 8 bits are seconds (0 to 59).
70Segment 1, Standby FunctionRead/Write0: Disabled. 1: Enabled.
71Segment 2, Temperature SettingRead/Write-10000~30000.
72Segment 2, Humidity SettingRead/Write0~10000.
73Segment 2, Timing Time (Hours)Read/Write0~9999.
74Segment 2, Timing (Minutes and Seconds)Read/WriteThe high 8 bits are minutes (0 to 59) and the low 8 bits are seconds (0 to 59).
75Segment 2, Standby FunctionRead/Write0: Disabled. 1: Enabled.
… …… …… …… …
661Segment 120, Temperature SettingRead/Write-10000~30000.
662Segment 120, Humidity SettingRead/Write0~10000.
663Segment 120, Timing Time (Hours)Read/Write0~9999.
664Segment 120, Timing (Minutes and Seconds)Read/WriteThe high 8 bits are minutes (0 to 59) and the low 8 bits are seconds (0 to 59).
665Segment 120, Standby FunctionRead/Write0: Disabled. 1: Enabled.
Note 1: The above is the register description assigned by the first program. The registers allocated by the 2nd to 120th programs can be deduced by analogy.
Note 2: Mark the segment number as SEG. For SEGn (1<=SEGn<=120), Its register start address is: 66+(SEGn-1)*5.
Note 3: Through calculations, we can see that, A program occupies a total of 666 registers. A total of 120 programs occupy 666*120=79920 registers. This has exceeded the size of the communication register area.
Therefore, this communication protocol only supports reading and writing of databases from 1 to 96 programs. 96 programs occupy a total of 666*96=63936 registers. The range of registers used is: registers (offset +0-offset +63935).
Please enter your email, so we can follow up with you.

© Copyright 2014-2023. Wewon Environmental Chambers Co., Ltd.