Merge branch 'docs/add_cn_trans_for_hmac' into 'master'

docs: Update hmac CN translation Closes DOC-14950 See merge request espressif/esp-idf!49909
2026-08-18 06:35:35 +03:00 · 2026-06-24 15:28:06 +08:00
parent 005dd1ba8c 1391610566
commit c99ca2ee41
1 changed files with 4 additions and 0 deletions
--- 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 参考
 -------------