]> git.kernelconcepts.de Git - karo-tx-uboot.git/blob - drivers/video/ipu_common.c
use default fdtaddr if not set
[karo-tx-uboot.git] / drivers / video / ipu_common.c
1 /*
2  * Porting to u-boot:
3  *
4  * (C) Copyright 2010
5  * Stefano Babic, DENX Software Engineering, sbabic@denx.de
6  *
7  * Linux IPU driver for MX51:
8  *
9  * (C) Copyright 2005-2010 Freescale Semiconductor, Inc.
10  *
11  * See file CREDITS for list of people who contributed to this
12  * project.
13  *
14  * This program is free software; you can redistribute it and/or
15  * modify it under the terms of the GNU General Public License as
16  * published by the Free Software Foundation; either version 2 of
17  * the License, or (at your option) any later version.
18  *
19  * This program is distributed in the hope that it will be useful,
20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
22  * GNU General Public License for more details.
23  *
24  * You should have received a copy of the GNU General Public License
25  * along with this program; if not, write to the Free Software
26  * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
27  * MA 02111-1307 USA
28  */
29
30 /* #define DEBUG */
31 #include <common.h>
32 #include <linux/types.h>
33 #include <linux/err.h>
34 #include <asm/io.h>
35 #include <asm/errno.h>
36 #include <asm/arch/imx-regs.h>
37 #include <asm/arch/crm_regs.h>
38 #include "ipu.h"
39 #include "ipu_regs.h"
40
41 extern struct mxc_ccm_reg *mxc_ccm;
42 extern u32 *ipu_cpmem_base;
43
44 struct ipu_ch_param_word {
45         uint32_t data[5];
46         uint32_t res[3];
47 };
48
49 struct ipu_ch_param {
50         struct ipu_ch_param_word word[2];
51 };
52
53 #define ipu_ch_param_addr(ch) (((struct ipu_ch_param *)ipu_cpmem_base) + (ch))
54
55 #define _param_word(base, w) \
56         (((struct ipu_ch_param *)(base))->word[(w)].data)
57
58 #define ipu_ch_param_set_field(base, w, bit, size, v) { \
59         int i = (bit) / 32; \
60         int off = (bit) % 32; \
61         _param_word(base, w)[i] |= (v) << off; \
62         if (((bit) + (size) - 1) / 32 > i) { \
63                 _param_word(base, w)[i + 1] |= (v) >> (off ? (32 - off) : 0); \
64         } \
65 }
66
67 #define ipu_ch_param_mod_field(base, w, bit, size, v) { \
68         int i = (bit) / 32; \
69         int off = (bit) % 32; \
70         u32 mask = (1UL << size) - 1; \
71         u32 temp = _param_word(base, w)[i]; \
72         temp &= ~(mask << off); \
73         _param_word(base, w)[i] = temp | (v) << off; \
74         if (((bit) + (size) - 1) / 32 > i) { \
75                 temp = _param_word(base, w)[i + 1]; \
76                 temp &= ~(mask >> (32 - off)); \
77                 _param_word(base, w)[i + 1] = \
78                         temp | ((v) >> (off ? (32 - off) : 0)); \
79         } \
80 }
81
82 #define ipu_ch_param_read_field(base, w, bit, size) ({ \
83         u32 temp2; \
84         int i = (bit) / 32; \
85         int off = (bit) % 32; \
86         u32 mask = (1UL << size) - 1; \
87         u32 temp1 = _param_word(base, w)[i]; \
88         temp1 = mask & (temp1 >> off); \
89         if (((bit)+(size) - 1) / 32 > i) { \
90                 temp2 = _param_word(base, w)[i + 1]; \
91                 temp2 &= mask >> (off ? (32 - off) : 0); \
92                 temp1 |= temp2 << (off ? (32 - off) : 0); \
93         } \
94         temp1; \
95 })
96
97
98 void clk_enable(struct clk *clk)
99 {
100         if (clk) {
101                 if (clk->usecount++ == 0) {
102                         clk->enable(clk);
103                 }
104         }
105 }
106
107 void clk_disable(struct clk *clk)
108 {
109         if (clk) {
110                 if (!(--clk->usecount)) {
111                         if (clk->disable)
112                                 clk->disable(clk);
113                 }
114         }
115 }
116
117 int clk_get_usecount(struct clk *clk)
118 {
119         if (clk == NULL)
120                 return 0;
121
122         return clk->usecount;
123 }
124
125 u32 clk_get_rate(struct clk *clk)
126 {
127         if (!clk)
128                 return 0;
129
130         return clk->rate;
131 }
132
133 struct clk *clk_get_parent(struct clk *clk)
134 {
135         if (!clk)
136                 return 0;
137
138         return clk->parent;
139 }
140
141 int clk_set_rate(struct clk *clk, unsigned long rate)
142 {
143         if (clk && clk->set_rate)
144                 clk->set_rate(clk, rate);
145         return clk->rate;
146 }
147
148 long clk_round_rate(struct clk *clk, unsigned long rate)
149 {
150         if (clk == NULL || !clk->round_rate)
151                 return 0;
152
153         return clk->round_rate(clk, rate);
154 }
155
156 int clk_set_parent(struct clk *clk, struct clk *parent)
157 {
158         clk->parent = parent;
159         if (clk->set_parent)
160                 return clk->set_parent(clk, parent);
161         return 0;
162 }
163
164 static int clk_ipu_enable(struct clk *clk)
165 {
166         u32 reg;
167
168         reg = __raw_readl(clk->enable_reg);
169         reg |= MXC_CCM_CCGR_CG_MASK << clk->enable_shift;
170         __raw_writel(reg, clk->enable_reg);
171
172         /* Handshake with IPU when certain clock rates are changed. */
173         reg = __raw_readl(&mxc_ccm->ccdr);
174         reg &= ~MXC_CCM_CCDR_IPU_HS_MASK;
175         __raw_writel(reg, &mxc_ccm->ccdr);
176
177         /* Handshake with IPU when LPM is entered as its enabled. */
178         reg = __raw_readl(&mxc_ccm->clpcr);
179         reg &= ~MXC_CCM_CLPCR_BYPASS_IPU_LPM_HS;
180         __raw_writel(reg, &mxc_ccm->clpcr);
181
182         return 0;
183 }
184
185 static void clk_ipu_disable(struct clk *clk)
186 {
187         u32 reg;
188
189         reg = __raw_readl(clk->enable_reg);
190         reg &= ~(MXC_CCM_CCGR_CG_MASK << clk->enable_shift);
191         __raw_writel(reg, clk->enable_reg);
192
193         /*
194          * No handshake with IPU whe dividers are changed
195          * as its not enabled.
196          */
197         reg = __raw_readl(&mxc_ccm->ccdr);
198         reg |= MXC_CCM_CCDR_IPU_HS_MASK;
199         __raw_writel(reg, &mxc_ccm->ccdr);
200
201         /* No handshake with IPU when LPM is entered as its not enabled. */
202         reg = __raw_readl(&mxc_ccm->clpcr);
203         reg |= MXC_CCM_CLPCR_BYPASS_IPU_LPM_HS;
204         __raw_writel(reg, &mxc_ccm->clpcr);
205 }
206
207
208 static struct clk ipu_clk = {
209         .name = "ipu_clk",
210 #if defined(CONFIG_MX51)
211         .rate = 133000000,
212 #elif defined(CONFIG_MX53)
213         .rate = 216000000,
214 #endif
215         .enable_reg = (u32 *)(MXC_CCM_BASE +
216                 offsetof(struct mxc_ccm_reg, CCGR5)),
217         .enable_shift = MXC_CCM_CCGR5_CG5_OFFSET,
218         .enable = clk_ipu_enable,
219         .disable = clk_ipu_disable,
220 };
221
222 /* Globals */
223 struct clk *g_ipu_clk;
224 unsigned char g_ipu_clk_enabled;
225 struct clk *g_di_clk[2];
226 struct clk *g_pixel_clk[2];
227 unsigned char g_dc_di_assignment[10];
228 uint32_t g_channel_init_mask;
229 uint32_t g_channel_enable_mask;
230
231 static int ipu_dc_use_count;
232 static int ipu_dp_use_count;
233 static int ipu_dmfc_use_count;
234 static int ipu_di_use_count[2];
235
236 u32 *ipu_cpmem_base;
237 u32 *ipu_dc_tmpl_reg;
238
239 /* Static functions */
240
241 static inline void ipu_ch_param_set_high_priority(uint32_t ch)
242 {
243         ipu_ch_param_mod_field(ipu_ch_param_addr(ch), 1, 93, 2, 1);
244 };
245
246 static inline uint32_t channel_2_dma(ipu_channel_t ch, ipu_buffer_t type)
247 {
248         return ((uint32_t) ch >> (6 * type)) & 0x3F;
249 };
250
251 /* Either DP BG or DP FG can be graphic window */
252 static inline int ipu_is_dp_graphic_chan(uint32_t dma_chan)
253 {
254         return (dma_chan == 23 || dma_chan == 27);
255 }
256
257 static inline int ipu_is_dmfc_chan(uint32_t dma_chan)
258 {
259         return ((dma_chan >= 23) && (dma_chan <= 29));
260 }
261
262
263 static inline void ipu_ch_param_set_buffer(uint32_t ch, int bufNum,
264                                             dma_addr_t phyaddr)
265 {
266         ipu_ch_param_mod_field(ipu_ch_param_addr(ch), 1, 29 * bufNum, 29,
267                                phyaddr / 8);
268 };
269
270 #define idma_is_valid(ch)       (ch != NO_DMA)
271 #define idma_mask(ch)           (idma_is_valid(ch) ? (1UL << (ch & 0x1F)) : 0)
272 #define idma_is_set(reg, dma)   (__raw_readl(reg(dma)) & idma_mask(dma))
273
274 static void ipu_pixel_clk_recalc(struct clk *clk)
275 {
276         u32 div = __raw_readl(DI_BS_CLKGEN0(clk->id));
277         if (div == 0)
278                 clk->rate = 0;
279         else
280                 clk->rate = (clk->parent->rate * 16) / div;
281 }
282
283 static unsigned long ipu_pixel_clk_round_rate(struct clk *clk,
284         unsigned long rate)
285 {
286         u32 div, div1;
287         u32 tmp;
288         /*
289          * Calculate divider
290          * Fractional part is 4 bits,
291          * so simply multiply by 2^4 to get fractional part.
292          */
293         tmp = clk->parent->rate * 16;
294         div = tmp / rate;
295
296         if (div < 0x10)            /* Min DI disp clock divider is 1 */
297                 div = 0x10;
298         if (div & ~0xFEF)
299                 div &= 0xFF8;
300         else {
301                 div1 = div & 0xFE0;
302                 if ((tmp/div1 - tmp/div) < rate / 4)
303                         div = div1;
304                 else
305                         div &= 0xFF8;
306         }
307         return (clk->parent->rate * 16) / div;
308 }
309
310 static int ipu_pixel_clk_set_rate(struct clk *clk, unsigned long rate)
311 {
312         u32 div = (clk->parent->rate * 16) / rate;
313
314         __raw_writel(div, DI_BS_CLKGEN0(clk->id));
315
316         /* Setup pixel clock timing */
317         __raw_writel((div / 16) << 16, DI_BS_CLKGEN1(clk->id));
318
319         clk->rate = (clk->parent->rate * 16) / div;
320         return 0;
321 }
322
323 static int ipu_pixel_clk_enable(struct clk *clk)
324 {
325         u32 disp_gen = __raw_readl(IPU_DISP_GEN);
326         disp_gen |= clk->id ? DI1_COUNTER_RELEASE : DI0_COUNTER_RELEASE;
327         __raw_writel(disp_gen, IPU_DISP_GEN);
328
329         return 0;
330 }
331
332 static void ipu_pixel_clk_disable(struct clk *clk)
333 {
334         u32 disp_gen = __raw_readl(IPU_DISP_GEN);
335         disp_gen &= clk->id ? ~DI1_COUNTER_RELEASE : ~DI0_COUNTER_RELEASE;
336         __raw_writel(disp_gen, IPU_DISP_GEN);
337 }
338
339 static int ipu_pixel_clk_set_parent(struct clk *clk, struct clk *parent)
340 {
341         u32 di_gen = __raw_readl(DI_GENERAL(clk->id));
342
343         if (parent == g_ipu_clk)
344                 di_gen &= ~DI_GEN_DI_CLK_EXT;
345         else if (!IS_ERR(g_di_clk[clk->id]) && parent == g_di_clk[clk->id])
346                 di_gen |= DI_GEN_DI_CLK_EXT;
347         else
348                 return -EINVAL;
349
350         __raw_writel(di_gen, DI_GENERAL(clk->id));
351         ipu_pixel_clk_recalc(clk);
352         return 0;
353 }
354
355 static struct clk pixel_clk[] = {
356         {
357                 .name = "pixel_clk",
358                 .id = 0,
359                 .recalc = ipu_pixel_clk_recalc,
360                 .set_rate = ipu_pixel_clk_set_rate,
361                 .round_rate = ipu_pixel_clk_round_rate,
362                 .set_parent = ipu_pixel_clk_set_parent,
363                 .enable = ipu_pixel_clk_enable,
364                 .disable = ipu_pixel_clk_disable,
365         },
366         {
367                 .name = "pixel_clk",
368                 .id = 1,
369                 .recalc = ipu_pixel_clk_recalc,
370                 .set_rate = ipu_pixel_clk_set_rate,
371                 .round_rate = ipu_pixel_clk_round_rate,
372                 .set_parent = ipu_pixel_clk_set_parent,
373                 .enable = ipu_pixel_clk_enable,
374                 .disable = ipu_pixel_clk_disable,
375         },
376 };
377
378 /*
379  * This function resets IPU
380  */
381 void ipu_reset(void)
382 {
383         u32 *reg;
384         u32 value;
385
386         reg = (u32 *)SRC_BASE_ADDR;
387         value = __raw_readl(reg);
388         value = value | SW_IPU_RST;
389         __raw_writel(value, reg);
390 }
391
392 /*
393  * This function is called by the driver framework to initialize the IPU
394  * hardware.
395  *
396  * @param       dev     The device structure for the IPU passed in by the
397  *                      driver framework.
398  *
399  * @return      Returns 0 on success or negative error code on error
400  */
401 int ipu_probe(void)
402 {
403         unsigned long ipu_base;
404 #ifdef CONFIG_MX51
405         u32 temp;
406         u32 *reg_hsc_mcd = (u32 *)MIPI_HSC_BASE_ADDR;
407         u32 *reg_hsc_mxt_conf = (u32 *)(MIPI_HSC_BASE_ADDR + 0x800);
408
409          __raw_writel(0xF00, reg_hsc_mcd);
410
411         /* CSI mode reserved*/
412         temp = __raw_readl(reg_hsc_mxt_conf);
413          __raw_writel(temp | 0x0FF, reg_hsc_mxt_conf);
414
415         temp = __raw_readl(reg_hsc_mxt_conf);
416         __raw_writel(temp | 0x10000, reg_hsc_mxt_conf);
417 #endif
418         ipu_base = IPU_CTRL_BASE_ADDR;
419         ipu_cpmem_base = (u32 *)(ipu_base + IPU_CPMEM_REG_BASE);
420         ipu_dc_tmpl_reg = (u32 *)(ipu_base + IPU_DC_TMPL_REG_BASE);
421
422         g_pixel_clk[0] = &pixel_clk[0];
423         g_pixel_clk[1] = &pixel_clk[1];
424
425         g_ipu_clk = &ipu_clk;
426         debug("ipu_clk = %u\n", clk_get_rate(g_ipu_clk));
427
428         ipu_reset();
429
430         clk_set_parent(g_pixel_clk[0], g_ipu_clk);
431         clk_set_parent(g_pixel_clk[1], g_ipu_clk);
432         clk_enable(g_ipu_clk);
433
434         g_di_clk[0] = NULL;
435         g_di_clk[1] = NULL;
436
437         __raw_writel(0x807FFFFF, IPU_MEM_RST);
438         while (__raw_readl(IPU_MEM_RST) & 0x80000000)
439                 ;
440
441         ipu_init_dc_mappings();
442
443         __raw_writel(0, IPU_INT_CTRL(5));
444         __raw_writel(0, IPU_INT_CTRL(6));
445         __raw_writel(0, IPU_INT_CTRL(9));
446         __raw_writel(0, IPU_INT_CTRL(10));
447
448         /* DMFC Init */
449         ipu_dmfc_init(DMFC_NORMAL, 1);
450
451         /* Set sync refresh channels as high priority */
452         __raw_writel(0x18800000L, IDMAC_CHA_PRI(0));
453
454         /* Set MCU_T to divide MCU access window into 2 */
455         __raw_writel(0x00400000L | (IPU_MCU_T_DEFAULT << 18), IPU_DISP_GEN);
456
457         clk_disable(g_ipu_clk);
458
459         return 0;
460 }
461
462 void ipu_dump_registers(void)
463 {
464         debug("IPU_CONF             0x%08X\n", __raw_readl(IPU_CONF));
465         debug("IDMAC_CONF           0x%08X\n", __raw_readl(IDMAC_CONF));
466         debug("IDMAC_CHA_EN1        0x%08X\n",
467                __raw_readl(IDMAC_CHA_EN(0)));
468         debug("IDMAC_CHA_EN2        0x%08X\n",
469                __raw_readl(IDMAC_CHA_EN(32)));
470         debug("IDMAC_CHA_PRI1       0x%08X\n",
471                __raw_readl(IDMAC_CHA_PRI(0)));
472         debug("IDMAC_CHA_PRI2       0x%08X\n",
473                __raw_readl(IDMAC_CHA_PRI(32)));
474         debug("IPU_CHA_DB_MODE_SEL0 0x%08X\n",
475                __raw_readl(IPU_CHA_DB_MODE_SEL(0)));
476         debug("IPU_CHA_DB_MODE_SEL1 0x%08X\n",
477                __raw_readl(IPU_CHA_DB_MODE_SEL(32)));
478         debug("DMFC_WR_CHAN         0x%08X\n",
479                __raw_readl(DMFC_WR_CHAN));
480         debug("DMFC_WR_CHAN_DEF     0x%08X\n",
481                __raw_readl(DMFC_WR_CHAN_DEF));
482         debug("DMFC_DP_CHAN         0x%08X\n",
483                __raw_readl(DMFC_DP_CHAN));
484         debug("DMFC_DP_CHAN_DEF     0x%08X\n",
485                __raw_readl(DMFC_DP_CHAN_DEF));
486         debug("DMFC_IC_CTRL         0x%08X\n",
487                __raw_readl(DMFC_IC_CTRL));
488         debug("IPU_FS_PROC_FLOW1    0x%08X\n",
489                __raw_readl(IPU_FS_PROC_FLOW1));
490         debug("IPU_FS_PROC_FLOW2    0x%08X\n",
491                __raw_readl(IPU_FS_PROC_FLOW2));
492         debug("IPU_FS_PROC_FLOW3    0x%08X\n",
493                __raw_readl(IPU_FS_PROC_FLOW3));
494         debug("IPU_FS_DISP_FLOW1    0x%08X\n",
495                __raw_readl(IPU_FS_DISP_FLOW1));
496 }
497
498 /*
499  * This function is called to initialize a logical IPU channel.
500  *
501  * @param       channel Input parameter for the logical channel ID to init.
502  *
503  * @param       params  Input parameter containing union of channel
504  *                      initialization parameters.
505  *
506  * @return      Returns 0 on success or negative error code on fail
507  */
508 int32_t ipu_init_channel(ipu_channel_t channel, ipu_channel_params_t *params)
509 {
510         int ret = 0;
511         uint32_t ipu_conf;
512
513         debug("init channel = %d\n", IPU_CHAN_ID(channel));
514
515         if (g_ipu_clk_enabled == 0) {
516                 g_ipu_clk_enabled = 1;
517                 clk_enable(g_ipu_clk);
518         }
519
520
521         if (g_channel_init_mask & (1L << IPU_CHAN_ID(channel))) {
522                 printf("Warning: channel already initialized %d\n",
523                         IPU_CHAN_ID(channel));
524         }
525
526         ipu_conf = __raw_readl(IPU_CONF);
527
528         switch (channel) {
529         case MEM_DC_SYNC:
530                 if (params->mem_dc_sync.di > 1) {
531                         ret = -EINVAL;
532                         goto err;
533                 }
534
535                 g_dc_di_assignment[1] = params->mem_dc_sync.di;
536                 ipu_dc_init(1, params->mem_dc_sync.di,
537                              params->mem_dc_sync.interlaced);
538                 ipu_di_use_count[params->mem_dc_sync.di]++;
539                 ipu_dc_use_count++;
540                 ipu_dmfc_use_count++;
541                 break;
542         case MEM_BG_SYNC:
543                 if (params->mem_dp_bg_sync.di > 1) {
544                         ret = -EINVAL;
545                         goto err;
546                 }
547
548                 g_dc_di_assignment[5] = params->mem_dp_bg_sync.di;
549                 ipu_dp_init(channel, params->mem_dp_bg_sync.in_pixel_fmt,
550                              params->mem_dp_bg_sync.out_pixel_fmt);
551                 ipu_dc_init(5, params->mem_dp_bg_sync.di,
552                              params->mem_dp_bg_sync.interlaced);
553                 ipu_di_use_count[params->mem_dp_bg_sync.di]++;
554                 ipu_dc_use_count++;
555                 ipu_dp_use_count++;
556                 ipu_dmfc_use_count++;
557                 break;
558         case MEM_FG_SYNC:
559                 ipu_dp_init(channel, params->mem_dp_fg_sync.in_pixel_fmt,
560                              params->mem_dp_fg_sync.out_pixel_fmt);
561
562                 ipu_dc_use_count++;
563                 ipu_dp_use_count++;
564                 ipu_dmfc_use_count++;
565                 break;
566         default:
567                 printf("Missing channel initialization\n");
568                 break;
569         }
570
571         /* Enable IPU sub module */
572         g_channel_init_mask |= 1L << IPU_CHAN_ID(channel);
573         if (ipu_dc_use_count == 1)
574                 ipu_conf |= IPU_CONF_DC_EN;
575         if (ipu_dp_use_count == 1)
576                 ipu_conf |= IPU_CONF_DP_EN;
577         if (ipu_dmfc_use_count == 1)
578                 ipu_conf |= IPU_CONF_DMFC_EN;
579         if (ipu_di_use_count[0] == 1) {
580                 ipu_conf |= IPU_CONF_DI0_EN;
581         }
582         if (ipu_di_use_count[1] == 1) {
583                 ipu_conf |= IPU_CONF_DI1_EN;
584         }
585
586         __raw_writel(ipu_conf, IPU_CONF);
587
588 err:
589         return ret;
590 }
591
592 /*
593  * This function is called to uninitialize a logical IPU channel.
594  *
595  * @param       channel Input parameter for the logical channel ID to uninit.
596  */
597 void ipu_uninit_channel(ipu_channel_t channel)
598 {
599         uint32_t reg;
600         uint32_t in_dma, out_dma = 0;
601         uint32_t ipu_conf;
602
603         if ((g_channel_init_mask & (1L << IPU_CHAN_ID(channel))) == 0) {
604                 debug("Channel already uninitialized %d\n",
605                         IPU_CHAN_ID(channel));
606                 return;
607         }
608
609         /*
610          * Make sure channel is disabled
611          * Get input and output dma channels
612          */
613         in_dma = channel_2_dma(channel, IPU_OUTPUT_BUFFER);
614         out_dma = channel_2_dma(channel, IPU_VIDEO_IN_BUFFER);
615
616         if (idma_is_set(IDMAC_CHA_EN, in_dma) ||
617             idma_is_set(IDMAC_CHA_EN, out_dma)) {
618                 printf("Channel %d is not disabled, disable first\n",
619                         IPU_CHAN_ID(channel));
620                 return;
621         }
622
623         ipu_conf = __raw_readl(IPU_CONF);
624
625         /* Reset the double buffer */
626         reg = __raw_readl(IPU_CHA_DB_MODE_SEL(in_dma));
627         __raw_writel(reg & ~idma_mask(in_dma), IPU_CHA_DB_MODE_SEL(in_dma));
628         reg = __raw_readl(IPU_CHA_DB_MODE_SEL(out_dma));
629         __raw_writel(reg & ~idma_mask(out_dma), IPU_CHA_DB_MODE_SEL(out_dma));
630
631         switch (channel) {
632         case MEM_DC_SYNC:
633                 ipu_dc_uninit(1);
634                 ipu_di_use_count[g_dc_di_assignment[1]]--;
635                 ipu_dc_use_count--;
636                 ipu_dmfc_use_count--;
637                 break;
638         case MEM_BG_SYNC:
639                 ipu_dp_uninit(channel);
640                 ipu_dc_uninit(5);
641                 ipu_di_use_count[g_dc_di_assignment[5]]--;
642                 ipu_dc_use_count--;
643                 ipu_dp_use_count--;
644                 ipu_dmfc_use_count--;
645                 break;
646         case MEM_FG_SYNC:
647                 ipu_dp_uninit(channel);
648                 ipu_dc_use_count--;
649                 ipu_dp_use_count--;
650                 ipu_dmfc_use_count--;
651                 break;
652         default:
653                 break;
654         }
655
656         g_channel_init_mask &= ~(1L << IPU_CHAN_ID(channel));
657
658         if (ipu_dc_use_count == 0)
659                 ipu_conf &= ~IPU_CONF_DC_EN;
660         if (ipu_dp_use_count == 0)
661                 ipu_conf &= ~IPU_CONF_DP_EN;
662         if (ipu_dmfc_use_count == 0)
663                 ipu_conf &= ~IPU_CONF_DMFC_EN;
664         if (ipu_di_use_count[0] == 0) {
665                 ipu_conf &= ~IPU_CONF_DI0_EN;
666         }
667         if (ipu_di_use_count[1] == 0) {
668                 ipu_conf &= ~IPU_CONF_DI1_EN;
669         }
670
671         __raw_writel(ipu_conf, IPU_CONF);
672
673         /* clear interrupt status */
674         __raw_writel(__raw_readl(IPU_STAT), IPU_STAT);
675
676         if (ipu_conf == 0) {
677                 clk_disable(g_ipu_clk);
678                 g_ipu_clk_enabled = 0;
679         }
680 }
681
682 static inline void ipu_ch_param_dump(int ch)
683 {
684 #ifdef DEBUG
685         struct ipu_ch_param *p = ipu_ch_param_addr(ch);
686         debug("ch %d word 0 - %08X %08X %08X %08X %08X\n", ch,
687                  p->word[0].data[0], p->word[0].data[1], p->word[0].data[2],
688                  p->word[0].data[3], p->word[0].data[4]);
689         debug("ch %d word 1 - %08X %08X %08X %08X %08X\n", ch,
690                  p->word[1].data[0], p->word[1].data[1], p->word[1].data[2],
691                  p->word[1].data[3], p->word[1].data[4]);
692         debug("PFS 0x%x, ",
693                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 85, 4));
694         debug("BPP 0x%x, ",
695                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 0, 107, 3));
696         debug("NPB 0x%x\n",
697                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 78, 7));
698
699         debug("FW %d, ",
700                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 0, 125, 13));
701         debug("FH %d, ",
702                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 0, 138, 12));
703         debug("Stride %d\n",
704                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 102, 14));
705
706         debug("Width0 %d+1, ",
707                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 116, 3));
708         debug("Width1 %d+1, ",
709                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 119, 3));
710         debug("Width2 %d+1, ",
711                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 122, 3));
712         debug("Width3 %d+1, ",
713                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 125, 3));
714         debug("Offset0 %d, ",
715                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 128, 5));
716         debug("Offset1 %d, ",
717                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 133, 5));
718         debug("Offset2 %d, ",
719                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 138, 5));
720         debug("Offset3 %d\n",
721                  ipu_ch_param_read_field(ipu_ch_param_addr(ch), 1, 143, 5));
722 #endif
723 }
724
725 static inline void ipu_ch_params_set_packing(struct ipu_ch_param *p,
726                                               int red_width, int red_offset,
727                                               int green_width, int green_offset,
728                                               int blue_width, int blue_offset,
729                                               int alpha_width, int alpha_offset)
730 {
731         /* Setup red width and offset */
732         ipu_ch_param_set_field(p, 1, 116, 3, red_width - 1);
733         ipu_ch_param_set_field(p, 1, 128, 5, red_offset);
734         /* Setup green width and offset */
735         ipu_ch_param_set_field(p, 1, 119, 3, green_width - 1);
736         ipu_ch_param_set_field(p, 1, 133, 5, green_offset);
737         /* Setup blue width and offset */
738         ipu_ch_param_set_field(p, 1, 122, 3, blue_width - 1);
739         ipu_ch_param_set_field(p, 1, 138, 5, blue_offset);
740         /* Setup alpha width and offset */
741         ipu_ch_param_set_field(p, 1, 125, 3, alpha_width - 1);
742         ipu_ch_param_set_field(p, 1, 143, 5, alpha_offset);
743 }
744
745 static void ipu_ch_param_init(int ch,
746                               uint32_t pixel_fmt, uint32_t width,
747                               uint32_t height, uint32_t stride,
748                               uint32_t u, uint32_t v,
749                               uint32_t uv_stride, dma_addr_t addr0,
750                               dma_addr_t addr1)
751 {
752         uint32_t u_offset = 0;
753         uint32_t v_offset = 0;
754         struct ipu_ch_param params;
755
756         memset(&params, 0, sizeof(params));
757
758         ipu_ch_param_set_field(&params, 0, 125, 13, width - 1);
759
760         if ((ch == 8) || (ch == 9) || (ch == 10)) {
761                 ipu_ch_param_set_field(&params, 0, 138, 12, (height / 2) - 1);
762                 ipu_ch_param_set_field(&params, 1, 102, 14, (stride * 2) - 1);
763         } else {
764                 ipu_ch_param_set_field(&params, 0, 138, 12, height - 1);
765                 ipu_ch_param_set_field(&params, 1, 102, 14, stride - 1);
766         }
767
768         ipu_ch_param_set_field(&params, 1, 0, 29, addr0 >> 3);
769         ipu_ch_param_set_field(&params, 1, 29, 29, addr1 >> 3);
770
771         switch (pixel_fmt) {
772         case IPU_PIX_FMT_GENERIC:
773                 /*Represents 8-bit Generic data */
774                 ipu_ch_param_set_field(&params, 0, 107, 3, 5);  /* bits/pixel */
775                 ipu_ch_param_set_field(&params, 1, 85, 4, 6);   /* pix format */
776                 ipu_ch_param_set_field(&params, 1, 78, 7, 63);  /* burst size */
777
778                 break;
779         case IPU_PIX_FMT_GENERIC_32:
780                 /*Represents 32-bit Generic data */
781                 break;
782         case IPU_PIX_FMT_RGB565:
783                 ipu_ch_param_set_field(&params, 0, 107, 3, 3);  /* bits/pixel */
784                 ipu_ch_param_set_field(&params, 1, 85, 4, 7);   /* pix format */
785                 ipu_ch_param_set_field(&params, 1, 78, 7, 15);  /* burst size */
786
787                 ipu_ch_params_set_packing(&params, 5, 0, 6, 5, 5, 11, 8, 16);
788                 break;
789         case IPU_PIX_FMT_BGR24:
790                 ipu_ch_param_set_field(&params, 0, 107, 3, 1);  /* bits/pixel */
791                 ipu_ch_param_set_field(&params, 1, 85, 4, 7);   /* pix format */
792                 ipu_ch_param_set_field(&params, 1, 78, 7, 19);  /* burst size */
793
794                 ipu_ch_params_set_packing(&params, 8, 0, 8, 8, 8, 16, 8, 24);
795                 break;
796         case IPU_PIX_FMT_RGB24:
797         case IPU_PIX_FMT_YUV444:
798                 ipu_ch_param_set_field(&params, 0, 107, 3, 1);  /* bits/pixel */
799                 ipu_ch_param_set_field(&params, 1, 85, 4, 7);   /* pix format */
800                 ipu_ch_param_set_field(&params, 1, 78, 7, 19);  /* burst size */
801
802                 ipu_ch_params_set_packing(&params, 8, 16, 8, 8, 8, 0, 8, 24);
803                 break;
804         case IPU_PIX_FMT_BGRA32:
805         case IPU_PIX_FMT_BGR32:
806                 ipu_ch_param_set_field(&params, 0, 107, 3, 0);  /* bits/pixel */
807                 ipu_ch_param_set_field(&params, 1, 85, 4, 7);   /* pix format */
808                 ipu_ch_param_set_field(&params, 1, 78, 7, 15);  /* burst size */
809
810                 ipu_ch_params_set_packing(&params, 8, 8, 8, 16, 8, 24, 8, 0);
811                 break;
812         case IPU_PIX_FMT_RGBA32:
813         case IPU_PIX_FMT_RGB32:
814                 ipu_ch_param_set_field(&params, 0, 107, 3, 0);  /* bits/pixel */
815                 ipu_ch_param_set_field(&params, 1, 85, 4, 7);   /* pix format */
816                 ipu_ch_param_set_field(&params, 1, 78, 7, 15);  /* burst size */
817
818                 ipu_ch_params_set_packing(&params, 8, 24, 8, 16, 8, 8, 8, 0);
819                 break;
820         case IPU_PIX_FMT_ABGR32:
821                 ipu_ch_param_set_field(&params, 0, 107, 3, 0);  /* bits/pixel */
822                 ipu_ch_param_set_field(&params, 1, 85, 4, 7);   /* pix format */
823
824                 ipu_ch_params_set_packing(&params, 8, 0, 8, 8, 8, 16, 8, 24);
825                 break;
826         case IPU_PIX_FMT_UYVY:
827                 ipu_ch_param_set_field(&params, 0, 107, 3, 3);  /* bits/pixel */
828                 ipu_ch_param_set_field(&params, 1, 85, 4, 0xA); /* pix format */
829                 ipu_ch_param_set_field(&params, 1, 78, 7, 15);  /* burst size */
830                 break;
831         case IPU_PIX_FMT_YUYV:
832                 ipu_ch_param_set_field(&params, 0, 107, 3, 3);  /* bits/pixel */
833                 ipu_ch_param_set_field(&params, 1, 85, 4, 0x8); /* pix format */
834                 ipu_ch_param_set_field(&params, 1, 78, 7, 31);  /* burst size */
835                 break;
836         case IPU_PIX_FMT_YUV420P2:
837         case IPU_PIX_FMT_YUV420P:
838                 ipu_ch_param_set_field(&params, 1, 85, 4, 2);   /* pix format */
839
840                 if (uv_stride < stride / 2)
841                         uv_stride = stride / 2;
842
843                 u_offset = stride * height;
844                 v_offset = u_offset + (uv_stride * height / 2);
845                 /* burst size */
846                 if ((ch == 8) || (ch == 9) || (ch == 10)) {
847                         ipu_ch_param_set_field(&params, 1, 78, 7, 15);
848                         uv_stride = uv_stride*2;
849                 } else {
850                         ipu_ch_param_set_field(&params, 1, 78, 7, 31);
851                 }
852                 break;
853         case IPU_PIX_FMT_YVU422P:
854                 /* BPP & pixel format */
855                 ipu_ch_param_set_field(&params, 1, 85, 4, 1);   /* pix format */
856                 ipu_ch_param_set_field(&params, 1, 78, 7, 31);  /* burst size */
857
858                 if (uv_stride < stride / 2)
859                         uv_stride = stride / 2;
860
861                 v_offset = (v == 0) ? stride * height : v;
862                 u_offset = (u == 0) ? v_offset + v_offset / 2 : u;
863                 break;
864         case IPU_PIX_FMT_YUV422P:
865                 /* BPP & pixel format */
866                 ipu_ch_param_set_field(&params, 1, 85, 4, 1);   /* pix format */
867                 ipu_ch_param_set_field(&params, 1, 78, 7, 31);  /* burst size */
868
869                 if (uv_stride < stride / 2)
870                         uv_stride = stride / 2;
871
872                 u_offset = (u == 0) ? stride * height : u;
873                 v_offset = (v == 0) ? u_offset + u_offset / 2 : v;
874                 break;
875         case IPU_PIX_FMT_NV12:
876                 /* BPP & pixel format */
877                 ipu_ch_param_set_field(&params, 1, 85, 4, 4);   /* pix format */
878                 ipu_ch_param_set_field(&params, 1, 78, 7, 31);  /* burst size */
879                 uv_stride = stride;
880                 u_offset = (u == 0) ? stride * height : u;
881                 break;
882         default:
883                 printf("mxc ipu: unimplemented pixel format: %08x\n",
884                         pixel_fmt);
885         }
886
887
888         if (uv_stride)
889                 ipu_ch_param_set_field(&params, 1, 128, 14, uv_stride - 1);
890
891         /* Get the uv offset from user when need cropping */
892         if (u || v) {
893                 u_offset = u;
894                 v_offset = v;
895         }
896
897         /* UBO and VBO are 22-bit */
898         if (u_offset/8 > 0x3fffff)
899                 puts("The value of U offset exceeds IPU limitation\n");
900         if (v_offset/8 > 0x3fffff)
901                 puts("The value of V offset exceeds IPU limitation\n");
902
903         ipu_ch_param_set_field(&params, 0, 46, 22, u_offset / 8);
904         ipu_ch_param_set_field(&params, 0, 68, 22, v_offset / 8);
905
906         debug("initializing idma ch %d @ %p\n", ch, ipu_ch_param_addr(ch));
907         memcpy(ipu_ch_param_addr(ch), &params, sizeof(params));
908 };
909
910 /*
911  * This function is called to initialize a buffer for logical IPU channel.
912  *
913  * @param       channel         Input parameter for the logical channel ID.
914  *
915  * @param       type            Input parameter which buffer to initialize.
916  *
917  * @param       pixel_fmt       Input parameter for pixel format of buffer.
918  *                              Pixel format is a FOURCC ASCII code.
919  *
920  * @param       width           Input parameter for width of buffer in pixels.
921  *
922  * @param       height          Input parameter for height of buffer in pixels.
923  *
924  * @param       stride          Input parameter for stride length of buffer
925  *                              in pixels.
926  *
927  * @param       phyaddr_0       Input parameter buffer 0 physical address.
928  *
929  * @param       phyaddr_1       Input parameter buffer 1 physical address.
930  *                              Setting this to a value other than NULL enables
931  *                              double buffering mode.
932  *
933  * @param       u               private u offset for additional cropping,
934  *                              zero if not used.
935  *
936  * @param       v               private v offset for additional cropping,
937  *                              zero if not used.
938  *
939  * @return      Returns 0 on success or negative error code on fail
940  */
941 int32_t ipu_init_channel_buffer(ipu_channel_t channel, ipu_buffer_t type,
942                                 uint32_t pixel_fmt,
943                                 uint16_t width, uint16_t height,
944                                 uint32_t stride,
945                                 dma_addr_t phyaddr_0, dma_addr_t phyaddr_1,
946                                 uint32_t u, uint32_t v)
947 {
948         uint32_t reg;
949         uint32_t dma_chan;
950
951         dma_chan = channel_2_dma(channel, type);
952         if (!idma_is_valid(dma_chan))
953                 return -EINVAL;
954
955         if (stride < width * bytes_per_pixel(pixel_fmt))
956                 stride = width * bytes_per_pixel(pixel_fmt);
957
958         if (stride % 4) {
959                 printf("Stride not 32-bit aligned, stride = %d\n", stride);
960                 return -EINVAL;
961         }
962         /* Build parameter memory data for DMA channel */
963         ipu_ch_param_init(dma_chan, pixel_fmt, width, height, stride, u, v, 0,
964                            phyaddr_0, phyaddr_1);
965
966         if (ipu_is_dmfc_chan(dma_chan)) {
967                 ipu_dmfc_set_wait4eot(dma_chan, width);
968         }
969
970         if (idma_is_set(IDMAC_CHA_PRI, dma_chan))
971                 ipu_ch_param_set_high_priority(dma_chan);
972
973         ipu_ch_param_dump(dma_chan);
974
975         reg = __raw_readl(IPU_CHA_DB_MODE_SEL(dma_chan));
976         if (phyaddr_1)
977                 reg |= idma_mask(dma_chan);
978         else
979                 reg &= ~idma_mask(dma_chan);
980         __raw_writel(reg, IPU_CHA_DB_MODE_SEL(dma_chan));
981
982         /* Reset to buffer 0 */
983         __raw_writel(idma_mask(dma_chan), IPU_CHA_CUR_BUF(dma_chan));
984
985         return 0;
986 }
987
988 /*
989  * This function enables a logical channel.
990  *
991  * @param       channel         Input parameter for the logical channel ID.
992  *
993  * @return      This function returns 0 on success or negative error code on
994  *              fail.
995  */
996 int32_t ipu_enable_channel(ipu_channel_t channel)
997 {
998         uint32_t reg;
999         uint32_t in_dma;
1000         uint32_t out_dma;
1001
1002         if (g_channel_enable_mask & (1L << IPU_CHAN_ID(channel))) {
1003                 printf("Warning: channel already enabled %d\n",
1004                         IPU_CHAN_ID(channel));
1005         }
1006
1007         /* Get input and output dma channels */
1008         out_dma = channel_2_dma(channel, IPU_OUTPUT_BUFFER);
1009         in_dma = channel_2_dma(channel, IPU_VIDEO_IN_BUFFER);
1010
1011         if (idma_is_valid(in_dma)) {
1012                 reg = __raw_readl(IDMAC_CHA_EN(in_dma));
1013                 __raw_writel(reg | idma_mask(in_dma), IDMAC_CHA_EN(in_dma));
1014         }
1015         if (idma_is_valid(out_dma)) {
1016                 reg = __raw_readl(IDMAC_CHA_EN(out_dma));
1017                 __raw_writel(reg | idma_mask(out_dma), IDMAC_CHA_EN(out_dma));
1018         }
1019
1020         if ((channel == MEM_DC_SYNC) || (channel == MEM_BG_SYNC) ||
1021             (channel == MEM_FG_SYNC))
1022                 ipu_dp_dc_enable(channel);
1023
1024         g_channel_enable_mask |= 1L << IPU_CHAN_ID(channel);
1025
1026         return 0;
1027 }
1028
1029 /*
1030  * This function clear buffer ready for a logical channel.
1031  *
1032  * @param       channel         Input parameter for the logical channel ID.
1033  *
1034  * @param       type            Input parameter which buffer to clear.
1035  *
1036  * @param       bufNum          Input parameter for which buffer number clear
1037  *                              ready state.
1038  *
1039  */
1040 void ipu_clear_buffer_ready(ipu_channel_t channel, ipu_buffer_t type,
1041                 uint32_t bufNum)
1042 {
1043         uint32_t dma_ch = channel_2_dma(channel, type);
1044
1045         if (!idma_is_valid(dma_ch))
1046                 return;
1047
1048         __raw_writel(0xF0000000, IPU_GPR); /* write one to clear */
1049         if (bufNum == 0) {
1050                 if (idma_is_set(IPU_CHA_BUF0_RDY, dma_ch)) {
1051                         __raw_writel(idma_mask(dma_ch),
1052                                         IPU_CHA_BUF0_RDY(dma_ch));
1053                 }
1054         } else {
1055                 if (idma_is_set(IPU_CHA_BUF1_RDY, dma_ch)) {
1056                         __raw_writel(idma_mask(dma_ch),
1057                                         IPU_CHA_BUF1_RDY(dma_ch));
1058                 }
1059         }
1060         __raw_writel(0x0, IPU_GPR); /* write one to set */
1061 }
1062
1063 /*
1064  * This function disables a logical channel.
1065  *
1066  * @param       channel         Input parameter for the logical channel ID.
1067  *
1068  * @param       wait_for_stop   Flag to set whether to wait for channel end
1069  *                              of frame or return immediately.
1070  *
1071  * @return      This function returns 0 on success or negative error code on
1072  *              fail.
1073  */
1074 int32_t ipu_disable_channel(ipu_channel_t channel)
1075 {
1076         uint32_t reg;
1077         uint32_t in_dma;
1078         uint32_t out_dma;
1079
1080         if ((g_channel_enable_mask & (1L << IPU_CHAN_ID(channel))) == 0) {
1081                 debug("Channel already disabled %d\n",
1082                         IPU_CHAN_ID(channel));
1083                 return 0;
1084         }
1085
1086         /* Get input and output dma channels */
1087         out_dma = channel_2_dma(channel, IPU_OUTPUT_BUFFER);
1088         in_dma = channel_2_dma(channel, IPU_VIDEO_IN_BUFFER);
1089
1090         if ((idma_is_valid(in_dma) &&
1091                 !idma_is_set(IDMAC_CHA_EN, in_dma))
1092                 && (idma_is_valid(out_dma) &&
1093                 !idma_is_set(IDMAC_CHA_EN, out_dma)))
1094                 return -EINVAL;
1095
1096         if ((channel == MEM_BG_SYNC) || (channel == MEM_FG_SYNC) ||
1097             (channel == MEM_DC_SYNC)) {
1098                 ipu_dp_dc_disable(channel, 0);
1099         }
1100
1101         /* Disable DMA channel(s) */
1102         if (idma_is_valid(in_dma)) {
1103                 reg = __raw_readl(IDMAC_CHA_EN(in_dma));
1104                 __raw_writel(reg & ~idma_mask(in_dma), IDMAC_CHA_EN(in_dma));
1105                 __raw_writel(idma_mask(in_dma), IPU_CHA_CUR_BUF(in_dma));
1106         }
1107         if (idma_is_valid(out_dma)) {
1108                 reg = __raw_readl(IDMAC_CHA_EN(out_dma));
1109                 __raw_writel(reg & ~idma_mask(out_dma), IDMAC_CHA_EN(out_dma));
1110                 __raw_writel(idma_mask(out_dma), IPU_CHA_CUR_BUF(out_dma));
1111         }
1112
1113         g_channel_enable_mask &= ~(1L << IPU_CHAN_ID(channel));
1114
1115         /* Set channel buffers NOT to be ready */
1116         if (idma_is_valid(in_dma)) {
1117                 ipu_clear_buffer_ready(channel, IPU_VIDEO_IN_BUFFER, 0);
1118                 ipu_clear_buffer_ready(channel, IPU_VIDEO_IN_BUFFER, 1);
1119         }
1120         if (idma_is_valid(out_dma)) {
1121                 ipu_clear_buffer_ready(channel, IPU_OUTPUT_BUFFER, 0);
1122                 ipu_clear_buffer_ready(channel, IPU_OUTPUT_BUFFER, 1);
1123         }
1124
1125         return 0;
1126 }
1127
1128 uint32_t bytes_per_pixel(uint32_t fmt)
1129 {
1130         switch (fmt) {
1131         case IPU_PIX_FMT_GENERIC:       /* generic data */
1132         case IPU_PIX_FMT_RGB332:
1133         case IPU_PIX_FMT_YUV420P:
1134         case IPU_PIX_FMT_YUV422P:
1135                 return 1;
1136         case IPU_PIX_FMT_RGB565:
1137         case IPU_PIX_FMT_YUYV:
1138         case IPU_PIX_FMT_UYVY:
1139                 return 2;
1140         case IPU_PIX_FMT_BGR24:
1141         case IPU_PIX_FMT_RGB24:
1142                 return 3;
1143         case IPU_PIX_FMT_GENERIC_32:    /* generic data */
1144         case IPU_PIX_FMT_BGR32:
1145         case IPU_PIX_FMT_BGRA32:
1146         case IPU_PIX_FMT_RGB32:
1147         case IPU_PIX_FMT_RGBA32:
1148         case IPU_PIX_FMT_ABGR32:
1149                 return 4;
1150         default:
1151                 return 1;
1152         }
1153         return 0;
1154 }
1155
1156 ipu_color_space_t format_to_colorspace(uint32_t fmt)
1157 {
1158         switch (fmt) {
1159         case IPU_PIX_FMT_RGB666:
1160         case IPU_PIX_FMT_RGB565:
1161         case IPU_PIX_FMT_BGR24:
1162         case IPU_PIX_FMT_RGB24:
1163         case IPU_PIX_FMT_BGR32:
1164         case IPU_PIX_FMT_BGRA32:
1165         case IPU_PIX_FMT_RGB32:
1166         case IPU_PIX_FMT_RGBA32:
1167         case IPU_PIX_FMT_ABGR32:
1168         case IPU_PIX_FMT_LVDS666:
1169         case IPU_PIX_FMT_LVDS888:
1170                 return RGB;
1171
1172         default:
1173                 return YCbCr;
1174         }
1175         return RGB;
1176 }