IEC 62386-301:2017
(Main)Digital addressable lighting interface - Part 301: Particular requirements - Input devices - Push buttons
Digital addressable lighting interface - Part 301: Particular requirements - Input devices - Push buttons
IEC 62386-301:2017 specifies a bus system for control by digital signals of electronic lighting equipment which is in line with the requirements of IEC 61347, with the addition of DC supplies.
This document is only applicable to IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:— input devices that make the lighting control system sensitive to push button operations.
Interface d'éclairage adressable numérique - Partie 301: Exigences particulières - Dispositifs d'entrée - Boutons-poussoirs
L'IEC 62386-301:2017 spécifie un système à bus pour la commande par signaux numériques des appareils d’éclairage électroniques conformes aux exigences de l'IEC 61347, en ajoutant les alimentations en courant continu.
Le présent document s'applique uniquement aux dispositifs d'entrée couverts par l'IEC 62386-103:2014 et l'IEC 62386-103/AMD1:— qui rendent le système de commande d'éclairage sensible à l'exploitation de boutons-poussoirs.
General Information
Standards Content (Sample)
IEC 62386-301 ®
Edition 1.0 2017-05
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
Digital addressable lighting interface –
Part 301: Particular requirements – Input devices – Push buttons
Interface d'éclairage adressable numérique –
Partie 301: Exigences particulières – Dispositifs d'entrée – Boutons-poussoirs
All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form
or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from
either IEC or IEC's member National Committee in the country of the requester. If you have any questions about IEC
copyright or have an enquiry about obtaining additional rights to this publication, please contact the address below or
your local IEC member National Committee for further information.
Droits de reproduction réservés. Sauf indication contraire, aucune partie de cette publication ne peut être reproduite
ni utilisée sous quelque forme que ce soit et par aucun procédé, électronique ou mécanique, y compris la photocopie
et les microfilms, sans l'accord écrit de l'IEC ou du Comité national de l'IEC du pays du demandeur. Si vous avez des
questions sur le copyright de l'IEC ou si vous désirez obtenir des droits supplémentaires sur cette publication, utilisez
les coordonnées ci-après ou contactez le Comité national de l'IEC de votre pays de résidence.
IEC Central Office Tel.: +41 22 919 02 11
3, rue de Varembé Fax: +41 22 919 03 00
CH-1211 Geneva 20 info@iec.ch
Switzerland www.iec.ch
About the IEC
The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes
International Standards for all electrical, electronic and related technologies.
About IEC publications
The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the
latest edition, a corrigenda or an amendment might have been published.
IEC Catalogue - webstore.iec.ch/catalogue Electropedia - www.electropedia.org
The stand-alone application for consulting the entire The world's leading online dictionary of electronic and
bibliographical information on IEC International Standards, electrical terms containing 20 000 terms and definitions in
Technical Specifications, Technical Reports and other English and French, with equivalent terms in 16 additional
documents. Available for PC, Mac OS, Android Tablets and languages. Also known as the International Electrotechnical
iPad. Vocabulary (IEV) online.
IEC publications search - www.iec.ch/searchpub IEC Glossary - std.iec.ch/glossary
The advanced search enables to find IEC publications by a 65 000 electrotechnical terminology entries in English and
variety of criteria (reference number, text, technical French extracted from the Terms and Definitions clause of
committee,…). It also gives information on projects, replaced IEC publications issued since 2002. Some entries have been
and withdrawn publications. collected from earlier publications of IEC TC 37, 77, 86 and
CISPR.
IEC Just Published - webstore.iec.ch/justpublished
Stay up to date on all new IEC publications. Just Published IEC Customer Service Centre - webstore.iec.ch/csc
details all new publications released. Available online and If you wish to give us your feedback on this publication or
also once a month by email. need further assistance, please contact the Customer Service
Centre: csc@iec.ch.
A propos de l'IEC
La Commission Electrotechnique Internationale (IEC) est la première organisation mondiale qui élabore et publie des
Normes internationales pour tout ce qui a trait à l'électricité, à l'électronique et aux technologies apparentées.
A propos des publications IEC
Le contenu technique des publications IEC est constamment revu. Veuillez vous assurer que vous possédez l’édition la
plus récente, un corrigendum ou amendement peut avoir été publié.
Catalogue IEC - webstore.iec.ch/catalogue Electropedia - www.electropedia.org
Application autonome pour consulter tous les renseignements
Le premier dictionnaire en ligne de termes électroniques et
bibliographiques sur les Normes internationales,
électriques. Il contient 20 000 termes et définitions en anglais
Spécifications techniques, Rapports techniques et autres
et en français, ainsi que les termes équivalents dans 16
documents de l'IEC. Disponible pour PC, Mac OS, tablettes
langues additionnelles. Egalement appelé Vocabulaire
Android et iPad.
Electrotechnique International (IEV) en ligne.
Recherche de publications IEC - www.iec.ch/searchpub
Glossaire IEC - std.iec.ch/glossary
65 000 entrées terminologiques électrotechniques, en anglais
La recherche avancée permet de trouver des publications IEC
en utilisant différents critères (numéro de référence, texte, et en français, extraites des articles Termes et Définitions des
comité d’études,…). Elle donne aussi des informations sur les publications IEC parues depuis 2002. Plus certaines entrées
projets et les publications remplacées ou retirées. antérieures extraites des publications des CE 37, 77, 86 et
CISPR de l'IEC.
IEC Just Published - webstore.iec.ch/justpublished
Service Clients - webstore.iec.ch/csc
Restez informé sur les nouvelles publications IEC. Just
Published détaille les nouvelles publications parues. Si vous désirez nous donner des commentaires sur cette
Disponible en ligne et aussi une fois par mois par email. publication ou si vous avez des questions contactez-nous:
csc@iec.ch.
IEC 62386-301 ®
Edition 1.0 2017-05
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
Digital addressable lighting interface –
Part 301: Particular requirements – Input devices – Push buttons
Interface d'éclairage adressable numérique –
Partie 301: Exigences particulières – Dispositifs d'entrée – Boutons-poussoirs
INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
COMMISSION
ELECTROTECHNIQUE
INTERNATIONALE
ICS 29.140.50; 29.140.99 ISBN 978-2-8322-4341-1
– 2 – IEC 62386-301:2017 © IEC 2017
CONTENTS
FOREWORD . 4
INTRODUCTION . 6
1 Scope . 8
2 Normative references . 8
3 Terms and definitions . 8
4 General . 9
4.1 General . 9
4.2 Version number . 9
4.3 Insulation . 9
5 Electrical specification . 9
6 Interface power supply . 9
7 Transmission protocol structure . 10
8 Timing . 10
9 Method of operation . 10
9.1 General . 10
9.2 Instance type . 10
9.3 Input signal and value . 10
9.4 Events . 10
9.4.1 Priority use . 10
9.4.2 Bus usage . 10
9.4.3 Encoding . 11
9.4.4 Untimed events . 11
9.4.5 Timed events . 12
9.4.6 Event configuration . 14
9.4.7 Event generation . 14
9.5 Configuring the input device . 15
9.5.1 Setting the timers . 15
9.5.2 Manual configuration . 16
9.6 Exception handling. 16
9.6.1 Button stuck . 16
9.6.2 Manufacturer specific errors . 16
9.6.3 Error value . 16
10 Declaration of variables . 17
11 Definition of commands . 18
11.1 General . 18
11.2 Overview sheets . 18
11.2.1 General . 18
11.2.2 Standard commands . 18
11.3 Event messages . 18
11.3.1 INPUT NOTIFICATION (device/instance, event) . 18
11.3.2 POWER NOTIFICATION (device) . 18
11.4 Device control instructions . 18
11.5 Device configuration instructions . 18
11.6 Device queries . 19
11.7 Instance control instructions . 19
11.8 Instance configuration instructions . 19
11.8.1 General . 19
11.8.2 SET EVENT FILTER (DTR0) . 19
11.8.3 SET SHORT TIMER (DTR0) . 19
11.8.4 SET DOUBLE TIMER (DTR0) . 19
11.8.5 SET REPEAT TIMER (DTR0) . 19
11.8.6 SET STUCK TIMER (DTR0) . 19
11.9 Instance queries . 19
11.9.1 General . 19
11.9.2 QUERY INSTANCE ERROR . 20
11.9.3 QUERY SHORT TIMER . 20
11.9.4 QUERY SHORT TIMER MIN . 20
11.9.5 QUERY DOUBLE TIMER . 20
11.9.6 QUERY DOUBLE TIMER MIN . 20
11.9.7 QUERY REPEAT TIMER . 20
11.9.8 QUERY STUCK TIMER . 20
11.10 Special commands . 20
Bibliography . 21
Figure 1 – IEC 62386 graphical overview . 6
Figure 2 – Button pressed/button released events . 12
Figure 3 – Short press event . 12
Figure 4 – Double press event . 13
Figure 5 – Long press event . 13
Figure 6 – Button stuck event . 14
Table 1 – Meaning of “inputValue” . 10
Table 2 – Push button input events . 11
Table 3 – Event filter . 14
Table 4 – Event timer setting . 15
Table 5 – “manualCapabilityInstance3xx” values . 16
Table 6 – “instanceErrorByte” values . 16
Table 7 – Declaration of device variables . 17
Table 8 – Restrictions to instance variables defined in IEC 62386-103:2014 and
IEC 62386-103:2014/AMD1:— . 17
Table 9 – Declaration of instance variables . 17
Table 10 – Standard commands . 18
– 4 – IEC 62386-301:2017 © IEC 2017
INTERNATIONAL ELECTROTECHNICAL COMMISSION
____________
DIGITAL ADDRESSABLE LIGHTING INTERFACE –
Part 301: Particular requirements – Input devices – Push buttons
FOREWORD
1) The International Electrotechnical Commission (IEC) is a worldwide organization for standardization comprising
all national electrotechnical committees (IEC National Committees). The object of IEC is to promote
international co-operation on all questions concerning standardization in the electrical and electronic fields. To
this end and in addition to other activities, IEC publishes International Standards, Technical Specifications,
Technical Reports, Publicly Available Specifications (PAS) and Guides (hereafter referred to as “IEC
Publication(s)”). Their preparation is entrusted to technical committees; any IEC National Committee interested
in the subject dealt with may participate in this preparatory work. International, governmental and non-
governmental organizations liaising with the IEC also participate in this preparation. IEC collaborates closely
with the International Organization for Standardization (ISO) in accordance with conditions determined by
agreement between the two organizations.
2) The formal decisions or agreements of IEC on technical matters express, as nearly as possible, an international
consensus of opinion on the relevant subjects since each technical committee has representation from all
interested IEC National Committees.
3) IEC Publications have the form of recommendations for international use and are accepted by IEC National
Committees in that sense. While all reasonable efforts are made to ensure that the technical content of IEC
Publications is accurate, IEC cannot be held responsible for the way in which they are used or for any
misinterpretation by any end user.
4) In order to promote international uniformity, IEC National Committees undertake to apply IEC Publications
transparently to the maximum extent possible in their national and regional publications. Any divergence
between any IEC Publication and the corresponding national or regional publication shall be clearly indicated in
the latter.
5) IEC itself does not provide any attestation of conformity. Independent certification bodies provide conformity
assessment services and, in some areas, access to IEC marks of conformity. IEC is not responsible for any
services carried out by independent certification bodies.
6) All users should ensure that they have the latest edition of this publication.
7) No liability shall attach to IEC or its directors, employees, servants or agents including individual experts and
members of its technical committees and IEC National Committees for any personal injury, property damage or
other damage of any nature whatsoever, whether direct or indirect, or for costs (including legal fees) and
expenses arising out of the publication, use of, or reliance upon, this IEC Publication or any other IEC
Publications.
8) Attention is drawn to the Normative references cited in this publication. Use of the referenced publications is
indispensable for the correct application of this publication.
9) Attention is drawn to the possibility that some of the elements of this IEC Publication may be the subject of
patent rights. IEC shall not be held responsible for identifying any or all such patent rights.
International Standard IEC 62386-301 has been prepared by subcommittee 34C: Auxiliaries
for lamps, of IEC technical committee 34: Lamps and related equipment.
The text of this standard is based on the following documents:
FDIS Report on voting
34C/1311A/FDIS 34C/1331/RVD
Full information on the voting for the approval of this International Standard can be found in
the report on voting indicated in the above table.
This document has been drafted in accordance with the ISO/IEC Directives, Part 2.
This Part 301 of IEC 62386 is intended to be used in conjunction with:
• Part 101, which contains general requirements for system components;
• Part 103, which contains general requirements for control devices.
A list of all parts in the IEC 62386 series, published under the general title: Digital
addressable lighting interface, can be found on the IEC website.
The committee has decided that the contents of this document will remain unchanged until the
stability date indicated on the IEC website under "http://webstore.iec.ch" in the data related to
the specific document. At this date, the document will be
• reconfirmed,
• withdrawn,
• replaced by a revised edition, or
• amended.
IMPORTANT – The 'colour inside' logo on the cover page of this publication indicates
that it contains colours which are considered to be useful for the correct
understanding of its contents. Users should therefore print this document using a
colour printer.
– 6 – IEC 62386-301:2017 © IEC 2017
INTRODUCTION
IEC 62386 contains several parts, referred to as series. The 1xx series includes the basic
specifications. Part 101 contains general requirements for system components, Part 102
extends this information with general requirements for control gear and Part 103 extends it
further with general requirements for control devices.
The 2xx parts extend the general requirements for control gear with lamp specific extensions
(mainly for backward compatibility with Edition 1 of IEC 62386) and with control gear specific
features.
The 3xx parts extend the general requirements for control devices with input device specific
extensions describing the instance types as well as some common features that can be
combined with multiple instance types.
This first edition of IEC 62386-301 is intended to be used in conjunction with
IEC 62386-101:2014, IEC 62386-101:2014/AMD1:—, IEC 62386-103:2014 and
IEC 62386-103:2014/AMD1:—. The division of IEC 62386 into separately published parts
provides for ease of future amendments and revisions. Additional requirements will be added
as and when a need for them is recognized.
The setup of the standards is graphically represented in Figure 1 below.
2xx 2xx 2xx 2xx 2xx 3xx 3xx 3xx 3xx 3xx
102 General requirements - 103 General requirements -
Control gear Control devices
101 General requirements -
System components
IEC
Figure 1 – IEC 62386 graphical overview
This document, and the other parts that make up the IEC 62386-300 series, in referring to any
of the clauses of IEC 62386-1XX, specifies the extent to which such a clause is applicable;
the parts also include additional requirements, as necessary.
Where the requirements of any of the clauses of IEC 62386-1XX are referred to in this
document by the sentence “The requirements of IEC 62386-1XX, Clause “n” apply”, this
sentence is to be interpreted as meaning that all requirements of the clause in question of
Part 1XX apply, except any which are clearly inapplicable.
The standardization of the control interface for control devices is intended to achieve
compatible co-existence and multi-master operation between electronic control gear and
lighting control devices, below the level of building management systems. This document
describes a method of implementing control devices.
All numbers used in this document are decimal numbers unless otherwise noted. Hexadecimal
numbers are given in the format 0xVV, where VV is the value. Binary numbers are given in
the format XXXXXXXXb or in the format XXXX XXXX, where X is 0 or 1; “x” in binary numbers
means “don't care”.
The following typographic expressions are used:
Variables: “variableName” or “variableName[3:0]”, giving only bits 3 to 0 of “variableName”.
Range of values: [lowest, highest]
Command: “COMMAND NAME”
– 8 – IEC 62386-301:2017 © IEC 2017
DIGITAL ADDRESSABLE LIGHTING INTERFACE –
Part 301: Particular requirements – Input devices – Push buttons
1 Scope
This part of IEC 62386 specifies a bus system for control by digital signals of electronic
lighting equipment which is in line with the requirements of IEC 61347, with the addition of DC
supplies.
This document is only applicable to IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—
input devices that make the lighting control system sensitive to push button operations.
NOTE Requirements for testing individual products during production are not included.
2 Normative references
The following documents are referred to in the text in such a way that some or all of their
content constitutes requirements of this document. For dated references, only the edition
cited applies. For undated references, the latest edition of the referenced document (including
any amendments) applies.
IEC 62386-101:2014, Digital addressable lighting interface – Part 101: General requirements
– System components
IEC 62386-101:2014/AMD1:—
IEC 62386-103:2014, Digital addressable lighting interface – Part 103: General requirements
– Control devices
IEC 62386-103:2014/AMD1:—
IEC 62386-333:— , Digital addressable lighting interface – Part 333: Particular requirements
for control devices – Manual configuration (feature type 33)
3 Terms and definitions
For the purposes of this document, the terms and definitions given in IEC 62386-101 and
IEC 62386-103 and the following apply.
ISO and IEC maintain terminological databases for use in standardization at the following
addresses:
• IEC Electropedia: available at http://www.electropedia.org/
• ISO Online browsing platform: available at http://www.iso.org/obp
3.1
instance
push button processing unit of an input device
_____________
Under preparation. Stage at the time of publication: IEC ACDV 62386-101/AMD1:2017.
Under preparation. Stage at the time of publication: IEC ACDV 62386-103/AMD1:2017.
Under preparation. Stage at the time of publication: IEC CCDV 62386-333:2017.
[SOURCE: IEC 62386-101:2014, 3.29, modified — "signal" replaced by "push button"]
3.2
bouncing
tendency of any two contacts in an electronic device to generate multiple signals as the
contacts close or open
3.3
debouncing
any kind of hardware device or software that ensures that only a single signal will be acted
upon for a single opening or closing of a contact
3.4
push button
means for the end user to interact with a lighting control system and known to be in the
released state except while the end user is pressing it, in which case it is in the pressed state
3.5
strictly monotonic
either entirely increasing or decreasing without repeating values
Note 1 to entry: Function f defined on a subset of the real numbers with real values is called monotonically
increasing, if for all x and y such that x < y one has f(x) < f(y), so f preserves the order. Likewise, a function is
called monotonically decreasing if, whenever x < y, then f(x) > f(y), so it reverses the order. For this document
strictly monotonic is defined as either monotonically increasing or monotonically decreasing.
4 General
4.1 General
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, Clause 4 apply,
with the restrictions, changes and additions identified below.
4.2 Version number
In 4.2 of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, “103” shall be replaced by
“301”, “version number” shall be replaced by “extended version number” and “versionNumber”
shall be replaced by “extendedVersionNumber”.
4.3 Insulation
According to IEC 61347-1 it might be required that the input device has at least
supplementary insulation. This depends on the connected components. In case internal
buttons are used, the input device shall have at least supplementary insulation. In case of
external connected components, it depends on the requirements imposed on these
components.
NOTE IEC-62386-103:2014 and IEC 62386-103:2014/AMD1:— require system components to have at least basic
insulation. Push buttons are intended to be safely operable by end users.
5 Electrical specification
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, Clause 5 apply.
6 Interface power supply
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, Clause 6 apply.
– 10 – IEC 62386-301:2017 © IEC 2017
7 Transmission protocol structure
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, Clause 7 apply.
NOTE Subclause 9.4 provides detailed event information applicable to instances.
8 Timing
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, Clause 8 apply.
9 Method of operation
9.1 General
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, Clause 9 apply,
with the following restrictions and additions.
9.2 Instance type
The instance type (“instanceType”) shall be equal to 1.
9.3 Input signal and value
The input “resolution” shall be equal to 1.
NOTE 1 A “resolution” of 1 implies that “inputValue” is a single byte variable with possible values limited to 0x00
and 0xFF.
NOTE 2 Since “inputValue” is a single byte variable, the instance will answer NO to “QUERY INPUT VALUE
LATCH”.
“inputValue” shall reflect the state of the push button or binary input, as shown in Table 1.
Table 1 – Meaning of “inputValue”
“inputValue” Push button state
0x00 Released
0xFF Pressed
A bouncing input signal shall be adequately debounced to ensure a single change of
“inputValue”.
9.4 Events
9.4.1 Priority use
The default “eventPriority” shall be priority 3. Since the application controller needs a timeslot
to respond, “eventPriority” should not be set to 2.
9.4.2 Bus usage
9.4.2.1 Instance level
Multiple events from an instance shall not be sent in a transaction.
9.4.2.2 Device level
At the device level events from different instances may be sent in a transaction.
9.4.3 Encoding
Push button events shall be encoded as shown in Table 2. Details on event timing are
described in 9.4.5.
Table 2 – Push button input events
Event name Event information Description
a
Button released 00 0000 0000b The button is released.
a
Button pressed 00 0000 0001b The button is pressed.
a
Short press 00 0000 0010b The button is pressed and released, without being pressed quickly
again (in case double press is enabled), or the button is pressed
and quickly released (in case double press is disabled).
a
Double press 00 0000 0101b The button is pressed and released, quickly followed by another
button press.
a
Long press start 00 0000 1001b The button is pressed without releasing it.
a
Long press repeat 00 0000 1011b Following a long press start condition, the button is still pressed.
The event occurs at regular intervals as long as the condition
holds.
a
Long press stop 00 0000 1100b Following a long press start condition, the button is released.
a
Button free 00 0000 1110b The button has been stuck and is now released.
a
Button stuck 00 0000 1111b The button has been pressed for a very long time and is assumed
stuck.
00 0000 0011b Reserved for future use.
00 0000 0100b
00 0000 011xb
00 0000 10x0b
00 0000 1101b
1x xxxx xxxxb
01 xxxx xxxxb
00 1xxx xxxxb
00 01xx xxxxb
00 001x xxxxb
a
Bit 0 always contains button pressed or button released information.
NOTE In order to save bus bandwidth, the application controller has the possibility to inhibit event notifications
that it does not need, as is described in 9.4.6.
A change of “inputValue” shall generate a maximum of one event. The button
pressed/released information is always present and can be derived from the event encoding.
9.4.4 Untimed events
The button pressed/released events are shown in Figure 2.
– 12 – IEC 62386-301:2017 © IEC 2017
0xFF
“inputValue”
0x00
“event” Button pressed Button released
IEC
Figure 2 – Button pressed/button released events
9.4.5 Timed events
Events are subject to the following timing configurations:
• T – The time which differentiates a short press from a long press. If a button is
short
released within T , either a short or a double press event will follow; a long press event
short
otherwise.
• T – The time which differentiates a single (short) press from a double press. If a
double
button is not pressed once more within T , a short press event occurs, a double press
double
event otherwise.
• T – The repetition interval of long press repeat events.
repeat
• T – If a button is pressed or bouncing longer than T it is considered broken.
stuck stuck
Given the above timing definitions, event timing shall be as indicated in Figure 3 for a short
press.
T
short
T
double
0xFF
“inputValue”
0x00
“event” Button pressed Button released Short press
IEC
Figure 3 – Short press event
NOTE If T is set to 0 (which means event disabled) a short press event is recognized directly with Button
double
released. See 9.5.1.
T
short
T
double
0xFF
“inputValue”
0x00
Button pressed
“event” Button pressed Button released
or Double press
IEC
Figure 4 – Double press event
Figure 4 shows the events for a double press event. If the double press event is enabled,
there is no separate button pressed event. However, the button pressed information can be
retrieved from the double press event, see Table 2.
Following a double press event, no further events shall occur until the button is released
(leading to a button released event) or the button is declared stuck (leading to a button stuck
event).
A double press event cannot occur on the first button press after a previous double press
event.
T T T T
short repeat repeat repeat
0xFF
“inputValue”
0x00
Long press start Long press repeat
Button released
or Long press stop
Button pressed
“event”
IEC
Figure 5 – Long press event
Figure 5 shows the events for a long button press. If the long press stop event is enabled,
there is no separate button released event. However, the button released information can be
retrieved from the long press stop event, see Table 2.
– 14 – IEC 62386-301:2017 © IEC 2017
T
stuck
0xFF
“inputValue”
0x00
“event” Button pressed Button stuck
IEC
Figure 6 – Button stuck event
Following a button stuck event (see Figure 6), no further events shall occur until the button is
released. This shall lead to maximum one single event, depending on the “eventFilter”.
9.4.6 Event configuration
The application controller may not need all the events mentioned in 9.4.3. The instance shall
allow the application controller to set the “eventFilter” (see IEC 62386-103:2014 and
IEC 62386-103:2014/AMD1:—, 9.7.4) to inhibit those events that the application controller
does not need. For this document, “eventFilter” shall be reduced to one byte.
NOTE Inhibiting events increases the effective bus bandwidth availability.
The “eventFilter” shall have the definition as given in Table 3:
Table 3 – Event filter
Bit Description Value Default
0 Button released event enabled? "1" = "Yes" 0
1 Button pressed event enabled? "1" = "Yes" 0
2 Short press event enabled? "1" = "Yes" 1
3 Double press event enabled? "1" = "Yes" 0
4 Long press start event enabled? "1" = "Yes" 1
5 Long press repeat event enabled? "1" = "Yes" 1
6 Long press stop event enabled? "1" = "Yes" 1
7 Button stuck/free event enabled? “1” = “Yes” 1
The filter can be set via “SET EVENT FILTER (DTR0)” and be queried using
“QUERY EVENT FILTER 0-7”, see IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—
for details.
9.4.7 Event generation
An event shall be generated on every change of “inputValue” or when required according to a
timer.
In case of system failure all events shall be cleared. Events that occurred during the system
failure shall not be sent after the bus has been restored.
In case the bus is busy, and if during this time multiple events occur, at least the last event
shall be sent.
9.5 Configuring the input device
9.5.1 Setting the timers
Event timers shall be programmable as is indicated in Table 4.
For each timer, a fixed minimum duration and a fixed increment duration are given. The
application controller can set the desired actual timer duration by setting the number of
increments to some value in the range [0,255]. The resulting time shall be strictly monotonic
according to the following formula:
Time = T * multiplier
incr
Only on (re-)starting a timer the actual time shall be calculated based on the corresponding
variable. This implies that the times only change after any running timer has been cancelled
or expired. The tolerance on the time shall be ±5 %.
The T and T timers have device specific physical minimum values to accommodate
short double
techniques that cannot cover the entire range of the timers.
Table 4 – Event timer setting
Time Multiplier Default value
T T T T
incr default min max
T “tShort” Max(25, 20 ms Max(25, “tShortMin”)*20 ms “tShortMin” * 20 ms 5 100 ms
short
“tShortMin”)
a a
T “tDouble” 0 20 ms “tDoubleMin” * 20 ms “tDoubleMin” * 20 ms 2 000 ms
double
T “tRepeat” 8 20 ms 160 ms 100 ms 2 000 ms
repeat
T “tStuck”
20 1 s 20 s 5 s 255 s
stuck
a
T is 0 ms if the double press event is disabled and “tDouble” is set to 0.
double
The input device shall expose the following commands to set and observe the timer
multipliers:
• “SET SHORT TIMER (DTR0)”, “QUERY SHORT TIMER”;
• “SET DOUBLE TIMER (DTR0)”, “QUERY DOUBLE TIMER”;
• “SET REPEAT TIMER (DTR0)”, “QUERY REPEAT TIMER”;
• “SET STUCK TIMER (DTR0)”, “QUERY STUCK TIMER”.
If the value set for DTR0 is outside the valid range (see Table 9), the instruction shall be
ignored.
If the double press event is disabled and
• “tDouble” = 0: T shall be 0 ms, which implies the short press event is not delayed on
double
a button release;
• “tDouble” ≥ “tDoubleMin”: the short press event is delayed by T on a button release,
double
calculated according to Table 4.
NOTE This feature is useful if some buttons have the double press event enabled, and others not. This still allows
all buttons to send the short press event at the same time.
– 16 – IEC 62386-301:2017 © IEC 2017
9.5.2 Manual configuration
If IEC 62386-333 is implemented, the instance variables according to Table 5 may be
manually configured. QUERY MANUAL CONFIGURATION CAPABILITY 3xx (see
IEC 62386-333) shall return the byte as defined in Table 5:
Table 5 – “manualCapabilityInstance3xx” values
Bit Description Value
0 Manual configuration of tShort supported 1 = “Yes”
1 Manual configuration of tDouble supported 1 = “Yes”
2 Manual configuration of tRepeat supported 1 = “Yes”
3 Manual configuration of tStuck supported 1 = “Yes”
4 Reserved 0
5 Reserved 0
6 Reserved 0
7 Reserved 0
9.6 Exception handling
9.6.1 Button stuck
If the button stuck event is enabled, the instance shall set “instanceError” to TRUE, from the
moment the button stuck event occurs until the push button has returned to the released
state. Once the button is in the released state the button free event shall be sent depending
on the “eventFilter”.
9.6.2 Manufacturer specific errors
If a manufacturer specific error is detected, the instance shall set “instanceError” to TRUE,
from the moment the error occurs until the error is gone.
9.6.3 Error value
“instanceError” can be observed via “QUERY INSTANCE STATUS”.
While “instanceError” is set, “QUERY INSTANCE ERROR” shall return “instanceErrorByte”
according to Table 6:
Table 6 – “instanceErrorByte” values
Bit Description Value
0 Button stuck? "1" = "Yes"
1 Reserved “0”
2 Reserved “0”
3 Reserved “0”
4 Manufacturer specific error 1? "1" = "Yes"
5 Manufacturer specific error 2? "1" = "Yes"
6 Manufacturer specific error 3? "1" = "Yes"
7 Manufacturer specific error 4? “1” = “Yes”
If used, the meaning of bits [7:4] of “instanceErrorByte” shall be documented in the
manual/documentation. The impact on event generation shall also be documented.
10 Declaration of variables
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, Clause 10
apply, with the following considerations.
Table 7 shows additions to the device variables.
Table 7 – Declaration of device variables
Variable Default value Reset value Power on value Range of Memory
(factory) validity type
“extendedVersionNumber” 2.0 no change no change 00001000b ROM
Table 8 shows restrictions to the instance variables.
Table 8 – Restrictions to instance variables defined in IEC 62386-103:2014 and
IEC 62386-103:2014/AMD1:—
Variable Default value Reset value Power on value Range of Memory
(factory) validity type
“instanceType” 1 no change no change 1 ROM
“resolution”
1 no change no change 1 ROM
a
b
“inputValue” no change no change 0x00, 0xFF RAM
“eventFilter” 1111 0100b 1111 0100b no change [0,255] NVM
“eventPriority”
3 3 no change [2,5] NVM
a
Not applicable.
b
The value should reflect the actual situation as soon as possible.
Table 9 shows additions to the instance variables.
Table 9 – Declaration of instance variables
Variable Default value Reset value Power on Range of Memory
(factory) value validity type
a
b
“instanceErrorByte” no change 0 xxxx 000xb RAM
“tShort” [“tShortMin”,255]
Max(25, Max(25, no change NVM
“tShortMin”) “tShortMin”)
“tShortMin”
factory burn in no change no change [10,255] ROM
c
“tDouble” 0 0 no change 0, [“tDoubleMin”,100] NVM
“tDoubleMin” factory burn in no change no change [10,100] ROM
“tRepeat”
8 8 no change [5,100] NVM
“tStuck” 20 20 no change [5,255] NVM
a
Not applicable.
b
The value should reflect the actual situation as soon as possible.
c
T can be 0 ms if the double press event is disabled, see 9.5.1.
double
– 18 – IEC 62386-301:2017 © IEC 2017
11 Definition of commands
11.1 General
Unused opcodes shall be reserved for future needs.
11.2 Overview sheets
11.2.1 General
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, 11.2 apply, with
the following additions.
11.2.2 Standard commands
Table 10 gives an overview of the additional commands.
Table 10 – Standard commands
Command name Address Instance Opcode See Command
byte byte byte subclause subclause
SET SHORT TIMER (DTR0) Device Instance 0x00 9.5.1 11.8.3
SET DOUBLE TIMER (DTR0) Device Instance 0x01 9.5.1 11.8.4
SET REPEAT TIMER (DTR0)
Device Instance 0x02 9.5.1 11.8.5
SET STUCK TIMER (DTR0) Device Instance 0x03 9.5.1 11.8.6
QUERY SHORT TIMER Device Instance 0x0A 9.5.1 11.9.3
QUERY SHORT TIMER MIN Device Instance 0x0B 9.5.1 11.9.4
QUERY DOUBLE TIMER Device Instance 0x0C 9.5.1 11.9.5
QUERY DOUBLE TIMER MIN Device Instance 0x0D 9.5.1 11.9.6
QUERY REPEAT TIMER Device Instance 0x0E 9.5.1 11.9.7
QUERY STUCK TIMER Device Instance 0x0F 9.5.1 11.9.8
11.3 Event messages
11.3.1 INPUT NOTIFICATION (device/instance, event)
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, 11.3.1 apply.
Refer to 9.4.3 for an overview of “event” values.
11.3.2 POWER NOTIFICATION (device)
The requirements of IEC 62386-103:2014 and IEC 62386-103:2014/AMD1:—, 11.3.2 apply.
11.4 Device control instructions
The requirements
...








Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.
Loading comments...