rit128x96: allow to define starting x and y coordinates with rit128x96_blitRaw().
[bertos.git] / bertos / drv / lcd_rit128x96.c
1 /**
2  * \file
3  * <!--
4  * This file is part of BeRTOS.
5  *
6  * Bertos is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
19  *
20  * As a special exception, you may use this file as part of a free software
21  * library without restriction.  Specifically, if other files instantiate
22  * templates or use macros or inline functions from this file, or you compile
23  * this file and link it with other files to produce an executable, this
24  * file does not by itself cause the resulting executable to be covered by
25  * the GNU General Public License.  This exception does not however
26  * invalidate any other reasons why the executable file might be covered by
27  * the GNU General Public License.
28  *
29  * Copyright 2010 Develer S.r.l. (http://www.develer.com/)
30  *
31  * -->
32  *
33  * \brief OLED-RIT-128x96 (P14201) graphic display driver
34  *
35  * \author Andrea Righi <arighi@develer.com>
36  */
37
38 #include <cfg/debug.h>
39 #include <cfg/macros.h>
40
41 #include "lcd_rit128x96.h"
42
43 /*
44  * Hard-coded command initialization sequence.
45  *
46  * NOTE: the first byte is the size of the command.
47  */
48 static const uint8_t init_cmd[] =
49 {
50         /* Unlock commands */
51         3, 0xfd, 0x12, 0xe3,
52         /* Display off */
53         2, 0xae, 0xe3,
54         /* Icon off */
55         3, 0x94, 0, 0xe3,
56         /* Multiplex ratio */
57         3, 0xa8, 95, 0xe3,
58         /* Contrast */
59         3, 0x81, 0xb7, 0xe3,
60         /* Pre-charge current */
61         3, 0x82, 0x3f, 0xe3,
62         /* Display Re-map */
63         3, 0xa0, 0x52, 0xe3,
64         /* Display Start Line */
65         3, 0xa1, 0, 0xe3,
66         /* Display Offset */
67         3, 0xa2, 0x00, 0xe3,
68         /* Display Mode Normal */
69         2, 0xa4, 0xe3,
70         /* Phase Length */
71         3, 0xb1, 0x11, 0xe3,
72         /* Frame frequency */
73         3, 0xb2, 0x23, 0xe3,
74         /* Front Clock Divider */
75         3, 0xb3, 0xe2, 0xe3,
76         /* Set gray scale table */
77         17, 0xb8, 1, 2, 3, 4, 5, 6, 8, 10, 12, 14, 16, 19, 22, 26, 30, 0xe3,
78         /* Second pre-charge period */
79         3, 0xbb, 0x01, 0xe3,
80         /* Pre-charge voltage */
81         3, 0xbc, 0x3f, 0xe3,
82         /* Display ON */
83         2, 0xaf, 0xe3,
84 };
85
86 /*
87  * Hard-coded command shutdown sequence.
88  */
89 static const uint8_t exit_cmd[] =
90 {
91         /* Display OFF */
92         0xae, 0xe3
93 };
94
95 /*
96  * Hard-coded horizontal increment command.
97  */
98 static const uint8_t horizontal_inc[] =
99 {
100         0xa0, 0x52
101 };
102
103 /**
104  * Write a sequence of data bytes to the LCD controller
105  */
106 static void lcd_dataWrite(const uint8_t *buf, size_t count)
107 {
108         while (count--)
109                 LCD_WRITE(*buf++);
110 }
111
112 /* Turn on the OLED display */
113 void rit128x96_on(void)
114 {
115         unsigned int i;
116
117         /* Loop through the SSD1329 controller initialization sequence */
118         LCD_SET_COMMAND();
119         for (i = 0; i < sizeof(init_cmd); i += init_cmd[i] + 1)
120                 lcd_dataWrite(init_cmd + i + 1, init_cmd[i] - 1);
121 }
122
123 /* Turn off the OLED display */
124 void rit128x96_off(void)
125 {
126         LCD_SET_COMMAND();
127         lcd_dataWrite(exit_cmd, sizeof(exit_cmd));
128 }
129
130 static void lcd_start_blit(uint8_t x, uint8_t y, uint8_t width, uint8_t height)
131 {
132         uint8_t buffer[3];
133
134         ASSERT(width == LCD_WIDTH && height == LCD_HEIGHT);
135
136         /* Enter command mode */
137         LCD_SET_COMMAND();
138
139         buffer[0] = 0x15;
140         buffer[1] = x / 2;
141         buffer[2] = (x + width - 2) / 2;
142         lcd_dataWrite(buffer, 3);
143
144         buffer[0] = 0x75;
145         buffer[1] = y;
146         buffer[2] = y + height - 1;
147         lcd_dataWrite(buffer, 3);
148         lcd_dataWrite((const uint8_t *)&horizontal_inc, sizeof(horizontal_inc));
149 }
150
151 /* Refresh a raw image on screen */
152 void rit128x96_blitRaw(const uint8_t *data,
153                 uint8_t x, uint8_t y, uint8_t width, uint8_t height)
154 {
155         lcd_start_blit(x, y, width, height);
156         /*
157          * Enter data mode and send the encoded image data to the OLED display,
158          * over the SSI bus.
159          */
160         LCD_SET_DATA();
161         while (height--)
162         {
163                 /* Write an entire row at once */
164                 lcd_dataWrite(data, width / 2);
165                 data += width / 2;
166         }
167 }
168
169 /* Refresh a bitmap on screen */
170 void rit128x96_blitBitmap(const Bitmap *bm)
171 {
172         uint8_t lcd_row[bm->width / 2];
173         uint8_t mask;
174         int i, l;
175
176         lcd_start_blit(0, 0, bm->width, bm->height);
177         /*
178          * Enter data mode and send the encoded image data to the OLED display,
179          * over the SSI bus.
180          */
181         LCD_SET_DATA();
182         for (l = 0; l < bm->height / 8; l++)
183         {
184                 for (mask = 1; mask; mask <<= 1)
185                 {
186                         for (i = 0; i < bm->width; i++)
187                         {
188                                 if (bm->raster[l * bm->width + i] & mask)
189                                         lcd_row[i / 2] |= i & 1 ? 0x0f : 0xf0;
190                                 else
191                                         lcd_row[i / 2] &= i & 1 ? 0xf0 : 0x0f;
192                         }
193                         /* Write an entire row at once */
194                         lcd_dataWrite(lcd_row, sizeof(lcd_row));
195                 }
196         }
197 }
198
199 /* Initialize the OLED display */
200 void rit128x96_init(void)
201 {
202         /* Initialize the communication bus */
203         lcd_bus_init();
204
205         /* Turn on the OLED display */
206         rit128x96_on();
207 }