Overview

The SNTP Diagnostics object presents the instances, attributes and services described below.

Class ID

405 (hex), 1029 (decimal)

Instance IDs

The SNTP Diagnostics object presents two instances:

  • 0: class

  • 1: instance

Attributes

SNTP Diagnostics object attributes are associated with each instance, as follows:

Instance ID = 0 (class attributes):

Attribute ID

Description

GET

SET

01

Revision

X

—

02

Maximum Instance

X

—

X = supported

— = not supported

Instance ID = 1 (instance attributes):

Attribute ID

Description

Type

GET

SET

Value

hex

dec

01

01

Network Time Service Configuration

STRUCT of

X

—

Primary NTP Server IP Address

UDINT

Secondary NTP Server IP Address

UDINT

Polling Period

USINT

In seconds

Update controller with Module Time

USINT

  • 0 = do not update

  • 1 = update

Time Zone

UDINT

Depends on the operating system of the configuration software.

Time Zone Offset

INT

In minutes

Daylight saving time bias

USINT

Daylight Saving Start Date - Month

USINT

Daylight Saving Start Date -
week #, day of week

USINT

  • MSB (4 bits) : week #

  • LSB (4 bits) : 0=Sunday…6=Saturday

Daylight Saving Start Time

UDINT

Seconds elapsed from midnight

Daylight Saving End Date - Month

USINT

Daylight Saving End Date -
week #, day of week

USINT

  • MSB (4 bits) : week #

  • LSB (4 bits) : 0=Sunday…6=Saturday

Daylight Saving End Time

UDINT

Seconds elapsed from midnight

Reserved

USINT[15]

02

02

Network Time Service Status

UDINT

X

—

  • 1 = idle

  • 2 = operational

03

03

Link to NTP Server Status

UDINT

X

—

  • 1 = NTP server not reachable

  • 2 = NTP server is reachable

04

04

Current NTP Server IP Address

UDINT

X

—

05

05

NTP Server Type

UDINT

X

—

Re: the server identified in attribute 03:

  • 0 = primary

  • 1= secondary

06

06

NTP Server Time Quality

UDINT

X

—

Jitter of the clock/time in microseconds/second

07

07

Number of NTP Requests Sent

UDINT

X

—

08

08

Number of Communication Errors

UDINT

X

—

09

09

Number of NTP Responses Received

UDINT

A

10

Last Error

UINT

  • 0 = no error

  • 1 = NTP_ERROR_CONF_BAD_PARAM

  • 2 = NTP_ERROR_CONF_BAD_CONF

  • 3 = NTP_ERROR_CREATE_SERVICE

  • 4 = NTP_ERROR_WRONG_STATE

  • 5 = NTP_ERROR_NO_RESPONSE

B

11

Current Date and Time

DATE_AND_TIME

 {
time_of_day UDINT,
date UINT
}

Refer to CIP specification.

C

12

Daylight Savings Status

UDINT

  • 1 = Daylight savings is enabled and the date/time is within the applicable period

  • 2 = Daylight savings is not enabled or enabled but not within the applicable period
D

13

Time Since Last Update

DINT

Amount of time elapsed since a valid response from the NTP server in 100ms increments. -1 = not updated

X = supported

— = not supported

Services

The SNTP Diagnostics object performs the following services upon the listed object types:

Service ID

Description

Class

Instance

Notes

hex

dec

01

01

Get_Attributes_All

X

X

Returns:

  • all class attributes (instance = 0)

  • instance attributes 1 to 7 (instance = 1)

0E

14

Get_Attribute_Single

X

X

Returns the value of the specified attribute.

32

50

Clear_All

—

X

Clears data in attributes 6, 7, 8, 9, 10, 13 (all attributes defined in decimal notation).

X = supported

— = not supported