2 * Driver for M-5MOLS 8M Pixel camera sensor with ISP
4 * Copyright (C) 2011 Samsung Electronics Co., Ltd.
5 * Author: HeungJun Kim <riverful.kim@samsung.com>
7 * Copyright (C) 2009 Samsung Electronics Co., Ltd.
8 * Author: Dongsoo Nathaniel Kim <dongsoo45.kim@samsung.com>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
16 #include <linux/i2c.h>
17 #include <linux/slab.h>
18 #include <linux/irq.h>
19 #include <linux/interrupt.h>
20 #include <linux/delay.h>
21 #include <linux/gpio.h>
22 #include <linux/regulator/consumer.h>
23 #include <linux/videodev2.h>
24 #include <linux/module.h>
25 #include <media/v4l2-ctrls.h>
26 #include <media/v4l2-device.h>
27 #include <media/v4l2-subdev.h>
28 #include <media/i2c/m5mols.h>
31 #include "m5mols_reg.h"
34 module_param(m5mols_debug, int, 0644);
36 #define MODULE_NAME "M5MOLS"
37 #define M5MOLS_I2C_CHECK_RETRY 500
39 /* The regulator consumer names for external voltage regulators */
40 static struct regulator_bulk_data supplies[] = {
42 .supply = "core", /* ARM core power, 1.2V */
44 .supply = "dig_18", /* digital power 1, 1.8V */
46 .supply = "d_sensor", /* sensor power 1, 1.8V */
48 .supply = "dig_28", /* digital power 2, 2.8V */
50 .supply = "a_sensor", /* analog power */
52 .supply = "dig_12", /* digital power 3, 1.2V */
56 static struct v4l2_mbus_framefmt m5mols_default_ffmt[M5MOLS_RESTYPE_MAX] = {
57 [M5MOLS_RESTYPE_MONITOR] = {
60 .code = MEDIA_BUS_FMT_VYUY8_2X8,
61 .field = V4L2_FIELD_NONE,
62 .colorspace = V4L2_COLORSPACE_JPEG,
64 [M5MOLS_RESTYPE_CAPTURE] = {
67 .code = MEDIA_BUS_FMT_JPEG_1X8,
68 .field = V4L2_FIELD_NONE,
69 .colorspace = V4L2_COLORSPACE_JPEG,
72 #define SIZE_DEFAULT_FFMT ARRAY_SIZE(m5mols_default_ffmt)
74 static const struct m5mols_resolution m5mols_reg_res[] = {
75 { 0x01, M5MOLS_RESTYPE_MONITOR, 128, 96 }, /* SUB-QCIF */
76 { 0x03, M5MOLS_RESTYPE_MONITOR, 160, 120 }, /* QQVGA */
77 { 0x05, M5MOLS_RESTYPE_MONITOR, 176, 144 }, /* QCIF */
78 { 0x06, M5MOLS_RESTYPE_MONITOR, 176, 176 },
79 { 0x08, M5MOLS_RESTYPE_MONITOR, 240, 320 }, /* QVGA */
80 { 0x09, M5MOLS_RESTYPE_MONITOR, 320, 240 }, /* QVGA */
81 { 0x0c, M5MOLS_RESTYPE_MONITOR, 240, 400 }, /* WQVGA */
82 { 0x0d, M5MOLS_RESTYPE_MONITOR, 400, 240 }, /* WQVGA */
83 { 0x0e, M5MOLS_RESTYPE_MONITOR, 352, 288 }, /* CIF */
84 { 0x13, M5MOLS_RESTYPE_MONITOR, 480, 360 },
85 { 0x15, M5MOLS_RESTYPE_MONITOR, 640, 360 }, /* qHD */
86 { 0x17, M5MOLS_RESTYPE_MONITOR, 640, 480 }, /* VGA */
87 { 0x18, M5MOLS_RESTYPE_MONITOR, 720, 480 },
88 { 0x1a, M5MOLS_RESTYPE_MONITOR, 800, 480 }, /* WVGA */
89 { 0x1f, M5MOLS_RESTYPE_MONITOR, 800, 600 }, /* SVGA */
90 { 0x21, M5MOLS_RESTYPE_MONITOR, 1280, 720 }, /* HD */
91 { 0x25, M5MOLS_RESTYPE_MONITOR, 1920, 1080 }, /* 1080p */
92 { 0x29, M5MOLS_RESTYPE_MONITOR, 3264, 2448 }, /* 2.63fps 8M */
93 { 0x39, M5MOLS_RESTYPE_MONITOR, 800, 602 }, /* AHS_MON debug */
95 { 0x02, M5MOLS_RESTYPE_CAPTURE, 320, 240 }, /* QVGA */
96 { 0x04, M5MOLS_RESTYPE_CAPTURE, 400, 240 }, /* WQVGA */
97 { 0x07, M5MOLS_RESTYPE_CAPTURE, 480, 360 },
98 { 0x08, M5MOLS_RESTYPE_CAPTURE, 640, 360 }, /* qHD */
99 { 0x09, M5MOLS_RESTYPE_CAPTURE, 640, 480 }, /* VGA */
100 { 0x0a, M5MOLS_RESTYPE_CAPTURE, 800, 480 }, /* WVGA */
101 { 0x10, M5MOLS_RESTYPE_CAPTURE, 1280, 720 }, /* HD */
102 { 0x14, M5MOLS_RESTYPE_CAPTURE, 1280, 960 }, /* 1M */
103 { 0x17, M5MOLS_RESTYPE_CAPTURE, 1600, 1200 }, /* 2M */
104 { 0x19, M5MOLS_RESTYPE_CAPTURE, 1920, 1080 }, /* Full-HD */
105 { 0x1a, M5MOLS_RESTYPE_CAPTURE, 2048, 1152 }, /* 3Mega */
106 { 0x1b, M5MOLS_RESTYPE_CAPTURE, 2048, 1536 },
107 { 0x1c, M5MOLS_RESTYPE_CAPTURE, 2560, 1440 }, /* 4Mega */
108 { 0x1d, M5MOLS_RESTYPE_CAPTURE, 2560, 1536 },
109 { 0x1f, M5MOLS_RESTYPE_CAPTURE, 2560, 1920 }, /* 5Mega */
110 { 0x21, M5MOLS_RESTYPE_CAPTURE, 3264, 1836 }, /* 6Mega */
111 { 0x22, M5MOLS_RESTYPE_CAPTURE, 3264, 1960 },
112 { 0x25, M5MOLS_RESTYPE_CAPTURE, 3264, 2448 }, /* 8Mega */
116 * m5mols_swap_byte - an byte array to integer conversion function
117 * @size: size in bytes of I2C packet defined in the M-5MOLS datasheet
119 * Convert I2C data byte array with performing any required byte
120 * reordering to assure proper values for each data type, regardless
121 * of the architecture endianness.
123 static u32 m5mols_swap_byte(u8 *data, u8 length)
127 else if (length == 2)
128 return be16_to_cpu(*((__be16 *)data));
130 return be32_to_cpu(*((__be32 *)data));
134 * m5mols_read - I2C read function
135 * @reg: combination of size, category and command for the I2C packet
136 * @size: desired size of I2C packet
139 * Returns 0 on success, or else negative errno.
141 static int m5mols_read(struct v4l2_subdev *sd, u32 size, u32 reg, u32 *val)
143 struct i2c_client *client = v4l2_get_subdevdata(sd);
144 struct m5mols_info *info = to_m5mols(sd);
145 u8 rbuf[M5MOLS_I2C_MAX_SIZE + 1];
146 u8 category = I2C_CATEGORY(reg);
147 u8 cmd = I2C_COMMAND(reg);
148 struct i2c_msg msg[2];
152 if (!client->adapter)
155 msg[0].addr = client->addr;
160 wbuf[1] = M5MOLS_BYTE_READ;
165 msg[1].addr = client->addr;
166 msg[1].flags = I2C_M_RD;
167 msg[1].len = size + 1;
170 /* minimum stabilization time */
171 usleep_range(200, 300);
173 ret = i2c_transfer(client->adapter, msg, 2);
176 *val = m5mols_swap_byte(&rbuf[1], size);
181 v4l2_err(sd, "read failed: size:%d cat:%02x cmd:%02x. %d\n",
182 size, category, cmd, ret);
184 return ret < 0 ? ret : -EIO;
187 int m5mols_read_u8(struct v4l2_subdev *sd, u32 reg, u8 *val)
192 if (I2C_SIZE(reg) != 1) {
193 v4l2_err(sd, "Wrong data size\n");
197 ret = m5mols_read(sd, I2C_SIZE(reg), reg, &val_32);
205 int m5mols_read_u16(struct v4l2_subdev *sd, u32 reg, u16 *val)
210 if (I2C_SIZE(reg) != 2) {
211 v4l2_err(sd, "Wrong data size\n");
215 ret = m5mols_read(sd, I2C_SIZE(reg), reg, &val_32);
223 int m5mols_read_u32(struct v4l2_subdev *sd, u32 reg, u32 *val)
225 if (I2C_SIZE(reg) != 4) {
226 v4l2_err(sd, "Wrong data size\n");
230 return m5mols_read(sd, I2C_SIZE(reg), reg, val);
234 * m5mols_write - I2C command write function
235 * @reg: combination of size, category and command for the I2C packet
236 * @val: value to write
238 * Returns 0 on success, or else negative errno.
240 int m5mols_write(struct v4l2_subdev *sd, u32 reg, u32 val)
242 struct i2c_client *client = v4l2_get_subdevdata(sd);
243 struct m5mols_info *info = to_m5mols(sd);
244 u8 wbuf[M5MOLS_I2C_MAX_SIZE + 4];
245 u8 category = I2C_CATEGORY(reg);
246 u8 cmd = I2C_COMMAND(reg);
247 u8 size = I2C_SIZE(reg);
248 u32 *buf = (u32 *)&wbuf[4];
249 struct i2c_msg msg[1];
252 if (!client->adapter)
255 if (size != 1 && size != 2 && size != 4) {
256 v4l2_err(sd, "Wrong data size\n");
260 msg->addr = client->addr;
262 msg->len = (u16)size + 4;
265 wbuf[1] = M5MOLS_BYTE_WRITE;
269 *buf = m5mols_swap_byte((u8 *)&val, size);
271 /* minimum stabilization time */
272 usleep_range(200, 300);
274 ret = i2c_transfer(client->adapter, msg, 1);
279 v4l2_err(sd, "write failed: cat:%02x cmd:%02x ret:%d\n",
282 return ret < 0 ? ret : -EIO;
286 * m5mols_busy_wait - Busy waiting with I2C register polling
287 * @reg: the I2C_REG() address of an 8-bit status register to check
288 * @value: expected status register value
289 * @mask: bit mask for the read status register value
290 * @timeout: timeout in miliseconds, or -1 for default timeout
292 * The @reg register value is ORed with @mask before comparing with @value.
294 * Return: 0 if the requested condition became true within less than
295 * @timeout ms, or else negative errno.
297 int m5mols_busy_wait(struct v4l2_subdev *sd, u32 reg, u32 value, u32 mask,
300 int ms = timeout < 0 ? M5MOLS_BUSY_WAIT_DEF_TIMEOUT : timeout;
301 unsigned long end = jiffies + msecs_to_jiffies(ms);
305 int ret = m5mols_read_u8(sd, reg, &status);
307 if (ret < 0 && !(mask & M5MOLS_I2C_RDY_WAIT_FL))
309 if (!ret && (status & mask & 0xff) == (value & 0xff))
311 usleep_range(100, 250);
312 } while (ms > 0 && time_is_after_jiffies(end));
318 * m5mols_enable_interrupt - Clear interrupt pending bits and unmask interrupts
320 * Before writing desired interrupt value the INT_FACTOR register should
321 * be read to clear pending interrupts.
323 int m5mols_enable_interrupt(struct v4l2_subdev *sd, u8 reg)
325 struct m5mols_info *info = to_m5mols(sd);
326 u8 mask = is_available_af(info) ? REG_INT_AF : 0;
330 ret = m5mols_read_u8(sd, SYSTEM_INT_FACTOR, &dummy);
332 ret = m5mols_write(sd, SYSTEM_INT_ENABLE, reg & ~mask);
336 int m5mols_wait_interrupt(struct v4l2_subdev *sd, u8 irq_mask, u32 timeout)
338 struct m5mols_info *info = to_m5mols(sd);
340 int ret = wait_event_interruptible_timeout(info->irq_waitq,
341 atomic_add_unless(&info->irq_done, -1, 0),
342 msecs_to_jiffies(timeout));
344 return ret ? ret : -ETIMEDOUT;
346 return m5mols_busy_wait(sd, SYSTEM_INT_FACTOR, irq_mask,
347 M5MOLS_I2C_RDY_WAIT_FL | irq_mask, -1);
351 * m5mols_reg_mode - Write the mode and check busy status
353 * It always accompanies a little delay changing the M-5MOLS mode, so it is
354 * needed checking current busy status to guarantee right mode.
356 static int m5mols_reg_mode(struct v4l2_subdev *sd, u8 mode)
358 int ret = m5mols_write(sd, SYSTEM_SYSMODE, mode);
361 return m5mols_busy_wait(sd, SYSTEM_SYSMODE, mode, 0xff,
362 M5MOLS_MODE_CHANGE_TIMEOUT);
366 * m5mols_set_mode - set the M-5MOLS controller mode
367 * @mode: the required operation mode
369 * The commands of M-5MOLS are grouped into specific modes. Each functionality
370 * can be guaranteed only when the sensor is operating in mode which a command
373 int m5mols_set_mode(struct m5mols_info *info, u8 mode)
375 struct v4l2_subdev *sd = &info->sd;
379 if (mode < REG_PARAMETER || mode > REG_CAPTURE)
382 ret = m5mols_read_u8(sd, SYSTEM_SYSMODE, ®);
383 if (ret || reg == mode)
388 ret = m5mols_reg_mode(sd, REG_MONITOR);
389 if (mode == REG_MONITOR)
392 ret = m5mols_reg_mode(sd, REG_CAPTURE);
396 if (mode == REG_PARAMETER) {
397 ret = m5mols_reg_mode(sd, REG_PARAMETER);
401 ret = m5mols_reg_mode(sd, REG_CAPTURE);
405 ret = m5mols_reg_mode(sd, REG_MONITOR);
406 if (mode == REG_MONITOR)
409 ret = m5mols_reg_mode(sd, REG_PARAMETER);
413 v4l2_warn(sd, "Wrong mode: %d\n", mode);
423 * m5mols_get_version - retrieve full revisions information of M-5MOLS
425 * The version information includes revisions of hardware and firmware,
426 * AutoFocus alghorithm version and the version string.
428 static int m5mols_get_version(struct v4l2_subdev *sd)
430 struct m5mols_info *info = to_m5mols(sd);
431 struct m5mols_version *ver = &info->ver;
436 ret = m5mols_read_u8(sd, SYSTEM_VER_CUSTOMER, &ver->customer);
438 ret = m5mols_read_u8(sd, SYSTEM_VER_PROJECT, &ver->project);
440 ret = m5mols_read_u16(sd, SYSTEM_VER_FIRMWARE, &ver->fw);
442 ret = m5mols_read_u16(sd, SYSTEM_VER_HARDWARE, &ver->hw);
444 ret = m5mols_read_u16(sd, SYSTEM_VER_PARAMETER, &ver->param);
446 ret = m5mols_read_u16(sd, SYSTEM_VER_AWB, &ver->awb);
448 ret = m5mols_read_u8(sd, AF_VERSION, &ver->af);
452 for (i = 0; i < VERSION_STRING_SIZE; i++) {
453 ret = m5mols_read_u8(sd, SYSTEM_VER_STRING, &str[i]);
458 v4l2_info(sd, "Manufacturer\t[%s]\n",
459 is_manufacturer(info, REG_SAMSUNG_ELECTRO) ?
460 "Samsung Electro-Mechanics" :
461 is_manufacturer(info, REG_SAMSUNG_OPTICS) ?
462 "Samsung Fiber-Optics" :
463 is_manufacturer(info, REG_SAMSUNG_TECHWIN) ?
464 "Samsung Techwin" : "None");
465 v4l2_info(sd, "Customer/Project\t[0x%02x/0x%02x]\n",
466 info->ver.customer, info->ver.project);
468 if (!is_available_af(info))
469 v4l2_info(sd, "No support Auto Focus on this firmware\n");
475 * __find_restype - Lookup M-5MOLS resolution type according to pixel code
478 static enum m5mols_restype __find_restype(u32 code)
480 enum m5mols_restype type = M5MOLS_RESTYPE_MONITOR;
483 if (code == m5mols_default_ffmt[type].code)
485 } while (++type != SIZE_DEFAULT_FFMT);
491 * __find_resolution - Lookup preset and type of M-5MOLS's resolution
492 * @mf: pixel format to find/negotiate the resolution preset for
493 * @type: M-5MOLS resolution type
494 * @resolution: M-5MOLS resolution preset register value
496 * Find nearest resolution matching resolution preset and adjust mf
497 * to supported values.
499 static int __find_resolution(struct v4l2_subdev *sd,
500 struct v4l2_mbus_framefmt *mf,
501 enum m5mols_restype *type,
504 const struct m5mols_resolution *fsize = &m5mols_reg_res[0];
505 const struct m5mols_resolution *match = NULL;
506 enum m5mols_restype stype = __find_restype(mf->code);
507 int i = ARRAY_SIZE(m5mols_reg_res);
508 unsigned int min_err = ~0;
512 if (stype == fsize->type) {
513 err = abs(fsize->width - mf->width)
514 + abs(fsize->height - mf->height);
524 mf->width = match->width;
525 mf->height = match->height;
526 *resolution = match->reg;
534 static struct v4l2_mbus_framefmt *__find_format(struct m5mols_info *info,
535 struct v4l2_subdev_pad_config *cfg,
536 enum v4l2_subdev_format_whence which,
537 enum m5mols_restype type)
539 if (which == V4L2_SUBDEV_FORMAT_TRY)
540 return cfg ? v4l2_subdev_get_try_format(&info->sd, cfg, 0) : NULL;
542 return &info->ffmt[type];
545 static int m5mols_get_fmt(struct v4l2_subdev *sd, struct v4l2_subdev_pad_config *cfg,
546 struct v4l2_subdev_format *fmt)
548 struct m5mols_info *info = to_m5mols(sd);
549 struct v4l2_mbus_framefmt *format;
552 mutex_lock(&info->lock);
554 format = __find_format(info, cfg, fmt->which, info->res_type);
556 fmt->format = *format;
560 mutex_unlock(&info->lock);
564 static int m5mols_set_fmt(struct v4l2_subdev *sd, struct v4l2_subdev_pad_config *cfg,
565 struct v4l2_subdev_format *fmt)
567 struct m5mols_info *info = to_m5mols(sd);
568 struct v4l2_mbus_framefmt *format = &fmt->format;
569 struct v4l2_mbus_framefmt *sfmt;
570 enum m5mols_restype type;
574 ret = __find_resolution(sd, format, &type, &resolution);
578 sfmt = __find_format(info, cfg, fmt->which, type);
582 mutex_lock(&info->lock);
584 format->code = m5mols_default_ffmt[type].code;
585 format->colorspace = V4L2_COLORSPACE_JPEG;
586 format->field = V4L2_FIELD_NONE;
588 if (fmt->which == V4L2_SUBDEV_FORMAT_ACTIVE) {
590 info->resolution = resolution;
591 info->res_type = type;
594 mutex_unlock(&info->lock);
598 static int m5mols_get_frame_desc(struct v4l2_subdev *sd, unsigned int pad,
599 struct v4l2_mbus_frame_desc *fd)
601 struct m5mols_info *info = to_m5mols(sd);
603 if (pad != 0 || fd == NULL)
606 mutex_lock(&info->lock);
608 * .get_frame_desc is only used for compressed formats,
609 * thus we always return the capture frame parameters here.
611 fd->entry[0].length = info->cap.buf_size;
612 fd->entry[0].pixelcode = info->ffmt[M5MOLS_RESTYPE_CAPTURE].code;
613 mutex_unlock(&info->lock);
615 fd->entry[0].flags = V4L2_MBUS_FRAME_DESC_FL_LEN_MAX;
621 static int m5mols_set_frame_desc(struct v4l2_subdev *sd, unsigned int pad,
622 struct v4l2_mbus_frame_desc *fd)
624 struct m5mols_info *info = to_m5mols(sd);
625 struct v4l2_mbus_framefmt *mf = &info->ffmt[M5MOLS_RESTYPE_CAPTURE];
627 if (pad != 0 || fd == NULL)
630 fd->entry[0].flags = V4L2_MBUS_FRAME_DESC_FL_LEN_MAX;
632 fd->entry[0].length = clamp_t(u32, fd->entry[0].length,
633 mf->width * mf->height,
634 M5MOLS_MAIN_JPEG_SIZE_MAX);
635 mutex_lock(&info->lock);
636 info->cap.buf_size = fd->entry[0].length;
637 mutex_unlock(&info->lock);
643 static int m5mols_enum_mbus_code(struct v4l2_subdev *sd,
644 struct v4l2_subdev_pad_config *cfg,
645 struct v4l2_subdev_mbus_code_enum *code)
647 if (!code || code->index >= SIZE_DEFAULT_FFMT)
650 code->code = m5mols_default_ffmt[code->index].code;
655 static const struct v4l2_subdev_pad_ops m5mols_pad_ops = {
656 .enum_mbus_code = m5mols_enum_mbus_code,
657 .get_fmt = m5mols_get_fmt,
658 .set_fmt = m5mols_set_fmt,
659 .get_frame_desc = m5mols_get_frame_desc,
660 .set_frame_desc = m5mols_set_frame_desc,
664 * m5mols_restore_controls - Apply current control values to the registers
666 * m5mols_do_scenemode() handles all parameters for which there is yet no
667 * individual control. It should be replaced at some point by setting each
668 * control individually, in required register set up order.
670 int m5mols_restore_controls(struct m5mols_info *info)
677 ret = m5mols_do_scenemode(info, REG_SCENE_NORMAL);
681 ret = v4l2_ctrl_handler_setup(&info->handle);
682 info->ctrl_sync = !ret;
688 * m5mols_start_monitor - Start the monitor mode
690 * Before applying the controls setup the resolution and frame rate
691 * in PARAMETER mode, and then switch over to MONITOR mode.
693 static int m5mols_start_monitor(struct m5mols_info *info)
695 struct v4l2_subdev *sd = &info->sd;
698 ret = m5mols_set_mode(info, REG_PARAMETER);
700 ret = m5mols_write(sd, PARM_MON_SIZE, info->resolution);
702 ret = m5mols_write(sd, PARM_MON_FPS, REG_FPS_30);
704 ret = m5mols_set_mode(info, REG_MONITOR);
706 ret = m5mols_restore_controls(info);
711 static int m5mols_s_stream(struct v4l2_subdev *sd, int enable)
713 struct m5mols_info *info = to_m5mols(sd);
717 mutex_lock(&info->lock);
718 code = info->ffmt[info->res_type].code;
721 if (is_code(code, M5MOLS_RESTYPE_MONITOR))
722 ret = m5mols_start_monitor(info);
723 else if (is_code(code, M5MOLS_RESTYPE_CAPTURE))
724 ret = m5mols_start_capture(info);
728 ret = m5mols_set_mode(info, REG_PARAMETER);
731 mutex_unlock(&info->lock);
735 static const struct v4l2_subdev_video_ops m5mols_video_ops = {
736 .s_stream = m5mols_s_stream,
739 static int m5mols_sensor_power(struct m5mols_info *info, bool enable)
741 struct v4l2_subdev *sd = &info->sd;
742 struct i2c_client *client = v4l2_get_subdevdata(sd);
743 const struct m5mols_platform_data *pdata = info->pdata;
746 if (info->power == enable)
750 if (info->set_power) {
751 ret = info->set_power(&client->dev, 1);
756 ret = regulator_bulk_enable(ARRAY_SIZE(supplies), supplies);
759 info->set_power(&client->dev, 0);
763 gpio_set_value(pdata->gpio_reset, !pdata->reset_polarity);
769 ret = regulator_bulk_disable(ARRAY_SIZE(supplies), supplies);
774 info->set_power(&client->dev, 0);
776 gpio_set_value(pdata->gpio_reset, pdata->reset_polarity);
784 /* m5mols_update_fw - optional firmware update routine */
785 int __attribute__ ((weak)) m5mols_update_fw(struct v4l2_subdev *sd,
786 int (*set_power)(struct m5mols_info *, bool))
792 * m5mols_fw_start - M-5MOLS internal ARM controller initialization
794 * Execute the M-5MOLS internal ARM controller initialization sequence.
795 * This function should be called after the supply voltage has been
796 * applied and before any requests to the device are made.
798 static int m5mols_fw_start(struct v4l2_subdev *sd)
800 struct m5mols_info *info = to_m5mols(sd);
803 atomic_set(&info->irq_done, 0);
804 /* Wait until I2C slave is initialized in Flash Writer mode */
805 ret = m5mols_busy_wait(sd, FLASH_CAM_START, REG_IN_FLASH_MODE,
806 M5MOLS_I2C_RDY_WAIT_FL | 0xff, -1);
808 ret = m5mols_write(sd, FLASH_CAM_START, REG_START_ARM_BOOT);
810 ret = m5mols_wait_interrupt(sd, REG_INT_MODE, 2000);
816 ret = m5mols_get_version(sd);
818 ret = m5mols_update_fw(sd, m5mols_sensor_power);
822 v4l2_dbg(1, m5mols_debug, sd, "Success ARM Booting\n");
824 ret = m5mols_write(sd, PARM_INTERFACE, REG_INTERFACE_MIPI);
826 ret = m5mols_enable_interrupt(sd,
827 REG_INT_AF | REG_INT_CAPTURE);
832 /* Execute the lens soft-landing algorithm */
833 static int m5mols_auto_focus_stop(struct m5mols_info *info)
837 ret = m5mols_write(&info->sd, AF_EXECUTE, REG_AF_STOP);
839 ret = m5mols_write(&info->sd, AF_MODE, REG_AF_POWEROFF);
841 ret = m5mols_busy_wait(&info->sd, SYSTEM_STATUS, REG_AF_IDLE,
847 * m5mols_s_power - Main sensor power control function
849 * To prevent breaking the lens when the sensor is powered off the Soft-Landing
850 * algorithm is called where available. The Soft-Landing algorithm availability
851 * dependends on the firmware provider.
853 static int m5mols_s_power(struct v4l2_subdev *sd, int on)
855 struct m5mols_info *info = to_m5mols(sd);
858 mutex_lock(&info->lock);
861 ret = m5mols_sensor_power(info, true);
863 ret = m5mols_fw_start(sd);
865 if (is_manufacturer(info, REG_SAMSUNG_TECHWIN)) {
866 ret = m5mols_set_mode(info, REG_MONITOR);
868 ret = m5mols_auto_focus_stop(info);
870 v4l2_warn(sd, "Soft landing lens failed\n");
872 ret = m5mols_sensor_power(info, false);
877 mutex_unlock(&info->lock);
881 static int m5mols_log_status(struct v4l2_subdev *sd)
883 struct m5mols_info *info = to_m5mols(sd);
885 v4l2_ctrl_handler_log_status(&info->handle, sd->name);
890 static const struct v4l2_subdev_core_ops m5mols_core_ops = {
891 .s_power = m5mols_s_power,
892 .log_status = m5mols_log_status,
896 * V4L2 subdev internal operations
898 static int m5mols_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
900 struct v4l2_mbus_framefmt *format = v4l2_subdev_get_try_format(sd, fh->pad, 0);
902 *format = m5mols_default_ffmt[0];
906 static const struct v4l2_subdev_internal_ops m5mols_subdev_internal_ops = {
910 static const struct v4l2_subdev_ops m5mols_ops = {
911 .core = &m5mols_core_ops,
912 .pad = &m5mols_pad_ops,
913 .video = &m5mols_video_ops,
916 static irqreturn_t m5mols_irq_handler(int irq, void *data)
918 struct m5mols_info *info = to_m5mols(data);
920 atomic_set(&info->irq_done, 1);
921 wake_up_interruptible(&info->irq_waitq);
926 static int m5mols_probe(struct i2c_client *client,
927 const struct i2c_device_id *id)
929 const struct m5mols_platform_data *pdata = client->dev.platform_data;
930 unsigned long gpio_flags;
931 struct m5mols_info *info;
932 struct v4l2_subdev *sd;
936 dev_err(&client->dev, "No platform data\n");
940 if (!gpio_is_valid(pdata->gpio_reset)) {
941 dev_err(&client->dev, "No valid RESET GPIO specified\n");
946 dev_err(&client->dev, "Interrupt not assigned\n");
950 info = devm_kzalloc(&client->dev, sizeof(*info), GFP_KERNEL);
955 info->set_power = pdata->set_power;
957 gpio_flags = pdata->reset_polarity
958 ? GPIOF_OUT_INIT_HIGH : GPIOF_OUT_INIT_LOW;
959 ret = devm_gpio_request_one(&client->dev, pdata->gpio_reset, gpio_flags,
962 dev_err(&client->dev, "Failed to request gpio: %d\n", ret);
966 ret = devm_regulator_bulk_get(&client->dev, ARRAY_SIZE(supplies),
969 dev_err(&client->dev, "Failed to get regulators: %d\n", ret);
974 v4l2_i2c_subdev_init(sd, client, &m5mols_ops);
975 strlcpy(sd->name, MODULE_NAME, sizeof(sd->name));
976 sd->flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
978 sd->internal_ops = &m5mols_subdev_internal_ops;
979 info->pad.flags = MEDIA_PAD_FL_SOURCE;
980 ret = media_entity_pads_init(&sd->entity, 1, &info->pad);
983 sd->entity.function = MEDIA_ENT_F_CAM_SENSOR;
985 init_waitqueue_head(&info->irq_waitq);
986 mutex_init(&info->lock);
988 ret = devm_request_irq(&client->dev, client->irq, m5mols_irq_handler,
989 IRQF_TRIGGER_RISING, MODULE_NAME, sd);
991 dev_err(&client->dev, "Interrupt request failed: %d\n", ret);
994 info->res_type = M5MOLS_RESTYPE_MONITOR;
995 info->ffmt[0] = m5mols_default_ffmt[0];
996 info->ffmt[1] = m5mols_default_ffmt[1];
998 ret = m5mols_sensor_power(info, true);
1002 ret = m5mols_fw_start(sd);
1004 ret = m5mols_init_controls(sd);
1006 ret = m5mols_sensor_power(info, false);
1010 media_entity_cleanup(&sd->entity);
1014 static int m5mols_remove(struct i2c_client *client)
1016 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1018 v4l2_device_unregister_subdev(sd);
1019 v4l2_ctrl_handler_free(sd->ctrl_handler);
1020 media_entity_cleanup(&sd->entity);
1025 static const struct i2c_device_id m5mols_id[] = {
1029 MODULE_DEVICE_TABLE(i2c, m5mols_id);
1031 static struct i2c_driver m5mols_i2c_driver = {
1033 .name = MODULE_NAME,
1035 .probe = m5mols_probe,
1036 .remove = m5mols_remove,
1037 .id_table = m5mols_id,
1040 module_i2c_driver(m5mols_i2c_driver);
1042 MODULE_AUTHOR("HeungJun Kim <riverful.kim@samsung.com>");
1043 MODULE_AUTHOR("Dongsoo Kim <dongsoo45.kim@samsung.com>");
1044 MODULE_DESCRIPTION("Fujitsu M-5MOLS 8M Pixel camera driver");
1045 MODULE_LICENSE("GPL");