bktr man page on OpenBSD

Man page or keyword search:  
man Server   11362 pages
apropos Keyword Search (all sections)
Output format
OpenBSD logo
[printable version]

BKTR(4)			  OpenBSD Programmer's Manual		       BKTR(4)

     bktr - Brooktree Bt848/849/878/879 PCI TV tuners and video capture boards

     bktr* at pci?
     radio* at bktr?

     #include <dev/ic/bt8xx.h>

     option BKTR_ALLOC_PAGES=nnn
     option BKTR_OVERRIDE_CARD=nnn
     option BKTR_OVERRIDE_MSP=n
     option BKTR_OVERRIDE_TUNER=nnn

     The bktr driver provides support for PCI video capture and VBI capture on
     low cost, high performance boards.	 This should support most video cards
     based on the Brooktree Bt848/849/878/879 Video Capture Chip.  The driver
     also supports FM Radio if the Tuner supports it.

     Specifically, the following cards are known to work:

	   Animation Technologies FlyVideo
	   AOpen VA1000
	   Askey/Dynalink Magic TView
	   ATI TV-Wonder and Wonder/VE
	   AverMedia cards
	   Hauppauge Wincast TV and WinTV/PCI
	   IMS TV Turbo
	   Intel Smart Video Recorder III
	   Leadtek Winfast TV 2000
	   Leadtek Winfast TV 2000 XP
	   Miro PC TV
	   MMAC Osprey
	   NEC PK-UG-X017
	   STB TV PCI Television Tuner
	   Terratec TerraTVplus
	   Video Highway XTreme
	   VideoLogic Captivator PCI
	   Zoltrix TV and Genie TV/FM

     The driver currently supports the following features:

	   PCI to PCI DMA transfer

     On these cards, tuners and other components are interconnected with an
     I2C bus.  The Brooktree848 chips act as a master device on the bus to
     control them.

     The video capture interface to bktr is accessed through /dev/bktrN
     devices.  The following ioctl(2) commands are supported on the
     Brooktree848 video capture interface:

     METEORSFMT unsigned long *
	     This command sets the video format, also sometimes referred to as
	     the video norm.  The supported formats are:

	     METEOR_FMT_AUTOMODE	   hardware default

     METEORGFMT unsigned long *
	     This command retrieves the current video format to the unsigned
	     long * argument.

     METEORSETGEO struct meteor_geomet *
	     This command sets the video properties that affect the bit size
	     of a frame through the meteor_geomet * argument.

	     struct meteor_geomet {
		     u_short	     rows;    /* height in pixels*/
		     u_short	     columns; /* width in pixels */
		     u_short	     frames;
		     u_long	     oformat;

	     The frames field is the number of frames to buffer.  Currently
	     only 1 frame is supported for most operations.

	     The oformat field is a bit-field describing the output pixel
	     format type and which video fields to capture.  The following are
	     supported pixel format types:

	     METEOR_GEO_RGB16		   16-bit RGB
	     METEOR_GEO_RGB24		   24-bit RGB in 32 bits
	     METEOR_GEO_YUV_PACKED	   16-bit 4:2:2 YUV
	     METEOR_GEO_YUV_PLANAR	   16-bit 4:2:2 YUV
	     METEOR_GEO_YUV_UNSIGNED	   unsigned UV

	     The following are supported field capture modes:

	     METEOR_GEO_ODD_ONLY	   only odd fields
	     METEOR_GEO_EVEN_ONLY	   only even fields

	     By default, frames will consist of both the odd and even fields.

     METEORGSUPPIXFMT struct meteor_pixfmt *
	     This command is used iteratively to fetch descriptions of
	     supported output pixel formats into the meteor_pixfmt * argument.

	     struct meteor_pixfmt {
		     u_int	    index;
		     METEOR_PIXTYPE type;
		     u_int	    Bpp;	     /* bytes per pixel */
		     u_long	    masks[3];	     /* YUV bit masks */
		     unsigned	    swap_bytes :1;
		     unsigned	    swap_shorts:1;

	     To query all the supported formats, start with an index field of
	     0 and continue with successive encodings (1, 2, ...) until the
	     command returns an error.

	     This command sets the active pixel format.	 The int * argument is
	     the index of the pixel format as returned by METEORGSUPPIXFMT.

	     This command fetches the active pixel format index into the int *

     METEORSINPUT unsigned long *
	     This command sets the input port of the Brooktree848 device.  The
	     following are supported input ports:

	     METEOR_INPUT_DEV0		   composite (RCA)
	     METEOR_INPUT_DEV1		   tuner
	     METEOR_INPUT_DEV2		   composite S-video
	     METEOR_INPUT_DEV3		   mystery device
	     METEOR_INPUT_DEV_RGB	   rgb meteor

	     Not all devices built with Brooktree848 chips support the full
	     list of input ports.

     METEORGINPUT unsigned long *
	     This command retrieves the current input port to the unsigned
	     long * argument.

     METEORSFPS unsigned short *
	     This command sets the number of frames to grab each second.
	     Valid frame rates are integers from 0 to 30.

     METEORGFPS unsigned short *
	     This command fetches the number of frames to grab each second
	     into the unsigned short * argument.

	     This command controls capturing of video data.  The following are
	     valid arguments:

	     METEOR_CAP_SINGLE		   capture one frame
	     METEOR_CAP_CONTINOUS	   continuously capture
	     METEOR_CAP_STOP_CONT	   stop continuous capture

     METEORSSIGNAL unsigned int *
	     This command controls the signal emission properties of bktr.  If
	     the unsigned int * argument is a valid signal, then that signal
	     will be emitted when either a frame or field capture has
	     completed.	 To select between frame or field signalling, the
	     following arguments are used:

	     METEOR_SIG_FRAME		   signal every frame
	     METEOR_SIG_FIELD		   signal every field

	     By default, signals will be generated for every frame.
	     Generation of signals is terminated with the METEOR_SIG_MODE_MASK

     Most cards supported by this driver feature a hardware television tuner
     on the I2C bus.  The tuner interface to bktr is accessed through
     /dev/tunerN devices.  The following ioctl(2) commands are supported on
     the tuner interface:

     TVTUNER_SETTYPE unsigned int *
	     This command sets the tuner's TV channel set, also sometimes
	     called the TV channel band.  This setting is used to calculate
	     the proper tuning frequencies.  The desired channel set must be
	     selected before attempting to set the tuner channel or frequency.
	     The following is a list of valid channel sets:

	     CHNLSET_NABCST		   North America broadcast
	     CHNLSET_CABLEIRC		   North America IRC cable
	     CHNLSET_CABLEHRC		   North America HRC cable
	     CHNLSET_WEUROPE		   Western Europe
	     CHNLSET_JPNBCST		   Japan broadcast
	     CHNLSET_JPNCABLE		   Japan cable
	     CHNLSET_XUSSR		   Russia
	     CHNLSET_AUSTRALIA		   Australia
	     CHNLSET_FRANCE		   France

     TVTUNER_GETTYPE unsigned int *
	     This command fetches the tuner's current channel set to the
	     unsigned int * argument.

     TVTUNER_SETCHNL unsigned int *
	     This command sets the tuner's frequency to a specified channel in
	     the current channel set.

     TVTUNER_GETCHNL unsigned int *
	     This command fetches the last selected channel.  Note that it is
	     not necessarily the current channel.  In particular, changing the
	     tuner's frequency by a command other than TVTUNER_SETCHNL will
	     not update this setting, and it defaults to 0 on driver

     TVTUNER_SETFREQ unsigned int *
	     This command sets the tuner's frequency to 1/16th the value of
	     the unsigned int * argument, in MHz.  Note that the current
	     channelset is used to determine frequency offsets when this
	     command is executed.

     TVTUNER_GETFREQ unsigned int *
	     This command fetches the tuner's current frequency to the
	     unsigned int * argument.  Note that this value is 16 times the
	     actual tuner frequency, in MHz.

     BT848_SAUDIO int *
	     This command controls the audio input port and mute state.	 The
	     following is a list of valid arguments:

	     AUDIO_TUNER	 tuner audio port
	     AUDIO_EXTERN	 external audio port
	     AUDIO_INTERN	 internal audio port
	     AUDIO_MUTE		 mute audio
	     AUDIO_UNMUTE	 unmute audio

     BT848_GAUDIO int *
	     This command fetches the audio input and mute state bits to the
	     int * argument.

     The following kernel configuration options are available:

     option BKTR_ALLOC_PAGES=nnn
	       Specifies the number of contiguous pages to allocate when
	       successfully probed.  The default number of pages allocated by
	       the kernel is 216.  This means that there are (216*4096) bytes
	       available for use.

	       One of these options can be used to set the default video
	       format for the driver.  This fixed random hangs and lockups
	       with the VideoLogic Captivator PCI card.

     option BKTR_OVERRIDE_CARD=nnn
	       Select a specific card (overrides autodetection).  `nnn' is set
	       to one of the names listed and explained below.

	       CARD_ASKEY_DYNALINK_MAGIC_TVIEW	Askey/Dynalink Magic TView
	       CARD_AVER_MEDIA			AverMedia
	       CARD_FLYVIDEO			Animation Technologies
	       CARD_AOPEN_VA1000		AOpen VA1000
	       CARD_TVWONDER			ATI TV-Wonder/VE
	       CARD_HAUPPAUGE			Hauppauge Wincast TV and WinTV
	       CARD_IMS_TURBO			IMS TV Turbo
	       CARD_INTEL			Intel Smart Video Recorder III
	       CARD_LEADTEK			Leadtek Winfast TV 2000
	       CARD_LEADTEK_XP			Leadtek Winfast TV 2000 XP
	       CARD_MIRO			Miro PC TV
	       CARD_OSPREY			MMAC Osprey
	       CARD_NEC_PK			NEC PK-UG-X017
	       CARD_STB				STB TV PCI Television Tuner
	       CARD_TERRATVPLUS			Terratec TerraTVplus
	       CARD_VIDEO_HIGHWAY_XTREME	Video Highway XTreme
	       CARD_ZOLTRIX			Zoltrix TV
	       CARD_ZOLTRIX_GENIE_FM		Zoltrix Genie TV/FM

     option BKTR_OVERRIDE_MSP=n
	       Specifies whether the MSP3400C chip is present (overrides

     option BKTR_OVERRIDE_TUNER=nnn
	       Select a specific tuner (overrides autodetection).  `nnn' is
	       set to one of the names listed and explained below.

	       TEMIC_NTSC		     Temic 4032FY5
	       TEMIC_PAL		     Temic 4002FH5
	       TEMIC_SECAM		     Temic 4002FN5
	       PHILIPS_NTSC		     Philips FI1236
	       PHILIPS_PAL		     Philips FM1216
	       PHILIPS_SECAM		     Philips FI1216MF
	       TEMIC_PALI		     Temic 4062FY5
	       PHILIPS_PALI		     Philips FI1246
	       PHILIPS_FR1236_NTSC	     Philips FR1236 MK2
	       PHILIPS_FR1216_PAL	     Philips FM1216
	       PHILIPS_FR1236_SECAM	     Philips FM1216MF
	       ALPS_TSCH5		     Apls TSCH5 NTSC
	       ALPS_TSBH1		     Apls TSBH1 NTSC
	       TIVISION_TVF5533		     Tivision TVF5533-MF NTSC

     intro(4), pci(4), radio(4)

     The bktr driver first appeared in FreeBSD 2.2.

     The bktr driver is based on the work of Jim Lowe
     <james@miller.cs.uwm.edu>, Mark Tinguely <tinguely@plains.nodak.edu>,
     Amancio Hasty <hasty@star-gate.com>, Roger Hardiman <roger@FreeBSD.org>
     and a bunch of other people.

     On big-endian architectures it is not possible to program the card to
     perform proper byte swapping in 24 bit modes, therefore only 16 and 32
     bit modes are supported.

OpenBSD 4.9		       October 25, 2009			   OpenBSD 4.9

List of man pages available for OpenBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net