2.2.104. Tariff Table Configuration Command Class, version 1

The Tariff Table Configuration Command Class defines the cost for a range of rates.

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

2.2.104.1. Tariff Table Supplier Set Command

This command is used to set the name of the utility supplier in the metering device.

7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_TARIFF_CONFIG (0x4A)
Command = TARIFF_TBL_SUPPLIER_SET (0x01)
Utility Timestamp Year 1
Utility Timestamp Year 2
Utility Timestamp Month
Utility Timestamp Day
Utility Timestamp Hour Local Time
Utility Timestamp Minute Local Time
Utility Timestamp Second Local Time
Currency 1
Currency 2
Currency 3
Standing Charge Precision			Standing Charge Period
Standing Charge Value 1
Standing Charge Value 2
Standing Charge Value 3
Standing Charge Value 4
Reserved			Number of Supplier Characters
Supplier Character 1
…
Supplier Character N

Utility Timestamp Year (16 bits)

Tariff applies from the specified year in the usual Gregorian calendar. The first byte (Year 1) is the most significant byte.

Utility Timestamp Month (8 bits)

Tariff applies from the specified month of the year between 01 (January) and 12 (December). A year equal to 0x0000 indicates that a accumulated value is not determined yet.

Utility Timestamp Day (8 bits)

Tariff applies from the specified day of the month between 01 and 31.

Utility Timestamp Hour Local Time (8 bits)

Tariff applies from the specified number of complete hours that have passed since midnight (00-23) in local time.

Utility Timestamp Minute Local Time (8 bits)

Tariff applies from the specified number of complete minutes that have passed since the start of the hour (00-59) in local time.

Utility Timestamp Second Local Time (8 bits)

Tariff applies from the specified number of complete seconds since the start of the minute (00-59) in local time. The value 60 used to keep UTC from wandering away is not supported.

Currency (3 bytes)

ISO 4217 defines the currency code. In Table 2.531 are some examples of the codes listed:

Table 2.531 Tariff Table Supplier Set::Currency encoding examples

Currency Code	Currency 1	Currency 2	Currency 3
Pound sterling	G	B	P
US Dollar	U	S	D

Standing Charge Period (5 bits)

This field indicates the stated period that standing charge applies e.g. 50p/week.

Table 2.532 Tariff Table Supplier Set::Standing Charge Period encoding

Period	Value
Weekly	0x01
Monthly	0x02
Quarterly	0x03
Yearly	0x04
Reserved	0x05-0x1F

Standing Charge 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.

Standing Charge Value (32 bits)

The Standing Charge value MUST be encoded as a 32-bit signed integer. The first byte MUST be the most significant byte. Table 2.12 shows signed decimal values together with their hexadecimal equivalents.

Reserved

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

Number of Supplier Characters (5 bits)

Number of characters defining the name of the utility supplier ID (1 … 32).

Supplier Character (N bytes)

The supplier character fields hold the string identifying the utility supplier. The character presentation uses standard ASCII codes (values 128-255 are ignored).

2.2.104.2. Tariff Table Set Command

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

7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_TARIFF_CONFIG (0x4A)
Command = TARIFF_TBL_SET (0x02)
Rate Parameter Set ID
Tariff Precision			Reserved
Tariff Value 1
Tariff Value 2
Tariff Value 3
Tariff Value 4

Rate Parameter Set ID (8 bits)

The Rate Parameter Set ID indicates the requested parameter set.

Reserved

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

Tariff 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.

Tariff Value (32 bits)

The Tariff value is a 32 bit signed field. The first byte is the most significant byte. shows signed decimal values together with their hexadecimal equivalents.

2.2.104.3. Tariff Table Remove Command

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

7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_TARIFF_CONFIG (0x4A)
Command = TARIFF_TBL_REMOVE (0x03)
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 ID’s indicates the number of Rate Parameter Set ID’s in the command.

Rate Parameter Set ID (N bytes)

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