1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /* -*- linux-c -*- *
3 *
4 * ALSA driver for the digigram lx6464es interface
5 * low-level interface
6 *
7 * Copyright (c) 2009 Tim Blechmann <tim@klingt.org>
8 */
9
10 #ifndef LX_CORE_H
11 #define LX_CORE_H
12
13 #include <linux/interrupt.h>
14
15 #include "lx_defs.h"
16
17 #define REG_CRM_NUMBER 12
18
19 struct lx6464es;
20
21 /* low-level register access */
22
23 /* dsp register access */
24 enum {
25 eReg_BASE,
26 eReg_CSM,
27 eReg_CRM1,
28 eReg_CRM2,
29 eReg_CRM3,
30 eReg_CRM4,
31 eReg_CRM5,
32 eReg_CRM6,
33 eReg_CRM7,
34 eReg_CRM8,
35 eReg_CRM9,
36 eReg_CRM10,
37 eReg_CRM11,
38 eReg_CRM12,
39
40 eReg_ICR,
41 eReg_CVR,
42 eReg_ISR,
43 eReg_RXHTXH,
44 eReg_RXMTXM,
45 eReg_RHLTXL,
46 eReg_RESETDSP,
47
48 eReg_CSUF,
49 eReg_CSES,
50 eReg_CRESMSB,
51 eReg_CRESLSB,
52 eReg_ADMACESMSB,
53 eReg_ADMACESLSB,
54 eReg_CONFES,
55
56 eMaxPortLx
57 };
58
59 unsigned long lx_dsp_reg_read(struct lx6464es *chip, int port);
60 void lx_dsp_reg_write(struct lx6464es *chip, int port, unsigned data);
61
62 /* plx register access */
63 enum {
64 ePLX_PCICR,
65
66 ePLX_MBOX0,
67 ePLX_MBOX1,
68 ePLX_MBOX2,
69 ePLX_MBOX3,
70 ePLX_MBOX4,
71 ePLX_MBOX5,
72 ePLX_MBOX6,
73 ePLX_MBOX7,
74
75 ePLX_L2PCIDB,
76 ePLX_IRQCS,
77 ePLX_CHIPSC,
78
79 eMaxPort
80 };
81
82 unsigned long lx_plx_reg_read(struct lx6464es *chip, int port);
83 void lx_plx_reg_write(struct lx6464es *chip, int port, u32 data);
84
85 /* rhm */
86 struct lx_rmh {
87 u16 cmd_len; /* length of the command to send (WORDs) */
88 u16 stat_len; /* length of the status received (WORDs) */
89 u16 dsp_stat; /* status type, RMP_SSIZE_XXX */
90 u16 cmd_idx; /* index of the command */
91 u32 cmd[REG_CRM_NUMBER];
92 u32 stat[REG_CRM_NUMBER];
93 };
94
95
96 /* low-level dsp access */
97 int lx_dsp_get_version(struct lx6464es *chip, u32 *rdsp_version);
98 int lx_dsp_get_clock_frequency(struct lx6464es *chip, u32 *rfreq);
99 int lx_dsp_set_granularity(struct lx6464es *chip, u32 gran);
100 int lx_dsp_read_async_events(struct lx6464es *chip, u32 *data);
101 int lx_dsp_get_mac(struct lx6464es *chip);
102
103
104 /* low-level pipe handling */
105 int lx_pipe_allocate(struct lx6464es *chip, u32 pipe, int is_capture,
106 int channels);
107 int lx_pipe_release(struct lx6464es *chip, u32 pipe, int is_capture);
108 int lx_pipe_sample_count(struct lx6464es *chip, u32 pipe, int is_capture,
109 u64 *rsample_count);
110 int lx_pipe_state(struct lx6464es *chip, u32 pipe, int is_capture, u16 *rstate);
111 int lx_pipe_stop(struct lx6464es *chip, u32 pipe, int is_capture);
112 int lx_pipe_start(struct lx6464es *chip, u32 pipe, int is_capture);
113 int lx_pipe_pause(struct lx6464es *chip, u32 pipe, int is_capture);
114
115 int lx_pipe_wait_for_start(struct lx6464es *chip, u32 pipe, int is_capture);
116 int lx_pipe_wait_for_idle(struct lx6464es *chip, u32 pipe, int is_capture);
117
118 /* low-level stream handling */
119 int lx_stream_set_format(struct lx6464es *chip, struct snd_pcm_runtime *runtime,
120 u32 pipe, int is_capture);
121 int lx_stream_state(struct lx6464es *chip, u32 pipe, int is_capture,
122 int *rstate);
123 int lx_stream_sample_position(struct lx6464es *chip, u32 pipe, int is_capture,
124 u64 *r_bytepos);
125
126 int lx_stream_set_state(struct lx6464es *chip, u32 pipe,
127 int is_capture, enum stream_state_t state);
128
lx_stream_start(struct lx6464es * chip,u32 pipe,int is_capture)129 static inline int lx_stream_start(struct lx6464es *chip, u32 pipe,
130 int is_capture)
131 {
132 return lx_stream_set_state(chip, pipe, is_capture, SSTATE_RUN);
133 }
134
lx_stream_pause(struct lx6464es * chip,u32 pipe,int is_capture)135 static inline int lx_stream_pause(struct lx6464es *chip, u32 pipe,
136 int is_capture)
137 {
138 return lx_stream_set_state(chip, pipe, is_capture, SSTATE_PAUSE);
139 }
140
lx_stream_stop(struct lx6464es * chip,u32 pipe,int is_capture)141 static inline int lx_stream_stop(struct lx6464es *chip, u32 pipe,
142 int is_capture)
143 {
144 return lx_stream_set_state(chip, pipe, is_capture, SSTATE_STOP);
145 }
146
147 /* low-level buffer handling */
148 int lx_buffer_ask(struct lx6464es *chip, u32 pipe, int is_capture,
149 u32 *r_needed, u32 *r_freed, u32 *size_array);
150 int lx_buffer_give(struct lx6464es *chip, u32 pipe, int is_capture,
151 u32 buffer_size, u32 buf_address_lo, u32 buf_address_hi,
152 u32 *r_buffer_index);
153 int lx_buffer_free(struct lx6464es *chip, u32 pipe, int is_capture,
154 u32 *r_buffer_size);
155 int lx_buffer_cancel(struct lx6464es *chip, u32 pipe, int is_capture,
156 u32 buffer_index);
157
158 /* low-level gain/peak handling */
159 int lx_level_unmute(struct lx6464es *chip, int is_capture, int unmute);
160 int lx_level_peaks(struct lx6464es *chip, int is_capture, int channels,
161 u32 *r_levels);
162
163
164 /* interrupt handling */
165 irqreturn_t lx_interrupt(int irq, void *dev_id);
166 irqreturn_t lx_threaded_irq(int irq, void *dev_id);
167 void lx_irq_enable(struct lx6464es *chip);
168 void lx_irq_disable(struct lx6464es *chip);
169
170
171 /* Stream Format Header Defines (for LIN and IEEE754) */
172 #define HEADER_FMT_BASE HEADER_FMT_BASE_LIN
173 #define HEADER_FMT_BASE_LIN 0xFED00000
174 #define HEADER_FMT_BASE_FLOAT 0xFAD00000
175 #define HEADER_FMT_MONO 0x00000080 /* bit 23 in header_lo. WARNING: old
176 * bit 22 is ignored in float
177 * format */
178 #define HEADER_FMT_INTEL 0x00008000
179 #define HEADER_FMT_16BITS 0x00002000
180 #define HEADER_FMT_24BITS 0x00004000
181 #define HEADER_FMT_UPTO11 0x00000200 /* frequency is less or equ. to 11k.
182 * */
183 #define HEADER_FMT_UPTO32 0x00000100 /* frequency is over 11k and less
184 * then 32k.*/
185
186
187 #define BIT_FMP_HEADER 23
188 #define BIT_FMP_SD 22
189 #define BIT_FMP_MULTICHANNEL 19
190
191 #define START_STATE 1
192 #define PAUSE_STATE 0
193
194
195
196
197
198 /* from PcxAll_e.h */
199 /* Start/Pause condition for pipes (PCXStartPipe, PCXPausePipe) */
200 #define START_PAUSE_IMMEDIATE 0
201 #define START_PAUSE_ON_SYNCHRO 1
202 #define START_PAUSE_ON_TIME_CODE 2
203
204
205 /* Pipe / Stream state */
206 #define START_STATE 1
207 #define PAUSE_STATE 0
208
unpack_pointer(dma_addr_t ptr,u32 * r_low,u32 * r_high)209 static inline void unpack_pointer(dma_addr_t ptr, u32 *r_low, u32 *r_high)
210 {
211 *r_low = (u32)(ptr & 0xffffffff);
212 #if BITS_PER_LONG == 32
213 *r_high = 0;
214 #else
215 *r_high = (u32)((u64)ptr>>32);
216 #endif
217 }
218
219 #endif /* LX_CORE_H */
220