2 * Copyright (C) 2005-2006 Micronas USA Inc.
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License (Version 2) as
6 * published by the Free Software Foundation.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
14 #include <linux/module.h>
15 #include <linux/init.h>
16 #include <linux/i2c.h>
17 #include <linux/videodev2.h>
18 #include <linux/ioctl.h>
19 #include <media/v4l2-device.h>
20 #include <media/v4l2-ctrls.h>
21 #include <linux/slab.h>
23 MODULE_DESCRIPTION("TW9903 I2C subdev driver");
24 MODULE_LICENSE("GPL v2");
27 * This driver is based on the wis-tw9903.c source that was in
28 * drivers/staging/media/go7007. That source had commented out code for
29 * saturation and scaling (neither seemed to work). If anyone ever gets
30 * hardware to test this driver, then that code might be useful to look at.
31 * You need to get the kernel sources of, say, kernel 3.8 where that
32 * wis-tw9903 driver is still present.
36 struct v4l2_subdev sd;
37 struct v4l2_ctrl_handler hdl;
41 static inline struct tw9903 *to_state(struct v4l2_subdev *sd)
43 return container_of(sd, struct tw9903, sd);
46 static const u8 initial_registers[] = {
47 0x02, 0x44, /* input 1, composite */
48 0x03, 0x92, /* correct digital format */
50 0x05, 0x80, /* or 0x00 for PAL */
51 0x06, 0x40, /* second internal current reference */
52 0x07, 0x02, /* window */
53 0x08, 0x14, /* window */
54 0x09, 0xf0, /* window */
55 0x0a, 0x81, /* window */
56 0x0b, 0xd0, /* window */
58 0x0d, 0x00, /* scaling */
59 0x0e, 0x11, /* scaling */
60 0x0f, 0x00, /* scaling */
61 0x10, 0x00, /* brightness */
62 0x11, 0x60, /* contrast */
63 0x12, 0x01, /* sharpness */
64 0x13, 0x7f, /* U gain */
65 0x14, 0x5a, /* V gain */
67 0x16, 0xc3, /* sharpness */
71 0x1c, 0x0f, /* video norm */
72 0x1d, 0x7f, /* video norm */
73 0x20, 0xa0, /* clamping gain (working 0x50) */
87 0x2e, 0xa5, /* burst PLL control (working: a9) */
88 0x2f, 0xe0, /* 0xea is blue test frame -- 0xe0 for normal */
94 0x06, 0xc0, /* reset device */
95 0x00, 0x00, /* Terminator (reg 0x00 is read-only) */
98 static int write_reg(struct v4l2_subdev *sd, u8 reg, u8 value)
100 struct i2c_client *client = v4l2_get_subdevdata(sd);
102 return i2c_smbus_write_byte_data(client, reg, value);
105 static int write_regs(struct v4l2_subdev *sd, const u8 *regs)
109 for (i = 0; regs[i] != 0x00; i += 2)
110 if (write_reg(sd, regs[i], regs[i + 1]) < 0)
115 static int tw9903_s_video_routing(struct v4l2_subdev *sd, u32 input,
116 u32 output, u32 config)
118 write_reg(sd, 0x02, 0x40 | (input << 1));
122 static int tw9903_s_std(struct v4l2_subdev *sd, v4l2_std_id norm)
124 struct tw9903 *dec = to_state(sd);
125 bool is_60hz = norm & V4L2_STD_525_60;
126 static const u8 config_60hz[] = {
133 static const u8 config_50hz[] = {
141 write_regs(sd, is_60hz ? config_60hz : config_50hz);
147 static int tw9903_s_ctrl(struct v4l2_ctrl *ctrl)
149 struct tw9903 *dec = container_of(ctrl->handler, struct tw9903, hdl);
150 struct v4l2_subdev *sd = &dec->sd;
153 case V4L2_CID_BRIGHTNESS:
154 write_reg(sd, 0x10, ctrl->val);
156 case V4L2_CID_CONTRAST:
157 write_reg(sd, 0x11, ctrl->val);
160 write_reg(sd, 0x15, ctrl->val);
168 static int tw9903_log_status(struct v4l2_subdev *sd)
170 struct tw9903 *dec = to_state(sd);
171 bool is_60hz = dec->norm & V4L2_STD_525_60;
173 v4l2_info(sd, "Standard: %d Hz\n", is_60hz ? 60 : 50);
174 v4l2_ctrl_subdev_log_status(sd);
178 /* --------------------------------------------------------------------------*/
180 static const struct v4l2_ctrl_ops tw9903_ctrl_ops = {
181 .s_ctrl = tw9903_s_ctrl,
184 static const struct v4l2_subdev_core_ops tw9903_core_ops = {
185 .log_status = tw9903_log_status,
188 static const struct v4l2_subdev_video_ops tw9903_video_ops = {
189 .s_std = tw9903_s_std,
190 .s_routing = tw9903_s_video_routing,
193 static const struct v4l2_subdev_ops tw9903_ops = {
194 .core = &tw9903_core_ops,
195 .video = &tw9903_video_ops,
198 /* --------------------------------------------------------------------------*/
200 static int tw9903_probe(struct i2c_client *client,
201 const struct i2c_device_id *id)
204 struct v4l2_subdev *sd;
205 struct v4l2_ctrl_handler *hdl;
207 /* Check if the adapter supports the needed features */
208 if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_BYTE_DATA))
211 v4l_info(client, "chip found @ 0x%02x (%s)\n",
212 client->addr << 1, client->adapter->name);
214 dec = devm_kzalloc(&client->dev, sizeof(*dec), GFP_KERNEL);
218 v4l2_i2c_subdev_init(sd, client, &tw9903_ops);
220 v4l2_ctrl_handler_init(hdl, 4);
221 v4l2_ctrl_new_std(hdl, &tw9903_ctrl_ops,
222 V4L2_CID_BRIGHTNESS, -128, 127, 1, 0);
223 v4l2_ctrl_new_std(hdl, &tw9903_ctrl_ops,
224 V4L2_CID_CONTRAST, 0, 255, 1, 0x60);
225 v4l2_ctrl_new_std(hdl, &tw9903_ctrl_ops,
226 V4L2_CID_HUE, -128, 127, 1, 0);
227 sd->ctrl_handler = hdl;
229 int err = hdl->error;
231 v4l2_ctrl_handler_free(hdl);
235 /* Initialize tw9903 */
236 dec->norm = V4L2_STD_NTSC;
238 if (write_regs(sd, initial_registers) < 0) {
239 v4l2_err(client, "error initializing TW9903\n");
246 static int tw9903_remove(struct i2c_client *client)
248 struct v4l2_subdev *sd = i2c_get_clientdata(client);
250 v4l2_device_unregister_subdev(sd);
251 v4l2_ctrl_handler_free(&to_state(sd)->hdl);
255 /* ----------------------------------------------------------------------- */
257 static const struct i2c_device_id tw9903_id[] = {
261 MODULE_DEVICE_TABLE(i2c, tw9903_id);
263 static struct i2c_driver tw9903_driver = {
267 .probe = tw9903_probe,
268 .remove = tw9903_remove,
269 .id_table = tw9903_id,
271 module_i2c_driver(tw9903_driver);