]>
Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | #ifndef __SOUND_TRIDENT_H |
2 | #define __SOUND_TRIDENT_H | |
3 | ||
4 | /* | |
5 | * [email protected] | |
6 | * Fri Feb 19 15:55:28 MST 1999 | |
7 | * Definitions for Trident 4DWave DX/NX chips | |
8 | * | |
9 | * | |
10 | * This program is free software; you can redistribute it and/or modify | |
11 | * it under the terms of the GNU General Public License as published by | |
12 | * the Free Software Foundation; either version 2 of the License, or | |
13 | * (at your option) any later version. | |
14 | * | |
15 | * This program is distributed in the hope that it will be useful, | |
16 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 | * GNU General Public License for more details. | |
19 | * | |
20 | * You should have received a copy of the GNU General Public License | |
21 | * along with this program; if not, write to the Free Software | |
22 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
23 | * | |
24 | */ | |
25 | ||
26 | #include "pcm.h" | |
27 | #include "mpu401.h" | |
28 | #include "ac97_codec.h" | |
1da177e4 | 29 | #include "util_mem.h" |
1da177e4 | 30 | |
1da177e4 LT |
31 | #define TRIDENT_DEVICE_ID_DX ((PCI_VENDOR_ID_TRIDENT<<16)|PCI_DEVICE_ID_TRIDENT_4DWAVE_DX) |
32 | #define TRIDENT_DEVICE_ID_NX ((PCI_VENDOR_ID_TRIDENT<<16)|PCI_DEVICE_ID_TRIDENT_4DWAVE_NX) | |
33 | #define TRIDENT_DEVICE_ID_SI7018 ((PCI_VENDOR_ID_SI<<16)|PCI_DEVICE_ID_SI_7018) | |
34 | ||
1da177e4 LT |
35 | #define SNDRV_TRIDENT_VOICE_TYPE_PCM 0 |
36 | #define SNDRV_TRIDENT_VOICE_TYPE_SYNTH 1 | |
37 | #define SNDRV_TRIDENT_VOICE_TYPE_MIDI 2 | |
38 | ||
39 | #define SNDRV_TRIDENT_VFLG_RUNNING (1<<0) | |
40 | ||
41 | /* TLB code constants */ | |
42 | #define SNDRV_TRIDENT_PAGE_SIZE 4096 | |
43 | #define SNDRV_TRIDENT_PAGE_SHIFT 12 | |
44 | #define SNDRV_TRIDENT_PAGE_MASK ((1<<SNDRV_TRIDENT_PAGE_SHIFT)-1) | |
45 | #define SNDRV_TRIDENT_MAX_PAGES 4096 | |
46 | ||
47 | /* | |
48 | * Direct registers | |
49 | */ | |
50 | ||
51 | #define TRID_REG(trident, x) ((trident)->port + (x)) | |
52 | ||
53 | #define ID_4DWAVE_DX 0x2000 | |
54 | #define ID_4DWAVE_NX 0x2001 | |
55 | ||
56 | /* Bank definitions */ | |
57 | ||
58 | #define T4D_BANK_A 0 | |
59 | #define T4D_BANK_B 1 | |
60 | #define T4D_NUM_BANKS 2 | |
61 | ||
62 | /* Register definitions */ | |
63 | ||
64 | /* Global registers */ | |
65 | ||
66 | enum global_control_bits { | |
67 | CHANNEL_IDX = 0x0000003f, | |
68 | OVERRUN_IE = 0x00000400, /* interrupt enable: capture overrun */ | |
69 | UNDERRUN_IE = 0x00000800, /* interrupt enable: playback underrun */ | |
70 | ENDLP_IE = 0x00001000, /* interrupt enable: end of buffer */ | |
71 | MIDLP_IE = 0x00002000, /* interrupt enable: middle buffer */ | |
72 | ETOG_IE = 0x00004000, /* interrupt enable: envelope toggling */ | |
73 | EDROP_IE = 0x00008000, /* interrupt enable: envelope drop */ | |
74 | BANK_B_EN = 0x00010000, /* SiS: enable bank B (64 channels) */ | |
75 | PCMIN_B_MIX = 0x00020000, /* SiS: PCM IN B mixing enable */ | |
76 | I2S_OUT_ASSIGN = 0x00040000, /* SiS: I2S Out contains surround PCM */ | |
77 | SPDIF_OUT_ASSIGN= 0x00080000, /* SiS: 0=S/PDIF L/R | 1=PCM Out FIFO */ | |
78 | MAIN_OUT_ASSIGN = 0x00100000, /* SiS: 0=PCM Out FIFO | 1=MMC Out buffer */ | |
79 | }; | |
80 | ||
81 | enum miscint_bits { | |
82 | PB_UNDERRUN_IRQ = 0x00000001, REC_OVERRUN_IRQ = 0x00000002, | |
83 | SB_IRQ = 0x00000004, MPU401_IRQ = 0x00000008, | |
84 | OPL3_IRQ = 0x00000010, ADDRESS_IRQ = 0x00000020, | |
85 | ENVELOPE_IRQ = 0x00000040, PB_UNDERRUN = 0x00000100, | |
86 | REC_OVERRUN = 0x00000200, MIXER_UNDERFLOW = 0x00000400, | |
87 | MIXER_OVERFLOW = 0x00000800, NX_SB_IRQ_DISABLE = 0x00001000, | |
88 | ST_TARGET_REACHED = 0x00008000, | |
89 | PB_24K_MODE = 0x00010000, ST_IRQ_EN = 0x00800000, | |
90 | ACGPIO_IRQ = 0x01000000 | |
91 | }; | |
92 | ||
93 | /* T2 legacy dma control registers. */ | |
94 | #define LEGACY_DMAR0 0x00 // ADR0 | |
95 | #define LEGACY_DMAR4 0x04 // CNT0 | |
96 | #define LEGACY_DMAR6 0x06 // CNT0 - High bits | |
97 | #define LEGACY_DMAR11 0x0b // MOD | |
98 | #define LEGACY_DMAR15 0x0f // MMR | |
99 | ||
100 | #define T4D_START_A 0x80 | |
101 | #define T4D_STOP_A 0x84 | |
102 | #define T4D_DLY_A 0x88 | |
103 | #define T4D_SIGN_CSO_A 0x8c | |
104 | #define T4D_CSPF_A 0x90 | |
105 | #define T4D_CSPF_B 0xbc | |
106 | #define T4D_CEBC_A 0x94 | |
107 | #define T4D_AINT_A 0x98 | |
108 | #define T4D_AINTEN_A 0x9c | |
109 | #define T4D_LFO_GC_CIR 0xa0 | |
110 | #define T4D_MUSICVOL_WAVEVOL 0xa8 | |
111 | #define T4D_SBDELTA_DELTA_R 0xac | |
112 | #define T4D_MISCINT 0xb0 | |
113 | #define T4D_START_B 0xb4 | |
114 | #define T4D_STOP_B 0xb8 | |
115 | #define T4D_SBBL_SBCL 0xc0 | |
116 | #define T4D_SBCTRL_SBE2R_SBDD 0xc4 | |
117 | #define T4D_STIMER 0xc8 | |
118 | #define T4D_AINT_B 0xd8 | |
119 | #define T4D_AINTEN_B 0xdc | |
120 | #define T4D_RCI 0x70 | |
121 | ||
122 | /* MPU-401 UART */ | |
123 | #define T4D_MPU401_BASE 0x20 | |
124 | #define T4D_MPUR0 0x20 | |
125 | #define T4D_MPUR1 0x21 | |
126 | #define T4D_MPUR2 0x22 | |
127 | #define T4D_MPUR3 0x23 | |
128 | ||
129 | /* S/PDIF Registers */ | |
130 | #define NX_SPCTRL_SPCSO 0x24 | |
131 | #define NX_SPLBA 0x28 | |
132 | #define NX_SPESO 0x2c | |
133 | #define NX_SPCSTATUS 0x64 | |
134 | ||
135 | /* Joystick */ | |
136 | #define GAMEPORT_GCR 0x30 | |
137 | #define GAMEPORT_MODE_ADC 0x80 | |
138 | #define GAMEPORT_LEGACY 0x31 | |
139 | #define GAMEPORT_AXES 0x34 | |
140 | ||
141 | /* NX Specific Registers */ | |
142 | #define NX_TLBC 0x6c | |
143 | ||
144 | /* Channel Registers */ | |
145 | ||
146 | #define CH_START 0xe0 | |
147 | ||
148 | #define CH_DX_CSO_ALPHA_FMS 0xe0 | |
149 | #define CH_DX_ESO_DELTA 0xe8 | |
150 | #define CH_DX_FMC_RVOL_CVOL 0xec | |
151 | ||
152 | #define CH_NX_DELTA_CSO 0xe0 | |
153 | #define CH_NX_DELTA_ESO 0xe8 | |
154 | #define CH_NX_ALPHA_FMS_FMC_RVOL_CVOL 0xec | |
155 | ||
156 | #define CH_LBA 0xe4 | |
157 | #define CH_GVSEL_PAN_VOL_CTRL_EC 0xf0 | |
158 | #define CH_EBUF1 0xf4 | |
159 | #define CH_EBUF2 0xf8 | |
160 | ||
161 | /* AC-97 Registers */ | |
162 | ||
163 | #define DX_ACR0_AC97_W 0x40 | |
164 | #define DX_ACR1_AC97_R 0x44 | |
165 | #define DX_ACR2_AC97_COM_STAT 0x48 | |
166 | ||
167 | #define NX_ACR0_AC97_COM_STAT 0x40 | |
168 | #define NX_ACR1_AC97_W 0x44 | |
169 | #define NX_ACR2_AC97_R_PRIMARY 0x48 | |
170 | #define NX_ACR3_AC97_R_SECONDARY 0x4c | |
171 | ||
172 | #define SI_AC97_WRITE 0x40 | |
173 | #define SI_AC97_READ 0x44 | |
174 | #define SI_SERIAL_INTF_CTRL 0x48 | |
175 | #define SI_AC97_GPIO 0x4c | |
176 | #define SI_ASR0 0x50 | |
177 | #define SI_SPDIF_CS 0x70 | |
178 | #define SI_GPIO 0x7c | |
179 | ||
180 | enum trident_nx_ac97_bits { | |
181 | /* ACR1-3 */ | |
182 | NX_AC97_BUSY_WRITE = 0x0800, | |
183 | NX_AC97_BUSY_READ = 0x0800, | |
184 | NX_AC97_BUSY_DATA = 0x0400, | |
185 | NX_AC97_WRITE_SECONDARY = 0x0100, | |
186 | /* ACR0 */ | |
187 | NX_AC97_SECONDARY_READY = 0x0040, | |
188 | NX_AC97_SECONDARY_RECORD = 0x0020, | |
189 | NX_AC97_SURROUND_OUTPUT = 0x0010, | |
190 | NX_AC97_PRIMARY_READY = 0x0008, | |
191 | NX_AC97_PRIMARY_RECORD = 0x0004, | |
192 | NX_AC97_PCM_OUTPUT = 0x0002, | |
193 | NX_AC97_WARM_RESET = 0x0001 | |
194 | }; | |
195 | ||
196 | enum trident_dx_ac97_bits { | |
197 | DX_AC97_BUSY_WRITE = 0x8000, | |
198 | DX_AC97_BUSY_READ = 0x8000, | |
199 | DX_AC97_READY = 0x0010, | |
200 | DX_AC97_RECORD = 0x0008, | |
201 | DX_AC97_PLAYBACK = 0x0002 | |
202 | }; | |
203 | ||
204 | enum sis7018_ac97_bits { | |
205 | SI_AC97_BUSY_WRITE = 0x00008000, | |
206 | SI_AC97_AUDIO_BUSY = 0x00004000, | |
207 | SI_AC97_MODEM_BUSY = 0x00002000, | |
208 | SI_AC97_BUSY_READ = 0x00008000, | |
209 | SI_AC97_SECONDARY = 0x00000080, | |
210 | }; | |
211 | ||
212 | enum serial_intf_ctrl_bits { | |
213 | WARM_RESET = 0x00000001, | |
214 | COLD_RESET = 0x00000002, | |
215 | I2S_CLOCK = 0x00000004, | |
216 | PCM_SEC_AC97 = 0x00000008, | |
217 | AC97_DBL_RATE = 0x00000010, | |
218 | SPDIF_EN = 0x00000020, | |
219 | I2S_OUTPUT_EN = 0x00000040, | |
220 | I2S_INPUT_EN = 0x00000080, | |
221 | PCMIN = 0x00000100, | |
222 | LINE1IN = 0x00000200, | |
223 | MICIN = 0x00000400, | |
224 | LINE2IN = 0x00000800, | |
225 | HEAD_SET_IN = 0x00001000, | |
226 | GPIOIN = 0x00002000, | |
227 | /* 7018 spec says id = 01 but the demo board routed to 10 | |
228 | SECONDARY_ID= 0x00004000, */ | |
229 | SECONDARY_ID = 0x00004000, | |
230 | PCMOUT = 0x00010000, | |
231 | SURROUT = 0x00020000, | |
232 | CENTEROUT = 0x00040000, | |
233 | LFEOUT = 0x00080000, | |
234 | LINE1OUT = 0x00100000, | |
235 | LINE2OUT = 0x00200000, | |
236 | GPIOOUT = 0x00400000, | |
237 | SI_AC97_PRIMARY_READY = 0x01000000, | |
238 | SI_AC97_SECONDARY_READY = 0x02000000, | |
239 | SI_AC97_POWERDOWN = 0x04000000, | |
240 | }; | |
241 | ||
242 | /* PCM defaults */ | |
243 | ||
244 | #define T4D_DEFAULT_PCM_VOL 10 /* 0 - 255 */ | |
245 | #define T4D_DEFAULT_PCM_PAN 0 /* 0 - 127 */ | |
246 | #define T4D_DEFAULT_PCM_RVOL 127 /* 0 - 127 */ | |
247 | #define T4D_DEFAULT_PCM_CVOL 127 /* 0 - 127 */ | |
248 | ||
bee1a5be TI |
249 | struct snd_trident; |
250 | struct snd_trident_voice; | |
251 | struct snd_trident_pcm_mixer; | |
252 | ||
bee1a5be TI |
253 | struct snd_trident_port { |
254 | struct snd_midi_channel_set * chset; | |
255 | struct snd_trident * trident; | |
1da177e4 LT |
256 | int mode; /* operation mode */ |
257 | int client; /* sequencer client number */ | |
258 | int port; /* sequencer port number */ | |
259 | unsigned int midi_has_voices: 1; | |
bee1a5be | 260 | }; |
1da177e4 | 261 | |
bee1a5be | 262 | struct snd_trident_memblk_arg { |
1da177e4 | 263 | short first_page, last_page; |
bee1a5be | 264 | }; |
1da177e4 | 265 | |
bee1a5be | 266 | struct snd_trident_tlb { |
1da177e4 LT |
267 | unsigned int * entries; /* 16k-aligned TLB table */ |
268 | dma_addr_t entries_dmaaddr; /* 16k-aligned PCI address to TLB table */ | |
269 | unsigned long * shadow_entries; /* shadow entries with virtual addresses */ | |
270 | struct snd_dma_buffer buffer; | |
bee1a5be | 271 | struct snd_util_memhdr * memhdr; /* page allocation list */ |
1da177e4 | 272 | struct snd_dma_buffer silent_page; |
bee1a5be | 273 | }; |
1da177e4 | 274 | |
bee1a5be | 275 | struct snd_trident_voice { |
1da177e4 LT |
276 | unsigned int number; |
277 | unsigned int use: 1, | |
278 | pcm: 1, | |
279 | synth:1, | |
280 | midi: 1; | |
281 | unsigned int flags; | |
282 | unsigned char client; | |
283 | unsigned char port; | |
284 | unsigned char index; | |
285 | ||
bee1a5be | 286 | struct snd_trident_sample_ops *sample_ops; |
1da177e4 LT |
287 | |
288 | /* channel parameters */ | |
289 | unsigned int CSO; /* 24 bits (16 on DX) */ | |
290 | unsigned int ESO; /* 24 bits (16 on DX) */ | |
291 | unsigned int LBA; /* 30 bits */ | |
292 | unsigned short EC; /* 12 bits */ | |
293 | unsigned short Alpha; /* 12 bits */ | |
294 | unsigned short Delta; /* 16 bits */ | |
295 | unsigned short Attribute; /* 16 bits - SiS 7018 */ | |
296 | unsigned short Vol; /* 12 bits (6.6) */ | |
297 | unsigned char Pan; /* 7 bits (1.4.2) */ | |
298 | unsigned char GVSel; /* 1 bit */ | |
299 | unsigned char RVol; /* 7 bits (5.2) */ | |
300 | unsigned char CVol; /* 7 bits (5.2) */ | |
301 | unsigned char FMC; /* 2 bits */ | |
302 | unsigned char CTRL; /* 4 bits */ | |
303 | unsigned char FMS; /* 4 bits */ | |
304 | unsigned char LFO; /* 8 bits */ | |
305 | ||
306 | unsigned int negCSO; /* nonzero - use negative CSO */ | |
307 | ||
bee1a5be | 308 | struct snd_util_memblk *memblk; /* memory block if TLB enabled */ |
1da177e4 LT |
309 | |
310 | /* PCM data */ | |
311 | ||
bee1a5be TI |
312 | struct snd_trident *trident; |
313 | struct snd_pcm_substream *substream; | |
314 | struct snd_trident_voice *extra; /* extra PCM voice (acts as interrupt generator) */ | |
1da177e4 LT |
315 | unsigned int running: 1, |
316 | capture: 1, | |
317 | spdif: 1, | |
318 | foldback: 1, | |
319 | isync: 1, | |
320 | isync2: 1, | |
321 | isync3: 1; | |
322 | int foldback_chan; /* foldback subdevice number */ | |
323 | unsigned int stimer; /* global sample timer (to detect spurious interrupts) */ | |
324 | unsigned int spurious_threshold; /* spurious threshold */ | |
325 | unsigned int isync_mark; | |
326 | unsigned int isync_max; | |
327 | unsigned int isync_ESO; | |
328 | ||
329 | /* --- */ | |
330 | ||
331 | void *private_data; | |
bee1a5be | 332 | void (*private_free)(struct snd_trident_voice *voice); |
1da177e4 LT |
333 | }; |
334 | ||
bee1a5be | 335 | struct snd_4dwave { |
1da177e4 LT |
336 | int seq_client; |
337 | ||
bee1a5be | 338 | struct snd_trident_port seq_ports[4]; |
bee1a5be | 339 | struct snd_trident_voice voices[64]; |
1da177e4 LT |
340 | |
341 | int ChanSynthCount; /* number of allocated synth channels */ | |
342 | int max_size; /* maximum synth memory size in bytes */ | |
343 | int current_size; /* current allocated synth mem in bytes */ | |
344 | }; | |
345 | ||
bee1a5be TI |
346 | struct snd_trident_pcm_mixer { |
347 | struct snd_trident_voice *voice; /* active voice */ | |
1da177e4 LT |
348 | unsigned short vol; /* front volume */ |
349 | unsigned char pan; /* pan control */ | |
350 | unsigned char rvol; /* rear volume */ | |
351 | unsigned char cvol; /* center volume */ | |
352 | unsigned char pad; | |
353 | }; | |
354 | ||
bee1a5be | 355 | struct snd_trident { |
1da177e4 LT |
356 | int irq; |
357 | ||
358 | unsigned int device; /* device ID */ | |
359 | ||
360 | unsigned char bDMAStart; | |
361 | ||
362 | unsigned long port; | |
363 | unsigned long midi_port; | |
364 | ||
365 | unsigned int spurious_irq_count; | |
366 | unsigned int spurious_irq_max_delta; | |
367 | ||
bee1a5be | 368 | struct snd_trident_tlb tlb; /* TLB entries for NX cards */ |
1da177e4 LT |
369 | |
370 | unsigned char spdif_ctrl; | |
371 | unsigned char spdif_pcm_ctrl; | |
372 | unsigned int spdif_bits; | |
373 | unsigned int spdif_pcm_bits; | |
bee1a5be | 374 | struct snd_kcontrol *spdif_pcm_ctl; /* S/PDIF settings */ |
1da177e4 LT |
375 | unsigned int ac97_ctrl; |
376 | ||
377 | unsigned int ChanMap[2]; /* allocation map for hardware channels */ | |
378 | ||
379 | int ChanPCM; /* max number of PCM channels */ | |
380 | int ChanPCMcnt; /* actual number of PCM channels */ | |
381 | ||
382 | unsigned int ac97_detect: 1; /* 1 = AC97 in detection phase */ | |
383 | unsigned int in_suspend: 1; /* 1 during suspend/resume */ | |
384 | ||
bee1a5be | 385 | struct snd_4dwave synth; /* synth specific variables */ |
1da177e4 LT |
386 | |
387 | spinlock_t event_lock; | |
388 | spinlock_t voice_alloc; | |
389 | ||
390 | struct snd_dma_device dma_dev; | |
391 | ||
392 | struct pci_dev *pci; | |
bee1a5be TI |
393 | struct snd_card *card; |
394 | struct snd_pcm *pcm; /* ADC/DAC PCM */ | |
395 | struct snd_pcm *foldback; /* Foldback PCM */ | |
396 | struct snd_pcm *spdif; /* SPDIF PCM */ | |
397 | struct snd_rawmidi *rmidi; | |
1da177e4 | 398 | |
bee1a5be TI |
399 | struct snd_ac97_bus *ac97_bus; |
400 | struct snd_ac97 *ac97; | |
401 | struct snd_ac97 *ac97_sec; | |
1da177e4 LT |
402 | |
403 | unsigned int musicvol_wavevol; | |
bee1a5be TI |
404 | struct snd_trident_pcm_mixer pcm_mixer[32]; |
405 | struct snd_kcontrol *ctl_vol; /* front volume */ | |
406 | struct snd_kcontrol *ctl_pan; /* pan */ | |
407 | struct snd_kcontrol *ctl_rvol; /* rear volume */ | |
408 | struct snd_kcontrol *ctl_cvol; /* center volume */ | |
1da177e4 LT |
409 | |
410 | spinlock_t reg_lock; | |
411 | ||
412 | struct gameport *gameport; | |
413 | }; | |
414 | ||
bee1a5be | 415 | int snd_trident_create(struct snd_card *card, |
1da177e4 LT |
416 | struct pci_dev *pci, |
417 | int pcm_streams, | |
418 | int pcm_spdif_device, | |
419 | int max_wavetable_size, | |
bee1a5be TI |
420 | struct snd_trident ** rtrident); |
421 | int snd_trident_create_gameport(struct snd_trident *trident); | |
422 | ||
423 | int snd_trident_pcm(struct snd_trident * trident, int device, struct snd_pcm **rpcm); | |
424 | int snd_trident_foldback_pcm(struct snd_trident * trident, int device, struct snd_pcm **rpcm); | |
425 | int snd_trident_spdif_pcm(struct snd_trident * trident, int device, struct snd_pcm **rpcm); | |
426 | int snd_trident_attach_synthesizer(struct snd_trident * trident); | |
427 | struct snd_trident_voice *snd_trident_alloc_voice(struct snd_trident * trident, int type, | |
428 | int client, int port); | |
429 | void snd_trident_free_voice(struct snd_trident * trident, struct snd_trident_voice *voice); | |
430 | void snd_trident_start_voice(struct snd_trident * trident, unsigned int voice); | |
431 | void snd_trident_stop_voice(struct snd_trident * trident, unsigned int voice); | |
432 | void snd_trident_write_voice_regs(struct snd_trident * trident, struct snd_trident_voice *voice); | |
fb0700b4 TI |
433 | int snd_trident_suspend(struct pci_dev *pci, pm_message_t state); |
434 | int snd_trident_resume(struct pci_dev *pci); | |
1da177e4 LT |
435 | |
436 | /* TLB memory allocation */ | |
bee1a5be TI |
437 | struct snd_util_memblk *snd_trident_alloc_pages(struct snd_trident *trident, |
438 | struct snd_pcm_substream *substream); | |
439 | int snd_trident_free_pages(struct snd_trident *trident, struct snd_util_memblk *blk); | |
440 | struct snd_util_memblk *snd_trident_synth_alloc(struct snd_trident *trident, unsigned int size); | |
441 | int snd_trident_synth_free(struct snd_trident *trident, struct snd_util_memblk *blk); | |
442 | int snd_trident_synth_copy_from_user(struct snd_trident *trident, struct snd_util_memblk *blk, | |
443 | int offset, const char __user *data, int size); | |
1da177e4 LT |
444 | |
445 | #endif /* __SOUND_TRIDENT_H */ |