feat(dma2d,ppa): Support flash encryption for DMA2D and PPA

docs/zh_CN/api-reference/peripherals/ppa.rst

@@ -44,6 +44,7 @@
 - :ref:`ppa-client-registration` - 涵盖如何注册 PPA 客户端来执行一切 PPA 操作。
 - :ref:`ppa-register-callback` - 涵盖如何将用户特定代码挂接到 PPA 驱动程序事件回调函数。
 - :ref:`ppa-perform-operation` - 涵盖如何执行 PPA 操作。
+- :ref:`ppa-buffer-alignment` - 涵盖 PPA 输入和输出缓冲区的内存对齐要求。
 - :ref:`ppa-thread-safety`- 涵盖在线程安全方面使用 PPA 操作 API 的情况。
 - :ref:`ppa-performance-overview` - 涵盖 PPA 操作的性能。
 
@@ -129,6 +130,28 @@ PPA 操作包括：
 
 :cpp:type:`ppa_trans_mode_t` 为可配置字段，适用于所有 PPA 操作 API。可以配置该字段，在调用 PPA 操作 API 时等待操作完成后再返回，或者在事务推送到内部队列后立即返回。
 
+.. _ppa-buffer-alignment:
+
+缓存区对齐要求
+^^^^^^^^^^^^^^
+
+PPA 缓存区需要满足以下对齐要求，以确保存储器访问的正确性：
+
+- 缓冲行对齐（仅针对输出缓存区）：
+
+    - ``out.buffer`` 地址和 ``out.buffer_size`` 大小必须与缓冲行大小对齐（请参阅 Kconfig 选项 :ref:`CONFIG_CACHE_L2_CACHE_LINE_SIZE`）。
+
+- 存储加密对齐（当存储加密启用且缓冲区位于外部存储空间时）：
+
+    - 块的字节宽度必须与 {IDF_TARGET_SOC_MEMSPI_ENCRYPTION_ALIGNMENT} 字节对齐。
+    - 块每行的起始地址必须与 {IDF_TARGET_SOC_MEMSPI_ENCRYPTION_ALIGNMENT} 字节对齐。
+
+    此外，当访问加密外部存储空间时，PPA 的 DMA 数据突发长度必须大于或等于 {IDF_TARGET_SOC_MEMSPI_ENCRYPTION_ALIGNMENT} 字节。如果配置的突发长度小于该值，驱动程序将自动增加到满足该要求。
+
+    .. warning::
+
+        SRM 引擎以宏块为单位处理图片，而宏块的对齐无法受到控制，因此如果缓冲区位于外部存储空间，则 SRM 操作在存储加密的情况下无法正常工作。
+
 .. _ppa-thread-safety:
 
 线程安全