1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * USB Driver for ALi m5602 based webcams 4 * 5 * Copyright (C) 2008 Erik Andrén 6 * Copyright (C) 2007 Ilyes Gouta. Based on the m5603x Linux Driver Project. 7 * Copyright (C) 2005 m5603x Linux Driver Project <m5602@x3ng.com.br> 8 * 9 * Portions of code to USB interface and ALi driver software, 10 * Copyright (c) 2006 Willem Duinker 11 * v4l2 interface modeled after the V4L2 driver 12 * for SN9C10x PC Camera Controllers 13 */ 14 15 #ifndef M5602_BRIDGE_H_ 16 #define M5602_BRIDGE_H_ 17 18 #include <linux/slab.h> 19 #include "gspca.h" 20 21 #define MODULE_NAME "ALi m5602" 22 23 /*****************************************************************************/ 24 25 #define M5602_XB_SENSOR_TYPE 0x00 26 #define M5602_XB_SENSOR_CTRL 0x01 27 #define M5602_XB_LINE_OF_FRAME_H 0x02 28 #define M5602_XB_LINE_OF_FRAME_L 0x03 29 #define M5602_XB_PIX_OF_LINE_H 0x04 30 #define M5602_XB_PIX_OF_LINE_L 0x05 31 #define M5602_XB_VSYNC_PARA 0x06 32 #define M5602_XB_HSYNC_PARA 0x07 33 #define M5602_XB_TEST_MODE_1 0x08 34 #define M5602_XB_TEST_MODE_2 0x09 35 #define M5602_XB_SIG_INI 0x0a 36 #define M5602_XB_DS_PARA 0x0e 37 #define M5602_XB_TRIG_PARA 0x0f 38 #define M5602_XB_CLK_PD 0x10 39 #define M5602_XB_MCU_CLK_CTRL 0x12 40 #define M5602_XB_MCU_CLK_DIV 0x13 41 #define M5602_XB_SEN_CLK_CTRL 0x14 42 #define M5602_XB_SEN_CLK_DIV 0x15 43 #define M5602_XB_AUD_CLK_CTRL 0x16 44 #define M5602_XB_AUD_CLK_DIV 0x17 45 #define M5602_OB_AC_LINK_STATE 0x22 46 #define M5602_OB_PCM_SLOT_INDEX 0x24 47 #define M5602_OB_GPIO_SLOT_INDEX 0x25 48 #define M5602_OB_ACRX_STATUS_ADDRESS_H 0x28 49 #define M5602_OB_ACRX_STATUS_DATA_L 0x29 50 #define M5602_OB_ACRX_STATUS_DATA_H 0x2a 51 #define M5602_OB_ACTX_COMMAND_ADDRESS 0x31 52 #define M5602_OB_ACRX_COMMAND_DATA_L 0x32 53 #define M5602_OB_ACTX_COMMAND_DATA_H 0X33 54 #define M5602_XB_DEVCTR1 0x41 55 #define M5602_XB_EPSETR0 0x42 56 #define M5602_XB_EPAFCTR 0x47 57 #define M5602_XB_EPBFCTR 0x49 58 #define M5602_XB_EPEFCTR 0x4f 59 #define M5602_XB_TEST_REG 0x53 60 #define M5602_XB_ALT2SIZE 0x54 61 #define M5602_XB_ALT3SIZE 0x55 62 #define M5602_XB_OBSFRAME 0x56 63 #define M5602_XB_PWR_CTL 0x59 64 #define M5602_XB_ADC_CTRL 0x60 65 #define M5602_XB_ADC_DATA 0x61 66 #define M5602_XB_MISC_CTRL 0x62 67 #define M5602_XB_SNAPSHOT 0x63 68 #define M5602_XB_SCRATCH_1 0x64 69 #define M5602_XB_SCRATCH_2 0x65 70 #define M5602_XB_SCRATCH_3 0x66 71 #define M5602_XB_SCRATCH_4 0x67 72 #define M5602_XB_I2C_CTRL 0x68 73 #define M5602_XB_I2C_CLK_DIV 0x69 74 #define M5602_XB_I2C_DEV_ADDR 0x6a 75 #define M5602_XB_I2C_REG_ADDR 0x6b 76 #define M5602_XB_I2C_DATA 0x6c 77 #define M5602_XB_I2C_STATUS 0x6d 78 #define M5602_XB_GPIO_DAT_H 0x70 79 #define M5602_XB_GPIO_DAT_L 0x71 80 #define M5602_XB_GPIO_DIR_H 0x72 81 #define M5602_XB_GPIO_DIR_L 0x73 82 #define M5602_XB_GPIO_EN_H 0x74 83 #define M5602_XB_GPIO_EN_L 0x75 84 #define M5602_XB_GPIO_DAT 0x76 85 #define M5602_XB_GPIO_DIR 0x77 86 #define M5602_XB_SEN_CLK_CONTROL 0x80 87 #define M5602_XB_SEN_CLK_DIVISION 0x81 88 #define M5602_XB_CPR_CLK_CONTROL 0x82 89 #define M5602_XB_CPR_CLK_DIVISION 0x83 90 #define M5602_XB_MCU_CLK_CONTROL 0x84 91 #define M5602_XB_MCU_CLK_DIVISION 0x85 92 #define M5602_XB_DCT_CLK_CONTROL 0x86 93 #define M5602_XB_DCT_CLK_DIVISION 0x87 94 #define M5602_XB_EC_CLK_CONTROL 0x88 95 #define M5602_XB_EC_CLK_DIVISION 0x89 96 #define M5602_XB_LBUF_CLK_CONTROL 0x8a 97 #define M5602_XB_LBUF_CLK_DIVISION 0x8b 98 99 #define I2C_BUSY 0x80 100 101 /*****************************************************************************/ 102 103 /* Driver info */ 104 #define DRIVER_AUTHOR "ALi m5602 Linux Driver Project" 105 #define DRIVER_DESC "ALi m5602 webcam driver" 106 107 #define M5602_ISOC_ENDPOINT_ADDR 0x81 108 #define M5602_INTR_ENDPOINT_ADDR 0x82 109 110 #define M5602_URB_MSG_TIMEOUT 5000 111 112 /*****************************************************************************/ 113 114 struct sd { 115 struct gspca_dev gspca_dev; 116 117 /* A pointer to the currently connected sensor */ 118 const struct m5602_sensor *sensor; 119 120 /* The current frame's id, used to detect frame boundaries */ 121 u8 frame_id; 122 123 /* The current frame count */ 124 u32 frame_count; 125 126 /* Camera rotation polling thread for "flipable" cams */ 127 struct task_struct *rotation_thread; 128 129 struct { /* auto-white-bal + green/red/blue balance control cluster */ 130 struct v4l2_ctrl *auto_white_bal; 131 struct v4l2_ctrl *red_bal; 132 struct v4l2_ctrl *blue_bal; 133 struct v4l2_ctrl *green_bal; 134 }; 135 struct { /* autoexpo / expo cluster */ 136 struct v4l2_ctrl *autoexpo; 137 struct v4l2_ctrl *expo; 138 }; 139 struct { /* autogain / gain cluster */ 140 struct v4l2_ctrl *autogain; 141 struct v4l2_ctrl *gain; 142 }; 143 struct { /* hflip/vflip cluster */ 144 struct v4l2_ctrl *hflip; 145 struct v4l2_ctrl *vflip; 146 }; 147 }; 148 149 int m5602_read_bridge( 150 struct sd *sd, const u8 address, u8 *i2c_data); 151 152 int m5602_write_bridge( 153 struct sd *sd, const u8 address, const u8 i2c_data); 154 155 int m5602_write_sensor(struct sd *sd, const u8 address, 156 u8 *i2c_data, const u8 len); 157 158 int m5602_read_sensor(struct sd *sd, const u8 address, 159 u8 *i2c_data, const u8 len); 160 161 #endif 162