^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) /* SPDX-License-Identifier: GPL-2.0-or-later */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) /* (C) 1999-2003 Nemosoft Unv.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) (C) 2004-2006 Luc Saillard (luc@saillard.org)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) NOTE: this version of pwc is an unofficial (modified) release of pwc & pcwx
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) driver and thus may have bugs that are not present in the original version.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) Please send bug reports and support requests to <luc@saillard.org>.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) The decompression routines have been implemented by reverse-engineering the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) Nemosoft binary pwcx module. Caveat emptor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) #ifndef PWC_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) #define PWC_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) #include <linux/module.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) #include <linux/usb.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) #include <linux/spinlock.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) #include <linux/wait.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) #include <linux/mutex.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) #include <linux/mm.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) #include <linux/slab.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) #include <asm/errno.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) #include <linux/videodev2.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) #include <media/v4l2-common.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) #include <media/v4l2-device.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) #include <media/v4l2-ioctl.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) #include <media/v4l2-ctrls.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) #include <media/v4l2-fh.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) #include <media/v4l2-event.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) #include <media/videobuf2-v4l2.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) #include <media/videobuf2-vmalloc.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) #ifdef CONFIG_USB_PWC_INPUT_EVDEV
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) #include <linux/input.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) #endif
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) #include "pwc-dec1.h"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) #include "pwc-dec23.h"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) /* Version block */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) #define PWC_VERSION "10.0.15"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) #define PWC_NAME "pwc"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) #define PFX PWC_NAME ": "
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) /* Trace certain actions in the driver */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) #define PWC_DEBUG_LEVEL_MODULE BIT(0)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) #define PWC_DEBUG_LEVEL_PROBE BIT(1)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) #define PWC_DEBUG_LEVEL_OPEN BIT(2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) #define PWC_DEBUG_LEVEL_READ BIT(3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) #define PWC_DEBUG_LEVEL_MEMORY BIT(4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) #define PWC_DEBUG_LEVEL_FLOW BIT(5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) #define PWC_DEBUG_LEVEL_SIZE BIT(6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) #define PWC_DEBUG_LEVEL_IOCTL BIT(7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) #define PWC_DEBUG_LEVEL_TRACE BIT(8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) #define PWC_DEBUG_MODULE(fmt, args...) PWC_DEBUG(MODULE, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) #define PWC_DEBUG_PROBE(fmt, args...) PWC_DEBUG(PROBE, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) #define PWC_DEBUG_OPEN(fmt, args...) PWC_DEBUG(OPEN, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) #define PWC_DEBUG_READ(fmt, args...) PWC_DEBUG(READ, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) #define PWC_DEBUG_MEMORY(fmt, args...) PWC_DEBUG(MEMORY, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) #define PWC_DEBUG_FLOW(fmt, args...) PWC_DEBUG(FLOW, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) #define PWC_DEBUG_SIZE(fmt, args...) PWC_DEBUG(SIZE, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) #define PWC_DEBUG_IOCTL(fmt, args...) PWC_DEBUG(IOCTL, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) #define PWC_DEBUG_TRACE(fmt, args...) PWC_DEBUG(TRACE, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) #ifdef CONFIG_USB_PWC_DEBUG
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) #define PWC_DEBUG_LEVEL (PWC_DEBUG_LEVEL_MODULE)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) #define PWC_DEBUG(level, fmt, args...) do {\
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) if ((PWC_DEBUG_LEVEL_ ##level) & pwc_trace) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) printk(KERN_DEBUG PFX fmt, ##args); \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) } while (0)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) #define PWC_ERROR(fmt, args...) printk(KERN_ERR PFX fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) #define PWC_WARNING(fmt, args...) printk(KERN_WARNING PFX fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) #define PWC_INFO(fmt, args...) printk(KERN_INFO PFX fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) #define PWC_TRACE(fmt, args...) PWC_DEBUG(TRACE, fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) #else /* if ! CONFIG_USB_PWC_DEBUG */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) #define PWC_ERROR(fmt, args...) printk(KERN_ERR PFX fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) #define PWC_WARNING(fmt, args...) printk(KERN_WARNING PFX fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) #define PWC_INFO(fmt, args...) printk(KERN_INFO PFX fmt, ##args)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) #define PWC_TRACE(fmt, args...) do { } while(0)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) #define PWC_DEBUG(level, fmt, args...) do { } while(0)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) #define pwc_trace 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) #endif
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) /* Defines for ToUCam cameras */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) #define TOUCAM_HEADER_SIZE 8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) #define TOUCAM_TRAILER_SIZE 4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) #define FEATURE_MOTOR_PANTILT 0x0001
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) #define FEATURE_CODEC1 0x0002
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) #define FEATURE_CODEC2 0x0004
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) #define MAX_WIDTH 640
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) #define MAX_HEIGHT 480
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) /* Ignore errors in the first N frames, to allow for startup delays */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) #define FRAME_LOWMARK 5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) /* Size and number of buffers for the ISO pipe. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) #define MAX_ISO_BUFS 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) #define ISO_FRAMES_PER_DESC 10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) #define ISO_MAX_FRAME_SIZE 960
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) #define ISO_BUFFER_SIZE (ISO_FRAMES_PER_DESC * ISO_MAX_FRAME_SIZE)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) /* Maximum size after decompression is 640x480 YUV data, 1.5 * 640 * 480 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) #define PWC_FRAME_SIZE (460800 + TOUCAM_HEADER_SIZE + TOUCAM_TRAILER_SIZE)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) /* Absolute minimum and maximum number of buffers available for mmap() */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) #define MIN_FRAMES 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) #define MAX_FRAMES 16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) /* Some macros to quickly find the type of a webcam */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) #define DEVICE_USE_CODEC1(x) ((x)<675)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) #define DEVICE_USE_CODEC2(x) ((x)>=675 && (x)<700)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) #define DEVICE_USE_CODEC3(x) ((x)>=700)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) #define DEVICE_USE_CODEC23(x) ((x)>=675)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) /* Request types: video */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) #define SET_LUM_CTL 0x01
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) #define GET_LUM_CTL 0x02
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) #define SET_CHROM_CTL 0x03
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) #define GET_CHROM_CTL 0x04
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) #define SET_STATUS_CTL 0x05
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) #define GET_STATUS_CTL 0x06
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) #define SET_EP_STREAM_CTL 0x07
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) #define GET_EP_STREAM_CTL 0x08
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) #define GET_XX_CTL 0x09
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) #define SET_XX_CTL 0x0A
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) #define GET_XY_CTL 0x0B
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) #define SET_XY_CTL 0x0C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) #define SET_MPT_CTL 0x0D
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) #define GET_MPT_CTL 0x0E
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) /* Selectors for the Luminance controls [GS]ET_LUM_CTL */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) #define AGC_MODE_FORMATTER 0x2000
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) #define PRESET_AGC_FORMATTER 0x2100
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) #define SHUTTER_MODE_FORMATTER 0x2200
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) #define PRESET_SHUTTER_FORMATTER 0x2300
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) #define PRESET_CONTOUR_FORMATTER 0x2400
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) #define AUTO_CONTOUR_FORMATTER 0x2500
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) #define BACK_LIGHT_COMPENSATION_FORMATTER 0x2600
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) #define CONTRAST_FORMATTER 0x2700
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) #define DYNAMIC_NOISE_CONTROL_FORMATTER 0x2800
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) #define FLICKERLESS_MODE_FORMATTER 0x2900
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) #define AE_CONTROL_SPEED 0x2A00
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) #define BRIGHTNESS_FORMATTER 0x2B00
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) #define GAMMA_FORMATTER 0x2C00
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) /* Selectors for the Chrominance controls [GS]ET_CHROM_CTL */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) #define WB_MODE_FORMATTER 0x1000
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) #define AWB_CONTROL_SPEED_FORMATTER 0x1100
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) #define AWB_CONTROL_DELAY_FORMATTER 0x1200
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) #define PRESET_MANUAL_RED_GAIN_FORMATTER 0x1300
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) #define PRESET_MANUAL_BLUE_GAIN_FORMATTER 0x1400
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) #define COLOUR_MODE_FORMATTER 0x1500
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) #define SATURATION_MODE_FORMATTER1 0x1600
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) #define SATURATION_MODE_FORMATTER2 0x1700
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) /* Selectors for the Status controls [GS]ET_STATUS_CTL */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) #define SAVE_USER_DEFAULTS_FORMATTER 0x0200
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) #define RESTORE_USER_DEFAULTS_FORMATTER 0x0300
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) #define RESTORE_FACTORY_DEFAULTS_FORMATTER 0x0400
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) #define READ_AGC_FORMATTER 0x0500
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) #define READ_SHUTTER_FORMATTER 0x0600
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) #define READ_RED_GAIN_FORMATTER 0x0700
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) #define READ_BLUE_GAIN_FORMATTER 0x0800
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) /* Formatters for the motorized pan & tilt [GS]ET_MPT_CTL */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177) #define PT_RELATIVE_CONTROL_FORMATTER 0x01
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) #define PT_RESET_CONTROL_FORMATTER 0x02
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) #define PT_STATUS_FORMATTER 0x03
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) /* Enumeration of image sizes */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) #define PSZ_SQCIF 0x00
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) #define PSZ_QSIF 0x01
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) #define PSZ_QCIF 0x02
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) #define PSZ_SIF 0x03
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) #define PSZ_CIF 0x04
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) #define PSZ_VGA 0x05
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) #define PSZ_MAX 6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) struct pwc_raw_frame {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) __le16 type; /* type of the webcam */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) __le16 vbandlength; /* Size of 4 lines compressed (used by the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193) decompressor) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) __u8 cmd[4]; /* the four byte of the command (in case of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195) nala, only the first 3 bytes is filled) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) __u8 rawframe[]; /* frame_size = H / 4 * vbandlength */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197) } __packed;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) /* intermediate buffers with raw data from the USB cam */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) struct pwc_frame_buf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) /* common v4l buffer stuff -- must be first */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) struct vb2_v4l2_buffer vb;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) struct list_head list;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) void *data;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) int filled; /* number of bytes filled */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) struct pwc_device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) struct video_device vdev;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212) struct v4l2_device v4l2_dev;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) /* videobuf2 queue and queued buffers list */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) struct vb2_queue vb_queue;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) struct list_head queued_bufs;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217) spinlock_t queued_bufs_lock; /* Protects queued_bufs */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219) /* If taking both locks vb_queue_lock must always be locked first! */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220) struct mutex v4l2_lock; /* Protects everything else */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) struct mutex vb_queue_lock; /* Protects vb_queue and capt_file */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 222)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 223) /* Pointer to our usb_device, will be NULL after unplug */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 224) struct usb_device *udev; /* Both mutexes most be hold when setting! */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 225)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 226) /* type of cam (645, 646, 675, 680, 690, 720, 730, 740, 750) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 227) int type;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 228) int release; /* release number */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 229) int features; /* feature bits */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 230)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 231) /*** Video data ***/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 232) int vendpoint; /* video isoc endpoint */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 233) int vcinterface; /* video control interface */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 234) int valternate; /* alternate interface needed */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 235) int vframes; /* frames-per-second */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 236) int pixfmt; /* pixelformat: V4L2_PIX_FMT_YUV420 or _PWCX */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 237) int vframe_count; /* received frames */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 238) int vmax_packet_size; /* USB maxpacket size */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 239) int vlast_packet_size; /* for frame synchronisation */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 240) int visoc_errors; /* number of contiguous ISOC errors */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 241) int vbandlength; /* compressed band length; 0 is uncompressed */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 242) char vsync; /* used by isoc handler */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 243) char vmirror; /* for ToUCaM series */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 244) char power_save; /* Do powersaving for this cam */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 245)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 246) unsigned char cmd_buf[13];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 247) unsigned char *ctrl_buf;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 248)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 249) struct urb *urbs[MAX_ISO_BUFS];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 250)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 251) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 252) * Frame currently being filled, this only gets touched by the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 253) * isoc urb complete handler, and by stream start / stop since
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 254) * start / stop touch it before / after starting / killing the urbs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 255) * no locking is needed around this
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 256) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 257) struct pwc_frame_buf *fill_buf;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 258)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 259) int frame_header_size, frame_trailer_size;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 260) int frame_size;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 261) int frame_total_size; /* including header & trailer */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 262) int drop_frames;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 263)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 264) union { /* private data for decompression engine */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 265) struct pwc_dec1_private dec1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 266) struct pwc_dec23_private dec23;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 267) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 268)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 269) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 270) * We have an 'image' and a 'view', where 'image' is the fixed-size img
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 271) * as delivered by the camera, and 'view' is the size requested by the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 272) * program. The camera image is centered in this viewport, laced with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 273) * a gray or black border. view_min <= image <= view <= view_max;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 274) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 275) int image_mask; /* supported sizes */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 276) int width, height; /* current resolution */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 277)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 278) #ifdef CONFIG_USB_PWC_INPUT_EVDEV
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 279) struct input_dev *button_dev; /* webcam snapshot button input */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 280) char button_phys[64];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 281) #endif
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 282)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 283) /* controls */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 284) struct v4l2_ctrl_handler ctrl_handler;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 285) u16 saturation_fmt;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 286) struct v4l2_ctrl *brightness;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 287) struct v4l2_ctrl *contrast;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 288) struct v4l2_ctrl *saturation;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 289) struct v4l2_ctrl *gamma;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 290) struct {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 291) /* awb / red-blue balance cluster */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 292) struct v4l2_ctrl *auto_white_balance;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 293) struct v4l2_ctrl *red_balance;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 294) struct v4l2_ctrl *blue_balance;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 295) /* usb ctrl transfers are slow, so we cache things */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 296) int color_bal_valid;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 297) unsigned long last_color_bal_update; /* In jiffies */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 298) s32 last_red_balance;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 299) s32 last_blue_balance;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 300) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 301) struct {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 302) /* autogain / gain cluster */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 303) struct v4l2_ctrl *autogain;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 304) struct v4l2_ctrl *gain;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 305) int gain_valid;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 306) unsigned long last_gain_update; /* In jiffies */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 307) s32 last_gain;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 308) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 309) struct {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 310) /* exposure_auto / exposure cluster */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 311) struct v4l2_ctrl *exposure_auto;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 312) struct v4l2_ctrl *exposure;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 313) int exposure_valid;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 314) unsigned long last_exposure_update; /* In jiffies */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 315) s32 last_exposure;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 316) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 317) struct v4l2_ctrl *colorfx;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 318) struct {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 319) /* autocontour/contour cluster */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 320) struct v4l2_ctrl *autocontour;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 321) struct v4l2_ctrl *contour;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 322) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 323) struct v4l2_ctrl *backlight;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 324) struct v4l2_ctrl *flicker;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 325) struct v4l2_ctrl *noise_reduction;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 326) struct v4l2_ctrl *save_user;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 327) struct v4l2_ctrl *restore_user;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 328) struct v4l2_ctrl *restore_factory;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 329) struct v4l2_ctrl *awb_speed;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 330) struct v4l2_ctrl *awb_delay;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 331) struct {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 332) /* motor control cluster */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 333) struct v4l2_ctrl *motor_pan;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 334) struct v4l2_ctrl *motor_tilt;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 335) struct v4l2_ctrl *motor_pan_reset;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 336) struct v4l2_ctrl *motor_tilt_reset;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 337) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 338) /* CODEC3 models have both gain and exposure controlled by autogain */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 339) struct v4l2_ctrl *autogain_expo_cluster[3];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 340) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 341)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 342) /* Global variables */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 343) #ifdef CONFIG_USB_PWC_DEBUG
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 344) extern int pwc_trace;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 345) #endif
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 346)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 347) /** Functions in pwc-misc.c */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 348) /* sizes in pixels */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 349) extern const int pwc_image_sizes[PSZ_MAX][2];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 350)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 351) int pwc_get_size(struct pwc_device *pdev, int width, int height);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 352) void pwc_construct(struct pwc_device *pdev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 353)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 354) /** Functions in pwc-ctrl.c */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 355) /* Request a certain video mode. Returns < 0 if not possible */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 356) extern int pwc_set_video_mode(struct pwc_device *pdev, int width, int height,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 357) int pixfmt, int frames, int *compression, int send_to_cam);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 358) extern unsigned int pwc_get_fps(struct pwc_device *pdev, unsigned int index, unsigned int size);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 359) extern int pwc_set_leds(struct pwc_device *pdev, int on_value, int off_value);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 360) extern int pwc_get_cmos_sensor(struct pwc_device *pdev, int *sensor);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 361) extern int send_control_msg(struct pwc_device *pdev,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 362) u8 request, u16 value, void *buf, int buflen);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 363)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 364) /* Control get / set helpers */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 365) int pwc_get_u8_ctrl(struct pwc_device *pdev, u8 request, u16 value, int *data);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 366) int pwc_set_u8_ctrl(struct pwc_device *pdev, u8 request, u16 value, u8 data);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 367) int pwc_get_s8_ctrl(struct pwc_device *pdev, u8 request, u16 value, int *data);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 368) #define pwc_set_s8_ctrl pwc_set_u8_ctrl
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 369) int pwc_get_u16_ctrl(struct pwc_device *pdev, u8 request, u16 value, int *dat);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 370) int pwc_set_u16_ctrl(struct pwc_device *pdev, u8 request, u16 value, u16 data);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 371) int pwc_button_ctrl(struct pwc_device *pdev, u16 value);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 372) int pwc_init_controls(struct pwc_device *pdev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 373)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 374) /* Power down or up the camera; not supported by all models */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 375) extern void pwc_camera_power(struct pwc_device *pdev, int power);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 376)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 377) extern const struct v4l2_ioctl_ops pwc_ioctl_ops;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 378)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 379) /** pwc-uncompress.c */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 380) /* Expand frame to image, possibly including decompression. Uses read_frame and fill_image */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 381) int pwc_decompress(struct pwc_device *pdev, struct pwc_frame_buf *fbuf);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 382)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 383) #endif
Orange Pi5 kernel
Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards
3 Commits
0 Branches
0 Tags