From 6463a745ac686306af77d263d0b74586c273b5b9 Mon Sep 17 00:00:00 2001 From: Shubham Patil Date: Wed, 22 Jan 2025 12:17:18 +0530 Subject: [PATCH 1/3] docs: modify copyright headers for files taken and modified from third-party sources --- .../blemesh_platform/platform/ESP32_custom/BUILD.gn | 11 +++++++++++ .../platform/ESP32_custom/nimble/BLEManagerImpl.cpp | 11 +++++++++++ examples/common/external_platform/BUILD.gn | 11 +++++++++++ 3 files changed, 33 insertions(+) diff --git a/examples/common/blemesh_platform/platform/ESP32_custom/BUILD.gn b/examples/common/blemesh_platform/platform/ESP32_custom/BUILD.gn index eb30491a6..99c7ae4ff 100644 --- a/examples/common/blemesh_platform/platform/ESP32_custom/BUILD.gn +++ b/examples/common/blemesh_platform/platform/ESP32_custom/BUILD.gn @@ -1,3 +1,14 @@ +# SPDX-FileCopyrightText: 2021 Project CHIP Authors +# +# SPDX-License-Identifier: Apache-2.0 +# +# SPDX-FileContributor: 2024 Espressif Systems (Shanghai) PTE LTD +# +# Modified the original code to support blemesh platform on ESP32 SoCs. +# +# For original code and license information, please refer to +# https://github.com/project-chip/connectedhomeip + # Copyright (c) 2021 Project CHIP Authors # # Licensed under the Apache License, Version 2.0 (the "License"); diff --git a/examples/common/blemesh_platform/platform/ESP32_custom/nimble/BLEManagerImpl.cpp b/examples/common/blemesh_platform/platform/ESP32_custom/nimble/BLEManagerImpl.cpp index 373fdbfe3..c56fef9a8 100644 --- a/examples/common/blemesh_platform/platform/ESP32_custom/nimble/BLEManagerImpl.cpp +++ b/examples/common/blemesh_platform/platform/ESP32_custom/nimble/BLEManagerImpl.cpp @@ -1,3 +1,14 @@ +// SPDX-FileCopyrightText: 2020-2021 Project CHIP Authors +// +// SPDX-License-Identifier: Apache-2.0 +// +// SPDX-FileContributor: 2024 Espressif Systems (Shanghai) PTE LTD +// +// Modified the original code to support blemesh platform on ESP32 SoCs. +// +// For original code and license information, please refer to +// https://github.com/project-chip/connectedhomeip + /* * * Copyright (c) 2020-2021 Project CHIP Authors diff --git a/examples/common/external_platform/BUILD.gn b/examples/common/external_platform/BUILD.gn index 75527b9ac..5b6e8be06 100644 --- a/examples/common/external_platform/BUILD.gn +++ b/examples/common/external_platform/BUILD.gn @@ -1,3 +1,14 @@ +# SPDX-FileCopyrightText: 2020-2021 Project CHIP Authors +# +# SPDX-License-Identifier: Apache-2.0 +# +# SPDX-FileContributor: 2022-2024 Espressif Systems (Shanghai) PTE LTD +# +# Modified the original code to support external platform on ESP32 SoCs. +# +# For original code and license information, please refer to +# https://github.com/project-chip/connectedhomeip + # Copyright (c) 2021 Project CHIP Authors # # Licensed under the Apache License, Version 2.0 (the "License"); From 0924df411f669957d647e20afa19a6687d0c4479 Mon Sep 17 00:00:00 2001 From: Shubham Patil Date: Wed, 22 Jan 2025 12:18:07 +0530 Subject: [PATCH 2/3] docs: add the notice file --- NOTICE | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 NOTICE diff --git a/NOTICE b/NOTICE new file mode 100644 index 000000000..61155bde7 --- /dev/null +++ b/NOTICE @@ -0,0 +1,42 @@ +Espressif’s SDK for Matter is an open source development framework for Matter +Specification. It is built on top of the open source Matter SDK. It is developed +and maintained by Espressif Systems and licensed under Apache License 2.0. + +The Matter SDK is an open source implementation of the Matter Specification +(Matter). Matter is developed by members of the Connectivity Standards Alliance +(Alliance) and promulgated by the Alliance. + +LIMITED RIGHTS TO THE MATTER SDK: Your rights to the Matter SDK are described in +the LICENSE. No warranty or assurance is made with respect to additional rights +that may be required to implement the Matter SDK. Use of the Matter SDK does not +assure compliance with Matter and does not convey the right to identify any +device, software, product or service as Matter compliant, certified or similar. + +CERTIFICATION REQUIRES MEMBERSHIP IN THE ALLIANCE: Certification by the Alliance +of any device, software, product or service is limited to members of the +Alliance, and requires compliance with applicable Alliance policies. + +USE OF ALLIANCE TRADEMARKS AND LOGOS REQUIRES MEMBERSHIP IN THE ALLIANCE: Only +the Alliance and its members may use Alliance trademarks and logos, including, +without limitation, the Matter trademarks and logos. All Alliance trademarks and +logos must be used in accordance with the Connectivity Standards Alliance +Trademark and Logo Usage Guidelines and Terms, a copy of which can be found at +www.csa-iot.org/resources/governing-documents. + +JOINING CONNECTIVITY STANDARDS ALLIANCE: For information on how to become a +member of Connectivity Standards Alliance please visit +www.csa-iot.org/become-member. + +DISCLAIMER: Elements of the Matter SDK may be subject to third party +intellectual property rights, including without limitation, patent, copyright or +trademark rights (such third party may or may not be a member of the Alliance). +The Alliance is not responsible and shall not be held responsible in any manner +for identifying or failing to identify any or all such third party intellectual +property rights. + +Members of the Alliance may own intellectual property rights in Matter which +rights are subject to the Alliance's Intellectual Property Rights Policy, which +can be found at www.csa-iot.org/resources/governing-documents, and not the +LICENSE. + +This NOTICE must be included on all copies of the Matter SDK. From 91c773948789cff55183bcd0c7f43fae88967871 Mon Sep 17 00:00:00 2001 From: Shubham Patil Date: Wed, 22 Jan 2025 12:47:12 +0530 Subject: [PATCH 3/3] docs: added copyrights and licensing page in programming guide --- NOTICE | 3 ++ docs/en/COPYRIGHT.rst | 64 +++++++++++++++++++++++++++++++++++++++++++ docs/en/index.rst | 9 ++++-- 3 files changed, 74 insertions(+), 2 deletions(-) create mode 100644 docs/en/COPYRIGHT.rst diff --git a/NOTICE b/NOTICE index 61155bde7..1abd1f867 100644 --- a/NOTICE +++ b/NOTICE @@ -1,6 +1,9 @@ Espressif’s SDK for Matter is an open source development framework for Matter Specification. It is built on top of the open source Matter SDK. It is developed and maintained by Espressif Systems and licensed under Apache License 2.0. +The following content is copied from the Matter SDK NOTICE file. +If there are any updates, the latest copy can be found at +https://github.com/project-chip/connectedhomeip/blob/master/NOTICE The Matter SDK is an open source implementation of the Matter Specification (Matter). Matter is developed by members of the Connectivity Standards Alliance diff --git a/docs/en/COPYRIGHT.rst b/docs/en/COPYRIGHT.rst new file mode 100644 index 000000000..b94f3908b --- /dev/null +++ b/docs/en/COPYRIGHT.rst @@ -0,0 +1,64 @@ +Copyrights and Licenses +*********************** + +Software Copyrights +=================== + +All original source code in this repository is Copyright (C) 2021-2025 Espressif Systems. +This source code is licensed under the Apache License 2.0 as described in the file +:project_file:`LICENSE `. + +Additional third party copyrighted code is included under the following licenses. + +Where source code headers specify Copyright & License information, +this information takes precedence over the summaries made here. + +Some examples use external components which are not Apache licensed, +please check the copyright description in each example source code. + +ESP-IDF +------- + +* `ESP-IDF`_ is licensed under the Apache License 2.0, as described in its `copyright and license document`_. + +Matter SDK +---------- + +* The `Matter SDK`_ is licensed under the Apache License 2.0 as described in the file `LICENSE`_ file. + +Managed Components from Espressif's Component Registry +------------------------------------------------------ + +* `espressif/mdns`_ is licensed under the Apache License 2.0. +* `espressif/esp_secure_cert_mgr`_ is licensed under the Apache License 2.0. +* `espressif/esp_encrypted_img`_ is licensed under the Apache License 2.0. +* `espressif/esp_insights`_ is licensed under the Apache License 2.0. +* `espressif/json_parser`_ is licensed under the Apache License 2.0. +* `espressif/json_generator`_ is licensed under the Apache License 2.0. +* `espressif/led_strip`_ is licensed under the Apache License 2.0. +* `espressif/button`_ is licensed under the Apache License 2.0. + +Documentation +------------- + +* HTML version of the `ESP-Matter Programming Guide`_ uses the Sphinx theme `sphinx_idf_theme`_, + which is Copyright (c) 2013-2020 Dave Snider, Read the Docs, Inc. & contributors, + and Espressif Systems (Shanghai) CO., LTD. It is based on `sphinx_rtd_theme`_. + Both are licensed under MIT license. + +.. _ESP-IDF: https://github.com/espressif/esp-idf +.. _Matter SDK: https://github.com/project-chip/connectedhomeip +.. _LICENSE: https://github.com/espressif/esp-matter/blob/master/LICENSE +.. _sphinx_idf_theme: https://github.com/espressif/sphinx_idf_theme +.. _sphinx_rtd_theme: https://github.com/readthedocs/sphinx_rtd_theme +.. _ESP-Matter Programming Guide: https://docs.espressif.com/projects/esp-matter/en/latest +.. _copyright and license document: https://docs.espressif.com/projects/esp-idf/en/latest/esp32/COPYRIGHT.html +.. _Espressif Component Registry: https://components.espressif.com +.. _espressif/mdns: https://components.espressif.com/components/espressif/mdns +.. _espressif/esp_secure_cert_mgr: https://components.espressif.com/components/espressif/esp_secure_cert_mgr +.. _espressif/esp_encrypted_img: https://components.espressif.com/components/espressif/esp_encrypted_img +.. _espressif/esp_insights: https://components.espressif.com/components/espressif/esp_insights +.. _espressif/json_parser: https://components.espressif.com/components/espressif/json_parser +.. _espressif/json_generator: https://components.espressif.com/components/espressif/json_generator +.. _espressif/led_strip: https://components.espressif.com/components/espressif/led_strip +.. _espressif/button: https://components.espressif.com/components/espressif/button \ No newline at end of file diff --git a/docs/en/index.rst b/docs/en/index.rst index 69efc78ff..914e831e0 100644 --- a/docs/en/index.rst +++ b/docs/en/index.rst @@ -1,7 +1,7 @@ Programming Guide ================= -`Matter `__ is a unified IP-based +`Matter`_ is a unified IP-based connectivity protocol that is designed to connect and build open, reliable and secure IoT ecosystems. This new technology and connectivity standard enables communication among a wide range of smart devices. Matter supports IP connectivity over Wi-Fi, Thread and Ethernet. @@ -9,7 +9,8 @@ communication among a wide range of smart devices. Matter supports IP connectivi Espressif's SDK for Matter is the official Matter development framework for Espressif's ESP32 series SoCs. -We have put together a series of blog posts that introduces various aspects of Matter. We recommend that you go through this `Espressif Matter Blog `__. +We have put together a series of blog posts that introduces various aspects of Matter. +We recommend that you go through this `Espressif Matter Blog`_. Table of Contents ================= @@ -26,4 +27,8 @@ Table of Contents 7. API Reference 8. Integration with esp-insights 9. Application User Guide + 10. Copyrights and Licenses A1 Appendix FAQs + +.. _Matter: https://csa-iot.org/all-solutions/matter/ +.. _Espressif Matter Blog: https://blog.espressif.com/matter-38ccf1d60bcd