pau: implement the pau regdma hal&ll layer for esp32c6

components/hal/CMakeLists.txt

@@ -131,6 +131,10 @@ if(NOT BOOTLOADER_BUILD)
         list(APPEND srcs "${target}/lp_timer_hal.c")
     endif()
 
+    if(CONFIG_SOC_PAU_SUPPORTED)
+        list(APPEND srcs "${target}/pau_hal.c")
+    endif()
+
     if(CONFIG_SOC_BOD_SUPPORTED)
         list(APPEND srcs "brownout_hal.c")
     endif()

components/hal/esp32c6/include/hal/pau_ll.h

@@ -0,0 +1,155 @@
+/*
+ * SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// The LL layer for ESP32-C6 PAU(Power Assist Unit) register operations
+
+#pragma once
+
+#include <stdlib.h>
+#include <stdbool.h>
+#include "soc/soc.h"
+#include "soc/pau_reg.h"
+#include "soc/pau_struct.h"
+#include "hal/pau_types.h"
+#include "hal/assert.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+static inline uint32_t pau_ll_get_regdma_backup_flow_error(pau_dev_t *dev)
+{
+    return dev->regdma_conf.flow_err;
+}
+
+static inline void pau_ll_select_regdma_entry_link(pau_dev_t *dev, int link)
+{
+    dev->regdma_conf.link_sel = link;
+}
+
+static inline void pau_ll_set_regdma_entry_link_backup_direction(pau_dev_t *dev, bool to_mem)
+{
+    dev->regdma_conf.to_mem = to_mem ? 1 : 0;
+}
+
+static inline void pau_ll_set_regdma_entry_link_backup_start_enable(pau_dev_t *dev)
+{
+    dev->regdma_conf.start = 1;
+}
+
+static inline void pau_ll_set_regdma_entry_link_backup_start_disable(pau_dev_t *dev)
+{
+    dev->regdma_conf.start = 0;
+}
+
+static inline void pau_ll_set_regdma_select_wifimac_link(pau_dev_t *dev)
+{
+    dev->regdma_conf.sel_mac = 1;
+}
+
+static inline void pau_ll_set_regdma_deselect_wifimac_link(pau_dev_t *dev)
+{
+    dev->regdma_conf.sel_mac = 0;
+}
+
+static inline void pau_ll_set_regdma_wifimac_link_backup_direction(pau_dev_t *dev, bool to_mem)
+{
+    dev->regdma_conf.to_mem_mac = to_mem ? 1 : 0;
+}
+
+static inline void pau_ll_set_regdma_wifimac_link_backup_start_enable(pau_dev_t *dev)
+{
+    dev->regdma_conf.start_mac = 1;
+}
+
+static inline void pau_ll_set_regdma_wifimac_link_backup_start_disable(pau_dev_t *dev)
+{
+    dev->regdma_conf.start_mac = 0;
+}
+
+static inline void pau_ll_set_regdma_link0_addr(pau_dev_t *dev, void *link_addr)
+{
+    dev->regdma_link_0_addr.val = (uint32_t)link_addr;
+}
+
+static inline void pau_ll_set_regdma_link1_addr(pau_dev_t *dev, void *link_addr)
+{
+    dev->regdma_link_1_addr.val = (uint32_t)link_addr;
+}
+
+static inline void pau_ll_set_regdma_link2_addr(pau_dev_t *dev, void *link_addr)
+{
+    dev->regdma_link_2_addr.val = (uint32_t)link_addr;
+}
+
+static inline void pau_ll_set_regdma_link3_addr(pau_dev_t *dev, void *link_addr)
+{
+    dev->regdma_link_3_addr.val = (uint32_t)link_addr;
+}
+
+static inline void pau_ll_set_regdma_wifimac_link_addr(pau_dev_t *dev, void *link_addr)
+{
+    dev->regdma_link_mac_addr.val = (uint32_t)link_addr;
+}
+
+static inline uint32_t pau_ll_get_regdma_current_link_addr(pau_dev_t *dev)
+{
+    return dev->regdma_current_link_addr.val;
+}
+
+static inline uint32_t pau_ll_get_regdma_backup_addr(pau_dev_t *dev)
+{
+    return dev->regdma_backup_addr.val;
+}
+
+static inline uint32_t pau_ll_get_regdma_memory_addr(pau_dev_t *dev)
+{
+    return dev->regdma_mem_addr.val;
+}
+
+static inline uint32_t pau_ll_get_regdma_intr_raw_signal(pau_dev_t *dev)
+{
+    return dev->int_raw.val;
+}
+
+static inline uint32_t pau_ll_get_regdma_intr_status(pau_dev_t *dev)
+{
+    return dev->int_st.val;
+}
+
+static inline void pau_ll_set_regdma_backup_done_intr_enable(pau_dev_t *dev)
+{
+    dev->int_ena.done_int_ena = 1;
+}
+
+static inline void pau_ll_set_regdma_backup_done_intr_disable(pau_dev_t *dev)
+{
+    dev->int_ena.done_int_ena = 0;
+}
+
+static inline void pau_ll_set_regdma_backup_error_intr_enable(pau_dev_t *dev)
+{
+    dev->int_ena.error_int_ena = 1;
+}
+
+static inline void pau_ll_set_regdma_backup_error_intr_disable(pau_dev_t *dev)
+{
+    dev->int_ena.error_int_ena = 0;
+}
+
+static inline void pau_ll_clear_regdma_backup_done_intr_state(pau_dev_t *dev)
+{
+    dev->int_clr.done_int_clr = 1;
+}
+
+static inline void pau_ll_clear_regdma_backup_error_intr_state(pau_dev_t *dev)
+{
+    dev->int_clr.error_int_clr = 1;
+}
+
+#ifdef __cplusplus
+}
+#endif

components/hal/esp32c6/pau_hal.c

@@ -0,0 +1,58 @@
+/*
+ * SPDX-FileCopyrightText: 2022-2023 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// The HAL layer for PAU (ESP32-C6 specific part)
+
+#include "soc/soc.h"
+#include "esp_attr.h"
+#include "hal/pau_hal.h"
+#include "hal/pau_types.h"
+
+void pau_hal_set_regdma_entry_link_addr(pau_hal_context_t *hal, pau_regdma_link_addr_t *link_addr)
+{
+    pau_ll_set_regdma_link0_addr(hal->dev, (*link_addr)[0]);
+    pau_ll_set_regdma_link1_addr(hal->dev, (*link_addr)[1]);
+    pau_ll_set_regdma_link2_addr(hal->dev, (*link_addr)[2]);
+    /* The link 3 of REGDMA is reserved, PMU state switching will not use
+     * REGDMA link 3 */
+}
+
+void pau_hal_start_regdma_modem_link(pau_hal_context_t *hal, bool backup_or_restore)
+{
+    pau_ll_clear_regdma_backup_done_intr_state(hal->dev);
+    pau_ll_set_regdma_select_wifimac_link(hal->dev);
+    pau_ll_set_regdma_wifimac_link_backup_direction(hal->dev, backup_or_restore);
+    pau_ll_set_regdma_wifimac_link_backup_start_enable(hal->dev);
+
+    while (!(pau_ll_get_regdma_intr_raw_signal(hal->dev) & PAU_DONE_INT_RAW));
+}
+
+void pau_hal_stop_regdma_modem_link(pau_hal_context_t *hal)
+{
+    pau_ll_set_regdma_wifimac_link_backup_start_disable(hal->dev);
+    pau_ll_set_regdma_deselect_wifimac_link(hal->dev);
+    pau_ll_clear_regdma_backup_done_intr_state(hal->dev);
+}
+
+void pau_hal_start_regdma_extra_link(pau_hal_context_t *hal, bool backup_or_restore)
+{
+    pau_ll_clear_regdma_backup_done_intr_state(hal->dev);
+    /* The link 3 of REGDMA is reserved, we use it as an extra linked list to
+     * provide backup and restore services for BLE, IEEE802.15.4 and possibly
+     * other modules */
+    pau_ll_select_regdma_entry_link(hal->dev, 3);
+    pau_ll_set_regdma_entry_link_backup_direction(hal->dev, true);
+    pau_ll_set_regdma_entry_link_backup_start_enable(hal->dev);
+
+    while (!(pau_ll_get_regdma_intr_raw_signal(hal->dev) & PAU_DONE_INT_RAW));
+}
+
+void pau_hal_stop_regdma_extra_link(pau_hal_context_t *hal)
+{
+    pau_ll_set_regdma_entry_link_backup_start_disable(hal->dev);
+    pau_ll_select_regdma_entry_link(hal->dev, 0); /* restore link select to default */
+    pau_ll_clear_regdma_backup_done_intr_state(hal->dev);
+}

components/hal/include/hal/pau_hal.h

@@ -0,0 +1,79 @@
+/*
+ * SPDX-FileCopyrightText: 2022-2023 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// The HAL layer for PAU (Power Assist Unit)
+
+#pragma once
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "soc/soc_caps.h"
+#include "hal/pau_ll.h"
+#include "hal/pau_types.h"
+
+typedef struct {
+    pau_dev_t *dev;
+} pau_hal_context_t;
+
+/**
+ * @brief Set regdma entry link address
+ *
+ * @param hal           regdma hal context
+ * @param link_addr     entry link address value
+ */
+void pau_hal_set_regdma_entry_link_addr(pau_hal_context_t *hal, pau_regdma_link_addr_t *link_addr);
+
+/**
+ * @brief Set regdma modem link address
+ *
+ * @param hal           regdma hal context
+ * @param link_addr     modem link address value
+ */
+#define pau_hal_set_regdma_modem_link_addr(hal, addr)   pau_ll_set_regdma_wifimac_link_addr((hal)->dev, (addr))
+
+/**
+ * @brief Start transmission on regdma modem link
+ *
+ * @param hal           regdma hal context
+ * @param backup_or_restore        false:restore true:backup
+ */
+void pau_hal_start_regdma_modem_link(pau_hal_context_t *hal, bool backup_or_restore);
+
+/**
+ * @brief Stop transmission on regdma modem link
+ *
+ * @param hal           regdma hal context
+ */
+void pau_hal_stop_regdma_modem_link(pau_hal_context_t *hal);
+
+/**
+ * @brief Set regdma extra link address
+ *
+ * @param hal           regdma hal context
+ * @param link_addr     extra link address value
+ */
+#define pau_hal_set_regdma_extra_link_addr(hal, addr)   pau_ll_set_regdma_link3_addr(hal->dev, (addr))
+
+/**
+ * @brief Start transmission on regdma extra link
+ *
+ * @param hal           regdma hal context
+ * @param backup_or_restore        false:restore true:backup
+ */
+void pau_hal_start_regdma_extra_link(pau_hal_context_t *hal, bool backup_or_restore);
+
+/**
+ * @brief Stop transmission on regdma extra link
+ *
+ * @param hal           regdma hal context
+ */
+void pau_hal_stop_regdma_extra_link(pau_hal_context_t *hal);
+
+#ifdef __cplusplus
+}
+#endif

components/hal/include/hal/pau_types.h

@@ -0,0 +1,16 @@
+/*
+ * SPDX-FileCopyrightText: 2020-2022 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+#pragma once
+
+#include "sdkconfig.h"
+#include "soc/soc_caps.h"
+
+#define PAU_REGDMA_LINK_NUM     (SOC_PM_PAU_LINK_NUM)
+
+/**
+ * @brief PAU REGDMA all link address buffer
+ */
+typedef void * pau_regdma_link_addr_t[PAU_REGDMA_LINK_NUM];