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 ---