LXR linux/include/linux/dma/k3-psil.h

   1/* SPDX-License-Identifier: GPL-2.0 */
   2/*
   3 *  Copyright (C) 2019 Texas Instruments Incorporated - https://www.ti.com
   4 */
   5
   6#ifndef K3_PSIL_H_
   7#define K3_PSIL_H_
   8
   9#include <linux/types.h>
  10
  11#define K3_PSIL_DST_THREAD_ID_OFFSET 0x8000
  12
  13struct device;
  14
  15/**
  16 * enum udma_tp_level - Channel Throughput Levels
  17 * @UDMA_TP_NORMAL:     Normal channel
  18 * @UDMA_TP_HIGH:       High Throughput channel
  19 * @UDMA_TP_ULTRAHIGH:  Ultra High Throughput channel
  20 */
  21enum udma_tp_level {
  22        UDMA_TP_NORMAL = 0,
  23        UDMA_TP_HIGH,
  24        UDMA_TP_ULTRAHIGH,
  25        UDMA_TP_LAST,
  26};
  27
  28/**
  29 * enum psil_endpoint_type - PSI-L Endpoint type
  30 * @PSIL_EP_NATIVE:     Normal channel
  31 * @PSIL_EP_PDMA_XY:    XY mode PDMA
  32 * @PSIL_EP_PDMA_MCAN:  MCAN mode PDMA
  33 * @PSIL_EP_PDMA_AASRC: AASRC mode PDMA
  34 */
  35enum psil_endpoint_type {
  36        PSIL_EP_NATIVE = 0,
  37        PSIL_EP_PDMA_XY,
  38        PSIL_EP_PDMA_MCAN,
  39        PSIL_EP_PDMA_AASRC,
  40};
  41
  42/**
  43 * struct psil_endpoint_config - PSI-L Endpoint configuration
  44 * @ep_type:            PSI-L endpoint type
  45 * @channel_tpl:        Desired throughput level for the channel
  46 * @pkt_mode:           If set, the channel must be in Packet mode, otherwise in
  47 *                      TR mode
  48 * @notdpkt:            TDCM must be suppressed on the TX channel
  49 * @needs_epib:         Endpoint needs EPIB
  50 * @pdma_acc32:         ACC32 must be enabled on the PDMA side
  51 * @pdma_burst:         BURST must be enabled on the PDMA side
  52 * @psd_size:           If set, PSdata is used by the endpoint
  53 * @mapped_channel_id:  PKTDMA thread to channel mapping for mapped channels.
  54 *                      The thread must be serviced by the specified channel if
  55 *                      mapped_channel_id is >= 0 in case of PKTDMA
  56 * @flow_start:         PKDMA flow range start of mapped channel. Unmapped
  57 *                      channels use flow_id == chan_id
  58 * @flow_num:           PKDMA flow count of mapped channel. Unmapped channels
  59 *                      use flow_id == chan_id
  60 * @default_flow_id:    PKDMA default (r)flow index of mapped channel.
  61 *                      Must be within the flow range of the mapped channel.
  62 */
  63struct psil_endpoint_config {
  64        enum psil_endpoint_type ep_type;
  65        enum udma_tp_level channel_tpl;
  66
  67        unsigned pkt_mode:1;
  68        unsigned notdpkt:1;
  69        unsigned needs_epib:1;
  70        /* PDMA properties, valid for PSIL_EP_PDMA_* */
  71        unsigned pdma_acc32:1;
  72        unsigned pdma_burst:1;
  73
  74        u32 psd_size;
  75        /* PKDMA mapped channel */
  76        s16 mapped_channel_id;
  77        /* PKTDMA tflow and rflow ranges for mapped channel */
  78        u16 flow_start;
  79        u16 flow_num;
  80        s16 default_flow_id;
  81};
  82
  83int psil_set_new_ep_config(struct device *dev, const char *name,
  84                           struct psil_endpoint_config *ep_config);
  85
  86#endif /* K3_PSIL_H_ */
  87