echonet specificationechonet.jp/wp/wp-content/uploads/pdf/general/... · ii version: 2.11 echonet...

i

Version: 2.11ECHONET CONSORTIUM

ECHONET SPECIFICATION General Contents and Definitions of Terms

© 2000（2002） ECHONET CONSORTIUM ALL RIGHT RESERVED

ECHONET Specification

Version 2.11 - English Version -

ii




Revision record ･ Version 1.0 March 18th 2000 released Open to consortium members July 2000 Open to the public ･ Version 1.01 May 23rd 2001 Open to the public ･ Version 2.00 August 7th 2001 Open to consortium members ･ Version 2.01 December 19th 2001 Open to consortium members ･ Version 2.10 Preview December 28th 2001 Open to consortium members ･ Version 2.10 Draft February 15th 2002 Open to consortium members ･ Version 2.10 March 7th 2002 Open to consortium members ･Version2.11 April 26th 2002 Open to consortium members

Notes: In and after Version 2.00, the power line communication protocol has been compiled as Power Line

Communication A.

The specifications published by the ECHONET Consortium are established without regard to industrialproperty rights (e.g., patent and utility model rights). In no event will the ECHONET Consortium beresponsible for industrial property rights to the contents of its specifications.

The publisher of this specification is not authorized to license and/or exempt any third party fromresponsibility for JAVA, IrDA, Bluetooth or HBS. A party who intends to use JAVA, IrDA, Bluetooth or HBS should take action in being licensed forabove-mentioned specifications.

In no event will the publisher of this specification be liable to you for any damages arising out of use of thisspecification.

iii




General Contents Part I ECHONET Overview

Chapter1 Introduction ...............................................................................................................1-1 1.1 Envisioned Home Network Development.................................................................1-1 1.2 ECHONET Development Objectives........................................................................1-3 1.3 ECHONET Aims.......................................................................................................1-4 1.4 Envisioned Applications ...........................................................................................1-5 1.5 ECHONET Characteristics .......................................................................................1-6

Chapter2 Definition of System Configuration..........................................................................2-1 2.1 ECHONET System Architecture ...................................................................................2-1 2.2 ECHONET Network Configuration ..............................................................................2-3 2.3 ECHONET Component Devices ...................................................................................2-4 2.4 Connections to External Networks and Systems ...........................................................2-5

Chapter3 ECHONET Communication Layer Configuration....................................................3-1 3.1 Overview of ECHONET Communication Layer Configuration ...................................3-1 3.2 Communication Layer Elements....................................................................................3-2

3.2.1 Service Middleware...................................................................................................3-3 3.2.2 ECHONET Communication Processing Block.........................................................3-4 3.2.3 Protocol Difference Absorption Processing Block ...................................................3-4 3.2.4 Device Object............................................................................................................3-4 3.2.5 Transmission Medium and Lower-Layer Communication Software........................3-4 3.2.6 API ............................................................................................................................3-5 3.2.7 Common Lower-Layer Communication Interface....................................................3-6 3.2.8 Individual Lower-Layer Communication Interface ..................................................3-6

Chapter4 Connection of Devices to ECHONET Networks......................................................4-1 4.1 Implementation of ECHONET Standard in Devices .....................................................4-1 4.2 ECHONET Device Types ..............................................................................................4-1 4.3 Adapters for Connection to ECHONET Networks........................................................4-2 4.4 Connection formats ........................................................................................................4-3

Chapter5 Structure of ECHONET Specifications and Intended Readership............................5-1 5.1 Structure of Specifications .............................................................................................5-1 5.2 Intended Readership.......................................................................................................5-2 5.3 Version numbering system.............................................................................................5-3

iv




Part II ECHONET Communication Middleware Specifications

Chapter1 Overview ......................................................................................................................2-2

1.1 Basic Concept ................................................................................................................2-2 1.2 Positioning on Communications Layers ........................................................................2-3

Chapter2 ECHONET Address .....................................................................................................2-1 2.1 Basic Concept ................................................................................................................2-1 2.2 ECHONET Address Structure .......................................................................................2-1 2.3 NetID..............................................................................................................................2-2 2.4 NodeID...........................................................................................................................2-2

Chapter3 ECHONET Objects ......................................................................................................3-1 3.1 Basic Concept ................................................................................................................3-1 3.2 Device Objects ...............................................................................................................3-2 3.3 Profile Objects ...............................................................................................................3-3 3.4 Communication Definition Objects ...............................................................................3-3 3.5 Service Objects ..............................................................................................................3-4 3.6 ECHONET Objects as Viewed from Application Software ..........................................3-4

Chapter4 Message Structure (Frame Format) ..............................................................................4-1 4.1 Basic Concept ................................................................................................................4-1 4.2 Frame Format.................................................................................................................4-1

4.2.1 ECHONET Headers (EHD) ......................................................................................4-6 4.2.2 Source/Destination ECHONET Address (SEA/DEA)..............................................4-8 4.2.3 ECHONET Byte Counter (EBC) ............................................................................4-10 4.2.4 ECHONET Data (EDATA) .....................................................................................4-10 4.2.5 Object Message Header (OHD) ..............................................................................4-10 4.2.6 ECHONET Objects (EOJ) ...................................................................................... 4-11 4.2.7 ECHONET Property (EPC) ....................................................................................4-20 4.2.8 ECHONET Service (ESV) ......................................................................................4-21 4.2.9 ECHONET Property Value Data (EDT) .................................................................4-40 4.2.10 ECHONET Data Counter (EDC) ............................................................................4-40 4.2.11 Compound ECHONET Service (CpESV)...............................................................4-41 4.2.12 Processing Target Property Counter(OPC) .............................................................4-53 4.2.13 Property Data Counter(PDC) ..................................................................................4-53

Chapter5 Basic Sequences ...........................................................................................................5-1 5.1 Basic Concept ................................................................................................................5-1 5.2 Basic Sequences for Object Control ..............................................................................5-2

v




5.2.1 Basic Sequences for Object Control in General........................................................5-2 5.2.2 Basic Sequences for Service Content........................................................................5-5

5.3 Basic Sequence for ECHONET Node Startup...............................................................5-8 5.3.1 Basic Sequence for ECHONET Node Cold Start .....................................................5-9 5.3.2 Basic Sequence for ECHONET Node Warm Start .................................................5-10

5.4 Basic Sequence for ECHONET Router Startup...........................................................5-12 5.4.1 Basic Sequence for Parent Router Cold Start..........................................................5-14 5.4.2 Basic Sequence for Parent Router Warm Start........................................................5-15 5.4.3 Basic Sequence for Normal Router Cold Start........................................................5-18 5.4.4 Basic Sequence for Normal Router Warm Start......................................................5-21

5.5 Basic Sequence for ECHONET Node Normal Operation ...........................................5-24 5.5.1 Basic Sequence for Detecting EA Duplication .......................................................5-24 5.5.2 Basic Sequence for Detecting Nodes with Bad Net IDs .........................................5-25 5.5.3 Basic Sequence for Net ID Write Request Reception.............................................5-26

Chapter6 ECHONET Communications Processing Block Processing Specifications ................6-1 6.1 Basic Concept ................................................................................................................6-1 6.2 Received Message Determination Processing Specifications........................................6-2 6.3 Routing Processing Specifications.................................................................................6-3

6.3.1 Received Message Routing Processing Specifications .............................................6-3 6.3.2 Send Message Routing Processing Specifications ....................................................6-3

6.4 Object Processing Specifications...................................................................................6-5 6.4.1 Object Processing (1) ................................................................................................6-5 6.4.2 Object Processing (2) ................................................................................................6-6 6.4.3 Object Processing (3) ................................................................................................6-6

6.5 Basic API Processing.....................................................................................................6-7 6.6 Send Message Creation/Management Processing .........................................................6-7 6.7 Startup Processing..........................................................................................................6-7

6.7.1 Node Startup Processing ...........................................................................................6-8 6.8 Description of Processing Functions .............................................................................6-9

Chapter7 Protocol Difference Absorption Processing Block Processing Specifications.............7-1 7.1 Basic Concept ................................................................................................................7-1 7.2 Message Receipt/Assembly Processing.........................................................................7-2

7.2.1 Message Receipt/Assembly Processing (1)...............................................................7-2 7.2.2 Message Receipt/Assembly Processing (2)...............................................................7-2

7.3 Message Splitting/Transmission Processing..................................................................7-3 7.3.1 Message Splitting/Transmission Processing (1)........................................................7-3 7.3.2 Message Splitting/Transmission Processing (2)........................................................7-3

vi




7.4 Address Conversion Processing.....................................................................................7-4 7.4.1 Address Conversion Specifications for Power Line Communications Protocol.......7-4 7.4.2 Address Conversion Specifications for Low-power Wireless Protocol....................7-5 7.4.3 Address Conversion Specifications for Extended HBS Protocol..............................7-5 7.4.4 Address Conversion Specifications for IrDA Control Protocol................................7-5 7.4.5 Address Conversion Specifications for LonTalk® Protocol......................................7-5

7.5 Communications Type Conversion Processing..............................................................7-6 7.5.1 Communications Type Conversion Specifications for Power Line Communications

Protocol .....................................................................................................................7-6 7.5.2 Communications Type Conversion Specifications for Low-power Wireless Protocol

...................................................................................................................................7-6 7.5.3 Communications Type Conversion Specifications for Extended HBS Protocol ......7-7 7.5.4 Communications Type Conversion Specifications for IrDA Control Protocol.........7-7 7.5.5 Communications Type Conversion Specifications for LonTalk® Protocol...............7-7

7.6 Common Lower-Layer Communications Interface Processing.....................................7-8 7.7 Description of Processing Functions .............................................................................7-9

Chapter8 ECHONET Communication Middleware State Transitions ........................................8-1 8.1 Basic Concept ................................................................................................................8-1 8.2 State Transitions in ECHONET Communications Processing Block............................8-2

Chapter9 ECHONET Objects: Detailed Specifications...............................................................9-1 9.1 Basic Concept ................................................................................................................9-1 9.2 ECHONET Properties: Basic Specifications .................................................................9-2

9.2.1 ECHONET Property Value Data Types ....................................................................9-2 9.2.2 ECHONET Property Value Range ............................................................................9-2 9.2.3 Required Class Properties .........................................................................................9-3 9.2.4 Array..........................................................................................................................9-3

9.3 Device Object Super Class Specifications .....................................................................9-5 9.3.1 Overview of Device Object Super Class Specifications ...........................................9-5 9.3.2 Operating Status Property .........................................................................................9-7 9.3.3 Installation Location Property...................................................................................9-7 9.3.4 Specification Version Infomation..............................................................................9-9 9.3.5 Fault Status Property .................................................................................................9-9 9.3.6 Fault Content Property ..............................................................................................9-9 9.3.7 Manufacturer Code Property...................................................................................9-10 9.3.8 Place-of-Business Code Property............................................................................9-10 9.3.9 Product Code Property ............................................................................................9-10 9.3.10 Serial Number Property...........................................................................................9-10

vii




9.3.11 Date-of-Manufacture Property ................................................................................9-10 9.3.12 Property Map Property ............................................................................................ 9-11

9.4 Sensor-related Device Class Group Objects: Detailed Specifications.........................9-12 9.5 Air Conditioning-related Device Class Group Objects: Detailed Specifications ........9-12 9.6 Housing/Equipment-related Device Class Group Objects: Detailed Specifications ...9-12 9.7 Cooking/Housework-related Device Class Group Objects: Detailed Specifications ..9-12 9.8 Health-related Device Class Group Objects: Detailed Specifications .........................9-12 9.9 Management/Control-related Device Class Group Objects: Detailed Specifications .9-13

9.9.1 Detailed Specifications for Secure Communication Common Key Setup Node Class.................................................................................................................................9-13

9.10 Profile Object Class Group Specifications ..................................................................9-14 9.10.1 Overview of Profile Object Super Class Specifications..........................................9-14 9.10.2 Property Map...........................................................................................................9-15

9.11 Profile Class Group Detailed Specifications................................................................9-16 9.11.1 Node Profile Class Detailed Specifications ............................................................9-17 9.11.2 Router Profile Class: Detailed Specifications .........................................................9-26 9.11.3 ECHONET Communications Processing Block Profile Class: Detailed Specifications

.................................................................................................................................9-29 9.11.4 Protocol Difference Absorption Processing Block Profile Class: Detailed

Specifications ..........................................................................................................9-31 9.11.5 Lower-layer Communications Software Profile Class: Detailed Specifications ....9-33

9.12 Communications Definition Class Group Specifications ............................................9-36 9.12.1 Overview of Communications Definition Object Super Class Specifications........9-37 9.12.2 Property Map...........................................................................................................9-37

9.13 Specifications for Status Notification Method Stipulation Communications Definition Class Group..................................................................................................................9-38

9.14 Specifications for Set Control Reception Method Stipulation Communications Definition Class Group..................................................................................................................9-41

9.15 Specifications for Linkage (Action) Setting Communications Definition Class Group..... ......................................................................................................................................9-44

9.16 Specifications for Linkage (Trigger) Setting Communications Definition Class Group.... ......................................................................................................................................9-50

9.17 Specifications for Secure Communication Access Property Setup Class Group.........9-55 Chapter10 ECHONET Security Communication Specification ................................................10-1

10.1 ECHONET Security Problems.......................................................................................10-1 10.2 ECHONET Security Policy............................................................................................10-1 10.3 Positioning of ECHONET in Protocol Stack .................................................................10-2

viii




10.4 Configuration of Secure Communication Messages in ECHONET ..............................10-3 10.4.1 ECHONET Secure Message Format........................................................................10-3 10.4.2 ECHONET Header (EHD).......................................................................................10-3 10.4.3 ECHONET byte Counter (EBC)..............................................................................10-3 10.4.4 ECHONET Secure Header (SHD) ...........................................................................10-4 10.4.5 Secure Key Header (SKH) .......................................................................................10-5 10.4.6 Maker Key Index (MKI) ..........................................................................................10-7 10.4.7 Authentication Header (AHD) .................................................................................10-8 10.4.8 Sequence Number Field (SNF) ................................................................................10-8 10.4.9 Message Authentication Signature (MAS) ..............................................................10-9 10.4.10 Plain Text ECHONET Data Part Byte Counter (PBC) ........................................ 10-11 10.4.11 Plain Text ECHONET Data (PEDATA)............................................................... 10-11 10.4.12 Block Check Code (BCC).................................................................................... 10-11 10.4.13 Padding (PDG) ..................................................................................................... 10-11

10.5 Enciphering ..................................................................................................................10-12 10.5.1 Common Key Block Enciphering ..........................................................................10-12

10.6 Authentication Sequence..............................................................................................10-13 10.6.1 Authentication Sequence...........................................................................................10-13 10.7 Management of Shared Keys for Secure Communication...........................................10-18

10.7.1 Detailed Specifications of Common Key Setting Class for Secure Communication...............................................................................................................................10-18

10.7.2 Methods to Establish Shared Keys for Secure Communication ............................10-18 10.7.3 Common Key (User Key) Setting Sequence for Secure Communication .............10-19 10.7.4 Common Key (Service Provider Key) Setting Sequence for Secure Communication

...............................................................................................................................10-22 10.7.5 Setting of Common Key (Maker Key) for Secure Communication ......................10-25 10.7.6 Common Key Distribution System ........................................................................10-26 10.7.7 Synchronous Updating System for Common Key .................................................10-29 10.7.8 Avoiding Omission of Devices Without Power When Updating Common Key ...10-30

10.8 Node Profile Property Stipulation for ECHONET Secure Communication................10-32 10.9 Access Limitation.........................................................................................................10-32 10.10 Security Communication Access Property Setting Class Group ...............................10-37 Supplement 1 References.......................................................................................................... i Supplement 2 Property Map Description Format .................................................................... ii Supplement 3 All Router Data Description Format ................................................................ iii Supplement 4 Instance List Description Format ..................................................................... iv Supplement 5 Class List Description Format........................................................................... v

ix




Part III Transmission Media And Lower-Layer Communication

Software Specification

Chapter 1 Overview of Lower-layer Communication Software and Transmission Media Communication Protocol Specification ....................................................................1-1

1.1 Positioning on Communication Layers..........................................................................1-1 1.2 Overview of Lower-layer Communication Software.....................................................1-2 1.3 Overview of New Transmission Media .........................................................................1-4 1.4 Relations to Other Standards .........................................................................................1-5

Chapter 2 Power Line Communication Protocol Specification ...................................................2-1 2.1 System Overview ...........................................................................................................2-1

2.1.1 Scope of the Standard................................................................................................2-1 2.2 Mechanical/Physical Specifications...............................................................................2-2

2.2.1 Connector shape ........................................................................................................2-2 2.2.2 Intended power line...................................................................................................2-2 2.2.3 Medium Specifications..............................................................................................2-2 2.2.4 Topology....................................................................................................................2-3

2.3 Electrical Specifications.................................................................................................2-4 2.3.1 System Specifications ...............................................................................................2-4

2.4 Logical Specifications..................................................................................................2-10 2.4.1 Layer 1.....................................................................................................................2-10 2.4.2 Layer 2.....................................................................................................................2-12 2.4.3 Layer 3.....................................................................................................................2-23

2.5 Basic Sequence ............................................................................................................2-27 2.5.1 Basic concept ..........................................................................................................2-27 2.5.2 Stop status ...............................................................................................................2-28 2.5.3 Initialize processing status ......................................................................................2-28 2.5.4 Communication stop status .....................................................................................2-31 2.5.5 Normal operation status ..........................................................................................2-31 2.5.6 Error stop status.......................................................................................................2-32

2.6 P&P Setup of House Code and MAC Address............................................................2-33 Chapter 3 Low-Power Radio Communications Protocol Specification.......................................3-1

3.1 System Overview ...........................................................................................................3-1 3.1.1 Communication Model..............................................................................................3-1 3.1.2 ARIB Standard ..........................................................................................................3-2

3.2 Mechanical/Physical Characteristics .............................................................................3-3 3.3 Electrical Characteristics ...............................................................................................3-3

x




3.3.1 Transmission system and transmitting signal............................................................3-3 3.3.2 Frequency..................................................................................................................3-3

3.4 Logical Specifications....................................................................................................3-9 3.4.1 Data structure ..........................................................................................................3-10 3.4.2 Layer 1..................................................................................................................... 3-11 3.4.3 Layer 2.....................................................................................................................3-19 3.4.4 Layer 3.....................................................................................................................3-38

3.5 Basic Sequence ............................................................................................................3-44 3.5.1 Basic concept ..........................................................................................................3-44 3.5.2 Stop Status...............................................................................................................3-45 3.5.3 Initialize processing status ......................................................................................3-45 3.5.4 Initialization completion stop status........................................................................3-46 3.5.5 Normal operation status ..........................................................................................3-47 3.5.6 Error stop status.......................................................................................................3-48 3.5.7 Suspension status ....................................................................................................3-48

Chapter 4 Extended HBS Communication Protocol Specification..............................................4-1 4.1 System Overview ...........................................................................................................4-1 4.2 Mechanical and Physical Characteristics.......................................................................4-2

4.2.1 Transmission media and number of transmission pairs ............................................4-3 4.2.2 Cable length...............................................................................................................4-3 4.2.3 Topology....................................................................................................................4-3 4.2.4 Number of terminals to be connected .......................................................................4-3 4.2.5 Information socket shape (including compatibility with signals) .............................4-3 4.2.6 Compatibility between information sockets and signals...........................................4-3

4.3 Electrical Characteristics ...............................................................................................4-4 4.3.1 Characteristic impedance of cable.............................................................................4-4 4.3.2 Load resistance of control channel cable ..................................................................4-4 4.3.3 Transmission rate of control signal ...........................................................................4-4 4.3.4 Transmission system and transmission waveform of control signal.........................4-5 4.3.5 Transmitting/receiving level of control signal ..........................................................4-5 4.3.6 Impedance and power feed voltage of terminals to be connected.............................4-6 4.3.7 Power feed voltage of control channel......................................................................4-6

4.4 Logical Layers (Layer 1 Specifications)........................................................................4-7 4.4.1 Control System..........................................................................................................4-7 4.4.2 Synchronization system ............................................................................................4-7 4.4.3 Basic format of control signal ...................................................................................4-8 4.4.4 Pause time and pause period .....................................................................................4-8

xi




4.4.5 Packet priority ...........................................................................................................4-9 4.4.6 Collision detection procedure....................................................................................4-9 4.4.7 Synchronization recovery procedure.......................................................................4-10 4.4.8 Short-data interruption procedure ...........................................................................4-10

4.5 Logical Specifications (Layer 2 Specifications) .......................................................... 4-11 4.5.1 Address.................................................................................................................... 4-11 4.5.2 Broadcast, simultaneous broadcast, and group broadcast .......................................4-12 4.5.3 Control code ............................................................................................................4-12 4.5.4 Data length code......................................................................................................4-13 4.5.5 Data area..................................................................................................................4-13 4.5.6 Check code ..............................................................................................................4-14 4.5.7 Dummy code ...........................................................................................................4-14 4.5.8 Error detection and error control (ACK/NAK response) ........................................4-14

4.6 Logical Specifications (Layer 7 Specifications) ..........................................................4-16 4.6.1 Header code (HD) ...................................................................................................4-16 4.6.2 System common commands....................................................................................4-17 4.6.3 Communication sequence .......................................................................................4-18

4.7 Basic Sequence (Software Internal State Transition Specification) ............................4-22 4.7.1 Basic concept ..........................................................................................................4-22 4.7.2 Stop Status...............................................................................................................4-24 4.7.3 Initialize processing status ......................................................................................4-24 4.7.4 Normal operation status ..........................................................................................4-25 4.7.5 Error stop status.......................................................................................................4-26 4.7.6 Suspension status ....................................................................................................4-27

Appendix 4.1 Documents Cited .................................................................................................4-28 Appendix 4.2 Details of Command Specifications ....................................................................4-29 Chapter 5 IrDA Control Communications Protocol Specification ..............................................5-1

5.1 System Overview ...........................................................................................................5-1 5.1.1 Overview ...................................................................................................................5-1 5.1.2 Scope of the specification .........................................................................................5-2

5.2 Mechanical/Physical Specifications...............................................................................5-3 5.2.1 Characteristics ...........................................................................................................5-3 5.2.2 Topology....................................................................................................................5-3

5.3 Electrical Specifications.................................................................................................5-4 5.3.1 Coding system...........................................................................................................5-4

5.4 Logical Specifications....................................................................................................5-6 5.4.1 Overall Data Structure Image....................................................................................5-6 5.4.2 Layer 1 (PHY layer)..................................................................................................5-7

xii




5.4.3 Layer 2 (MAC layer).................................................................................................5-8 5.4.4 Layer 2 (LLC layer) ..................................................................................................5-9 5.4.5 Packet accommodation............................................................................................ 5-11

5.5 Basic Sequence ............................................................................................................5-12 5.5.1 Basic concept ..........................................................................................................5-12 5.5.2 Stop Status...............................................................................................................5-13 5.5.3 Cold start .................................................................................................................5-14 5.5.4 Warm start ...............................................................................................................5-17 5.5.5 Communication stop status .....................................................................................5-18 5.5.6 Operation status.......................................................................................................5-21 5.5.7 Error stop status.......................................................................................................5-22 5.5.8 Suspension status ....................................................................................................5-23

5.6 Accommodation Specification.....................................................................................5-24 5.6.1 Relationship between host and peripherals .............................................................5-24 5.6.2 Handling of individually specified messages within a subnet ................................5-24 5.6.3 Recommended conditions for host and peripherals ................................................5-24 5.6.4 Mandatory conditions for host and peripherals.......................................................5-24

Chapter 6 LonTalk® Communication Protocol Specification ......................................................6-1 6.1 System Overview ...........................................................................................................6-1

6.1.1 Organization of Chapter 6 .........................................................................................6-2 6.2 Mechanical/Physical Specifications...............................................................................6-3 6.3 Electrical Characteristics ...............................................................................................6-3 6.4 Logical Specifications....................................................................................................6-3

6.4.1 Layer 1.......................................................................................................................6-4 6.4.2 Layer 2.......................................................................................................................6-4 6.4.3 Layer 3.......................................................................................................................6-6

6.5 Basic Sequence ..............................................................................................................6-7 6.5.1 Basic concept ............................................................................................................6-7 6.5.2 Stop Status.................................................................................................................6-9 6.5.3 Initialize processing status ........................................................................................6-9 6.5.4 Initialization completion stop status........................................................................6-10 6.5.5 Normal operation status .......................................................................................... 6-11 6.5.6 Error stop status.......................................................................................................6-13 6.5.7 Suspension status ....................................................................................................6-14 6.5.8 (Neuron® Chip)Node-ID setting sequence..............................................................6-15

6.6 RCR STD-16 Transceiver Specifications ....................................................................6-16 6.6.1 System Overview ....................................................................................................6-16

xiii




6.6.2 Mechanical/physical specifications.........................................................................6-18 6.6.3 Electrical characteristics..........................................................................................6-18 6.6.4 Logical specifications (layer 1) ...............................................................................6-19 6.6.5 Transceiver operation sequence ..............................................................................6-21 6.6.6 Automatic channel switching system......................................................................6-22 6.6.7 Group ID registration ..............................................................................................6-23 6.6.8 (Neuron® Chip) Node-ID setting ............................................................................6-24 6.6.9 Transmission system ...............................................................................................6-25 6.6.10 Reception system ....................................................................................................6-26

Appendix Documents Cited ............................................................................................................. i Part IV ECHONET Basic API Specification

Chapter1 Overview ...................................................................................................................1-1 1.1 Basic Concept ................................................................................................................1-1 1.2 Positioning on Communication Layer ...........................................................................1-2

Chapter2 ECHONET Basic API Function Specification..........................................................2-1 2.1 List of ECHONET Basic API Functions .......................................................................2-1 2.2 ECHONET Basic API Function Specification ..............................................................2-4

Chapter3 Level 1 ECHONET Basic API Specification............................................................3-1 3.1 List of Level 1 ECHONET Basic APIs .........................................................................3-1 3.2 Level 1 ECHONET Basic API Detailed Specification..................................................3-3

Chapter4 Level 2 ECHONET Basic API Specification (For C Language) ..............................4-1 4.1 Constant Specifications..................................................................................................4-2 4.2 List of Low-level Basic API Functions .........................................................................4-7 4.3 Low-level Basic API Function Detailed Specification..................................................4-9

4.3.1 MidOpenSession .....................................................................................................4-10 4.3.2 MidCloseSession..................................................................................................... 4-11 4.3.3 MidSetEA................................................................................................................4-12 4.3.4 MidGetEA ...............................................................................................................4-13 4.3.5 MidGetNodeID .......................................................................................................4-14 4.3.6 MidSetControlVal ...................................................................................................4-15 4.3.7 MidGetControlVal...................................................................................................4-16 4.3.8 MidSetSendEpc, MidExtSetSendEpc .....................................................................4-17 4.3.9 MidSetEpc, MidExtSetEpc .....................................................................................4-20 4.3.10 MidGetReceiveEpc,MidExtGetReceiveEpc ..........................................................4-22 4.3.11 MidGetEpc ..............................................................................................................4-24

xiv




4.3.12 MidSetSendCheckEpc,MidExtSetSendCheckEpc...................................................4-25 4.3.13 MidSetSendEpcM, MidExtSetSendEpcM ..............................................................4-27 4.3.14 MidSetEpcM, MidExtSetEpcM ..............................................................................4-30 4.3.15 MidGetReceiveEpcM..............................................................................................4-32 4.3.16 MidGetFpcM...........................................................................................................4-34 4.3.17 MidSetSendCheckEpcM, MidExtSetSendCheckEpcM..........................................4-35 4.3.18 MidGetReceiveCheckEpc, MidExtGetReceiveCheckEpc......................................4-37 4.3.19 MidGetEpcSize .......................................................................................................4-39 4.3.20 MidGetEpcAttrib.....................................................................................................4-40 4.3.21 MidGetEpcMember.................................................................................................4-42 4.3.22 MidCreateNode .......................................................................................................4-43 4.3.23 MidCreateObj..........................................................................................................4-44 4.3.24 MidCreateEpc, MidCreateExtEpc...........................................................................4-45 4.3.25 MidCreateEpcM, MidCreateExtEpcM....................................................................4-47 4.3.26 MidAddEpcMember ...............................................................................................4-49 4.3.27 MidAddEpcMemberS .............................................................................................4-50 4.3.28 MidDeleteNode .......................................................................................................4-51 4.3.29 MidDeleteObj..........................................................................................................4-52 4.3.30 MidDeleteEpc..........................................................................................................4-53 4.3.31 MidDeleteEpcM......................................................................................................4-54 4.3.32 MidGetState ............................................................................................................4-55 4.3.33 MidSetRecvTargetList.............................................................................................4-56 4.3.34 MidAddRecvTargetList...........................................................................................4-57 4.3.35 MidDeleteRecvTargetList .......................................................................................4-58 4.3.36 MidGetRecvTargetList............................................................................................4-59 4.3.37 MidStart...................................................................................................................4-60 4.3.38 MidReset .................................................................................................................4-61 4.3.39 Midlnit.....................................................................................................................4-62 4.3.40 MidlnitAll................................................................................................................4-63 4.3.41 MidRequestRun.......................................................................................................4-64 4.3.42 MidSuspend.............................................................................................................4-65 4.3.43 MidWakeUp ............................................................................................................4-66 4.3.44 MidSetSendMulti, MidExtSetSendMulti ................................................................4-67 4.3.45 MidGetReceiveEpcMulti ........................................................................................4-70 4.3.46 MidSetSecureContVal .............................................................................................4-72 4.3.47 MidStop.................................................................................................................4-73 4.3.48 MidHalt .................................................................................................................4-74

xv




Chapter5 Level 2 ECHONET Basic API Specification (For JavaTM Language).................5-1 5.1 Basic Concept ................................................................................................................5-1 5.2 API Configuration..........................................................................................................5-3

5.2.1 API classes ................................................................................................................5-3 5.2.2 Relationships between classes...................................................................................5-3 5.2.3 EN_Object class ........................................................................................................5-4 5.2.4 EN_Node class ..........................................................................................................5-6 5.2.5 EN_Property class .....................................................................................................5-6 5.2.6 EN_Packet class ........................................................................................................5-7 5.2.7 EN_Exception exception class ..................................................................................5-7 5.2.8 EN_EventListener interface ......................................................................................5-7 5.2.9 EN_Const interface ...................................................................................................5-7 5.2.10 EN_SecureOpt class..................................................................................................5-7 5.2.11 EN_CpException exception class .............................................................................5-7

5.3 Detailed API Specifications ...........................................................................................5-8 5.3.1 EN_Object class ........................................................................................................5-9 5.3.2 EN_Node class ........................................................................................................5-62 5.3.3 EN_Property class ...................................................................................................5-76 5.3.4 EN_Packet class ......................................................................................................5-81 5.3.5 EN_Exception exception class ................................................................................5-82 5.3.6 EN_EvenListener interface .....................................................................................5-83 5.3.7 EN_Const interface .................................................................................................5-85 5.3.8 EN_SecureOpt class................................................................................................5-90 5.3.9 EN_CpException exception class ...........................................................................5-91

Part V ECHONET Common Lower-layer Communication Interface

Specification

Chapter 1 Overview .....................................................................................................................1-1

1.1 Basic Concept................................................................................................................1-1 1.2 Positioning on Communication Layers.........................................................................1-2

Chapter 2 ECHONET Common Lower-layer Communication Interface Function Specification2-1 2.1 List of ECHONET Common Lower-layer Communication Interface Functions .........2-1 2.2 ECHONET Common Lower-Layer Communication Interface Function Detailed

Specification..................................................................................................................2-2 Chapter 3 Level 1 ECHONET Common Lower-layer Communication Interface Specification.3-1

xvi




3.1 List of Level 1 ECHONET Common Lower-Layer Communication Interface Services...................................................................................................................................3-1

3.2 Level 1 ECHONET Common Lower-layer Communication Interface Detailed Specification..................................................................................................................3-3

Chapter 4 Level 2 ECHONET Common Lower-layer Communication Interface Specification.4-1 4.1 List of Level 2 ECHONET Common Lower-Layer Communication Interface Functions

for C Language..............................................................................................................4-2 4.2 C Language-oriented Level 2 ECHONET Common Lower-layer Communication

Interface Detailed Specification ................................................................................4-4 4.2.1 ClcGetDevID.............................................................................................................4-5 4.2.2 Clclnit ........................................................................................................................4-6 4.2.3 ClcRequestRun..........................................................................................................4-7 4.2.4 ClcSetTrouble............................................................................................................4-8 4.2.5 ClcStart......................................................................................................................4-9 4.2.6 ClcSuspend..............................................................................................................4-10 4.2.7 ClcWakeUp ............................................................................................................. 4-11 4.2.8 ClcGetProData ........................................................................................................4-12 4.2.9 ClcGetStatus............................................................................................................4-13 4.2.10 ClcInitAll...............................................................................................................4-14 4.2.11 ClcStop ..................................................................................................................4-15 4.2.12 ClcHalt ..................................................................................................................4-16 4.2.13 ClcLowInit ............................................................................................................4-17 4.2.14 ClcLowRequestRun ..............................................................................................4-19 4.2.15 ClcLowStart ..........................................................................................................4-20 4.2.16 ClcLowSuspend ....................................................................................................4-21 4.2.17 ClcLowWakeUp....................................................................................................4-22 4.2.18 ClcGetLowProData ...............................................................................................4-23 4.2.19 ClcGetLowStatus ..................................................................................................4-25 4.2.20 ClcSendData..........................................................................................................4-27 4.2.21 ClcGetSendResult .................................................................................................4-29 4.2.22 ClcSendCancel ......................................................................................................4-30 4.2.23 ClcReceiveData.....................................................................................................4-31 4.2.24 ClcGetNodeID.......................................................................................................4-32 4.2.25 ClcSetNodeID .......................................................................................................4-33 4.2.26 ClcLowInitAll .......................................................................................................4-34 4.2.27 ClcLowStop...........................................................................................................4-36 4.2.28 ClcLowHalt ...........................................................................................................4-37

xvii




Part VI ECHONET Discrete Lower-layer Communication Interface

Specification

Chapter 1 Overview ...................................................................................................................1-1

1.1 Basic Concept...................................................................................................................1-1 1.2 Positioning on Communication Layers.........................................................................1-2

Chapter 2 ECHONET Discrete Lower-layer Communication Interface Function Specification...................................................................................................................................2-1

2.1 List of ECHONET Discrete Lower-layer Communication Interface Functions...........2-1 2.2 ECHONET Discrete Lower-layer Communication Interface Detailed Specification ..2-2

Chapter 3 Level 1 ECHONET Discrete Lower-layer Communication Interface Specification 3-1 3.1 List of Level 1 ECHONET Discrete Lower-Layer Communication Interface Services3-1 3.2 Detailed Specifications for Level 1 ECHONET Discrete Lower-Layer Communication

Interface Services ..........................................................................................................3-3 Chapter 4 Level 2 ECHONET Discrete Lower-layer Communication Interface Specification 4-1

4.1 List of Level 2 ECHONET Discrete Lower-layer Communication Interfaces.............4-2 4.2 Level 2 ECHONET Discrete Lower-layer Communication Interface Detail Specification

...................................................................................................................................4-4 4.2.1 LowGetDevID...........................................................................................................4-5 4.2.2 LowInit ......................................................................................................................4-6 4.2.3 LowRequestRun........................................................................................................4-8 4.2.4 LowSetTrouble..........................................................................................................4-9 4.2.5 LowStart ..................................................................................................................4-10 4.2.6 LowSuspend............................................................................................................ 4-11 4.2.7 LowWakeup ............................................................................................................4-12 4.2.8 LowGetProData.......................................................................................................4-13 4.2.9 LowGetStatus ..........................................................................................................4-15 4.2.10 LowSendData........................................................................................................4-17 4.2.11 LowGetSendResult................................................................................................4-19 4.2.12 LowSendCancel ....................................................................................................4-20 4.2.13 LowReceiveData ...................................................................................................4-21 4.2.14 LowGetAddress.....................................................................................................4-22 4.2.15 LowSetAddress .....................................................................................................4-23 4.2.16 LowReqToMac......................................................................................................4-24

xviii




4.2.17 LowReqToID.........................................................................................................4-25 4.2.18 LowReqBcastID....................................................................................................4-26 4.2.19 LowInitAll.............................................................................................................4-28 4.2.20 LowStop ................................................................................................................4-30 4.2.21 LowHalt.................................................................................................................4-31

4.3 Initial Setting Information Specification .....................................................................4-32 4.3.1 Initialization parameter specifications for power line lower-layer communication

software ...................................................................................................................4-33 4.3.2 Initialization parameter specifications for specific low-power radio lower-layer

communication software .........................................................................................4-33 4.3.3 Initialization parameter specifications for extended HBS lower-layer communication

software ...................................................................................................................4-33 4.3.4 Initialization parameter specifications for IrDA-dependent lower-layer

communication software .........................................................................................4-33 4.3.5 Initialization parameter specifications for LonTalk®-dependent lower-layer

communication software .........................................................................................4-34

Part VII ECHONET Communications Equipment Specification

Chapter 1 Overview of ECHONET Communications Equipment Specification ......................1-1 1.1 Basic Concept ................................................................................................................1-1 1.2 Communications Equipment Specification Overview of ECHONET Node .................1-1 1.3 Communications Equipment Specification Overview of ECHONET Device Adapter.1-1 1.4 Communications Equipment Specification Overview of ECHONET Gateway............1-2 1.5 Communications Equipment Specification Overview of ECHONET Router ...............1-2

Chapter 2 ECHONET Nodes .....................................................................................................2-1 2.1 Basic Concept ................................................................................................................2-1 2.2 Function Definition........................................................................................................2-1 2.3 Mechanical and Physical Characteristics.......................................................................2-2

2.3.1 Shape .........................................................................................................................2-2 2.3.2 Display block.............................................................................................................2-3

2.4 NetID Server Function...................................................................................................2-3 2.5 ECHONET Nodes and subnets ......................................................................................2-3 2.6 ECHONET Nodes and Domains ...................................................................................2-4 2.7 Limitation on Number of Connections ..........................................................................2-4

Chapter 3 ECHONET Device Adapter ......................................................................................3-1

xix




3.1 Basic Concept................................................................................................................3-1 3.2 Function Definition........................................................................................................3-3 3.3 Mechanical and Physical Characteristics ......................................................................3-5

3.3.1 Shape .........................................................................................................................3-5 3.3.2 Display block.............................................................................................................3-5

3.4 Electrical Characteristics ...............................................................................................3-6 3.5 Logical Conditions.........................................................................................................3-6 3.6 Adapter Communication Software ................................................................................3-6

3.6.1 Overview of Adapter Communication Software.......................................................3-6 3.6.2 Adapter Communication Interface ............................................................................3-8 3.6.3 Mechanical and physical characteristics of adapter communication interface .........3-8 3.6.4 Electrical characteristics of Adapter Communication Interface .............................3-12 3.6.5 Logical conditions of Adapter Communication Interface.......................................3-16 3.6.6 Adapter communication interface circuit (reference circuit) ..................................3-25 3.6.7 Adapter Communication Software Protocol ...........................................................3-28 3.6.8 Adapter Communication Interface Services ...........................................................3-33 3.6.9 Protocol translate processing...................................................................................3-55 3.6.10 Operation sequence .................................................................................................3-57 3.6.11 Optional service handling........................................................................................3-58 3.6.12 Optional data handling ............................................................................................3-58 3.6.13 Inhibition of simultaneous service issue .................................................................3-59 3.6.14 Service start/end conditions ....................................................................................3-60 3.6.15 Timeout ...................................................................................................................3-61

Chapter 4 ECHONET Gateway.................................................................................................4-1 4.1 Basic Concept ................................................................................................................4-1

Chapter 5 ECHONET Router ....................................................................................................5-1 5.1 Basic Concept ................................................................................................................5-1 5.2 Function Definition........................................................................................................5-1

5.2.1 Mechanical and physical characteristics ...................................................................5-1 5.2.2 Electrical characteristics............................................................................................5-2 5.2.3 Logical specification .................................................................................................5-2

Chapter 6 IrDA Control Router .................................................................................................6-1 6.1 Basic Concept ................................................................................................................6-1 6.2 Communications between Peripherals ...........................................................................6-2 6.3 Rules of Broadcast-specified Data Communication ......................................................6-4

6.3.1 Overview ...................................................................................................................6-4 6.3.2 When receiving broadcast-specified data from outside IrDA subnet .......................6-4 6.3.3 When receiving broadcast-specified data from inside IrDA subnet .........................6-6

xx




6.4 Communication to a Peripheral in the Unbind Status....................................................6-8 6.4.1 Basic Concept............................................................................................................6-8 6.4.2 Sequence....................................................................................................................6-8

Appendix 1 Reference Document ..................................................................................................... i Part VIII ECHONET Service Middleware Specification

Chapter 1 Overview ...................................................................................................................1-1 1.1 BASIC CONCEPT.........................................................................................................1-1 1.2 POSITIONING ON COMMUNICATION LAYERS....................................................1-2 1.3 ECHONET SERVICE MIDDLEWARE AND SERVICE OBJECT DEFINING

METHOD ......................................................................................................................1-3 1.4 SERVICE API................................................................................................................1-4

Chapter 2 ECHONET Basic Service Middleware .....................................................................2-1 2.1 SYSTEM MODEL.........................................................................................................2-1 2.2 DEFINITION OF BASIC SERVICE MIDDLEWARE FUNCTIONS .........................2-1 2.3 DEFINITION OF BASIC SERVICE OBJECT.............................................................2-5

2.3.1 Linked action service object......................................................................................2-5 2.4 API OF BASIC SERVICE MIDDLEWARE.................................................................2-7

2.4.1 API of linked action service middleware ..................................................................2-7 Chapter 3 Housing-dedicated EMS Service Middleware (Sample Proposal) ........................3-1

3.1 SYSTEM MODEL.........................................................................................................3-1 3.2 HOUSING-DEDICATED EMS FUNCTIONS .............................................................3-3

3.2.1 Housing-dedicated feedback-type peak cut EMS .....................................................3-3 3.2.2 Housing-dedicated feed forward type peak-cut EMS ...............................................3-5 3.2.3 Housing-dedicated hybrid type peak-cut EMS .........................................................3-7

3.3 HOUSING-DEDICATED EMS SERVICE MIDDLEWARE FUNCTIONS................3-9 3.3.1 Basic concept ............................................................................................................3-9 3.3.2 Detailed functions of housing-dedicated EMS service middleware .......................3-10

3.4 HOUSING-DEDICATED EMS SERVICE OBJECT.................................................. 3-11 3.4.1 Basic concept .......................................................................................................... 3-11 3.4.2 Detailed definitions of housing-dedicated EMS service classes............................. 3-11

3.5 HOUSING-DEDICATED EMS SERVICE API..........................................................3-12 3.5.1 Basic concept ..........................................................................................................3-12 3.5.2 List of function items ..............................................................................................3-12

Chapter 4 Small Building/Store-dedicated EMS Service Middleware (Sample Proposal) .......4-1 4.1 SYSTEM MODEL.........................................................................................................4-1

xxi




4.2 SMALL BUILDING/STORE-DEDICATED EMS FUNCTIONS................................4-2 4.3 SMALL BUILDING/STORE-DEDICATED EMS SERVICE OBJECT......................4-4

4.3.1 Small building/store-dedicated EMS service class ...................................................4-4 4.3.2 Details of small building/store-dedicated service classes .........................................4-5

4.4 SEQUENCE...................................................................................................................4-9 4.5 SMALL BUILDING/STORE-DEDICATED EMS SERVICE API ............................4-10

4.5.1 Basic concept ...................................................................4-10 4.5.2 List of function items ...................................................................4-10

Part IX ECHONET Gateway Specifications

Chapter 1 Overview ...................................................................................................................1-1 1.1 Basic Concept ................................................................................................................1-1 1.2 Concept of ECHONET Connections with External Systems ........................................1-1 1.3 Concept of Function Definitions as Service Middleware ..............................................1-1 1.4 ECHONET Gateway Types ...........................................................................................1-2 1.5 Software Configuration..................................................................................................1-4

Chapter 2 Functions of Gateway Basic Block ...........................................................................2-1 Chapter 3 Functions of Gateway Discrete Block.......................................................................3-1 Chapter 4 Functions of Gateway Basic Block ...........................................................................4-1

4.1 Access Control Function................................................................................................4-2 4.2 Direct Access Function ..................................................................................................4-3 4.3 Asynchronous Access Function.....................................................................................4-3 4.4 Message Filtering Function............................................................................................4-4 4.5 ECHONET Device Status Monitoring Function ...........................................................4-5 4.6 ECHONET Device Connection Status Change Notice Function ..................................4-6

Chapter 5 Functions of Gateway Discrete Block.......................................................................5-1 Chapter 6 Definition of Gateway Basic Block Object...............................................................6-1

6.1 Class Number.................................................................................................................6-1 6.2 Object Service ................................................................................................................6-1 6.3 Object Property ..............................................................................................................6-1 6.4 State Transition ..............................................................................................................6-7 6.5 Operations ......................................................................................................................6-8

Chapter 7 Gateway Basic Block APIs .......................................................................................7-1 7.1 Function Overview.........................................................................................................7-1 7.2 Level 1 ...........................................................................................................................7-3 7.3 Level 2 ......................................................................................................................... 7-11

xxii




Part X Echonet System Design Guidelines

Chapter 1 Overview ...................................................................................................................1-1 1.1 Basic Concept ................................................................................................................1-1

Chapter 2 Network Configuration .............................................................................................2-1 2.1 Network Configuration Requirements ...........................................................................2-1

Chapter 3 Distributed Management System ..............................................................................3-1 3.1 Overview........................................................................................................................3-1 3.2 Design Guidelines..........................................................................................................3-2 3.3 System Design ...............................................................................................................3-3

3.3.1 System Architecture ..................................................................................................3-3 3.3.2 System Situation-based design..................................................................................3-4

3.4 Approach to System Entry, Quittance, Registration, and Deletion................................3-6 3.5 Methods Of Confirming ECHONET Node Existence...................................................3-7 3.6 System Configuration Data............................................................................................3-8 3.7 System Startup ...............................................................................................................3-9

3.7.1 Definition Of system startup situation ......................................................................3-9 3.7.2 System Startup Processing ........................................................................................3-9 3.7.3 ECHONET Instance Management ..........................................................................3-10

3.8 Normal System Operation............................................................................................ 3-11 3.8.1 Definition of Normal System Operation Situation.................................................. 3-11 3.8.2 Processing During Normal System Operation ........................................................ 3-11

3.9 System Errors...............................................................................................................3-12 3.9.1 Definition of System Error Situation ......................................................................3-12 3.9.2 System Error Processing