3.2.49. Wake Up Command Class, version 2

The Wake Up Command Class version 2 enables read back of the Wake Up Interval capabilities in a node.

3.2.49.1. Compatibility considerations

\requirement{CC:0084.02.00.21.001}{0}

A node supporting Wake Up Command Class, version 2 MUST also support Wake Up Command Class, version 1.

All commands not mentioned in this version remain unchanged from the Wake Up Command Class, version 1.

\requirement{CC:0084.02.00.22.001}{4}

A version 2 supporting node may receive a Wake Up Interval Set outside the range of supported intervals from a version 1 controlling node. A version 2 supporting node SHOULD NOT ignore a Wake Up Interval Set with an invalid time period and set the Wake Up Interval to a supported value.

3.2.49.2. Wake Up Interval Set Command

The Wake Up Interval Set Command is used to configure the wake up interval of a device and the NodeID of the device receiving the Wake Up Notification Command.

Table 3.187 Wake Up Interval Set Command, version 2

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_WAKE_UP (0x84)

Command = WAKE_UP_INTERVAL_SET (0x04)

Seconds 1 (MSB)

Seconds 2

Seconds 3 (LSB)

NodeID

All fields not described below remain unchanged from version 1

Seconds (24 bits)

This field is used to specify the time in seconds between Wake Up periods for the receiving node.

\requirement{CC:0084.02.04.11.001}{0}

The first byte MUST be the most significant byte.

\requirement{CC:0084.02.04.11.002}{0}

Values in the range 1..16777215 MUST indicate the time between Wake Up periods.

The value 0 MUST indicate that the receiving node MUST Wake Up when initiated by an event determined by the application e.g. a pushbutton activation.

\requirement{CC:0084.02.04.11.003}{0}

A receiving node MUST accept any interval value within the interval limits advertised by the Wake Up Interval Capabilities Report Command.

\requirement{CC:0084.02.04.12.001}{0}

A receiving node SHOULD NOT ignore this command if this field contains a non-valid value and it SHOULD apply the following:

\requirement{CC:0084.02.04.12.002}{4}

  • If the received value is higher than the minimum valid value (advertised in the Wake Up Interval Capabilities Report Command), the receiving node SHOULD round down the value to the next valid value but SHOULD NOT set it to 0 if 0 is the minimum value.

\requirement{CC:0084.02.04.12.003}{4}

  • If the value specified in this field is lower than the minimum valid value, the receiving node SHOULD apply the minimum valid value.

\requirement{CC:0084.02.04.12.004}{0}

A receiving node SHOULD accept the value 0, even if the Minimum Wake Up Interval advertised by the Wake Up Interval Capabilities Report Command is larger than 0. If accepted, the value 0 MUST disable the timer-based transmission of Wake Up Notification Commands.

\requirement{CC:0084.02.04.12.005}{0}

The node SHOULD be able to issue a Wake Up Notification in response to some local activation, e.g. a button press.

3.2.49.3. Wake Up Interval Capabilities Get Command

This command is used to request the Wake Up Interval capabilities of a node.

\requirement{CC:0084.02.09.11.001}{0}

The Wake Up Interval Capabilities Report Command MUST be returned in response to this command.

\requirement{CC:0084.02.09.11.002}{0}

This command MUST NOT be issued via multicast addressing.

\requirement{CC:0084.02.09.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 3.188 Wake Up Interval Capabilities Get Command

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_WAKE_UP (0x84)

Command = WAKE_UP_INTERVAL_CAPABILITIES_GET (0x09)

3.2.49.4. Wake Up Interval Capabilities Report Command

This command is used to advertise the Wake Up Interval capabilities of a node.

Table 3.189 Wake Up Interval Capabilities Report Command

7

6

5

4

3

2

1

0

Command Class = COMMAND_CLASS_WAKE_UP (0x84)

Command = WAKE_UP_INTERVAL_CAPABILITIES_REPORT (0x0A)

Minimum Wake Up Interval Seconds 1 (MSB)

Minimum Wake Up Interval Seconds 2

Minimum Wake Up Interval Seconds 3 (LSB)

Maximum Wake Up Interval Seconds 1 (MSB)

Maximum Wake Up Interval Seconds 2

Maximum Wake Up Interval Seconds 3 (LSB)

Default Wake Up Interval Seconds 1 (MSB)

Default Wake Up Interval Seconds 2

Default Wake Up Interval Seconds 3 (LSB)

Wake Up Interval Step Seconds 1 (MSB)

Wake Up Interval Step Seconds 2

Wake Up Interval Step Seconds 3 (LSB)

\requirement{CC:0084.02.0A.11.001}{0}

Byte 1 MUST be the most significant byte for all fields in this command.

Minimum Wake Up Interval Seconds (24 bits)

\requirement{CC:0084.02.0A.11.002}{0}

This field is used to advertise the minimum Wake Up Interval supported by the sending node. The field MUST be in the range 0..16777215

\requirement{CC:0084.02.0A.11.00B}{0}

The value 0 MUST indicate that the receiving node MUST supports Wake Up when initiated by an event determined by the application e.g. a pushbutton activation.

\requirement{CC:0084.02.0A.11.00C}{0}

Values in the range 1..16777215 MUST indicate Minimum supported Wake Up interval in seconds

Maximum Wake Up Interval Seconds (24 bits)

\requirement{CC:0084.02.0A.11.003}{4}

This field is used to advertise the maximum Wake Up Interval supported by the sending node. The field MUST comply with Table 3.190.

\requirement{CC:0084.02.0A.11.004}{32} \requirement{CC:0084.02.0A.11.005}{46} \requirement{CC:0084.02.0A.13.001}{54}

Table 3.190 Wake Up Interval Capabilities Report::Maximum Wake Up Interval Seconds Encoding

Decimal

Description

0

This value is used to indicate that there is no minimum / maximum / default wake up interval. In this case, the sending node is activated by e.g. user interaction in form of a button press.

If this field is set to 0, the Minimum and Default Wake Up Interval fields MUST also be 0.

<min interval> ..16777215

Values in this range indicate the maximum wake up interval in seconds supported by the sending node.

This field MUST NOT be set to a lower value than the Minimum Wake Up Interval Seconds value.

This field MAY be set to the same value as the Minimum Wake Up Interval Seconds value, which means the sending node only supports one value.

Default Wake Up Interval Seconds (24 bits)

This field is used to advertise the default Wake Up Interval value for the sending node.

\requirement{CC:0084.02.0A.12.006}{0}

This field MUST be set to a value included in the range defined by the Minimum Wake Up Interval and the Maximum Wake Up Interval

\requirement{CC:0084.02.0A.12.001}{0}

The Default Wake Up Interval SHOULD be 0 if the Minimum Wake Up Interval is 0.

Wake Up Interval Step Seconds (24 bits)

\requirement{CC:0084.02.0A.11.007}{4}

This field is used to advertise the resolution of valid Wake Up Intervals values for the sending node. The field MUST comply with Table 3.191.

\requirement{CC:0084.02.0A.11.008}{28} \requirement{CC:0084.02.0A.11.009}{44} \requirement{CC:0084.02.0A.12.002}{52} \requirement{CC:0084.02.0A.11.00A}{68}

Table 3.191 Wake Up Interval Capabilities Report::Wake Up Interval Step Seconds Encoding

Decimal

Description

0

This value is used to indicate that no interval steps are possible.

The battery-operated device only supports the minimum and maximum Wake Up Interval values.

This field MUST be set to 0 if the maximum and the minimum interval are equal.

1..16777215

Values in this range indicate the Wake Up Interval step in seconds supported by the sending node.

This field’s value MUST NOT exceed the difference between the Minimum and Maximum Wake Up Intervals.

This field SHOULD have a value so that the difference between the maximum and minimum Wake Up Interval is a multiple of this field’s value.

Examples:

If a device has minimum wake up interval of 5 minutes (300 seconds) and a maximum wake up interval of 10 minutes (600 seconds), the wake up interval step MUST NOT exceed 5 minutes (300 seconds) as this would be larger than the difference of the minimum and maximum interval. A Wake Up Interval Step of 100 seconds indicates that the nodes supports the following Wake Up Intervals :

300 seconds

400 seconds

500 seconds

600 seconds