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
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
|
/*
Driver for the SAA5246A or SAA5281 Teletext (=Videotext) decoder chips from
Philips.
Copyright (C) 2004 Michael Geng (linux@MichaelGeng.de)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#ifndef __SAA5246A_H__
#define __SAA5246A_H__
#define MAJOR_VERSION 1 /* driver major version number */
#define MINOR_VERSION 8 /* driver minor version number */
#define IF_NAME "SAA5246A"
#define I2C_ADDRESS 17
/* Number of DAUs = number of pages that can be searched at the same time. */
#define NUM_DAUS 4
#define NUM_ROWS_PER_PAGE 40
/* first column is 0 (not 1) */
#define POS_TIME_START 32
#define POS_TIME_END 39
#define POS_HEADER_START 7
#define POS_HEADER_END 31
/* Returns 'true' if the part of the videotext page described with req contains
(at least parts of) the time field */
#define REQ_CONTAINS_TIME(p_req) \
((p_req)->start <= POS_TIME_END && \
(p_req)->end >= POS_TIME_START)
/* Returns 'true' if the part of the videotext page described with req contains
(at least parts of) the page header */
#define REQ_CONTAINS_HEADER(p_req) \
((p_req)->start <= POS_HEADER_END && \
(p_req)->end >= POS_HEADER_START)
/*****************************************************************************/
/* Mode register numbers of the SAA5246A */
/*****************************************************************************/
#define SAA5246A_REGISTER_R0 0
#define SAA5246A_REGISTER_R1 1
#define SAA5246A_REGISTER_R2 2
#define SAA5246A_REGISTER_R3 3
#define SAA5246A_REGISTER_R4 4
#define SAA5246A_REGISTER_R5 5
#define SAA5246A_REGISTER_R6 6
#define SAA5246A_REGISTER_R7 7
#define SAA5246A_REGISTER_R8 8
#define SAA5246A_REGISTER_R9 9
#define SAA5246A_REGISTER_R10 10
#define SAA5246A_REGISTER_R11 11
#define SAA5246A_REGISTER_R11B 11
/* SAA5246A mode registers often autoincrement to the next register.
Therefore we use variable argument lists. The following macro indicates
the end of a command list. */
#define COMMAND_END (- 1)
/*****************************************************************************/
/* Contents of the mode registers of the SAA5246A */
/*****************************************************************************/
/* Register R0 (Advanced Control) */
#define R0_SELECT_R11 0x00
#define R0_SELECT_R11B 0x01
#define R0_PLL_TIME_CONSTANT_LONG 0x00
#define R0_PLL_TIME_CONSTANT_SHORT 0x02
#define R0_ENABLE_nODD_EVEN_OUTPUT 0x00
#define R0_DISABLE_nODD_EVEN_OUTPUT 0x04
#define R0_ENABLE_HDR_POLL 0x00
#define R0_DISABLE_HDR_POLL 0x10
#define R0_DO_NOT_FORCE_nODD_EVEN_LOW_IF_PICTURE_DISPLAYED 0x00
#define R0_FORCE_nODD_EVEN_LOW_IF_PICTURE_DISPLAYED 0x20
#define R0_NO_FREE_RUN_PLL 0x00
#define R0_FREE_RUN_PLL 0x40
#define R0_NO_AUTOMATIC_FASTEXT_PROMPT 0x00
#define R0_AUTOMATIC_FASTEXT_PROMPT 0x80
/* Register R1 (Mode) */
#define R1_INTERLACED_312_AND_HALF_312_AND_HALF_LINES 0x00
#define R1_NON_INTERLACED_312_313_LINES 0x01
#define R1_NON_INTERLACED_312_312_LINES 0x02
#define R1_FFB_LEADING_EDGE_IN_FIRST_BROAD_PULSE 0x03
#define R1_FFB_LEADING_EDGE_IN_SECOND_BROAD_PULSE 0x07
#define R1_DEW 0x00
#define R1_FULL_FIELD 0x08
#define R1_EXTENDED_PACKET_DISABLE 0x00
#define R1_EXTENDED_PACKET_ENABLE 0x10
#define R1_DAUS_ALL_ON 0x00
#define R1_DAUS_ALL_OFF 0x20
#define R1_7_BITS_PLUS_PARITY 0x00
#define R1_8_BITS_NO_PARITY 0x40
#define R1_VCS_TO_SCS 0x00
#define R1_NO_VCS_TO_SCS 0x80
/* Register R2 (Page request address) */
#define R2_IN_R3_SELECT_PAGE_HUNDREDS 0x00
#define R2_IN_R3_SELECT_PAGE_TENS 0x01
#define R2_IN_R3_SELECT_PAGE_UNITS 0x02
#define R2_IN_R3_SELECT_HOURS_TENS 0x03
#define R2_IN_R3_SELECT_HOURS_UNITS 0x04
#define R2_IN_R3_SELECT_MINUTES_TENS 0x05
#define R2_IN_R3_SELECT_MINUTES_UNITS 0x06
#define R2_DAU_0 0x00
#define R2_DAU_1 0x10
#define R2_DAU_2 0x20
#define R2_DAU_3 0x30
#define R2_BANK_0 0x00
#define R2_BANK 1 0x40
#define R2_HAMMING_CHECK_ON 0x80
#define R2_HAMMING_CHECK_OFF 0x00
/* Register R3 (Page request data) */
#define R3_PAGE_HUNDREDS_0 0x00
#define R3_PAGE_HUNDREDS_1 0x01
#define R3_PAGE_HUNDREDS_2 0x02
#define R3_PAGE_HUNDREDS_3 0x03
#define R3_PAGE_HUNDREDS_4 0x04
#define R3_PAGE_HUNDREDS_5 0x05
#define R3_PAGE_HUNDREDS_6 0x06
#define R3_PAGE_HUNDREDS_7 0x07
#define R3_HOLD_PAGE 0x00
#define R3_UPDATE_PAGE 0x08
#define R3_PAGE_HUNDREDS_DO_NOT_CARE 0x00
#define R3_PAGE_HUNDREDS_DO_CARE 0x10
#define R3_PAGE_TENS_DO_NOT_CARE 0x00
#define R3_PAGE_TENS_DO_CARE 0x10
#define R3_PAGE_UNITS_DO_NOT_CARE 0x00
#define R3_PAGE_UNITS_DO_CARE 0x10
#define R3_HOURS_TENS_DO_NOT_CARE 0x00
#define R3_HOURS_TENS_DO_CARE 0x10
#define R3_HOURS_UNITS_DO_NOT_CARE 0x00
#define R3_HOURS_UNITS_DO_CARE 0x10
#define R3_MINUTES_TENS_DO_NOT_CARE 0x00
#define R3_MINUTES_TENS_DO_CARE 0x10
#define R3_MINUTES_UNITS_DO_NOT_CARE 0x00
#define R3_MINUTES_UNITS_DO_CARE 0x10
/* Register R4 (Display chapter) */
#define R4_DISPLAY_PAGE_0 0x00
#define R4_DISPLAY_PAGE_1 0x01
#define R4_DISPLAY_PAGE_2 0x02
#define R4_DISPLAY_PAGE_3 0x03
#define R4_DISPLAY_PAGE_4 0x04
#define R4_DISPLAY_PAGE_5 0x05
#define R4_DISPLAY_PAGE_6 0x06
#define R4_DISPLAY_PAGE_7 0x07
/* Register R5 (Normal display control) */
#define R5_PICTURE_INSIDE_BOXING_OFF 0x00
#define R5_PICTURE_INSIDE_BOXING_ON 0x01
#define R5_PICTURE_OUTSIDE_BOXING_OFF 0x00
#define R5_PICTURE_OUTSIDE_BOXING_ON 0x02
#define R5_TEXT_INSIDE_BOXING_OFF 0x00
#define R5_TEXT_INSIDE_BOXING_ON 0x04
#define R5_TEXT_OUTSIDE_BOXING_OFF 0x00
#define R5_TEXT_OUTSIDE_BOXING_ON 0x08
#define R5_CONTRAST_REDUCTION_INSIDE_BOXING_OFF 0x00
#define R5_CONTRAST_REDUCTION_INSIDE_BOXING_ON 0x10
#define R5_CONTRAST_REDUCTION_OUTSIDE_BOXING_OFF 0x00
#define R5_CONTRAST_REDUCTION_OUTSIDE_BOXING_ON 0x20
#define R5_BACKGROUND_COLOR_INSIDE_BOXING_OFF 0x00
#define R5_BACKGROUND_COLOR_INSIDE_BOXING_ON 0x40
#define R5_BACKGROUND_COLOR_OUTSIDE_BOXING_OFF 0x00
#define R5_BACKGROUND_COLOR_OUTSIDE_BOXING_ON 0x80
/* Register R6 (Newsflash display) */
#define R6_NEWSFLASH_PICTURE_INSIDE_BOXING_OFF 0x00
#define R6_NEWSFLASH_PICTURE_INSIDE_BOXING_ON 0x01
#define R6_NEWSFLASH_PICTURE_OUTSIDE_BOXING_OFF 0x00
#define R6_NEWSFLASH_PICTURE_OUTSIDE_BOXING_ON 0x02
#define R6_NEWSFLASH_TEXT_INSIDE_BOXING_OFF 0x00
#define R6_NEWSFLASH_TEXT_INSIDE_BOXING_ON 0x04
#define R6_NEWSFLASH_TEXT_OUTSIDE_BOXING_OFF 0x00
#define R6_NEWSFLASH_TEXT_OUTSIDE_BOXING_ON 0x08
#define R6_NEWSFLASH_CONTRAST_REDUCTION_INSIDE_BOXING_OFF 0x00
#define R6_NEWSFLASH_CONTRAST_REDUCTION_INSIDE_BOXING_ON 0x10
#define R6_NEWSFLASH_CONTRAST_REDUCTION_OUTSIDE_BOXING_OFF 0x00
#define R6_NEWSFLASH_CONTRAST_REDUCTION_OUTSIDE_BOXING_ON 0x20
#define R6_NEWSFLASH_BACKGROUND_COLOR_INSIDE_BOXING_OFF 0x00
#define R6_NEWSFLASH_BACKGROUND_COLOR_INSIDE_BOXING_ON 0x40
#define R6_NEWSFLASH_BACKGROUND_COLOR_OUTSIDE_BOXING_OFF 0x00
#define R6_NEWSFLASH_BACKGROUND_COLOR_OUTSIDE_BOXING_ON 0x80
/* Register R7 (Display mode) */
#define R7_BOX_OFF_ROW_0 0x00
#define R7_BOX_ON_ROW_0 0x01
#define R7_BOX_OFF_ROW_1_TO_23 0x00
#define R7_BOX_ON_ROW_1_TO_23 0x02
#define R7_BOX_OFF_ROW_24 0x00
#define R7_BOX_ON_ROW_24 0x04
#define R7_SINGLE_HEIGHT 0x00
#define R7_DOUBLE_HEIGHT 0x08
#define R7_TOP_HALF 0x00
#define R7_BOTTOM_HALF 0x10
#define R7_REVEAL_OFF 0x00
#define R7_REVEAL_ON 0x20
#define R7_CURSER_OFF 0x00
#define R7_CURSER_ON 0x40
#define R7_STATUS_BOTTOM 0x00
#define R7_STATUS_TOP 0x80
/* Register R8 (Active chapter) */
#define R8_ACTIVE_CHAPTER_0 0x00
#define R8_ACTIVE_CHAPTER_1 0x01
#define R8_ACTIVE_CHAPTER_2 0x02
#define R8_ACTIVE_CHAPTER_3 0x03
#define R8_ACTIVE_CHAPTER_4 0x04
#define R8_ACTIVE_CHAPTER_5 0x05
#define R8_ACTIVE_CHAPTER_6 0x06
#define R8_ACTIVE_CHAPTER_7 0x07
#define R8_CLEAR_MEMORY 0x08
#define R8_DO_NOT_CLEAR_MEMORY 0x00
/* Register R9 (Curser row) */
#define R9_CURSER_ROW_0 0x00
#define R9_CURSER_ROW_1 0x01
#define R9_CURSER_ROW_2 0x02
#define R9_CURSER_ROW_25 0x19
/* Register R10 (Curser column) */
#define R10_CURSER_COLUMN_0 0x00
#define R10_CURSER_COLUMN_6 0x06
#define R10_CURSER_COLUMN_8 0x08
/*****************************************************************************/
/* Row 25 control data in column 0 to 9 */
/*****************************************************************************/
#define ROW25_COLUMN0_PAGE_UNITS 0x0F
#define ROW25_COLUMN1_PAGE_TENS 0x0F
#define ROW25_COLUMN2_MINUTES_UNITS 0x0F
#define ROW25_COLUMN3_MINUTES_TENS 0x07
#define ROW25_COLUMN3_DELETE_PAGE 0x08
#define ROW25_COLUMN4_HOUR_UNITS 0x0F
#define ROW25_COLUMN5_HOUR_TENS 0x03
#define ROW25_COLUMN5_INSERT_HEADLINE 0x04
#define ROW25_COLUMN5_INSERT_SUBTITLE 0x08
#define ROW25_COLUMN6_SUPPRESS_HEADER 0x01
#define ROW25_COLUMN6_UPDATE_PAGE 0x02
#define ROW25_COLUMN6_INTERRUPTED_SEQUENCE 0x04
#define ROW25_COLUMN6_SUPPRESS_DISPLAY 0x08
#define ROW25_COLUMN7_SERIAL_MODE 0x01
#define ROW25_COLUMN7_CHARACTER_SET 0x0E
#define ROW25_COLUMN8_PAGE_HUNDREDS 0x07
#define ROW25_COLUMN8_PAGE_NOT_FOUND 0x10
#define ROW25_COLUMN9_PAGE_BEING_LOOKED_FOR 0x20
#define ROW25_COLUMN0_TO_7_HAMMING_ERROR 0x10
/*****************************************************************************/
/* Helper macros for extracting page, hour and minute digits */
/*****************************************************************************/
/* BYTE_POS 0 is at row 0, column 0,
BYTE_POS 1 is at row 0, column 1,
BYTE_POS 40 is at row 1, column 0, (with NUM_ROWS_PER_PAGE = 40)
BYTE_POS 41 is at row 1, column 1, (with NUM_ROWS_PER_PAGE = 40),
... */
#define ROW(BYTE_POS) (BYTE_POS / NUM_ROWS_PER_PAGE)
#define COLUMN(BYTE_POS) (BYTE_POS % NUM_ROWS_PER_PAGE)
/*****************************************************************************/
/* Helper macros for extracting page, hour and minute digits */
/*****************************************************************************/
/* Macros for extracting hundreds, tens and units of a page number which
must be in the range 0 ... 0x799.
Note that page is coded in hexadecimal, i.e. 0x123 means page 123.
page 0x.. means page 8.. */
#define HUNDREDS_OF_PAGE(page) (((page) / 0x100) & 0x7)
#define TENS_OF_PAGE(page) (((page) / 0x10) & 0xF)
#define UNITS_OF_PAGE(page) ((page) & 0xF)
/* Macros for extracting tens and units of a hour information which
must be in the range 0 ... 0x24.
Note that hour is coded in hexadecimal, i.e. 0x12 means 12 hours */
#define TENS_OF_HOUR(hour) ((hour) / 0x10)
#define UNITS_OF_HOUR(hour) ((hour) & 0xF)
/* Macros for extracting tens and units of a minute information which
must be in the range 0 ... 0x59.
Note that minute is coded in hexadecimal, i.e. 0x12 means 12 minutes */
#define TENS_OF_MINUTE(minute) ((minute) / 0x10)
#define UNITS_OF_MINUTE(minute) ((minute) & 0xF)
#define HOUR_MAX 0x23
#define MINUTE_MAX 0x59
#define PAGE_MAX 0x8FF
#endif /* __SAA5246A_H__ */
|
