On Tuesday, June 24, 2014 4:19 PM, Daniel Jeong wrote: > > This driver a general version for tps611xx backlgiht chips of TI. s/This driver a general/This driver is a general -> "is" is missing. > It supports tps61158, tps61161, tps61163 and tps61165 backlight driver > based on EasyScale protocol(1-Wire Control Interface). > > EasyScale > EasyScale is a simple but flexible one pin interface to configure the current. > The interface is based on a master-slave structure, where the master is > typically a microcontroller or application processor and the IC is the slave. > The advantage of EasyScale compared with other one pin interfaces is that > its bit detection is in a large extent independent from the bit transmission rate. > It can automatically detect bit rates between 1.7kBit/sec and up to 160kBit/sec. > > EasyScale on TPS61163 > A command consists of 24 bits, including an 8-bit device address byte and a 16-bit data byte. > All of the 24 bits should be transmitted together each time, and the LSB bit should be > transmitted first. The device address byte A7(MSB)~A0(LSB) is fixed to 0x8F. > The data byte includes 9 bits D8(MSB)~D0(LSB) for brightness information and an RFA bit. > The RFA bit set to "1" indicates the Request for Acknowledge condition. The Acknowledge > condition is only applied when the protocol is received correctly. > Bit sream : D0-D8 | 0 | RFA | 00000 | A0-A7 > Please refer http://www.ti.com/lit/ds/symlink/tps61163.pdf for more details. > > EasyScale on TPS61158/61/65 > A command consists of 16 bits, including an 8-bit device address byte and a 8-bit data byte. > All of the 16 bits should be transmitted together each time, and the MSB bit should be > transmitted first. The device address byte A7(MSB)~A0(LSB) is fixed (tps61158 0x58 > tps61161 and tps61165 0x72). The data byte includes an RFA bit. > The RFA bit set to "1" indicates the Request for Acknowledge condition. The Acknowledge > condition is only applied when the protocol is received correctly. > Bit sream : A7-A0 | RFA | 00 | D4-D0 > Please refer the links below for more details. s/refer/refer to > tps61158 : http://www.ti.com/lit/ds/symlink/tps61158.pdf > tps61161 : http://www.ti.com.cn/cn/lit/ds/symlink/tps61161-q1.pdf > tps61165 : http://www.ti.com/lit/ds/symlink/tps61165.pdf These columns of the commit message are long. Please keep 80 columns for the readability, if possible. > > Signed-off-by: Daniel Jeong <gshark.jeong@xxxxxxxxx> > --- > drivers/video/backlight/Kconfig | 7 + > drivers/video/backlight/Makefile | 1 + > drivers/video/backlight/tps611xx_bl.c | 494 +++++++++++++++++++++++++++++ > include/linux/platform_data/tps611xx_bl.h | 31 ++ > 4 files changed, 533 insertions(+) > create mode 100644 drivers/video/backlight/tps611xx_bl.c > create mode 100644 include/linux/platform_data/tps611xx_bl.h > > diff --git a/drivers/video/backlight/Kconfig b/drivers/video/backlight/Kconfig > index 5a3eb2e..c779a85 100644 > --- a/drivers/video/backlight/Kconfig > +++ b/drivers/video/backlight/Kconfig > @@ -418,6 +418,13 @@ config BACKLIGHT_TPS65217 > If you have a Texas Instruments TPS65217 say Y to enable the > backlight driver. > > +config BACKLIGHT_TPS611xx > + tristate "TPS611xx Backlight" > + depends on BACKLIGHT_CLASS_DEVICE && GPIOLIB > + help > + This supports TI TPS61158,TPS61161, TPS61163 and TPS61165 > + backlight driver based on EasyScale Protocol. > + > config BACKLIGHT_AS3711 > tristate "AS3711 Backlight" > depends on BACKLIGHT_CLASS_DEVICE && MFD_AS3711 > diff --git a/drivers/video/backlight/Makefile b/drivers/video/backlight/Makefile > index bb82002..44f1641 100644 > --- a/drivers/video/backlight/Makefile > +++ b/drivers/video/backlight/Makefile > @@ -52,4 +52,5 @@ obj-$(CONFIG_BACKLIGHT_PWM) += pwm_bl.o > obj-$(CONFIG_BACKLIGHT_SAHARA) += kb3886_bl.o > obj-$(CONFIG_BACKLIGHT_TOSA) += tosa_bl.o > obj-$(CONFIG_BACKLIGHT_TPS65217) += tps65217_bl.o > +obj-$(CONFIG_BACKLIGHT_TPS611xx) += tps611xx_bl.o Please add it in an alphabetical order as below. +obj-$(CONFIG_BACKLIGHT_TPS611xx) += tps611xx_bl.o obj-$(CONFIG_BACKLIGHT_TPS65217) += tps65217_bl.o > obj-$(CONFIG_BACKLIGHT_WM831X) += wm831x_bl.o > diff --git a/drivers/video/backlight/tps611xx_bl.c b/drivers/video/backlight/tps611xx_bl.c > new file mode 100644 > index 0000000..8dcc88a > --- /dev/null > +++ b/drivers/video/backlight/tps611xx_bl.c > @@ -0,0 +1,494 @@ [...] > + > +static struct tps611xx_esdata tps611xx_info[] = { > + [TPS61158_ID] = { > + .id = TPS61158_ID, > + .name = "tps61158", > + .addr = 0x5800, > + .cmd = { > + .seq = CMD_FORWARD, > + .size = 16, > + .brt_max = 31, > + .brt_bmask = 0x1f, > + .rfa_bmask = 0x80 > + }, Please keep the standard for coding style as below. [TPS61158_ID] = { .id = TPS61158_ID, .name = "tps61158", .addr = 0x5800, .cmd = { .seq = CMD_FORWARD, .size = 16, .brt_max = 31, .brt_bmask = 0x1f, .rfa_bmask = 0x80 }, > + .time = { > + .es_delay = 100000, > + .es_det = 450000, > + .start = 3500, > + .eos = 3500, > + .reset = 4, > + .logic_1_low = 5000, > + .logic_0_low = 15000, > + .ackn = 900000, > + .ack_poll = 2000 > + }, > + }, > + > + [TPS61161_ID] = { > + .id = TPS61161_ID, > + .name = "tps61161", > + .addr = 0x7200, > + .cmd = { > + .seq = CMD_FORWARD, > + .size = 16, > + .brt_max = 31, > + .brt_bmask = 0x1f, > + .rfa_bmask = 0x80 > + }, > + .time = { > + .es_delay = 120000, > + .es_det = 280000, > + .start = 2000, > + .eos = 2000, > + .reset = 3, > + .logic_1_low = 3000, > + .logic_0_low = 7000, > + .ackn = 512000, > + .ack_poll = 2000 > + }, > + }, > + > + [TPS61163_ID] = { > + .id = TPS61163_ID, > + .name = "tps61163", > + .addr = 0x8F0000, > + .cmd = { > + .seq = CMD_BACKWARD, > + .size = 24, > + .brt_max = 511, > + .brt_bmask = 0x1ff, > + .rfa_bmask = 0x400 > + }, > + .time = { > + .es_delay = 100000, > + .es_det = 260000, > + .start = 2000, > + .eos = 2000, > + .reset = 3, > + .logic_1_low = 3000, > + .logic_0_low = 7000, > + .ackn = 512000, > + .ack_poll = 2000 > + }, > + }, > + > + [TPS61165_ID] = { > + .id = TPS61165_ID, > + .name = "tps61165", > + .addr = 0x7200, > + .cmd = { > + .seq = CMD_FORWARD, > + .size = 16, > + .brt_max = 31, > + .brt_bmask = 0x1f, > + .rfa_bmask = 0x80 > + }, > + .time = { > + .es_delay = 120000, > + .es_det = 280000, > + .start = 4000, > + .eos = 4000, > + .reset = 3, > + .logic_1_low = 3000, > + .logic_0_low = 7000, > + .ackn = 512000, > + .ack_poll = 2000 > + }, > + }, > +}; Same as above mentioned comment. [...] > + > +static int tps611xx_bl_get_brightness(struct backlight_device *bl) > +{ > + return bl->props.brightness; > +} > + > +static const struct backlight_ops tps611xx_bl_ops = { > + .update_status = tps611xx_bl_update_status, > + .get_brightness = tps611xx_bl_get_brightness, Please don't add 'tps611xx_bl_get_brightness' callback function, when it just returns 'props.brightness'. Please refer to the following links. http://www.spinics.net/lists/arm-kernel/msg335952.html http://www.spinics.net/lists/arm-kernel/msg335951.html [...] > + > +static struct platform_driver tps611xx_backlight_driver = { > + .driver = { > + .name = TPS611XX_NAME, > + .owner = THIS_MODULE, > + .of_match_table = of_match_ptr(tps611xx_backlight_of_match), > + }, Please keep the coding style as below. + } > + .probe = tps611xx_backlight_probe, > + .remove = tps611xx_backlight_remove, > + .id_table = tps611xx_id_table, > +}; > + > +module_platform_driver(tps611xx_backlight_driver); > + > +MODULE_DESCRIPTION("EasyScale based tps611xx Backlight Driver"); > +MODULE_LICENSE("GPL v2"); > +MODULE_ALIAS("platform:tps611xx_bl"); > diff --git a/include/linux/platform_data/tps611xx_bl.h b/include/linux/platform_data/tps611xx_bl.h > new file mode 100644 > index 0000000..73d1f08 > --- /dev/null > +++ b/include/linux/platform_data/tps611xx_bl.h > @@ -0,0 +1,31 @@ > +/* > + * Simple driver for Texas Instruments TPS61163a Backlight driver chip s/TPS61163a/TPS611xx > + * Copyright (C) 2014 Texas Instruments > + * > + * This program is free software; you can redistribute it and/or modify > + * it under the terms of the GNU General Public License version 2 as > + * published by the Free Software Foundation. > + * > + */ > + > +#ifndef __TPS611XX_H > +#define __TPS611XX_H > + > +#define TPS611XX_NAME "tps611xx_bl" > +#define TPS61158_NAME "tps61158_bl" > +#define TPS61161_NAME "tps61161_bl" > +#define TPS61163_NAME "tps61163_bl" > +#define TPS61165_NAME "tps61165_bl" > + > +/* > + * struct tps61163a platform data s/tps61163a/tps611xx Best regards, Jingoo Han > + * @rfa_en : request for acknowledge > + * @en_gpio_num : gpio number for en_pin > + */ > +struct tps611xx_platform_data { > + > + int rfa_en; > + unsigned int en_gpio_num; > +}; > + > +#endif /* __TPS611XX_H */ > -- > 1.7.9.5 -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
