2.2.27. Clock Command Class, version 1 [DEPRECATED]

Warning

THIS COMMAND CLASS VERSION HAS BEEN DEPRECATED

\requirement{CC:0081.01.00.32.006}{0}

The Clock Command Class is used to implement a simple clock functionality. It is RECOMMENDED to use Time Command Class, version 3 or higher instead of Clock Command Class.

2.2.27.1. Interoperability considerations

\requirement{CC:0081.01.00.32.001}{0}

A controlling node SHOULD configure the current time and weekday in a supporting node during node commissioning.

It has been found that some version 1 nodes issue Clock Get Command to controllers in order to learn the current time and use the returned Clock Report Command as a Clock Set Command.

\requirement{CC:0081.01.00.32.002}{0}

A supporting node SHOULD NOT learn the current time with a Clock Get Command.

\requirement{CC:0081.01.00.32.003}{0}

A node SHOULD control the Time Command Class to read the current time from supporting nodes (time servers) or support the Clock Command Class and wait to be set the current time by a controlling node.

\requirement{CC:0081.01.00.32.004}{0}

A Z-Wave Plus node SHOULD issue a Clock Report Command via the Lifeline Association Group if they suspect to have inaccurate time and/or weekdays (e.g. after battery removal).

\requirement{CC:0081.01.00.32.005}{0}

A controlling node SHOULD compare the received time and weekday with its current time and set the time again at the supporting node if a deviation is observed (e.g. different weekday or more than a minute difference)

2.2.27.2. Multi Channel Considerations

\requirement{CC:0081.01.00.12.001}{0}

Multi Channel End Points SHOULD NOT support the Clock Command Class.

2.2.27.3. Clock Set Command

This command is used to set the current time in a supporting node.

Table 2.141 Clock Set Command

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_CLOCK (0x81)

Command = CLOCK_SET (0x04)

Weekday

Hour

Minute

Weekday (3 bits)

\requirement{CC:0081.01.04.11.001}{0}

This field is used to indicate the current weekday that the receiving node MUST assume.

\requirement{CC:0081.01.04.11.002}{0}

This field MUST comply with Table 2.142.

Table 2.142 Clock Set Command::Weekday encoding

Value

Description

0x00

Unused/unknown

This value may be specified if the weekday is not used or not known

0x01

Monday

0x02

Tuesday

0x03

Wednesday

0x04

Thursday

0x05

Friday

0x06

Saturday

0x07

Sunday

Hour (5 bits)

\requirement{CC:0081.01.04.11.003}{0}

This field is used to indicate the hour of the current time that the receiving node MUST assume.

\requirement{CC:0081.01.04.11.004}{0}

This field MUST be in the range 0..23.

Minute (8 bits)

\requirement{CC:0081.01.04.11.005}{0}

This field is used to indicate the minute of the current time that the receiving node MUST assume.

\requirement{CC:0081.01.04.11.006}{0}

This field MUST be in the range 0..59.

\requirement{CC:0081.01.04.12.001}{0}

A sending node knowing the current time with seconds precision SHOULD round its current time to the nearest minute when sending this command.

2.2.27.4. Clock Get Command

This command is used to request the current time set at a supporting node.

\requirement{CC:0081.01.05.11.001}{0}

The Clock Report Command MUST be returned in response to this command.

\requirement{CC:0081.01.05.11.002}{0}

This command MUST NOT be issued via multicast addressing.

\requirement{CC:0081.01.05.11.003}{0}

A receiving node MUST NOT return a response if this command is received via multicast addressing. The Z-Wave Multicast frame, the broadcast NodeID and the Multi Channel multi-End Point destination are all considered multicast addressing methods.

Table 2.143 Clock Get Command

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_CLOCK (0x81)

Command = CLOCK_GET (0x05)

2.2.27.5. Clock Report Command

This command is used to advertise the current time set at the sending node.

Table 2.144 Clock Report Command

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_CLOCK (0x81)

Command = CLOCK_REPORT (0x06)

Weekday

Hour

Minute

For fields description, refer to Clock Set Command

\requirement{CC:0081.01.06.11.001}{0}

A sending node MUST comply with fields description from Clock Set Command