2 * For the STS-Thompson TDA7432 audio processor chip
4 * Handles audio functions: volume, balance, tone, loudness
5 * This driver will not complain if used with any
6 * other i2c device with the same address.
8 * Muting and tone control by Jonathan Isom <jisom@ematic.com>
10 * Copyright (c) 2000 Eric Sandeen <eric_sandeen@bigfoot.com>
11 * This code is placed under the terms of the GNU General Public License
12 * Based on tda9855.c by Steve VanDeBogart (vandebo@uclink.berkeley.edu)
13 * Which was based on tda8425.c by Greg Alexander (c) 1998
16 * debug - set to 1 if you'd like to see debug messages
17 * set to 2 if you'd like to be inundated with debug messages
19 * loudness - set between 0 and 15 for varying degrees of loudness effect
21 * maxvol - set maximium volume to +20db (1), default is 0db(0)
24 * Revision: 0.7 - maxvol module parm to set maximium volume 0db or +20db
25 * store if muted so we can return it
26 * change balance only if flaged to
27 * Revision: 0.6 - added tone controls
28 * Revision: 0.5 - Fixed odd balance problem
29 * Revision: 0.4 - added muting
30 * Revision: 0.3 - Fixed silly reversed volume controls. :)
31 * Revision: 0.2 - Cleaned up #defines
32 * fixed volume control
33 * Added I2C_DRIVERID_TDA7432
34 * added loudness insmod control
35 * Revision: 0.1 - initial version
38 #include <linux/module.h>
39 #include <linux/init.h>
40 #include <linux/kernel.h>
41 #include <linux/sched.h>
42 #include <linux/string.h>
43 #include <linux/timer.h>
44 #include <linux/delay.h>
45 #include <linux/errno.h>
46 #include <linux/slab.h>
47 #include <linux/videodev.h>
48 #include <linux/i2c.h>
49 #include <linux/i2c-algo-bit.h>
52 #include <media/audiochip.h>
53 #include <media/v4l2-common.h>
55 #ifndef VIDEO_AUDIO_BALANCE
56 # define VIDEO_AUDIO_BALANCE 32
59 MODULE_AUTHOR("Eric Sandeen <eric_sandeen@bigfoot.com>");
60 MODULE_DESCRIPTION("bttv driver for the tda7432 audio processor chip");
61 MODULE_LICENSE("GPL");
64 static int loudness
; /* disable loudness by default */
65 static int debug
; /* insmod parameter */
66 module_param(debug
, int, S_IRUGO
| S_IWUSR
);
67 module_param(loudness
, int, S_IRUGO
);
68 MODULE_PARM_DESC(maxvol
,"Set maximium volume to +20db (0), default is 0db(1)");
69 module_param(maxvol
, int, S_IRUGO
| S_IWUSR
);
72 /* Address to scan (I2C address of this chip) */
73 static unsigned short normal_i2c
[] = {
79 /* Structure of address and subaddresses for the tda7432 */
91 static struct i2c_driver driver
;
92 static struct i2c_client client_template
;
94 /* The TDA7432 is made by STS-Thompson
96 * http://us.st.com/stonline/books/pdf/docs/4056.pdf
98 * TDA7432: I2C-bus controlled basic audio processor
100 * The TDA7432 controls basic audio functions like volume, balance,
101 * and tone control (including loudness). It also has four channel
102 * output (for front and rear). Since most vidcap cards probably
103 * don't have 4 channel output, this driver will set front & rear
104 * together (no independent control).
107 /* Subaddresses for TDA7432 */
109 #define TDA7432_IN 0x00 /* Input select */
110 #define TDA7432_VL 0x01 /* Volume */
111 #define TDA7432_TN 0x02 /* Bass, Treble (Tone) */
112 #define TDA7432_LF 0x03 /* Attenuation LF (Left Front) */
113 #define TDA7432_LR 0x04 /* Attenuation LR (Left Rear) */
114 #define TDA7432_RF 0x05 /* Attenuation RF (Right Front) */
115 #define TDA7432_RR 0x06 /* Attenuation RR (Right Rear) */
116 #define TDA7432_LD 0x07 /* Loudness */
119 /* Masks for bits in TDA7432 subaddresses */
121 /* Many of these not used - just for documentation */
123 /* Subaddress 0x00 - Input selection and bass control */
125 /* Bits 0,1,2 control input:
126 * 0x00 - Stereo input
128 * 0x03 - Mute (Using Attenuators Plays better with modules)
129 * Mono probably isn't used - I'm guessing only the stereo
130 * input is connected on most cards, so we'll set it to stereo.
132 * Bit 3 controls bass cut: 0/1 is non-symmetric/symmetric bass cut
133 * Bit 4 controls bass range: 0/1 is extended/standard bass range
135 * Highest 3 bits not used
138 #define TDA7432_STEREO_IN 0
139 #define TDA7432_MONO_IN 2 /* Probably won't be used */
140 #define TDA7432_BASS_SYM 1 << 3
141 #define TDA7432_BASS_NORM 1 << 4
143 /* Subaddress 0x01 - Volume */
145 /* Lower 7 bits control volume from -79dB to +32dB in 1dB steps
146 * Recommended maximum is +20 dB
153 * MSB (bit 7) controls loudness: 1/0 is loudness on/off
156 #define TDA7432_VOL_0DB 0x20
157 #define TDA7432_LD_ON 1 << 7
160 /* Subaddress 0x02 - Tone control */
162 /* Bits 0,1,2 control absolute treble gain from 0dB to 14dB
163 * 0x0 is 14dB, 0x7 is 0dB
165 * Bit 3 controls treble attenuation/gain (sign)
167 * 0 = attenuation (-)
169 * Bits 4,5,6 control absolute bass gain from 0dB to 14dB
170 * (This is only true for normal base range, set in 0x00)
171 * 0x0 << 4 is 14dB, 0x7 is 0dB
173 * Bit 7 controls bass attenuation/gain (sign)
175 * 0 << 7 = attenuation (-)
178 * 1 1 0 1 0 1 0 1 is +4dB bass, -4dB treble
181 #define TDA7432_TREBLE_0DB 0xf
182 #define TDA7432_TREBLE 7
183 #define TDA7432_TREBLE_GAIN 1 << 3
184 #define TDA7432_BASS_0DB 0xf
185 #define TDA7432_BASS 7 << 4
186 #define TDA7432_BASS_GAIN 1 << 7
189 /* Subaddress 0x03 - Left Front attenuation */
190 /* Subaddress 0x04 - Left Rear attenuation */
191 /* Subaddress 0x05 - Right Front attenuation */
192 /* Subaddress 0x06 - Right Rear attenuation */
194 /* Bits 0,1,2,3,4 control attenuation from 0dB to -37.5dB
200 * Bit 5 mutes that channel when set (1 = mute, 0 = unmute)
201 * We'll use the mute on the input, though (above)
205 #define TDA7432_ATTEN_0DB 0x00
206 #define TDA7432_MUTE 0x1 << 5
209 /* Subaddress 0x07 - Loudness Control */
211 /* Bits 0,1,2,3 control loudness from 0dB to -15dB in 1dB steps
212 * when bit 4 is NOT set
217 * If bit 4 is set, then there is a flat attenuation according to
218 * the lower 4 bits, as above.
227 static int tda7432_write(struct i2c_client
*client
, int subaddr
, int val
)
229 unsigned char buffer
[2];
230 v4l_dbg(2, debug
,client
,"In tda7432_write\n");
231 v4l_dbg(1, debug
,client
,"Writing %d 0x%x\n", subaddr
, val
);
234 if (2 != i2c_master_send(client
,buffer
,2)) {
235 v4l_err(client
,"I/O error, trying (write %d 0x%x)\n",
242 /* I don't think we ever actually _read_ the chip... */
244 static int tda7432_set(struct i2c_client
*client
)
246 struct tda7432
*t
= i2c_get_clientdata(client
);
247 unsigned char buf
[16];
248 v4l_dbg(2, debug
,client
,"In tda7432_set\n");
250 v4l_dbg(1, debug
,client
,
251 "tda7432: 7432_set(0x%02x,0x%02x,0x%02x,0x%02x,0x%02x,0x%02x,0x%02x,0x%02x,0x%02x)\n",
252 t
->input
,t
->volume
,t
->bass
,t
->treble
,t
->lf
,t
->lr
,t
->rf
,t
->rr
,t
->loud
);
263 if (10 != i2c_master_send(client
,buf
,10)) {
264 v4l_err(client
,"I/O error, trying tda7432_set\n");
271 static void do_tda7432_init(struct i2c_client
*client
)
273 struct tda7432
*t
= i2c_get_clientdata(client
);
274 v4l_dbg(2, debug
,client
,"In tda7432_init\n");
276 t
->input
= TDA7432_STEREO_IN
| /* Main (stereo) input */
277 TDA7432_BASS_SYM
| /* Symmetric bass cut */
278 TDA7432_BASS_NORM
; /* Normal bass range */
279 t
->volume
= 0x3b ; /* -27dB Volume */
280 if (loudness
) /* Turn loudness on? */
281 t
->volume
|= TDA7432_LD_ON
;
282 t
->muted
= VIDEO_AUDIO_MUTE
;
283 t
->treble
= TDA7432_TREBLE_0DB
; /* 0dB Treble */
284 t
->bass
= TDA7432_BASS_0DB
; /* 0dB Bass */
285 t
->lf
= TDA7432_ATTEN_0DB
; /* 0dB attenuation */
286 t
->lr
= TDA7432_ATTEN_0DB
; /* 0dB attenuation */
287 t
->rf
= TDA7432_ATTEN_0DB
; /* 0dB attenuation */
288 t
->rr
= TDA7432_ATTEN_0DB
; /* 0dB attenuation */
289 t
->loud
= loudness
; /* insmod parameter */
294 /* *********************** *
295 * i2c interface functions *
296 * *********************** */
298 static int tda7432_attach(struct i2c_adapter
*adap
, int addr
, int kind
)
301 struct i2c_client
*client
;
303 t
= kzalloc(sizeof *t
,GFP_KERNEL
);
308 memcpy(client
,&client_template
,sizeof(struct i2c_client
));
309 client
->adapter
= adap
;
311 i2c_set_clientdata(client
, t
);
313 do_tda7432_init(client
);
314 i2c_attach_client(client
);
316 v4l_info(client
, "chip found @ 0x%x (%s)\n", addr
<< 1, adap
->name
);
320 static int tda7432_probe(struct i2c_adapter
*adap
)
322 if (adap
->class & I2C_CLASS_TV_ANALOG
)
323 return i2c_probe(adap
, &addr_data
, tda7432_attach
);
327 static int tda7432_detach(struct i2c_client
*client
)
329 struct tda7432
*t
= i2c_get_clientdata(client
);
331 do_tda7432_init(client
);
332 i2c_detach_client(client
);
338 static int tda7432_command(struct i2c_client
*client
,
339 unsigned int cmd
, void *arg
)
341 struct tda7432
*t
= i2c_get_clientdata(client
);
342 v4l_dbg(2, debug
,client
,"In tda7432_command\n");
344 v4l_i2c_print_ioctl(client
,cmd
);
347 /* --- v4l ioctls --- */
348 /* take care: bttv does userspace copying, we'll get a
349 kernel pointer here... */
351 /* Query card - scale from TDA7432 settings to V4L settings */
354 struct video_audio
*va
= arg
;
356 va
->flags
|= VIDEO_AUDIO_VOLUME
|
361 va
->flags
|= VIDEO_AUDIO_MUTE
;
362 va
->mode
|= VIDEO_SOUND_STEREO
;
363 /* Master volume control
364 * V4L volume is min 0, max 65535
366 * Min (-79dB) is 0x6f
367 * Max (+20dB) is 0x07 (630)
368 * Max (0dB) is 0x20 (829)
369 * (Mask out bit 7 of vol - it's for the loudness setting)
371 if (!maxvol
){ /* max +20db */
372 va
->volume
= ( 0x6f - (t
->volume
& 0x7F) ) * 630;
373 } else { /* max 0db */
374 va
->volume
= ( 0x6f - (t
->volume
& 0x7F) ) * 829;
377 /* Balance depends on L,R attenuation
378 * V4L balance is 0 to 65535, middle is 32768
379 * TDA7432 attenuation: min (0dB) is 0, max (-37.5dB) is 0x1f
380 * to scale up to V4L numbers, mult by 1057
381 * attenuation exists for lf, lr, rf, rr
382 * we use only lf and rf (front channels)
385 if ( (t
->lf
) < (t
->rf
) )
386 /* right is attenuated, balance shifted left */
387 va
->balance
= (32768 - 1057*(t
->rf
));
389 /* left is attenuated, balance shifted right */
390 va
->balance
= (32768 + 1057*(t
->lf
));
392 /* Bass/treble 4 bits each */
395 va
->bass
= ~(va
->bass
- 0x8) & 0xf;
396 va
->bass
= (va
->bass
<< 12)+(va
->bass
<< 8)+(va
->bass
<< 4)+(va
->bass
);
397 va
->treble
=t
->treble
;
398 if(va
->treble
>= 0x8)
399 va
->treble
= ~(va
->treble
- 0x8) & 0xf;
400 va
->treble
= (va
->treble
<< 12)+(va
->treble
<< 8)+(va
->treble
<< 4)+(va
->treble
);
402 break; /* VIDIOCGAUDIO case */
405 /* Set card - scale from V4L settings to TDA7432 settings */
408 struct video_audio
*va
= arg
;
410 if(va
->flags
& VIDEO_AUDIO_VOLUME
){
411 if(!maxvol
){ /* max +20db */
412 t
->volume
= 0x6f - ((va
->volume
)/630);
413 } else { /* max 0db */
414 t
->volume
= 0x6f - ((va
->volume
)/829);
417 if (loudness
) /* Turn on the loudness bit */
418 t
->volume
|= TDA7432_LD_ON
;
420 tda7432_write(client
,TDA7432_VL
, t
->volume
);
423 if(va
->flags
& VIDEO_AUDIO_BASS
)
425 t
->bass
= va
->bass
>> 12;
427 t
->bass
= (~t
->bass
& 0xf) + 0x8 ;
429 if(va
->flags
& VIDEO_AUDIO_TREBLE
)
431 t
->treble
= va
->treble
>> 12;
433 t
->treble
= (~t
->treble
& 0xf) + 0x8 ;
435 if(va
->flags
& (VIDEO_AUDIO_TREBLE
| VIDEO_AUDIO_BASS
))
436 tda7432_write(client
,TDA7432_TN
, 0x10 | (t
->bass
<< 4) | t
->treble
);
438 if(va
->flags
& VIDEO_AUDIO_BALANCE
) {
439 if (va
->balance
< 32768)
441 /* shifted to left, attenuate right */
442 t
->rr
= (32768 - va
->balance
)/1057;
444 t
->lr
= TDA7432_ATTEN_0DB
;
445 t
->lf
= TDA7432_ATTEN_0DB
;
447 else if(va
->balance
> 32769)
449 /* shifted to right, attenuate left */
450 t
->lf
= (va
->balance
- 32768)/1057;
452 t
->rr
= TDA7432_ATTEN_0DB
;
453 t
->rf
= TDA7432_ATTEN_0DB
;
458 t
->rr
= TDA7432_ATTEN_0DB
;
459 t
->rf
= TDA7432_ATTEN_0DB
;
460 t
->lf
= TDA7432_ATTEN_0DB
;
461 t
->lr
= TDA7432_ATTEN_0DB
;
465 t
->muted
=(va
->flags
& VIDEO_AUDIO_MUTE
);
468 /* Mute & update balance*/
469 tda7432_write(client
,TDA7432_LF
, t
->lf
| TDA7432_MUTE
);
470 tda7432_write(client
,TDA7432_LR
, t
->lr
| TDA7432_MUTE
);
471 tda7432_write(client
,TDA7432_RF
, t
->rf
| TDA7432_MUTE
);
472 tda7432_write(client
,TDA7432_RR
, t
->rr
| TDA7432_MUTE
);
474 tda7432_write(client
,TDA7432_LF
, t
->lf
);
475 tda7432_write(client
,TDA7432_LR
, t
->lr
);
476 tda7432_write(client
,TDA7432_RF
, t
->rf
);
477 tda7432_write(client
,TDA7432_RR
, t
->rr
);
482 } /* end of VIDEOCSAUDIO case */
484 } /* end of (cmd) switch */
489 static struct i2c_driver driver
= {
493 .id
= I2C_DRIVERID_TDA7432
,
494 .attach_adapter
= tda7432_probe
,
495 .detach_client
= tda7432_detach
,
496 .command
= tda7432_command
,
499 static struct i2c_client client_template
=
505 static int __init
tda7432_init(void)
507 if ( (loudness
< 0) || (loudness
> 15) ) {
508 printk(KERN_ERR
"loudness parameter must be between 0 and 15\n");
512 return i2c_add_driver(&driver
);
515 static void __exit
tda7432_fini(void)
517 i2c_del_driver(&driver
);
520 module_init(tda7432_init
);
521 module_exit(tda7432_fini
);