TECHNICAL REPORT

Comprehensive Semantic Model

Blue Book Edition 15 Part 2 Amendment 1

for Energy Management

COSEM Interface Classes

DLMS UA 1000-1 Ed. 15 Part 2 Am. 1

27 th June 2023

Version 1.0

DLMS User Association

© Copyright 1997-2023 DLMS User Association

 CONTENTS
CONTENTS ................................................................................................................... 1
1 Scope ..................................................................................................................... 3
1.1 Clause 4.1.8.4 Mandatory contents of a COSEM logical device ............................ 3
1.2 Clause 4.13.7 G3-PLC Hybrid RF MAC setup (class_id = 161, version = 0) ........... 3
1.3 Clause 6.2.7 Script table objects (class_id = 9) ................................................... 3
1.4 Clause 6.2.38 Function control objects (class_id = 122) ....................................... 3
2 Revision history ....................................................................................................... 3
3 Technical corrections ............................................................................................... 4
3.1 Mandatory contents of a COSEM logical device (Clause 4.1.8.4 of DLMS UA
1000-1 Ed. 15 Part 2) ....................................................................................... 4
3.2 G3-PLC Hybrid RF MAC setup (class_id = 161, version = 0) (Clause 4.13.7
of DLMS UA 1000-1 Ed. 15 ............................................................................... 4
3.3 Script table objects (class_id = 9) (Clause 6.2.7 of DLMS UA 1000 -1 Ed. 15
Part 2) ............................................................................................................ 5
3.4 Function control objects (class_id = 122) (Clause 6.2.38 of DLMS UA 1000 -1
Ed. 15 Part 2) .................................................................................................. 7

DLMS User Association 2023-06-27 DLMS UA 1000-1 Part 2 Ed 15 Am. 1 1/7

 FOREWORD
Copyright

© Copyright 1997-2023 DLMS User Association

This document is confidential. It may not be copied, nor handed over to persons outside the
DLMS User Association.

The copyright is enforced by national and international law. The "Berne Convention for the
Protection of Literary and Artistic Works", which is signed by 176 countries world -wide, and
other treaties apply.

Acknowledgement

The document has been written by members of DLMS UA Maintenance Working Group .

2/7 2023-06-27 DLMS UA 1000-1 Part 2 Ed. 15 Am. 1 DLMS User Association
 1 Scope

Amendment 1 amends the following Clauses of DLMS UA 1000-1 Ed. 15 Part 2 (Blue Book Part
2 Edition 15):

1.1 Clause 4.1.8.4 Mandatory contents of a COSEM logical device

The text has been amended to mandate that Device ID#1 (Manufacturing number AKA Serial
Nr.) is present in at least one LD and visible in at least one AA.

A paragraph to this effect has been inserted in the Clause.

The text in the Clause has also been amended to clarify the use of mandatory firmware identifier
objects.

1.2 Clause 4.13.7 G3-PLC Hybrid RF MAC setup (class_id = 161, version = 0)

In the table of clause 4.13.7.1, the data type value of attribute “mac_channel_number_RF” has
been changed from “unsigned” to “long-unsigned).

1.3 Clause 6.2.7 Script table objects (class_id = 9)

The text has been amended to include support for new OBIS codes and attributes to support
EVCS charging, in line with the EVCS Profile Phase 1.

An entry for “EVCS values script table” has been added to the Script table objects table, along
with it associated description.

1.4 Clause 6.2.38 Function control objects (class_id = 122)

The OBIS code “B” value has been changed from “0” to “b”.

2 Revision history

Version Date Author Comment

0.1 9/1/23 Gould Initial draft

GK 230224: Update

0.3 Gould Update for review

0.4 Gould Updates following review
0.8 Gould For approval by Maintenance WG
0.8.1 21/3/23 Gould Corrected broken references in 3.2 and issued to Technical Board for
approval

0.8.2. 27/03/2023 Gould

29/03/2023 Commented by G.Kmethy
0.9 4/4/23 Gould Included GK comments
1.0 27/6/23 Gould Published

DLMS User Association 2023-06-27 DLMS UA 1000-1 Part 2 Ed 15 Am. 1 3/7

3 Technical corrections

3.1 Mandatory contents of a COSEM logical device (Clause 4.1.8.4 of DLMS UA 1000-1
Ed. 15 Part 2)

The following objects shall be present in each COSEM logical device. They shall be accessible
for GET/Read in all AAs with this logical device:

• COSEM logical device name object;

• current “Association” (LN or SN) object.

If the “SAP Assignment” object is present, then the COSEM logical device name object does
not have to be present.

The Device ID # 1 (Manufacturing number, AKA Serial Nr.) object, OBIS code 0 -b:96.1-0*255
is mandatory. It can be present in any logical device and visible in any AA, but it shall be present
in at least one LD and visible in at least one AA. Its value shall be readable.

For identifying the firmware the following objects are mandatory:

• at least one abstract or energy type related an active firmware identifier object that holds
the identifier of the currently active firmware identifier; and
• at least one abstract or energy type related active firmware signature object that holds the
digital signature of the currently active firmware.
NOTE The digital signature algorithm is not specified here.

If a Logical Device has multiple firmware modules then an active firmware identifier object and
an active firmware signature object shall be present for each .
The related active firmware identifier and active firmware signature shall be linked to each other
via value group B.
The following objects may be optionally present:
• one or more active firmware version object(s) that hold(s) the version of the currently
active firmware.

3.2 G3-PLC Hybrid RF MAC setup (class_id = 161, version = 0) (Clause 4.13.7 of DLMS
UA 1000-1 Ed. 15 Part 2)
4.13.7.1 Overview

An instance of the “G3-PLC Hybrid RF MAC setup” IC holds the necessary additional
parameters to set up and manage the G3-PLC Hybrid PLC & RF IEEE 802.15.4:2015 RF MAC
sub-layer.
These attributes influence the functional behaviour of an implementation. Implementations may
allow changes to the attributes during normal running, i.e. even after the device start -up
sequence has been executed.

4/7 2023-06-27 DLMS UA 1000-1 Part 2 Ed. 15 Am. 1 DLMS User Association
 G3-PLC Hybrid RF MAC setup 0…n class_id = 161, version = 0
Attributes Data type Min Max. Def. Short
. name
1. logical_name (static) octet-string x
2. mac_max_BE_RF (static) unsigned 3 14 0 x + 0x08
3. mac_max_CSMA_backoffs_RF (static) double-long-unsigned 0 5 4 x + 0x10
4. mac_frame_retries_RF (static) unsigned 0 7 3 x + 0x18
5. mac_max_min_BE_RF (static) unsigned 0 14 3 x + 0x20
6. mac_frame_counter_RF (dyn.) double-long-unsigned 0 4 294 967 295 0 x + 0x28
7. mac_duplicate_detection_TTL_ (static) bit-string 0 255 3 x + 0x30
RF
8. mac_POS_table_RF (dyn.) array x + 0x38
9. mac_operating_mode_RF (static) unsigned 1 2 1 x + 0x40
10. mac_channel_number_RF (static) long-unsigned 0 7279 0 x + 0x48
11. mac_duty_cycle_usage_RF (dyn) unsigned 0 100 0 x + 0x50
12. mac_duty_cycle_period_RF (static) long-unsigned 1 65535 360 x + 0x58
0
13. mac_duty_cycle_limit_RF (static) Long-unsigned 1 65535 90 x + 0x60
14. mac_duty_cycle_threshold_RF (static) unsigned 1 100 90 x + 0x68
15. mac_disable_PHY_RF (static) boolean FAL x + 0x70
SE
Specific methods m/o
1. mac_get_POS_table_entry_RF o x + 0xA0
(data)

3.3 Script table objects (class_id = 9) (Clause 6.2.7 of DLMS UA 1000-1 Ed. 15 Part 2)

Instances of the IC “Script table” – see 4.5.2 – control the behaviour of the device.

Several instances are predefined and normally available as hidden scripts only with access to
the execute () method. The following table contains only the identifiers for the “standard”
instances of the listed scripts. Implementation specific instances of these scripts should use
values different from zero in value group D.

• MDI reset / End of billing period “Script table” objects define the actions to be performed
at the end of the billing period, for example the reset of maximum demand indicator
registers and archiving data. If there are several billing period schemes available, then
there shall be one script present in the array of scripts for each billing period scheme.
• Tariffication “Script table” objects define the entry point into tariffication by standardizing
utility-wide how to invoke the activation of certain tariff conditions;
• Disconnect control “Script table” objects hold the scripts to invoke the methods of
“Disconnect control” objects;
• Image activation “Script table” objects are is used to locally activate an Image
transferred to the server, at the date and time held by an Image activation “Single action
schedule” object;
• Push “Script table” objects hold scripts to activate the push operation. Normally every
entry in the array of scripts calls the push method of one “Push setup” obje ct instance;

DLMS User Association 2023-06-27 DLMS UA 1000-1 Part 2 Ed 15 Am. 1 5/7

 • Load profile control “Script table” allow to change attributes of “Profile generic” objects
e.g. to change the capture period and thus allow extended time control;
• M-Bus profile control “Script table” allow to change attributes of M -Bus related “Profile
generic” objects e.g. to change the capture period and thus allow extended time control;
• Function control “Script table” objects allow making changes to “Function control”
objects;
• EVCS values “Script table” objects allow making changes to “Possible” ( A = 1 or 2,D =
60) objects and other objects related to EVCS data provision;
• Broadcast “Script table” objects allow standardising utility wide the entry point into
regularly needed functionality.

OBIS code
Script table objects IC
A B C D E F
a 0 b 10 0 0 255
Global meter reset Script table
a 0 b 10 0 1 255
MDI reset / End of billing period Script table
Tariffication Script table 0 b 10 0 100 255
a 0 b 10 0 101 255
Activate test mode Script table
a 0 b 10 0 102 255
Activate normal mode Script table
Set output signals Script table 0 b 10 0 103 255
b, c 0 b 10 0 104 255
Switch optical test output Script table
Power quality measurement management Script 0 b 10 0 105 255
table
9, Script table
Disconnect control Script table 0 b 10 0 106 255

Image activation Script table 0 b 10 0 107 255

Push Script table 0 b 10 0 108 255
Load profile control Script table 0 b 10 0 109 255
M-Bus profile control Script table 0 b 10 0 110 255
Function control Script table 0 b 10 0 111 255
EVCS values script table 0 b 10 0 112 255

Broadcast Script table 0 b 10 0 125 255

a
The activation of these scripts is performed by calling the execute() method to the script identifier 1 of the
corresponding script object.
b
The optical test output is switched to measuring quantity Y and the test mode is activated by calling the execute
method of the script table object 0.x.10.0.104.255 using Y as parameter; where Y is given by see DLMS UA
1000-1 Ed 15 Part 1:2021 Table 13. The default value of A is 1 (Electricity).

EXAMPLE In the case of electricity meters, A = 1, default, execute (21) switches the test output to display
the active power + of phase 1.
c
The optical test output is also switched back to its default value when this script is activated.

6/7 2023-06-27 DLMS UA 1000-1 Part 2 Ed. 15 Am. 1 DLMS User Association
3.4 Function control objects (class_id = 122) (Clause 6.2.38 of DLMS UA 1000-1 Ed. 15
Part 2)

Instances of the IC “Function control“ – see Error! Reference source not found. – allow
enabling and disabling functions in the server.

OBIS code
Function control related objects IC
A B C D E F

Function control 122, Function control 0 b 44 1 e 255

DLMS User Association 2023-06-27 DLMS UA 1000-1 Part 2 Ed 15 Am. 1 7/7