一、 与 LCD 驱动相关的主要文件路径 \mediatek\platform\mt6573\uboot\mt6573_disp_drv.c \mediatek\platform\mt6573\uboot\mt6573_disp_drv_dpi.c \mediatek\platform\mt6573\uboot \mt6573_disp_drv_dbi.c \mediatek\platform\mt6573\uboot \mt6573_dpi_drv.c \mediatek\platform\mt6573\uboot \mt6573_dsi_drv.c \mediatek\platform\mt6573\uboot \mt6573_lcd_drv.c \mediatek\source\kernel\drivers\video\mtkfb.c \mediatek\source\kernel\drivers\video\disp_drv.c \mediatek\source\kernel\drivers\video\disp_drv_dpi.c \mediatek\source\kernel\drivers\video\disp_drv_dbi.c \mediatek\platform\mt6573\kernel\drivers\video\lcd_drv.c \mediatek\platform\mt6573\kernel\drivers\video\dpi_drv.c \mediatek\platform\mt6573\kernel\drivers\video\dsi_drv.c \mediatek\custom\common\kernel\lcm\LCM_NAME\LCM_NAME.c \mediatek\platform\mt6573\uboot \mt6573_pwm.c \mediatek\platform\mt6573\uboot \mt65xx_leds.c \mediatek\source\kernel\drivers\leds\leds.c \mediatek\custom\ginwave73_gb\kernel\leds\mt65xx\cust_leds.c 二、 怎样新建一个 LCD 驱动 LCD 模组主要包括 LCD 显示屏和驱动 IC。 比如 LF040DNYB16a 模组的驱动 IC 型号为 NT35510。 要在 MTK6573 平台上新建这个 lcd 的驱动，步骤如下： 1、 在 mediatek\custom\common\kernel\lcm 目录下新建文件夹 nt35510,在此文件夹中新建 nt35510.c。 这就是 LCM 硬 件层驱动文件。 2、 修 改 \mediatek\custom\common\kernel\lcm\ mt65xx_lcm_list.c, 在 lcm_driver_list [ lcm_count ] 中 增 加 nt35510_lcm_drv。 3、 打 开 mediatek\config\ginwave73_gb\ProjectConfig.mk ， 修 改 CUSTOM_UBOOT_LCM = nt35510, CUSTOM_KERNEL_LCM = nt35510；修改 LCM_WIDTH、LCM_HEIGHT、BOOT_LOGO 为正确的值。 驱动文件（ 三、 驱动文件（nt35510.c） 主 要任务是实现 LCM_DRIVER nt35510_lcm_drv = { .name = "nt35510" .set_util_funcs = lcm_set_util_funcs, .get_params = lcm_get_params, .init = lcm_init, .suspend = lcm_suspend, .resume = lcm_resume, .compare_id = lcm_compare_id, }; 相关的参数，数据结构如下： （1）lcm_get_params 主要是设置 LCM 相关的参数，数据结构如下： ） typedef struct { LCM_TYPE type; LCM_CTRL ctrl; //! how to control LCM registers unsigned int width;unsigned int height; unsigned int io_select_mode; /* particular parameters */ LCM_DBI_PARAMS dbi; LCM_DPI_PARAMS dpi; LCM_DSI_PARAMS dsi; } LCM_PARAMS;
//DBI or DPI should select IO mode according to chip spec
LCM_TYPE 定义 LCM 与 HOST 间的接口，主要分为 3 种，DBI, DPI, DSI。其中 DBI 又分为 parallel DBI 和 serial DBI。 parallel DBI 型 DBI） （B 的命令和数据都在数据总线 D[17:0]上传输。 CSX 为低时数据有效。 WRX 线控制 D[17:0] 为写时序，RDX 控制 D[17:0]为读时序。D/CX 指示 D[17:0]上传输的是命令还是数据。注：MT6573 使用 LPA0 线作为 D/CX 线，LPCE 线作为 CSX 线，LWRB 线作为 WRX 线，LRDB 线作为 RDX 线。
serial DBI（C 型 DBI）的命令和数据都在 SPI 接口上传输。CSX 为低时 SDA 有效。SCL 提供时钟，DIN 输入， DOUT 输出。当 SDA_EN=1 时，DIN 线成为双向的 SDA 线，即可输入又可输出，DOUT 线不用。C 型 DBI 分为 3 线(没有 D/CX 线)和 4 线（有 D/CX 线）两种。3 线的使用一个 D/CX bit 来区分命令/数据，4 线的使用 D/CX 线来区分命令/数据。注：MT6573 使用 LSA0 线作为 D/CX 线，LSCE 线作为 CSX 线。LSCK 线作为 SCL 线，LSDA 线
作为 SDA 线。
DPI 的命令在 SPI 上传输， Pixel data(RGB data)在 D[17:0]上传输。 其命令传输方式与 serial DBI 相同。 对于 Pixel data(RGB data)， 需要自己的 4 条控制线： DPICK_PIN(RGB 时钟) 、 DPIDE_PIN （RGB 数据有效） DPIVSYNC(场 、 同步)、 DPIHSYNC(行同步) 。 typedef enum { LCM_CTRL_NONE = 0, LCM_CTRL_SERIAL_DBI, LCM_CTRL_PARALLEL_DBI, LCM_CTRL_GPIO } LCM_CTRL 定义 LCM 与 HOST 之间传递 command 的方式，有 SERIAL_DBI、PARALLEL_DBI、GPIO 几种 控制方式。如果是 DPI 接口，其 LCM_CTRL 可以选择 SERIAL_DBI 或者 GPIO。 Width 和 height 定义 LCM 的宽度和高度。 io_select_mode 有 这 些 选 项 ： 0 （ LCD_IO_SEL_16CPU_24RGB ） 1 （ LCD_IO_SEL_18CPU_18RGB ） 2 ， ， （LCD_IO_SEL_24CPU_8RGB） ，3（LCD_IO_SEL_24CPU_ONLY） 。根据 driver IC 的定义填写。 LCM_×××_PARAMS 根据不同的 LCM_TYPE 取值，这是针对 DBI/DPI/DSI 接口类型的详细参数定义。比如 LCM_DPI_PARAMS 定义如下： typedef struct { unsigned int mipi_pll_clk_ref; // 0..1 unsigned int mipi_pll_clk_div1; // 0..63 unsigned int mipi_pll_clk_div2; // 0..15 unsigned int dpi_clk_div; // 2..32
unsigned int dpi_clk_duty; /* polarity parameters */ LCM_POLARITY clk_pol; LCM_POLARITY de_pol; LCM_POLARITY vsync_pol; LCM_POLARITY hsync_pol; /* timing parameters */ unsigned int hsync_pulse_width; unsigned int hsync_back_porch; unsigned int hsync_front_porch; unsigned int vsync_pulse_width; unsigned int vsync_back_porch; unsigned int vsync_front_porch;
// (dpi_clk_div - 1) .. 31
/* output format parameters */ LCM_DPI_FORMAT format; LCM_COLOR_ORDER rgb_order; unsigned int is_serial_output; /* intermediate buffers parameters */ unsigned int intermediat_buffer_num; // 2..3 /* iopad parameters */ LCM_DRIVING_CURRENT io_driving_current; } LCM_DPI_PARAMS; 其中，第一段前 4 项用于控制 DPI 时钟，计算公式如下： Pixel Clock Frequency = 26MHz * mipi_pll_clk_div1 / (mipi_pll_clk_ref + 1)/ (2 * mipi_pll_clk_div2)/ dpi_clk_div 第二段 4 个参数设置 DPICK_PIN(RGB 时钟) 、DPIDE_PIN（RGB 数据有效） DPIVSYNC(场同步)、 、 DPIHSYNC(行同步)线是上升沿还是下降沿有效。 行同步脉冲开始前和开始后的几个时钟周期，是行信号消隐期；场同步开始前和开始后的几个行周期，是场信 号 消 隐 期 。 消 隐 期 不 传 递 图 像 信 号 。 消 隐 期 特 性 由 第 三 段 六 个 参 数 定 义 ： hsync_pulse_width; hsync_back_porch; hsync_front_porch;vsync_pulse_width; vsync_back_porch; vsync_front_porch; LCM_DPI_FORMAT 指定每个像素中 RGB 各占几个 bit. LCM_COLOR_ORDER 指定 RGB 的顺序。 上述参数的值，均依照 LCM spec 及驱动 IC datasheet 中的定义。 这里要说说一个特别之处。NT35510 使用 DPI 接口，SERIAL_DBI ctrl 方式时，没有 D/CX 线，datasheet 上定 义的传输方式是 9 bits，即在数据 byte 前加个 D/CX bit。但使用了 NT35510 的 LCM——LF040DNYB16a，其 spec 中却另外定义了其串口使用 16 bits 模式传输。Byte1 是标志 byte, 前 3 位分别为 R/W bit, D/CX bit, High/Low bit； Byte2 则是命令或数据。 NT35510 的每个 command 长度为 2byte， 还可能带有若干 bytes 的参数， 0x40 0xAA。 比如命令 F001,参数 AA，应该这样传输：0x20 0xF0 0x00 0x01 的初始化，包括如下步骤： （2）lcm_init 主要实现 LCM 的初始化，包括如下步骤： ） config_gpio——配置 GPIO。
发送 reset 信号。RESET pin low 和 RESET pin high 需要持续的时间一般为若干 ms, 以 datasheet 为准。 init_lcm_registers——初始化 LCM 的寄存器。具体可以厂家提供的初始代码为参考。一般在此函数末尾， 都会使用唤醒命令组（见后文） ，使 LCM 进入工作状态。 （3）lcm_suspend 使 LCM 休眠，使用特定的命令，并遵守 datasheet 定义的时间特性。常用命令组如下： 休眠， ） 0X2800 (or 0X28) —— set display off 0X1000 (or 0X10) —— enter sleep mode 对 nt35510 而言，还有一种更深睡眠的状态——deep standby mode，使用如下命令进入： 0X4F00 0X01 苏醒， （4）lcm_resume 使 LCM 苏醒，使用特定的命令，并遵守 datasheet 定义的时间特性。 ） 唤醒命令组： 0X1100 (or 0X11) —— exit sleep mode 0X2900 (or 0X29) —— set display on 对 nt35510 而言，如果在 lcm_suspend 中使 LCM enter deep standby mode，则不能使用唤醒命令组，需要使 用 reset 信号并要重新 init_lcm_registers。 四、 驱动 nt35510_lcm_drv 怎样被上层使用 Mtkfb.c 中实现了 LCM 的 platform driver： static struct platform_driver mtkfb_driver = { .driver = { .name = “mtk-fb”, .bus = &platform_bus_type, .probe = mtkfb_probe, .remove = mtkfb_remove, .suspend = mtkfb_suspend, .resume = mtkfb_resume, }, }; mtkfb_probe 会 调 用 函数 mtkfb_find_lcm_driver 来 发 现 LCM 的 硬 件层驱 动 。 mtkfb_find_lcm_driver— — DISP_SelectDevice——disp_drv_get_lcm_driver，检查 lcm_driver_list[], 得到当前使用的 LCM 及其驱动名称。
Mt6573_devs.c 中，定义了 framebuffer 型的 platform device，这个设备在 mt6573_board_init()调用时被注册。它 所对应的驱动就是上文提到的 mtkfb_driver static struct platform_device mt6573_device_fb = { .name = "mtkfb" .id = 0, .num_resources = ARRAY_SIZE(resource_fb), .resource = resource_fb, .dev = { .dma_mask = &mtkfb_dmamask, .coherent_dma_mask = 0xffffffff, }, }; 在 linux 内核中 lcd 设备驱动所使用的是 framebuffer 设备类型，framebuffer 设备驱动程序的核心数据结构是 fb_ops；用户空间就是通过此结构体，调用其中的函数来对 LCD 实现控制。Mtkfb.c 中定义并实现了 fb_ops 类型的 mtkfb_ops 。 一 个 使 用 mtkfb_ops 的 例 子 见 \mediatek\source\kernel\drivers\gpu\pvr\services4\3rdparty\mtklfb\ mtklfb_displayclass.c。
static struct fb_ops mtkfb_ops = { .owner = THIS_MODULE, .fb_open = mtkfb_open, .fb_release = mtkfb_release, .fb_setcolreg = mtkfb_setcolreg, .fb_pan_display = mtkfb_pan_display_proxy, .fb_fillrect = cfb_fillrect, .fb_copyarea = cfb_copyarea, .fb_imageblit = cfb_imageblit, .fb_cursor = mtkfb_soft_cursor, .fb_check_var = mtkfb_check_var, .fb_set_par = mtkfb_set_par, .fb_ioctl = mtkfb_ioctl, };
//批量配置颜色参数 //虚拟屏幕内容显示 //填充区域显示 //复制区域显示 //显示图象 //光标显示 //检查并配置 fb_var_screeninfo 参数 //change display mode and set parameter //特定 ioctl 配置 LCD 屏幕特性
五、 Frame Buffer 设备驱动 mtkfb_driver 中的各个函数会调用到 DISP_xxx 函数（DISP_drv.c）,而 DISP_xxx 会调用到 LCD_xxx 函数 （lcd_drv.c）以及 LCM 硬件层驱动。 mtkfb_probe 的主要工作如下： * find lcm driver * Register interrupt handler (call back function), Init screen update wait queue, create screen update kThread * Allocate and initialize frame buffer device (fb_info , mtkfb_device), select panel type according to machine type * Initialize Display Driver PDD Layer (DISP_init) * Initialize fb_info struct (mtkfb_fbinfo_init) * Register mtkfb_device fs to system (mtkfb_register_sysfs) * Register fb_info to system (register_framebuffer) fb_info 结构定义如下 结构定义如下： struct fb_info { int node; int flags; struct mutex lock; /* Lock for open/release/ioctl funcs */ struct mutex mm_lock; /* Lock for fb_mmap and smem_* fields */ struct fb_var_screeninfo var;/* Current var */ struct fb_fix_screeninfo fix; /* Current fix */ struct fb_monspecs monspecs; /* Current Monitor specs */ struct work_struct queue; /* Framebuffer event queue */ struct fb_pixmap pixmap; /* Image hardware mapper */ struct fb_pixmap sprite; /* Cursor hardware mapper */ struct fb_cmap cmap; /* Current cmap */ struct list_head modelist; /* mode list */ struct fb_videomode *mode; /* current mode */ #ifdef CONFIG_FB_BACKLIGHT struct backlight_device *bl_dev; struct mutex bl_curve_mutex; u8 bl_curve[FB_BACKLIGHT_LEVELS]; #endif
#ifdef CONFIG_FB_DEFERRED_IO struct delayed_work deferred_work; struct fb_deferred_io *fbdefio; #endif struct fb_ops *fbops; struct device *device; /* This is the parent */ struct device *dev; /* This is this fb device */ int class_flag; /* private sysfs flags */ #ifdef CONFIG_FB_TILEBLITTING struct fb_tile_ops *tileops; /* Tile Blitting */ #endif char __iomem *screen_base; /* Virtual address */ unsigned long screen_size; /* Amount of ioremapped VRAM or 0 */ void *pseudo_palette; /* Fake palette of 16 colors */ #define FBINFO_STATE_RUNNING 0 #define FBINFO_STATE_SUSPENDED 1 u32 state; /* Hardware state i.e suspend */ void *fbcon_par; /* fbcon use-only private area */ /* From here on everything is device dependent */ void *par; struct apertures_struct { unsigned int count; struct aperture { resource_size_t base; resource_size_t size; } ranges[0]; } *apertures; }; 1）fb_var_screeninfo ） 这个结构描述了显示卡的特性： NOTE: __u32 是表示 unsigned 不带符号的 32 bits 的数据类型，其余类推。这是 Linux 内核中所用到的数 据类型，如果是开发用户空间（user-space）的程序，可以根据具体计算机平台的情况，用 unsigned long 等等来代 替 struct fb_var_screeninfo { __u32 xres; /* visible resolution */ //可视区域 __u32 yres; __u32 xres_virtual; /* virtual resolution */ //可视区域 __u32 yres_virtual; __u32 xoffset; /* offset from virtual to visible resolution */ //可视区域的偏移 __u32 yoffset; __u32 bits_per_pixel; /* guess what */ //每一象素的 bit 数 __u32 grayscale; /* != 0 Gray levels instead of colors *///等于零就成黑白 struct fb_bitfield red; /* bitfield in fb mem if true color, */真彩的 bit 机构 struct fb_bitfield green; /* else only length is significant */
struct fb_bitfield blue; struct fb_bitfield transp; /* transparency */ 透明 __u32 nonstd; /* != 0 Non standard pixel format */ 不是标准格式 __u32 activate; /* see FB_ACTIVATE_* */ __u32 height; /* height of picture in mm */ 内存中的图像高度 __u32 width; /* width of picture in mm */ 内存中的图像宽度 __u32 accel_flags; /* acceleration flags (hints) */ 加速标志 /* Timing: All values in pixclocks, except pixclock (of course) */ 时序-_-这些部分就是显示器的显示方法了，可以找相关的资料看看 __u32 pixclock; /* pixel clock in ps (pico seconds) */ __u32 left_margin; /* time from sync to picture */ __u32 right_margin; /* time from picture to sync */ __u32 upper_margin; /* time from sync to picture */ __u32 lower_margin; __u32 hsync_len; /* length of horizontal sync */ 水平可视区域 __u32 vsync_len; /* length of vertical sync */ 垂直可视区域 __u32 sync; /* see FB_SYNC_* */ __u32 vmode; /* see FB_VMODE_* */ __u32 reserved[6]; /* Reserved for future compatibility */ 备用－以后开发 }; 2) fb_fix_screeninfon 这个结构在显卡被设定模式后创建，它描述显示卡的属性，并且系统运行时不能被修改；比如 FrameBuffer 内 存的起始地址。它依赖于被设定的模式，当一个模式被设定后，内存信息由显示卡硬件给出，内存的位置等信息就 不可以修改。 struct fb_fix_screeninfo { char id[16]; /* identification string eg "TT Builtin" */ID unsigned long smem_start; /* Start of frame buffer mem */ 内存起始 /* (physical address) */ 物理地址 __u32 smem_len; /* Length of frame buffer mem */ 内存大小 __u32 type; /* see FB_TYPE_* */__u32 type_aux; /* Interleave for interleaved Planes */插入区域？ __u32 visual; /* see FB_VISUAL_* */ __u16 xpanstep; /* zero if no hardware panning */没有硬件设备就为零 __u16 ypanstep; /* zero if no hardware panning */ __u16 ywrapstep; /* zero if no hardware ywrap */ __u32 line_length; /* length of a line in bytes */ 一行的字节表示 unsigned long mmio_start; /* Start of Memory Mapped I/O */内存映射的 I/O 起始 /* (physical address) */ __u32 mmio_len; /* Length of Memory Mapped I/O */ I/O 的大小 __u32 accel; /* Type of acceleration available */ 可用的加速类型 __u16 reserved[3]; /* Reserved for future compatibility */ }; Mtkfb_device 结构定义如下： 结构定义如下： struct mtkfb_device { int state; void *fb_va_base; dma_addr_t fb_pa_base;
/* MPU virtual address */ /* Bus physical address */
unsigned long
fb_size_in_byte;
unsigned long layer_enable; MTK_FB_FORMAT layer_format[HW_OVERLAY_COUNT]; unsigned int layer_config_dirty; int u32 xscale, yscale, mirror; pseudo_palette[17]; /* transformations. rotate is stored in fb_info->var */
struct fb_info *fb_info; struct device *dev; };
/* Linux fbdev framework data */
六、 uBoot 阶段 Mt6573_board.c 中， board_init 函数执行硬件先期初始化工作， 它调用 mt65xx_disp_init 函数(Mt6573_disp_drv.c)。 board_init — — mt65xx_disp_init — — DISP_Init — — disp_drv_init_context — — DISP_DetectDevice — — disp_drv_get_lcm_driver——lcm_driver_list[ ] disp_drv_init_context——DISP_GetDriverDPI / DISP_GetDriverDBI / DISP_GetDriverDSI DISP_GetDriverDPI (mt6573_disp_drv_dpi.c) — — DPI_DISP_DRV. dpi_init — — init_dpi — — DPI_Init （Mt6573_dpi_drv.c） DISP_GetDriverDBI (mt6573_disp_drv_dbi.c) — — DBI_DISP_DRV. dbi_init — — init_lcd — — LCD_xxx （Mt6573_lcd_drv.c） DISP_GetDriverDSI (mt6573_disp_drv_dsi.c)——DSI_DISP_DRV. dsi_init——init_lcd， init_dsi——DSI_Init （Mt6573_dsi_drv.c） DISP_Init—— ——LCD_Init (Mt6573_lcd_drv.c) —— DISP_UpdateScreen——LCD_StartTransfer (Mt6573_lcd_drv.c) 七、 背光控制 Cust_leds.c 中定义了 cust_mt65xx_led 类型的数组 cust_led_list[]，列出了平台的所有 led 设备，包括不同颜色 的 led 灯，轨迹球、键盘、按键、LCD 等的背光灯。不同 led 设备可以有各自不同的背光控制方式，比如 PWM （脉冲宽度调制）方式，GPIO 方式，PMIC 方式，用户自定义方式等。如下所示： static struct cust_mt65xx_led cust_led_list[MT65XX_LED_TYPE_TOTAL] = { {"red" MT65XX_LED_MODE_PWM, PWM3}, {"green" MT65XX_LED_MODE_PWM, PWM2}, {"blue" MT65XX_LED_MODE_PWM, PWM1}, {"jogball-backlight" MT65XX_LED_MODE_NONE, -1}, {"keyboard-backlight" MT65XX_LED_MODE_NONE, -1}, {"button-backlight" MT65XX_LED_MODE_PWM, PWM7}, {"lcd-backlight" MT65XX_LED_MODE_CUST, (int)Cust_SetBacklight}, }; 这 个 数 组 通 过 get_cust_led_list 函 数 被 mt65xx_leds_probe 调 用 ， 传 递 给 mt65xx_leds_driver ， 并 且 mt65xx_leds_probe 将数组中的设备一一注册。(\mediatek\source\kernel\drivers\leds\ leds.c) static struct platform_driver mt65xx_leds_driver = { .driver ={ .name = "leds-mt65xx" .owner = THIS_MODULE, }, .probe = mt65xx_leds_probe,
.remove //.suspend .shutdown };
= mt65xx_leds_remove, = mt65xx_leds_suspend, = mt65xx_leds_shutdown,
static struct platform_device mt65xx_leds_device = { .name = "leds-mt65xx" .id = -1 }; 以 lcd-backlight 为例， 其控制方式为自定义， 背光控制 IC 为 SN3228B， 控制函数为 Cust_SetBacklight。 MT6573 的 GPIO49 作为控制脚，连接到 SN3228B 的 EN/SET 脚。该引脚对收到的上升沿脉冲计数（1～14 个） ，调整 自己的输出电流，从而控制 Leds 的亮度。所以 Cust_SetBacklight 根据要达到的亮度 level，在 GPIO49 上输出 对应数量的上升沿脉冲，时间特性需满足 SN3228 的定义。 如果采用 PWM 控制方式，则需要使用 MT6573 的 PWM controller。函数 led_set_pwm 实现了用 PWM 控制 led 灯的亮、灭、闪烁时对 PWM controller 相关寄存器的配置；函数 backlight_set_pwm 实现了用 PWM 控制 lcd backlight 时对 PWM controller 相关寄存器的配置，随 lcd-backlight brightness level 不同，相应的 PWM 脚输出 对应数量的脉冲（level：0～64） mt65xx_led_set_cust 根据不同的控制方式，调用相应的配置函数，如下： MT65XX_LED_MODE_PWM: backlight_set_pwm / led_set_pwm MT65XX_LED_MODE_CUST: Cust_SetBacklight MT65XX_LED_MODE_GPIO: brightness_set_gpio MT65XX_LED_MODE_PMIC: brightness_set_pmic mt65xx_leds_probe 为 cust_led_list[]中的每个 led 设备初始化一个任务队列， 任务处理函数为 mt65xx_led_work， 它再调用 mt65xx_led_set_cust 实现控制。每个 led 设备的亮度设置(brightness_set)函数为 mt65xx_led_set，它对 lcd-backlight 设备直接调用 mt65xx_led_set_cust，对其他设备则用任务队列调度。 Uboot 阶段，其函数调用及 led 和 backlight 控制方式与启动后基本相同。增加了各种充电状态下对红、绿、 蓝 led 的控制。如下是 backlight 的调用关系： （mt65xx_leds.c） mt65xx_backlight_on——mt65xx_leds_brightness_set(MT65XX_LED_TYPE_LCD, LED_FULL) ——mt65xx_led_set_cust——brightness_set_pwm / Cust_SetBacklight
//DBI or DPI should select IO mode according to chip spec
LCM_TYPE 定义 LCM 与 HOST 间的接口，主要分为 3 种，DBI, DPI, DSI。其中 DBI 又分为 parallel DBI 和 serial DBI。 parallel DBI 型 DBI） （B 的命令和数据都在数据总线 D[17:0]上传输。 CSX 为低时数据有效。 WRX 线控制 D[17:0] 为写时序，RDX 控制 D[17:0]为读时序。D/CX 指示 D[17:0]上传输的是命令还是数据。注：MT6573 使用 LPA0 线作为 D/CX 线，LPCE 线作为 CSX 线，LWRB 线作为 WRX 线，LRDB 线作为 RDX 线。
serial DBI（C 型 DBI）的命令和数据都在 SPI 接口上传输。CSX 为低时 SDA 有效。SCL 提供时钟，DIN 输入， DOUT 输出。当 SDA_EN=1 时，DIN 线成为双向的 SDA 线，即可输入又可输出，DOUT 线不用。C 型 DBI 分为 3 线(没有 D/CX 线)和 4 线（有 D/CX 线）两种。3 线的使用一个 D/CX bit 来区分命令/数据，4 线的使用 D/CX 线来区分命令/数据。注：MT6573 使用 LSA0 线作为 D/CX 线，LSCE 线作为 CSX 线。LSCK 线作为 SCL 线，LSDA 线
作为 SDA 线。
DPI 的命令在 SPI 上传输， Pixel data(RGB data)在 D[17:0]上传输。 其命令传输方式与 serial DBI 相同。 对于 Pixel data(RGB data)， 需要自己的 4 条控制线： DPICK_PIN(RGB 时钟) 、 DPIDE_PIN （RGB 数据有效） DPIVSYNC(场 、 同步)、 DPIHSYNC(行同步) 。 typedef enum { LCM_CTRL_NONE = 0, LCM_CTRL_SERIAL_DBI, LCM_CTRL_PARALLEL_DBI, LCM_CTRL_GPIO } LCM_CTRL 定义 LCM 与 HOST 之间传递 command 的方式，有 SERIAL_DBI、PARALLEL_DBI、GPIO 几种 控制方式。如果是 DPI 接口，其 LCM_CTRL 可以选择 SERIAL_DBI 或者 GPIO。 Width 和 height 定义 LCM 的宽度和高度。 io_select_mode 有 这 些 选 项 ： 0 （ LCD_IO_SEL_16CPU_24RGB ） 1 （ LCD_IO_SEL_18CPU_18RGB ） 2 ， ， （LCD_IO_SEL_24CPU_8RGB） ，3（LCD_IO_SEL_24CPU_ONLY） 。根据 driver IC 的定义填写。 LCM_×××_PARAMS 根据不同的 LCM_TYPE 取值，这是针对 DBI/DPI/DSI 接口类型的详细参数定义。比如 LCM_DPI_PARAMS 定义如下： typedef struct { unsigned int mipi_pll_clk_ref; // 0..1 unsigned int mipi_pll_clk_div1; // 0..63 unsigned int mipi_pll_clk_div2; // 0..15 unsigned int dpi_clk_div; // 2..32
unsigned int dpi_clk_duty; /* polarity parameters */ LCM_POLARITY clk_pol; LCM_POLARITY de_pol; LCM_POLARITY vsync_pol; LCM_POLARITY hsync_pol; /* timing parameters */ unsigned int hsync_pulse_width; unsigned int hsync_back_porch; unsigned int hsync_front_porch; unsigned int vsync_pulse_width; unsigned int vsync_back_porch; unsigned int vsync_front_porch;
// (dpi_clk_div - 1) .. 31
/* output format parameters */ LCM_DPI_FORMAT format; LCM_COLOR_ORDER rgb_order; unsigned int is_serial_output; /* intermediate buffers parameters */ unsigned int intermediat_buffer_num; // 2..3 /* iopad parameters */ LCM_DRIVING_CURRENT io_driving_current; } LCM_DPI_PARAMS; 其中，第一段前 4 项用于控制 DPI 时钟，计算公式如下： Pixel Clock Frequency = 26MHz * mipi_pll_clk_div1 / (mipi_pll_clk_ref + 1)/ (2 * mipi_pll_clk_div2)/ dpi_clk_div 第二段 4 个参数设置 DPICK_PIN(RGB 时钟) 、DPIDE_PIN（RGB 数据有效） DPIVSYNC(场同步)、 、 DPIHSYNC(行同步)线是上升沿还是下降沿有效。 行同步脉冲开始前和开始后的几个时钟周期，是行信号消隐期；场同步开始前和开始后的几个行周期，是场信 号 消 隐 期 。 消 隐 期 不 传 递 图 像 信 号 。 消 隐 期 特 性 由 第 三 段 六 个 参 数 定 义 ： hsync_pulse_width; hsync_back_porch; hsync_front_porch;vsync_pulse_width; vsync_back_porch; vsync_front_porch; LCM_DPI_FORMAT 指定每个像素中 RGB 各占几个 bit. LCM_COLOR_ORDER 指定 RGB 的顺序。 上述参数的值，均依照 LCM spec 及驱动 IC datasheet 中的定义。 这里要说说一个特别之处。NT35510 使用 DPI 接口，SERIAL_DBI ctrl 方式时，没有 D/CX 线，datasheet 上定 义的传输方式是 9 bits，即在数据 byte 前加个 D/CX bit。但使用了 NT35510 的 LCM——LF040DNYB16a，其 spec 中却另外定义了其串口使用 16 bits 模式传输。Byte1 是标志 byte, 前 3 位分别为 R/W bit, D/CX bit, High/Low bit； Byte2 则是命令或数据。 NT35510 的每个 command 长度为 2byte， 还可能带有若干 bytes 的参数， 0x40 0xAA。 比如命令 F001,参数 AA，应该这样传输：0x20 0xF0 0x00 0x01 的初始化，包括如下步骤： （2）lcm_init 主要实现 LCM 的初始化，包括如下步骤： ） config_gpio——配置 GPIO。
发送 reset 信号。RESET pin low 和 RESET pin high 需要持续的时间一般为若干 ms, 以 datasheet 为准。 init_lcm_registers——初始化 LCM 的寄存器。具体可以厂家提供的初始代码为参考。一般在此函数末尾， 都会使用唤醒命令组（见后文） ，使 LCM 进入工作状态。 （3）lcm_suspend 使 LCM 休眠，使用特定的命令，并遵守 datasheet 定义的时间特性。常用命令组如下： 休眠， ） 0X2800 (or 0X28) —— set display off 0X1000 (or 0X10) —— enter sleep mode 对 nt35510 而言，还有一种更深睡眠的状态——deep standby mode，使用如下命令进入： 0X4F00 0X01 苏醒， （4）lcm_resume 使 LCM 苏醒，使用特定的命令，并遵守 datasheet 定义的时间特性。 ） 唤醒命令组： 0X1100 (or 0X11) —— exit sleep mode 0X2900 (or 0X29) —— set display on 对 nt35510 而言，如果在 lcm_suspend 中使 LCM enter deep standby mode，则不能使用唤醒命令组，需要使 用 reset 信号并要重新 init_lcm_registers。 四、 驱动 nt35510_lcm_drv 怎样被上层使用 Mtkfb.c 中实现了 LCM 的 platform driver： static struct platform_driver mtkfb_driver = { .driver = { .name = “mtk-fb”, .bus = &platform_bus_type, .probe = mtkfb_probe, .remove = mtkfb_remove, .suspend = mtkfb_suspend, .resume = mtkfb_resume, }, }; mtkfb_probe 会 调 用 函数 mtkfb_find_lcm_driver 来 发 现 LCM 的 硬 件层驱 动 。 mtkfb_find_lcm_driver— — DISP_SelectDevice——disp_drv_get_lcm_driver，检查 lcm_driver_list[], 得到当前使用的 LCM 及其驱动名称。
Mt6573_devs.c 中，定义了 framebuffer 型的 platform device，这个设备在 mt6573_board_init()调用时被注册。它 所对应的驱动就是上文提到的 mtkfb_driver static struct platform_device mt6573_device_fb = { .name = "mtkfb" .id = 0, .num_resources = ARRAY_SIZE(resource_fb), .resource = resource_fb, .dev = { .dma_mask = &mtkfb_dmamask, .coherent_dma_mask = 0xffffffff, }, }; 在 linux 内核中 lcd 设备驱动所使用的是 framebuffer 设备类型，framebuffer 设备驱动程序的核心数据结构是 fb_ops；用户空间就是通过此结构体，调用其中的函数来对 LCD 实现控制。Mtkfb.c 中定义并实现了 fb_ops 类型的 mtkfb_ops 。 一 个 使 用 mtkfb_ops 的 例 子 见 \mediatek\source\kernel\drivers\gpu\pvr\services4\3rdparty\mtklfb\ mtklfb_displayclass.c。
static struct fb_ops mtkfb_ops = { .owner = THIS_MODULE, .fb_open = mtkfb_open, .fb_release = mtkfb_release, .fb_setcolreg = mtkfb_setcolreg, .fb_pan_display = mtkfb_pan_display_proxy, .fb_fillrect = cfb_fillrect, .fb_copyarea = cfb_copyarea, .fb_imageblit = cfb_imageblit, .fb_cursor = mtkfb_soft_cursor, .fb_check_var = mtkfb_check_var, .fb_set_par = mtkfb_set_par, .fb_ioctl = mtkfb_ioctl, };
//批量配置颜色参数 //虚拟屏幕内容显示 //填充区域显示 //复制区域显示 //显示图象 //光标显示 //检查并配置 fb_var_screeninfo 参数 //change display mode and set parameter //特定 ioctl 配置 LCD 屏幕特性
五、 Frame Buffer 设备驱动 mtkfb_driver 中的各个函数会调用到 DISP_xxx 函数（DISP_drv.c）,而 DISP_xxx 会调用到 LCD_xxx 函数 （lcd_drv.c）以及 LCM 硬件层驱动。 mtkfb_probe 的主要工作如下： * find lcm driver * Register interrupt handler (call back function), Init screen update wait queue, create screen update kThread * Allocate and initialize frame buffer device (fb_info , mtkfb_device), select panel type according to machine type * Initialize Display Driver PDD Layer (DISP_init) * Initialize fb_info struct (mtkfb_fbinfo_init) * Register mtkfb_device fs to system (mtkfb_register_sysfs) * Register fb_info to system (register_framebuffer) fb_info 结构定义如下 结构定义如下： struct fb_info { int node; int flags; struct mutex lock; /* Lock for open/release/ioctl funcs */ struct mutex mm_lock; /* Lock for fb_mmap and smem_* fields */ struct fb_var_screeninfo var;/* Current var */ struct fb_fix_screeninfo fix; /* Current fix */ struct fb_monspecs monspecs; /* Current Monitor specs */ struct work_struct queue; /* Framebuffer event queue */ struct fb_pixmap pixmap; /* Image hardware mapper */ struct fb_pixmap sprite; /* Cursor hardware mapper */ struct fb_cmap cmap; /* Current cmap */ struct list_head modelist; /* mode list */ struct fb_videomode *mode; /* current mode */ #ifdef CONFIG_FB_BACKLIGHT struct backlight_device *bl_dev; struct mutex bl_curve_mutex; u8 bl_curve[FB_BACKLIGHT_LEVELS]; #endif
#ifdef CONFIG_FB_DEFERRED_IO struct delayed_work deferred_work; struct fb_deferred_io *fbdefio; #endif struct fb_ops *fbops; struct device *device; /* This is the parent */ struct device *dev; /* This is this fb device */ int class_flag; /* private sysfs flags */ #ifdef CONFIG_FB_TILEBLITTING struct fb_tile_ops *tileops; /* Tile Blitting */ #endif char __iomem *screen_base; /* Virtual address */ unsigned long screen_size; /* Amount of ioremapped VRAM or 0 */ void *pseudo_palette; /* Fake palette of 16 colors */ #define FBINFO_STATE_RUNNING 0 #define FBINFO_STATE_SUSPENDED 1 u32 state; /* Hardware state i.e suspend */ void *fbcon_par; /* fbcon use-only private area */ /* From here on everything is device dependent */ void *par; struct apertures_struct { unsigned int count; struct aperture { resource_size_t base; resource_size_t size; } ranges[0]; } *apertures; }; 1）fb_var_screeninfo ） 这个结构描述了显示卡的特性： NOTE: __u32 是表示 unsigned 不带符号的 32 bits 的数据类型，其余类推。这是 Linux 内核中所用到的数 据类型，如果是开发用户空间（user-space）的程序，可以根据具体计算机平台的情况，用 unsigned long 等等来代 替 struct fb_var_screeninfo { __u32 xres; /* visible resolution */ //可视区域 __u32 yres; __u32 xres_virtual; /* virtual resolution */ //可视区域 __u32 yres_virtual; __u32 xoffset; /* offset from virtual to visible resolution */ //可视区域的偏移 __u32 yoffset; __u32 bits_per_pixel; /* guess what */ //每一象素的 bit 数 __u32 grayscale; /* != 0 Gray levels instead of colors *///等于零就成黑白 struct fb_bitfield red; /* bitfield in fb mem if true color, */真彩的 bit 机构 struct fb_bitfield green; /* else only length is significant */
struct fb_bitfield blue; struct fb_bitfield transp; /* transparency */ 透明 __u32 nonstd; /* != 0 Non standard pixel format */ 不是标准格式 __u32 activate; /* see FB_ACTIVATE_* */ __u32 height; /* height of picture in mm */ 内存中的图像高度 __u32 width; /* width of picture in mm */ 内存中的图像宽度 __u32 accel_flags; /* acceleration flags (hints) */ 加速标志 /* Timing: All values in pixclocks, except pixclock (of course) */ 时序-_-这些部分就是显示器的显示方法了，可以找相关的资料看看 __u32 pixclock; /* pixel clock in ps (pico seconds) */ __u32 left_margin; /* time from sync to picture */ __u32 right_margin; /* time from picture to sync */ __u32 upper_margin; /* time from sync to picture */ __u32 lower_margin; __u32 hsync_len; /* length of horizontal sync */ 水平可视区域 __u32 vsync_len; /* length of vertical sync */ 垂直可视区域 __u32 sync; /* see FB_SYNC_* */ __u32 vmode; /* see FB_VMODE_* */ __u32 reserved[6]; /* Reserved for future compatibility */ 备用－以后开发 }; 2) fb_fix_screeninfon 这个结构在显卡被设定模式后创建，它描述显示卡的属性，并且系统运行时不能被修改；比如 FrameBuffer 内 存的起始地址。它依赖于被设定的模式，当一个模式被设定后，内存信息由显示卡硬件给出，内存的位置等信息就 不可以修改。 struct fb_fix_screeninfo { char id[16]; /* identification string eg "TT Builtin" */ID unsigned long smem_start; /* Start of frame buffer mem */ 内存起始 /* (physical address) */ 物理地址 __u32 smem_len; /* Length of frame buffer mem */ 内存大小 __u32 type; /* see FB_TYPE_* */__u32 type_aux; /* Interleave for interleaved Planes */插入区域？ __u32 visual; /* see FB_VISUAL_* */ __u16 xpanstep; /* zero if no hardware panning */没有硬件设备就为零 __u16 ypanstep; /* zero if no hardware panning */ __u16 ywrapstep; /* zero if no hardware ywrap */ __u32 line_length; /* length of a line in bytes */ 一行的字节表示 unsigned long mmio_start; /* Start of Memory Mapped I/O */内存映射的 I/O 起始 /* (physical address) */ __u32 mmio_len; /* Length of Memory Mapped I/O */ I/O 的大小 __u32 accel; /* Type of acceleration available */ 可用的加速类型 __u16 reserved[3]; /* Reserved for future compatibility */ }; Mtkfb_device 结构定义如下： 结构定义如下： struct mtkfb_device { int state; void *fb_va_base; dma_addr_t fb_pa_base;
/* MPU virtual address */ /* Bus physical address */
unsigned long
fb_size_in_byte;
unsigned long layer_enable; MTK_FB_FORMAT layer_format[HW_OVERLAY_COUNT]; unsigned int layer_config_dirty; int u32 xscale, yscale, mirror; pseudo_palette[17]; /* transformations. rotate is stored in fb_info->var */
struct fb_info *fb_info; struct device *dev; };
/* Linux fbdev framework data */
六、 uBoot 阶段 Mt6573_board.c 中， board_init 函数执行硬件先期初始化工作， 它调用 mt65xx_disp_init 函数(Mt6573_disp_drv.c)。 board_init — — mt65xx_disp_init — — DISP_Init — — disp_drv_init_context — — DISP_DetectDevice — — disp_drv_get_lcm_driver——lcm_driver_list[ ] disp_drv_init_context——DISP_GetDriverDPI / DISP_GetDriverDBI / DISP_GetDriverDSI DISP_GetDriverDPI (mt6573_disp_drv_dpi.c) — — DPI_DISP_DRV. dpi_init — — init_dpi — — DPI_Init （Mt6573_dpi_drv.c） DISP_GetDriverDBI (mt6573_disp_drv_dbi.c) — — DBI_DISP_DRV. dbi_init — — init_lcd — — LCD_xxx （Mt6573_lcd_drv.c） DISP_GetDriverDSI (mt6573_disp_drv_dsi.c)——DSI_DISP_DRV. dsi_init——init_lcd， init_dsi——DSI_Init （Mt6573_dsi_drv.c） DISP_Init—— ——LCD_Init (Mt6573_lcd_drv.c) —— DISP_UpdateScreen——LCD_StartTransfer (Mt6573_lcd_drv.c) 七、 背光控制 Cust_leds.c 中定义了 cust_mt65xx_led 类型的数组 cust_led_list[]，列出了平台的所有 led 设备，包括不同颜色 的 led 灯，轨迹球、键盘、按键、LCD 等的背光灯。不同 led 设备可以有各自不同的背光控制方式，比如 PWM （脉冲宽度调制）方式，GPIO 方式，PMIC 方式，用户自定义方式等。如下所示： static struct cust_mt65xx_led cust_led_list[MT65XX_LED_TYPE_TOTAL] = { {"red" MT65XX_LED_MODE_PWM, PWM3}, {"green" MT65XX_LED_MODE_PWM, PWM2}, {"blue" MT65XX_LED_MODE_PWM, PWM1}, {"jogball-backlight" MT65XX_LED_MODE_NONE, -1}, {"keyboard-backlight" MT65XX_LED_MODE_NONE, -1}, {"button-backlight" MT65XX_LED_MODE_PWM, PWM7}, {"lcd-backlight" MT65XX_LED_MODE_CUST, (int)Cust_SetBacklight}, }; 这 个 数 组 通 过 get_cust_led_list 函 数 被 mt65xx_leds_probe 调 用 ， 传 递 给 mt65xx_leds_driver ， 并 且 mt65xx_leds_probe 将数组中的设备一一注册。(\mediatek\source\kernel\drivers\leds\ leds.c) static struct platform_driver mt65xx_leds_driver = { .driver ={ .name = "leds-mt65xx" .owner = THIS_MODULE, }, .probe = mt65xx_leds_probe,
.remove //.suspend .shutdown };
= mt65xx_leds_remove, = mt65xx_leds_suspend, = mt65xx_leds_shutdown,
static struct platform_device mt65xx_leds_device = { .name = "leds-mt65xx" .id = -1 }; 以 lcd-backlight 为例， 其控制方式为自定义， 背光控制 IC 为 SN3228B， 控制函数为 Cust_SetBacklight。 MT6573 的 GPIO49 作为控制脚，连接到 SN3228B 的 EN/SET 脚。该引脚对收到的上升沿脉冲计数（1～14 个） ，调整 自己的输出电流，从而控制 Leds 的亮度。所以 Cust_SetBacklight 根据要达到的亮度 level，在 GPIO49 上输出 对应数量的上升沿脉冲，时间特性需满足 SN3228 的定义。 如果采用 PWM 控制方式，则需要使用 MT6573 的 PWM controller。函数 led_set_pwm 实现了用 PWM 控制 led 灯的亮、灭、闪烁时对 PWM controller 相关寄存器的配置；函数 backlight_set_pwm 实现了用 PWM 控制 lcd backlight 时对 PWM controller 相关寄存器的配置，随 lcd-backlight brightness level 不同，相应的 PWM 脚输出 对应数量的脉冲（level：0～64） mt65xx_led_set_cust 根据不同的控制方式，调用相应的配置函数，如下： MT65XX_LED_MODE_PWM: backlight_set_pwm / led_set_pwm MT65XX_LED_MODE_CUST: Cust_SetBacklight MT65XX_LED_MODE_GPIO: brightness_set_gpio MT65XX_LED_MODE_PMIC: brightness_set_pmic mt65xx_leds_probe 为 cust_led_list[]中的每个 led 设备初始化一个任务队列， 任务处理函数为 mt65xx_led_work， 它再调用 mt65xx_led_set_cust 实现控制。每个 led 设备的亮度设置(brightness_set)函数为 mt65xx_led_set，它对 lcd-backlight 设备直接调用 mt65xx_led_set_cust，对其他设备则用任务队列调度。 Uboot 阶段，其函数调用及 led 和 backlight 控制方式与启动后基本相同。增加了各种充电状态下对红、绿、 蓝 led 的控制。如下是 backlight 的调用关系： （mt65xx_leds.c） mt65xx_backlight_on——mt65xx_leds_brightness_set(MT65XX_LED_TYPE_LCD, LED_FULL) ——mt65xx_led_set_cust——brightness_set_pwm / Cust_SetBacklight
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
