-
Notifications
You must be signed in to change notification settings - Fork 5
/
ST7036.h
251 lines (185 loc) · 7.3 KB
/
ST7036.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
/* ************************************************************************
*
* ST7036 display controller
*
* (c) 2019-2020 by Markus Reschke
*
* ************************************************************************ */
/* ************************************************************************
* I2C
* ************************************************************************ */
/*
* I2C slave addreses
*/
#define ST7036_I2C_ADDR_0 0b00111100 /* A1=0 A0=0 0x3c */
#define ST7036_I2C_ADDR_1 0b00111101 /* A1=0 A0=1 0x3d */
#define ST7036_I2C_ADDR_2 0b00111110 /* A1=1 A0=0 0x3e */
#define ST7036_I2C_ADDR_3 0b00111111 /* A1=1 A0=1 0x3f */
/*
* I2C control byte
*/
#define LCD_CONTROL_BYTE 0b00000000 /* 0x00 */
/* continuation flag */
#define FLAG_CTRL_MULTI 0b00000000 /* stream of bytes follows */
#define FLAG_CTRL_SINGLE 0b10000000 /* only 1 byte follows */
/* RS */
#define FLAG_CTRL_CMD 0b00000000 /* command follows */
#define FLAG_CTRL_DATA 0b01000000 /* data follows */
/* ************************************************************************
* commands
* ************************************************************************ */
/*
* clear display
* - 1 byte cmd
* - modes: normal & extension
* - exec time: 1.08ms
*/
#define CMD_CLEAR 0b00000001 /* clear display */
/*
* return home
* - 1 byte cmd
* - modes: normal & extension
* - exec time: 1.08ms
*/
#define CMD_HOME 0b00000010 /* return home */
/*
* entry mode set
* - 1 byte cmd
* - modes: normal & extension
* - exec time: 26.3µs
*/
#define CMD_ENTRY_MODE 0b00000100 /* entry mode set */
#define FLAG_CURSOR_DECREASE 0b00000000 /* auto-decrease cursor position */
#define FLAG_CURSOR_INCREASE 0b00000010 /* auto-increase cursor position */
#define FLAG_DISPLAY_NOSHIFT 0b00000000 /* enable display auto-shift */
#define FLAG_DISPLAY_SHIFT 0b00000001 /* disable display auto-shift */
/*
* display control
* - 1 byte cmd
* - modes: normal & extension
* - exec time: 26.3µs
*/
#define CMD_DISPLAY_CONTROL 0b00001000 /* display control */
#define FLAG_DISPLAY_OFF 0b00000000 /* display off */
#define FLAG_DISPLAY_ON 0b00000100 /* display on */
#define FLAG_CURSOR_OFF 0b00000000 /* cursor off */
#define FLAG_CURSOR_ON 0b00000010 /* cursor on */
#define FLAG_BLINK_OFF 0b00000000 /* blinking off */
#define FLAG_BLINK_ON 0b00000001 /* blinking on */
/*
* cursor/display shift
* - 1 byte cmd
* - modes: normal & extension (instruction table 0)
* - exec time: 26.3µs
*/
#define CMD_SHIFT 0b00010000 /* shift */
#define FLAG_SHIFT_CURSOR 0b00000000 /* shift cursor */
#define FLAG_SHIFT_DISPLAY 0b00001000 /* shift display */
#define FLAG_SHIFT_LEFT 0b00000000 /* shift left */
#define FLAG_SHIFT_RIGHT 0b00000100 /* shift right */
/*
* bias set
* - 1 byte cmd
* - modes: extension (instruction table 1)
* - exec time: 26.3µs
*/
#define CMD_BIAS 0b00010100 /* set bias */
#define FLAG_BIAS_5 0b00000000 /* bias 1/5 */
#define FLAG_BIAS_4 0b00001000 /* bias 1/4 */
#define FLAG_12LINE 0b00000000 /* 1 or 2-line mode */
#define FLAG_3LINE 0b00000001 /* 3-line mode */
/*
* double height position select (when 5x16 font is enabled)
* - 1 byte cmd
* - modes: extension (instruction table 2)
* - exec time: 26.3µs
*/
#define CMD_DOUBLEHEIGHT_POS 0b00010000 /* double height position */
#define FLAG_DOUBLE_BOTTOM 0b00000000 /* 5x16 font for bottom line */
#define FLAG_DOUBLE_TOP 0b00001000 /* 5x16 font for top line */
/*
* function set
* - 1 byte cmd
* - modes: normal & extension
* - exec time: 26.3µs
*/
#define CMD_FUNCTION_SET 0b00100000 /* function set */
#define FLAG_INTERFACE_4BIT 0b00000000 /* enable 4 bit data interface */
#define FLAG_INTERFACE_8BIT 0b00010000 /* enable 8 bit data interface */
#define FLAG_LINES_1 0b00000000 /* display one line */
#define FLAG_LINES_2 0b00001000 /* display two lines */
/* must be also set for 3-line mode */
/* additional flags for extension mode */
#define FLAG_FONT_5X8 0b00000000 /* select 5x8 font */
#define FLAG_FONT_5X16 0b00000100 /* select 5x16 font */
#define FLAG_INST_TABLE_0 0b00000000 /* instruction table 0 */
#define FLAG_INST_TABLE_1 0b00000001 /* instruction table 1 */
#define FLAG_INST_TABLE_2 0b00000010 /* instruction table 2 */
/*
* set CGRAM address (custom character)
* - 1 byte cmd
* - modes: normal & extension (instruction table 0)
* - exec time: 26.3µs
*/
#define CMD_SET_CGRAM 0b01000000 /* set CGRAM address */
/*
* set ICON address (?)
* - 1 byte cmd
* - modes: extension (instruction table 1)
* - exec time: 26.3µs
* - valid address range: 00-0F
*/
#define CMD_SET_ICON 0b01000000 /* set ICON address */
/*
* power, ICON control and contrast set (high bits)
* - 1 byte cmd
* - modes: extension (instruction table 1)
* - exec time: 26.3µs
* - contrast: upper 2 bits (of 6 bits, valid range 0-63)
*/
#define CMD_MISC_CONTROL 0b01010000 /* set misc stuff */
#define FLAG_ICON_OFF 0b00000000 /* disable display of ICON */
#define FLAG_ICON_ON 0b00001000 /* enable display of ICON */
#define FLAG_BOOSTER_OFF 0b00000000 /* disable booster circuit */
#define FLAG_BOOSTER_ON 0b00000100 /* enable booster circuit */
/* bits 0-1: upper 2 bits of contrast */
/*
* voltage follower control
* - 1 byte cmd
* - modes: extension (instruction table 1)
* - exec time: 26.3µs
*/
#define CMD_FOLLOWER 0b01100000 /* follower control */
#define FLAG_FOLLOWER_OFF 0b00000000 /* disable internal follower */
#define FLAG_FOLLOWER_ON 0b00001000 /* enable internal follower */
/* bits 0-2: V0 generator ratio */
#define FLAG_FOLLOWER_100 0b00000000 /* factor 1.00 */
#define FLAG_FOLLOWER_125 0b00000001 /* factor 1.25 */
#define FLAG_FOLLOWER_150 0b00000010 /* factor 1.50 */
#define FLAG_FOLLOWER_180 0b00000011 /* factor 1.80 */
#define FLAG_FOLLOWER_200 0b00000100 /* factor 2.00 */
#define FLAG_FOLLOWER_250 0b00000101 /* factor 2.50 */
#define FLAG_FOLLOWER_300 0b00000110 /* factor 3.00 */
#define FLAG_FOLLOWER_375 0b00000111 /* factor 3.75 */
/*
* contrast set (low bits)
* - 1 byte cmd
* - modes: extension (instruction table 1)
* - exec time: 26.3µs
* - contrast: lower 4 bits (of 6 bits, valid range 0-63)
*/
#define CMD_CONTRAST 0b01110000 /* set contrast */
/*
* set DDRAM address (cursor position)
* - 1 byte cmd
* - modes: normal & extension
* - exec time: 26.3µs
* - valid address ranges:
* 1-line mode: 00-4F
* 2-line mode: 00-27, 40-67
* 3-line mode: 00-0F, 10-1F, 20-2F
*/
#define CMD_SET_DDRAM 0b10000000 /* set DDRAM address */
/* ************************************************************************
* EOF
* ************************************************************************ */