Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
s5k6aa.c
Go to the documentation of this file.
1 /*
2  * Driver for Samsung S5K6AAFX SXGA 1/6" 1.3M CMOS Image Sensor
3  * with embedded SoC ISP.
4  *
5  * Copyright (C) 2011, Samsung Electronics Co., Ltd.
6  * Sylwester Nawrocki <[email protected]>
7  *
8  * Based on a driver authored by Dongsoo Nathaniel Kim.
9  * Copyright (C) 2009, Dongsoo Nathaniel Kim <[email protected]>
10  *
11  * This program is free software; you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License as published by
13  * the Free Software Foundation; either version 2 of the License, or
14  * (at your option) any later version.
15  */
16 
17 #include <linux/clk.h>
18 #include <linux/delay.h>
19 #include <linux/gpio.h>
20 #include <linux/i2c.h>
21 #include <linux/media.h>
22 #include <linux/module.h>
24 #include <linux/slab.h>
25 
26 #include <media/media-entity.h>
27 #include <media/v4l2-ctrls.h>
28 #include <media/v4l2-device.h>
29 #include <media/v4l2-subdev.h>
30 #include <media/v4l2-mediabus.h>
31 #include <media/s5k6aa.h>
32 
33 static int debug;
34 module_param(debug, int, 0644);
35 
36 #define DRIVER_NAME "S5K6AA"
37 
38 /* The token to indicate array termination */
39 #define S5K6AA_TERM 0xffff
40 #define S5K6AA_OUT_WIDTH_DEF 640
41 #define S5K6AA_OUT_HEIGHT_DEF 480
42 #define S5K6AA_WIN_WIDTH_MAX 1280
43 #define S5K6AA_WIN_HEIGHT_MAX 1024
44 #define S5K6AA_WIN_WIDTH_MIN 8
45 #define S5K6AA_WIN_HEIGHT_MIN 8
46 
47 /*
48  * H/W register Interface (0xD0000000 - 0xD0000FFF)
49  */
50 #define AHB_MSB_ADDR_PTR 0xfcfc
51 #define GEN_REG_OFFSH 0xd000
52 #define REG_CMDWR_ADDRH 0x0028
53 #define REG_CMDWR_ADDRL 0x002a
54 #define REG_CMDRD_ADDRH 0x002c
55 #define REG_CMDRD_ADDRL 0x002e
56 #define REG_CMDBUF0_ADDR 0x0f12
57 #define REG_CMDBUF1_ADDR 0x0f10
58 
59 /*
60  * Host S/W Register interface (0x70000000 - 0x70002000)
61  * The value of the two most significant address bytes is 0x7000,
62  * (HOST_SWIF_OFFS_H). The register addresses below specify 2 LSBs.
63  */
64 #define HOST_SWIF_OFFSH 0x7000
65 
66 /* Initialization parameters */
67 /* Master clock frequency in KHz */
68 #define REG_I_INCLK_FREQ_L 0x01b8
69 #define REG_I_INCLK_FREQ_H 0x01ba
70 #define MIN_MCLK_FREQ_KHZ 6000U
71 #define MAX_MCLK_FREQ_KHZ 27000U
72 #define REG_I_USE_NPVI_CLOCKS 0x01c6
73 #define REG_I_USE_NMIPI_CLOCKS 0x01c8
74 
75 /* Clock configurations, n = 0..2. REG_I_* frequency unit is 4 kHz. */
76 #define REG_I_OPCLK_4KHZ(n) ((n) * 6 + 0x01cc)
77 #define REG_I_MIN_OUTRATE_4KHZ(n) ((n) * 6 + 0x01ce)
78 #define REG_I_MAX_OUTRATE_4KHZ(n) ((n) * 6 + 0x01d0)
79 #define SYS_PLL_OUT_FREQ (48000000 / 4000)
80 #define PCLK_FREQ_MIN (24000000 / 4000)
81 #define PCLK_FREQ_MAX (48000000 / 4000)
82 #define REG_I_INIT_PARAMS_UPDATED 0x01e0
83 #define REG_I_ERROR_INFO 0x01e2
84 
85 /* General purpose parameters */
86 #define REG_USER_BRIGHTNESS 0x01e4
87 #define REG_USER_CONTRAST 0x01e6
88 #define REG_USER_SATURATION 0x01e8
89 #define REG_USER_SHARPBLUR 0x01ea
90 
91 #define REG_G_SPEC_EFFECTS 0x01ee
92 #define REG_G_ENABLE_PREV 0x01f0
93 #define REG_G_ENABLE_PREV_CHG 0x01f2
94 #define REG_G_NEW_CFG_SYNC 0x01f8
95 #define REG_G_PREVZOOM_IN_WIDTH 0x020a
96 #define REG_G_PREVZOOM_IN_HEIGHT 0x020c
97 #define REG_G_PREVZOOM_IN_XOFFS 0x020e
98 #define REG_G_PREVZOOM_IN_YOFFS 0x0210
99 #define REG_G_INPUTS_CHANGE_REQ 0x021a
100 #define REG_G_ACTIVE_PREV_CFG 0x021c
101 #define REG_G_PREV_CFG_CHG 0x021e
102 #define REG_G_PREV_OPEN_AFTER_CH 0x0220
103 #define REG_G_PREV_CFG_ERROR 0x0222
104 
105 /* Preview control section. n = 0...4. */
106 #define PREG(n, x) ((n) * 0x26 + x)
107 #define REG_P_OUT_WIDTH(n) PREG(n, 0x0242)
108 #define REG_P_OUT_HEIGHT(n) PREG(n, 0x0244)
109 #define REG_P_FMT(n) PREG(n, 0x0246)
110 #define REG_P_MAX_OUT_RATE(n) PREG(n, 0x0248)
111 #define REG_P_MIN_OUT_RATE(n) PREG(n, 0x024a)
112 #define REG_P_PVI_MASK(n) PREG(n, 0x024c)
113 #define REG_P_CLK_INDEX(n) PREG(n, 0x024e)
114 #define REG_P_FR_RATE_TYPE(n) PREG(n, 0x0250)
115 #define FR_RATE_DYNAMIC 0
116 #define FR_RATE_FIXED 1
117 #define FR_RATE_FIXED_ACCURATE 2
118 #define REG_P_FR_RATE_Q_TYPE(n) PREG(n, 0x0252)
119 #define FR_RATE_Q_BEST_FRRATE 1 /* Binning enabled */
120 #define FR_RATE_Q_BEST_QUALITY 2 /* Binning disabled */
121 /* Frame period in 0.1 ms units */
122 #define REG_P_MAX_FR_TIME(n) PREG(n, 0x0254)
123 #define REG_P_MIN_FR_TIME(n) PREG(n, 0x0256)
124 /* Conversion to REG_P_[MAX/MIN]_FR_TIME value; __t: time in us */
125 #define US_TO_FR_TIME(__t) ((__t) / 100)
126 #define S5K6AA_MIN_FR_TIME 33300 /* us */
127 #define S5K6AA_MAX_FR_TIME 650000 /* us */
128 #define S5K6AA_MAX_HIGHRES_FR_TIME 666 /* x100 us */
129 /* The below 5 registers are for "device correction" values */
130 #define REG_P_COLORTEMP(n) PREG(n, 0x025e)
131 #define REG_P_PREV_MIRROR(n) PREG(n, 0x0262)
132 
133 /* Extended image property controls */
134 /* Exposure time in 10 us units */
135 #define REG_SF_USR_EXPOSURE_L 0x03c6
136 #define REG_SF_USR_EXPOSURE_H 0x03c8
137 #define REG_SF_USR_EXPOSURE_CHG 0x03ca
138 #define REG_SF_USR_TOT_GAIN 0x03cc
139 #define REG_SF_USR_TOT_GAIN_CHG 0x03ce
140 #define REG_SF_RGAIN 0x03d0
141 #define REG_SF_RGAIN_CHG 0x03d2
142 #define REG_SF_GGAIN 0x03d4
143 #define REG_SF_GGAIN_CHG 0x03d6
144 #define REG_SF_BGAIN 0x03d8
145 #define REG_SF_BGAIN_CHG 0x03da
146 #define REG_SF_FLICKER_QUANT 0x03dc
147 #define REG_SF_FLICKER_QUANT_CHG 0x03de
148 
149 /* Output interface (parallel/MIPI) setup */
150 #define REG_OIF_EN_MIPI_LANES 0x03fa
151 #define REG_OIF_EN_PACKETS 0x03fc
152 #define REG_OIF_CFG_CHG 0x03fe
153 
154 /* Auto-algorithms enable mask */
155 #define REG_DBG_AUTOALG_EN 0x0400
156 #define AALG_ALL_EN_MASK (1 << 0)
157 #define AALG_AE_EN_MASK (1 << 1)
158 #define AALG_DIVLEI_EN_MASK (1 << 2)
159 #define AALG_WB_EN_MASK (1 << 3)
160 #define AALG_FLICKER_EN_MASK (1 << 5)
161 #define AALG_FIT_EN_MASK (1 << 6)
162 #define AALG_WRHW_EN_MASK (1 << 7)
163 
164 /* Firmware revision information */
165 #define REG_FW_APIVER 0x012e
166 #define S5K6AAFX_FW_APIVER 0x0001
167 #define REG_FW_REVISION 0x0130
168 
169 /* For now we use only one user configuration register set */
170 #define S5K6AA_MAX_PRESETS 1
171 
172 static const char * const s5k6aa_supply_names[] = {
173  "vdd_core", /* Digital core supply 1.5V (1.4V to 1.6V) */
174  "vdda", /* Analog power supply 2.8V (2.6V to 3.0V) */
175  "vdd_reg", /* Regulator input power 1.8V (1.7V to 1.9V)
176  or 2.8V (2.6V to 3.0) */
177  "vddio", /* I/O supply 1.8V (1.65V to 1.95V)
178  or 2.8V (2.5V to 3.1V) */
179 };
180 #define S5K6AA_NUM_SUPPLIES ARRAY_SIZE(s5k6aa_supply_names)
181 
186 };
187 
191 };
192 
196  /* REG_P_FMT(x) register value */
198 };
199 
201  /* output pixel format and resolution */
202  struct v4l2_mbus_framefmt mbus_fmt;
205 };
206 
207 struct s5k6aa_ctrls {
209  /* Auto / manual white balance cluster */
210  struct v4l2_ctrl *awb;
214  /* Mirror cluster */
215  struct v4l2_ctrl *hflip;
216  struct v4l2_ctrl *vflip;
217  /* Auto exposure / manual exposure and gain cluster */
220  struct v4l2_ctrl *gain;
221 };
222 
226  /* Maximum rectangle for the interval */
228 };
229 
230 struct s5k6aa {
231  struct v4l2_subdev sd;
232  struct media_pad pad;
233 
236 
237  int (*s_power)(int enable);
240 
241  /* external master clock frequency */
242  unsigned long mclk_frequency;
243  /* ISP internal master clock frequency */
245  /* output pixel clock frequency range */
248 
249  unsigned int inv_hflip:1;
250  unsigned int inv_vflip:1;
251 
252  /* protects the struct members below */
253  struct mutex lock;
254 
255  /* sensor matrix scan window */
257 
261  const struct s5k6aa_interval *fiv;
262 
263  unsigned int streaming:1;
264  unsigned int apply_cfg:1;
265  unsigned int apply_crop:1;
266  unsigned int power;
267 };
268 
269 static struct s5k6aa_regval s5k6aa_analog_config[] = {
270  /* Analog settings */
271  { 0x112a, 0x0000 }, { 0x1132, 0x0000 },
272  { 0x113e, 0x0000 }, { 0x115c, 0x0000 },
273  { 0x1164, 0x0000 }, { 0x1174, 0x0000 },
274  { 0x1178, 0x0000 }, { 0x077a, 0x0000 },
275  { 0x077c, 0x0000 }, { 0x077e, 0x0000 },
276  { 0x0780, 0x0000 }, { 0x0782, 0x0000 },
277  { 0x0784, 0x0000 }, { 0x0786, 0x0000 },
278  { 0x0788, 0x0000 }, { 0x07a2, 0x0000 },
279  { 0x07a4, 0x0000 }, { 0x07a6, 0x0000 },
280  { 0x07a8, 0x0000 }, { 0x07b6, 0x0000 },
281  { 0x07b8, 0x0002 }, { 0x07ba, 0x0004 },
282  { 0x07bc, 0x0004 }, { 0x07be, 0x0005 },
283  { 0x07c0, 0x0005 }, { S5K6AA_TERM, 0 },
284 };
285 
286 /* TODO: Add RGB888 and Bayer format */
287 static const struct s5k6aa_pixfmt s5k6aa_formats[] = {
289  /* range 16-240 */
292 };
293 
294 static const struct s5k6aa_interval s5k6aa_intervals[] = {
295  { 1000, {10000, 1000000}, {1280, 1024} }, /* 10 fps */
296  { 666, {15000, 1000000}, {1280, 1024} }, /* 15 fps */
297  { 500, {20000, 1000000}, {1280, 720} }, /* 20 fps */
298  { 400, {25000, 1000000}, {640, 480} }, /* 25 fps */
299  { 333, {33300, 1000000}, {640, 480} }, /* 30 fps */
300 };
301 
302 #define S5K6AA_INTERVAL_DEF_INDEX 1 /* 15 fps */
303 
304 static inline struct v4l2_subdev *ctrl_to_sd(struct v4l2_ctrl *ctrl)
305 {
306  return &container_of(ctrl->handler, struct s5k6aa, ctrls.handler)->sd;
307 }
308 
309 static inline struct s5k6aa *to_s5k6aa(struct v4l2_subdev *sd)
310 {
311  return container_of(sd, struct s5k6aa, sd);
312 }
313 
314 /* Set initial values for all preview presets */
315 static void s5k6aa_presets_data_init(struct s5k6aa *s5k6aa)
316 {
317  struct s5k6aa_preset *preset = &s5k6aa->presets[0];
318  int i;
319 
320  for (i = 0; i < S5K6AA_MAX_PRESETS; i++) {
321  preset->mbus_fmt.width = S5K6AA_OUT_WIDTH_DEF;
322  preset->mbus_fmt.height = S5K6AA_OUT_HEIGHT_DEF;
323  preset->mbus_fmt.code = s5k6aa_formats[0].code;
324  preset->index = i;
325  preset->clk_id = 0;
326  preset++;
327  }
328 
329  s5k6aa->fiv = &s5k6aa_intervals[S5K6AA_INTERVAL_DEF_INDEX];
330  s5k6aa->preset = &s5k6aa->presets[0];
331 }
332 
333 static int s5k6aa_i2c_read(struct i2c_client *client, u16 addr, u16 *val)
334 {
335  u8 wbuf[2] = {addr >> 8, addr & 0xFF};
336  struct i2c_msg msg[2];
337  u8 rbuf[2];
338  int ret;
339 
340  msg[0].addr = client->addr;
341  msg[0].flags = 0;
342  msg[0].len = 2;
343  msg[0].buf = wbuf;
344 
345  msg[1].addr = client->addr;
346  msg[1].flags = I2C_M_RD;
347  msg[1].len = 2;
348  msg[1].buf = rbuf;
349 
350  ret = i2c_transfer(client->adapter, msg, 2);
351  *val = be16_to_cpu(*((u16 *)rbuf));
352 
353  v4l2_dbg(3, debug, client, "i2c_read: 0x%04X : 0x%04x\n", addr, *val);
354 
355  return ret == 2 ? 0 : ret;
356 }
357 
358 static int s5k6aa_i2c_write(struct i2c_client *client, u16 addr, u16 val)
359 {
360  u8 buf[4] = {addr >> 8, addr & 0xFF, val >> 8, val & 0xFF};
361 
362  int ret = i2c_master_send(client, buf, 4);
363  v4l2_dbg(3, debug, client, "i2c_write: 0x%04X : 0x%04x\n", addr, val);
364 
365  return ret == 4 ? 0 : ret;
366 }
367 
368 /* The command register write, assumes Command_Wr_addH = 0x7000. */
369 static int s5k6aa_write(struct i2c_client *c, u16 addr, u16 val)
370 {
371  int ret = s5k6aa_i2c_write(c, REG_CMDWR_ADDRL, addr);
372  if (ret)
373  return ret;
374  return s5k6aa_i2c_write(c, REG_CMDBUF0_ADDR, val);
375 }
376 
377 /* The command register read, assumes Command_Rd_addH = 0x7000. */
378 static int s5k6aa_read(struct i2c_client *client, u16 addr, u16 *val)
379 {
380  int ret = s5k6aa_i2c_write(client, REG_CMDRD_ADDRL, addr);
381  if (ret)
382  return ret;
383  return s5k6aa_i2c_read(client, REG_CMDBUF0_ADDR, val);
384 }
385 
386 static int s5k6aa_write_array(struct v4l2_subdev *sd,
387  const struct s5k6aa_regval *msg)
388 {
389  struct i2c_client *client = v4l2_get_subdevdata(sd);
390  u16 addr_incr = 0;
391  int ret = 0;
392 
393  while (msg->addr != S5K6AA_TERM) {
394  if (addr_incr != 2)
395  ret = s5k6aa_i2c_write(client, REG_CMDWR_ADDRL,
396  msg->addr);
397  if (ret)
398  break;
399  ret = s5k6aa_i2c_write(client, REG_CMDBUF0_ADDR, msg->val);
400  if (ret)
401  break;
402  /* Assume that msg->addr is always less than 0xfffc */
403  addr_incr = (msg + 1)->addr - msg->addr;
404  msg++;
405  }
406 
407  return ret;
408 }
409 
410 /* Configure the AHB high address bytes for GTG registers access */
411 static int s5k6aa_set_ahb_address(struct i2c_client *client)
412 {
413  int ret = s5k6aa_i2c_write(client, AHB_MSB_ADDR_PTR, GEN_REG_OFFSH);
414  if (ret)
415  return ret;
416  ret = s5k6aa_i2c_write(client, REG_CMDRD_ADDRH, HOST_SWIF_OFFSH);
417  if (ret)
418  return ret;
419  return s5k6aa_i2c_write(client, REG_CMDWR_ADDRH, HOST_SWIF_OFFSH);
420 }
421 
428 static int s5k6aa_configure_pixel_clocks(struct s5k6aa *s5k6aa)
429 {
430  struct i2c_client *c = v4l2_get_subdevdata(&s5k6aa->sd);
431  unsigned long fmclk = s5k6aa->mclk_frequency / 1000;
432  u16 status;
433  int ret;
434 
435  if (WARN(fmclk < MIN_MCLK_FREQ_KHZ || fmclk > MAX_MCLK_FREQ_KHZ,
436  "Invalid clock frequency: %ld\n", fmclk))
437  return -EINVAL;
438 
439  s5k6aa->pclk_fmin = PCLK_FREQ_MIN;
440  s5k6aa->pclk_fmax = PCLK_FREQ_MAX;
441  s5k6aa->clk_fop = SYS_PLL_OUT_FREQ;
442 
443  /* External input clock frequency in kHz */
444  ret = s5k6aa_write(c, REG_I_INCLK_FREQ_H, fmclk >> 16);
445  if (!ret)
446  ret = s5k6aa_write(c, REG_I_INCLK_FREQ_L, fmclk & 0xFFFF);
447  if (!ret)
448  ret = s5k6aa_write(c, REG_I_USE_NPVI_CLOCKS, 1);
449  /* Internal PLL frequency */
450  if (!ret)
451  ret = s5k6aa_write(c, REG_I_OPCLK_4KHZ(0), s5k6aa->clk_fop);
452  if (!ret)
453  ret = s5k6aa_write(c, REG_I_MIN_OUTRATE_4KHZ(0),
454  s5k6aa->pclk_fmin);
455  if (!ret)
456  ret = s5k6aa_write(c, REG_I_MAX_OUTRATE_4KHZ(0),
457  s5k6aa->pclk_fmax);
458  if (!ret)
459  ret = s5k6aa_write(c, REG_I_INIT_PARAMS_UPDATED, 1);
460  if (!ret)
461  ret = s5k6aa_read(c, REG_I_ERROR_INFO, &status);
462 
463  return ret ? ret : (status ? -EINVAL : 0);
464 }
465 
466 /* Set horizontal and vertical image flipping */
467 static int s5k6aa_set_mirror(struct s5k6aa *s5k6aa, int horiz_flip)
468 {
469  struct i2c_client *client = v4l2_get_subdevdata(&s5k6aa->sd);
470  int index = s5k6aa->preset->index;
471 
472  unsigned int vflip = s5k6aa->ctrls.vflip->val ^ s5k6aa->inv_vflip;
473  unsigned int flip = (horiz_flip ^ s5k6aa->inv_hflip) | (vflip << 1);
474 
475  return s5k6aa_write(client, REG_P_PREV_MIRROR(index), flip);
476 }
477 
478 /* Configure auto/manual white balance and R/G/B gains */
479 static int s5k6aa_set_awb(struct s5k6aa *s5k6aa, int awb)
480 {
481  struct i2c_client *c = v4l2_get_subdevdata(&s5k6aa->sd);
482  struct s5k6aa_ctrls *ctrls = &s5k6aa->ctrls;
483  u16 reg;
484 
485  int ret = s5k6aa_read(c, REG_DBG_AUTOALG_EN, &reg);
486 
487  if (!ret && !awb) {
488  ret = s5k6aa_write(c, REG_SF_RGAIN, ctrls->gain_red->val);
489  if (!ret)
490  ret = s5k6aa_write(c, REG_SF_RGAIN_CHG, 1);
491  if (ret)
492  return ret;
493 
494  ret = s5k6aa_write(c, REG_SF_GGAIN, ctrls->gain_green->val);
495  if (!ret)
496  ret = s5k6aa_write(c, REG_SF_GGAIN_CHG, 1);
497  if (ret)
498  return ret;
499 
500  ret = s5k6aa_write(c, REG_SF_BGAIN, ctrls->gain_blue->val);
501  if (!ret)
502  ret = s5k6aa_write(c, REG_SF_BGAIN_CHG, 1);
503  }
504  if (!ret) {
505  reg = awb ? reg | AALG_WB_EN_MASK : reg & ~AALG_WB_EN_MASK;
506  ret = s5k6aa_write(c, REG_DBG_AUTOALG_EN, reg);
507  }
508 
509  return ret;
510 }
511 
512 /* Program FW with exposure time, 'exposure' in us units */
513 static int s5k6aa_set_user_exposure(struct i2c_client *client, int exposure)
514 {
515  unsigned int time = exposure / 10;
516 
517  int ret = s5k6aa_write(client, REG_SF_USR_EXPOSURE_L, time & 0xffff);
518  if (!ret)
519  ret = s5k6aa_write(client, REG_SF_USR_EXPOSURE_H, time >> 16);
520  if (ret)
521  return ret;
522  return s5k6aa_write(client, REG_SF_USR_EXPOSURE_CHG, 1);
523 }
524 
525 static int s5k6aa_set_user_gain(struct i2c_client *client, int gain)
526 {
527  int ret = s5k6aa_write(client, REG_SF_USR_TOT_GAIN, gain);
528  if (ret)
529  return ret;
530  return s5k6aa_write(client, REG_SF_USR_TOT_GAIN_CHG, 1);
531 }
532 
533 /* Set auto/manual exposure and total gain */
534 static int s5k6aa_set_auto_exposure(struct s5k6aa *s5k6aa, int value)
535 {
536  struct i2c_client *c = v4l2_get_subdevdata(&s5k6aa->sd);
537  unsigned int exp_time = s5k6aa->ctrls.exposure->val;
538  u16 auto_alg;
539 
540  int ret = s5k6aa_read(c, REG_DBG_AUTOALG_EN, &auto_alg);
541  if (ret)
542  return ret;
543 
544  v4l2_dbg(1, debug, c, "man_exp: %d, auto_exp: %d, a_alg: 0x%x\n",
545  exp_time, value, auto_alg);
546 
547  if (value == V4L2_EXPOSURE_AUTO) {
548  auto_alg |= AALG_AE_EN_MASK | AALG_DIVLEI_EN_MASK;
549  } else {
550  ret = s5k6aa_set_user_exposure(c, exp_time);
551  if (ret)
552  return ret;
553  ret = s5k6aa_set_user_gain(c, s5k6aa->ctrls.gain->val);
554  if (ret)
555  return ret;
556  auto_alg &= ~(AALG_AE_EN_MASK | AALG_DIVLEI_EN_MASK);
557  }
558 
559  return s5k6aa_write(c, REG_DBG_AUTOALG_EN, auto_alg);
560 }
561 
562 static int s5k6aa_set_anti_flicker(struct s5k6aa *s5k6aa, int value)
563 {
564  struct i2c_client *client = v4l2_get_subdevdata(&s5k6aa->sd);
565  u16 auto_alg;
566  int ret;
567 
568  ret = s5k6aa_read(client, REG_DBG_AUTOALG_EN, &auto_alg);
569  if (ret)
570  return ret;
571 
572  if (value == V4L2_CID_POWER_LINE_FREQUENCY_AUTO) {
573  auto_alg |= AALG_FLICKER_EN_MASK;
574  } else {
575  auto_alg &= ~AALG_FLICKER_EN_MASK;
576  /* The V4L2_CID_LINE_FREQUENCY control values match
577  * the register values */
578  ret = s5k6aa_write(client, REG_SF_FLICKER_QUANT, value);
579  if (ret)
580  return ret;
581  ret = s5k6aa_write(client, REG_SF_FLICKER_QUANT_CHG, 1);
582  if (ret)
583  return ret;
584  }
585 
586  return s5k6aa_write(client, REG_DBG_AUTOALG_EN, auto_alg);
587 }
588 
589 static int s5k6aa_set_colorfx(struct s5k6aa *s5k6aa, int val)
590 {
591  struct i2c_client *client = v4l2_get_subdevdata(&s5k6aa->sd);
592  static const struct v4l2_control colorfx[] = {
593  { V4L2_COLORFX_NONE, 0 },
594  { V4L2_COLORFX_BW, 1 },
595  { V4L2_COLORFX_NEGATIVE, 2 },
596  { V4L2_COLORFX_SEPIA, 3 },
597  { V4L2_COLORFX_SKY_BLUE, 4 },
598  { V4L2_COLORFX_SKETCH, 5 },
599  };
600  int i;
601 
602  for (i = 0; i < ARRAY_SIZE(colorfx); i++) {
603  if (colorfx[i].id == val)
604  return s5k6aa_write(client, REG_G_SPEC_EFFECTS,
605  colorfx[i].value);
606  }
607  return -EINVAL;
608 }
609 
610 static int s5k6aa_preview_config_status(struct i2c_client *client)
611 {
612  u16 error = 0;
613  int ret = s5k6aa_read(client, REG_G_PREV_CFG_ERROR, &error);
614 
615  v4l2_dbg(1, debug, client, "error: 0x%x (%d)\n", error, ret);
616  return ret ? ret : (error ? -EINVAL : 0);
617 }
618 
619 static int s5k6aa_get_pixfmt_index(struct s5k6aa *s5k6aa,
620  struct v4l2_mbus_framefmt *mf)
621 {
622  unsigned int i;
623 
624  for (i = 0; i < ARRAY_SIZE(s5k6aa_formats); i++)
625  if (mf->colorspace == s5k6aa_formats[i].colorspace &&
626  mf->code == s5k6aa_formats[i].code)
627  return i;
628  return 0;
629 }
630 
631 static int s5k6aa_set_output_framefmt(struct s5k6aa *s5k6aa,
632  struct s5k6aa_preset *preset)
633 {
634  struct i2c_client *client = v4l2_get_subdevdata(&s5k6aa->sd);
635  int fmt_index = s5k6aa_get_pixfmt_index(s5k6aa, &preset->mbus_fmt);
636  int ret;
637 
638  ret = s5k6aa_write(client, REG_P_OUT_WIDTH(preset->index),
639  preset->mbus_fmt.width);
640  if (!ret)
641  ret = s5k6aa_write(client, REG_P_OUT_HEIGHT(preset->index),
642  preset->mbus_fmt.height);
643  if (!ret)
644  ret = s5k6aa_write(client, REG_P_FMT(preset->index),
645  s5k6aa_formats[fmt_index].reg_p_fmt);
646  return ret;
647 }
648 
649 static int s5k6aa_set_input_params(struct s5k6aa *s5k6aa)
650 {
651  struct i2c_client *c = v4l2_get_subdevdata(&s5k6aa->sd);
652  struct v4l2_rect *r = &s5k6aa->ccd_rect;
653  int ret;
654 
655  ret = s5k6aa_write(c, REG_G_PREVZOOM_IN_WIDTH, r->width);
656  if (!ret)
657  ret = s5k6aa_write(c, REG_G_PREVZOOM_IN_HEIGHT, r->height);
658  if (!ret)
659  ret = s5k6aa_write(c, REG_G_PREVZOOM_IN_XOFFS, r->left);
660  if (!ret)
661  ret = s5k6aa_write(c, REG_G_PREVZOOM_IN_YOFFS, r->top);
662  if (!ret)
663  ret = s5k6aa_write(c, REG_G_INPUTS_CHANGE_REQ, 1);
664  if (!ret)
665  s5k6aa->apply_crop = 0;
666 
667  return ret;
668 }
669 
677 static int s5k6aa_configure_video_bus(struct s5k6aa *s5k6aa,
678  enum v4l2_mbus_type bus_type, int nlanes)
679 {
680  struct i2c_client *client = v4l2_get_subdevdata(&s5k6aa->sd);
681  u16 cfg = 0;
682  int ret;
683 
684  /*
685  * TODO: The sensor is supposed to support BT.601 and BT.656
686  * but there is nothing indicating how to switch between both
687  * in the datasheet. For now default BT.601 interface is assumed.
688  */
689  if (bus_type == V4L2_MBUS_CSI2)
690  cfg = nlanes;
691  else if (bus_type != V4L2_MBUS_PARALLEL)
692  return -EINVAL;
693 
694  ret = s5k6aa_write(client, REG_OIF_EN_MIPI_LANES, cfg);
695  if (ret)
696  return ret;
697  return s5k6aa_write(client, REG_OIF_CFG_CHG, 1);
698 }
699 
700 /* This function should be called when switching to new user configuration set*/
701 static int s5k6aa_new_config_sync(struct i2c_client *client, int timeout,
702  int cid)
703 {
704  unsigned long end = jiffies + msecs_to_jiffies(timeout);
705  u16 reg = 1;
706  int ret;
707 
708  ret = s5k6aa_write(client, REG_G_ACTIVE_PREV_CFG, cid);
709  if (!ret)
710  ret = s5k6aa_write(client, REG_G_PREV_CFG_CHG, 1);
711  if (!ret)
712  ret = s5k6aa_write(client, REG_G_NEW_CFG_SYNC, 1);
713  if (timeout == 0)
714  return ret;
715 
716  while (ret >= 0 && time_is_after_jiffies(end)) {
717  ret = s5k6aa_read(client, REG_G_NEW_CFG_SYNC, &reg);
718  if (!reg)
719  return 0;
720  usleep_range(1000, 5000);
721  }
722  return ret ? ret : -ETIMEDOUT;
723 }
724 
731 static int s5k6aa_set_prev_config(struct s5k6aa *s5k6aa,
732  struct s5k6aa_preset *preset)
733 {
734  struct i2c_client *client = v4l2_get_subdevdata(&s5k6aa->sd);
735  int idx = preset->index;
736  u16 frame_rate_q;
737  int ret;
738 
739  if (s5k6aa->fiv->reg_fr_time >= S5K6AA_MAX_HIGHRES_FR_TIME)
740  frame_rate_q = FR_RATE_Q_BEST_FRRATE;
741  else
742  frame_rate_q = FR_RATE_Q_BEST_QUALITY;
743 
744  ret = s5k6aa_set_output_framefmt(s5k6aa, preset);
745  if (!ret)
746  ret = s5k6aa_write(client, REG_P_MAX_OUT_RATE(idx),
747  s5k6aa->pclk_fmax);
748  if (!ret)
749  ret = s5k6aa_write(client, REG_P_MIN_OUT_RATE(idx),
750  s5k6aa->pclk_fmin);
751  if (!ret)
752  ret = s5k6aa_write(client, REG_P_CLK_INDEX(idx),
753  preset->clk_id);
754  if (!ret)
755  ret = s5k6aa_write(client, REG_P_FR_RATE_TYPE(idx),
757  if (!ret)
758  ret = s5k6aa_write(client, REG_P_FR_RATE_Q_TYPE(idx),
759  frame_rate_q);
760  if (!ret)
761  ret = s5k6aa_write(client, REG_P_MAX_FR_TIME(idx),
762  s5k6aa->fiv->reg_fr_time + 33);
763  if (!ret)
764  ret = s5k6aa_write(client, REG_P_MIN_FR_TIME(idx),
765  s5k6aa->fiv->reg_fr_time - 33);
766  if (!ret)
767  ret = s5k6aa_new_config_sync(client, 250, idx);
768  if (!ret)
769  ret = s5k6aa_preview_config_status(client);
770  if (!ret)
771  s5k6aa->apply_cfg = 0;
772 
773  v4l2_dbg(1, debug, client, "Frame interval: %d +/- 3.3ms. (%d)\n",
774  s5k6aa->fiv->reg_fr_time, ret);
775  return ret;
776 }
777 
786 static int s5k6aa_initialize_isp(struct v4l2_subdev *sd)
787 {
788  struct i2c_client *client = v4l2_get_subdevdata(sd);
789  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
790  int ret;
791 
792  s5k6aa->apply_crop = 1;
793  s5k6aa->apply_cfg = 1;
794  msleep(100);
795 
796  ret = s5k6aa_set_ahb_address(client);
797  if (ret)
798  return ret;
799  ret = s5k6aa_configure_video_bus(s5k6aa, s5k6aa->bus_type,
800  s5k6aa->mipi_lanes);
801  if (ret)
802  return ret;
803  ret = s5k6aa_write_array(sd, s5k6aa_analog_config);
804  if (ret)
805  return ret;
806  msleep(20);
807 
808  return s5k6aa_configure_pixel_clocks(s5k6aa);
809 }
810 
811 static int s5k6aa_gpio_set_value(struct s5k6aa *priv, int id, u32 val)
812 {
813  if (!gpio_is_valid(priv->gpio[id].gpio))
814  return 0;
815  gpio_set_value(priv->gpio[id].gpio, !!val);
816  return 1;
817 }
818 
819 static int s5k6aa_gpio_assert(struct s5k6aa *priv, int id)
820 {
821  return s5k6aa_gpio_set_value(priv, id, priv->gpio[id].level);
822 }
823 
824 static int s5k6aa_gpio_deassert(struct s5k6aa *priv, int id)
825 {
826  return s5k6aa_gpio_set_value(priv, id, !priv->gpio[id].level);
827 }
828 
829 static int __s5k6aa_power_on(struct s5k6aa *s5k6aa)
830 {
831  int ret;
832 
834  if (ret)
835  return ret;
836  if (s5k6aa_gpio_deassert(s5k6aa, STBY))
837  usleep_range(150, 200);
838 
839  if (s5k6aa->s_power)
840  ret = s5k6aa->s_power(1);
841  usleep_range(4000, 4000);
842 
843  if (s5k6aa_gpio_deassert(s5k6aa, RST))
844  msleep(20);
845 
846  return ret;
847 }
848 
849 static int __s5k6aa_power_off(struct s5k6aa *s5k6aa)
850 {
851  int ret;
852 
853  if (s5k6aa_gpio_assert(s5k6aa, RST))
854  usleep_range(100, 150);
855 
856  if (s5k6aa->s_power) {
857  ret = s5k6aa->s_power(0);
858  if (ret)
859  return ret;
860  }
861  if (s5k6aa_gpio_assert(s5k6aa, STBY))
862  usleep_range(50, 100);
863  s5k6aa->streaming = 0;
864 
866 }
867 
868 /*
869  * V4L2 subdev core and video operations
870  */
871 static int s5k6aa_set_power(struct v4l2_subdev *sd, int on)
872 {
873  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
874  int ret = 0;
875 
876  mutex_lock(&s5k6aa->lock);
877 
878  if (!on == s5k6aa->power) {
879  if (on) {
880  ret = __s5k6aa_power_on(s5k6aa);
881  if (!ret)
882  ret = s5k6aa_initialize_isp(sd);
883  } else {
884  ret = __s5k6aa_power_off(s5k6aa);
885  }
886 
887  if (!ret)
888  s5k6aa->power += on ? 1 : -1;
889  }
890 
891  mutex_unlock(&s5k6aa->lock);
892 
893  if (!on || ret || s5k6aa->power != 1)
894  return ret;
895 
897 }
898 
899 static int __s5k6aa_stream(struct s5k6aa *s5k6aa, int enable)
900 {
901  struct i2c_client *client = v4l2_get_subdevdata(&s5k6aa->sd);
902  int ret = 0;
903 
904  ret = s5k6aa_write(client, REG_G_ENABLE_PREV, enable);
905  if (!ret)
906  ret = s5k6aa_write(client, REG_G_ENABLE_PREV_CHG, 1);
907  if (!ret)
908  s5k6aa->streaming = enable;
909 
910  return ret;
911 }
912 
913 static int s5k6aa_s_stream(struct v4l2_subdev *sd, int on)
914 {
915  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
916  int ret = 0;
917 
918  mutex_lock(&s5k6aa->lock);
919 
920  if (s5k6aa->streaming == !on) {
921  if (!ret && s5k6aa->apply_cfg)
922  ret = s5k6aa_set_prev_config(s5k6aa, s5k6aa->preset);
923  if (s5k6aa->apply_crop)
924  ret = s5k6aa_set_input_params(s5k6aa);
925  if (!ret)
926  ret = __s5k6aa_stream(s5k6aa, !!on);
927  }
928  mutex_unlock(&s5k6aa->lock);
929 
930  return ret;
931 }
932 
933 static int s5k6aa_g_frame_interval(struct v4l2_subdev *sd,
934  struct v4l2_subdev_frame_interval *fi)
935 {
936  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
937 
938  mutex_lock(&s5k6aa->lock);
939  fi->interval = s5k6aa->fiv->interval;
940  mutex_unlock(&s5k6aa->lock);
941 
942  return 0;
943 }
944 
945 static int __s5k6aa_set_frame_interval(struct s5k6aa *s5k6aa,
946  struct v4l2_subdev_frame_interval *fi)
947 {
948  struct v4l2_mbus_framefmt *mbus_fmt = &s5k6aa->preset->mbus_fmt;
949  const struct s5k6aa_interval *fiv = &s5k6aa_intervals[0];
950  unsigned int err, min_err = UINT_MAX;
951  unsigned int i, fr_time;
952 
953  if (fi->interval.denominator == 0)
954  return -EINVAL;
955 
956  fr_time = fi->interval.numerator * 10000 / fi->interval.denominator;
957 
958  for (i = 0; i < ARRAY_SIZE(s5k6aa_intervals); i++) {
959  const struct s5k6aa_interval *iv = &s5k6aa_intervals[i];
960 
961  if (mbus_fmt->width > iv->size.width ||
962  mbus_fmt->height > iv->size.height)
963  continue;
964 
965  err = abs(iv->reg_fr_time - fr_time);
966  if (err < min_err) {
967  fiv = iv;
968  min_err = err;
969  }
970  }
971  s5k6aa->fiv = fiv;
972 
973  v4l2_dbg(1, debug, &s5k6aa->sd, "Changed frame interval to %d us\n",
974  fiv->reg_fr_time * 100);
975  return 0;
976 }
977 
978 static int s5k6aa_s_frame_interval(struct v4l2_subdev *sd,
979  struct v4l2_subdev_frame_interval *fi)
980 {
981  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
982  int ret;
983 
984  v4l2_dbg(1, debug, sd, "Setting %d/%d frame interval\n",
985  fi->interval.numerator, fi->interval.denominator);
986 
987  mutex_lock(&s5k6aa->lock);
988  ret = __s5k6aa_set_frame_interval(s5k6aa, fi);
989  s5k6aa->apply_cfg = 1;
990 
991  mutex_unlock(&s5k6aa->lock);
992  return ret;
993 }
994 
995 /*
996  * V4L2 subdev pad level and video operations
997  */
998 static int s5k6aa_enum_frame_interval(struct v4l2_subdev *sd,
999  struct v4l2_subdev_fh *fh,
1000  struct v4l2_subdev_frame_interval_enum *fie)
1001 {
1002  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
1003  const struct s5k6aa_interval *fi;
1004  int ret = 0;
1005 
1006  if (fie->index > ARRAY_SIZE(s5k6aa_intervals))
1007  return -EINVAL;
1008 
1011  &fie->height, S5K6AA_WIN_HEIGHT_MIN,
1012  S5K6AA_WIN_HEIGHT_MAX, 1, 0);
1013 
1014  mutex_lock(&s5k6aa->lock);
1015  fi = &s5k6aa_intervals[fie->index];
1016  if (fie->width > fi->size.width || fie->height > fi->size.height)
1017  ret = -EINVAL;
1018  else
1019  fie->interval = fi->interval;
1020  mutex_unlock(&s5k6aa->lock);
1021 
1022  return ret;
1023 }
1024 
1025 static int s5k6aa_enum_mbus_code(struct v4l2_subdev *sd,
1026  struct v4l2_subdev_fh *fh,
1027  struct v4l2_subdev_mbus_code_enum *code)
1028 {
1029  if (code->index >= ARRAY_SIZE(s5k6aa_formats))
1030  return -EINVAL;
1031 
1032  code->code = s5k6aa_formats[code->index].code;
1033  return 0;
1034 }
1035 
1036 static int s5k6aa_enum_frame_size(struct v4l2_subdev *sd,
1037  struct v4l2_subdev_fh *fh,
1038  struct v4l2_subdev_frame_size_enum *fse)
1039 {
1040  int i = ARRAY_SIZE(s5k6aa_formats);
1041 
1042  if (fse->index > 0)
1043  return -EINVAL;
1044 
1045  while (--i)
1046  if (fse->code == s5k6aa_formats[i].code)
1047  break;
1048 
1049  fse->code = s5k6aa_formats[i].code;
1050  fse->min_width = S5K6AA_WIN_WIDTH_MIN;
1051  fse->max_width = S5K6AA_WIN_WIDTH_MAX;
1052  fse->max_height = S5K6AA_WIN_HEIGHT_MIN;
1053  fse->min_height = S5K6AA_WIN_HEIGHT_MAX;
1054 
1055  return 0;
1056 }
1057 
1058 static struct v4l2_rect *
1059 __s5k6aa_get_crop_rect(struct s5k6aa *s5k6aa, struct v4l2_subdev_fh *fh,
1060  enum v4l2_subdev_format_whence which)
1061 {
1062  if (which == V4L2_SUBDEV_FORMAT_ACTIVE)
1063  return &s5k6aa->ccd_rect;
1064 
1065  WARN_ON(which != V4L2_SUBDEV_FORMAT_TRY);
1066  return v4l2_subdev_get_try_crop(fh, 0);
1067 }
1068 
1069 static void s5k6aa_try_format(struct s5k6aa *s5k6aa,
1070  struct v4l2_mbus_framefmt *mf)
1071 {
1072  unsigned int index;
1073 
1076  &mf->height, S5K6AA_WIN_HEIGHT_MIN,
1077  S5K6AA_WIN_HEIGHT_MAX, 1, 0);
1078 
1079  if (mf->colorspace != V4L2_COLORSPACE_JPEG &&
1080  mf->colorspace != V4L2_COLORSPACE_REC709)
1081  mf->colorspace = V4L2_COLORSPACE_JPEG;
1082 
1083  index = s5k6aa_get_pixfmt_index(s5k6aa, mf);
1084 
1085  mf->colorspace = s5k6aa_formats[index].colorspace;
1086  mf->code = s5k6aa_formats[index].code;
1087  mf->field = V4L2_FIELD_NONE;
1088 }
1089 
1090 static int s5k6aa_get_fmt(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh,
1091  struct v4l2_subdev_format *fmt)
1092 {
1093  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
1094  struct v4l2_mbus_framefmt *mf;
1095 
1096  memset(fmt->reserved, 0, sizeof(fmt->reserved));
1097 
1098  if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
1099  mf = v4l2_subdev_get_try_format(fh, 0);
1100  fmt->format = *mf;
1101  return 0;
1102  }
1103 
1104  mutex_lock(&s5k6aa->lock);
1105  fmt->format = s5k6aa->preset->mbus_fmt;
1106  mutex_unlock(&s5k6aa->lock);
1107 
1108  return 0;
1109 }
1110 
1111 static int s5k6aa_set_fmt(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh,
1112  struct v4l2_subdev_format *fmt)
1113 {
1114  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
1115  struct s5k6aa_preset *preset = s5k6aa->preset;
1116  struct v4l2_mbus_framefmt *mf;
1117  struct v4l2_rect *crop;
1118  int ret = 0;
1119 
1120  mutex_lock(&s5k6aa->lock);
1121  s5k6aa_try_format(s5k6aa, &fmt->format);
1122 
1123  if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
1124  mf = v4l2_subdev_get_try_format(fh, fmt->pad);
1125  crop = v4l2_subdev_get_try_crop(fh, 0);
1126  } else {
1127  if (s5k6aa->streaming) {
1128  ret = -EBUSY;
1129  } else {
1130  mf = &preset->mbus_fmt;
1131  crop = &s5k6aa->ccd_rect;
1132  s5k6aa->apply_cfg = 1;
1133  }
1134  }
1135 
1136  if (ret == 0) {
1137  struct v4l2_subdev_frame_interval fiv = {
1138  .interval = {0, 1}
1139  };
1140 
1141  *mf = fmt->format;
1142  /*
1143  * Make sure the crop window is valid, i.e. its size is
1144  * greater than the output window, as the ISP supports
1145  * only down-scaling.
1146  */
1147  crop->width = clamp_t(unsigned int, crop->width, mf->width,
1149  crop->height = clamp_t(unsigned int, crop->height, mf->height,
1151  crop->left = clamp_t(unsigned int, crop->left, 0,
1152  S5K6AA_WIN_WIDTH_MAX - crop->width);
1153  crop->top = clamp_t(unsigned int, crop->top, 0,
1154  S5K6AA_WIN_HEIGHT_MAX - crop->height);
1155 
1156  /* Reset to minimum possible frame interval */
1157  ret = __s5k6aa_set_frame_interval(s5k6aa, &fiv);
1158  }
1159  mutex_unlock(&s5k6aa->lock);
1160 
1161  return ret;
1162 }
1163 
1164 static int s5k6aa_get_crop(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh,
1165  struct v4l2_subdev_crop *crop)
1166 {
1167  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
1168  struct v4l2_rect *rect;
1169 
1170  memset(crop->reserved, 0, sizeof(crop->reserved));
1171 
1172  mutex_lock(&s5k6aa->lock);
1173  rect = __s5k6aa_get_crop_rect(s5k6aa, fh, crop->which);
1174  crop->rect = *rect;
1175  mutex_unlock(&s5k6aa->lock);
1176 
1177  v4l2_dbg(1, debug, sd, "Current crop rectangle: (%d,%d)/%dx%d\n",
1178  rect->left, rect->top, rect->width, rect->height);
1179 
1180  return 0;
1181 }
1182 
1183 static int s5k6aa_set_crop(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh,
1184  struct v4l2_subdev_crop *crop)
1185 {
1186  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
1187  struct v4l2_mbus_framefmt *mf;
1188  unsigned int max_x, max_y;
1189  struct v4l2_rect *crop_r;
1190 
1191  mutex_lock(&s5k6aa->lock);
1192  crop_r = __s5k6aa_get_crop_rect(s5k6aa, fh, crop->which);
1193 
1194  if (crop->which == V4L2_SUBDEV_FORMAT_ACTIVE) {
1195  mf = &s5k6aa->preset->mbus_fmt;
1196  s5k6aa->apply_crop = 1;
1197  } else {
1198  mf = v4l2_subdev_get_try_format(fh, 0);
1199  }
1200  v4l_bound_align_image(&crop->rect.width, mf->width,
1202  &crop->rect.height, mf->height,
1203  S5K6AA_WIN_HEIGHT_MAX, 1, 0);
1204 
1205  max_x = (S5K6AA_WIN_WIDTH_MAX - crop->rect.width) & ~1;
1206  max_y = (S5K6AA_WIN_HEIGHT_MAX - crop->rect.height) & ~1;
1207 
1208  crop->rect.left = clamp_t(unsigned int, crop->rect.left, 0, max_x);
1209  crop->rect.top = clamp_t(unsigned int, crop->rect.top, 0, max_y);
1210 
1211  *crop_r = crop->rect;
1212 
1213  mutex_unlock(&s5k6aa->lock);
1214 
1215  v4l2_dbg(1, debug, sd, "Set crop rectangle: (%d,%d)/%dx%d\n",
1216  crop_r->left, crop_r->top, crop_r->width, crop_r->height);
1217 
1218  return 0;
1219 }
1220 
1221 static const struct v4l2_subdev_pad_ops s5k6aa_pad_ops = {
1222  .enum_mbus_code = s5k6aa_enum_mbus_code,
1223  .enum_frame_size = s5k6aa_enum_frame_size,
1224  .enum_frame_interval = s5k6aa_enum_frame_interval,
1225  .get_fmt = s5k6aa_get_fmt,
1226  .set_fmt = s5k6aa_set_fmt,
1227  .get_crop = s5k6aa_get_crop,
1228  .set_crop = s5k6aa_set_crop,
1229 };
1230 
1231 static const struct v4l2_subdev_video_ops s5k6aa_video_ops = {
1232  .g_frame_interval = s5k6aa_g_frame_interval,
1233  .s_frame_interval = s5k6aa_s_frame_interval,
1234  .s_stream = s5k6aa_s_stream,
1235 };
1236 
1237 /*
1238  * V4L2 subdev controls
1239  */
1240 
1241 static int s5k6aa_s_ctrl(struct v4l2_ctrl *ctrl)
1242 {
1243  struct v4l2_subdev *sd = ctrl_to_sd(ctrl);
1244  struct i2c_client *client = v4l2_get_subdevdata(sd);
1245  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
1246  int idx, err = 0;
1247 
1248  v4l2_dbg(1, debug, sd, "ctrl: 0x%x, value: %d\n", ctrl->id, ctrl->val);
1249 
1250  mutex_lock(&s5k6aa->lock);
1251  /*
1252  * If the device is not powered up by the host driver do
1253  * not apply any controls to H/W at this time. Instead
1254  * the controls will be restored right after power-up.
1255  */
1256  if (s5k6aa->power == 0)
1257  goto unlock;
1258  idx = s5k6aa->preset->index;
1259 
1260  switch (ctrl->id) {
1262  err = s5k6aa_set_awb(s5k6aa, ctrl->val);
1263  break;
1264 
1265  case V4L2_CID_BRIGHTNESS:
1266  err = s5k6aa_write(client, REG_USER_BRIGHTNESS, ctrl->val);
1267  break;
1268 
1269  case V4L2_CID_COLORFX:
1270  err = s5k6aa_set_colorfx(s5k6aa, ctrl->val);
1271  break;
1272 
1273  case V4L2_CID_CONTRAST:
1274  err = s5k6aa_write(client, REG_USER_CONTRAST, ctrl->val);
1275  break;
1276 
1278  err = s5k6aa_set_auto_exposure(s5k6aa, ctrl->val);
1279  break;
1280 
1281  case V4L2_CID_HFLIP:
1282  err = s5k6aa_set_mirror(s5k6aa, ctrl->val);
1283  if (err)
1284  break;
1285  err = s5k6aa_write(client, REG_G_PREV_CFG_CHG, 1);
1286  break;
1287 
1289  err = s5k6aa_set_anti_flicker(s5k6aa, ctrl->val);
1290  break;
1291 
1292  case V4L2_CID_SATURATION:
1293  err = s5k6aa_write(client, REG_USER_SATURATION, ctrl->val);
1294  break;
1295 
1296  case V4L2_CID_SHARPNESS:
1297  err = s5k6aa_write(client, REG_USER_SHARPBLUR, ctrl->val);
1298  break;
1299 
1301  err = s5k6aa_write(client, REG_P_COLORTEMP(idx), ctrl->val);
1302  if (err)
1303  break;
1304  err = s5k6aa_write(client, REG_G_PREV_CFG_CHG, 1);
1305  break;
1306  }
1307 unlock:
1308  mutex_unlock(&s5k6aa->lock);
1309  return err;
1310 }
1311 
1312 static const struct v4l2_ctrl_ops s5k6aa_ctrl_ops = {
1313  .s_ctrl = s5k6aa_s_ctrl,
1314 };
1315 
1316 static int s5k6aa_log_status(struct v4l2_subdev *sd)
1317 {
1319  return 0;
1320 }
1321 
1322 #define V4L2_CID_RED_GAIN (V4L2_CTRL_CLASS_CAMERA | 0x1001)
1323 #define V4L2_CID_GREEN_GAIN (V4L2_CTRL_CLASS_CAMERA | 0x1002)
1324 #define V4L2_CID_BLUE_GAIN (V4L2_CTRL_CLASS_CAMERA | 0x1003)
1325 
1326 static const struct v4l2_ctrl_config s5k6aa_ctrls[] = {
1327  {
1328  .ops = &s5k6aa_ctrl_ops,
1329  .id = V4L2_CID_RED_GAIN,
1330  .type = V4L2_CTRL_TYPE_INTEGER,
1331  .name = "Gain, Red",
1332  .min = 0,
1333  .max = 256,
1334  .def = 127,
1335  .step = 1,
1336  }, {
1337  .ops = &s5k6aa_ctrl_ops,
1338  .id = V4L2_CID_GREEN_GAIN,
1339  .type = V4L2_CTRL_TYPE_INTEGER,
1340  .name = "Gain, Green",
1341  .min = 0,
1342  .max = 256,
1343  .def = 127,
1344  .step = 1,
1345  }, {
1346  .ops = &s5k6aa_ctrl_ops,
1347  .id = V4L2_CID_BLUE_GAIN,
1348  .type = V4L2_CTRL_TYPE_INTEGER,
1349  .name = "Gain, Blue",
1350  .min = 0,
1351  .max = 256,
1352  .def = 127,
1353  .step = 1,
1354  },
1355 };
1356 
1357 static int s5k6aa_initialize_ctrls(struct s5k6aa *s5k6aa)
1358 {
1359  const struct v4l2_ctrl_ops *ops = &s5k6aa_ctrl_ops;
1360  struct s5k6aa_ctrls *ctrls = &s5k6aa->ctrls;
1361  struct v4l2_ctrl_handler *hdl = &ctrls->handler;
1362 
1363  int ret = v4l2_ctrl_handler_init(hdl, 16);
1364  if (ret)
1365  return ret;
1366  /* Auto white balance cluster */
1368  0, 1, 1, 1);
1369  ctrls->gain_red = v4l2_ctrl_new_custom(hdl, &s5k6aa_ctrls[0], NULL);
1370  ctrls->gain_green = v4l2_ctrl_new_custom(hdl, &s5k6aa_ctrls[1], NULL);
1371  ctrls->gain_blue = v4l2_ctrl_new_custom(hdl, &s5k6aa_ctrls[2], NULL);
1372  v4l2_ctrl_auto_cluster(4, &ctrls->awb, 0, false);
1373 
1374  ctrls->hflip = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_HFLIP, 0, 1, 1, 0);
1375  ctrls->vflip = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_VFLIP, 0, 1, 1, 0);
1376  v4l2_ctrl_cluster(2, &ctrls->hflip);
1377 
1378  ctrls->auto_exp = v4l2_ctrl_new_std_menu(hdl, ops,
1381  /* Exposure time: x 1 us */
1382  ctrls->exposure = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_EXPOSURE,
1383  0, 6000000U, 1, 100000U);
1384  /* Total gain: 256 <=> 1x */
1385  ctrls->gain = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_GAIN,
1386  0, 256, 1, 256);
1387  v4l2_ctrl_auto_cluster(3, &ctrls->auto_exp, 0, false);
1388 
1392 
1395 
1397  0, 256, 1, 0);
1398 
1399  v4l2_ctrl_new_std(hdl, ops, V4L2_CID_SATURATION, -127, 127, 1, 0);
1400  v4l2_ctrl_new_std(hdl, ops, V4L2_CID_BRIGHTNESS, -127, 127, 1, 0);
1401  v4l2_ctrl_new_std(hdl, ops, V4L2_CID_CONTRAST, -127, 127, 1, 0);
1402  v4l2_ctrl_new_std(hdl, ops, V4L2_CID_SHARPNESS, -127, 127, 1, 0);
1403 
1404  if (hdl->error) {
1405  ret = hdl->error;
1407  return ret;
1408  }
1409 
1410  s5k6aa->sd.ctrl_handler = hdl;
1411  return 0;
1412 }
1413 
1414 /*
1415  * V4L2 subdev internal operations
1416  */
1417 static int s5k6aa_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
1418 {
1419  struct v4l2_mbus_framefmt *format = v4l2_subdev_get_try_format(fh, 0);
1420  struct v4l2_rect *crop = v4l2_subdev_get_try_crop(fh, 0);
1421 
1422  format->colorspace = s5k6aa_formats[0].colorspace;
1423  format->code = s5k6aa_formats[0].code;
1424  format->width = S5K6AA_OUT_WIDTH_DEF;
1425  format->height = S5K6AA_OUT_HEIGHT_DEF;
1426  format->field = V4L2_FIELD_NONE;
1427 
1428  crop->width = S5K6AA_WIN_WIDTH_MAX;
1429  crop->height = S5K6AA_WIN_HEIGHT_MAX;
1430  crop->left = 0;
1431  crop->top = 0;
1432 
1433  return 0;
1434 }
1435 
1436 static int s5k6aa_check_fw_revision(struct s5k6aa *s5k6aa)
1437 {
1438  struct i2c_client *client = v4l2_get_subdevdata(&s5k6aa->sd);
1439  u16 api_ver = 0, fw_rev = 0;
1440 
1441  int ret = s5k6aa_set_ahb_address(client);
1442 
1443  if (!ret)
1444  ret = s5k6aa_read(client, REG_FW_APIVER, &api_ver);
1445  if (!ret)
1446  ret = s5k6aa_read(client, REG_FW_REVISION, &fw_rev);
1447  if (ret) {
1448  v4l2_err(&s5k6aa->sd, "FW revision check failed!\n");
1449  return ret;
1450  }
1451 
1452  v4l2_info(&s5k6aa->sd, "FW API ver.: 0x%X, FW rev.: 0x%X\n",
1453  api_ver, fw_rev);
1454 
1455  return api_ver == S5K6AAFX_FW_APIVER ? 0 : -ENODEV;
1456 }
1457 
1458 static int s5k6aa_registered(struct v4l2_subdev *sd)
1459 {
1460  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
1461  int ret;
1462 
1463  mutex_lock(&s5k6aa->lock);
1464  ret = __s5k6aa_power_on(s5k6aa);
1465  if (!ret) {
1466  msleep(100);
1467  ret = s5k6aa_check_fw_revision(s5k6aa);
1468  __s5k6aa_power_off(s5k6aa);
1469  }
1470  mutex_unlock(&s5k6aa->lock);
1471 
1472  return ret;
1473 }
1474 
1475 static const struct v4l2_subdev_internal_ops s5k6aa_subdev_internal_ops = {
1476  .registered = s5k6aa_registered,
1477  .open = s5k6aa_open,
1478 };
1479 
1480 static const struct v4l2_subdev_core_ops s5k6aa_core_ops = {
1481  .s_power = s5k6aa_set_power,
1482  .log_status = s5k6aa_log_status,
1483 };
1484 
1485 static const struct v4l2_subdev_ops s5k6aa_subdev_ops = {
1486  .core = &s5k6aa_core_ops,
1487  .pad = &s5k6aa_pad_ops,
1488  .video = &s5k6aa_video_ops,
1489 };
1490 
1491 /*
1492  * GPIO setup
1493  */
1494 static int s5k6aa_configure_gpio(int nr, int val, const char *name)
1495 {
1496  unsigned long flags = val ? GPIOF_OUT_INIT_HIGH : GPIOF_OUT_INIT_LOW;
1497  int ret;
1498 
1499  if (!gpio_is_valid(nr))
1500  return 0;
1501  ret = gpio_request_one(nr, flags, name);
1502  if (!ret)
1503  gpio_export(nr, 0);
1504  return ret;
1505 }
1506 
1507 static void s5k6aa_free_gpios(struct s5k6aa *s5k6aa)
1508 {
1509  int i;
1510 
1511  for (i = 0; i < ARRAY_SIZE(s5k6aa->gpio); i++) {
1512  if (!gpio_is_valid(s5k6aa->gpio[i].gpio))
1513  continue;
1514  gpio_free(s5k6aa->gpio[i].gpio);
1515  s5k6aa->gpio[i].gpio = -EINVAL;
1516  }
1517 }
1518 
1519 static int s5k6aa_configure_gpios(struct s5k6aa *s5k6aa,
1520  const struct s5k6aa_platform_data *pdata)
1521 {
1522  const struct s5k6aa_gpio *gpio = &pdata->gpio_stby;
1523  int ret;
1524 
1525  s5k6aa->gpio[STBY].gpio = -EINVAL;
1526  s5k6aa->gpio[RST].gpio = -EINVAL;
1527 
1528  ret = s5k6aa_configure_gpio(gpio->gpio, gpio->level, "S5K6AA_STBY");
1529  if (ret) {
1530  s5k6aa_free_gpios(s5k6aa);
1531  return ret;
1532  }
1533  s5k6aa->gpio[STBY] = *gpio;
1534  if (gpio_is_valid(gpio->gpio))
1535  gpio_set_value(gpio->gpio, 0);
1536 
1537  gpio = &pdata->gpio_reset;
1538  ret = s5k6aa_configure_gpio(gpio->gpio, gpio->level, "S5K6AA_RST");
1539  if (ret) {
1540  s5k6aa_free_gpios(s5k6aa);
1541  return ret;
1542  }
1543  s5k6aa->gpio[RST] = *gpio;
1544  if (gpio_is_valid(gpio->gpio))
1545  gpio_set_value(gpio->gpio, 0);
1546 
1547  return 0;
1548 }
1549 
1550 static int s5k6aa_probe(struct i2c_client *client,
1551  const struct i2c_device_id *id)
1552 {
1553  const struct s5k6aa_platform_data *pdata = client->dev.platform_data;
1554  struct v4l2_subdev *sd;
1555  struct s5k6aa *s5k6aa;
1556  int i, ret;
1557 
1558  if (pdata == NULL) {
1559  dev_err(&client->dev, "Platform data not specified\n");
1560  return -EINVAL;
1561  }
1562 
1563  if (pdata->mclk_frequency == 0) {
1564  dev_err(&client->dev, "MCLK frequency not specified\n");
1565  return -EINVAL;
1566  }
1567 
1568  s5k6aa = devm_kzalloc(&client->dev, sizeof(*s5k6aa), GFP_KERNEL);
1569  if (!s5k6aa)
1570  return -ENOMEM;
1571 
1572  mutex_init(&s5k6aa->lock);
1573 
1574  s5k6aa->mclk_frequency = pdata->mclk_frequency;
1575  s5k6aa->bus_type = pdata->bus_type;
1576  s5k6aa->mipi_lanes = pdata->nlanes;
1577  s5k6aa->s_power = pdata->set_power;
1578  s5k6aa->inv_hflip = pdata->horiz_flip;
1579  s5k6aa->inv_vflip = pdata->vert_flip;
1580 
1581  sd = &s5k6aa->sd;
1582  v4l2_i2c_subdev_init(sd, client, &s5k6aa_subdev_ops);
1583  strlcpy(sd->name, DRIVER_NAME, sizeof(sd->name));
1584 
1585  sd->internal_ops = &s5k6aa_subdev_internal_ops;
1587 
1588  s5k6aa->pad.flags = MEDIA_PAD_FL_SOURCE;
1589  sd->entity.type = MEDIA_ENT_T_V4L2_SUBDEV_SENSOR;
1590  ret = media_entity_init(&sd->entity, 1, &s5k6aa->pad, 0);
1591  if (ret)
1592  return ret;
1593 
1594  ret = s5k6aa_configure_gpios(s5k6aa, pdata);
1595  if (ret)
1596  goto out_err2;
1597 
1598  for (i = 0; i < S5K6AA_NUM_SUPPLIES; i++)
1599  s5k6aa->supplies[i].supply = s5k6aa_supply_names[i];
1600 
1601  ret = regulator_bulk_get(&client->dev, S5K6AA_NUM_SUPPLIES,
1602  s5k6aa->supplies);
1603  if (ret) {
1604  dev_err(&client->dev, "Failed to get regulators\n");
1605  goto out_err3;
1606  }
1607 
1608  ret = s5k6aa_initialize_ctrls(s5k6aa);
1609  if (ret)
1610  goto out_err4;
1611 
1612  s5k6aa_presets_data_init(s5k6aa);
1613 
1614  s5k6aa->ccd_rect.width = S5K6AA_WIN_WIDTH_MAX;
1615  s5k6aa->ccd_rect.height = S5K6AA_WIN_HEIGHT_MAX;
1616  s5k6aa->ccd_rect.left = 0;
1617  s5k6aa->ccd_rect.top = 0;
1618 
1619  return 0;
1620 
1621 out_err4:
1622  regulator_bulk_free(S5K6AA_NUM_SUPPLIES, s5k6aa->supplies);
1623 out_err3:
1624  s5k6aa_free_gpios(s5k6aa);
1625 out_err2:
1626  media_entity_cleanup(&s5k6aa->sd.entity);
1627  return ret;
1628 }
1629 
1630 static int s5k6aa_remove(struct i2c_client *client)
1631 {
1632  struct v4l2_subdev *sd = i2c_get_clientdata(client);
1633  struct s5k6aa *s5k6aa = to_s5k6aa(sd);
1634 
1637  media_entity_cleanup(&sd->entity);
1638  regulator_bulk_free(S5K6AA_NUM_SUPPLIES, s5k6aa->supplies);
1639  s5k6aa_free_gpios(s5k6aa);
1640 
1641  return 0;
1642 }
1643 
1644 static const struct i2c_device_id s5k6aa_id[] = {
1645  { DRIVER_NAME, 0 },
1646  { },
1647 };
1648 MODULE_DEVICE_TABLE(i2c, s5k6aa_id);
1649 
1650 
1651 static struct i2c_driver s5k6aa_i2c_driver = {
1652  .driver = {
1653  .name = DRIVER_NAME
1654  },
1655  .probe = s5k6aa_probe,
1656  .remove = s5k6aa_remove,
1657  .id_table = s5k6aa_id,
1658 };
1659 
1660 module_i2c_driver(s5k6aa_i2c_driver);
1661 
1662 MODULE_DESCRIPTION("Samsung S5K6AA(FX) SXGA camera driver");
1663 MODULE_AUTHOR("Sylwester Nawrocki <[email protected]>");
1664 MODULE_LICENSE("GPL");