k3-udma-glue.h 5.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. /*
  3. * Copyright (C) 2019 Texas Instruments Incorporated - https://www.ti.com
  4. */
  5. #ifndef K3_UDMA_GLUE_H_
  6. #define K3_UDMA_GLUE_H_
  7. #include <linux/types.h>
  8. #include <linux/soc/ti/k3-ringacc.h>
  9. #include <linux/dma/ti-cppi5.h>
  10. struct k3_udma_glue_tx_channel_cfg {
  11. struct k3_ring_cfg tx_cfg;
  12. struct k3_ring_cfg txcq_cfg;
  13. bool tx_pause_on_err;
  14. bool tx_filt_einfo;
  15. bool tx_filt_pswords;
  16. bool tx_supr_tdpkt;
  17. u32 swdata_size;
  18. };
  19. struct k3_udma_glue_tx_channel;
  20. struct k3_udma_glue_tx_channel *k3_udma_glue_request_tx_chn(struct device *dev,
  21. const char *name, struct k3_udma_glue_tx_channel_cfg *cfg);
  22. void k3_udma_glue_release_tx_chn(struct k3_udma_glue_tx_channel *tx_chn);
  23. int k3_udma_glue_push_tx_chn(struct k3_udma_glue_tx_channel *tx_chn,
  24. struct cppi5_host_desc_t *desc_tx,
  25. dma_addr_t desc_dma);
  26. int k3_udma_glue_pop_tx_chn(struct k3_udma_glue_tx_channel *tx_chn,
  27. dma_addr_t *desc_dma);
  28. int k3_udma_glue_enable_tx_chn(struct k3_udma_glue_tx_channel *tx_chn);
  29. void k3_udma_glue_disable_tx_chn(struct k3_udma_glue_tx_channel *tx_chn);
  30. void k3_udma_glue_tdown_tx_chn(struct k3_udma_glue_tx_channel *tx_chn,
  31. bool sync);
  32. void k3_udma_glue_reset_tx_chn(struct k3_udma_glue_tx_channel *tx_chn,
  33. void *data, void (*cleanup)(void *data, dma_addr_t desc_dma));
  34. u32 k3_udma_glue_tx_get_hdesc_size(struct k3_udma_glue_tx_channel *tx_chn);
  35. u32 k3_udma_glue_tx_get_txcq_id(struct k3_udma_glue_tx_channel *tx_chn);
  36. int k3_udma_glue_tx_get_irq(struct k3_udma_glue_tx_channel *tx_chn);
  37. struct device *
  38. k3_udma_glue_tx_get_dma_device(struct k3_udma_glue_tx_channel *tx_chn);
  39. void k3_udma_glue_tx_dma_to_cppi5_addr(struct k3_udma_glue_tx_channel *tx_chn,
  40. dma_addr_t *addr);
  41. void k3_udma_glue_tx_cppi5_to_dma_addr(struct k3_udma_glue_tx_channel *tx_chn,
  42. dma_addr_t *addr);
  43. enum {
  44. K3_UDMA_GLUE_SRC_TAG_LO_KEEP = 0,
  45. K3_UDMA_GLUE_SRC_TAG_LO_USE_FLOW_REG = 1,
  46. K3_UDMA_GLUE_SRC_TAG_LO_USE_REMOTE_FLOW_ID = 2,
  47. K3_UDMA_GLUE_SRC_TAG_LO_USE_REMOTE_SRC_TAG = 4,
  48. };
  49. /**
  50. * k3_udma_glue_rx_flow_cfg - UDMA RX flow cfg
  51. *
  52. * @rx_cfg: RX ring configuration
  53. * @rxfdq_cfg: RX free Host PD ring configuration
  54. * @ring_rxq_id: RX ring id (or -1 for any)
  55. * @ring_rxfdq0_id: RX free Host PD ring (FDQ) if (or -1 for any)
  56. * @rx_error_handling: Rx Error Handling Mode (0 - drop, 1 - re-try)
  57. * @src_tag_lo_sel: Rx Source Tag Low Byte Selector in Host PD
  58. */
  59. struct k3_udma_glue_rx_flow_cfg {
  60. struct k3_ring_cfg rx_cfg;
  61. struct k3_ring_cfg rxfdq_cfg;
  62. int ring_rxq_id;
  63. int ring_rxfdq0_id;
  64. bool rx_error_handling;
  65. int src_tag_lo_sel;
  66. };
  67. /**
  68. * k3_udma_glue_rx_channel_cfg - UDMA RX channel cfg
  69. *
  70. * @psdata_size: SW Data is present in Host PD of @swdata_size bytes
  71. * @flow_id_base: first flow_id used by channel.
  72. * if @flow_id_base = -1 - range of GP rflows will be
  73. * allocated dynamically.
  74. * @flow_id_num: number of RX flows used by channel
  75. * @flow_id_use_rxchan_id: use RX channel id as flow id,
  76. * used only if @flow_id_num = 1
  77. * @remote indication that RX channel is remote - some remote CPU
  78. * core owns and control the RX channel. Linux Host only
  79. * allowed to attach and configure RX Flow within RX
  80. * channel. if set - not RX channel operation will be
  81. * performed by K3 NAVSS DMA glue interface.
  82. * @def_flow_cfg default RX flow configuration,
  83. * used only if @flow_id_num = 1
  84. */
  85. struct k3_udma_glue_rx_channel_cfg {
  86. u32 swdata_size;
  87. int flow_id_base;
  88. int flow_id_num;
  89. bool flow_id_use_rxchan_id;
  90. bool remote;
  91. struct k3_udma_glue_rx_flow_cfg *def_flow_cfg;
  92. };
  93. struct k3_udma_glue_rx_channel;
  94. struct k3_udma_glue_rx_channel *k3_udma_glue_request_rx_chn(
  95. struct device *dev,
  96. const char *name,
  97. struct k3_udma_glue_rx_channel_cfg *cfg);
  98. void k3_udma_glue_release_rx_chn(struct k3_udma_glue_rx_channel *rx_chn);
  99. int k3_udma_glue_enable_rx_chn(struct k3_udma_glue_rx_channel *rx_chn);
  100. void k3_udma_glue_disable_rx_chn(struct k3_udma_glue_rx_channel *rx_chn);
  101. void k3_udma_glue_tdown_rx_chn(struct k3_udma_glue_rx_channel *rx_chn,
  102. bool sync);
  103. int k3_udma_glue_push_rx_chn(struct k3_udma_glue_rx_channel *rx_chn,
  104. u32 flow_num, struct cppi5_host_desc_t *desc_tx,
  105. dma_addr_t desc_dma);
  106. int k3_udma_glue_pop_rx_chn(struct k3_udma_glue_rx_channel *rx_chn,
  107. u32 flow_num, dma_addr_t *desc_dma);
  108. int k3_udma_glue_rx_flow_init(struct k3_udma_glue_rx_channel *rx_chn,
  109. u32 flow_idx, struct k3_udma_glue_rx_flow_cfg *flow_cfg);
  110. u32 k3_udma_glue_rx_flow_get_fdq_id(struct k3_udma_glue_rx_channel *rx_chn,
  111. u32 flow_idx);
  112. u32 k3_udma_glue_rx_get_flow_id_base(struct k3_udma_glue_rx_channel *rx_chn);
  113. int k3_udma_glue_rx_get_irq(struct k3_udma_glue_rx_channel *rx_chn,
  114. u32 flow_num);
  115. void k3_udma_glue_rx_put_irq(struct k3_udma_glue_rx_channel *rx_chn,
  116. u32 flow_num);
  117. void k3_udma_glue_reset_rx_chn(struct k3_udma_glue_rx_channel *rx_chn,
  118. u32 flow_num, void *data,
  119. void (*cleanup)(void *data, dma_addr_t desc_dma),
  120. bool skip_fdq);
  121. int k3_udma_glue_rx_flow_enable(struct k3_udma_glue_rx_channel *rx_chn,
  122. u32 flow_idx);
  123. int k3_udma_glue_rx_flow_disable(struct k3_udma_glue_rx_channel *rx_chn,
  124. u32 flow_idx);
  125. struct device *
  126. k3_udma_glue_rx_get_dma_device(struct k3_udma_glue_rx_channel *rx_chn);
  127. void k3_udma_glue_rx_dma_to_cppi5_addr(struct k3_udma_glue_rx_channel *rx_chn,
  128. dma_addr_t *addr);
  129. void k3_udma_glue_rx_cppi5_to_dma_addr(struct k3_udma_glue_rx_channel *rx_chn,
  130. dma_addr_t *addr);
  131. #endif /* K3_UDMA_GLUE_H_ */