1636 lines
46 KiB
C
1636 lines
46 KiB
C
/* Copyright (c) 2011-2015, The Linux Foundation. All rights reserved.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License version 2 and
|
|
* only version 2 as published by the Free Software Foundation.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*/
|
|
|
|
/* Smart-Peripheral-Switch (SPS) API. */
|
|
|
|
#ifndef _SPS_H_
|
|
#define _SPS_H_
|
|
|
|
#include <linux/types.h> /* u32 */
|
|
|
|
#if defined(CONFIG_PHYS_ADDR_T_64BIT) || defined(CONFIG_ARM_LPAE)
|
|
|
|
/* Returns upper 4bits of 36bits physical address */
|
|
#define SPS_GET_UPPER_ADDR(addr) ((addr & 0xF00000000ULL) >> 32)
|
|
|
|
/* Returns 36bits physical address from 32bit address &
|
|
* flags word */
|
|
#define DESC_FULL_ADDR(flags, addr) ((((phys_addr_t)flags & 0xF) << 32) | addr)
|
|
|
|
/* Returns flags word with flags and 4bit upper address
|
|
* from flags and 36bit physical address */
|
|
#define DESC_FLAG_WORD(flags, addr) (((addr & 0xF00000000ULL) >> 32) | flags)
|
|
|
|
#else
|
|
|
|
#define SPS_GET_UPPER_ADDR(addr) (0)
|
|
#define DESC_FULL_ADDR(flags, addr) (addr)
|
|
#define DESC_FLAG_WORD(flags, addr) (flags)
|
|
|
|
#endif
|
|
|
|
/* Returns upper 4bits of 36bits physical address from
|
|
* flags word */
|
|
#define DESC_UPPER_ADDR(flags) ((flags & 0xF))
|
|
|
|
/* Returns lower 32bits of 36bits physical address */
|
|
#define SPS_GET_LOWER_ADDR(addr) ((u32)(addr & 0xFFFFFFFF))
|
|
|
|
/* SPS device handle indicating use of system memory */
|
|
#define SPS_DEV_HANDLE_MEM (~0x0ul>>1)
|
|
|
|
/* SPS device handle indicating use of BAM-DMA */
|
|
|
|
/* SPS device handle invalid value */
|
|
#define SPS_DEV_HANDLE_INVALID ((unsigned long)0)
|
|
|
|
/* BAM invalid IRQ value */
|
|
#define SPS_IRQ_INVALID 0
|
|
|
|
/* Invalid address value */
|
|
#define SPS_ADDR_INVALID ((unsigned long)0xDEADBEEF)
|
|
|
|
/* Invalid peripheral device enumeration class */
|
|
#define SPS_CLASS_INVALID ((unsigned long)-1)
|
|
|
|
/*
|
|
* This value specifies different configurations for an SPS connection.
|
|
* A non-default value instructs the SPS driver to search for the configuration
|
|
* in the fixed connection mapping table.
|
|
*/
|
|
#define SPS_CONFIG_DEFAULT 0
|
|
|
|
/*
|
|
* This value instructs the SPS driver to use the default BAM-DMA channel
|
|
* threshold
|
|
*/
|
|
#define SPS_DMA_THRESHOLD_DEFAULT 0
|
|
|
|
/* Flag bits supported by SPS hardware for struct sps_iovec */
|
|
#define SPS_IOVEC_FLAG_INT 0x8000 /* Generate interrupt */
|
|
#define SPS_IOVEC_FLAG_EOT 0x4000 /* Generate end-of-transfer indication */
|
|
#define SPS_IOVEC_FLAG_EOB 0x2000 /* Generate end-of-block indication */
|
|
#define SPS_IOVEC_FLAG_NWD 0x1000 /* notify when done */
|
|
#define SPS_IOVEC_FLAG_CMD 0x0800 /* command descriptor */
|
|
#define SPS_IOVEC_FLAG_LOCK 0x0400 /* pipe lock */
|
|
#define SPS_IOVEC_FLAG_UNLOCK 0x0200 /* pipe unlock */
|
|
#define SPS_IOVEC_FLAG_IMME 0x0100 /* immediate command descriptor */
|
|
#define SPS_IOVEC_FLAG_NO_SUBMIT 0x0020 /* Do not submit descriptor to HW */
|
|
#define SPS_IOVEC_FLAG_DEFAULT 0x0010 /* Use driver default */
|
|
|
|
/* Maximum descriptor/iovec size */
|
|
#define SPS_IOVEC_MAX_SIZE (32 * 1024 - 1) /* 32K-1 bytes due to HW limit */
|
|
|
|
/* BAM device options flags */
|
|
|
|
/*
|
|
* BAM will be configured and enabled at boot. Otherwise, BAM will be
|
|
* configured and enabled when first pipe connect occurs.
|
|
*/
|
|
#define SPS_BAM_OPT_ENABLE_AT_BOOT 1UL
|
|
/* BAM IRQ is disabled */
|
|
#define SPS_BAM_OPT_IRQ_DISABLED (1UL << 1)
|
|
/* BAM peripheral is a BAM-DMA */
|
|
#define SPS_BAM_OPT_BAMDMA (1UL << 2)
|
|
/* BAM IRQ is registered for apps wakeup */
|
|
#define SPS_BAM_OPT_IRQ_WAKEUP (1UL << 3)
|
|
/* Ignore external block pipe reset */
|
|
#define SPS_BAM_NO_EXT_P_RST (1UL << 4)
|
|
/* Don't enable local clock gating */
|
|
#define SPS_BAM_NO_LOCAL_CLK_GATING (1UL << 5)
|
|
/* Don't enable writeback cancel*/
|
|
#define SPS_BAM_CANCEL_WB (1UL << 6)
|
|
/* BAM uses SMMU */
|
|
#define SPS_BAM_SMMU_EN (1UL << 9)
|
|
/* Confirm resource status before access BAM*/
|
|
#define SPS_BAM_RES_CONFIRM (1UL << 7)
|
|
/* Hold memory for BAM DMUX */
|
|
#define SPS_BAM_HOLD_MEM (1UL << 8)
|
|
/* Use cached write pointer */
|
|
#define SPS_BAM_CACHED_WP (1UL << 10)
|
|
|
|
/* BAM device management flags */
|
|
|
|
/* BAM global device control is managed remotely */
|
|
#define SPS_BAM_MGR_DEVICE_REMOTE 1UL
|
|
/* BAM device supports multiple execution environments */
|
|
#define SPS_BAM_MGR_MULTI_EE (1UL << 1)
|
|
/* BAM pipes are *not* allocated locally */
|
|
#define SPS_BAM_MGR_PIPE_NO_ALLOC (1UL << 2)
|
|
/* BAM pipes are *not* configured locally */
|
|
#define SPS_BAM_MGR_PIPE_NO_CONFIG (1UL << 3)
|
|
/* BAM pipes are *not* controlled locally */
|
|
#define SPS_BAM_MGR_PIPE_NO_CTRL (1UL << 4)
|
|
/* "Globbed" management properties */
|
|
#define SPS_BAM_MGR_NONE \
|
|
(SPS_BAM_MGR_DEVICE_REMOTE | SPS_BAM_MGR_PIPE_NO_ALLOC | \
|
|
SPS_BAM_MGR_PIPE_NO_CONFIG | SPS_BAM_MGR_PIPE_NO_CTRL)
|
|
#define SPS_BAM_MGR_LOCAL 0
|
|
#define SPS_BAM_MGR_LOCAL_SHARED SPS_BAM_MGR_MULTI_EE
|
|
#define SPS_BAM_MGR_REMOTE_SHARED \
|
|
(SPS_BAM_MGR_DEVICE_REMOTE | SPS_BAM_MGR_MULTI_EE | \
|
|
SPS_BAM_MGR_PIPE_NO_ALLOC)
|
|
#define SPS_BAM_MGR_ACCESS_MASK SPS_BAM_MGR_NONE
|
|
|
|
/*
|
|
* BAM security configuration
|
|
*/
|
|
#define SPS_BAM_NUM_EES 4
|
|
#define SPS_BAM_SEC_DO_NOT_CONFIG 0
|
|
#define SPS_BAM_SEC_DO_CONFIG 0x0A434553
|
|
|
|
/* BAM pipe selection */
|
|
#define SPS_BAM_PIPE(n) (1UL << (n))
|
|
|
|
/* This enum specifies the operational mode for an SPS connection */
|
|
enum sps_mode {
|
|
SPS_MODE_SRC = 0, /* end point is the source (producer) */
|
|
SPS_MODE_DEST, /* end point is the destination (consumer) */
|
|
};
|
|
|
|
|
|
/*
|
|
* This enum is a set of bit flag options for SPS connection.
|
|
* The enums should be OR'd together to create the option set
|
|
* for the SPS connection.
|
|
*/
|
|
enum sps_option {
|
|
/*
|
|
* Options to enable specific SPS hardware interrupts.
|
|
* These bit flags are also used to indicate interrupt source
|
|
* for the SPS_EVENT_IRQ event.
|
|
*/
|
|
SPS_O_DESC_DONE = 0x00000001, /* Descriptor processed */
|
|
SPS_O_INACTIVE = 0x00000002, /* Inactivity timeout */
|
|
SPS_O_WAKEUP = 0x00000004, /* Peripheral wake up */
|
|
SPS_O_OUT_OF_DESC = 0x00000008,/* Out of descriptors */
|
|
SPS_O_ERROR = 0x00000010, /* Error */
|
|
SPS_O_EOT = 0x00000020, /* End-of-transfer */
|
|
SPS_O_RST_ERROR = 0x00000040, /* Pipe reset unsucessful error */
|
|
SPS_O_HRESP_ERROR = 0x00000080,/* Errorneous Hresponse by AHB MASTER */
|
|
|
|
/* Options to enable hardware features */
|
|
SPS_O_STREAMING = 0x00010000, /* Enable streaming mode (no EOT) */
|
|
/* Use MTI/SETPEND instead of BAM interrupt */
|
|
SPS_O_IRQ_MTI = 0x00020000,
|
|
/* NWD bit written with EOT for BAM2BAM producer pipe */
|
|
SPS_O_WRITE_NWD = 0x00040000,
|
|
/* EOT set after pipe SW offset advanced */
|
|
SPS_O_LATE_EOT = 0x00080000,
|
|
|
|
/* Options to enable software features */
|
|
/* Do not disable a pipe during disconnection */
|
|
SPS_O_NO_DISABLE = 0x00800000,
|
|
/* Transfer operation should be polled */
|
|
SPS_O_POLL = 0x01000000,
|
|
/* Disable queuing of transfer events for the connection end point */
|
|
SPS_O_NO_Q = 0x02000000,
|
|
SPS_O_FLOWOFF = 0x04000000, /* Graceful halt */
|
|
/* SPS_O_WAKEUP will be disabled after triggered */
|
|
SPS_O_WAKEUP_IS_ONESHOT = 0x08000000,
|
|
/**
|
|
* Client must read each descriptor from the FIFO
|
|
* using sps_get_iovec()
|
|
*/
|
|
SPS_O_ACK_TRANSFERS = 0x10000000,
|
|
/* Connection is automatically enabled */
|
|
SPS_O_AUTO_ENABLE = 0x20000000,
|
|
/* DISABLE endpoint synchronization for config/enable/disable */
|
|
SPS_O_NO_EP_SYNC = 0x40000000,
|
|
/* Allow partial polling duing IRQ mode */
|
|
SPS_O_HYBRID = 0x80000000,
|
|
};
|
|
|
|
/**
|
|
* This enum specifies BAM DMA channel priority. Clients should use
|
|
* SPS_DMA_PRI_DEFAULT unless a specific priority is required.
|
|
*/
|
|
enum sps_dma_priority {
|
|
SPS_DMA_PRI_DEFAULT = 0,
|
|
SPS_DMA_PRI_LOW,
|
|
SPS_DMA_PRI_MED,
|
|
SPS_DMA_PRI_HIGH,
|
|
};
|
|
|
|
/*
|
|
* This enum specifies the ownership of a connection resource.
|
|
* Remote or shared ownership is only possible/meaningful on the processor
|
|
* that controls resource.
|
|
*/
|
|
enum sps_owner {
|
|
SPS_OWNER_LOCAL = 0x1, /* Resource is owned by local processor */
|
|
SPS_OWNER_REMOTE = 0x2, /* Resource is owned by a satellite processor */
|
|
};
|
|
|
|
/* This enum indicates the event associated with a client event trigger */
|
|
enum sps_event {
|
|
SPS_EVENT_INVALID = 0,
|
|
|
|
SPS_EVENT_EOT, /* End-of-transfer */
|
|
SPS_EVENT_DESC_DONE, /* Descriptor processed */
|
|
SPS_EVENT_OUT_OF_DESC, /* Out of descriptors */
|
|
SPS_EVENT_WAKEUP, /* Peripheral wake up */
|
|
SPS_EVENT_FLOWOFF, /* Graceful halt (idle) */
|
|
SPS_EVENT_INACTIVE, /* Inactivity timeout */
|
|
SPS_EVENT_ERROR, /* Error */
|
|
SPS_EVENT_RST_ERROR, /* Pipe Reset unsuccessful */
|
|
SPS_EVENT_HRESP_ERROR, /* Errorneous Hresponse by AHB Master*/
|
|
SPS_EVENT_MAX,
|
|
};
|
|
|
|
/*
|
|
* This enum specifies the event trigger mode and is an argument for the
|
|
* sps_register_event() function.
|
|
*/
|
|
enum sps_trigger {
|
|
/* Trigger with payload for callback */
|
|
SPS_TRIGGER_CALLBACK = 0,
|
|
/* Trigger without payload for wait or poll */
|
|
SPS_TRIGGER_WAIT,
|
|
};
|
|
|
|
/*
|
|
* This enum indicates the desired halting mechanism and is an argument for the
|
|
* sps_flow_off() function
|
|
*/
|
|
enum sps_flow_off {
|
|
SPS_FLOWOFF_FORCED = 0, /* Force hardware into halt state */
|
|
/* Allow hardware to empty pipe before halting */
|
|
SPS_FLOWOFF_GRACEFUL,
|
|
};
|
|
|
|
/*
|
|
* This enum indicates the target memory heap and is an argument for the
|
|
* sps_mem_alloc() function.
|
|
*/
|
|
enum sps_mem {
|
|
SPS_MEM_LOCAL = 0, /* SPS subsystem local (pipe) memory */
|
|
SPS_MEM_UC, /* Microcontroller (ARM7) local memory */
|
|
};
|
|
|
|
/*
|
|
* This enum indicates a timer control operation and is an argument for the
|
|
* sps_timer_ctrl() function.
|
|
*/
|
|
enum sps_timer_op {
|
|
SPS_TIMER_OP_CONFIG = 0,
|
|
SPS_TIMER_OP_RESET,
|
|
/* SPS_TIMER_OP_START, Not supported by hardware yet */
|
|
/* SPS_TIMER_OP_STOP, Not supported by hardware yet */
|
|
SPS_TIMER_OP_READ,
|
|
};
|
|
|
|
/*
|
|
* This enum indicates the inactivity timer operating mode and is an
|
|
* argument for the sps_timer_ctrl() function.
|
|
*/
|
|
enum sps_timer_mode {
|
|
SPS_TIMER_MODE_ONESHOT = 0,
|
|
/* SPS_TIMER_MODE_PERIODIC, Not supported by hardware yet */
|
|
};
|
|
|
|
/* This enum indicates the cases when callback the user of BAM */
|
|
enum sps_callback_case {
|
|
SPS_CALLBACK_BAM_ERROR_IRQ = 1, /* BAM ERROR IRQ */
|
|
SPS_CALLBACK_BAM_HRESP_ERR_IRQ, /* Erroneous HResponse */
|
|
SPS_CALLBACK_BAM_TIMER_IRQ, /* Inactivity timer */
|
|
SPS_CALLBACK_BAM_RES_REQ, /* Request resource */
|
|
SPS_CALLBACK_BAM_RES_REL, /* Release resource */
|
|
SPS_CALLBACK_BAM_POLL, /* To poll each pipe */
|
|
};
|
|
|
|
/*
|
|
* This enum indicates the command type in a command element
|
|
*/
|
|
enum sps_command_type {
|
|
SPS_WRITE_COMMAND = 0,
|
|
SPS_READ_COMMAND,
|
|
};
|
|
|
|
/**
|
|
* struct msm_sps_platform_data - SPS Platform specific data.
|
|
* @bamdma_restricted_pipes - Bitmask of pipes restricted from local use.
|
|
*
|
|
*/
|
|
struct msm_sps_platform_data {
|
|
u32 bamdma_restricted_pipes;
|
|
};
|
|
|
|
/**
|
|
* This data type corresponds to the native I/O vector (BAM descriptor)
|
|
* supported by SPS hardware
|
|
*
|
|
* @addr - Buffer physical address.
|
|
* @size - Buffer size in bytes.
|
|
* @flags -Flag bitmask (see SPS_IOVEC_FLAG_ #defines).
|
|
*
|
|
*/
|
|
struct sps_iovec {
|
|
u32 addr;
|
|
u32 size:16;
|
|
u32 flags:16;
|
|
};
|
|
|
|
/**
|
|
* This data type corresponds to the native Command Element
|
|
* supported by SPS hardware
|
|
*
|
|
* @addr - register address.
|
|
* @command - command type.
|
|
* @data - for write command: content to be written into peripheral register.
|
|
* for read command: dest addr to write peripheral register value to.
|
|
* @mask - register mask.
|
|
* @reserved - for future usage.
|
|
*
|
|
*/
|
|
struct sps_command_element {
|
|
u32 addr:24;
|
|
u32 command:8;
|
|
u32 data;
|
|
u32 mask;
|
|
u32 reserved;
|
|
};
|
|
|
|
/*
|
|
* BAM device's security configuation
|
|
*/
|
|
struct sps_bam_pipe_sec_config_props {
|
|
u32 pipe_mask;
|
|
u32 vmid;
|
|
};
|
|
|
|
struct sps_bam_sec_config_props {
|
|
/* Per-EE configuration - This is a pipe bit mask for each EE */
|
|
struct sps_bam_pipe_sec_config_props ees[SPS_BAM_NUM_EES];
|
|
};
|
|
|
|
/**
|
|
* This struct defines a BAM device. The client must memset() this struct to
|
|
* zero before writing device information. A value of zero for uninitialized
|
|
* values will instruct the SPS driver to use general defaults or
|
|
* hardware/BIOS supplied values.
|
|
*
|
|
*
|
|
* @options - See SPS_BAM_OPT_* bit flag.
|
|
* @phys_addr - BAM base physical address (not peripheral address).
|
|
* @virt_addr - BAM base virtual address.
|
|
* @virt_size - For virtual mapping.
|
|
* @irq - IRQ enum for use in ISR vector install.
|
|
* @num_pipes - number of pipes. Can be read from hardware.
|
|
* @summing_threshold - BAM event threshold.
|
|
*
|
|
* @periph_class - Peripheral device enumeration class.
|
|
* @periph_dev_id - Peripheral global device ID.
|
|
* @periph_phys_addr - Peripheral base physical address, for BAM-DMA only.
|
|
* @periph_virt_addr - Peripheral base virtual address.
|
|
* @periph_virt_size - Size for virtual mapping.
|
|
*
|
|
* @callback - callback function for BAM user.
|
|
* @user - pointer to user data.
|
|
*
|
|
* @event_threshold - Pipe event threshold.
|
|
* @desc_size - Size (bytes) of descriptor FIFO.
|
|
* @data_size - Size (bytes) of data FIFO.
|
|
* @desc_mem_id - Heap ID for default descriptor FIFO allocations.
|
|
* @data_mem_id - Heap ID for default data FIFO allocations.
|
|
*
|
|
* @manage - BAM device management flags (see SPS_BAM_MGR_*).
|
|
* @restricted_pipes - Bitmask of pipes restricted from local use.
|
|
* @ee - Local execution environment index.
|
|
*
|
|
* @irq_gen_addr - MTI interrupt generation address. This configuration only
|
|
* applies to BAM rev 1 and 2 hardware. MTIs are only supported on BAMs when
|
|
* global config is controlled by a remote processor.
|
|
* NOTE: This address must correspond to the MTI associated with the "irq" IRQ
|
|
* enum specified above.
|
|
*
|
|
* @sec_config - must be set to SPS_BAM_SEC_DO_CONFIG to perform BAM security
|
|
* configuration. Only the processor that manages the BAM is allowed to
|
|
* perform the configuration. The global (top-level) BAM interrupt will be
|
|
* assigned to the EE of the processor that manages the BAM.
|
|
*
|
|
* @p_sec_config_props - BAM device's security configuation
|
|
*
|
|
*/
|
|
struct sps_bam_props {
|
|
|
|
/* BAM device properties. */
|
|
|
|
u32 options;
|
|
phys_addr_t phys_addr;
|
|
void *virt_addr;
|
|
u32 virt_size;
|
|
u32 irq;
|
|
u32 num_pipes;
|
|
u32 summing_threshold;
|
|
|
|
/* Peripheral device properties */
|
|
|
|
u32 periph_class;
|
|
u32 periph_dev_id;
|
|
phys_addr_t periph_phys_addr;
|
|
void *periph_virt_addr;
|
|
u32 periph_virt_size;
|
|
|
|
/* Connection pipe parameter defaults. */
|
|
|
|
u32 event_threshold;
|
|
u32 desc_size;
|
|
u32 data_size;
|
|
u32 desc_mem_id;
|
|
u32 data_mem_id;
|
|
|
|
/* Feedback to BAM user */
|
|
void (*callback)(enum sps_callback_case, void *);
|
|
void *user;
|
|
|
|
/* Security properties */
|
|
|
|
u32 manage;
|
|
u32 restricted_pipes;
|
|
u32 ee;
|
|
|
|
/* Log Level property */
|
|
u32 ipc_loglevel;
|
|
|
|
/* BAM MTI interrupt generation */
|
|
|
|
u32 irq_gen_addr;
|
|
|
|
/* Security configuration properties */
|
|
|
|
u32 sec_config;
|
|
struct sps_bam_sec_config_props *p_sec_config_props;
|
|
|
|
/* Logging control */
|
|
|
|
bool constrained_logging;
|
|
u32 logging_number;
|
|
};
|
|
|
|
/**
|
|
* This struct specifies memory buffer properties.
|
|
*
|
|
* @base - Buffer virtual address.
|
|
* @phys_base - Buffer physical address.
|
|
* @size - Specifies buffer size (or maximum size).
|
|
* @min_size - If non-zero, specifies buffer minimum size.
|
|
*
|
|
*/
|
|
struct sps_mem_buffer {
|
|
void *base;
|
|
phys_addr_t phys_base;
|
|
unsigned long iova;
|
|
u32 size;
|
|
u32 min_size;
|
|
};
|
|
|
|
/**
|
|
* This struct defines a connection's end point and is used as the argument
|
|
* for the sps_connect(), sps_get_config(), and sps_set_config() functions.
|
|
* For system mode pipe, use SPS_DEV_HANDLE_MEM for the end point that
|
|
* corresponds to system memory.
|
|
*
|
|
* The client can force SPS to reserve a specific pipe on a BAM.
|
|
* If the pipe is in use, the sps_connect/set_config() will fail.
|
|
*
|
|
* @source - Source BAM.
|
|
* @src_pipe_index - BAM pipe index, 0 to 30.
|
|
* @destination - Destination BAM.
|
|
* @dest_pipe_index - BAM pipe index, 0 to 30.
|
|
*
|
|
* @mode - specifies which end (source or destination) of the connection will
|
|
* be controlled/referenced by the client.
|
|
*
|
|
* @config - This value is for future use and should be set to
|
|
* SPS_CONFIG_DEFAULT or left as default from sps_get_config().
|
|
*
|
|
* @options - OR'd connection end point options (see SPS_O defines).
|
|
*
|
|
* WARNING: The memory provided should be physically contiguous and non-cached.
|
|
* The user can use one of the following:
|
|
* 1. sps_alloc_mem() - allocated from pipe-memory.
|
|
* 2. dma_alloc_coherent() - allocate coherent DMA memory.
|
|
* 3. dma_map_single() - for using memory allocated by kmalloc().
|
|
*
|
|
* @desc - Descriptor FIFO.
|
|
* @data - Data FIFO (BAM-to-BAM mode only).
|
|
*
|
|
* @event_thresh - Pipe event threshold or derivative.
|
|
* @lock_group - The lock group this pipe belongs to.
|
|
*
|
|
* @sps_reserved - Reserved word - client must not modify.
|
|
*
|
|
*/
|
|
struct sps_connect {
|
|
unsigned long source;
|
|
unsigned long source_iova;
|
|
u32 src_pipe_index;
|
|
unsigned long destination;
|
|
unsigned long dest_iova;
|
|
u32 dest_pipe_index;
|
|
|
|
enum sps_mode mode;
|
|
|
|
u32 config;
|
|
|
|
enum sps_option options;
|
|
|
|
struct sps_mem_buffer desc;
|
|
struct sps_mem_buffer data;
|
|
|
|
u32 event_thresh;
|
|
|
|
u32 lock_group;
|
|
|
|
/* SETPEND/MTI interrupt generation parameters */
|
|
|
|
u32 irq_gen_addr;
|
|
u32 irq_gen_data;
|
|
|
|
u32 sps_reserved;
|
|
|
|
};
|
|
|
|
/**
|
|
* This struct defines a satellite connection's end point. The client of the
|
|
* SPS driver on the satellite processor must call sps_get_config() to
|
|
* initialize a struct sps_connect, then copy the values from the struct
|
|
* sps_satellite to the struct sps_connect before making the sps_connect()
|
|
* call to the satellite SPS driver.
|
|
*
|
|
*/
|
|
struct sps_satellite {
|
|
/**
|
|
* These values must be copied to either the source or destination
|
|
* corresponding values in the connect struct.
|
|
*/
|
|
phys_addr_t dev;
|
|
u32 pipe_index;
|
|
|
|
/**
|
|
* These values must be copied to the corresponding values in the
|
|
* connect struct
|
|
*/
|
|
u32 config;
|
|
enum sps_option options;
|
|
|
|
};
|
|
|
|
/**
|
|
* This struct defines parameters for allocation of a BAM DMA channel. The
|
|
* client must memset() this struct to zero before writing allocation
|
|
* information. A value of zero for uninitialized values will instruct
|
|
* the SPS driver to use defaults or "don't care".
|
|
*
|
|
* @dev - Associated BAM device handle, or SPS_DEV_HANDLE_DMA.
|
|
*
|
|
* @src_owner - Source owner processor ID.
|
|
* @dest_owner - Destination owner processor ID.
|
|
*
|
|
*/
|
|
struct sps_alloc_dma_chan {
|
|
unsigned long dev;
|
|
|
|
/* BAM DMA channel configuration parameters */
|
|
|
|
u32 threshold;
|
|
enum sps_dma_priority priority;
|
|
|
|
/**
|
|
* Owner IDs are global host processor identifiers used by the system
|
|
* SROT when establishing execution environments.
|
|
*/
|
|
u32 src_owner;
|
|
u32 dest_owner;
|
|
|
|
};
|
|
|
|
/**
|
|
* This struct defines parameters for an allocated BAM DMA channel.
|
|
*
|
|
* @dev - BAM DMA device handle.
|
|
* @dest_pipe_index - Destination/input/write pipe index.
|
|
* @src_pipe_index - Source/output/read pipe index.
|
|
*
|
|
*/
|
|
struct sps_dma_chan {
|
|
unsigned long dev;
|
|
u32 dest_pipe_index;
|
|
u32 src_pipe_index;
|
|
};
|
|
|
|
/**
|
|
* This struct is an argument passed payload when triggering a callback event
|
|
* object registered for an SPS connection end point.
|
|
*
|
|
* @user - Pointer registered with sps_register_event().
|
|
*
|
|
* @event_id - Which event.
|
|
*
|
|
* @iovec - The associated I/O vector. If the end point is a system-mode
|
|
* producer, the size will reflect the actual number of bytes written to the
|
|
* buffer by the pipe. NOTE: If this I/O vector was part of a set submitted to
|
|
* sps_transfer(), then the vector array itself will be updated with all of
|
|
* the actual counts.
|
|
*
|
|
* @user - Pointer registered with the transfer.
|
|
*
|
|
*/
|
|
struct sps_event_notify {
|
|
void *user;
|
|
|
|
enum sps_event event_id;
|
|
|
|
/* Data associated with the event */
|
|
|
|
union {
|
|
/* Data for SPS_EVENT_IRQ */
|
|
struct {
|
|
u32 mask;
|
|
} irq;
|
|
|
|
/* Data for SPS_EVENT_EOT or SPS_EVENT_DESC_DONE */
|
|
|
|
struct {
|
|
struct sps_iovec iovec;
|
|
void *user;
|
|
} transfer;
|
|
|
|
/* Data for SPS_EVENT_ERROR */
|
|
|
|
struct {
|
|
u32 status;
|
|
} err;
|
|
|
|
} data;
|
|
};
|
|
|
|
/**
|
|
* This struct defines a event registration parameters and is used as the
|
|
* argument for the sps_register_event() function.
|
|
*
|
|
* @options - Event options that will trigger the event object.
|
|
* @mode - Event trigger mode.
|
|
*
|
|
* @xfer_done - a pointer to a completion object. NULL if not in use.
|
|
*
|
|
* @callback - a callback to call on completion. NULL if not in use.
|
|
*
|
|
* @user - User pointer that will be provided in event callback data.
|
|
*
|
|
*/
|
|
struct sps_register_event {
|
|
enum sps_option options;
|
|
enum sps_trigger mode;
|
|
struct completion *xfer_done;
|
|
void (*callback)(struct sps_event_notify *notify);
|
|
void *user;
|
|
};
|
|
|
|
/**
|
|
* This struct defines a system memory transfer's parameters and is used as the
|
|
* argument for the sps_transfer() function.
|
|
*
|
|
* @iovec_phys - Physical address of I/O vectors buffer.
|
|
* @iovec - Pointer to I/O vectors buffer.
|
|
* @iovec_count - Number of I/O vectors.
|
|
* @user - User pointer passed in callback event.
|
|
*
|
|
*/
|
|
struct sps_transfer {
|
|
phys_addr_t iovec_phys;
|
|
struct sps_iovec *iovec;
|
|
u32 iovec_count;
|
|
void *user;
|
|
};
|
|
|
|
/**
|
|
* This struct defines a timer control operation parameters and is used as an
|
|
* argument for the sps_timer_ctrl() function.
|
|
*
|
|
* @op - Timer control operation.
|
|
* @timeout_msec - Inactivity timeout (msec).
|
|
*
|
|
*/
|
|
struct sps_timer_ctrl {
|
|
enum sps_timer_op op;
|
|
|
|
/**
|
|
* The following configuration parameters must be set when the timer
|
|
* control operation is SPS_TIMER_OP_CONFIG.
|
|
*/
|
|
enum sps_timer_mode mode;
|
|
u32 timeout_msec;
|
|
};
|
|
|
|
/**
|
|
* This struct defines a timer control operation result and is used as an
|
|
* argument for the sps_timer_ctrl() function.
|
|
*/
|
|
struct sps_timer_result {
|
|
u32 current_timer;
|
|
};
|
|
|
|
|
|
/*----------------------------------------------------------------------------
|
|
* Functions specific to sps interface
|
|
* -------------------------------------------------------------------------*/
|
|
struct sps_pipe; /* Forward declaration */
|
|
|
|
#ifdef CONFIG_SPS
|
|
/**
|
|
* Register a BAM device
|
|
*
|
|
* This function registers a BAM device with the SPS driver. For each
|
|
*peripheral that includes a BAM, the peripheral driver must register
|
|
* the BAM with the SPS driver.
|
|
*
|
|
* A requirement is that the peripheral driver must remain attached
|
|
* to the SPS driver until the BAM is deregistered. Otherwise, the
|
|
* system may attempt to unload the SPS driver. BAM registrations would
|
|
* be lost.
|
|
*
|
|
* @bam_props - Pointer to struct for BAM device properties.
|
|
*
|
|
* @dev_handle - Device handle will be written to this location (output).
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_register_bam_device(const struct sps_bam_props *bam_props,
|
|
unsigned long *dev_handle);
|
|
|
|
/**
|
|
* Deregister a BAM device
|
|
*
|
|
* This function deregisters a BAM device from the SPS driver. The peripheral
|
|
* driver should deregister a BAM when the peripheral driver is shut down or
|
|
* when BAM use should be disabled.
|
|
*
|
|
* A BAM cannot be deregistered if any of its pipes is in an active connection.
|
|
*
|
|
* When all BAMs have been deregistered, the system is free to unload the
|
|
* SPS driver.
|
|
*
|
|
* @dev_handle - BAM device handle.
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_deregister_bam_device(unsigned long dev_handle);
|
|
|
|
/**
|
|
* Allocate client state context
|
|
*
|
|
* This function allocate and initializes a client state context struct.
|
|
*
|
|
* @return pointer to client state context
|
|
*
|
|
*/
|
|
struct sps_pipe *sps_alloc_endpoint(void);
|
|
|
|
/**
|
|
* Free client state context
|
|
*
|
|
* This function de-initializes and free a client state context struct.
|
|
*
|
|
* @ctx - client context for SPS connection end point
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_free_endpoint(struct sps_pipe *h);
|
|
|
|
/**
|
|
* Get the configuration parameters for an SPS connection end point
|
|
*
|
|
* This function retrieves the configuration parameters for an SPS connection
|
|
* end point.
|
|
* This function may be called before the end point is connected (before
|
|
* sps_connect is called). This allows the client to specify parameters before
|
|
* the connection is established.
|
|
*
|
|
* The client must call this function to fill it's struct sps_connect
|
|
* struct before modifying values and passing the struct to sps_set_config().
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @config - Pointer to buffer for the end point's configuration parameters.
|
|
* Must not be NULL.
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_get_config(struct sps_pipe *h, struct sps_connect *config);
|
|
|
|
/**
|
|
* Allocate memory from the SPS Pipe-Memory.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @mem - memory type - N/A.
|
|
*
|
|
* @mem_buffer - Pointer to struct for allocated memory properties.
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_alloc_mem(struct sps_pipe *h, enum sps_mem mem,
|
|
struct sps_mem_buffer *mem_buffer);
|
|
|
|
/**
|
|
* Free memory from the SPS Pipe-Memory.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @mem_buffer - Pointer to struct for allocated memory properties.
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_free_mem(struct sps_pipe *h, struct sps_mem_buffer *mem_buffer);
|
|
|
|
/**
|
|
* Connect an SPS connection end point
|
|
*
|
|
* This function creates a connection between two SPS peripherals or between
|
|
* an SPS peripheral and the local host processor (via system memory, end
|
|
*point SPS_DEV_HANDLE_MEM). Establishing the connection includes
|
|
* initialization of the SPS hardware and allocation of any other connection
|
|
* resources (buffer memory, etc.).
|
|
*
|
|
* This function requires the client to specify both the source and
|
|
* destination end points of the SPS connection. However, the handle
|
|
* returned applies only to the end point of the connection that the client
|
|
* controls. The end point under control must be specified by the
|
|
* enum sps_mode mode argument, either SPS_MODE_SRC, SPS_MODE_DEST, or
|
|
* SPS_MODE_CTL. Note that SPS_MODE_CTL is only supported for I/O
|
|
* accelerator connections, and only a limited set of control operations are
|
|
* allowed (TBD).
|
|
*
|
|
* For a connection involving system memory
|
|
* (SPS_DEV_HANDLE_MEM), the peripheral end point must be
|
|
* specified. For example, SPS_MODE_SRC must be specified for a
|
|
* BAM-to-system connection, since the BAM pipe is the data
|
|
* producer.
|
|
*
|
|
* For a specific peripheral-to-peripheral connection, there may be more than
|
|
* one required configuration. For example, there might be high-performance
|
|
* and low-power configurations for a connection between the two peripherals.
|
|
* The config argument allows the client to specify different configurations,
|
|
* which may require different system resource allocations and hardware
|
|
* initialization.
|
|
*
|
|
* A client is allowed to create one and only one connection for its
|
|
* struct sps_pipe. The handle is used to identify the connection end point
|
|
* in subsequent SPS driver calls. A specific connection source or
|
|
* destination end point can be associated with one and only one
|
|
* struct sps_pipe.
|
|
*
|
|
* The client must establish an open device handle to the SPS. To do so, the
|
|
* client must attach to the SPS driver and open the SPS device by calling
|
|
* the following functions.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @connect - Pointer to connection parameters
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_connect(struct sps_pipe *h, struct sps_connect *connect);
|
|
|
|
/**
|
|
* Disconnect an SPS connection end point
|
|
*
|
|
* This function disconnects an SPS connection end point.
|
|
* The SPS hardware associated with that end point will be disabled.
|
|
* For a connection involving system memory (SPS_DEV_HANDLE_MEM), all
|
|
* connection resources are deallocated. For a peripheral-to-peripheral
|
|
* connection, the resources associated with the connection will not be
|
|
* deallocated until both end points are closed.
|
|
*
|
|
* The client must call sps_connect() for the handle before calling
|
|
* this function.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_disconnect(struct sps_pipe *h);
|
|
|
|
/**
|
|
* Register an event object for an SPS connection end point
|
|
*
|
|
* This function registers a callback event object for an SPS connection end
|
|
*point. The registered event object will be triggered for the set of
|
|
* events specified in reg->options that are enabled for the end point.
|
|
*
|
|
* There can only be one registered event object for each event. If an event
|
|
* object is already registered for an event, it will be replaced. If
|
|
*reg->event handle is NULL, then any registered event object for the
|
|
* event will be deregistered. Option bits in reg->options not associated
|
|
* with events are ignored.
|
|
*
|
|
* The client must call sps_connect() for the handle before calling
|
|
* this function.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @reg - Pointer to event registration parameters
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_register_event(struct sps_pipe *h, struct sps_register_event *reg);
|
|
|
|
/**
|
|
* Perform a single DMA transfer on an SPS connection end point
|
|
*
|
|
* This function submits a DMA transfer request consisting of a single buffer
|
|
* for an SPS connection end point associated with a peripheral-to/from-memory
|
|
* connection. The request will be submitted immediately to hardware if the
|
|
* hardware is idle (data flow off, no other pending transfers). Otherwise, it
|
|
* will be queued for later handling in the SPS driver work loop.
|
|
*
|
|
* The data buffer must be DMA ready. The client is responsible for insuring
|
|
*physically contiguous memory, cache maintenance, and memory barrier. For
|
|
* more information, see Appendix A.
|
|
*
|
|
* The client must not modify the data buffer until the completion indication is
|
|
* received.
|
|
*
|
|
* This function cannot be used if transfer queuing is disabled (see option
|
|
* SPS_O_NO_Q). The client must set the SPS_O_EOT option to receive a callback
|
|
* event trigger when the transfer is complete. The SPS driver will insure the
|
|
* appropriate flags in the I/O vectors are set to generate the completion
|
|
* indication.
|
|
*
|
|
* The return value from this function may indicate that an error occurred.
|
|
* Possible causes include invalid arguments.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @addr - Physical address of buffer to transfer.
|
|
*
|
|
* WARNING: The memory provided should be physically contiguous and
|
|
* non-cached.
|
|
*
|
|
* The user can use one of the following:
|
|
* 1. sps_alloc_mem() - allocated from pipe-memory.
|
|
* 2. dma_alloc_coherent() - allocate DMA memory.
|
|
* 3. dma_map_single() for memory allocated by kmalloc().
|
|
*
|
|
* @size - Size in bytes of buffer to transfer
|
|
*
|
|
* @user - User pointer that will be returned to user as part of
|
|
* event payload
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_transfer_one(struct sps_pipe *h, phys_addr_t addr, u32 size,
|
|
void *user, u32 flags);
|
|
|
|
/**
|
|
* Read event queue for an SPS connection end point
|
|
*
|
|
* This function reads event queue for an SPS connection end point.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @event - pointer to client's event data buffer
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_get_event(struct sps_pipe *h, struct sps_event_notify *event);
|
|
|
|
/**
|
|
* Get processed I/O vector (completed transfers)
|
|
*
|
|
* This function fetches the next processed I/O vector.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @iovec - Pointer to I/O vector struct (output).
|
|
* This struct will be zeroed if there are no more processed I/O vectors.
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_get_iovec(struct sps_pipe *h, struct sps_iovec *iovec);
|
|
|
|
/**
|
|
* Enable an SPS connection end point
|
|
*
|
|
* This function enables an SPS connection end point.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_flow_on(struct sps_pipe *h);
|
|
|
|
/**
|
|
* Disable an SPS connection end point
|
|
*
|
|
* This function disables an SPS connection end point.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @mode - Desired mode for disabling pipe data flow
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_flow_off(struct sps_pipe *h, enum sps_flow_off mode);
|
|
|
|
/**
|
|
* Perform a Multiple DMA transfer on an SPS connection end point
|
|
*
|
|
* This function submits a DMA transfer request for an SPS connection end point
|
|
* associated with a peripheral-to/from-memory connection. The request will be
|
|
* submitted immediately to hardware if the hardware is idle (data flow off, no
|
|
* other pending transfers). Otherwise, it will be queued for later handling in
|
|
* the SPS driver work loop.
|
|
*
|
|
* The data buffers referenced by the I/O vectors must be DMA ready.
|
|
* The client is responsible for insuring physically contiguous memory,
|
|
* any cache maintenance, and memory barrier. For more information,
|
|
* see Appendix A.
|
|
*
|
|
* The I/O vectors must specify physical addresses for the referenced buffers.
|
|
*
|
|
* The client must not modify the data buffers referenced by I/O vectors until
|
|
* the completion indication is received.
|
|
*
|
|
* If transfer queuing is disabled (see option SPS_O_NO_Q), the client is
|
|
* responsible for setting the appropriate flags in the I/O vectors to generate
|
|
* the completion indication. Also, the client is responsible for enabling the
|
|
* appropriate connection callback event options for completion indication (see
|
|
* sps_connect(), sps_set_config()).
|
|
*
|
|
* If transfer queuing is enabled, the client must set the SPS_O_EOT option to
|
|
* receive a callback event trigger when the transfer is complete. The SPS
|
|
* driver will insure the appropriate flags in the I/O vectors are set to
|
|
* generate the completion indication. The client must not set any flags in the
|
|
* I/O vectors, as this may cause the SPS driver to become out of sync with the
|
|
* hardware.
|
|
*
|
|
* The return value from this function may indicate that an error occurred.
|
|
* Possible causes include invalid arguments. If transfer queuing is disabled,
|
|
* an error will occur if the pipe is already processing a transfer.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @transfer - Pointer to transfer parameter struct
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_transfer(struct sps_pipe *h, struct sps_transfer *transfer);
|
|
|
|
/**
|
|
* Determine whether an SPS connection end point FIFO is empty
|
|
*
|
|
* This function returns the empty state of an SPS connection end point.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @empty - pointer to client's empty status word (boolean)
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_is_pipe_empty(struct sps_pipe *h, u32 *empty);
|
|
|
|
/**
|
|
* Reset an SPS BAM device
|
|
*
|
|
* This function resets an SPS BAM device.
|
|
*
|
|
* @dev - device handle for the BAM
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_device_reset(unsigned long dev);
|
|
|
|
/**
|
|
* Set the configuration parameters for an SPS connection end point
|
|
*
|
|
* This function sets the configuration parameters for an SPS connection
|
|
* end point. This function may be called before the end point is connected
|
|
* (before sps_connect is called). This allows the client to specify
|
|
*parameters before the connection is established. The client is allowed
|
|
* to pre-allocate resources and override driver defaults.
|
|
*
|
|
* The client must call sps_get_config() to fill it's struct sps_connect
|
|
* struct before modifying values and passing the struct to this function.
|
|
* Only those parameters that differ from the current configuration will
|
|
* be processed.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @config - Pointer to the end point's new configuration parameters.
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_set_config(struct sps_pipe *h, struct sps_connect *config);
|
|
|
|
/**
|
|
* Set ownership of an SPS connection end point
|
|
*
|
|
* This function sets the ownership of an SPS connection end point to
|
|
* either local (default) or non-local. This function is used to
|
|
* retrieve the struct sps_connect data that must be used by a
|
|
* satellite processor when calling sps_connect().
|
|
*
|
|
* Non-local ownership is only possible/meaningful on the processor
|
|
* that controls resource allocations (apps processor). Setting ownership
|
|
* to non-local on a satellite processor will fail.
|
|
*
|
|
* Setting ownership from non-local to local will succeed only if the
|
|
* owning satellite processor has properly brought the end point to
|
|
* an idle condition.
|
|
*
|
|
* This function will succeed if the connection end point is already in
|
|
* the specified ownership state.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @owner - New ownership of the connection end point
|
|
*
|
|
* @connect - Pointer to buffer for satellite processor connect data.
|
|
* Can be NULL to avoid retrieving the connect data. Will be ignored
|
|
* if the end point ownership is set to local.
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_set_owner(struct sps_pipe *h, enum sps_owner owner,
|
|
struct sps_satellite *connect);
|
|
|
|
#ifdef CONFIG_SPS_SUPPORT_BAMDMA
|
|
/**
|
|
* Allocate a BAM DMA channel
|
|
*
|
|
* This function allocates a BAM DMA channel. A "BAM DMA" is a special
|
|
* DMA peripheral with a BAM front end. The DMA peripheral acts as a conduit
|
|
* for data to flow into a consumer pipe and then out of a producer pipe.
|
|
* It's primarily purpose is to serve as a path for interprocessor communication
|
|
* that allows each processor to control and protect it's own memory space.
|
|
*
|
|
* @alloc - Pointer to struct for BAM DMA channel allocation properties.
|
|
*
|
|
* @chan - Allocated channel information will be written to this
|
|
* location (output).
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_alloc_dma_chan(const struct sps_alloc_dma_chan *alloc,
|
|
struct sps_dma_chan *chan);
|
|
|
|
/**
|
|
* Free a BAM DMA channel
|
|
*
|
|
* This function frees a BAM DMA channel.
|
|
*
|
|
* @chan - Pointer to information for channel to free
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_free_dma_chan(struct sps_dma_chan *chan);
|
|
|
|
/**
|
|
* Get the BAM handle for BAM-DMA.
|
|
*
|
|
* The BAM handle should be use as source/destination in the sps_connect().
|
|
*
|
|
* @return handle on success, zero on error
|
|
*
|
|
*/
|
|
unsigned long sps_dma_get_bam_handle(void);
|
|
|
|
/**
|
|
* Free the BAM handle for BAM-DMA.
|
|
*
|
|
*/
|
|
void sps_dma_free_bam_handle(unsigned long h);
|
|
#else
|
|
static inline int sps_alloc_dma_chan(const struct sps_alloc_dma_chan *alloc,
|
|
struct sps_dma_chan *chan)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_free_dma_chan(struct sps_dma_chan *chan)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline unsigned long sps_dma_get_bam_handle(void)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline void sps_dma_free_bam_handle(unsigned long h)
|
|
{
|
|
}
|
|
#endif
|
|
|
|
/**
|
|
* Get number of free transfer entries for an SPS connection end point
|
|
*
|
|
* This function returns the number of free transfer entries for an
|
|
* SPS connection end point.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @count - pointer to count status
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_get_free_count(struct sps_pipe *h, u32 *count);
|
|
|
|
/**
|
|
* Perform timer control
|
|
*
|
|
* This function performs timer control operations.
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @timer_ctrl - Pointer to timer control specification
|
|
*
|
|
* @timer_result - Pointer to buffer for timer operation result.
|
|
* This argument can be NULL if no result is expected for the operation.
|
|
* If non-NULL, the current timer value will always provided.
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_timer_ctrl(struct sps_pipe *h,
|
|
struct sps_timer_ctrl *timer_ctrl,
|
|
struct sps_timer_result *timer_result);
|
|
|
|
/**
|
|
* Find the handle of a BAM device based on the physical address
|
|
*
|
|
* This function finds a BAM device in the BAM registration list that
|
|
* matches the specified physical address, and returns its handle.
|
|
*
|
|
* @phys_addr - physical address of the BAM
|
|
*
|
|
* @h - device handle of the BAM
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_phy2h(phys_addr_t phys_addr, unsigned long *handle);
|
|
|
|
/**
|
|
* Setup desc/data FIFO for bam-to-bam connection
|
|
*
|
|
* @mem_buffer - Pointer to struct for allocated memory properties.
|
|
*
|
|
* @addr - address of FIFO
|
|
*
|
|
* @size - FIFO size
|
|
*
|
|
* @use_offset - use address offset instead of absolute address
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_setup_bam2bam_fifo(struct sps_mem_buffer *mem_buffer,
|
|
u32 addr, u32 size, int use_offset);
|
|
|
|
/**
|
|
* Get the number of unused descriptors in the descriptor FIFO
|
|
* of a pipe
|
|
*
|
|
* @h - client context for SPS connection end point
|
|
*
|
|
* @desc_num - number of unused descriptors
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_get_unused_desc_num(struct sps_pipe *h, u32 *desc_num);
|
|
|
|
/**
|
|
* Get the debug info of BAM registers and descriptor FIFOs
|
|
*
|
|
* @dev - BAM device handle
|
|
*
|
|
* @option - debugging option
|
|
*
|
|
* @para - parameter used for an option (such as pipe combination)
|
|
*
|
|
* @tb_sel - testbus selection
|
|
*
|
|
* @desc_sel - selection of descriptors
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_get_bam_debug_info(unsigned long dev, u32 option, u32 para,
|
|
u32 tb_sel, u32 desc_sel);
|
|
|
|
/**
|
|
* Vote for or relinquish BAM DMA clock
|
|
*
|
|
* @clk_on - to turn on or turn off the clock
|
|
*
|
|
* @return 0 on success, negative value on error
|
|
*
|
|
*/
|
|
int sps_ctrl_bam_dma_clk(bool clk_on);
|
|
|
|
/*
|
|
* sps_pipe_reset - reset a pipe of a BAM.
|
|
* @dev: BAM device handle
|
|
* @pipe: pipe index
|
|
*
|
|
* This function resets a pipe of a BAM.
|
|
*
|
|
* Return: 0 on success, negative value on error
|
|
*/
|
|
int sps_pipe_reset(unsigned long dev, u32 pipe);
|
|
|
|
/*
|
|
* sps_pipe_disable - disable a pipe of a BAM.
|
|
* @dev: BAM device handle
|
|
* @pipe: pipe index
|
|
*
|
|
* This function disables a pipe of a BAM.
|
|
*
|
|
* Return: 0 on success, negative value on error
|
|
*/
|
|
int sps_pipe_disable(unsigned long dev, u32 pipe);
|
|
|
|
/*
|
|
* sps_pipe_pending_desc - checking pending descriptor.
|
|
* @dev: BAM device handle
|
|
* @pipe: pipe index
|
|
* @pending: indicate if there is any pending descriptor.
|
|
*
|
|
* This function checks if a pipe of a BAM has any pending descriptor.
|
|
*
|
|
* Return: 0 on success, negative value on error
|
|
*/
|
|
int sps_pipe_pending_desc(unsigned long dev, u32 pipe, bool *pending);
|
|
|
|
/*
|
|
* sps_bam_process_irq - process IRQ of a BAM.
|
|
* @dev: BAM device handle
|
|
*
|
|
* This function processes any pending IRQ of a BAM.
|
|
*
|
|
* Return: 0 on success, negative value on error
|
|
*/
|
|
int sps_bam_process_irq(unsigned long dev);
|
|
|
|
/*
|
|
* sps_get_bam_addr - get address info of a BAM.
|
|
* @dev: BAM device handle
|
|
* @base: beginning address
|
|
* @size: address range size
|
|
*
|
|
* This function returns the address info of a BAM.
|
|
*
|
|
* Return: 0 on success, negative value on error
|
|
*/
|
|
int sps_get_bam_addr(unsigned long dev, phys_addr_t *base,
|
|
u32 *size);
|
|
|
|
/*
|
|
* sps_pipe_inject_zlt - inject a ZLT with EOT.
|
|
* @dev: BAM device handle
|
|
* @pipe_index: pipe index
|
|
*
|
|
* This function injects a ZLT with EOT for a pipe of a BAM.
|
|
*
|
|
* Return: 0 on success, negative value on error
|
|
*/
|
|
int sps_pipe_inject_zlt(unsigned long dev, u32 pipe_index);
|
|
#else
|
|
static inline int sps_register_bam_device(const struct sps_bam_props
|
|
*bam_props, unsigned long *dev_handle)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_deregister_bam_device(unsigned long dev_handle)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline struct sps_pipe *sps_alloc_endpoint(void)
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
static inline int sps_free_endpoint(struct sps_pipe *h)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_get_config(struct sps_pipe *h, struct sps_connect *config)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_alloc_mem(struct sps_pipe *h, enum sps_mem mem,
|
|
struct sps_mem_buffer *mem_buffer)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_free_mem(struct sps_pipe *h,
|
|
struct sps_mem_buffer *mem_buffer)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_connect(struct sps_pipe *h, struct sps_connect *connect)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_disconnect(struct sps_pipe *h)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_register_event(struct sps_pipe *h,
|
|
struct sps_register_event *reg)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_transfer_one(struct sps_pipe *h, phys_addr_t addr,
|
|
u32 size, void *user, u32 flags)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_get_event(struct sps_pipe *h,
|
|
struct sps_event_notify *event)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_get_iovec(struct sps_pipe *h, struct sps_iovec *iovec)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_flow_on(struct sps_pipe *h)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_flow_off(struct sps_pipe *h, enum sps_flow_off mode)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_transfer(struct sps_pipe *h,
|
|
struct sps_transfer *transfer)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_is_pipe_empty(struct sps_pipe *h, u32 *empty)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_device_reset(unsigned long dev)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_set_config(struct sps_pipe *h, struct sps_connect *config)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_set_owner(struct sps_pipe *h, enum sps_owner owner,
|
|
struct sps_satellite *connect)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_get_free_count(struct sps_pipe *h, u32 *count)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_alloc_dma_chan(const struct sps_alloc_dma_chan *alloc,
|
|
struct sps_dma_chan *chan)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_free_dma_chan(struct sps_dma_chan *chan)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline unsigned long sps_dma_get_bam_handle(void)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline void sps_dma_free_bam_handle(unsigned long h)
|
|
{
|
|
}
|
|
|
|
static inline int sps_timer_ctrl(struct sps_pipe *h,
|
|
struct sps_timer_ctrl *timer_ctrl,
|
|
struct sps_timer_result *timer_result)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_phy2h(phys_addr_t phys_addr, unsigned long *handle)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_setup_bam2bam_fifo(struct sps_mem_buffer *mem_buffer,
|
|
u32 addr, u32 size, int use_offset)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_get_unused_desc_num(struct sps_pipe *h, u32 *desc_num)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_get_bam_debug_info(unsigned long dev, u32 option,
|
|
u32 para, u32 tb_sel, u32 desc_sel)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_ctrl_bam_dma_clk(bool clk_on)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_pipe_reset(unsigned long dev, u32 pipe)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_pipe_disable(unsigned long dev, u32 pipe)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_pipe_pending_desc(unsigned long dev, u32 pipe,
|
|
bool *pending)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_bam_process_irq(unsigned long dev)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_get_bam_addr(unsigned long dev, phys_addr_t *base,
|
|
u32 *size);
|
|
{
|
|
return -EPERM;
|
|
}
|
|
|
|
static inline int sps_pipe_inject_zlt(unsigned long dev, u32 pipe_index)
|
|
{
|
|
return -EPERM;
|
|
}
|
|
#endif
|
|
|
|
#endif /* _SPS_H_ */
|