UK Smart MeteringKnowledge ProjectStructured SRV and specimen referenceBrowse SRVs

Service Reference Variant

4.17 · Retrieve Daily Consumption Log

Service details

Identifiers, rules, and applicability

Service reference
4.17
Service Reference Variant
4.17
DUIS section
3.8.41
Command variants
1, 2, 3
DUIS possible responses
AcknowledgementService Response from Device - GBCSPayloadService Response from Device - DSPScheduledMessage FormatResponse to a Command for Local Delivery Request - LocalCommand Format
Critical
No
Sensitive response
Yes
Protection against replay
No
On demand
Yes
Future dated
DSP
DSP scheduled
Yes
DCC only
No
SMETS1 applicability
No
SAPC requirement
Optional
DUIS applicability
3.0, 3.1, 4.0, 5.0, 5.1, 5.2, 5.3

Cross-specification evidence

SMETS/CHTS to GBCS Mapping

This section shows the SMETS and CHTS attributes that can be read or written by the identified GBCS Use Case. Command requirements are shown separately from the mapped attributes.

ECS661 attribute0x0060ESME
SpecificationItemReferenceDescription
SMETSDaily Consumption Log [INFO]5.7.5.14A log capable of storing 731 date stamped entries of Consumption arranged as a circular buffer such that when full, further writes shall cause the oldest entry to be overwritten.
GCS611 attribute0x00A0GPF
SpecificationItemReferenceDescription
CHTSGPF Daily Gas Consumption Log [INFO]4.6.3.7A log capable of storing 731 date stamped entries of Gas Consumption arranged as a circular Buffer such that when full, further writes shall cause the oldest entry to be overwritten.

Specific Errors

Response codes and descriptions

Response CodeResponse Code Description
E041701
The ReadLogPeriod (or ReadLogPeriodOffset) specified within the Service Request does not span at least 1 midnight

Source: DUIS 3.8.41.3

GBCS Use Case

Use cases, device coverage, and applicability

Use Case / Message Code
ECS660x0060
DUIS Applicability
v3.0 – v5.3
GBCS Applicability
v1.0 – v4.3
GBCS Criticality
Non-Critical
Sensitive Response
Yes
Future Dated
DSP
GBTWhat is GBT?
ResponseESMENot always GBT
SMETS1 Applicable
No
Eligible Roles
EISENOMDROUESME
Use Case / Message Code
GCS610x00A0
DUIS Applicability
v3.0 – v5.3
GBCS Applicability
v1.0 – v4.3
GBCS Criticality
Non-Critical
Sensitive Response
Yes
Future Dated
DSP
GBTWhat is GBT?
ResponseGPFNot always GBT
SMETS1 Applicable
No
Eligible Roles
GISGNOMDROUGPF

DUIS Service Definition

Data items and DCC processing

Request data items

Table 154: RetrieveDailyConsumptionLog (sr:ReadLogFutureDatableAndURPCredentials) data items
Data ItemDescription / Allowable valuesTypeMandatoryDefaultUnits
ExecutionDateTimeA User shall only add this Data Item to the Service Request where they require the Service Request to be executed at a future date and time. The UTC date and time the User requires the command to be executed on the Device Date-time in the future that is either <= current date + 30 days or the date = ‘3000-12-31T00:00:00Z’xs:dateTimeNoNoneUTC Date-Time
ReadLogPeriodThe Start and End Date-Times for which the data is required. The daily log entry is created and dated at midnight and therefore the Start and End Date-Times must encompass at least one midnight time.sr:ReadLogPeriod (see clause 3.10.1.14)YesNoneN/A
KAPublicSecurityCredentialsThe Key Agreement Public Security Credentials (of the requesting party) to be used where the request is from an Unknown Remote Party (i.e. Other User) with respect to the BusinessTargetID specified within the Service Request.sr:Certificate (xs:base64Binary)User Role ED, GT: N/A User Role MDR, OU: Yes User Roles IS/GS that do not have their credentials on the Device when sending the Service Request e.g. Old Suppliers YesNoneN/A
Table 155: DSPRetrieveDailyConsumptionLog (sr:ReadLogPeriodOffset) data items
Data ItemDescription / Allowable valuesTypeMandatoryDefaultUnits
DSPRetrieveDailyConsumptionLogThe Start and End Date Offsets from the current date and the Start and End Times which together define the date-time period for which the data is requiredNote: Item only used when Creating Schedulessr:ReadLogPeriodOffset (See clause 3.10.1.15)YesNoneN/A

DUGIDS service matrix

DUGIDS DS.0226 Table 36 footnote extract

FootnoteExtractColumnCell ValueSource
5Service Request also available to the ‘Old’ Registered Supplier (EIS)Eligible User RoleEISDS.0226 Table 36 Service Request Matrix
5Service Request also available to the ‘Old’ Registered Supplier (EIS)Eligible User RoleGISDS.0226 Table 36 Service Request Matrix
11Service Request also available to the ‘Old’ Registered Meter Data RetrieverEligible User RoleMDRDS.0226 Table 36 Service Request Matrix
7Service Request can’t be Sequenced for Gas, because the DCC can’t read the encrypted status returned by the DeviceService Reference Variant4.17DS.0226 Table 36 Service Request Matrix

Message Patterns & Examples

Pattern explorer

Open Message Patterns →