 1da177e4c3
			
		
	
	
	1da177e4c3
	
	
	
		
			
			Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip!
		
			
				
	
	
		
			92 lines
		
	
	
	
		
			3 KiB
			
		
	
	
	
		
			Text
		
	
	
	
	
	
			
		
		
	
	
			92 lines
		
	
	
	
		
			3 KiB
			
		
	
	
	
		
			Text
		
	
	
	
	
	
| 
 | |
| Intro
 | |
| =====
 | |
| 
 | |
| people start bugging me about this with questions, looks like I
 | |
| should write up some documentation for this beast.  That way I
 | |
| don't have to answer that much mails I hope.  Yes, I'm lazy...
 | |
| 
 | |
| 
 | |
| You might have noticed that the bt878 grabber cards have actually
 | |
| _two_ PCI functions:
 | |
| 
 | |
| $ lspci
 | |
| [ ... ]
 | |
| 00:0a.0 Multimedia video controller: Brooktree Corporation Bt878 (rev 02)
 | |
| 00:0a.1 Multimedia controller: Brooktree Corporation Bt878 (rev 02)
 | |
| [ ... ]
 | |
| 
 | |
| The first does video, it is backward compatible to the bt848.  The second
 | |
| does audio.  btaudio is a driver for the second function.  It's a sound
 | |
| driver which can be used for recording sound (and _only_ recording, no
 | |
| playback).  As most TV cards come with a short cable which can be plugged
 | |
| into your sound card's line-in you probably don't need this driver if all
 | |
| you want to do is just watching TV...
 | |
| 
 | |
| 
 | |
| Driver Status
 | |
| =============
 | |
| 
 | |
| Still somewhat experimental.  The driver should work stable, i.e. it
 | |
| should'nt crash your box.  It might not work as expected, have bugs,
 | |
| not being fully OSS API compilant, ...
 | |
| 
 | |
| Latest versions are available from http://bytesex.org/bttv/, the
 | |
| driver is in the bttv tarball.  Kernel patches might be available too,
 | |
| have a look at http://bytesex.org/bttv/listing.html.
 | |
| 
 | |
| The chip knows two different modes.  btaudio registers two dsp
 | |
| devices, one for each mode.  They can not be used at the same time.
 | |
| 
 | |
| 
 | |
| Digital audio mode
 | |
| ==================
 | |
| 
 | |
| The chip gives you 16 bit stereo sound.  The sample rate depends on
 | |
| the external source which feeds the bt878 with digital sound via I2S
 | |
| interface.  There is a insmod option (rate) to tell the driver which
 | |
| sample rate the hardware uses (32000 is the default).
 | |
| 
 | |
| One possible source for digital sound is the msp34xx audio processor
 | |
| chip which provides digital sound via I2S with 32 kHz sample rate.  My
 | |
| Hauppauge board works this way.
 | |
| 
 | |
| The Osprey-200 reportly gives you digital sound with 44100 Hz sample
 | |
| rate.  It is also possible that you get no sound at all.
 | |
| 
 | |
| 
 | |
| analog mode (A/D)
 | |
| =================
 | |
| 
 | |
| You can tell the driver to use this mode with the insmod option "analog=1".
 | |
| The chip has three analog inputs.  Consequently you'll get a mixer device
 | |
| to control these.
 | |
| 
 | |
| The analog mode supports mono only.  Both 8 + 16 bit.  Both are _signed_
 | |
| int, which is uncommon for the 8 bit case.  Sample rate range is 119 kHz
 | |
| to 448 kHz.  Yes, the number of digits is correct.  The driver supports
 | |
| downsampling by powers of two, so you can ask for more usual sample rates
 | |
| like 44 kHz too.
 | |
| 
 | |
| With my Hauppauge I get noisy sound on the second input (mapped to line2
 | |
| by the mixer device).  Others get a useable signal on line1.
 | |
| 
 | |
| 
 | |
| some examples
 | |
| =============
 | |
| 
 | |
| * read audio data from btaudio (dsp2), send to es1730 (dsp,dsp1):
 | |
|   $ sox -w -r 32000 -t ossdsp /dev/dsp2 -t ossdsp /dev/dsp
 | |
| 
 | |
| * read audio data from btaudio, send to esound daemon (which might be
 | |
|   running on another host):
 | |
|   $ sox -c 2 -w -r 32000 -t ossdsp /dev/dsp2 -t sw - | esdcat -r 32000
 | |
|   $ sox -c 1 -w -r 32000 -t ossdsp /dev/dsp2 -t sw - | esdcat -m -r 32000
 | |
| 
 | |
| 
 | |
| Have fun,
 | |
| 
 | |
|   Gerd
 | |
| 
 | |
| -- 
 | |
| Gerd Knorr <kraxel@bytesex.org>
 |