share/man/man4/isv.4

   1 .\"     $NetBSD: isv.4,v 1.3 2009/10/19 23:28:02 dyoung Exp $
   2 .\"
   3 .\" Copyright (c) 2008 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD
   7 .\" Foundation by David Young.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or
  10 .\" without modification, are permitted provided that the following
  11 .\" conditions are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above
  15 .\"    copyright notice, this list of conditions and the following
  16 .\"    disclaimer in the documentation and/or other materials
  17 .\"    provided with the distribution.
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  20 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  21 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  22 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  23 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  24 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  25 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  26 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  27 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  28 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  29 .\" POSSIBILITY OF SUCH DAMAGE.
  30 .\"
  31 .Dd April 1, 2008
  32 .Dt isv 4
  33 .Os
  34 .Sh NAME
  35 .Nm isv
  36 .Nd IDEC Supervision/16 image capture board
  37 .Sh SYNOPSIS
  38 .Cd "isv0 at isa? port 0x2f0"
  39 .Cd "isv0 at isa? port 0x2e0"
  40 .Cd "isv0 at isa? port 0x3f0"
  41 .Cd "isv0 at isa? port 0x3e0"
  42 .Sh DESCRIPTION
  43 .Pp
  44 .Nm
  45 is a driver for the IDEC Supervision/16, an image capture board
  46 that plugs into a 16-bit ISA bus.
  47 The IDEC Supervision/16 digitizes an NTSC television signal, storing
  48 a 512 x 480-pixel, 8-bit grayscale image in its 256kB dynamic RAM array
  49 every 1/30th of a second.
  50 The host reads frames from the DRAM using 122881 16-bit I/O reads.
  51 Reading frames from the Supervision/16 is quite slow:
  52 after the host reads a 16-bit word from the DRAM, the Supervision/16
  53 state machine takes approximately 0.5 microseconds to get ready
  54 for the next read.
  55 Theoretically, a frame rate of approximately 10 frames per second
  56 is possible.
  57 .Nm
  58 achieves a frame rate of approximately 6 frames per second.
  59 .Pp
  60 .Sh SEE ALSO
  61 .Xr isvctl 8
  62 .Rs
  63 .%R Programming the Supervision/16 Image Capture Board
  64 .%Q IDEC
  65 .%D circa 1991
  66 .Re
  67 .Sh HISTORY
  68 The
  69 .Nm
  70 device first appeared in
  71 .Nx 5.0 .
  72 .Sh AUTHORS
  73 The
  74 .Nm
  75 driver was written by
  76 .An David Young Aq dyoung@NetBSD.org .
  77 .Sh BUGS
  78 .Pp
  79 Synchronizing with the hardware and reading frames from it is very
  80 CPU-intensive.
  81 .Pp
  82 .Nm
  83 will not detect the capture board if it is not attached to an active
  84 video source.
  85 To force
  86 .Nx
  87 to detect the capture board at any time, re-scan the ISA bus using,
  88 e.g.,
  89 .Ic drvctl Fl r Ar isa0 .