Zigbee联盟发布的Zigbee Cluster Library规范

需积分: 10 51 浏览量更新于2024-07-14 收藏 11.17MB PDF 举报

"07-5123-08 Zigbee Cluster Library (1).pdf" Zigbee Cluster Library，简称ZCL，是Zigbee联盟发布的一份规范文档，主要针对Zigbee应用中的簇库进行详细定义。该文档旨在为Zigbee开发者提供一个标准化的框架，用于构建和实现Zigbee网络中的设备应用层功能。 Zigbee是一种基于IEEE 802.15.4标准的低功耗、短距离无线通信技术，主要用于物联网（IoT）设备之间的通信。ZCL是Zigbee应用层的重要组成部分，它定义了设备如何在Zigbee网络中执行特定任务，如控制、监测和数据交换。ZCL包含了一系列预定义的簇（Cluster），这些簇代表了特定的功能或服务，比如照明控制、温度传感器或者能源管理等。文档07-5123 Revision 8于2019年12月发布，由Zigbee联盟赞助并由其董事会批准。文档的关键词包括Zigbee、Application、Cluster、Library、ZCL、Dotdot、Dictionary和DataModel，这表明ZCL不仅关注簇的实现，还涉及应用层的数据模型和字典，以及Dotdot，这是Zigbee Alliance的跨平台语义层，确保不同设备间的互操作性。 Zigbee Cluster Library规范详细描述了每个簇的结构、命令、属性和事件，为开发人员提供了清晰的指导，帮助他们创建符合Zigbee标准的产品。例如，开发者可以利用ZCL来定义设备的角色，如端点（Endpoint）和簇配置，以便设备能够正确地与其他Zigbee设备交互。文档中还包含版权和使用披露信息，规定只有Zigbee联盟的成员才能复制此文档供自身或联盟其他成员使用，并且明确禁止未经许可的商业或营利性复制。 Zigbee Cluster Library是Zigbee网络应用开发的核心参考资料，它定义了一套标准化的接口和通信协议，使得开发人员能够构建可靠、互操作的Zigbee设备，推动智能家居、工业自动化、智能建筑等多个领域的IoT解决方案的发展。

Zigbee Cluster Library Specification

Zigbee Document – 075123

11.4.7 ECDSA Signing Certificate Sub-element ................................................................... 11-13

480

11.4.8 Image Integrity Code Sub-element ............................................................................. 11-13

481

11.4.9 ECDSA Signature Sub-element (Crypto Suite 2) ....................................................... 11-14

482

11.4.10 ECDSA Signing Certificate Sub-element (Crypto Suite 2) ........................................ 11-14

483

11.5 OTA File Naming .................................................................................................................... 11-14

484

11.6 Signatures ................................................................................................................................ 11-15

485

11.7 ECDSA Signature Calculation ................................................................................................ 11-15

486

11.7.1 ECDSA Signature Verification ................................................................................... 11-16

487

11.7.2 Image Integrity Code .................................................................................................. 11-17

488

11.8 Discovery of the Upgrade Server ............................................................................................ 11-18

489

11.8.1 Server and Client ......................................................................................................... 11-18

490

11.8.2 Sleepy Devices ............................................................................................................ 11-19

491

11.9 Dependencies ........................................................................................................................... 11-19

492

11.10 OTA Cluster Attributes ...................................................................................................... 11-19

493

11.10.1 UpgradeServerID Attribute ......................................................................................... 11-20

494

11.10.2 FileOffset Attribute ..................................................................................................... 11-20

495

11.10.3 CurrentFileVersion Attribute ...................................................................................... 11-21

496

11.10.4 CurrentZigBeeStackVersion Attribute ........................................................................ 11-21

497

11.10.5 DownloadedFileVersion Attribute .............................................................................. 11-21

498

11.10.6 DownloadedZigBeeStackVersion Attribute ................................................................ 11-21

499

11.10.7 ImageUpgradeStatus Attribute .................................................................................... 11-21

500

11.10.8 Manufacturer ID Attribute .......................................................................................... 11-22

501

11.10.9 Image Type ID Attribute ............................................................................................. 11-22

502

11.10.10 MinimumBlockPeriod Attribute ............................................................................ 11-22

503

11.10.11 Image Stamp Attribute .......................................................................................... 11-22

504

11.10.12 UpgradeActivationPolicy Attribute ....................................................................... 11-22

505

11.10.13 UpgradeTimeoutPolicy Attribute .......................................................................... 11-23

506

11.11 OTA Cluster Parameters .................................................................................................... 11-24

507

11.11.1 QueryJitter Parameter ................................................................................................. 11-24

508

11.11.2 DataSize Parameter ..................................................................................................... 11-24

509

11.11.3 OTAImageData Parameter .......................................................................................... 11-24

510

11.11.4 CurrentTime and UpgradeTime/RequestTime Parameters ......................................... 11-25

511

11.12 OTA Upgrade Diagram ...................................................................................................... 11-26

512

11.13 Command Frames .............................................................................................................. 11-27

513

11.13.1 OTA Cluster Command Identifiers ............................................................................. 11-27

514

11.13.2 OTA Cluster Status Codes .......................................................................................... 11-28

515

11.13.3 Image Notify Command .............................................................................................. 11-28

516

11.13.4 Query Next Image Request Command ........................................................................ 11-31

517

11.13.5 Query Next Image Response Command ..................................................................... 11-33

518

11.13.6 Image Block Request Command ................................................................................. 11-35

519

11.13.7 Image Page Request Command .................................................................................. 11-37

520

11.13.8 Image Block Response Command .............................................................................. 11-41

521

11.13.9 Upgrade End Request Command ................................................................................ 11-45

522

11.13.10 Query Device Specific File Request Command .................................................... 11-49

523

11.13.11 Query Device Specific File Response Command .................................................. 11-50

524

11.14 Multiple Files Required for a Bootload .............................................................................. 11-52

525

11.14.1 Single OTA File with multiple sub-elements .............................................................. 11-52

526

11.14.2 Separate OTA Files Upgraded Independently............................................................. 11-52

527

11.14.3 Multiple OTA Files Dependent on Each Other ........................................................... 11-53

528

11.15 OTA Upgrade Cluster Management ................................................................................... 11-53

529

11.15.1 Query Upgrade Status ................................................................................................. 11-53

530

11.15.2 Query Downloaded ZigBee Stack and File Versions .................................................. 11-54

531

11.15.3 Rate Limiting .............................................................................................................. 11-54

532

11.15.4 Current Time, Request Time, and MinimumBlockPeriod .......................................... 11-55

533

11.16 OTA Upgrade Process ........................................................................................................ 11-56

534

11.17 Application Standard Specific Decisions ........................................................................... 11-56

535

Zigbee Cluster Library Specification

Zigbee Document – 075123

11.17.1 SE Profile Standard: OTA Upgrade from SE 1.x to SE 2.0 ......................................... 11-57

536

11.18 OTA Upgrade Recovery ..................................................................................................... 11-57

537

Chapter 12 Telecommunication ............................................................................................................ 12-1

538

12.1 General Description.................................................................................................................... 12-1

539

12.1.1 Introduction ................................................................................................................... 12-1

540

12.1.2 Cluster List .................................................................................................................... 12-1

541

12.2 Information ................................................................................................................................. 12-1

542

12.2.1 Scope and Purpose ......................................................................................................... 12-1

543

12.2.2 Cluster List .................................................................................................................... 12-2

544

12.2.3 Overview ....................................................................................................................... 12-3

545

12.2.4 Server ............................................................................................................................. 12-4

546

12.2.5 Client ........................................................................................................................... 12-21

547

12.2.6 Payload Formats for Contents Data ............................................................................. 12-21

548

12.2.7 Introduction ................................................................................................................. 12-24

549

12.2.8 Server ........................................................................................................................... 12-25

550

12.2.9 Client ........................................................................................................................... 12-35

551

12.3 Voice Over ZigBee................................................................................................................... 12-36

552

12.3.1 Scope and Purpose ....................................................................................................... 12-36

553

12.3.2 Overview ..................................................................................................................... 12-36

554

12.3.3 Server ........................................................................................................................... 12-37

555

12.3.4 Client ........................................................................................................................... 12-44

556

Chapter 13 Commissioning ................................................................................................................... 13-1

557

13.1 General Description.................................................................................................................... 13-1

558

13.1.1 13.1.1 Introduction ......................................................................................................... 13-1

559

13.1.2 13.1.2 Cluster List .......................................................................................................... 13-1

560

13.2 Commissioning .......................................................................................................................... 13-1

561

13.2.1 Overview ....................................................................................................................... 13-1

562

13.2.2 Server ............................................................................................................................. 13-2

563

13.2.3 Client ........................................................................................................................... 13-16

564

13.2.4 Commissioning EUI-64s.............................................................................................. 13-17

565

13.3 Touchlink Commissioning ....................................................................................................... 13-18

566

13.3.1 Overview ..................................................................................................................... 13-18

567

13.3.2 Server ........................................................................................................................... 13-19

568

13.3.3 Client ........................................................................................................................... 13-45

569

13.3.4 Functional Description ................................................................................................. 13-46

570

Chapter 14 Retail .................................................................................................................................. 14-1

571

14.1 General Description.................................................................................................................... 14-1

572

14.1.1 Introduction ................................................................................................................... 14-1

573

14.1.2 Cluster List .................................................................................................................... 14-1

574

14.2 Retail Tunnel (MSP Tunnel) ...................................................................................................... 14-1

575

14.2.1 Overview ....................................................................................................................... 14-1

576

14.2.2 Server ............................................................................................................................. 14-2

577

14.2.3 Client ............................................................................................................................. 14-4

578

14.3 Mobile Device Configuration ..................................................................................................... 14-4

579

14.3.1 Overview ....................................................................................................................... 14-4

580

14.3.2 Server ............................................................................................................................. 14-5

581

14.3.3 Client ............................................................................................................................. 14-7

582

14.4 Neighbor Cleaning ..................................................................................................................... 14-7

583

14.4.1 Overview ....................................................................................................................... 14-7

584

14.4.2 Server ............................................................................................................................. 14-8

585

14.4.3 Client ............................................................................................................................. 14-9

586

14.5 Nearest Gateway ...................................................................................................................... 14-10

587

14.5.1 Overview ..................................................................................................................... 14-10

588

Zigbee Cluster Library Specification

Zigbee Document – 075123

14.5.2 Server .......................................................................................................................... 14-11

589

14.5.3 Client ........................................................................................................................... 14-11

590

14.5.4 Examples of Use ......................................................................................................... 14-11

591

Chapter 15 Appliance ........................................................................................................................... 15-1

592

15.1 General Description ................................................................................................................... 15-1

593

15.1.1 Introduction ................................................................................................................... 15-1

594

15.1.2 Cluster List .................................................................................................................... 15-1

595

15.2 EN50523 Appliance Control ..................................................................................................... 15-1

596

15.2.1 Overview ....................................................................................................................... 15-1

597

15.2.2 General Description ...................................................................................................... 15-2

598

15.2.3 Server Attributes ........................................................................................................... 15-2

599

15.2.4 Server Commands Received ......................................................................................... 15-4

600

15.2.5 Server Commands Generated ........................................................................................ 15-8

601

15.2.6 Client ........................................................................................................................... 15-10

602

15.3 EN50523 Appliance Identification .......................................................................................... 15-11

603

15.3.1 Overview ..................................................................................................................... 15-11

604

15.3.2 Server .......................................................................................................................... 15-11

605

15.3.3 Client ........................................................................................................................... 15-15

606

15.4 EN50523 Appliance Events and Alerts ................................................................................... 15-15

607

15.4.1 Overview ..................................................................................................................... 15-15

608

15.4.2 Server .......................................................................................................................... 15-17

609

15.4.3 Client ........................................................................................................................... 15-21

610

15.5 Appliance Statistics ................................................................................................................. 15-21

611

15.5.1 Overview ..................................................................................................................... 15-21

612

15.5.2 Server .......................................................................................................................... 15-22

613

15.5.3 Client ........................................................................................................................... 15-25

614

15.5.4 Appliance Statistics Cluster Sequence Diagram ......................................................... 15-26

615

616

Zigbee Cluster Library Specification

Zigbee Document – 075123

LIST OF FIGURES

617

Figure 2-1. Client Server Model ...................................................................................................................2-3

618

Figure 2-2. Format of the General ZCL Frame ............................................................................................2-8

619

Figure 2-3. Format of the Frame Control Field ............................................................................................2-8

620

Figure 2-4. Values of the Frame Type Sub-field ..........................................................................................2-8

621

Figure 2-5. Format of the Read Attributes Command Frame ..................................................................... 2-11

622

Figure 2-6. Format of Read Attributes Response Command Frame .......................................................... 2-12

623

Figure 2-7. Format of the Read Attributes Status Record Field ................................................................. 2-12

624

Figure 2-8. Format of the Attribute Value Field for an Array, Set or Bag ................................................. 2-13

625

Figure 2-9. Format of the Attribute Value Field for a Structure ................................................................. 2-13

626

Figure 2-10. Format of the Write Attributes Command Frame .................................................................. 2-14

627

Figure 2-11. Format of the Write Attribute Record Field ........................................................................... 2-14

628

Figure 2-12. Format of Write Attributes Response Command Frame ........................................................ 2-16

629

Figure 2-13. Format of the Write Attribute Status Record Field ................................................................ 2-16

630

Figure 2-14. Write Attributes No Response Command Frame .................................................................. 2-17

631

Figure 2-15. Format of the Configure Reporting Command Frame ........................................................... 2-18

632

Figure 2-16. Format of the Attribute Reporting Configuration Record ...................................................... 2-18

633

Figure 2-17. Format of the Configure Reporting Response Command Frame ........................................... 2-21

634

Figure 2-18. Format of the Attribute Status Record Field .......................................................................... 2-22

635

Figure 2-19. Read Reporting Configuration Command Frame .................................................................. 2-23

636

Figure 2-20. Format of the Attribute Status Record Field .......................................................................... 2-23

637

Figure 2-21. Format of the Read Reporting Configuration Response Command Frame ........................... 2-24

638

Figure 2-22. Attribute Reporting Configuration Record Field ................................................................... 2-24

639

Figure 2-23. Format of the Report Attributes Command Frame ................................................................ 2-26

640

Figure 2-24. Format of the Attribute Report Fields .................................................................................... 2-26

641

Figure 2-25. Format of the Default Response Command Frame ................................................................ 2-28

642

Figure 2-26. Format of the Discover Attributes Command Frame ............................................................. 2-29

643

Figure 2-27. Discover Attributes Response Command Frame ................................................................... 2-30

644

Figure 2-28. Format of the Attribute Report Fields .................................................................................... 2-30

645

Figure 2-29. Format of Read Attributes Structured Command Frame ....................................................... 2-31

646

Figure 2-30. Format of the Selector Field .................................................................................................. 2-32

647

Figure 2-31. Write Attributes Structured Command Frame ....................................................................... 2-33

648

Figure 2-32. Format of the Write Attribute Record Field ........................................................................... 2-33

649

Figure 2-33. Format of the Selector Field .................................................................................................. 2-33

650

Figure 2-34. Write Attributes Structured Response Command Frame ....................................................... 2-36

651

Figure 2-35. Format of the Write Attribute Status Record Field ................................................................ 2-36

652

Figure 2-36. Format of the Discover Server Commands Command Frame ............................................... 2-37

653

Figure 2-37. Format of the Discover Commands Received Response Frame ............................................ 2-38

654

Figure 2-38. Format of the Discover Attributes Extended Command Frame ............................................. 2-40

655

Figure 2-39. Format of the Discover Attributes Extended Response Command Frame ............................ 2-41

656

Figure 2-40. Format of the Extended Attribute Information Fields ............................................................ 2-41

657

Figure 2-41. Format of the Attribute Access Control Field ........................................................................ 2-42

658

Figure 2-42. Format of the Semi-precision Number .................................................................................. 2-49

659

Figure 2-43. Format of the Octet String Type ............................................................................................ 2-50

660

Figure 2-44. Format of the Character String Type ..................................................................................... 2-51

661

Figure 2-45. Format of the Long Octet String Type ................................................................................... 2-51

662

Figure 2-46. Format of the Long Character String Type ............................................................................ 2-52

663

Figure 2-47. Format of the Time of Day Type ........................................................................................... 2-53

664

Figure 2-48. Format of the Date Type ........................................................................................................ 2-54

665

Figure 3-1. Typical Usage of Device Configuration and Installation Clusters .............................................3-2

666

Figure 3-2. Typical Usage of On/Off and Level Clusters.............................................................................3-3

667

Figure 3-3. Typical Usage of the Alarms Cluster .........................................................................................3-3

668

Figure 3-4. Typical Usage of the Location Cluster with Centralized Device ...............................................3-4

669

Figure 3-5. Example Usage of the Input, Output and Value Clusters ..........................................................3-5

670

Figure 3-6. Format of the ProductCode attribute ....................................................................................... 3-11

671

Zigbee Cluster Library Specification

Zigbee Document – 075123

Figure 3-7. Format of Identify Query Response Command Payload ......................................................... 3-32

672

Figure 3-8. Format of the Trigger Effect Command .................................................................................. 3-32

673

Figure 3-9. Format of Identify Query Response Command Payload ......................................................... 3-34

674

Figure 3-10. Format of the Add Group Command Payload ...................................................................... 3-37

675

Figure 3-11. Format of the View Group Command Payload ..................................................................... 3-38

676

Figure 3-12. Format of Get Group Membership Command Payload ........................................................ 3-39

677

Figure 3-13. Format of the Remove Group Command Payload ................................................................ 3-39

678

Figure 3-14. Add Group If Identifying Command Payload ....................................................................... 3-40

679

Figure 3-15. Format of the Add Group Response Command Payload ...................................................... 3-42

680

Figure 3-16. Format of the View Group Response Command Payload ..................................................... 3-42

681

Figure 3-17. Format of the Get Group Membership Response Command Payload .................................. 3-43

682

Figure 3-18. Format of Remove Group Response Command Payload ...................................................... 3-43

683

Figure 3-19. Format of the Add Scene Command Payload ....................................................................... 3-48

684

Figure 3-20. Format of the View Scene Command Payload ..................................................................... 3-49

685

Figure 3-21. Format of the Remove Scene Command Payload ................................................................. 3-49

686

Figure 3-22. Format of the Remove All Scenes Command Payload ......................................................... 3-50

687

Figure 3-23. Format of the Store Scene Command Payload ...................................................................... 3-51

688

Figure 3-24. Format of the Recall Scene Command Payload .................................................................... 3-52

689

Figure 3-25. Format of Get Scene Membership Command Payload ......................................................... 3-53

690

Figure 3-26. Format of the Copy Scene Command ................................................................................... 3-55

691

Figure 3-27. Format of the Mode Field of the Copy Scene Command ...................................................... 3-55

692

Figure 3-28. Format of the Add Scene Response Command Payload ....................................................... 3-57

693

Figure 3-29. Format of the View Scene Response Command Payload ..................................................... 3-57

694

Figure 3-30. Format of Remove Scene Response Command Payload ...................................................... 3-58

695

Figure 3-31. Format of the Remove All Scenes Response Command Payload ......................................... 3-58

696

Figure 3-32. Format of the Store Scene Response Command Payload ..................................................... 3-59

697

Figure 3-33. Format of the Get Scene Membership Response CommandPayload .................................... 3-59

698

Figure 3-34. Format of the Copy Scene Response Command ................................................................... 3-60

699

Figure 3-35. State Behavior of Store and Recall Global Scene ................................................................. 3-63

700

Figure 3-36. Format of the Off With Effect Command ............................................................................. 3-65

701

Figure 3-37. Format of the On With Timed Off Command ....................................................................... 3-67

702

Figure 3-38. Format of the On/Off Control Field of the On With Timed Off Command .......................... 3-67

703

Figure 3-39. On/Off Cluster Operation State Machine .............................................................................. 3-68

704

Figure 3-40. Format of the Move to Level Command Payload ................................................................. 3-77

705

Figure 3-41. Format of the Move Command Payload ............................................................................... 3-78

706

Figure 3-42. Format of the Step Command Payload ................................................................................. 3-79

707

Figure 3-43. Format of the Command Payload ......................................................................................... 3-80

708

Figure 3-44. Format of the Command Payload ......................................................................................... 3-81

709

Figure 3-45. Format of the Reset Alarm Command Payload..................................................................... 3-84

710

Figure 3-46. Format of the Alarm Command Payload .............................................................................. 3-85

711

Figure 3-47. Format of the Get Alarm Response Command Payload ....................................................... 3-85

712

Figure 3-48. Example of Usage of RSSI Location Cluster ........................................................................ 3-91

713

Figure 3-49. Format of the Set Absolute Location Command Payload ..................................................... 3-96

714

Figure 3-50. Format of the Set Device Configuration Payload ................................................................. 3-96

715

Figure 3-51. Format of the Get Device Configuration Payload ................................................................. 3-97

716

Figure 3-52. Format of the Get Location Data Payload ............................................................................. 3-98

717

Figure 3-53. Format of the RSSI Response Command Payload ................................................................ 3-99

718

Figure 3-54. Format of the Send Pings Command Payload ..................................................................... 3-100

719

Figure 3-55. Format of the Anchor Node Announce Command Payload ................................................ 3-100

720

Figure 3-56. Format of the Device Configuration Response Payload ..................................................... 3-101

721

Figure 3-57. Format of the Location Data Response Payload ................................................................. 3-102

722

Figure 3-58. Format of the Location Data Notification Payload ............................................................. 3-103

723

Figure 3-59. Format of the RSSI Ping Command Payload ...................................................................... 3-103

724

Figure 3-60. Format of the Report RSSI Measurements Command Payload ........................................... 3-104

725

Figure 3-61. Neighbor Info Structure ...................................................................................................... 3-104

726

Figure 3-62. Format of the Request Own Location Command Payload .................................................. 3-105

727

剩余1212页未读，继续阅读

lin357858771

粉丝: 0
资源: 2

Zigbee联盟发布的Zigbee Cluster Library规范

Zigbee Cluster Library Specification 2021: Revision 8详解

Zigbee Cluster Library Specification Revision 7 (2018)

ZigBee Cluster Library详解与授权指南

07-5123-06-zigbee-cluster-library-specification (20).pdf

zigbee-cluster-library.zip

zigbee cluster library

Zigbee Cluster Library

07-5123-07-ZigbeeClusterLibrary_Revision_7.pdf

Getting-Started-with-Zigbee-3.0-CN.pdf

ZIGBEE CLUSTER LIBRARY SPECIFICATION

最新资源