2 * Driver for Digigram VX soundcards
4 * Definitions of DSP commands
6 * Copyright (c) 2002 by Takashi Iwai <tiwai@suse.de>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
37 CMD_PARAM_OUTPUT_PIPE,
47 CMD_STREAM_OUT_LEVEL_ADJUST,
49 CMD_FORMAT_STREAM_OUT,
53 CMD_GET_REMAINING_BYTES,
55 CMD_AUDIO_LEVEL_ADJUST,
56 CMD_AUDIO_VU_PIC_METER,
63 CMD_LOAD_EFFECT_CONTEXT,
66 CMD_STREAM1_OUT_SET_N_LEVELS,
67 CMD_PURGE_STREAM_DCMDS,
69 CMD_LOAD_EFFECT_CONTEXT_PACKET,
71 CMD_RESYNC_AUDIO_INPUTS,
72 CMD_NOTIFY_STREAM_TIME,
73 CMD_STREAM_SAMPLE_COUNT,
77 CMD_PARAMETER_STREAM_OUT,
79 CMD_GET_STREAM_LEVELS,
81 // CMD_SET_STREAM_OUT_EFFECTS,
82 // CMD_GET_STREAM_OUT_EFFECTS,
83 CMD_CONNECT_MONITORING,
84 CMD_STREAM2_OUT_SET_N_LEVELS,
86 CMD_NOTIFY_END_OF_BUFFER,
87 CMD_GET_STREAM_VU_METER,
92 unsigned int opcode; /* command word */
93 int length; /* command length (in words) */
94 int st_type; /* status type (RMH_SSIZE_XXX) */
95 int st_length; /* fixed length */
98 /* Family and code op of some DSP requests. */
99 #define CODE_OP_PIPE_TIME 0x004e0000
100 #define CODE_OP_START_STREAM 0x00800000
101 #define CODE_OP_PAUSE_STREAM 0x00810000
102 #define CODE_OP_OUT_STREAM_LEVEL 0x00820000
103 #define CODE_OP_UPDATE_R_BUFFERS 0x00840000
104 #define CODE_OP_OUT_STREAM1_LEVEL_CURVE 0x00850000
105 #define CODE_OP_OUT_STREAM2_LEVEL_CURVE 0x00930000
106 #define CODE_OP_OUT_STREAM_FORMAT 0x00860000
107 #define CODE_OP_STREAM_TIME 0x008f0000
108 #define CODE_OP_OUT_STREAM_EXTRAPARAMETER 0x00910000
109 #define CODE_OP_OUT_AUDIO_LEVEL 0x00c20000
111 #define NOTIFY_LAST_COMMAND 0x00400000
113 /* Values for a user delay */
114 #define DC_DIFFERED_DELAY (1<<BIT_DIFFERED_COMMAND)
115 #define DC_NOTIFY_DELAY (1<<BIT_NOTIFIED_COMMAND)
116 #define DC_HBUFFER_DELAY (1<<BIT_TIME_RELATIVE_TO_BUFFER)
117 #define DC_MULTIPLE_DELAY (1<<BIT_RESERVED)
118 #define DC_STREAM_TIME_DELAY (1<<BIT_STREAM_TIME)
119 #define DC_CANCELLED_DELAY (1<<BIT_CANCELLED_COMMAND)
121 /* Values for tiDelayed field in TIME_INFO structure,
122 * and for pbPause field in PLAY_BUFFER_INFO structure
124 #define BIT_DIFFERED_COMMAND 0
125 #define BIT_NOTIFIED_COMMAND 1
126 #define BIT_TIME_RELATIVE_TO_BUFFER 2
127 #define BIT_RESERVED 3
128 #define BIT_STREAM_TIME 4
129 #define BIT_CANCELLED_COMMAND 5
131 /* Access to the "Size" field of the response of the CMD_GET_NOTIFY_EVENT request. */
132 #define GET_NOTIFY_EVENT_SIZE_FIELD_MASK 0x000000ff
134 /* DSP commands general masks */
135 #define OPCODE_MASK 0x00ff0000
136 #define DSP_DIFFERED_COMMAND_MASK 0x0000C000
138 /* Notifications (NOTIFY_INFO) */
139 #define ALL_CMDS_NOTIFIED 0x0000 // reserved
140 #define START_STREAM_NOTIFIED 0x0001
141 #define PAUSE_STREAM_NOTIFIED 0x0002
142 #define OUT_STREAM_LEVEL_NOTIFIED 0x0003
143 #define OUT_STREAM_PARAMETER_NOTIFIED 0x0004 // left for backward compatibility
144 #define OUT_STREAM_FORMAT_NOTIFIED 0x0004
145 #define PIPE_TIME_NOTIFIED 0x0005
146 #define OUT_AUDIO_LEVEL_NOTIFIED 0x0006
147 #define OUT_STREAM_LEVEL_CURVE_NOTIFIED 0x0007
148 #define STREAM_TIME_NOTIFIED 0x0008
149 #define OUT_STREAM_EXTRAPARAMETER_NOTIFIED 0x0009
150 #define UNKNOWN_COMMAND_NOTIFIED 0xffff
152 /* Output pipe parameters setting */
153 #define MASK_VALID_PIPE_MPEG_PARAM 0x000040
154 #define MASK_VALID_PIPE_BACKWARD_PARAM 0x000020
155 #define MASK_SET_PIPE_MPEG_PARAM 0x000002
156 #define MASK_SET_PIPE_BACKWARD_PARAM 0x000001
158 #define MASK_DSP_WORD 0x00FFFFFF
159 #define MASK_ALL_STREAM 0x00FFFFFF
160 #define MASK_DSP_WORD_LEVEL 0x000001FF
161 #define MASK_FIRST_FIELD 0x0000001F
164 #define COMMAND_RECORD_MASK 0x000800
166 /* PipeManagement definition bits (PIPE_DECL_INFO) */
167 #define P_UNDERRUN_SKIP_SOUND_MASK 0x01
168 #define P_PREPARE_FOR_MPEG3_MASK 0x02
169 #define P_DO_NOT_RESET_ANALOG_LEVELS 0x04
170 #define P_ALLOW_UNDER_ALLOCATION_MASK 0x08
171 #define P_DATA_MODE_MASK 0x10
172 #define P_ASIO_BUFFER_MANAGEMENT_MASK 0x20
174 #define BIT_SKIP_SOUND 0x08 // bit 3
175 #define BIT_DATA_MODE 0x10 // bit 4
177 /* Bits in the CMD_MODIFY_CLOCK request. */
178 #define CMD_MODIFY_CLOCK_FD_BIT 0x00000001
179 #define CMD_MODIFY_CLOCK_T_BIT 0x00000002
180 #define CMD_MODIFY_CLOCK_S_BIT 0x00000004
182 /* Access to the results of the CMD_GET_TIME_CODE RMH. */
183 #define TIME_CODE_V_MASK 0x00800000
184 #define TIME_CODE_N_MASK 0x00400000
185 #define TIME_CODE_B_MASK 0x00200000
186 #define TIME_CODE_W_MASK 0x00100000
188 /* Values for the CMD_MANAGE_SIGNAL RMH. */
189 #define MANAGE_SIGNAL_TIME_CODE 0x01
190 #define MANAGE_SIGNAL_MIDI 0x02
192 /* Values for the CMD_CONFIG_TIME_CODE RMH. */
193 #define CONFIG_TIME_CODE_CANCEL 0x00001000
195 /* Mask to get only the effective time from the
196 * high word out of the 2 returned by the DSP
198 #define PCX_TIME_HI_MASK 0x000fffff
200 /* Values for setting a H-Buffer time */
201 #define HBUFFER_TIME_HIGH 0x00200000
202 #define HBUFFER_TIME_LOW 0x00000000
204 #define NOTIFY_MASK_TIME_HIGH 0x00400000
205 #define MULTIPLE_MASK_TIME_HIGH 0x00100000
206 #define STREAM_MASK_TIME_HIGH 0x00800000
212 void vx_init_rmh(struct vx_rmh *rmh, unsigned int cmd);
215 * vx_send_pipe_cmd_params - fill first command word for pipe commands
216 * @rmh: the rmh to be modified
217 * @is_capture: 0 = playback, 1 = capture operation
218 * @param1: first pipe-parameter
219 * @param2: second pipe-parameter
221 static inline void vx_set_pipe_cmd_params(struct vx_rmh *rmh, int is_capture,
222 int param1, int param2)
225 rmh->Cmd[0] |= COMMAND_RECORD_MASK;
226 rmh->Cmd[0] |= (((u32)param1 & MASK_FIRST_FIELD) << FIELD_SIZE) & MASK_DSP_WORD;
229 rmh->Cmd[0] |= ((u32)param2 & MASK_FIRST_FIELD) & MASK_DSP_WORD;
234 * vx_set_stream_cmd_params - fill first command word for stream commands
235 * @rmh: the rmh to be modified
236 * @is_capture: 0 = playback, 1 = capture operation
237 * @pipe: the pipe index (zero-based)
239 static inline void vx_set_stream_cmd_params(struct vx_rmh *rmh, int is_capture, int pipe)
242 rmh->Cmd[0] |= COMMAND_RECORD_MASK;
243 rmh->Cmd[0] |= (((u32)pipe & MASK_FIRST_FIELD) << FIELD_SIZE) & MASK_DSP_WORD;
246 #endif /* __VX_CMD_H */