11639 some man pages show incorrect driver locations

   1 '\" te
   2 .\" Copyright (c) 2004, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH DCAM1394 7D "Jan 10, 2020"
   7 .SH NAME
   8 dcam1394 \- 1394-based digital camera (IIDC) driver
   9 .SH SYNOPSIS

  10 .nf
  11 \fB#include <sys/dcam/dcam1394_io.h>\fR
  12 .fi
  13 
  14 .SH DESCRIPTION


  15 The \fBdcam1394\fR driver supports devices implementing the \fI1394 Trade
  16 Association Digital Camera Specification\fR (also referred to as the IIDC
  17 specification).  Only a subset of the specification is supported.
  18 .SH READING DATA


  19 Isochronous data is read from the driver frame-by-frame and is maintained
  20 within the driver in a ring buffer.
  21 .sp
  22 .LP
  23 Video frames are read from the isochronous input device using \fBread\fR(2).
  24 .sp
  25 .LP
  26 The \fBdcam1394_frame_t\fR structure describes the frame layout and is defined
  27 as follows:
  28 .sp
  29 .in +2
  30 .nf
  31      struct {
  32           unsigned int vid_mode;
  33           unsigned int seq_num;
  34           hrtime_t     timestamp;
  35           unsigned char *buff;
  36      };
  37 .fi
  38 .in -2
  39 
  40 .sp
  41 .LP
  42 The size to allocate for the structure is determined by the video mode for
  43 which the camera is configured. Possible values for the vid_mode field are
  44 listed under DCAM1394_PARAM_VID_MODE below.
  45 .SH IOCTL REQUESTS


  46 The following ioctl requests are supported:
  47 .sp
  48 .ne 2
  49 .na
  50 \fBDCAM1394_CMD_CAM_RESET\fR
  51 .ad
  52 .sp .6
  53 .RS 4n
  54 Reset the device.
  55 .RE
  56 
  57 .sp
  58 .ne 2
  59 .na
  60 \fBDCAM1394_CMD_REG_READ\fR
  61 .ad
  62 .sp .6
  63 .RS 4n
  64 Read the indicated dcam/IIDC register. The argument is a pointer to a
  65 \fBdcam1394_reg_io_t\fR structure, which is defined as follows:
  66 .sp
  67 .in +2
  68 .nf
  69     struct {
  70          unsigned int offs;
  71          unsigned int val;
  72     };
  73 .fi
  74 .in -2
  75 
  76 The offs field should be set to the offset of the register from which to read.
  77 Register offset values are defined in the \fI1394 Trade Association Digital
  78 Camera Specification\fR.
  79 .sp
  80 After the operation is completed, the camera register value is put in the
  81 \fBval\fR field.
  82 .RE
  83 
  84 .sp
  85 .ne 2
  86 .na
  87 \fBDCAM1394_CMD_REG_WRITE\fR
  88 .ad
  89 .sp .6
  90 .RS 4n
  91 Write the indicated dcam/IIDC register. The argument is a pointer to a
  92 \fBdcam1394_reg_io_t\fR structure (described above).
  93 .sp
  94 The offs field should be set to the offset of the register from which to read.
  95 The register offset values are defined in the \fI1394 Trade Association Digital
  96 Camera Specification\fR.
  97 .sp
  98 The val field should be set to the value to be written to the camera register.
  99 .RE
 100 
 101 .sp
 102 .ne 2
 103 .na
 104 \fBDCAM1394_CMD_PARAM_GET\fR
 105 .ad
 106 .sp .6
 107 .RS 4n
 108 Gets a list of parameters associated with a camera. The argument is a pointer
 109 to a \fBdcam1394_param_list_t\fR structure (described below). The parameter
 110 list is accessed through macros defined below.
 111 .sp
 112 The parameter list only supports Format 1 video formats.
 113 .RE
 114 
 115 .sp
 116 .ne 2
 117 .na
 118 \fBDCAM1394_CMD_PARAM_SET\fR
 119 .ad
 120 .sp .6
 121 .RS 4n
 122 Sets a list of parameters associated with a camera. The argument is a pointer
 123 to a \fBdcam1394_param_list_t structure\fR (described below). The parameter
 124 list is accessed through macros defined below.
 125 .sp
 126 The parameter list only supports Format 1 video formats.
 127 .RE
 128 
 129 .sp
 130 .ne 2
 131 .na
 132 \fBDCAM1394_CMD_FRAME_RCV_START\fR
 133 .ad
 134 .sp .6
 135 .RS 4n
 136 Start receiving video frames from the camera.
 137 .sp
 138 The contents of the ring buffer may be accessed by reading the isochronous
 139 stream device.
 140 .RE
 141 
 142 .sp
 143 .ne 2
 144 .na
 145 \fBDCAM1394_CMD_FRAME_RCV_STOP\fR
 146 .ad
 147 .sp .6
 148 .RS 4n
 149 Stop receiving frames from the camera.
 150 .RE
 151 
 152 .sp
 153 .ne 2
 154 .na
 155 \fBDCAM1394_CMD_RING_BUFF_FLUSH\fR
 156 .ad
 157 .sp .6
 158 .RS 4n
 159 Flush the frames in the ring buffer.
 160 .RE
 161 
 162 .sp
 163 .ne 2
 164 .na
 165 \fBDCAM1394_CMD_FRAME_SEQ_NUM_COUNT_RESET\fR
 166 .ad
 167 .sp .6
 168 .RS 4n
 169 Reset frame sequence number.
 170 .RE
 171 
 172 .SH PARAMETER LIST ACCESS


 173 The parameter list is initialized and access through macros. The data type for
 174 the parameter list is \fBdcam1394_param_list_t\fR.
 175 .sp
 176 .LP
 177 The following macros are used to access the parameter list:
 178 .sp
 179 .ne 2
 180 .na
 181 \fBPARAM_LIST_INIT(param_list)\fR
 182 .ad
 183 .sp .6
 184 .RS 4n
 185 Initialize the parameter list.
 186 .RE
 187 
 188 .sp
 189 .ne 2
 190 .na
 191 \fBPARAM_LIST_ADD(param_list, param, subparam)\fR
 192 .ad
 193 .sp .6
 194 .RS 4n
 195 Add a parameter to the list.
 196 .RE
 197 
 198 .sp
 199 .ne 2
 200 .na
 201 \fBPARAM_LIST_REMOVE(param_list, param, subparam)\fR
 202 .ad
 203 .sp .6
 204 .RS 4n
 205 Remove a parameter from the list.
 206 .RE
 207 
 208 .sp
 209 .ne 2
 210 .na
 211 \fBPARAM_LIST_IS_ENTRY(param_list, param, subparam)\fR
 212 .ad
 213 .sp .6
 214 .RS 4n
 215 Indicates if a specific parameter is in the list.
 216 .RE
 217 
 218 .sp
 219 .ne 2
 220 .na
 221 \fBPARAM_VAL(param_list, param, subparam)\fR
 222 .ad
 223 .sp .6
 224 .RS 4n
 225 Value of a specified parameter.
 226 .RE
 227 
 228 .sp
 229 .ne 2
 230 .na
 231 \fBPARAM_ERR(param_list, param, subparam)\fR
 232 .ad
 233 .sp .6
 234 .RS 4n
 235 Indicates if a specific parameter is successfully set.
 236 .RE
 237 
 238 .sp
 239 .LP
 240 When no subparam value is required, the value DCAM1394_SUBPARAM_NONE may be
 241 used.
 242 .SH PARAMETERS


 243 The following parameters may appear in the list:
 244 .sp
 245 .ne 2
 246 .na
 247 \fBDCAM1394_PARAM_CAP_POWER_CTRL\fR
 248 .ad
 249 .sp .6
 250 .RS 4n
 251 Queries if the camera can be turned off and on through software. The subparam
 252 value is ignored.
 253 .RE
 254 
 255 .sp
 256 .ne 2
 257 .na
 258 \fBDCAM1394_PARAM_POWER\fR
 259 .ad
 260 .sp .6
 261 .RS 4n
 262 Controls or queries if the camera is powered up. Verify this feature using
 263 DCAM1394_PARAM_CAP_POWER_CTRL before use. The subparam field is ignored.
 264 .RE
 265 
 266 .sp
 267 .ne 2
 268 .na
 269 \fBDCAM1394_PARAM_CAP_VID_MOD\fR
 270 .ad
 271 .sp .6
 272 .RS 4n
 273 Queries if a specific video mode is supported by the camera.
 274 .sp
 275 subparam is one of the following and is used to determine if a specified video
 276 mode is supported by the camera:
 277 .sp
 278 .in +2
 279 .nf
 280   DCAM1394_SUBPARAM_VID_MODE_0
 281   DCAM1394_SUBPARAM_VID_MODE_YUV_444_160_120
 282        Video mode is 4:4:4, YUV color space, 160x120 resolution.
 283 
 284   DCAM1394_SUBPARAM_VID_MODE_1
 285   DCAM1394_SUBPARAM_VID_MODE_YUV_422_320_240
 286        Video mode is 4:2:2, YUV color space, 320x240 resolution.
 287 
 288   DCAM1394_SUBPARAM_VID_MODE_2
 289   DCAM1394_SUBPARAM_VID_MODE_YUV_411_640_480
 290        Video mode is 4:1:1, YUV color space, 640x480 resolution.
 291 
 292   DCAM1394_SUBPARAM_VID_MODE_3
 293   DCAM1394_SUBPARAM_VID_MODE_YUV_422_640_480
 294        Video mode is 4:2:2, YUV color space, 640x480 resolution.
 295 
 296   DCAM1394_SUBPARAM_VID_MODE_4
 297   DCAM1394_SUBPARAM_VID_MODE_RGB_640_480
 298        Video mode is RGB color space, 640x480 resolution.
 299 
 300   DCAM1394_SUBPARAM_VID_MODE_5
 301   DCAM1394_SUBPARAM_VID_MODE_Y_640_480
 302        Video mode is Y color space, 640x480 resolution.
 303 .fi
 304 .in -2
 305 
 306 .RE
 307 
 308 .sp
 309 .ne 2
 310 .na
 311 \fBDCAM1394_PARAM_VID_MODE\fR
 312 .ad
 313 .sp .6
 314 .RS 4n
 315 Controls or queries the current video mode of the camera.  The subparam field
 316 is ignored. When selecting the video mode, it should be compatible with the
 317 capability of the camera, which may be determined by checking the
 318 DCAM1394_PARAM_CAP_VID_MODE parameter.
 319 .sp
 320 The value of this parameter may be one of the following:
 321 .sp
 322 .in +2
 323 .nf
 324   DCAM1394_VID_MODE_0
 325   DCAM1394_VID_MODE_YUV_444_160_120
 326        Video mode is 4:4:4, YUV color space, 160x120 resolution.
 327 
 328   DCAM1394_VID_MODE_1
 329   DCAM1394_VID_MODE_YUV_422_320_240
 330        Video mode is 4:2:2, YUV color space, 320x240 resolution.
 331 
 332   DCAM1394_VID_MODE_2
 333   DCAM1394_VID_MODE_YUV_411_640_480
 334        Video mode is 4:1:1, YUV color space, 640x480 resolution.
 335 
 336   DCAM1394_VID_MODE_3
 337   DCAM1394_VID_MODE_YUV_422_640_480
 338        Video mode is 4:2:2, YUV color space, 640x480 resolution.
 339 
 340   DCAM1394_VID_MODE_4
 341   DCAM1394_VID_MODE_RGB_640_480
 342        Video mode is RGB color space, 640x480 resolution.
 343 
 344   DCAM1394_VID_MODE_5
 345   DCAM1394_VID_MODE_Y_640_480
 346        Video mode is Y color space, 640x480 resolution.
 347 .fi
 348 .in -2
 349 
 350 .RE
 351 
 352 .sp
 353 .ne 2
 354 .na
 355 \fBDCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_0\fR
 356 .ad
 357 .sp .6
 358 .RS 4n
 359 Queries if a specific frame rate is supported by the camera in video mode 0
 360 (4:4:4, YUV, 160x120).
 361 .sp
 362 subparam is one of the following and used to determine if a specified frame
 363 rate is supported by the camera:
 364 .sp
 365 .in +2
 366 .nf
 367           DCAM1394_SUBPARAM_FRAME_RATE_0
 368           DCAM1394_SUBPARAM_FRAME_RATE_3_75_FPS
 369                Frame rate is 3.75 frames/second.
 370 
 371           DCAM1394_SUBPARAM_FRAME_RATE_1
 372           DCAM1394_SUBPARAM_FRAME_RATE_7_5_FPS
 373                Frame rate is 7.5 frames/second.
 374 
 375           DCAM1394_SUBPARAM_FRAME_RATE_2
 376           DCAM1394_SUBPARAM_FRAME_RATE_15_FPS
 377                Frame rate is 15 frames/second.
 378 
 379           DCAM1394_SUBPARAM_FRAME_RATE_3
 380           DCAM1394_SUBPARAM_FRAME_RATE_30_FPS
 381                Frame rate is 30 frames/second.
 382 
 383           DCAM1394_SUBPARAM_FRAME_RATE_4
 384           DCAM1394_SUBPARAM_FRAME_RATE_60_FPS
 385                Frame rate is 60 frames/second.
 386 .fi
 387 .in -2
 388 
 389 .RE
 390 
 391 .sp
 392 .ne 2
 393 .na
 394 \fBDCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_1\fR
 395 .ad
 396 .sp .6
 397 .RS 4n
 398 Queries if a specific frame rate is supported by the camera in video mode 1
 399 (4:2:2, YUV, 320x240). See DCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_0 for a
 400 listing of valid subparam values.
 401 .RE
 402 
 403 .sp
 404 .ne 2
 405 .na
 406 \fBDCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_2\fR
 407 .ad
 408 .sp .6
 409 .RS 4n
 410 Queries if a specific frame rate is supported by the camera in video mode 2
 411 (4:1:1, YUV, 640x480). See DCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_0 for a
 412 listing of valid subparam values.
 413 .RE
 414 
 415 .sp
 416 .ne 2
 417 .na
 418 \fBDCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_3\fR
 419 .ad
 420 .sp .6
 421 .RS 4n
 422 Queries if a specific frame rate is supported by the camera in video mode 3
 423 (4:2:2, YUV, 640x480). See DCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_0 for a
 424 listing of valid subparam values.
 425 .RE
 426 
 427 .sp
 428 .ne 2
 429 .na
 430 \fBDCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_4\fR
 431 .ad
 432 .sp .6
 433 .RS 4n
 434 Queries if a specific frame rate is supported by the camera in video mode 4.
 435 (RGB, 640x480). See DCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_0 for a listing of
 436 valid subparam values.
 437 .RE
 438 
 439 .sp
 440 .ne 2
 441 .na
 442 \fBDCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_5\fR
 443 .ad
 444 .sp .6
 445 .RS 4n
 446 Queries if a specific frame rate is supported by the camera in video mode 5.
 447 (Y, 640x480). See DCAM1394_PARAM_CAP_FRAME_RATE_VID_MODE_0 for a listing of
 448 valid subparam values.
 449 .RE
 450 
 451 .sp
 452 .ne 2
 453 .na
 454 \fBDCAM1394_PARAM_FRAME_RATE\fR
 455 .ad
 456 .sp .6
 457 .RS 4n
 458 Controls or queries the current frame rate of the camera.  The subparam field
 459 is ignored. When selecting a frame rate, it should be compatible with the
 460 capability of the camera, which can be determined by querying one of the frame
 461 rate capability parameters above.
 462 .sp
 463 The value of this parameter may be one of the following:
 464 .sp
 465 .in +2
 466 .nf
 467           DCAM1394_FRAME_RATE_0
 468           DCAM1394_3_75_FPS
 469                The frame rate is 3.75 frames per second.
 470 
 471           DCAM1394_FRAME_RATE_1
 472           DCAM1394_7_5_FPS
 473                The frame rate is 7.5 frames per second.
 474 
 475           DCAM1394_FRAME_RATE_2
 476           DCAM1394_15_FPS
 477                The frame rate is 15 frames per second.
 478 
 479           DCAM1394_FRAME_RATE_3
 480           DCAM1394_30_FPS
 481                The frame rate is 30 frames per second.
 482 
 483           DCAM1394_FRAME_RATE_4
 484           DCAM1394_60_FPS
 485                The frame rate is 60 frames per second.
 486 .fi
 487 .in -2
 488 
 489 .RE
 490 
 491 .sp
 492 .ne 2
 493 .na
 494 \fBDCAM1394_PARAM_RING_BUFF_CAPACITY\fR
 495 .ad
 496 .sp .6
 497 .RS 4n
 498 Controls or queries the number of frames that the ring buffer may hold. This
 499 value can range between 2 and 30. The subparam field is ignored.
 500 .RE
 501 
 502 .sp
 503 .ne 2
 504 .na
 505 \fBDCAM1394_PARAM_RING_BUFF_NUM_FRAMES_READY\fR
 506 .ad
 507 .sp .6
 508 .RS 4n
 509 Queries the number of frames in the ring buffer ready to be accessed. The
 510 subparam field is ignored.
 511 .RE
 512 
 513 .sp
 514 .ne 2
 515 .na
 516 \fBDCAM1394_PARAM_RING_BUFF_READ_PTR_INCR\fR
 517 .ad
 518 .sp .6
 519 .RS 4n
 520 Controls or queries the number of bytes to advance the read pointer as it
 521 consumes data from the ring buffer. The subparam field is ignored.
 522 .RE
 523 
 524 .sp
 525 .ne 2
 526 .na
 527 \fBDCAM1394_PARAM_FRAME_NUM_BYTES\fR
 528 .ad
 529 .sp .6
 530 .RS 4n
 531 Queries the number of bytes in a frame at the current video mode. The subparam
 532 field is ignored.
 533 .RE
 534 
 535 .sp
 536 .ne 2
 537 .na
 538 \fBDCAM1394_PARAM_STATUS\fR
 539 .ad
 540 .sp .6
 541 .RS 4n
 542 Queries the parameter status. The subparam field is ignored.
 543 .sp
 544 The values for the parameter status is a bit field with the following values
 545 possibly set:
 546 .sp
 547 .ne 2
 548 .na
 549 \fBDCAM1394_STATUS_FRAME_RCV_DONE\fR
 550 .ad
 551 .sp .6
 552 .RS 4n
 553 Frame successfully received.
 554 .RE
 555 
 556 .sp
 557 .ne 2
 558 .na
 559 \fBDCAM1394_STATUS_RING_BUFF_LOST_FRAME\fR
 560 .ad
 561 .sp .6
 562 .RS 4n
 563 A frame has been lost while processing the ring buffer.
 564 .RE
 565 
 566 .sp
 567 .ne 2
 568 .na
 569 \fBDCAM1394_STATUS_PARAM_CHANGE\fR
 570 .ad
 571 .sp .6
 572 .RS 4n
 573 A parameter has been changed.
 574 .RE
 575 
 576 .sp
 577 .ne 2
 578 .na
 579 \fBDCAM1394_STATUS_FRAME_SEQ_NUM_COUNT_OVERFLOW\fR
 580 .ad
 581 .sp .6
 582 .RS 4n
 583 Frame sequence number has reached its maximum possible value and has
 584 overflowed.
 585 .RE
 586 
 587 .sp
 588 .ne 2
 589 .na
 590 \fBDCAM1394_STATUS_CAM_UNPLUG\fR
 591 .ad
 592 .sp .6
 593 .RS 4n
 594 Camera has been unplugged.
 595 .RE
 596 
 597 .RE
 598 
 599 .sp
 600 .ne 2
 601 .na
 602 \fBDCAM1394_PARAM_BRIGHTNESS\fR
 603 .ad
 604 .sp .6
 605 .RS 4n
 606 Query or control a camera feature. This feature queries or controls the
 607 brightness of the camera.
 608 .sp
 609 .ne 2
 610 .na
 611 \fBDCAM1394_SUBPARAM_PRESENCE\fR
 612 .ad
 613 .sp .6
 614 .RS 4n
 615 Indicates if the feature is available.
 616 .RE
 617 
 618 .sp
 619 .ne 2
 620 .na
 621 \fBDCAM1394_SUBPARAM_CAP_ON_OFF\fR
 622 .ad
 623 .sp .6
 624 .RS 4n
 625 Indicates if the feature may be enabled and disabled. May only be queried.
 626 .RE
 627 
 628 .sp
 629 .ne 2
 630 .na
 631 \fBDCAM1394_SUBPARAM_ON_OFF\fR
 632 .ad
 633 .sp .6
 634 .RS 4n
 635 Indicates if the feature is enabled.
 636 .RE
 637 
 638 .sp
 639 .ne 2
 640 .na
 641 \fBDCAM1394_SUBPARAM_CAP_CTRL_AUTO\fR
 642 .ad
 643 .sp .6
 644 .RS 4n
 645 Indicates if the automatic control of this feature is supported by the camera.
 646 May only be queried.
 647 .RE
 648 
 649 .sp
 650 .ne 2
 651 .na
 652 \fBDCAM1394_SUBPARAM_CAP_CTRL_MANUAL\fR
 653 .ad
 654 .sp .6
 655 .RS 4n
 656 Indicates if the manual control of this feature is supported by the camera. May
 657 only be queried.
 658 .RE
 659 
 660 .sp
 661 .ne 2
 662 .na
 663 \fBDCAM1394_SUBPARAM_CTRL_MODE\fR
 664 .ad
 665 .sp .6
 666 .RS 4n
 667 Indicates if the feature is in auto or manual mode.
 668 .RE
 669 
 670 .sp
 671 .ne 2
 672 .na
 673 \fBDCAM1394_SUBPARAM_MIN_VAL\fR
 674 .ad
 675 .sp .6
 676 .RS 4n
 677 Minimum value of the feature. May only be queried.
 678 .RE
 679 
 680 .sp
 681 .ne 2
 682 .na
 683 \fBDCAM1394_SUBPARAM_MAX_VAL\fR
 684 .ad
 685 .sp .6
 686 .RS 4n
 687 Maximum value of the feature. May only be queried.
 688 .RE
 689 
 690 .sp
 691 .ne 2
 692 .na
 693 \fBDCAM1394_SUBPARAM_VALUE\fR
 694 .ad
 695 .sp .6
 696 .RS 4n
 697 Current value of the feature.
 698 .RE
 699 
 700 .sp
 701 .ne 2
 702 .na
 703 \fBDCAM1394_SUBPARAM_CAP_READ\fR
 704 .ad
 705 .sp .6
 706 .RS 4n
 707 Indicates if the feature may be read. May only be                queried.
 708 .RE
 709 
 710 .RE
 711 
 712 .sp
 713 .ne 2
 714 .na
 715 \fBDCAM1394_PARAM_EXPOSURE\fR
 716 .ad
 717 .sp .6
 718 .RS 4n
 719 Query or control a camera feature. This feature queries or controls the
 720 exposure of the camera. The subparams supported by this feature are described
 721 under DCAM1394_PARAM_BRIGHTNESS.
 722 .RE
 723 
 724 .sp
 725 .ne 2
 726 .na
 727 \fBDCAM1394_PARAM_SHARPNESS\fR
 728 .ad
 729 .sp .6
 730 .RS 4n
 731 Query or control a camera feature. This feature queries or controls the
 732 sharpness of the camera. The subparams supported by this feature are described
 733 under DCAM1394_PARAM_BRIGHTNESS.
 734 .RE
 735 
 736 .sp
 737 .ne 2
 738 .na
 739 \fBDCAM1394_PARAM_WHITE_BALANCE\fR
 740 .ad
 741 .sp .6
 742 .RS 4n
 743 Query or control a camera feature. This feature queries or controls the white
 744 balance of the camera. The subparams supported by this feature are described
 745 under DCAM1394_PARAM_BRIGHTNESS, except for DCAM1394_SUBPARAM_VALUE.
 746 DCAM1394_SUBPARAM_VALUE is replaced by two distinct subparams.
 747 .sp
 748 .ne 2
 749 .na
 750 \fBDCAM1394_SUBPARAM_U_VALUE\fR
 751 .ad
 752 .RS 29n
 753 U or B component of the white balance.
 754 .RE
 755 
 756 .sp
 757 .ne 2
 758 .na
 759 \fBDCAM1394_SUBPARAM_V_VALUE\fR
 760 .ad
 761 .RS 29n
 762 V or R component of the white balance.
 763 .RE
 764 
 765 .RE
 766 
 767 .sp
 768 .ne 2
 769 .na
 770 \fBDCAM1394_PARAM_HUE\fR
 771 .ad
 772 .sp .6
 773 .RS 4n
 774 Query or control a camera feature. This feature queries or controls the hue of
 775 the camera. The subparams supported by this feature are described under
 776 DCAM1394_PARAM_BRIGHTNESS.
 777 .RE
 778 
 779 .sp
 780 .ne 2
 781 .na
 782 \fBDCAM1394_PARAM_SATURATION\fR
 783 .ad
 784 .sp .6
 785 .RS 4n
 786 Query or control a camera feature. This feature queries or controls the
 787 saturation of the camera. The subparams supported by this feature are described
 788 under DCAM1394_PARAM_BRIGHTNESS.
 789 .RE
 790 
 791 .sp
 792 .ne 2
 793 .na
 794 \fBDCAM1394_PARAM_GAMMA\fR
 795 .ad
 796 .sp .6
 797 .RS 4n
 798 Query or control a camera feature. This feature queries or controls the gamma
 799 of the camera. The subparams supported by this feature are described under
 800 DCAM1394_PARAM_BRIGHTNESS.
 801 .RE
 802 
 803 .sp
 804 .ne 2
 805 .na
 806 \fBDCAM1394_PARAM_SHUTTER\fR
 807 .ad
 808 .sp .6
 809 .RS 4n
 810 Query or control a camera feature. This feature queries or controls the
 811 sharpness of the camera. The subparams supported by this feature are described
 812 under DCAM1394_PARAM_BRIGHTNESS.
 813 .RE
 814 
 815 .sp
 816 .ne 2
 817 .na
 818 \fBDCAM1394_PARAM_GAIN\fR
 819 .ad
 820 .sp .6
 821 .RS 4n
 822 Query or control a camera feature. This feature queries or controls the gain of
 823 the camera. The subparams supported by this feature are described under
 824 DCAM1394_PARAM_BRIGHTNESS.
 825 .RE
 826 
 827 .sp
 828 .ne 2
 829 .na
 830 \fBDCAM1394_PARAM_IRIS\fR
 831 .ad
 832 .sp .6
 833 .RS 4n
 834 Query or control a camera feature. This feature queries or controls the iris of
 835 the camera. The subparams supported by this feature are described under
 836 DCAM1394_PARAM_BRIGHTNESS.
 837 .RE
 838 
 839 .sp
 840 .ne 2
 841 .na
 842 \fBDCAM1394_PARAM_FOCUS\fR
 843 .ad
 844 .sp .6
 845 .RS 4n
 846 Query or control a camera feature. This feature queries or controls the focus
 847 of the camera. The subparams supported by this feature are described under
 848 DCAM1394_PARAM_BRIGHTNESS.
 849 .RE
 850 
 851 .sp
 852 .ne 2
 853 .na
 854 \fBDCAM1394_PARAM_ZOOM\fR
 855 .ad
 856 .sp .6
 857 .RS 4n
 858 Query or control a camera feature. This feature queries or controls the zoom of
 859 the camera. The subparams supported by this feature are described under
 860 DCAM1394_PARAM_BRIGHTNESS.
 861 .RE
 862 
 863 .sp
 864 .ne 2
 865 .na
 866 \fBDCAM1394_PARAM_PAN\fR
 867 .ad
 868 .sp .6
 869 .RS 4n
 870 Query or control a camera feature. This feature queries or controls the pan of
 871 the camera. The subparams supported by this feature are described under
 872 DCAM1394_PARAM_BRIGHTNESS.
 873 .RE
 874 
 875 .sp
 876 .ne 2
 877 .na
 878 \fBDCAM1394_PARAM_TILT\fR
 879 .ad
 880 .sp .6
 881 .RS 4n
 882 Query or control a camera feature. This feature queries or controls the tilt of
 883 the camera.The subparams supported by this feature are described under
 884 DCAM1394_PARAM_BRIGHTNESS.
 885 .RE
 886 
 887 .SH DEVICE SPECIAL FILES

 888 .ne 2
 889 .na
 890 \fB/dev/dcam\fIN\fR\fR
 891 .ad
 892 .RS 17n
 893 Device node for isochronous input from camera.
 894 .RE
 895 
 896 .sp
 897 .ne 2
 898 .na
 899 \fB/dev/dcamctl\fIN\fR\fR
 900 .ad
 901 .RS 17n
 902 Device node for camera control.
 903 .RE
 904 
 905 .SH FILES

 906 .ne 2
 907 .na
 908 \fB/kernel/drv/sparcv9/dcam1394\fR
 909 .ad
 910 .sp .6
 911 .RS 4n
 912 Device driver (SPARC)
 913 .RE
 914 
 915 .sp
 916 .ne 2
 917 .na
 918 \fB/kernel/drv/amd64/dcam1394\fR
 919 .ad
 920 .sp .6
 921 .RS 4n
 922 Device driver (x86)
 923 .RE
 924 
 925 .SH ATTRIBUTES


 926 See \fBattributes\fR(5) for descriptions of the following attributes:
 927 .sp
 928 
 929 .sp
 930 .TS
 931 box;
 932 c | c
 933 l | l .
 934 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 935 _
 936 Interface Stability     Evolving
 937 .TE
 938 
 939 .SH SEE ALSO


 940 \fBattributes\fR(5), \fBhci1394\fR(7D)
 941 .sp
 942 .LP
 943 \fI1394 Trade Association Digital Camera Specification, Version 1.04 - 1996\fR
 944 .sp
 945 .LP
 946 \fIIEEE Std 1394-2000 Standard for a High Performance Serial Bus - 2000\fR
--- EOF ---