1 /*
2 * SPDX-FileCopyrightText: 2020-2022 Espressif Systems (Shanghai) CO LTD
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
7 // #define LOG_LOCAL_LEVEL ESP_LOG_DEBUG
8
9 #include <stdlib.h>
10 #include <sys/cdefs.h>
11 #include "sdkconfig.h"
12 #include "esp_log.h"
13 #include "esp_check.h"
14 #include "esp_heap_caps.h"
15 #include "hal/gdma_hal.h"
16 #include "hal/gdma_ll.h"
17 #include "soc/gdma_periph.h"
18 #include "esp_private/gdma.h"
19 #include "esp_private/etm_interface.h"
20 #include "gdma_priv.h"
21
22 #define ETM_MEM_ALLOC_CAPS MALLOC_CAP_DEFAULT
23
24 static const char *TAG = "gdma-etm";
25
26 typedef struct gdma_etm_task_t {
27 esp_etm_task_t base;
28 gdma_channel_t *chan;
29 } gdma_etm_task_t;
30
gdma_del_etm_event(esp_etm_event_t * event)31 static esp_err_t gdma_del_etm_event(esp_etm_event_t *event)
32 {
33 free(event);
34 return ESP_OK;
35 }
36
gdma_del_etm_task(esp_etm_task_t * task)37 static esp_err_t gdma_del_etm_task(esp_etm_task_t *task)
38 {
39 gdma_etm_task_t *gdma_task = __containerof(task, gdma_etm_task_t, base);
40 gdma_channel_t *dma_chan = gdma_task->chan;
41 gdma_pair_t *pair = dma_chan->pair;
42 gdma_group_t *group = pair->group;
43 if (dma_chan->direction == GDMA_CHANNEL_DIRECTION_RX) {
44 gdma_ll_rx_enable_etm_task(group->hal.dev, pair->pair_id, false);
45 } else {
46 gdma_ll_tx_enable_etm_task(group->hal.dev, pair->pair_id, false);
47 }
48 free(gdma_task);
49 dma_chan->flags.start_stop_by_etm = false;
50 return ESP_OK;
51 }
52
gdma_new_etm_event(gdma_channel_handle_t dma_chan,const gdma_etm_event_config_t * config,esp_etm_event_handle_t * out_event)53 esp_err_t gdma_new_etm_event(gdma_channel_handle_t dma_chan, const gdma_etm_event_config_t *config, esp_etm_event_handle_t *out_event)
54 {
55 esp_etm_event_t *event = NULL;
56 esp_err_t ret = ESP_OK;
57 ESP_GOTO_ON_FALSE(dma_chan && config && out_event, ESP_ERR_INVALID_ARG, err, TAG, "invalid argument");
58 ESP_GOTO_ON_FALSE(config->event_type < GDMA_ETM_EVENT_MAX, ESP_ERR_INVALID_ARG, err, TAG, "invalid event type");
59 event = heap_caps_calloc(1, sizeof(esp_etm_event_t), ETM_MEM_ALLOC_CAPS);
60 ESP_GOTO_ON_FALSE(event, ESP_ERR_NO_MEM, err, TAG, "no memory for ETM event");
61
62 gdma_pair_t *pair = dma_chan->pair;
63 gdma_group_t *group = pair->group;
64 uint32_t event_id = 0;
65
66 if (dma_chan->direction == GDMA_CHANNEL_DIRECTION_RX) {
67 event_id = GDMA_LL_RX_ETM_EVENT_TABLE(group->group_id, pair->pair_id, config->event_type);
68 } else {
69 event_id = GDMA_LL_TX_ETM_EVENT_TABLE(group->group_id, pair->pair_id, config->event_type);
70 }
71 ESP_GOTO_ON_FALSE(event_id != 0, ESP_ERR_NOT_SUPPORTED, err, TAG, "not supported event type");
72
73 // fill the ETM event object
74 event->event_id = event_id;
75 event->trig_periph = ETM_TRIG_PERIPH_GDMA;
76 event->del = gdma_del_etm_event;
77 *out_event = event;
78 return ESP_OK;
79
80 err:
81 if (event) {
82 gdma_del_etm_event(event);
83 }
84 return ret;
85 }
86
gdma_new_etm_task(gdma_channel_handle_t dma_chan,const gdma_etm_task_config_t * config,esp_etm_task_handle_t * out_task)87 esp_err_t gdma_new_etm_task(gdma_channel_handle_t dma_chan, const gdma_etm_task_config_t *config, esp_etm_task_handle_t *out_task)
88 {
89 gdma_etm_task_t *task = NULL;
90 esp_err_t ret = ESP_OK;
91 ESP_GOTO_ON_FALSE(dma_chan && config && out_task, ESP_ERR_INVALID_ARG, err, TAG, "invalid argument");
92 ESP_GOTO_ON_FALSE(config->task_type < GDMA_ETM_TASK_MAX, ESP_ERR_INVALID_ARG, err, TAG, "invalid task type");
93 task = heap_caps_calloc(1, sizeof(gdma_etm_task_t), ETM_MEM_ALLOC_CAPS);
94 ESP_GOTO_ON_FALSE(task, ESP_ERR_NO_MEM, err, TAG, "no memory for ETM task");
95
96 gdma_pair_t *pair = dma_chan->pair;
97 gdma_group_t *group = pair->group;
98 uint32_t task_id = 0;
99
100 if (dma_chan->direction == GDMA_CHANNEL_DIRECTION_RX) {
101 task_id = GDMA_LL_RX_ETM_TASK_TABLE(group->group_id, pair->pair_id, config->task_type);
102 gdma_ll_rx_enable_etm_task(group->hal.dev, pair->pair_id, true);
103 } else {
104 task_id = GDMA_LL_TX_ETM_TASK_TABLE(group->group_id, pair->pair_id, config->task_type);
105 gdma_ll_tx_enable_etm_task(group->hal.dev, pair->pair_id, true);
106 }
107 ESP_GOTO_ON_FALSE(task_id != 0, ESP_ERR_NOT_SUPPORTED, err, TAG, "not supported task type");
108
109 // set a flag, now the GDMA channel is start/stop by ETM subsystem
110 dma_chan->flags.start_stop_by_etm = true;
111 // fill the ETM task object
112 task->chan = dma_chan;
113 task->base.task_id = task_id;
114 task->base.trig_periph = ETM_TRIG_PERIPH_GDMA;
115 task->base.del = gdma_del_etm_task;
116 *out_task = &(task->base);
117 return ESP_OK;
118
119 err:
120 if (task) {
121 gdma_del_etm_task(&task->base);
122 }
123 return ret;
124 }
125
