208 lines · c
1/* SPDX-License-Identifier: GPL-2.0-or-later */2/*3 * Driver for Digigram miXart soundcards4 *5 * main header file6 *7 * Copyright (c) 2003 by Digigram <alsa@digigram.com>8 */9 10#ifndef __SOUND_MIXART_H11#define __SOUND_MIXART_H12 13#include <linux/interrupt.h>14#include <linux/mutex.h>15#include <sound/pcm.h>16 17#define MIXART_DRIVER_VERSION 0x000100 /* 0.1.0 */18 19 20/*21 */22 23struct mixart_uid {24 u32 object_id;25 u32 desc;26};27 28struct mem_area {29 unsigned long phys;30 void __iomem *virt;31 struct resource *res;32};33 34 35struct mixart_route {36 unsigned char connected;37 unsigned char phase_inv;38 int volume;39};40 41 42/* firmware status codes */43#define MIXART_MOTHERBOARD_XLX_INDEX 044#define MIXART_MOTHERBOARD_ELF_INDEX 145#define MIXART_AESEBUBOARD_XLX_INDEX 246#define MIXART_HARDW_FILES_MAX_INDEX 3 /* xilinx, elf, AESEBU xilinx */47 48#define MIXART_MAX_CARDS 449#define MSG_FIFO_SIZE 1650 51#define MIXART_MAX_PHYS_CONNECTORS (MIXART_MAX_CARDS * 2 * 2) /* 4 * stereo * (analog+digital) */52 53struct mixart_mgr {54 unsigned int num_cards;55 struct snd_mixart *chip[MIXART_MAX_CARDS];56 57 struct pci_dev *pci;58 59 int irq;60 61 /* memory-maps */62 struct mem_area mem[2];63 64 /* one and only blocking message or notification may be pending */65 u32 pending_event;66 wait_queue_head_t msg_sleep;67 68 /* messages fifo */69 u32 msg_fifo[MSG_FIFO_SIZE];70 int msg_fifo_readptr;71 int msg_fifo_writeptr;72 atomic_t msg_processed; /* number of messages to be processed in irq thread */73 74 struct mutex lock; /* interrupt lock */75 struct mutex msg_lock; /* mailbox lock */76 77 struct mutex setup_mutex; /* mutex used in hw_params, open and close */78 79 /* hardware interface */80 unsigned int dsp_loaded; /* bit flags of loaded dsp indices */81 unsigned int board_type; /* read from embedded once elf file is loaded, 250 = miXart8, 251 = with AES, 252 = with Cobranet */82 83 struct snd_dma_buffer flowinfo;84 struct snd_dma_buffer bufferinfo;85 86 struct mixart_uid uid_console_manager;87 int sample_rate;88 int ref_count_rate;89 90 struct mutex mixer_mutex; /* mutex for mixer */91 92};93 94 95#define MIXART_STREAM_STATUS_FREE 096#define MIXART_STREAM_STATUS_OPEN 197#define MIXART_STREAM_STATUS_RUNNING 298#define MIXART_STREAM_STATUS_DRAINING 399#define MIXART_STREAM_STATUS_PAUSE 4100 101#define MIXART_PLAYBACK_STREAMS 4102#define MIXART_CAPTURE_STREAMS 1103 104#define MIXART_PCM_ANALOG 0105#define MIXART_PCM_DIGITAL 1106#define MIXART_PCM_TOTAL 2107 108#define MIXART_MAX_STREAM_PER_CARD (MIXART_PCM_TOTAL * (MIXART_PLAYBACK_STREAMS + MIXART_CAPTURE_STREAMS) )109 110 111#define MIXART_NOTIFY_CARD_MASK 0xF000112#define MIXART_NOTIFY_CARD_OFFSET 12113#define MIXART_NOTIFY_PCM_MASK 0x0F00114#define MIXART_NOTIFY_PCM_OFFSET 8115#define MIXART_NOTIFY_CAPT_MASK 0x0080116#define MIXART_NOTIFY_SUBS_MASK 0x007F117 118 119struct mixart_stream {120 struct snd_pcm_substream *substream;121 struct mixart_pipe *pipe;122 int pcm_number;123 124 int status; /* nothing, running, draining */125 126 u64 abs_period_elapsed; /* last absolute stream position where period_elapsed was called (multiple of runtime->period_size) */127 u32 buf_periods; /* periods counter in the buffer (< runtime->periods) */128 u32 buf_period_frag; /* defines with buf_period_pos the exact position in the buffer (< runtime->period_size) */129 130 int channels;131};132 133 134enum mixart_pipe_status {135 PIPE_UNDEFINED,136 PIPE_STOPPED,137 PIPE_RUNNING,138 PIPE_CLOCK_SET139};140 141struct mixart_pipe {142 struct mixart_uid group_uid; /* id of the pipe, as returned by embedded */143 int stream_count;144 struct mixart_uid uid_left_connector; /* UID's for the audio connectors */145 struct mixart_uid uid_right_connector;146 enum mixart_pipe_status status;147 int references; /* number of subs openned */148 int monitoring; /* pipe used for monitoring issue */149};150 151 152struct snd_mixart {153 struct snd_card *card;154 struct mixart_mgr *mgr;155 int chip_idx; /* zero based */156 struct snd_hwdep *hwdep; /* DSP loader, only for the first card */157 158 struct snd_pcm *pcm; /* PCM analog i/o */159 struct snd_pcm *pcm_dig; /* PCM digital i/o */160 161 /* allocate stereo pipe for instance */162 struct mixart_pipe pipe_in_ana;163 struct mixart_pipe pipe_out_ana;164 165 /* if AES/EBU daughter board is available, additional pipes possible on pcm_dig */166 struct mixart_pipe pipe_in_dig;167 struct mixart_pipe pipe_out_dig;168 169 struct mixart_stream playback_stream[MIXART_PCM_TOTAL][MIXART_PLAYBACK_STREAMS]; /* 0 = pcm, 1 = pcm_dig */170 struct mixart_stream capture_stream[MIXART_PCM_TOTAL]; /* 0 = pcm, 1 = pcm_dig */171 172 /* UID's for the physical io's */173 struct mixart_uid uid_out_analog_physio;174 struct mixart_uid uid_in_analog_physio;175 176 int analog_playback_active[2]; /* Mixer : Master Playback active (!mute) */177 int analog_playback_volume[2]; /* Mixer : Master Playback Volume */178 int analog_capture_volume[2]; /* Mixer : Master Capture Volume */179 int digital_playback_active[2*MIXART_PLAYBACK_STREAMS][2]; /* Mixer : Digital Playback Active [(analog+AES output)*streams][stereo]*/180 int digital_playback_volume[2*MIXART_PLAYBACK_STREAMS][2]; /* Mixer : Digital Playback Volume [(analog+AES output)*streams][stereo]*/181 int digital_capture_volume[2][2]; /* Mixer : Digital Capture Volume [analog+AES output][stereo] */182 int monitoring_active[2]; /* Mixer : Monitoring Active */183 int monitoring_volume[2]; /* Mixer : Monitoring Volume */184};185 186struct mixart_bufferinfo187{188 u32 buffer_address;189 u32 reserved[5];190 u32 available_length;191 u32 buffer_id;192};193 194struct mixart_flowinfo195{196 u32 bufferinfo_array_phy_address;197 u32 reserved[11];198 u32 bufferinfo_count;199 u32 capture;200};201 202/* exported */203int snd_mixart_create_pcm(struct snd_mixart * chip);204struct mixart_pipe *snd_mixart_add_ref_pipe(struct snd_mixart *chip, int pcm_number, int capture, int monitoring);205int snd_mixart_kill_ref_pipe(struct mixart_mgr *mgr, struct mixart_pipe *pipe, int monitoring);206 207#endif /* __SOUND_MIXART_H */208