Merge branch 'docs/add_disclaimer_v2.2' into 'release/v2.2.0.0_esp8266'

docs: Added a disclaimer for the esp-at project (v2.2.0.0) See merge request application/esp-at!1649
espressif · Nov 5, 2024 · ab82e36 · ab82e36
2 parents b333aa7 + 81b0357
commit ab82e36
Show file tree

Hide file tree

Showing 13 changed files with 160 additions and 2 deletions.
diff --git a/README.md b/README.md
@@ -1,5 +1,5 @@
 # Overview
-libat_core.a is AT Command Core, and it is the core of AT command, including the default AT instruction set, the AT command parsing, execution and responding. The lib contains 4 kinds of command, such as `AT+TEST=?`, `AT+TEST?`, `AT+TEST=“abc”` and `AT+TEST`. It supports custom AT commands based on the lib and related APIs, and ones can also define input and output medium, like uart, spi, socket, bt, etc.
+libat_core.a is AT Command Core, and it is the core of AT command, including the default AT instruction set, the AT command parsing, execution and responding. The lib contains 4 kinds of command, such as `AT+TEST=?`, `AT+TEST?`, `AT+TEST=“abc”` and `AT+TEST`. It supports custom AT commands based on the lib and related APIs, and ones can also define input and output medium, like uart, spi, socket, bt, etc. **Before using the ESP-AT solution, please read the [disclaimer](https://docs.espressif.com/projects/esp-at/en/latest/esp32/disclaimer.html) carefully and comply with its terms and precautions.**
 
 The demo is the AT command set based on uart. You can replace the uart driver with other drivers whichever you want to use. But maybe you have to make some changes to run the new driver. In addition, you can add some custom AT commands in `at_custom_cmd` like `AT+CIUPDATE` if necessary.
 
@@ -20,7 +20,7 @@ The demo is the AT command set based on uart. You can replace the uart driver wi
 - https://blog.csdn.net/espressif/article/details/79316992: CSDN espressif official blog in Chinese
 
 # 概述
-libat_core.a 是 AT 命令集的核心部分, 包含默认的 AT 指令集, 具有 AT 命令解析、 执行和回复功能. 在此库中，可以处理 `AT+TEST=?`、 `AT+TEST?`、 `AT+TEST=“abc”` 和 `AT+TEST` 4 种格式的指令集. 可以根据相关 API 自定义命令, 并且还可以定义输入输出介质, 比如 uart, spi, socket, bt 等等.
+libat_core.a 是 AT 命令集的核心部分, 包含默认的 AT 指令集, 具有 AT 命令解析、 执行和回复功能. 在此库中，可以处理 `AT+TEST=?`、 `AT+TEST?`、 `AT+TEST=“abc”` 和 `AT+TEST` 4 种格式的指令集. 可以根据相关 API 自定义命令, 并且还可以定义输入输出介质, 比如 uart, spi, socket, bt 等等. **在使用 ESP-AT 方案前，请仔细阅读 [特别声明](https://docs.espressif.com/projects/esp-at/zh_CN/latest/esp32/disclaimer.html)，并遵循其中的各项条款和注意事项。**
 
 此工程是基于 uart 实现的命令集，如果需要，你可以使用其它驱动程序替换掉 uart 驱动，为了使用新的驱动程序，可能必须做一些必要的代码改动. 另外，如果需要，你可以仿照 `AT+CIUPDATE` 在 `at_custom_cmd` 中添加自定义命令.
 

diff --git a/docs/en/AT_Binary_Lists/ESP32-S2_AT_binaries.md b/docs/en/AT_Binary_Lists/ESP32-S2_AT_binaries.md
@@ -3,6 +3,10 @@ Released Firmware
 
 It is recommended to use the lastest version of firmware.
 
+## Disclaimer
+
+Before using the AT firmware below, please read the [disclaimer](https://docs.espressif.com/projects/esp-at/en/latest/esp32/disclaimer.html) carefully and comply with its terms and precautions.
+
 ## ESP32-S2-WROOM Series
 
 - v2.1.0.0 [ESP32-S2-WROOM_AT_Bin_V2.1.0.0.zip](https://download.espressif.com/esp_at/firmware/ESP32S2/ESP32-S2-WROOM/ESP32-S2-WROOM_AT_Bin_V2.1.0.0.zip) (Recommended)

diff --git a/docs/en/AT_Binary_Lists/ESP32_AT_binaries.md b/docs/en/AT_Binary_Lists/ESP32_AT_binaries.md
@@ -3,6 +3,10 @@ Released Firmware
 
 It is recommended to use the lastest version of firmware.
 
+## Disclaimer
+
+Before using the AT firmware below, please read the [disclaimer](https://docs.espressif.com/projects/esp-at/en/latest/esp32/disclaimer.html) carefully and comply with its terms and precautions.
+
 ## ESP32-WROOM-32 Series
 
 - v2.1.0.0 [ESP32-WROOM-32_AT_Bin_V2.1.0.0.zip](https://download.espressif.com/esp_at/firmware/ESP32/ESP32_WROOM/ESP32-WROOM-32_AT_Bin_V2.1.0.0.zip) (Recommended)

diff --git a/docs/en/AT_Binary_Lists/ESP8266_AT_binaries.md b/docs/en/AT_Binary_Lists/ESP8266_AT_binaries.md
@@ -6,6 +6,10 @@ It is recommended to use the lastest version of firmware.
 **Note**:  
 Espressif has not released a separate version for the **1 MB ESP8285/8266 series of chips**, but you can refer to [How to Download the Latest Temporary Version of AT Firmware from GitHub](https://docs.espressif.com/projects/esp-at/en/latest/Compile_and_Develop/How_to_download_the_latest_temporary_version_of_AT_from_github.html) and choose to download the 1 MB firmware on the CI (Continuous Integration) of GitHub (**Please switch to release/v2.2.0.0_esp8266 branch and download `esp8285-1MB-at` under the Artifacts page**).
 
+## Disclaimer
+
+Before using the AT firmware below, please read the [disclaimer](https://docs.espressif.com/projects/esp-at/en/latest/esp32/disclaimer.html) carefully and comply with its terms and precautions.
+
 ## ESP-WROOM-02 Series
 
 - v2.2.1.0 [ESP8266-IDF-AT_V2.2.1.0.zip](https://download.espressif.com/esp_at/firmware/ESP8266/ESP8266-IDF-AT_V2.2.1.0.zip) (Recommended)

diff --git a/docs/en/Get_Started/What_is_ESP-AT.rst b/docs/en/Get_Started/What_is_ESP-AT.rst
@@ -3,6 +3,9 @@ What is ESP-AT
 
 :link_to_translation:`zh_CN:[中文]`
 
+.. important::
+  Before using the ESP-AT, please read the :doc:`../disclaimer` carefully and comply with its terms and precautions.
+
 ESP-AT is a solution developed by Espressif to integrate connectivity into customers' products, which can be quickly moved to mass production. It aims to reduce software development costs and quickly form products. With ESP-AT commands, you can quickly join the wireless network, connect to the cloud platform, realize data transmission and remote control functions, and realize the interconnection of everything through wireless communication easily.
 
 ESP-AT is a project based on ESP-IDF or ESP8266_RTOS_SDK. It makes an ESP board work as a slave, and an MCU as a host. The host MCU sends AT commands to the ESP chip and receives AT responses back. ESP-AT provides a wide range of AT commands with different functions, such as Wi-Fi commands, TCP/IP commands, Bluetooth LE commands, Bluetooth commands, MQTT commands, HTTP commands, and Ethernet commands.

diff --git a/docs/en/disclaimer.rst b/docs/en/disclaimer.rst
@@ -0,0 +1,63 @@
+Disclaimer
+==========
+
+:link_to_translation:`zh_CN:[中文]`
+
+Thank you for choosing to use [Solution/Firmware ESP-AT]. To ensure the safe, legal, and effective use of this solution (firmware), please carefully read the following Disclaimer. This Disclaimer aims to clarify the terms and precautions that users must follow when using this solution (firmware). By continuing to use this solution (firmware), you indicate your acceptance and agreement to comply with these terms.
+
+Application Scenario Verification
+---------------------------------
+
+This solution (firmware) is a general version. Despite extensive testing across various scenarios, there remains a risk that certain use cases may not be covered. Prior to making commercial production decisions based on this solution (firmware), please conduct thorough and comprehensive validation tailored to your specific application scenarios.
+
+Compatibility
+-------------
+
+Given the rapid advancement of technology, the emergence of new technologies, solutions, or standards may lead to compatibility issues. Users are advised to conduct appropriate testing and validation based on their products and to stay informed about new version releases of this solution (firmware)
+
+Server Upgrade Considerations
+-----------------------------
+
+When upgrading servers, including but not limited to operating system upgrades, tool upgrades, and certificate upgrades, it is essential to conduct testing and validation prior to any formal upgrades to prevent connectivity issues arising from server changes.
+
+Wireless Solution Issue Handling
+--------------------------------
+
+Wireless solutions are susceptible to external factors and can present complex issue diagnostics. Users should plan remote OTA and remote issue information retrieval solutions in conjunction with their products and cloud platforms. Otherwise, users may need to provide on-site logs, data packets, and other necessary information for problem analysis.
+
+Usage Restrictions
+------------------
+
+Users must not utilize this solution (firmware) for illegal activities or purposes that violate applicable laws and regulations. Users are responsible for ensuring that their use of this solution (this firmware) complies with all relevant laws and regulations. We accept no responsibility for any consequences arising from illegal use of this solution (firmware).
+
+Limitation of Liability
+-----------------------
+
+We shall not be liable for any direct, indirect, incidental, special, or consequential damages (including but not limited to data loss, profit loss, business interruption, etc.) resulting from the use of this solution (firmware), even if we have been advised of the possibility of such damages.
+
+Third-Party Software and Technology
+-----------------------------------
+
+This solution (firmware) may contain third-party software or technology. We assume no responsibility for the applicability and compliance of such third-party software or technology. Users should adhere to the licensing agreements and usage terms of third parties.
+
+Data Protection
+---------------
+
+Users are solely responsible for the protection and backup of any data generated during the use of this solution (firmware). We accept no liability for any losses resulting from data loss or leakage.
+
+Version Updates and Maintenance
+-------------------------------
+
+This solution (firmware) will undergo periodic maintenance updates and version releases. Users are encouraged to monitor version status, and no separate notification will be provided.
+
+Disclaimer Updates
+------------------
+
+The terms of this Disclaimer may be updated periodically without prior notice.
+
+User Responsibility
+-------------------
+
+Users are strongly encouraged to read and strictly adhere to the terms of this Disclaimer. Any risks arising from non-compliance shall be borne by the user.
+
+Thank you for your understanding and cooperation!
diff --git a/docs/en/index.rst b/docs/en/index.rst
@@ -43,5 +43,6 @@ This is the documentation for the ESP-AT.
    Compile and Develop <Compile_and_Develop/index>
    Customized AT Commands and Firmware <Customized_AT_Commands_and_Firmware/index>
    Index of Abbreviations <index_of_abbreviations>
+   Disclaimer <disclaimer>
 
 * :ref:`genindex`
diff --git a/docs/zh_CN/AT_Binary_Lists/ESP32-S2_AT_binaries.md b/docs/zh_CN/AT_Binary_Lists/ESP32-S2_AT_binaries.md
@@ -3,6 +3,10 @@
 
 推荐下载最新版本的固件。
 
+## 特别声明
+
+在使用下面的 AT 固件前，请仔细阅读 [特别声明](https://docs.espressif.com/projects/esp-at/zh_CN/latest/esp32/disclaimer.html)，并遵循其中的各项条款和注意事项。
+
 ## ESP32-S2-WROOM Series
 
 - v2.1.0.0 [ESP32-S2-WROOM_AT_Bin_V2.1.0.0.zip](https://download.espressif.com/esp_at/firmware/ESP32S2/ESP32-S2-WROOM/ESP32-S2-WROOM_AT_Bin_V2.1.0.0.zip)（推荐）

diff --git a/docs/zh_CN/AT_Binary_Lists/ESP32_AT_binaries.md b/docs/zh_CN/AT_Binary_Lists/ESP32_AT_binaries.md
@@ -3,6 +3,10 @@
 
 推荐下载最新版本的固件。
 
+## 特别声明
+
+在使用下面的 AT 固件前，请仔细阅读 [特别声明](https://docs.espressif.com/projects/esp-at/zh_CN/latest/esp32/disclaimer.html)，并遵循其中的各项条款和注意事项。
+
 ## ESP32-WROOM-32 Series
 
 - v2.1.0.0 [ESP32-WROOM-32_AT_Bin_V2.1.0.0.zip](https://download.espressif.com/esp_at/firmware/ESP32/ESP32_WROOM/ESP32-WROOM-32_AT_Bin_V2.1.0.0.zip)（推荐）

diff --git a/docs/zh_CN/AT_Binary_Lists/ESP8266_AT_binaries.md b/docs/zh_CN/AT_Binary_Lists/ESP8266_AT_binaries.md
@@ -6,6 +6,10 @@
 **说明**：  
 乐鑫没有为 **1 MB ESP8285/8266 系列芯片**发布单独的版本，但是您可以参考[如何从 GitHub 下载最新临时版本 AT 固件](https://docs.espressif.com/projects/esp-at/zh_CN/latest/Compile_and_Develop/How_to_download_the_latest_temporary_version_of_AT_from_github.html)并从 GitHub 上的 CI （持续集成） 上下载 1 MB 的固件 （**请切换到 release/v2.2.0.0_esp8266 分支后在 Artifacts 页面下载 `esp8285-1MB-at`**）。
 
+## 特别声明
+
+在使用下面的 AT 固件前，请仔细阅读 [特别声明](https://docs.espressif.com/projects/esp-at/zh_CN/latest/esp32/disclaimer.html)，并遵循其中的各项条款和注意事项。
+
 ## ESP-WROOM-02 Series
 
 - v2.2.1.0 [ESP8266-IDF-AT_V2.2.1.0.zip](https://download.espressif.com/esp_at/firmware/ESP8266/ESP8266-IDF-AT_V2.2.1.0.zip)（推荐）

diff --git a/docs/zh_CN/Get_Started/What_is_ESP-AT.rst b/docs/zh_CN/Get_Started/What_is_ESP-AT.rst
@@ -3,6 +3,9 @@ ESP-AT 是什么
 
 :link_to_translation:`en:[English]`
 
+.. important::
+  在使用 ESP-AT 前，请仔细阅读 :doc:`../disclaimer`，并遵循其中的各项条款和注意事项。
+
 ESP-AT 是乐鑫开发的可直接用于量产的物联网应用固件，旨在降低客户开发成本，快速形成产品。通过 ESP-AT 指令，您可以快速加入无线网络、连接云平台、实现数据通信以及远程控制等功能，真正的通过无线通讯实现万物互联。
 
 ESP-AT 是基于 ESP-IDF 或 ESP8266_RTOS_SDK 实现的软件工程。它使 ESP 模组作为从机，MCU 作为主机。MCU 发送 AT 命令给 ESP 模组，控制 ESP 模组执行不同的操作，并接收 ESP 模组返回的 AT 响应。ESP-AT 提供了大量功能不同的 AT 命令，如 Wi-Fi 命令、TCP/IP 命令、Bluetooth LE 命令、Bluetooth 命令、MQTT 命令、HTTP 命令、Ethernet 命令等。

diff --git a/docs/zh_CN/disclaimer.rst b/docs/zh_CN/disclaimer.rst
@@ -0,0 +1,63 @@
+特别声明
+========
+
+:link_to_translation:`en:[English]`
+
+感谢您选择使用 ESP-AT 方案（固件）。为了确保您对本方案（本固件）的使用安全、合法且符合预期效果，请仔细阅读以下特别声明。本声明旨在明确用户在使用本方案（本固件）过程中需要遵循的各项条款和注意事项。通过继续使用本方案（本固件），您即表示接受并同意遵守这些条款。
+
+应用场景验证
+------------
+
+本方案（本固件）为通用版本，尽管针对各种场景做了大量的测试，但测试用例仍存在某些应用场景无法覆盖的风险，在决定基于本方案（本固件）进行商用量产前，请结合自己的应用场景，进行充足且全面的验证。
+
+兼容性
+------
+
+由于技术日新月异，当某一新的技术、方案或标准出现时，可能导致兼容性问题，请结合自己产品做好相应的测试验证，并关注本方案（本固件）的新版本发布情况。
+
+服务器升级注意事项
+------------------
+
+当对服务器进行升级时，包括但不限于操作系统升级、工具升级、证书升级等，请务必在正式升级前进行测试验证，避免因服务器变动导致的连接问题。
+
+无线方案问题处理
+----------------
+
+无线方案易受外部因素影响，且问题定位复杂。请结合自身产品和云平台，规划好远程 OTA 和远程问题信息获取的解决方案，否则可能需要用户现场提供日志、数据包等必需的信息进行问题分析。
+
+使用限制
+--------
+
+用户不得将本方案（本固件）用于非法活动或违反相关法律法规的用途。用户应确保其使用本方案（本固件）的行为符合所有适用的法律和法规，我司不对因非法使用本方案（固件）而产生的任何后果负责。
+
+责任限制
+--------
+
+对于因使用本方案（本固件）造成的直接、间接、偶然、特殊或继发性的损害（包括但不限于数据丢失、利润损失、业务中断等），我司不承担任何责任，即使已被告知可能发生此类损害。 
+
+第三方软件和技术
+----------------
+
+本方案（本固件）可能包含第三方的软件或技术，我司对这些第三方软件或技术的适用性和合规性不承担责任。用户应遵循第三方的许可协议和使用条款。
+
+数据保护
+--------
+
+用户在使用本方案（本固件）过程中产生的数据应由用户自行负责保护和备份。我司对因数据丢失或泄露引起的任何损失不承担责任。
+
+版本更新与维护
+--------------
+
+本方案（本固件）会不定期进行维护更新及版本发布，请自行关注版本状态，恕不另行通知。
+
+声明更新
+--------
+
+本声明条款可能会不定期更新，恕不另行通知。
+
+用户责任
+--------
+
+强烈建议用户认真阅读并严格遵守本声明条款，由于未遵守导致的风险，需由用户承担。
+
+感谢您的理解与配合！
diff --git a/docs/zh_CN/index.rst b/docs/zh_CN/index.rst
@@ -43,5 +43,6 @@ ESP-AT 用户指南
    编译和开发 <Compile_and_Develop/index>
    第三方定制化 AT 命令和固件 <Customized_AT_Commands_and_Firmware/index>
    缩写词索引 <index_of_abbreviations>
+   特别声明 <disclaimer>
 
 * :ref:`genindex`