2.2.83. Rate Table Configuration Command Class, version 1¶

The Rate Table Configuration Command Class defines the parameter sets for a range of rates.

The Rate Table configuration commands are separated for the Rate Table monitoring commands in the rate Table Monitor Command Class, allowing the classes to be optionally supported at different Z-Wave security levels.

Every rate is described as a combination of time, maximum consumption, maximum demand and DCP Rate ID.

Time: Time of day. E.g. 7.15am to 9.20am
Maximum Consumption: E.g. 200kWh. This allows the Utility Supplier to provide special rates for ‘utility conserving’ end users.
Maximum Demand: E.g. 4000W. This allows the Utility Supplier to provide special rates for end-users which manages to keep the ‘peak’ demand under ‘control’.
DCP Rate ID: E.g. DCP Rate ID = 16. This allows the Utility Supplier to provide special rates for end-users participating in DCP event with a specific DCP Rate ID.

2.2.83.1. Rate table set command¶

This command adds a rate parameter set to a given rate parameter set identifier.

Table 2.481 Rate Table Set Command¶
7	6	4
Command Class = COMMAND_CLASS_RATE_TBL_CONFIG (0x48)
Command = RATE_TBL_SET (0x01)
Rate Parameter Set ID
Reserved	Rate Type	Number of Rate Char.
Rate Character 1
…
Rate Character N
Start Hour Local Time
Start Minute Local Time
Duration Minute 1
Duration Minute 2

The following part of the command is OPTIONAL depending on the parameters supported. Use the Rate Table Supported Get Command to obtain supported parameters beside the default above. A not supported parameter is not included into the command layout.

Table 2.482 Rate Table Set Command Optional¶
7	6	5	4	3	2	1	0
Consumption Precision 1			Consumption Scale 1
Min. Consumption Value 1
Min. Consumption Value 2
Min. Consumption Value 3
Min. Consumption Value 4
Max. Consumption Value 1
Max. Consumption Value 2
Max. Consumption Value 3
Max. Consumption Value 4
Max. Demand Precision 1			Max. Demand Scale 1
Max. Demand Value 1
Max. Demand Value 2
Max. Demand Value 3
Max. Demand Value 4
DCP Rate ID

Rate Parameter Set ID (8 bits)

The Rate Parameter Set ID indicates the requested parameter set.

Rate Type (2 bits)

Rate Type specifies the type of parameters in the report. This field MUST be encoded according to Table 2.356.

Reserved

This field MUST be set to 0 by a sending node and MUST be ignored by a receiving node.

Number of Rate Characters (5 bits)

Number of characters defining the rate text (1..32).

Rate Character (N bytes)

The Rate character fields hold the string identifying the rate parameter set. The character presentation uses standard ASCII codes (values in the range 128..255 MUST be ignored).

Start Hour Local Time (8 bits)

Specify the number of complete hours that have passed since midnight (00..23) in local time.

Start Minute Local Time (8 bits)

Specify the number of complete minutes that have passed since the start of the hour (00..59) in local time.

Duration Minute (16 bits)

Specify the duration in minutes (1..1440) since the start in local time. The value 1440 indicates that the parameter set applies the entire day.

Consumption Precision (3 bits)

The precision field describes what the precision of the value is. The number indicates the number of decimals. The decimal value 1025 with precision 2 is therefore equal to 10.25.

Consumption Scale (5 bits)

The Consumption Scale used to indicate the scale (unit) is applicable for the rate. The Consumption Scale parameter is of the variable type Meter Scale; refer to Section 2.2.64.13 Meter Table Current Data Report Command.

Minimum / Maximum Consumption Value (4 * 8 bits)

The Minimum / Maximum Consumption Value are a 32 bit unsigned field. The first byte is the most significant byte.

The Minimum / Maximum Consumption Value are used in the Rate Table when Block Tariffs are used. Block tariffs assign blocks of energy at a set cost. The billing period is defined by the Utility Supplier.

Example of Block Tariff based Rate Table: (Two Block tariff system)

The first block from 0 kWh to 200 kWh is charged at 2 USD/kWh and all other units consumed over 200kWh will be charged at 2.5 USD/kWh

Rate1: Min Consumption value = 0kWh, Max Consumption Value = 200kWh
Rate2: Min Consumption value = 200kWh, Max Consumption Value = 2147483648kWh

NOTE: The actual charge is set using the Tariff Table Configuration Command Class, version 1.

NOTICE: The device receiving the Rate Table Report MUST show the value even though the Scale is not supported.

Max. Demand Precision (3 bits)

The Maximum Demand Precision field describes what the precision of the value is. The number indicates the number of decimals. The decimal value 1025 with precision 2 is therefore equal to 10.25.

Max. Demand Scale (5 bits)

The Maximum Demand Scale field describes what unit is applicable for the rate. The Maximum Demand Scale parameter is of the variable type Meter Scale; refer to Section 2.2.64.13 Meter Table Current Data Report Command.

Max. Demand Value (4 * 8 bits)

The Maximum Demand Value is a 32 bit unsigned field. The first byte is the most significant byte.

The maximum demand value 0xFFFFFFFF is reserved and represents an unlimited maximum demand value.

NOTICE: The device receiving the Rate Table Report MUST show the value even though the Scale is not supported.

DCP Rate ID (8 bits)

The DCP Rate ID addresses the Demand Control Plan parameters, which will overrule other parameter sets defined in the Rate Table Command Class. A DCP Rate ID equal to zero disables Demand Control Plan mapping.

2.2.83.2. Rate table remove command¶

This command is used to remove rate parameter set(s).

Table 2.483 Rate Table Remove Command¶
7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_RATE_TBL_CONFIG (0x48)
Command = RATE_TBL_REMOVE (0x02)
Reserved		Rate Parameter Set IDs
Rate Parameter Set ID 1
…
Rate Parameter Set ID N

Reserved

This field MUST be set to 0 by a sending node and MUST be ignored by a receiving node.

Rate Parameter Set IDs (6 bits)

The Rate Parameter Set IDs indicates the number of rate parameter set IDs in the command.

Rate Parameter Set ID (N bytes)

These fields contain a list of Rate Parameter Set ID’s that should be removed from the Rate Table. All Rate Parameter Set ID’s are cleared in case no Rate Parameter Set ID’s are supplied.