blob: ab5614ad0e3dbfc10bc673c23e7828383a1efa16 [file] [log] [blame]
Tom Rini10e47792018-05-06 17:58:06 -04001// SPDX-License-Identifier: GPL-2.0+
wdenk9ca7bbc2004-10-09 23:25:58 +00002/*
Nikita Kiryanovf54c0262015-02-03 13:32:29 +02003 * Common LCD routines
wdenk9ca7bbc2004-10-09 23:25:58 +00004 *
5 * (C) Copyright 2001-2002
6 * Wolfgang Denk, DENX Software Engineering -- wd@denx.de
wdenk9ca7bbc2004-10-09 23:25:58 +00007 */
8
wdenk9ca7bbc2004-10-09 23:25:58 +00009/* #define DEBUG */
wdenk9ca7bbc2004-10-09 23:25:58 +000010#include <config.h>
11#include <common.h>
12#include <command.h>
Simon Glass63334482019-11-14 12:57:39 -070013#include <cpu_func.h>
Nikita Kiryanov2f3e2ca2013-02-24 21:28:43 +000014#include <env_callback.h>
Simon Glass0f2af882020-05-10 11:40:05 -060015#include <log.h>
Simon Glass274e0b02020-05-10 11:39:56 -060016#include <asm/cache.h>
Simon Glass97589732020-05-10 11:40:02 -060017#include <init.h>
Simon Glass3ba929a2020-10-30 21:38:53 -060018#include <asm/global_data.h>
wdenk9ca7bbc2004-10-09 23:25:58 +000019#include <linux/types.h>
Jean-Christophe PLAGNIOL-VILLARD2a7a0312009-05-16 12:14:54 +020020#include <stdio_dev.h>
wdenk9ca7bbc2004-10-09 23:25:58 +000021#include <lcd.h>
Joe Hershberger65b905b2015-03-22 17:08:59 -050022#include <mapmem.h>
wdenkbc3202a2005-04-03 23:11:38 +000023#include <watchdog.h>
Przemyslaw Marczakc3bf15e2014-01-22 11:24:13 +010024#include <asm/unaligned.h>
Robert Winkler2a90ed02013-06-17 11:31:29 -070025#include <splash.h>
Simon Glassb9ddbf42014-02-27 13:26:19 -070026#include <asm/io.h>
27#include <asm/unaligned.h>
Nikita Kiryanovf54c0262015-02-03 13:32:29 +020028#include <video_font.h>
Robert Winkler2a90ed02013-06-17 11:31:29 -070029
wdenk2b9d1862005-07-04 00:03:16 +000030#ifdef CONFIG_LCD_LOGO
Nikita Kiryanovf54c0262015-02-03 13:32:29 +020031#include <bmp_logo.h>
32#include <bmp_logo_data.h>
33#if (CONSOLE_COLOR_WHITE >= BMP_LOGO_OFFSET) && (LCD_BPP != LCD_COLOR16)
34#error Default Color Map overlaps with Logo Color Map
35#endif
wdenk2b9d1862005-07-04 00:03:16 +000036#endif
wdenk9ca7bbc2004-10-09 23:25:58 +000037
Simon Glass599a4df2012-10-17 13:24:54 +000038#ifndef CONFIG_LCD_ALIGNMENT
39#define CONFIG_LCD_ALIGNMENT PAGE_SIZE
40#endif
41
Nikita Kiryanov6c8cf8d2014-12-08 17:14:42 +020042#if (LCD_BPP != LCD_COLOR8) && (LCD_BPP != LCD_COLOR16) && \
43 (LCD_BPP != LCD_COLOR32)
Nikita Kiryanovf54c0262015-02-03 13:32:29 +020044#error Unsupported LCD BPP.
Jeroen Hofsteecdc348a2013-01-12 12:07:59 +000045#endif
46
Wolfgang Denk6405a152006-03-31 18:32:53 +020047DECLARE_GLOBAL_DATA_PTR;
wdenk9ca7bbc2004-10-09 23:25:58 +000048
Nikita Kiryanov1f828412012-05-24 01:42:38 +000049static int lcd_init(void *lcdbase);
Nikita Kiryanov1ae13d32015-02-03 13:32:32 +020050static void lcd_logo(void);
Nikita Kiryanov1f828412012-05-24 01:42:38 +000051static void lcd_setfgcolor(int color);
52static void lcd_setbgcolor(int color);
wdenk9ca7bbc2004-10-09 23:25:58 +000053
Wolfgang Denk67f53912013-01-05 09:45:48 +000054static int lcd_color_fg;
55static int lcd_color_bg;
Jeroen Hofsteeb9092e62013-01-22 10:44:11 +000056int lcd_line_length;
wdenk9ca7bbc2004-10-09 23:25:58 +000057char lcd_is_enabled = 0;
Jeroen Hofstee881c4ec2013-01-22 10:44:12 +000058static void *lcd_base; /* Start of framebuffer memory */
Simon Glassef45ffd2012-10-30 13:40:18 +000059static char lcd_flush_dcache; /* 1 to flush dcache after each lcd update */
wdenk9ca7bbc2004-10-09 23:25:58 +000060
Simon Glassef45ffd2012-10-30 13:40:18 +000061/* Flush LCD activity to the caches */
62void lcd_sync(void)
63{
64 /*
65 * flush_dcache_range() is declared in common.h but it seems that some
66 * architectures do not actually implement it. Is there a way to find
67 * out whether it exists? For now, ARM is safe.
68 */
Trevor Woerner43ec7e02019-05-03 09:41:00 -040069#if defined(CONFIG_ARM) && !CONFIG_IS_ENABLED(SYS_DCACHE_OFF)
Simon Glassef45ffd2012-10-30 13:40:18 +000070 int line_length;
71
72 if (lcd_flush_dcache)
Alexander Grafd2dc92e2016-03-16 15:41:22 +010073 flush_dcache_range((ulong)lcd_base,
74 (ulong)(lcd_base + lcd_get_size(&line_length)));
Simon Glassef45ffd2012-10-30 13:40:18 +000075#endif
76}
77
78void lcd_set_flush_dcache(int flush)
79{
80 lcd_flush_dcache = (flush != 0);
81}
82
Simon Glass0d1e1f72014-07-23 06:54:59 -060083static void lcd_stub_putc(struct stdio_dev *dev, const char c)
84{
85 lcd_putc(c);
86}
87
Simon Glass0d1e1f72014-07-23 06:54:59 -060088static void lcd_stub_puts(struct stdio_dev *dev, const char *s)
89{
90 lcd_puts(s);
91}
92
Nikita Kiryanovf54c0262015-02-03 13:32:29 +020093/* Small utility to check that you got the colours right */
wdenk9ca7bbc2004-10-09 23:25:58 +000094#ifdef LCD_TEST_PATTERN
95
Andreas Neubacher9f9b56a2016-01-21 13:06:32 +010096#if LCD_BPP == LCD_COLOR8
wdenk9ca7bbc2004-10-09 23:25:58 +000097#define N_BLK_VERT 2
98#define N_BLK_HOR 3
99
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000100static int test_colors[N_BLK_HOR * N_BLK_VERT] = {
wdenk9ca7bbc2004-10-09 23:25:58 +0000101 CONSOLE_COLOR_RED, CONSOLE_COLOR_GREEN, CONSOLE_COLOR_YELLOW,
102 CONSOLE_COLOR_BLUE, CONSOLE_COLOR_MAGENTA, CONSOLE_COLOR_CYAN,
Andreas Neubacher9f9b56a2016-01-21 13:06:32 +0100103}; /*LCD_BPP == LCD_COLOR8 */
104
105#elif LCD_BPP == LCD_COLOR16
106#define N_BLK_VERT 2
107#define N_BLK_HOR 4
108
109static int test_colors[N_BLK_HOR * N_BLK_VERT] = {
110 CONSOLE_COLOR_RED, CONSOLE_COLOR_GREEN, CONSOLE_COLOR_YELLOW, CONSOLE_COLOR_BLUE,
111 CONSOLE_COLOR_MAGENTA, CONSOLE_COLOR_CYAN, CONSOLE_COLOR_GREY, CONSOLE_COLOR_WHITE,
wdenk9ca7bbc2004-10-09 23:25:58 +0000112};
Andreas Neubacher9f9b56a2016-01-21 13:06:32 +0100113#endif /*LCD_BPP == LCD_COLOR16 */
wdenk9ca7bbc2004-10-09 23:25:58 +0000114
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000115static void test_pattern(void)
wdenk9ca7bbc2004-10-09 23:25:58 +0000116{
117 ushort v_max = panel_info.vl_row;
118 ushort h_max = panel_info.vl_col;
119 ushort v_step = (v_max + N_BLK_VERT - 1) / N_BLK_VERT;
120 ushort h_step = (h_max + N_BLK_HOR - 1) / N_BLK_HOR;
121 ushort v, h;
Andreas Neubacher9f9b56a2016-01-21 13:06:32 +0100122#if LCD_BPP == LCD_COLOR8
wdenk9ca7bbc2004-10-09 23:25:58 +0000123 uchar *pix = (uchar *)lcd_base;
Andreas Neubacher9f9b56a2016-01-21 13:06:32 +0100124#elif LCD_BPP == LCD_COLOR16
125 ushort *pix = (ushort *)lcd_base;
126#endif
wdenk9ca7bbc2004-10-09 23:25:58 +0000127
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000128 printf("[LCD] Test Pattern: %d x %d [%d x %d]\n",
wdenk9ca7bbc2004-10-09 23:25:58 +0000129 h_max, v_max, h_step, v_step);
130
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000131 for (v = 0; v < v_max; ++v) {
wdenk9ca7bbc2004-10-09 23:25:58 +0000132 uchar iy = v / v_step;
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000133 for (h = 0; h < h_max; ++h) {
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000134 uchar ix = N_BLK_HOR * iy + h / h_step;
wdenk9ca7bbc2004-10-09 23:25:58 +0000135 *pix++ = test_colors[ix];
136 }
137 }
138}
139#endif /* LCD_TEST_PATTERN */
140
Anatolij Gustschinfa50d902013-11-09 11:00:09 +0100141/*
142 * With most lcd drivers the line length is set up
143 * by calculating it from panel_info parameters. Some
144 * drivers need to calculate the line length differently,
145 * so make the function weak to allow overriding it.
146 */
147__weak int lcd_get_size(int *line_length)
Simon Glass599a4df2012-10-17 13:24:54 +0000148{
149 *line_length = (panel_info.vl_col * NBITS(panel_info.vl_bpix)) / 8;
150 return *line_length * panel_info.vl_row;
151}
152
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000153int drv_lcd_init(void)
wdenk9ca7bbc2004-10-09 23:25:58 +0000154{
Jean-Christophe PLAGNIOL-VILLARD2a7a0312009-05-16 12:14:54 +0200155 struct stdio_dev lcddev;
wdenk9ca7bbc2004-10-09 23:25:58 +0000156 int rc;
157
Simon Glassb9ddbf42014-02-27 13:26:19 -0700158 lcd_base = map_sysmem(gd->fb_base, 0);
wdenk9ca7bbc2004-10-09 23:25:58 +0000159
Nikita Kiryanovf54c0262015-02-03 13:32:29 +0200160 lcd_init(lcd_base);
wdenk9ca7bbc2004-10-09 23:25:58 +0000161
162 /* Device initialization */
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000163 memset(&lcddev, 0, sizeof(lcddev));
wdenk9ca7bbc2004-10-09 23:25:58 +0000164
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000165 strcpy(lcddev.name, "lcd");
wdenk9ca7bbc2004-10-09 23:25:58 +0000166 lcddev.ext = 0; /* No extensions */
167 lcddev.flags = DEV_FLAGS_OUTPUT; /* Output only */
Simon Glass0d1e1f72014-07-23 06:54:59 -0600168 lcddev.putc = lcd_stub_putc; /* 'putc' function */
169 lcddev.puts = lcd_stub_puts; /* 'puts' function */
wdenk9ca7bbc2004-10-09 23:25:58 +0000170
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000171 rc = stdio_register(&lcddev);
wdenk9ca7bbc2004-10-09 23:25:58 +0000172
173 return (rc == 0) ? 1 : rc;
174}
175
Che-Liang Chiou2444b172011-10-20 23:07:03 +0000176void lcd_clear(void)
wdenk9ca7bbc2004-10-09 23:25:58 +0000177{
Nikita Kiryanov631d2e12014-12-08 17:14:43 +0200178 int bg_color;
Igor Opaniuk1f6bfad2019-05-29 09:01:43 +0000179 __maybe_unused ulong addr;
Nikita Kiryanov1ae13d32015-02-03 13:32:32 +0200180 static int do_splash = 1;
Nikita Kiryanov5aec5812014-12-08 17:14:38 +0200181#if LCD_BPP == LCD_COLOR8
wdenk9ca7bbc2004-10-09 23:25:58 +0000182 /* Setting the palette */
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000183 lcd_setcolreg(CONSOLE_COLOR_BLACK, 0, 0, 0);
184 lcd_setcolreg(CONSOLE_COLOR_RED, 0xFF, 0, 0);
185 lcd_setcolreg(CONSOLE_COLOR_GREEN, 0, 0xFF, 0);
186 lcd_setcolreg(CONSOLE_COLOR_YELLOW, 0xFF, 0xFF, 0);
187 lcd_setcolreg(CONSOLE_COLOR_BLUE, 0, 0, 0xFF);
188 lcd_setcolreg(CONSOLE_COLOR_MAGENTA, 0xFF, 0, 0xFF);
189 lcd_setcolreg(CONSOLE_COLOR_CYAN, 0, 0xFF, 0xFF);
190 lcd_setcolreg(CONSOLE_COLOR_GREY, 0xAA, 0xAA, 0xAA);
191 lcd_setcolreg(CONSOLE_COLOR_WHITE, 0xFF, 0xFF, 0xFF);
wdenk9ca7bbc2004-10-09 23:25:58 +0000192#endif
193
Jean-Christophe PLAGNIOL-VILLARD03836942008-10-16 15:01:15 +0200194#ifndef CONFIG_SYS_WHITE_ON_BLACK
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000195 lcd_setfgcolor(CONSOLE_COLOR_BLACK);
196 lcd_setbgcolor(CONSOLE_COLOR_WHITE);
Nikita Kiryanov631d2e12014-12-08 17:14:43 +0200197 bg_color = CONSOLE_COLOR_WHITE;
wdenk9ca7bbc2004-10-09 23:25:58 +0000198#else
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000199 lcd_setfgcolor(CONSOLE_COLOR_WHITE);
200 lcd_setbgcolor(CONSOLE_COLOR_BLACK);
Nikita Kiryanov631d2e12014-12-08 17:14:43 +0200201 bg_color = CONSOLE_COLOR_BLACK;
Jean-Christophe PLAGNIOL-VILLARD03836942008-10-16 15:01:15 +0200202#endif /* CONFIG_SYS_WHITE_ON_BLACK */
wdenk9ca7bbc2004-10-09 23:25:58 +0000203
204#ifdef LCD_TEST_PATTERN
205 test_pattern();
206#else
207 /* set framebuffer to background color */
Hannes Petermaier95f87df2014-03-07 18:55:40 +0100208#if (LCD_BPP != LCD_COLOR32)
Nikita Kiryanov631d2e12014-12-08 17:14:43 +0200209 memset((char *)lcd_base, bg_color, lcd_line_length * panel_info.vl_row);
Hannes Petermaier95f87df2014-03-07 18:55:40 +0100210#else
211 u32 *ppix = lcd_base;
212 u32 i;
213 for (i = 0;
214 i < (lcd_line_length * panel_info.vl_row)/NBYTES(panel_info.vl_bpix);
215 i++) {
Nikita Kiryanov631d2e12014-12-08 17:14:43 +0200216 *ppix++ = bg_color;
Hannes Petermaier95f87df2014-03-07 18:55:40 +0100217 }
218#endif
wdenk9ca7bbc2004-10-09 23:25:58 +0000219#endif
Hannes Petermaiera3c8e862015-03-27 08:01:38 +0100220 /* setup text-console */
221 debug("[LCD] setting up console...\n");
222 lcd_init_console(lcd_base,
223 panel_info.vl_col,
224 panel_info.vl_row,
225 panel_info.vl_rot);
wdenk9ca7bbc2004-10-09 23:25:58 +0000226 /* Paint the logo and retrieve LCD base address */
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000227 debug("[LCD] Drawing the logo...\n");
Nikita Kiryanov1ae13d32015-02-03 13:32:32 +0200228 if (do_splash) {
Igor Opaniuk1f6bfad2019-05-29 09:01:43 +0000229 if (splash_display() == 0) {
Nikita Kiryanov1ae13d32015-02-03 13:32:32 +0200230 do_splash = 0;
Igor Opaniuk1f6bfad2019-05-29 09:01:43 +0000231 lcd_sync();
232 return;
Nikita Kiryanov1ae13d32015-02-03 13:32:32 +0200233 }
234 }
235
236 lcd_logo();
237#if defined(CONFIG_LCD_LOGO) && !defined(CONFIG_LCD_INFO_BELOW_LOGO)
238 addr = (ulong)lcd_base + BMP_LOGO_HEIGHT * lcd_line_length;
Marcel Ziswiler39a62072015-08-04 15:49:50 +0200239 lcd_init_console((void *)addr, panel_info.vl_col,
240 panel_info.vl_row, panel_info.vl_rot);
Nikita Kiryanov1ae13d32015-02-03 13:32:32 +0200241#endif
Simon Glassef45ffd2012-10-30 13:40:18 +0000242 lcd_sync();
wdenk9ca7bbc2004-10-09 23:25:58 +0000243}
244
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000245static int lcd_init(void *lcdbase)
wdenk9ca7bbc2004-10-09 23:25:58 +0000246{
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000247 debug("[LCD] Initializing LCD frambuffer at %p\n", lcdbase);
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000248 lcd_ctrl_init(lcdbase);
Anatolij Gustschin02591592013-03-29 14:00:13 +0100249
250 /*
Stephen Warren682b6b52014-11-19 20:41:03 -0700251 * lcd_ctrl_init() of some drivers (i.e. bcm2835 on rpi) ignores
Anatolij Gustschin02591592013-03-29 14:00:13 +0100252 * the 'lcdbase' argument and uses custom lcd base address
253 * by setting up gd->fb_base. Check for this condition and fixup
254 * 'lcd_base' address.
255 */
Simon Glassb9ddbf42014-02-27 13:26:19 -0700256 if (map_to_sysmem(lcdbase) != gd->fb_base)
257 lcd_base = map_sysmem(gd->fb_base, 0);
Anatolij Gustschin02591592013-03-29 14:00:13 +0100258
259 debug("[LCD] Using LCD frambuffer at %p\n", lcd_base);
260
Stephen Warrenefc8f792013-01-29 16:37:38 +0000261 lcd_get_size(&lcd_line_length);
Haavard Skinnemoen7eb8b232008-09-01 16:21:21 +0200262 lcd_is_enabled = 1;
Che-Liang Chiou2444b172011-10-20 23:07:03 +0000263 lcd_clear();
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000264 lcd_enable();
wdenk9ca7bbc2004-10-09 23:25:58 +0000265
266 /* Initialize the console */
Nikita Kiryanov699c05e2014-12-08 17:14:41 +0200267 lcd_set_col(0);
wdenk2b9d1862005-07-04 00:03:16 +0000268#ifdef CONFIG_LCD_INFO_BELOW_LOGO
Nikita Kiryanov699c05e2014-12-08 17:14:41 +0200269 lcd_set_row(7 + BMP_LOGO_HEIGHT / VIDEO_FONT_HEIGHT);
wdenk9ca7bbc2004-10-09 23:25:58 +0000270#else
Nikita Kiryanov699c05e2014-12-08 17:14:41 +0200271 lcd_set_row(1); /* leave 1 blank line below logo */
wdenk9ca7bbc2004-10-09 23:25:58 +0000272#endif
wdenk9ca7bbc2004-10-09 23:25:58 +0000273
274 return 0;
275}
276
wdenk9ca7bbc2004-10-09 23:25:58 +0000277/*
278 * This is called early in the system initialization to grab memory
279 * for the LCD controller.
280 * Returns new address for monitor, after reserving LCD buffer memory
281 *
282 * Note that this is running from ROM, so no write access to global data.
283 */
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000284ulong lcd_setmem(ulong addr)
wdenk9ca7bbc2004-10-09 23:25:58 +0000285{
286 ulong size;
Simon Glass599a4df2012-10-17 13:24:54 +0000287 int line_length;
wdenk9ca7bbc2004-10-09 23:25:58 +0000288
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000289 debug("LCD panel info: %d x %d, %d bit/pix\n", panel_info.vl_col,
290 panel_info.vl_row, NBITS(panel_info.vl_bpix));
wdenk9ca7bbc2004-10-09 23:25:58 +0000291
Simon Glass599a4df2012-10-17 13:24:54 +0000292 size = lcd_get_size(&line_length);
wdenk9ca7bbc2004-10-09 23:25:58 +0000293
Simon Glass599a4df2012-10-17 13:24:54 +0000294 /* Round up to nearest full page, or MMU section if defined */
295 size = ALIGN(size, CONFIG_LCD_ALIGNMENT);
296 addr = ALIGN(addr - CONFIG_LCD_ALIGNMENT + 1, CONFIG_LCD_ALIGNMENT);
wdenk9ca7bbc2004-10-09 23:25:58 +0000297
298 /* Allocate pages for the frame buffer. */
299 addr -= size;
300
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000301 debug("Reserving %ldk for LCD Framebuffer at: %08lx\n",
302 size >> 10, addr);
wdenk9ca7bbc2004-10-09 23:25:58 +0000303
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000304 return addr;
wdenk9ca7bbc2004-10-09 23:25:58 +0000305}
306
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000307static void lcd_setfgcolor(int color)
wdenk9ca7bbc2004-10-09 23:25:58 +0000308{
Stelian Popf6f86652008-05-09 21:57:18 +0200309 lcd_color_fg = color;
wdenk9ca7bbc2004-10-09 23:25:58 +0000310}
311
Nikita Kiryanov631d2e12014-12-08 17:14:43 +0200312int lcd_getfgcolor(void)
313{
314 return lcd_color_fg;
315}
316
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000317static void lcd_setbgcolor(int color)
wdenk9ca7bbc2004-10-09 23:25:58 +0000318{
Stelian Popf6f86652008-05-09 21:57:18 +0200319 lcd_color_bg = color;
wdenk9ca7bbc2004-10-09 23:25:58 +0000320}
321
Nikita Kiryanov631d2e12014-12-08 17:14:43 +0200322int lcd_getbgcolor(void)
323{
324 return lcd_color_bg;
325}
326
wdenk9ca7bbc2004-10-09 23:25:58 +0000327#ifdef CONFIG_LCD_LOGO
Nikita Kiryanov7f45a7e2015-02-03 13:32:24 +0200328__weak void lcd_logo_set_cmap(void)
329{
Nikita Kiryanov70080dc2015-02-03 13:32:26 +0200330 int i;
331 ushort *cmap = configuration_get_cmap();
332
333 for (i = 0; i < ARRAY_SIZE(bmp_logo_palette); ++i)
334 *cmap++ = bmp_logo_palette[i];
Nikita Kiryanov7f45a7e2015-02-03 13:32:24 +0200335}
336
Nikita Kiryanov618212c2015-02-03 13:32:30 +0200337void lcd_logo_plot(int x, int y)
wdenk9ca7bbc2004-10-09 23:25:58 +0000338{
wdenk9ca7bbc2004-10-09 23:25:58 +0000339 ushort i, j;
Nikita Kiryanovf54c0262015-02-03 13:32:29 +0200340 uchar *bmap = &bmp_logo_bitmap[0];
Andre Renaudada32ec2013-02-13 17:48:00 +0000341 unsigned bpix = NBITS(panel_info.vl_bpix);
Nikita Kiryanovf54c0262015-02-03 13:32:29 +0200342 uchar *fb = (uchar *)(lcd_base + y * lcd_line_length + x * bpix / 8);
343 ushort *fb16;
wdenk9ca7bbc2004-10-09 23:25:58 +0000344
Nikita Kiryanov70080dc2015-02-03 13:32:26 +0200345 debug("Logo: width %d height %d colors %d\n",
346 BMP_LOGO_WIDTH, BMP_LOGO_HEIGHT, BMP_LOGO_COLORS);
wdenk9ca7bbc2004-10-09 23:25:58 +0000347
Andre Renaudada32ec2013-02-13 17:48:00 +0000348 if (bpix < 12) {
wdenk9ca7bbc2004-10-09 23:25:58 +0000349 WATCHDOG_RESET();
Nikita Kiryanov7f45a7e2015-02-03 13:32:24 +0200350 lcd_logo_set_cmap();
wdenk9ca7bbc2004-10-09 23:25:58 +0000351 WATCHDOG_RESET();
352
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000353 for (i = 0; i < BMP_LOGO_HEIGHT; ++i) {
354 memcpy(fb, bmap, BMP_LOGO_WIDTH);
wdenk9ca7bbc2004-10-09 23:25:58 +0000355 bmap += BMP_LOGO_WIDTH;
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000356 fb += panel_info.vl_col;
wdenk9ca7bbc2004-10-09 23:25:58 +0000357 }
358 }
359 else { /* true color mode */
Alessandro Rubini2d68c262010-03-13 17:44:08 +0100360 u16 col16;
Andre Renaudada32ec2013-02-13 17:48:00 +0000361 fb16 = (ushort *)fb;
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000362 for (i = 0; i < BMP_LOGO_HEIGHT; ++i) {
363 for (j = 0; j < BMP_LOGO_WIDTH; j++) {
Alessandro Rubini2d68c262010-03-13 17:44:08 +0100364 col16 = bmp_logo_palette[(bmap[j]-16)];
365 fb16[j] =
366 ((col16 & 0x000F) << 1) |
367 ((col16 & 0x00F0) << 3) |
368 ((col16 & 0x0F00) << 4);
wdenk9ca7bbc2004-10-09 23:25:58 +0000369 }
370 bmap += BMP_LOGO_WIDTH;
371 fb16 += panel_info.vl_col;
372 }
373 }
374
375 WATCHDOG_RESET();
Simon Glassef45ffd2012-10-30 13:40:18 +0000376 lcd_sync();
wdenk9ca7bbc2004-10-09 23:25:58 +0000377}
Anatolij Gustschin6f1378f2012-04-27 04:41:27 +0000378#else
Nikita Kiryanov618212c2015-02-03 13:32:30 +0200379static inline void lcd_logo_plot(int x, int y) {}
wdenk9ca7bbc2004-10-09 23:25:58 +0000380#endif /* CONFIG_LCD_LOGO */
381
Jon Loeliger052fc842007-07-08 18:10:08 -0500382#if defined(CONFIG_CMD_BMP) || defined(CONFIG_SPLASH_SCREEN)
Matthias Weisser53884182009-07-09 16:07:30 +0200383#ifdef CONFIG_SPLASH_SCREEN_ALIGN
Nikita Kiryanovb4eb54d2012-08-09 00:14:51 +0000384
385static void splash_align_axis(int *axis, unsigned long panel_size,
386 unsigned long picture_size)
387{
388 unsigned long panel_picture_delta = panel_size - picture_size;
389 unsigned long axis_alignment;
390
391 if (*axis == BMP_ALIGN_CENTER)
392 axis_alignment = panel_picture_delta / 2;
393 else if (*axis < 0)
394 axis_alignment = panel_picture_delta + *axis + 1;
395 else
396 return;
397
Masahiro Yamadadb204642014-11-07 03:03:31 +0900398 *axis = max(0, (int)axis_alignment);
Nikita Kiryanovb4eb54d2012-08-09 00:14:51 +0000399}
Matthias Weisser53884182009-07-09 16:07:30 +0200400#endif
401
Tom Wai-Hong Tam79926a42012-09-28 15:11:16 +0000402#ifdef CONFIG_LCD_BMP_RLE8
Tom Wai-Hong Tam79926a42012-09-28 15:11:16 +0000403#define BMP_RLE8_ESCAPE 0
404#define BMP_RLE8_EOL 0
405#define BMP_RLE8_EOBMP 1
406#define BMP_RLE8_DELTA 2
407
408static void draw_unencoded_bitmap(ushort **fbp, uchar *bmap, ushort *cmap,
409 int cnt)
410{
411 while (cnt > 0) {
412 *(*fbp)++ = cmap[*bmap++];
413 cnt--;
414 }
415}
416
417static void draw_encoded_bitmap(ushort **fbp, ushort c, int cnt)
418{
419 ushort *fb = *fbp;
420 int cnt_8copy = cnt >> 3;
421
422 cnt -= cnt_8copy << 3;
423 while (cnt_8copy > 0) {
424 *fb++ = c;
425 *fb++ = c;
426 *fb++ = c;
427 *fb++ = c;
428 *fb++ = c;
429 *fb++ = c;
430 *fb++ = c;
431 *fb++ = c;
432 cnt_8copy--;
433 }
434 while (cnt > 0) {
435 *fb++ = c;
436 cnt--;
437 }
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000438 *fbp = fb;
Tom Wai-Hong Tam79926a42012-09-28 15:11:16 +0000439}
440
441/*
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000442 * Do not call this function directly, must be called from lcd_display_bitmap.
Tom Wai-Hong Tam79926a42012-09-28 15:11:16 +0000443 */
Simon Glass92e1f852015-05-13 07:02:27 -0600444static void lcd_display_rle8_bitmap(struct bmp_image *bmp, ushort *cmap,
445 uchar *fb, int x_off, int y_off)
Tom Wai-Hong Tam79926a42012-09-28 15:11:16 +0000446{
447 uchar *bmap;
448 ulong width, height;
449 ulong cnt, runlen;
450 int x, y;
451 int decode = 1;
452
Przemyslaw Marczakc3bf15e2014-01-22 11:24:13 +0100453 width = get_unaligned_le32(&bmp->header.width);
454 height = get_unaligned_le32(&bmp->header.height);
455 bmap = (uchar *)bmp + get_unaligned_le32(&bmp->header.data_offset);
Tom Wai-Hong Tam79926a42012-09-28 15:11:16 +0000456
457 x = 0;
458 y = height - 1;
459
460 while (decode) {
461 if (bmap[0] == BMP_RLE8_ESCAPE) {
462 switch (bmap[1]) {
463 case BMP_RLE8_EOL:
464 /* end of line */
465 bmap += 2;
466 x = 0;
467 y--;
468 /* 16bpix, 2-byte per pixel, width should *2 */
469 fb -= (width * 2 + lcd_line_length);
470 break;
471 case BMP_RLE8_EOBMP:
472 /* end of bitmap */
473 decode = 0;
474 break;
475 case BMP_RLE8_DELTA:
476 /* delta run */
477 x += bmap[2];
478 y -= bmap[3];
479 /* 16bpix, 2-byte per pixel, x should *2 */
480 fb = (uchar *) (lcd_base + (y + y_off - 1)
481 * lcd_line_length + (x + x_off) * 2);
482 bmap += 4;
483 break;
484 default:
485 /* unencoded run */
486 runlen = bmap[1];
487 bmap += 2;
488 if (y < height) {
489 if (x < width) {
490 if (x + runlen > width)
491 cnt = width - x;
492 else
493 cnt = runlen;
494 draw_unencoded_bitmap(
495 (ushort **)&fb,
496 bmap, cmap, cnt);
497 }
498 x += runlen;
499 }
500 bmap += runlen;
501 if (runlen & 1)
502 bmap++;
503 }
504 } else {
505 /* encoded run */
506 if (y < height) {
507 runlen = bmap[0];
508 if (x < width) {
509 /* aggregate the same code */
510 while (bmap[0] == 0xff &&
511 bmap[2] != BMP_RLE8_ESCAPE &&
512 bmap[1] == bmap[3]) {
513 runlen += bmap[2];
514 bmap += 2;
515 }
516 if (x + runlen > width)
517 cnt = width - x;
518 else
519 cnt = runlen;
520 draw_encoded_bitmap((ushort **)&fb,
521 cmap[bmap[1]], cnt);
522 }
523 x += runlen;
524 }
525 bmap += 2;
526 }
527 }
528}
529#endif
530
Nikita Kiryanovc999bcc2015-02-03 13:32:23 +0200531__weak void fb_put_byte(uchar **fb, uchar **from)
532{
533 *(*fb)++ = *(*from)++;
534}
Nikita Kiryanovb4571182012-08-09 00:14:53 +0000535
536#if defined(CONFIG_BMP_16BPP)
Nikita Kiryanovc6cc0652015-02-03 13:32:22 +0200537__weak void fb_put_word(uchar **fb, uchar **from)
Nikita Kiryanovb4571182012-08-09 00:14:53 +0000538{
539 *(*fb)++ = *(*from)++;
540 *(*fb)++ = *(*from)++;
541}
Nikita Kiryanovb4571182012-08-09 00:14:53 +0000542#endif /* CONFIG_BMP_16BPP */
543
Simon Glass92e1f852015-05-13 07:02:27 -0600544__weak void lcd_set_cmap(struct bmp_image *bmp, unsigned colors)
Nikita Kiryanov1dce1e72015-02-03 13:32:27 +0200545{
546 int i;
Simon Glass92e1f852015-05-13 07:02:27 -0600547 struct bmp_color_table_entry cte;
Nikita Kiryanov1dce1e72015-02-03 13:32:27 +0200548 ushort *cmap = configuration_get_cmap();
549
550 for (i = 0; i < colors; ++i) {
551 cte = bmp->color_table[i];
552 *cmap = (((cte.red) << 8) & 0xf800) |
553 (((cte.green) << 3) & 0x07e0) |
554 (((cte.blue) >> 3) & 0x001f);
Nikita Kiryanov1dce1e72015-02-03 13:32:27 +0200555 cmap++;
Nikita Kiryanov1dce1e72015-02-03 13:32:27 +0200556 }
557}
558
wdenk9ca7bbc2004-10-09 23:25:58 +0000559int lcd_display_bitmap(ulong bmp_image, int x, int y)
560{
Anatolij Gustschina11ca282009-02-25 20:28:13 +0100561 ushort *cmap_base = NULL;
wdenk9ca7bbc2004-10-09 23:25:58 +0000562 ushort i, j;
563 uchar *fb;
Simon Glass92e1f852015-05-13 07:02:27 -0600564 struct bmp_image *bmp = (struct bmp_image *)map_sysmem(bmp_image, 0);
wdenk9ca7bbc2004-10-09 23:25:58 +0000565 uchar *bmap;
Tom Wai-Hong Tam93f04d62012-09-28 15:11:14 +0000566 ushort padded_width;
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100567 unsigned long width, height, byte_width;
Wolfgang Denkd4321d32006-08-30 23:09:00 +0200568 unsigned long pwidth = panel_info.vl_col;
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100569 unsigned colors, bpix, bmp_bpix;
Simon Glass8980cc02015-05-13 07:02:28 -0600570 int hdr_size;
xypron.glpk@gmx.defb9fc962017-07-30 21:59:23 +0200571 struct bmp_color_table_entry *palette;
wdenk9ca7bbc2004-10-09 23:25:58 +0000572
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000573 if (!bmp || !(bmp->header.signature[0] == 'B' &&
574 bmp->header.signature[1] == 'M')) {
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000575 printf("Error: no valid bmp image at %lx\n", bmp_image);
576
wdenk9ca7bbc2004-10-09 23:25:58 +0000577 return 1;
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100578 }
wdenk9ca7bbc2004-10-09 23:25:58 +0000579
xypron.glpk@gmx.defb9fc962017-07-30 21:59:23 +0200580 palette = bmp->color_table;
Przemyslaw Marczakc3bf15e2014-01-22 11:24:13 +0100581 width = get_unaligned_le32(&bmp->header.width);
582 height = get_unaligned_le32(&bmp->header.height);
583 bmp_bpix = get_unaligned_le16(&bmp->header.bit_count);
Simon Glass8980cc02015-05-13 07:02:28 -0600584 hdr_size = get_unaligned_le16(&bmp->header.size);
585 debug("hdr_size=%d, bmp_bpix=%d\n", hdr_size, bmp_bpix);
Przemyslaw Marczakc3bf15e2014-01-22 11:24:13 +0100586
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100587 colors = 1 << bmp_bpix;
wdenk9ca7bbc2004-10-09 23:25:58 +0000588
589 bpix = NBITS(panel_info.vl_bpix);
590
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000591 if (bpix != 1 && bpix != 8 && bpix != 16 && bpix != 32) {
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100592 printf ("Error: %d bit/pixel mode, but BMP has %d bit/pixel\n",
593 bpix, bmp_bpix);
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000594
wdenk9ca7bbc2004-10-09 23:25:58 +0000595 return 1;
596 }
597
Hannes Petermaier14b7eed2014-07-15 16:28:46 +0200598 /*
599 * We support displaying 8bpp BMPs on 16bpp LCDs
600 * and displaying 24bpp BMPs on 32bpp LCDs
601 * */
602 if (bpix != bmp_bpix &&
603 !(bmp_bpix == 8 && bpix == 16) &&
604 !(bmp_bpix == 24 && bpix == 32)) {
wdenk9ca7bbc2004-10-09 23:25:58 +0000605 printf ("Error: %d bit/pixel mode, but BMP has %d bit/pixel\n",
Przemyslaw Marczakc3bf15e2014-01-22 11:24:13 +0100606 bpix, get_unaligned_le16(&bmp->header.bit_count));
wdenk9ca7bbc2004-10-09 23:25:58 +0000607 return 1;
608 }
609
Simon Glass8980cc02015-05-13 07:02:28 -0600610 debug("Display-bmp: %d x %d with %d colors, display %d\n",
611 (int)width, (int)height, (int)colors, 1 << bpix);
wdenk9ca7bbc2004-10-09 23:25:58 +0000612
Nikita Kiryanov1dce1e72015-02-03 13:32:27 +0200613 if (bmp_bpix == 8)
614 lcd_set_cmap(bmp, colors);
Wolfgang Denkd4321d32006-08-30 23:09:00 +0200615
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000616 padded_width = (width & 0x3 ? (width & ~0x3) + 4 : width);
Matthias Weisser53884182009-07-09 16:07:30 +0200617
618#ifdef CONFIG_SPLASH_SCREEN_ALIGN
Nikita Kiryanovb4eb54d2012-08-09 00:14:51 +0000619 splash_align_axis(&x, pwidth, width);
620 splash_align_axis(&y, panel_info.vl_row, height);
Matthias Weisser53884182009-07-09 16:07:30 +0200621#endif /* CONFIG_SPLASH_SCREEN_ALIGN */
622
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000623 if ((x + width) > pwidth)
Wolfgang Denkd4321d32006-08-30 23:09:00 +0200624 width = pwidth - x;
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000625 if ((y + height) > panel_info.vl_row)
wdenk9ca7bbc2004-10-09 23:25:58 +0000626 height = panel_info.vl_row - y;
627
Przemyslaw Marczakc3bf15e2014-01-22 11:24:13 +0100628 bmap = (uchar *)bmp + get_unaligned_le32(&bmp->header.data_offset);
629 fb = (uchar *)(lcd_base +
Liu Ying1bb98712011-01-11 15:29:58 +0800630 (y + height - 1) * lcd_line_length + x * bpix / 8);
Mark Jackson7b298f32009-02-06 10:37:49 +0100631
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100632 switch (bmp_bpix) {
Nikita Kiryanovf54c0262015-02-03 13:32:29 +0200633 case 1:
Simon Glassf461f122014-10-15 04:53:04 -0600634 case 8: {
Nikita Kiryanov1dce1e72015-02-03 13:32:27 +0200635 cmap_base = configuration_get_cmap();
Tom Wai-Hong Tam79926a42012-09-28 15:11:16 +0000636#ifdef CONFIG_LCD_BMP_RLE8
Przemyslaw Marczakc3bf15e2014-01-22 11:24:13 +0100637 u32 compression = get_unaligned_le32(&bmp->header.compression);
Simon Glass8980cc02015-05-13 07:02:28 -0600638 debug("compressed %d %d\n", compression, BMP_BI_RLE8);
Przemyslaw Marczakc3bf15e2014-01-22 11:24:13 +0100639 if (compression == BMP_BI_RLE8) {
Tom Wai-Hong Tam79926a42012-09-28 15:11:16 +0000640 if (bpix != 16) {
641 /* TODO implement render code for bpix != 16 */
642 printf("Error: only support 16 bpix");
643 return 1;
644 }
645 lcd_display_rle8_bitmap(bmp, cmap_base, fb, x, y);
646 break;
647 }
648#endif
649
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100650 if (bpix != 16)
651 byte_width = width;
652 else
653 byte_width = width * 2;
654
Mark Jackson7b298f32009-02-06 10:37:49 +0100655 for (i = 0; i < height; ++i) {
656 WATCHDOG_RESET();
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100657 for (j = 0; j < width; j++) {
658 if (bpix != 16) {
Nikita Kiryanovc999bcc2015-02-03 13:32:23 +0200659 fb_put_byte(&fb, &bmap);
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100660 } else {
Simon Glass8980cc02015-05-13 07:02:28 -0600661 struct bmp_color_table_entry *entry;
662 uint val;
663
664 if (cmap_base) {
665 val = cmap_base[*bmap];
666 } else {
667 entry = &palette[*bmap];
668 val = entry->blue >> 3 |
669 entry->green >> 2 << 5 |
670 entry->red >> 3 << 11;
671 }
672 *(uint16_t *)fb = val;
673 bmap++;
Guennadi Liakhovetski332d0b52009-02-06 10:37:53 +0100674 fb += sizeof(uint16_t) / sizeof(*fb);
675 }
676 }
Tom Wai-Hong Tam93f04d62012-09-28 15:11:14 +0000677 bmap += (padded_width - width);
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000678 fb -= byte_width + lcd_line_length;
Mark Jackson7b298f32009-02-06 10:37:49 +0100679 }
680 break;
Simon Glassf461f122014-10-15 04:53:04 -0600681 }
Mark Jackson7b298f32009-02-06 10:37:49 +0100682#if defined(CONFIG_BMP_16BPP)
683 case 16:
684 for (i = 0; i < height; ++i) {
685 WATCHDOG_RESET();
Nikita Kiryanovb4571182012-08-09 00:14:53 +0000686 for (j = 0; j < width; j++)
687 fb_put_word(&fb, &bmap);
688
Tom Wai-Hong Tam93f04d62012-09-28 15:11:14 +0000689 bmap += (padded_width - width) * 2;
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000690 fb -= width * 2 + lcd_line_length;
Mark Jackson7b298f32009-02-06 10:37:49 +0100691 }
692 break;
693#endif /* CONFIG_BMP_16BPP */
Philipp Tomsich5cfa3f42017-05-05 21:48:30 +0200694#if defined(CONFIG_BMP_24BPP)
Hannes Petermaier14b7eed2014-07-15 16:28:46 +0200695 case 24:
696 for (i = 0; i < height; ++i) {
697 for (j = 0; j < width; j++) {
698 *(fb++) = *(bmap++);
699 *(fb++) = *(bmap++);
700 *(fb++) = *(bmap++);
701 *(fb++) = 0;
702 }
703 fb -= lcd_line_length + width * (bpix / 8);
704 }
705 break;
Philipp Tomsich5cfa3f42017-05-05 21:48:30 +0200706#endif /* CONFIG_BMP_24BPP */
Donghwa Leebf345a12012-05-09 19:23:37 +0000707#if defined(CONFIG_BMP_32BPP)
708 case 32:
709 for (i = 0; i < height; ++i) {
710 for (j = 0; j < width; j++) {
711 *(fb++) = *(bmap++);
712 *(fb++) = *(bmap++);
713 *(fb++) = *(bmap++);
714 *(fb++) = *(bmap++);
715 }
Jeroen Hofstee729b09e2013-01-12 12:07:56 +0000716 fb -= lcd_line_length + width * (bpix / 8);
Donghwa Leebf345a12012-05-09 19:23:37 +0000717 }
718 break;
719#endif /* CONFIG_BMP_32BPP */
Mark Jackson7b298f32009-02-06 10:37:49 +0100720 default:
721 break;
722 };
wdenk9ca7bbc2004-10-09 23:25:58 +0000723
Simon Glassef45ffd2012-10-30 13:40:18 +0000724 lcd_sync();
Nikita Kiryanov1f828412012-05-24 01:42:38 +0000725 return 0;
wdenk9ca7bbc2004-10-09 23:25:58 +0000726}
Jon Loeliger052fc842007-07-08 18:10:08 -0500727#endif
wdenk9ca7bbc2004-10-09 23:25:58 +0000728
Nikita Kiryanov1ae13d32015-02-03 13:32:32 +0200729static void lcd_logo(void)
wdenk9ca7bbc2004-10-09 23:25:58 +0000730{
Nikita Kiryanov618212c2015-02-03 13:32:30 +0200731 lcd_logo_plot(0, 0);
wdenk9ca7bbc2004-10-09 23:25:58 +0000732
Haavard Skinnemoenddbcf952008-09-01 16:21:22 +0200733#ifdef CONFIG_LCD_INFO
Nikita Kiryanov699c05e2014-12-08 17:14:41 +0200734 lcd_set_col(LCD_INFO_X / VIDEO_FONT_WIDTH);
735 lcd_set_row(LCD_INFO_Y / VIDEO_FONT_HEIGHT);
Haavard Skinnemoenddbcf952008-09-01 16:21:22 +0200736 lcd_show_board_info();
737#endif /* CONFIG_LCD_INFO */
wdenk9ca7bbc2004-10-09 23:25:58 +0000738}
739
Nikita Kiryanov2f3e2ca2013-02-24 21:28:43 +0000740#ifdef CONFIG_SPLASHIMAGE_GUARD
741static int on_splashimage(const char *name, const char *value, enum env_op op,
742 int flags)
743{
744 ulong addr;
745 int aligned;
746
747 if (op == env_op_delete)
748 return 0;
749
750 addr = simple_strtoul(value, NULL, 16);
751 /* See README.displaying-bmps */
752 aligned = (addr % 4 == 2);
753 if (!aligned) {
754 printf("Invalid splashimage value. Value must be 16 bit aligned, but not 32 bit aligned\n");
755 return -1;
756 }
757
758 return 0;
759}
760
761U_BOOT_ENV_CALLBACK(splashimage, on_splashimage);
762#endif
763
Vadim Bendeburya7eaa2f2012-09-28 15:11:13 +0000764int lcd_get_pixel_width(void)
765{
766 return panel_info.vl_col;
767}
768
769int lcd_get_pixel_height(void)
770{
771 return panel_info.vl_row;
772}