Commit | Line | Data |
---|---|---|
558b7bd8 OZ |
1 | /* |
2 | * linux/drivers/video/vt8623fb.c - fbdev driver for | |
3 | * integrated graphic core in VIA VT8623 [CLE266] chipset | |
4 | * | |
5 | * Copyright (c) 2006-2007 Ondrej Zajicek <santiago@crfreenet.org> | |
6 | * | |
7 | * This file is subject to the terms and conditions of the GNU General Public | |
8 | * License. See the file COPYING in the main directory of this archive for | |
9 | * more details. | |
10 | * | |
11 | * Code is based on s3fb, some parts are from David Boucher's viafb | |
12 | * (http://davesdomain.org.uk/viafb/) | |
13 | */ | |
14 | ||
558b7bd8 OZ |
15 | #include <linux/module.h> |
16 | #include <linux/kernel.h> | |
17 | #include <linux/errno.h> | |
18 | #include <linux/string.h> | |
19 | #include <linux/mm.h> | |
20 | #include <linux/tty.h> | |
558b7bd8 OZ |
21 | #include <linux/delay.h> |
22 | #include <linux/fb.h> | |
23 | #include <linux/svga.h> | |
24 | #include <linux/init.h> | |
25 | #include <linux/pci.h> | |
ac751efa | 26 | #include <linux/console.h> /* Why should fb driver call console functions? because console_lock() */ |
558b7bd8 OZ |
27 | #include <video/vga.h> |
28 | ||
29 | #ifdef CONFIG_MTRR | |
30 | #include <asm/mtrr.h> | |
31 | #endif | |
32 | ||
33 | struct vt8623fb_info { | |
34 | char __iomem *mmio_base; | |
35 | int mtrr_reg; | |
36 | struct vgastate state; | |
37 | struct mutex open_lock; | |
38 | unsigned int ref_count; | |
39 | u32 pseudo_palette[16]; | |
40 | }; | |
41 | ||
42 | ||
43 | ||
44 | /* ------------------------------------------------------------------------- */ | |
45 | ||
46 | static const struct svga_fb_format vt8623fb_formats[] = { | |
47 | { 0, {0, 6, 0}, {0, 6, 0}, {0, 6, 0}, {0, 0, 0}, 0, | |
48 | FB_TYPE_TEXT, FB_AUX_TEXT_SVGA_STEP8, FB_VISUAL_PSEUDOCOLOR, 16, 16}, | |
49 | { 4, {0, 6, 0}, {0, 6, 0}, {0, 6, 0}, {0, 0, 0}, 0, | |
50 | FB_TYPE_PACKED_PIXELS, 0, FB_VISUAL_PSEUDOCOLOR, 16, 16}, | |
51 | { 4, {0, 6, 0}, {0, 6, 0}, {0, 6, 0}, {0, 0, 0}, 1, | |
52 | FB_TYPE_INTERLEAVED_PLANES, 1, FB_VISUAL_PSEUDOCOLOR, 16, 16}, | |
53 | { 8, {0, 6, 0}, {0, 6, 0}, {0, 6, 0}, {0, 0, 0}, 0, | |
54 | FB_TYPE_PACKED_PIXELS, 0, FB_VISUAL_PSEUDOCOLOR, 8, 8}, | |
55 | /* {16, {10, 5, 0}, {5, 5, 0}, {0, 5, 0}, {0, 0, 0}, 0, | |
56 | FB_TYPE_PACKED_PIXELS, 0, FB_VISUAL_TRUECOLOR, 4, 4}, */ | |
57 | {16, {11, 5, 0}, {5, 6, 0}, {0, 5, 0}, {0, 0, 0}, 0, | |
58 | FB_TYPE_PACKED_PIXELS, 0, FB_VISUAL_TRUECOLOR, 4, 4}, | |
59 | {32, {16, 8, 0}, {8, 8, 0}, {0, 8, 0}, {0, 0, 0}, 0, | |
60 | FB_TYPE_PACKED_PIXELS, 0, FB_VISUAL_TRUECOLOR, 2, 2}, | |
61 | SVGA_FORMAT_END | |
62 | }; | |
63 | ||
64 | static const struct svga_pll vt8623_pll = {2, 127, 2, 7, 0, 3, | |
65 | 60000, 300000, 14318}; | |
66 | ||
67 | /* CRT timing register sets */ | |
68 | ||
3552f09a AB |
69 | static struct vga_regset vt8623_h_total_regs[] = {{0x00, 0, 7}, {0x36, 3, 3}, VGA_REGSET_END}; |
70 | static struct vga_regset vt8623_h_display_regs[] = {{0x01, 0, 7}, VGA_REGSET_END}; | |
71 | static struct vga_regset vt8623_h_blank_start_regs[] = {{0x02, 0, 7}, VGA_REGSET_END}; | |
72 | static struct vga_regset vt8623_h_blank_end_regs[] = {{0x03, 0, 4}, {0x05, 7, 7}, {0x33, 5, 5}, VGA_REGSET_END}; | |
73 | static struct vga_regset vt8623_h_sync_start_regs[] = {{0x04, 0, 7}, {0x33, 4, 4}, VGA_REGSET_END}; | |
74 | static struct vga_regset vt8623_h_sync_end_regs[] = {{0x05, 0, 4}, VGA_REGSET_END}; | |
75 | ||
76 | static struct vga_regset vt8623_v_total_regs[] = {{0x06, 0, 7}, {0x07, 0, 0}, {0x07, 5, 5}, {0x35, 0, 0}, VGA_REGSET_END}; | |
77 | static struct vga_regset vt8623_v_display_regs[] = {{0x12, 0, 7}, {0x07, 1, 1}, {0x07, 6, 6}, {0x35, 2, 2}, VGA_REGSET_END}; | |
78 | static struct vga_regset vt8623_v_blank_start_regs[] = {{0x15, 0, 7}, {0x07, 3, 3}, {0x09, 5, 5}, {0x35, 3, 3}, VGA_REGSET_END}; | |
79 | static struct vga_regset vt8623_v_blank_end_regs[] = {{0x16, 0, 7}, VGA_REGSET_END}; | |
80 | static struct vga_regset vt8623_v_sync_start_regs[] = {{0x10, 0, 7}, {0x07, 2, 2}, {0x07, 7, 7}, {0x35, 1, 1}, VGA_REGSET_END}; | |
81 | static struct vga_regset vt8623_v_sync_end_regs[] = {{0x11, 0, 3}, VGA_REGSET_END}; | |
82 | ||
83 | static struct vga_regset vt8623_offset_regs[] = {{0x13, 0, 7}, {0x35, 5, 7}, VGA_REGSET_END}; | |
84 | static struct vga_regset vt8623_line_compare_regs[] = {{0x18, 0, 7}, {0x07, 4, 4}, {0x09, 6, 6}, {0x33, 0, 2}, {0x35, 4, 4}, VGA_REGSET_END}; | |
85 | static struct vga_regset vt8623_fetch_count_regs[] = {{0x1C, 0, 7}, {0x1D, 0, 1}, VGA_REGSET_END}; | |
86 | static struct vga_regset vt8623_start_address_regs[] = {{0x0d, 0, 7}, {0x0c, 0, 7}, {0x34, 0, 7}, {0x48, 0, 1}, VGA_REGSET_END}; | |
87 | ||
88 | static struct svga_timing_regs vt8623_timing_regs = { | |
558b7bd8 OZ |
89 | vt8623_h_total_regs, vt8623_h_display_regs, vt8623_h_blank_start_regs, |
90 | vt8623_h_blank_end_regs, vt8623_h_sync_start_regs, vt8623_h_sync_end_regs, | |
91 | vt8623_v_total_regs, vt8623_v_display_regs, vt8623_v_blank_start_regs, | |
92 | vt8623_v_blank_end_regs, vt8623_v_sync_start_regs, vt8623_v_sync_end_regs, | |
93 | }; | |
94 | ||
95 | ||
96 | /* ------------------------------------------------------------------------- */ | |
97 | ||
98 | ||
99 | /* Module parameters */ | |
100 | ||
cc6c549c | 101 | static char *mode_option = "640x480-8@60"; |
558b7bd8 OZ |
102 | |
103 | #ifdef CONFIG_MTRR | |
104 | static int mtrr = 1; | |
105 | #endif | |
106 | ||
107 | MODULE_AUTHOR("(c) 2006 Ondrej Zajicek <santiago@crfreenet.org>"); | |
108 | MODULE_LICENSE("GPL"); | |
109 | MODULE_DESCRIPTION("fbdev driver for integrated graphics core in VIA VT8623 [CLE266]"); | |
110 | ||
cc6c549c KH |
111 | module_param(mode_option, charp, 0644); |
112 | MODULE_PARM_DESC(mode_option, "Default video mode ('640x480-8@60', etc)"); | |
9e3f0ca8 KH |
113 | module_param_named(mode, mode_option, charp, 0); |
114 | MODULE_PARM_DESC(mode, "Default video mode e.g. '648x480-8@60' (deprecated)"); | |
558b7bd8 OZ |
115 | |
116 | #ifdef CONFIG_MTRR | |
117 | module_param(mtrr, int, 0444); | |
118 | MODULE_PARM_DESC(mtrr, "Enable write-combining with MTRR (1=enable, 0=disable, default=1)"); | |
119 | #endif | |
120 | ||
121 | ||
122 | /* ------------------------------------------------------------------------- */ | |
123 | ||
55db0923 DM |
124 | static void vt8623fb_tilecursor(struct fb_info *info, struct fb_tilecursor *cursor) |
125 | { | |
126 | struct vt8623fb_info *par = info->par; | |
127 | ||
128 | svga_tilecursor(par->state.vgabase, info, cursor); | |
129 | } | |
558b7bd8 OZ |
130 | |
131 | static struct fb_tile_ops vt8623fb_tile_ops = { | |
132 | .fb_settile = svga_settile, | |
133 | .fb_tilecopy = svga_tilecopy, | |
134 | .fb_tilefill = svga_tilefill, | |
135 | .fb_tileblit = svga_tileblit, | |
55db0923 | 136 | .fb_tilecursor = vt8623fb_tilecursor, |
558b7bd8 OZ |
137 | .fb_get_tilemax = svga_get_tilemax, |
138 | }; | |
139 | ||
140 | ||
141 | /* ------------------------------------------------------------------------- */ | |
142 | ||
143 | ||
144 | /* image data is MSB-first, fb structure is MSB-first too */ | |
145 | static inline u32 expand_color(u32 c) | |
146 | { | |
147 | return ((c & 1) | ((c & 2) << 7) | ((c & 4) << 14) | ((c & 8) << 21)) * 0xFF; | |
148 | } | |
149 | ||
150 | /* vt8623fb_iplan_imageblit silently assumes that almost everything is 8-pixel aligned */ | |
151 | static void vt8623fb_iplan_imageblit(struct fb_info *info, const struct fb_image *image) | |
152 | { | |
153 | u32 fg = expand_color(image->fg_color); | |
154 | u32 bg = expand_color(image->bg_color); | |
155 | const u8 *src1, *src; | |
156 | u8 __iomem *dst1; | |
157 | u32 __iomem *dst; | |
158 | u32 val; | |
159 | int x, y; | |
160 | ||
161 | src1 = image->data; | |
162 | dst1 = info->screen_base + (image->dy * info->fix.line_length) | |
163 | + ((image->dx / 8) * 4); | |
164 | ||
165 | for (y = 0; y < image->height; y++) { | |
166 | src = src1; | |
167 | dst = (u32 __iomem *) dst1; | |
168 | for (x = 0; x < image->width; x += 8) { | |
169 | val = *(src++) * 0x01010101; | |
170 | val = (val & fg) | (~val & bg); | |
171 | fb_writel(val, dst++); | |
172 | } | |
173 | src1 += image->width / 8; | |
174 | dst1 += info->fix.line_length; | |
175 | } | |
176 | } | |
177 | ||
178 | /* vt8623fb_iplan_fillrect silently assumes that almost everything is 8-pixel aligned */ | |
179 | static void vt8623fb_iplan_fillrect(struct fb_info *info, const struct fb_fillrect *rect) | |
180 | { | |
181 | u32 fg = expand_color(rect->color); | |
182 | u8 __iomem *dst1; | |
183 | u32 __iomem *dst; | |
184 | int x, y; | |
185 | ||
186 | dst1 = info->screen_base + (rect->dy * info->fix.line_length) | |
187 | + ((rect->dx / 8) * 4); | |
188 | ||
189 | for (y = 0; y < rect->height; y++) { | |
190 | dst = (u32 __iomem *) dst1; | |
191 | for (x = 0; x < rect->width; x += 8) { | |
192 | fb_writel(fg, dst++); | |
193 | } | |
194 | dst1 += info->fix.line_length; | |
195 | } | |
196 | } | |
197 | ||
198 | ||
199 | /* image data is MSB-first, fb structure is high-nibble-in-low-byte-first */ | |
200 | static inline u32 expand_pixel(u32 c) | |
201 | { | |
202 | return (((c & 1) << 24) | ((c & 2) << 27) | ((c & 4) << 14) | ((c & 8) << 17) | | |
203 | ((c & 16) << 4) | ((c & 32) << 7) | ((c & 64) >> 6) | ((c & 128) >> 3)) * 0xF; | |
204 | } | |
205 | ||
206 | /* vt8623fb_cfb4_imageblit silently assumes that almost everything is 8-pixel aligned */ | |
207 | static void vt8623fb_cfb4_imageblit(struct fb_info *info, const struct fb_image *image) | |
208 | { | |
209 | u32 fg = image->fg_color * 0x11111111; | |
210 | u32 bg = image->bg_color * 0x11111111; | |
211 | const u8 *src1, *src; | |
212 | u8 __iomem *dst1; | |
213 | u32 __iomem *dst; | |
214 | u32 val; | |
215 | int x, y; | |
216 | ||
217 | src1 = image->data; | |
218 | dst1 = info->screen_base + (image->dy * info->fix.line_length) | |
219 | + ((image->dx / 8) * 4); | |
220 | ||
221 | for (y = 0; y < image->height; y++) { | |
222 | src = src1; | |
223 | dst = (u32 __iomem *) dst1; | |
224 | for (x = 0; x < image->width; x += 8) { | |
225 | val = expand_pixel(*(src++)); | |
226 | val = (val & fg) | (~val & bg); | |
227 | fb_writel(val, dst++); | |
228 | } | |
229 | src1 += image->width / 8; | |
230 | dst1 += info->fix.line_length; | |
231 | } | |
232 | } | |
233 | ||
234 | static void vt8623fb_imageblit(struct fb_info *info, const struct fb_image *image) | |
235 | { | |
236 | if ((info->var.bits_per_pixel == 4) && (image->depth == 1) | |
237 | && ((image->width % 8) == 0) && ((image->dx % 8) == 0)) { | |
238 | if (info->fix.type == FB_TYPE_INTERLEAVED_PLANES) | |
239 | vt8623fb_iplan_imageblit(info, image); | |
240 | else | |
241 | vt8623fb_cfb4_imageblit(info, image); | |
242 | } else | |
243 | cfb_imageblit(info, image); | |
244 | } | |
245 | ||
246 | static void vt8623fb_fillrect(struct fb_info *info, const struct fb_fillrect *rect) | |
247 | { | |
248 | if ((info->var.bits_per_pixel == 4) | |
249 | && ((rect->width % 8) == 0) && ((rect->dx % 8) == 0) | |
250 | && (info->fix.type == FB_TYPE_INTERLEAVED_PLANES)) | |
251 | vt8623fb_iplan_fillrect(info, rect); | |
252 | else | |
253 | cfb_fillrect(info, rect); | |
254 | } | |
255 | ||
256 | ||
257 | /* ------------------------------------------------------------------------- */ | |
258 | ||
259 | ||
260 | static void vt8623_set_pixclock(struct fb_info *info, u32 pixclock) | |
261 | { | |
d907ec04 | 262 | struct vt8623fb_info *par = info->par; |
558b7bd8 OZ |
263 | u16 m, n, r; |
264 | u8 regval; | |
265 | int rv; | |
266 | ||
267 | rv = svga_compute_pll(&vt8623_pll, 1000000000 / pixclock, &m, &n, &r, info->node); | |
268 | if (rv < 0) { | |
269 | printk(KERN_ERR "fb%d: cannot set requested pixclock, keeping old value\n", info->node); | |
270 | return; | |
271 | } | |
272 | ||
273 | /* Set VGA misc register */ | |
274 | regval = vga_r(NULL, VGA_MIS_R); | |
275 | vga_w(NULL, VGA_MIS_W, regval | VGA_MIS_ENB_PLL_LOAD); | |
276 | ||
277 | /* Set clock registers */ | |
278 | vga_wseq(NULL, 0x46, (n | (r << 6))); | |
279 | vga_wseq(NULL, 0x47, m); | |
280 | ||
281 | udelay(1000); | |
282 | ||
283 | /* PLL reset */ | |
d907ec04 DM |
284 | svga_wseq_mask(par->state.vgabase, 0x40, 0x02, 0x02); |
285 | svga_wseq_mask(par->state.vgabase, 0x40, 0x00, 0x02); | |
558b7bd8 OZ |
286 | } |
287 | ||
288 | ||
289 | static int vt8623fb_open(struct fb_info *info, int user) | |
290 | { | |
291 | struct vt8623fb_info *par = info->par; | |
292 | ||
293 | mutex_lock(&(par->open_lock)); | |
294 | if (par->ref_count == 0) { | |
295 | memset(&(par->state), 0, sizeof(struct vgastate)); | |
296 | par->state.flags = VGA_SAVE_MODE | VGA_SAVE_FONTS | VGA_SAVE_CMAP; | |
297 | par->state.num_crtc = 0xA2; | |
298 | par->state.num_seq = 0x50; | |
299 | save_vga(&(par->state)); | |
300 | } | |
301 | ||
302 | par->ref_count++; | |
303 | mutex_unlock(&(par->open_lock)); | |
304 | ||
305 | return 0; | |
306 | } | |
307 | ||
308 | static int vt8623fb_release(struct fb_info *info, int user) | |
309 | { | |
310 | struct vt8623fb_info *par = info->par; | |
311 | ||
312 | mutex_lock(&(par->open_lock)); | |
313 | if (par->ref_count == 0) { | |
314 | mutex_unlock(&(par->open_lock)); | |
315 | return -EINVAL; | |
316 | } | |
317 | ||
318 | if (par->ref_count == 1) | |
319 | restore_vga(&(par->state)); | |
320 | ||
321 | par->ref_count--; | |
322 | mutex_unlock(&(par->open_lock)); | |
323 | ||
324 | return 0; | |
325 | } | |
326 | ||
327 | static int vt8623fb_check_var(struct fb_var_screeninfo *var, struct fb_info *info) | |
328 | { | |
329 | int rv, mem, step; | |
330 | ||
331 | /* Find appropriate format */ | |
332 | rv = svga_match_format (vt8623fb_formats, var, NULL); | |
333 | if (rv < 0) | |
334 | { | |
335 | printk(KERN_ERR "fb%d: unsupported mode requested\n", info->node); | |
336 | return rv; | |
337 | } | |
338 | ||
339 | /* Do not allow to have real resoulution larger than virtual */ | |
340 | if (var->xres > var->xres_virtual) | |
341 | var->xres_virtual = var->xres; | |
342 | ||
343 | if (var->yres > var->yres_virtual) | |
344 | var->yres_virtual = var->yres; | |
345 | ||
346 | /* Round up xres_virtual to have proper alignment of lines */ | |
347 | step = vt8623fb_formats[rv].xresstep - 1; | |
348 | var->xres_virtual = (var->xres_virtual+step) & ~step; | |
349 | ||
350 | /* Check whether have enough memory */ | |
351 | mem = ((var->bits_per_pixel * var->xres_virtual) >> 3) * var->yres_virtual; | |
352 | if (mem > info->screen_size) | |
353 | { | |
354 | printk(KERN_ERR "fb%d: not enough framebuffer memory (%d kB requested , %d kB available)\n", info->node, mem >> 10, (unsigned int) (info->screen_size >> 10)); | |
355 | return -EINVAL; | |
356 | } | |
357 | ||
358 | /* Text mode is limited to 256 kB of memory */ | |
359 | if ((var->bits_per_pixel == 0) && (mem > (256*1024))) | |
360 | { | |
361 | printk(KERN_ERR "fb%d: text framebuffer size too large (%d kB requested, 256 kB possible)\n", info->node, mem >> 10); | |
362 | return -EINVAL; | |
363 | } | |
364 | ||
365 | rv = svga_check_timings (&vt8623_timing_regs, var, info->node); | |
366 | if (rv < 0) | |
367 | { | |
368 | printk(KERN_ERR "fb%d: invalid timings requested\n", info->node); | |
369 | return rv; | |
370 | } | |
371 | ||
372 | /* Interlaced mode not supported */ | |
373 | if (var->vmode & FB_VMODE_INTERLACED) | |
374 | return -EINVAL; | |
375 | ||
376 | return 0; | |
377 | } | |
378 | ||
379 | ||
380 | static int vt8623fb_set_par(struct fb_info *info) | |
381 | { | |
382 | u32 mode, offset_value, fetch_value, screen_size; | |
21da386d | 383 | struct vt8623fb_info *par = info->par; |
558b7bd8 OZ |
384 | u32 bpp = info->var.bits_per_pixel; |
385 | ||
386 | if (bpp != 0) { | |
387 | info->fix.ypanstep = 1; | |
388 | info->fix.line_length = (info->var.xres_virtual * bpp) / 8; | |
389 | ||
390 | info->flags &= ~FBINFO_MISC_TILEBLITTING; | |
391 | info->tileops = NULL; | |
392 | ||
393 | /* in 4bpp supports 8p wide tiles only, any tiles otherwise */ | |
394 | info->pixmap.blit_x = (bpp == 4) ? (1 << (8 - 1)) : (~(u32)0); | |
395 | info->pixmap.blit_y = ~(u32)0; | |
396 | ||
397 | offset_value = (info->var.xres_virtual * bpp) / 64; | |
398 | fetch_value = ((info->var.xres * bpp) / 128) + 4; | |
399 | ||
400 | if (bpp == 4) | |
401 | fetch_value = (info->var.xres / 8) + 8; /* + 0 is OK */ | |
402 | ||
403 | screen_size = info->var.yres_virtual * info->fix.line_length; | |
404 | } else { | |
405 | info->fix.ypanstep = 16; | |
406 | info->fix.line_length = 0; | |
407 | ||
408 | info->flags |= FBINFO_MISC_TILEBLITTING; | |
409 | info->tileops = &vt8623fb_tile_ops; | |
410 | ||
411 | /* supports 8x16 tiles only */ | |
412 | info->pixmap.blit_x = 1 << (8 - 1); | |
413 | info->pixmap.blit_y = 1 << (16 - 1); | |
414 | ||
415 | offset_value = info->var.xres_virtual / 16; | |
416 | fetch_value = (info->var.xres / 8) + 8; | |
417 | screen_size = (info->var.xres_virtual * info->var.yres_virtual) / 64; | |
418 | } | |
419 | ||
420 | info->var.xoffset = 0; | |
421 | info->var.yoffset = 0; | |
422 | info->var.activate = FB_ACTIVATE_NOW; | |
423 | ||
424 | /* Unlock registers */ | |
d907ec04 | 425 | svga_wseq_mask(par->state.vgabase, 0x10, 0x01, 0x01); |
ea770789 DM |
426 | svga_wcrt_mask(par->state.vgabase, 0x11, 0x00, 0x80); |
427 | svga_wcrt_mask(par->state.vgabase, 0x47, 0x00, 0x01); | |
558b7bd8 OZ |
428 | |
429 | /* Device, screen and sync off */ | |
d907ec04 | 430 | svga_wseq_mask(par->state.vgabase, 0x01, 0x20, 0x20); |
ea770789 DM |
431 | svga_wcrt_mask(par->state.vgabase, 0x36, 0x30, 0x30); |
432 | svga_wcrt_mask(par->state.vgabase, 0x17, 0x00, 0x80); | |
558b7bd8 OZ |
433 | |
434 | /* Set default values */ | |
e2fade2c | 435 | svga_set_default_gfx_regs(par->state.vgabase); |
f51a14dd | 436 | svga_set_default_atc_regs(par->state.vgabase); |
a4ade839 | 437 | svga_set_default_seq_regs(par->state.vgabase); |
1d28fcad | 438 | svga_set_default_crt_regs(par->state.vgabase); |
21da386d DM |
439 | svga_wcrt_multi(par->state.vgabase, vt8623_line_compare_regs, 0xFFFFFFFF); |
440 | svga_wcrt_multi(par->state.vgabase, vt8623_start_address_regs, 0); | |
558b7bd8 | 441 | |
21da386d | 442 | svga_wcrt_multi(par->state.vgabase, vt8623_offset_regs, offset_value); |
dc6aff3a | 443 | svga_wseq_multi(par->state.vgabase, vt8623_fetch_count_regs, fetch_value); |
558b7bd8 | 444 | |
8f5af9de | 445 | /* Clear H/V Skew */ |
ea770789 DM |
446 | svga_wcrt_mask(par->state.vgabase, 0x03, 0x00, 0x60); |
447 | svga_wcrt_mask(par->state.vgabase, 0x05, 0x00, 0x60); | |
8f5af9de | 448 | |
558b7bd8 | 449 | if (info->var.vmode & FB_VMODE_DOUBLE) |
ea770789 | 450 | svga_wcrt_mask(par->state.vgabase, 0x09, 0x80, 0x80); |
558b7bd8 | 451 | else |
ea770789 | 452 | svga_wcrt_mask(par->state.vgabase, 0x09, 0x00, 0x80); |
558b7bd8 | 453 | |
d907ec04 DM |
454 | svga_wseq_mask(par->state.vgabase, 0x1E, 0xF0, 0xF0); // DI/DVP bus |
455 | svga_wseq_mask(par->state.vgabase, 0x2A, 0x0F, 0x0F); // DI/DVP bus | |
456 | svga_wseq_mask(par->state.vgabase, 0x16, 0x08, 0xBF); // FIFO read threshold | |
558b7bd8 OZ |
457 | vga_wseq(NULL, 0x17, 0x1F); // FIFO depth |
458 | vga_wseq(NULL, 0x18, 0x4E); | |
d907ec04 | 459 | svga_wseq_mask(par->state.vgabase, 0x1A, 0x08, 0x08); // enable MMIO ? |
558b7bd8 OZ |
460 | |
461 | vga_wcrt(NULL, 0x32, 0x00); | |
462 | vga_wcrt(NULL, 0x34, 0x00); | |
463 | vga_wcrt(NULL, 0x6A, 0x80); | |
464 | vga_wcrt(NULL, 0x6A, 0xC0); | |
465 | ||
466 | vga_wgfx(NULL, 0x20, 0x00); | |
467 | vga_wgfx(NULL, 0x21, 0x00); | |
468 | vga_wgfx(NULL, 0x22, 0x00); | |
469 | ||
470 | /* Set SR15 according to number of bits per pixel */ | |
471 | mode = svga_match_format(vt8623fb_formats, &(info->var), &(info->fix)); | |
472 | switch (mode) { | |
473 | case 0: | |
474 | pr_debug("fb%d: text mode\n", info->node); | |
9c96394b | 475 | svga_set_textmode_vga_regs(par->state.vgabase); |
d907ec04 | 476 | svga_wseq_mask(par->state.vgabase, 0x15, 0x00, 0xFE); |
ea770789 | 477 | svga_wcrt_mask(par->state.vgabase, 0x11, 0x60, 0x70); |
558b7bd8 OZ |
478 | break; |
479 | case 1: | |
480 | pr_debug("fb%d: 4 bit pseudocolor\n", info->node); | |
481 | vga_wgfx(NULL, VGA_GFX_MODE, 0x40); | |
d907ec04 | 482 | svga_wseq_mask(par->state.vgabase, 0x15, 0x20, 0xFE); |
ea770789 | 483 | svga_wcrt_mask(par->state.vgabase, 0x11, 0x00, 0x70); |
558b7bd8 OZ |
484 | break; |
485 | case 2: | |
486 | pr_debug("fb%d: 4 bit pseudocolor, planar\n", info->node); | |
d907ec04 | 487 | svga_wseq_mask(par->state.vgabase, 0x15, 0x00, 0xFE); |
ea770789 | 488 | svga_wcrt_mask(par->state.vgabase, 0x11, 0x00, 0x70); |
558b7bd8 OZ |
489 | break; |
490 | case 3: | |
491 | pr_debug("fb%d: 8 bit pseudocolor\n", info->node); | |
d907ec04 | 492 | svga_wseq_mask(par->state.vgabase, 0x15, 0x22, 0xFE); |
558b7bd8 OZ |
493 | break; |
494 | case 4: | |
495 | pr_debug("fb%d: 5/6/5 truecolor\n", info->node); | |
d907ec04 | 496 | svga_wseq_mask(par->state.vgabase, 0x15, 0xB6, 0xFE); |
558b7bd8 OZ |
497 | break; |
498 | case 5: | |
499 | pr_debug("fb%d: 8/8/8 truecolor\n", info->node); | |
d907ec04 | 500 | svga_wseq_mask(par->state.vgabase, 0x15, 0xAE, 0xFE); |
558b7bd8 OZ |
501 | break; |
502 | default: | |
503 | printk(KERN_ERR "vt8623fb: unsupported mode - bug\n"); | |
504 | return (-EINVAL); | |
505 | } | |
506 | ||
507 | vt8623_set_pixclock(info, info->var.pixclock); | |
508 | svga_set_timings(&vt8623_timing_regs, &(info->var), 1, 1, | |
509 | (info->var.vmode & FB_VMODE_DOUBLE) ? 2 : 1, 1, | |
510 | 1, info->node); | |
511 | ||
512 | memset_io(info->screen_base, 0x00, screen_size); | |
513 | ||
514 | /* Device and screen back on */ | |
ea770789 DM |
515 | svga_wcrt_mask(par->state.vgabase, 0x17, 0x80, 0x80); |
516 | svga_wcrt_mask(par->state.vgabase, 0x36, 0x00, 0x30); | |
d907ec04 | 517 | svga_wseq_mask(par->state.vgabase, 0x01, 0x00, 0x20); |
558b7bd8 OZ |
518 | |
519 | return 0; | |
520 | } | |
521 | ||
522 | ||
523 | static int vt8623fb_setcolreg(u_int regno, u_int red, u_int green, u_int blue, | |
524 | u_int transp, struct fb_info *fb) | |
525 | { | |
526 | switch (fb->var.bits_per_pixel) { | |
527 | case 0: | |
528 | case 4: | |
529 | if (regno >= 16) | |
530 | return -EINVAL; | |
531 | ||
532 | outb(0x0F, VGA_PEL_MSK); | |
533 | outb(regno, VGA_PEL_IW); | |
534 | outb(red >> 10, VGA_PEL_D); | |
535 | outb(green >> 10, VGA_PEL_D); | |
536 | outb(blue >> 10, VGA_PEL_D); | |
537 | break; | |
538 | case 8: | |
539 | if (regno >= 256) | |
540 | return -EINVAL; | |
541 | ||
542 | outb(0xFF, VGA_PEL_MSK); | |
543 | outb(regno, VGA_PEL_IW); | |
544 | outb(red >> 10, VGA_PEL_D); | |
545 | outb(green >> 10, VGA_PEL_D); | |
546 | outb(blue >> 10, VGA_PEL_D); | |
547 | break; | |
548 | case 16: | |
549 | if (regno >= 16) | |
550 | return 0; | |
551 | ||
552 | if (fb->var.green.length == 5) | |
553 | ((u32*)fb->pseudo_palette)[regno] = ((red & 0xF800) >> 1) | | |
554 | ((green & 0xF800) >> 6) | ((blue & 0xF800) >> 11); | |
555 | else if (fb->var.green.length == 6) | |
556 | ((u32*)fb->pseudo_palette)[regno] = (red & 0xF800) | | |
557 | ((green & 0xFC00) >> 5) | ((blue & 0xF800) >> 11); | |
558 | else | |
559 | return -EINVAL; | |
560 | break; | |
561 | case 24: | |
562 | case 32: | |
563 | if (regno >= 16) | |
564 | return 0; | |
565 | ||
566 | /* ((transp & 0xFF00) << 16) */ | |
567 | ((u32*)fb->pseudo_palette)[regno] = ((red & 0xFF00) << 8) | | |
568 | (green & 0xFF00) | ((blue & 0xFF00) >> 8); | |
569 | break; | |
570 | default: | |
571 | return -EINVAL; | |
572 | } | |
573 | ||
574 | return 0; | |
575 | } | |
576 | ||
577 | ||
578 | static int vt8623fb_blank(int blank_mode, struct fb_info *info) | |
579 | { | |
d907ec04 DM |
580 | struct vt8623fb_info *par = info->par; |
581 | ||
558b7bd8 OZ |
582 | switch (blank_mode) { |
583 | case FB_BLANK_UNBLANK: | |
584 | pr_debug("fb%d: unblank\n", info->node); | |
ea770789 | 585 | svga_wcrt_mask(par->state.vgabase, 0x36, 0x00, 0x30); |
d907ec04 | 586 | svga_wseq_mask(par->state.vgabase, 0x01, 0x00, 0x20); |
558b7bd8 OZ |
587 | break; |
588 | case FB_BLANK_NORMAL: | |
589 | pr_debug("fb%d: blank\n", info->node); | |
ea770789 | 590 | svga_wcrt_mask(par->state.vgabase, 0x36, 0x00, 0x30); |
d907ec04 | 591 | svga_wseq_mask(par->state.vgabase, 0x01, 0x20, 0x20); |
558b7bd8 OZ |
592 | break; |
593 | case FB_BLANK_HSYNC_SUSPEND: | |
594 | pr_debug("fb%d: DPMS standby (hsync off)\n", info->node); | |
ea770789 | 595 | svga_wcrt_mask(par->state.vgabase, 0x36, 0x10, 0x30); |
d907ec04 | 596 | svga_wseq_mask(par->state.vgabase, 0x01, 0x20, 0x20); |
558b7bd8 OZ |
597 | break; |
598 | case FB_BLANK_VSYNC_SUSPEND: | |
599 | pr_debug("fb%d: DPMS suspend (vsync off)\n", info->node); | |
ea770789 | 600 | svga_wcrt_mask(par->state.vgabase, 0x36, 0x20, 0x30); |
d907ec04 | 601 | svga_wseq_mask(par->state.vgabase, 0x01, 0x20, 0x20); |
558b7bd8 OZ |
602 | break; |
603 | case FB_BLANK_POWERDOWN: | |
604 | pr_debug("fb%d: DPMS off (no sync)\n", info->node); | |
ea770789 | 605 | svga_wcrt_mask(par->state.vgabase, 0x36, 0x30, 0x30); |
d907ec04 | 606 | svga_wseq_mask(par->state.vgabase, 0x01, 0x20, 0x20); |
558b7bd8 OZ |
607 | break; |
608 | } | |
609 | ||
610 | return 0; | |
611 | } | |
612 | ||
613 | ||
614 | static int vt8623fb_pan_display(struct fb_var_screeninfo *var, struct fb_info *info) | |
615 | { | |
21da386d | 616 | struct vt8623fb_info *par = info->par; |
558b7bd8 OZ |
617 | unsigned int offset; |
618 | ||
619 | /* Calculate the offset */ | |
620 | if (var->bits_per_pixel == 0) { | |
621 | offset = (var->yoffset / 16) * var->xres_virtual + var->xoffset; | |
622 | offset = offset >> 3; | |
623 | } else { | |
624 | offset = (var->yoffset * info->fix.line_length) + | |
625 | (var->xoffset * var->bits_per_pixel / 8); | |
626 | offset = offset >> ((var->bits_per_pixel == 4) ? 2 : 1); | |
627 | } | |
628 | ||
629 | /* Set the offset */ | |
21da386d | 630 | svga_wcrt_multi(par->state.vgabase, vt8623_start_address_regs, offset); |
558b7bd8 OZ |
631 | |
632 | return 0; | |
633 | } | |
634 | ||
635 | ||
636 | /* ------------------------------------------------------------------------- */ | |
637 | ||
638 | ||
639 | /* Frame buffer operations */ | |
640 | ||
641 | static struct fb_ops vt8623fb_ops = { | |
642 | .owner = THIS_MODULE, | |
643 | .fb_open = vt8623fb_open, | |
644 | .fb_release = vt8623fb_release, | |
645 | .fb_check_var = vt8623fb_check_var, | |
646 | .fb_set_par = vt8623fb_set_par, | |
647 | .fb_setcolreg = vt8623fb_setcolreg, | |
648 | .fb_blank = vt8623fb_blank, | |
649 | .fb_pan_display = vt8623fb_pan_display, | |
650 | .fb_fillrect = vt8623fb_fillrect, | |
651 | .fb_copyarea = cfb_copyarea, | |
652 | .fb_imageblit = vt8623fb_imageblit, | |
5a87ede9 | 653 | .fb_get_caps = svga_get_caps, |
558b7bd8 OZ |
654 | }; |
655 | ||
656 | ||
657 | /* PCI probe */ | |
658 | ||
659 | static int __devinit vt8623_pci_probe(struct pci_dev *dev, const struct pci_device_id *id) | |
660 | { | |
661 | struct fb_info *info; | |
662 | struct vt8623fb_info *par; | |
663 | unsigned int memsize1, memsize2; | |
664 | int rc; | |
665 | ||
666 | /* Ignore secondary VGA device because there is no VGA arbitration */ | |
667 | if (! svga_primary_device(dev)) { | |
668 | dev_info(&(dev->dev), "ignoring secondary device\n"); | |
669 | return -ENODEV; | |
670 | } | |
671 | ||
672 | /* Allocate and fill driver data structure */ | |
20e061fb | 673 | info = framebuffer_alloc(sizeof(struct vt8623fb_info), &(dev->dev)); |
558b7bd8 OZ |
674 | if (! info) { |
675 | dev_err(&(dev->dev), "cannot allocate memory\n"); | |
676 | return -ENOMEM; | |
677 | } | |
678 | ||
679 | par = info->par; | |
680 | mutex_init(&par->open_lock); | |
681 | ||
682 | info->flags = FBINFO_PARTIAL_PAN_OK | FBINFO_HWACCEL_YPAN; | |
683 | info->fbops = &vt8623fb_ops; | |
684 | ||
685 | /* Prepare PCI device */ | |
686 | ||
687 | rc = pci_enable_device(dev); | |
688 | if (rc < 0) { | |
594a8819 | 689 | dev_err(info->device, "cannot enable PCI device\n"); |
558b7bd8 OZ |
690 | goto err_enable_device; |
691 | } | |
692 | ||
693 | rc = pci_request_regions(dev, "vt8623fb"); | |
694 | if (rc < 0) { | |
594a8819 | 695 | dev_err(info->device, "cannot reserve framebuffer region\n"); |
558b7bd8 OZ |
696 | goto err_request_regions; |
697 | } | |
698 | ||
699 | info->fix.smem_start = pci_resource_start(dev, 0); | |
700 | info->fix.smem_len = pci_resource_len(dev, 0); | |
701 | info->fix.mmio_start = pci_resource_start(dev, 1); | |
702 | info->fix.mmio_len = pci_resource_len(dev, 1); | |
703 | ||
704 | /* Map physical IO memory address into kernel space */ | |
705 | info->screen_base = pci_iomap(dev, 0, 0); | |
706 | if (! info->screen_base) { | |
707 | rc = -ENOMEM; | |
594a8819 | 708 | dev_err(info->device, "iomap for framebuffer failed\n"); |
558b7bd8 OZ |
709 | goto err_iomap_1; |
710 | } | |
711 | ||
712 | par->mmio_base = pci_iomap(dev, 1, 0); | |
713 | if (! par->mmio_base) { | |
714 | rc = -ENOMEM; | |
594a8819 | 715 | dev_err(info->device, "iomap for MMIO failed\n"); |
558b7bd8 OZ |
716 | goto err_iomap_2; |
717 | } | |
718 | ||
719 | /* Find how many physical memory there is on card */ | |
720 | memsize1 = (vga_rseq(NULL, 0x34) + 1) >> 1; | |
721 | memsize2 = vga_rseq(NULL, 0x39) << 2; | |
722 | ||
723 | if ((16 <= memsize1) && (memsize1 <= 64) && (memsize1 == memsize2)) | |
724 | info->screen_size = memsize1 << 20; | |
725 | else { | |
594a8819 | 726 | dev_err(info->device, "memory size detection failed (%x %x), suppose 16 MB\n", memsize1, memsize2); |
558b7bd8 OZ |
727 | info->screen_size = 16 << 20; |
728 | } | |
729 | ||
730 | info->fix.smem_len = info->screen_size; | |
731 | strcpy(info->fix.id, "VIA VT8623"); | |
732 | info->fix.type = FB_TYPE_PACKED_PIXELS; | |
733 | info->fix.visual = FB_VISUAL_PSEUDOCOLOR; | |
734 | info->fix.ypanstep = 0; | |
735 | info->fix.accel = FB_ACCEL_NONE; | |
736 | info->pseudo_palette = (void*)par->pseudo_palette; | |
737 | ||
738 | /* Prepare startup mode */ | |
739 | ||
d6d1b650 | 740 | kparam_block_sysfs_write(mode_option); |
cc6c549c | 741 | rc = fb_find_mode(&(info->var), info, mode_option, NULL, 0, NULL, 8); |
d6d1b650 | 742 | kparam_unblock_sysfs_write(mode_option); |
558b7bd8 OZ |
743 | if (! ((rc == 1) || (rc == 2))) { |
744 | rc = -EINVAL; | |
594a8819 | 745 | dev_err(info->device, "mode %s not found\n", mode_option); |
558b7bd8 OZ |
746 | goto err_find_mode; |
747 | } | |
748 | ||
749 | rc = fb_alloc_cmap(&info->cmap, 256, 0); | |
750 | if (rc < 0) { | |
594a8819 | 751 | dev_err(info->device, "cannot allocate colormap\n"); |
558b7bd8 OZ |
752 | goto err_alloc_cmap; |
753 | } | |
754 | ||
755 | rc = register_framebuffer(info); | |
756 | if (rc < 0) { | |
594a8819 | 757 | dev_err(info->device, "cannot register framebugger\n"); |
558b7bd8 OZ |
758 | goto err_reg_fb; |
759 | } | |
760 | ||
761 | printk(KERN_INFO "fb%d: %s on %s, %d MB RAM\n", info->node, info->fix.id, | |
762 | pci_name(dev), info->fix.smem_len >> 20); | |
763 | ||
764 | /* Record a reference to the driver data */ | |
765 | pci_set_drvdata(dev, info); | |
766 | ||
767 | #ifdef CONFIG_MTRR | |
768 | if (mtrr) { | |
769 | par->mtrr_reg = -1; | |
770 | par->mtrr_reg = mtrr_add(info->fix.smem_start, info->fix.smem_len, MTRR_TYPE_WRCOMB, 1); | |
771 | } | |
772 | #endif | |
773 | ||
774 | return 0; | |
775 | ||
776 | /* Error handling */ | |
777 | err_reg_fb: | |
778 | fb_dealloc_cmap(&info->cmap); | |
779 | err_alloc_cmap: | |
780 | err_find_mode: | |
781 | pci_iounmap(dev, par->mmio_base); | |
782 | err_iomap_2: | |
783 | pci_iounmap(dev, info->screen_base); | |
784 | err_iomap_1: | |
785 | pci_release_regions(dev); | |
786 | err_request_regions: | |
787 | /* pci_disable_device(dev); */ | |
788 | err_enable_device: | |
789 | framebuffer_release(info); | |
790 | return rc; | |
791 | } | |
792 | ||
793 | /* PCI remove */ | |
794 | ||
795 | static void __devexit vt8623_pci_remove(struct pci_dev *dev) | |
796 | { | |
797 | struct fb_info *info = pci_get_drvdata(dev); | |
558b7bd8 OZ |
798 | |
799 | if (info) { | |
38d473f9 OZ |
800 | struct vt8623fb_info *par = info->par; |
801 | ||
558b7bd8 OZ |
802 | #ifdef CONFIG_MTRR |
803 | if (par->mtrr_reg >= 0) { | |
804 | mtrr_del(par->mtrr_reg, 0, 0); | |
805 | par->mtrr_reg = -1; | |
806 | } | |
807 | #endif | |
808 | ||
809 | unregister_framebuffer(info); | |
810 | fb_dealloc_cmap(&info->cmap); | |
811 | ||
812 | pci_iounmap(dev, info->screen_base); | |
813 | pci_iounmap(dev, par->mmio_base); | |
814 | pci_release_regions(dev); | |
815 | /* pci_disable_device(dev); */ | |
816 | ||
817 | pci_set_drvdata(dev, NULL); | |
818 | framebuffer_release(info); | |
819 | } | |
820 | } | |
821 | ||
822 | ||
823 | #ifdef CONFIG_PM | |
824 | /* PCI suspend */ | |
825 | ||
826 | static int vt8623_pci_suspend(struct pci_dev* dev, pm_message_t state) | |
827 | { | |
828 | struct fb_info *info = pci_get_drvdata(dev); | |
829 | struct vt8623fb_info *par = info->par; | |
830 | ||
594a8819 | 831 | dev_info(info->device, "suspend\n"); |
558b7bd8 | 832 | |
ac751efa | 833 | console_lock(); |
558b7bd8 OZ |
834 | mutex_lock(&(par->open_lock)); |
835 | ||
836 | if ((state.event == PM_EVENT_FREEZE) || (par->ref_count == 0)) { | |
837 | mutex_unlock(&(par->open_lock)); | |
ac751efa | 838 | console_unlock(); |
558b7bd8 OZ |
839 | return 0; |
840 | } | |
841 | ||
842 | fb_set_suspend(info, 1); | |
843 | ||
844 | pci_save_state(dev); | |
845 | pci_disable_device(dev); | |
846 | pci_set_power_state(dev, pci_choose_state(dev, state)); | |
847 | ||
848 | mutex_unlock(&(par->open_lock)); | |
ac751efa | 849 | console_unlock(); |
558b7bd8 OZ |
850 | |
851 | return 0; | |
852 | } | |
853 | ||
854 | ||
855 | /* PCI resume */ | |
856 | ||
857 | static int vt8623_pci_resume(struct pci_dev* dev) | |
858 | { | |
859 | struct fb_info *info = pci_get_drvdata(dev); | |
860 | struct vt8623fb_info *par = info->par; | |
861 | ||
594a8819 | 862 | dev_info(info->device, "resume\n"); |
558b7bd8 | 863 | |
ac751efa | 864 | console_lock(); |
558b7bd8 OZ |
865 | mutex_lock(&(par->open_lock)); |
866 | ||
950d442a JL |
867 | if (par->ref_count == 0) |
868 | goto fail; | |
558b7bd8 OZ |
869 | |
870 | pci_set_power_state(dev, PCI_D0); | |
871 | pci_restore_state(dev); | |
872 | ||
873 | if (pci_enable_device(dev)) | |
874 | goto fail; | |
875 | ||
876 | pci_set_master(dev); | |
877 | ||
878 | vt8623fb_set_par(info); | |
879 | fb_set_suspend(info, 0); | |
880 | ||
558b7bd8 | 881 | fail: |
950d442a | 882 | mutex_unlock(&(par->open_lock)); |
ac751efa | 883 | console_unlock(); |
558b7bd8 OZ |
884 | |
885 | return 0; | |
886 | } | |
887 | #else | |
888 | #define vt8623_pci_suspend NULL | |
889 | #define vt8623_pci_resume NULL | |
890 | #endif /* CONFIG_PM */ | |
891 | ||
892 | /* List of boards that we are trying to support */ | |
893 | ||
894 | static struct pci_device_id vt8623_devices[] __devinitdata = { | |
895 | {PCI_DEVICE(PCI_VENDOR_ID_VIA, 0x3122)}, | |
896 | {0, 0, 0, 0, 0, 0, 0} | |
897 | }; | |
898 | ||
899 | MODULE_DEVICE_TABLE(pci, vt8623_devices); | |
900 | ||
901 | static struct pci_driver vt8623fb_pci_driver = { | |
902 | .name = "vt8623fb", | |
903 | .id_table = vt8623_devices, | |
904 | .probe = vt8623_pci_probe, | |
905 | .remove = __devexit_p(vt8623_pci_remove), | |
906 | .suspend = vt8623_pci_suspend, | |
907 | .resume = vt8623_pci_resume, | |
908 | }; | |
909 | ||
910 | /* Cleanup */ | |
911 | ||
912 | static void __exit vt8623fb_cleanup(void) | |
913 | { | |
914 | pr_debug("vt8623fb: cleaning up\n"); | |
915 | pci_unregister_driver(&vt8623fb_pci_driver); | |
916 | } | |
917 | ||
918 | /* Driver Initialisation */ | |
919 | ||
3552f09a | 920 | static int __init vt8623fb_init(void) |
558b7bd8 OZ |
921 | { |
922 | ||
923 | #ifndef MODULE | |
924 | char *option = NULL; | |
925 | ||
926 | if (fb_get_options("vt8623fb", &option)) | |
927 | return -ENODEV; | |
928 | ||
929 | if (option && *option) | |
cc6c549c | 930 | mode_option = option; |
558b7bd8 OZ |
931 | #endif |
932 | ||
933 | pr_debug("vt8623fb: initializing\n"); | |
934 | return pci_register_driver(&vt8623fb_pci_driver); | |
935 | } | |
936 | ||
937 | /* ------------------------------------------------------------------------- */ | |
938 | ||
939 | /* Modularization */ | |
940 | ||
941 | module_init(vt8623fb_init); | |
942 | module_exit(vt8623fb_cleanup); |