2 * Author: Yevgeniy Kiveisha <yevgeniy.kiveisha@intel.com>
3 * Copyright (c) 2014 Intel Corporation.
5 * Permission is hereby granted, free of charge, to any person obtaining
6 * a copy of this software and associated documentation files (the
7 * "Software"), to deal in the Software without restriction, including
8 * without limitation the rights to use, copy, modify, merge, publish,
9 * distribute, sublicense, and/or sell copies of the Software, and to
10 * permit persons to whom the Software is furnished to do so, subject to
11 * the following conditions:
13 * The above copyright notice and this permission notice shall be
14 * included in all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
32 #define DISPLAY_CMD_OFF 0xAE
33 #define DISPLAY_CMD_ON 0xAF
35 #define BASE_LOW_COLUMN_ADDR 0x00
36 #define BASE_HIGH_COLUMN_ADDR 0x10
37 #define BASE_PAGE_START_ADDR 0xB0
38 #define DISPLAY_CMD_MEM_ADDR_MODE 0x20
40 #define DISPLAY_CMD_SET_NORMAL 0xA6
42 const uint8_t BasicFont[][8] =
44 {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},
45 {0x00,0x00,0x5F,0x00,0x00,0x00,0x00,0x00},
46 {0x00,0x00,0x07,0x00,0x07,0x00,0x00,0x00},
47 {0x00,0x14,0x7F,0x14,0x7F,0x14,0x00,0x00},
48 {0x00,0x24,0x2A,0x7F,0x2A,0x12,0x00,0x00},
49 {0x00,0x23,0x13,0x08,0x64,0x62,0x00,0x00},
50 {0x00,0x36,0x49,0x55,0x22,0x50,0x00,0x00},
51 {0x00,0x00,0x05,0x03,0x00,0x00,0x00,0x00},
52 {0x00,0x1C,0x22,0x41,0x00,0x00,0x00,0x00},
53 {0x00,0x41,0x22,0x1C,0x00,0x00,0x00,0x00},
54 {0x00,0x08,0x2A,0x1C,0x2A,0x08,0x00,0x00},
55 {0x00,0x08,0x08,0x3E,0x08,0x08,0x00,0x00},
56 {0x00,0xA0,0x60,0x00,0x00,0x00,0x00,0x00},
57 {0x00,0x08,0x08,0x08,0x08,0x08,0x00,0x00},
58 {0x00,0x60,0x60,0x00,0x00,0x00,0x00,0x00},
59 {0x00,0x20,0x10,0x08,0x04,0x02,0x00,0x00},
60 {0x00,0x3E,0x51,0x49,0x45,0x3E,0x00,0x00},
61 {0x00,0x00,0x42,0x7F,0x40,0x00,0x00,0x00},
62 {0x00,0x62,0x51,0x49,0x49,0x46,0x00,0x00},
63 {0x00,0x22,0x41,0x49,0x49,0x36,0x00,0x00},
64 {0x00,0x18,0x14,0x12,0x7F,0x10,0x00,0x00},
65 {0x00,0x27,0x45,0x45,0x45,0x39,0x00,0x00},
66 {0x00,0x3C,0x4A,0x49,0x49,0x30,0x00,0x00},
67 {0x00,0x01,0x71,0x09,0x05,0x03,0x00,0x00},
68 {0x00,0x36,0x49,0x49,0x49,0x36,0x00,0x00},
69 {0x00,0x06,0x49,0x49,0x29,0x1E,0x00,0x00},
70 {0x00,0x00,0x36,0x36,0x00,0x00,0x00,0x00},
71 {0x00,0x00,0xAC,0x6C,0x00,0x00,0x00,0x00},
72 {0x00,0x08,0x14,0x22,0x41,0x00,0x00,0x00},
73 {0x00,0x14,0x14,0x14,0x14,0x14,0x00,0x00},
74 {0x00,0x41,0x22,0x14,0x08,0x00,0x00,0x00},
75 {0x00,0x02,0x01,0x51,0x09,0x06,0x00,0x00},
76 {0x00,0x32,0x49,0x79,0x41,0x3E,0x00,0x00},
77 {0x00,0x7E,0x09,0x09,0x09,0x7E,0x00,0x00},
78 {0x00,0x7F,0x49,0x49,0x49,0x36,0x00,0x00},
79 {0x00,0x3E,0x41,0x41,0x41,0x22,0x00,0x00},
80 {0x00,0x7F,0x41,0x41,0x22,0x1C,0x00,0x00},
81 {0x00,0x7F,0x49,0x49,0x49,0x41,0x00,0x00},
82 {0x00,0x7F,0x09,0x09,0x09,0x01,0x00,0x00},
83 {0x00,0x3E,0x41,0x41,0x51,0x72,0x00,0x00},
84 {0x00,0x7F,0x08,0x08,0x08,0x7F,0x00,0x00},
85 {0x00,0x41,0x7F,0x41,0x00,0x00,0x00,0x00},
86 {0x00,0x20,0x40,0x41,0x3F,0x01,0x00,0x00},
87 {0x00,0x7F,0x08,0x14,0x22,0x41,0x00,0x00},
88 {0x00,0x7F,0x40,0x40,0x40,0x40,0x00,0x00},
89 {0x00,0x7F,0x02,0x0C,0x02,0x7F,0x00,0x00},
90 {0x00,0x7F,0x04,0x08,0x10,0x7F,0x00,0x00},
91 {0x00,0x3E,0x41,0x41,0x41,0x3E,0x00,0x00},
92 {0x00,0x7F,0x09,0x09,0x09,0x06,0x00,0x00},
93 {0x00,0x3E,0x41,0x51,0x21,0x5E,0x00,0x00},
94 {0x00,0x7F,0x09,0x19,0x29,0x46,0x00,0x00},
95 {0x00,0x26,0x49,0x49,0x49,0x32,0x00,0x00},
96 {0x00,0x01,0x01,0x7F,0x01,0x01,0x00,0x00},
97 {0x00,0x3F,0x40,0x40,0x40,0x3F,0x00,0x00},
98 {0x00,0x1F,0x20,0x40,0x20,0x1F,0x00,0x00},
99 {0x00,0x3F,0x40,0x38,0x40,0x3F,0x00,0x00},
100 {0x00,0x63,0x14,0x08,0x14,0x63,0x00,0x00},
101 {0x00,0x03,0x04,0x78,0x04,0x03,0x00,0x00},
102 {0x00,0x61,0x51,0x49,0x45,0x43,0x00,0x00},
103 {0x00,0x7F,0x41,0x41,0x00,0x00,0x00,0x00},
104 {0x00,0x02,0x04,0x08,0x10,0x20,0x00,0x00},
105 {0x00,0x41,0x41,0x7F,0x00,0x00,0x00,0x00},
106 {0x00,0x04,0x02,0x01,0x02,0x04,0x00,0x00},
107 {0x00,0x80,0x80,0x80,0x80,0x80,0x00,0x00},
108 {0x00,0x01,0x02,0x04,0x00,0x00,0x00,0x00},
109 {0x00,0x20,0x54,0x54,0x54,0x78,0x00,0x00},
110 {0x00,0x7F,0x48,0x44,0x44,0x38,0x00,0x00},
111 {0x00,0x38,0x44,0x44,0x28,0x00,0x00,0x00},
112 {0x00,0x38,0x44,0x44,0x48,0x7F,0x00,0x00},
113 {0x00,0x38,0x54,0x54,0x54,0x18,0x00,0x00},
114 {0x00,0x08,0x7E,0x09,0x02,0x00,0x00,0x00},
115 {0x00,0x18,0xA4,0xA4,0xA4,0x7C,0x00,0x00},
116 {0x00,0x7F,0x08,0x04,0x04,0x78,0x00,0x00},
117 {0x00,0x00,0x7D,0x00,0x00,0x00,0x00,0x00},
118 {0x00,0x80,0x84,0x7D,0x00,0x00,0x00,0x00},
119 {0x00,0x7F,0x10,0x28,0x44,0x00,0x00,0x00},
120 {0x00,0x41,0x7F,0x40,0x00,0x00,0x00,0x00},
121 {0x00,0x7C,0x04,0x18,0x04,0x78,0x00,0x00},
122 {0x00,0x7C,0x08,0x04,0x7C,0x00,0x00,0x00},
123 {0x00,0x38,0x44,0x44,0x38,0x00,0x00,0x00},
124 {0x00,0xFC,0x24,0x24,0x18,0x00,0x00,0x00},
125 {0x00,0x18,0x24,0x24,0xFC,0x00,0x00,0x00},
126 {0x00,0x00,0x7C,0x08,0x04,0x00,0x00,0x00},
127 {0x00,0x48,0x54,0x54,0x24,0x00,0x00,0x00},
128 {0x00,0x04,0x7F,0x44,0x00,0x00,0x00,0x00},
129 {0x00,0x3C,0x40,0x40,0x7C,0x00,0x00,0x00},
130 {0x00,0x1C,0x20,0x40,0x20,0x1C,0x00,0x00},
131 {0x00,0x3C,0x40,0x30,0x40,0x3C,0x00,0x00},
132 {0x00,0x44,0x28,0x10,0x28,0x44,0x00,0x00},
133 {0x00,0x1C,0xA0,0xA0,0x7C,0x00,0x00,0x00},
134 {0x00,0x44,0x64,0x54,0x4C,0x44,0x00,0x00},
135 {0x00,0x08,0x36,0x41,0x00,0x00,0x00,0x00},
136 {0x00,0x00,0x7F,0x00,0x00,0x00,0x00,0x00},
137 {0x00,0x41,0x36,0x08,0x00,0x00,0x00,0x00},
138 {0x00,0x02,0x01,0x01,0x02,0x01,0x00,0x00},
139 {0x00,0x02,0x05,0x05,0x02,0x00,0x00,0x00}
146 } displayAddressingMode;
149 * @brief C++ API for SSD1308 i2c controlled OLED displays
151 * @snippet lcm-lcd.cxx Interesting
153 class SSD1308 : public I2CLcd {
156 * SSD1308 Constructor, calls libmraa initialisation functions
158 * @param bus i2c bus to use
159 * @param address the slave address the lcd is registered on
161 SSD1308 (int bus, int address);
167 * Draw an image, see examples/python/make_oled_pic.py for an
168 * explanation on how the pixels are mapped to bytes
170 * @param data the buffer to read
171 * @param bytes the amount of bytes to read from the pointer
172 * @return Result of operation
174 mraa_result_t draw(uint8_t *data, int bytes);
176 * Write a string to LCD
178 * @param msg The std::string to write to display, note only ascii
179 * chars are supported
180 * @return Result of operation
182 mraa_result_t write(std::string msg);
184 * Set cursor to a coordinate
186 * @param row The row to set cursor to
187 * @param column The column to set cursor to
188 * @return Result of operation
190 mraa_result_t setCursor(int row, int column);
192 * Clear display from characters
194 * @return Result of operatio
196 mraa_result_t clear();
198 * Return to coordinate 0,0
200 * @return Result of operation
202 mraa_result_t home();
204 mraa_result_t writeChar (mraa_i2c_context ctx, uint8_t value);
205 mraa_result_t setNormalDisplay ();
206 mraa_result_t setAddressingMode (displayAddressingMode mode);