LXR linux/drivers/media/video/gspca/m5602/m5602

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