From 13916105663ad29fd990c4d745701efe7e068332 Mon Sep 17 00:00:00 2001
From: renpeiying <renpeiying@espressif.com>
Date: Tue, 23 Jun 2026 12:09:57 +0800
Subject: [PATCH] docs: Update hmac CN translation

---
 docs/zh_CN/api-reference/peripherals/hmac.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/zh_CN/api-reference/peripherals/hmac.rst b/docs/zh_CN/api-reference/peripherals/hmac.rst
index 53fb41ed9de..cd027012d70 100644
--- a/docs/zh_CN/api-reference/peripherals/hmac.rst
+++ b/docs/zh_CN/api-reference/peripherals/hmac.rst
@@ -221,6 +221,10 @@ HMAC 的第三种应用场景是将其作为密钥，启用软禁用的 JTAG 接
         // 计算 HMAC 失败
     }
 
+.. note::
+
+    ESP-HMAC 不透明 PSA 驱动基于单次硬件 HMAC 外设实现，该外设可以通过单次运算为完整消息计算消息认证码 (MAC)，但无法在多次调用之间保存或恢复运算中间状态。因此，该驱动不支持多分段流式运算：须在单次 :cpp:func:`psa_mac_compute` 调用中传入完整消息（如上所示），或仅执行一次多分段更新操作。若对同一 MAC 运算操作发起第二次非空更新，会返回 ``PSA_ERROR_BAD_STATE`` 错误，且该操作会直接失败并关闭，不会基于部分消息生成对应的 MAC 结果。
+
 API 参考
 -------------