Commit | Line | Data |
---|---|---|
79e53945 | 1 | /* |
39507259 | 2 | * Copyright © 2006 Intel Corporation |
79e53945 JB |
3 | * |
4 | * Permission is hereby granted, free of charge, to any person obtaining a | |
5 | * copy of this software and associated documentation files (the "Software"), | |
6 | * to deal in the Software without restriction, including without limitation | |
7 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, | |
8 | * and/or sell copies of the Software, and to permit persons to whom the | |
9 | * Software is furnished to do so, subject to the following conditions: | |
10 | * | |
11 | * The above copyright notice and this permission notice (including the next | |
12 | * paragraph) shall be included in all copies or substantial portions of the | |
13 | * Software. | |
14 | * | |
15 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
16 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
17 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL | |
18 | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
19 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
20 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | |
21 | * SOFTWARE. | |
22 | * | |
23 | * Authors: | |
24 | * Eric Anholt <eric@anholt.net> | |
25 | * | |
26 | */ | |
25e341cf | 27 | #include <linux/dmi.h> |
9f0e7ff4 | 28 | #include <drm/drm_dp_helper.h> |
760285e7 DH |
29 | #include <drm/drmP.h> |
30 | #include <drm/i915_drm.h> | |
79e53945 JB |
31 | #include "i915_drv.h" |
32 | #include "intel_bios.h" | |
33 | ||
9b9d172d | 34 | #define SLAVE_ADDR1 0x70 |
35 | #define SLAVE_ADDR2 0x72 | |
79e53945 | 36 | |
500a8cc4 ZW |
37 | static int panel_type; |
38 | ||
79e53945 JB |
39 | static void * |
40 | find_section(struct bdb_header *bdb, int section_id) | |
41 | { | |
42 | u8 *base = (u8 *)bdb; | |
43 | int index = 0; | |
44 | u16 total, current_size; | |
45 | u8 current_id; | |
46 | ||
47 | /* skip to first section */ | |
48 | index += bdb->header_size; | |
49 | total = bdb->bdb_size; | |
50 | ||
51 | /* walk the sections looking for section_id */ | |
52 | while (index < total) { | |
53 | current_id = *(base + index); | |
54 | index++; | |
55 | current_size = *((u16 *)(base + index)); | |
56 | index += 2; | |
57 | if (current_id == section_id) | |
58 | return base + index; | |
59 | index += current_size; | |
60 | } | |
61 | ||
62 | return NULL; | |
63 | } | |
64 | ||
db545019 DMEA |
65 | static u16 |
66 | get_blocksize(void *p) | |
67 | { | |
68 | u16 *block_ptr, block_size; | |
69 | ||
70 | block_ptr = (u16 *)((char *)p - 2); | |
71 | block_size = *block_ptr; | |
72 | return block_size; | |
73 | } | |
74 | ||
79e53945 | 75 | static void |
88631706 | 76 | fill_detail_timing_data(struct drm_display_mode *panel_fixed_mode, |
99834ea4 | 77 | const struct lvds_dvo_timing *dvo_timing) |
88631706 ML |
78 | { |
79 | panel_fixed_mode->hdisplay = (dvo_timing->hactive_hi << 8) | | |
80 | dvo_timing->hactive_lo; | |
81 | panel_fixed_mode->hsync_start = panel_fixed_mode->hdisplay + | |
82 | ((dvo_timing->hsync_off_hi << 8) | dvo_timing->hsync_off_lo); | |
83 | panel_fixed_mode->hsync_end = panel_fixed_mode->hsync_start + | |
84 | dvo_timing->hsync_pulse_width; | |
85 | panel_fixed_mode->htotal = panel_fixed_mode->hdisplay + | |
86 | ((dvo_timing->hblank_hi << 8) | dvo_timing->hblank_lo); | |
87 | ||
88 | panel_fixed_mode->vdisplay = (dvo_timing->vactive_hi << 8) | | |
89 | dvo_timing->vactive_lo; | |
90 | panel_fixed_mode->vsync_start = panel_fixed_mode->vdisplay + | |
91 | dvo_timing->vsync_off; | |
92 | panel_fixed_mode->vsync_end = panel_fixed_mode->vsync_start + | |
93 | dvo_timing->vsync_pulse_width; | |
94 | panel_fixed_mode->vtotal = panel_fixed_mode->vdisplay + | |
95 | ((dvo_timing->vblank_hi << 8) | dvo_timing->vblank_lo); | |
96 | panel_fixed_mode->clock = dvo_timing->clock * 10; | |
97 | panel_fixed_mode->type = DRM_MODE_TYPE_PREFERRED; | |
98 | ||
9bc35499 AJ |
99 | if (dvo_timing->hsync_positive) |
100 | panel_fixed_mode->flags |= DRM_MODE_FLAG_PHSYNC; | |
101 | else | |
102 | panel_fixed_mode->flags |= DRM_MODE_FLAG_NHSYNC; | |
103 | ||
104 | if (dvo_timing->vsync_positive) | |
105 | panel_fixed_mode->flags |= DRM_MODE_FLAG_PVSYNC; | |
106 | else | |
107 | panel_fixed_mode->flags |= DRM_MODE_FLAG_NVSYNC; | |
108 | ||
88631706 ML |
109 | /* Some VBTs have bogus h/vtotal values */ |
110 | if (panel_fixed_mode->hsync_end > panel_fixed_mode->htotal) | |
111 | panel_fixed_mode->htotal = panel_fixed_mode->hsync_end + 1; | |
112 | if (panel_fixed_mode->vsync_end > panel_fixed_mode->vtotal) | |
113 | panel_fixed_mode->vtotal = panel_fixed_mode->vsync_end + 1; | |
114 | ||
115 | drm_mode_set_name(panel_fixed_mode); | |
116 | } | |
117 | ||
99834ea4 CW |
118 | static bool |
119 | lvds_dvo_timing_equal_size(const struct lvds_dvo_timing *a, | |
120 | const struct lvds_dvo_timing *b) | |
121 | { | |
122 | if (a->hactive_hi != b->hactive_hi || | |
123 | a->hactive_lo != b->hactive_lo) | |
124 | return false; | |
125 | ||
126 | if (a->hsync_off_hi != b->hsync_off_hi || | |
127 | a->hsync_off_lo != b->hsync_off_lo) | |
128 | return false; | |
129 | ||
130 | if (a->hsync_pulse_width != b->hsync_pulse_width) | |
131 | return false; | |
132 | ||
133 | if (a->hblank_hi != b->hblank_hi || | |
134 | a->hblank_lo != b->hblank_lo) | |
135 | return false; | |
136 | ||
137 | if (a->vactive_hi != b->vactive_hi || | |
138 | a->vactive_lo != b->vactive_lo) | |
139 | return false; | |
140 | ||
141 | if (a->vsync_off != b->vsync_off) | |
142 | return false; | |
143 | ||
144 | if (a->vsync_pulse_width != b->vsync_pulse_width) | |
145 | return false; | |
146 | ||
147 | if (a->vblank_hi != b->vblank_hi || | |
148 | a->vblank_lo != b->vblank_lo) | |
149 | return false; | |
150 | ||
151 | return true; | |
152 | } | |
153 | ||
154 | static const struct lvds_dvo_timing * | |
155 | get_lvds_dvo_timing(const struct bdb_lvds_lfp_data *lvds_lfp_data, | |
156 | const struct bdb_lvds_lfp_data_ptrs *lvds_lfp_data_ptrs, | |
157 | int index) | |
158 | { | |
159 | /* | |
160 | * the size of fp_timing varies on the different platform. | |
161 | * So calculate the DVO timing relative offset in LVDS data | |
162 | * entry to get the DVO timing entry | |
163 | */ | |
164 | ||
165 | int lfp_data_size = | |
166 | lvds_lfp_data_ptrs->ptr[1].dvo_timing_offset - | |
167 | lvds_lfp_data_ptrs->ptr[0].dvo_timing_offset; | |
168 | int dvo_timing_offset = | |
169 | lvds_lfp_data_ptrs->ptr[0].dvo_timing_offset - | |
170 | lvds_lfp_data_ptrs->ptr[0].fp_timing_offset; | |
171 | char *entry = (char *)lvds_lfp_data->data + lfp_data_size * index; | |
172 | ||
173 | return (struct lvds_dvo_timing *)(entry + dvo_timing_offset); | |
174 | } | |
175 | ||
b0354385 TI |
176 | /* get lvds_fp_timing entry |
177 | * this function may return NULL if the corresponding entry is invalid | |
178 | */ | |
179 | static const struct lvds_fp_timing * | |
180 | get_lvds_fp_timing(const struct bdb_header *bdb, | |
181 | const struct bdb_lvds_lfp_data *data, | |
182 | const struct bdb_lvds_lfp_data_ptrs *ptrs, | |
183 | int index) | |
184 | { | |
185 | size_t data_ofs = (const u8 *)data - (const u8 *)bdb; | |
186 | u16 data_size = ((const u16 *)data)[-1]; /* stored in header */ | |
187 | size_t ofs; | |
188 | ||
189 | if (index >= ARRAY_SIZE(ptrs->ptr)) | |
190 | return NULL; | |
191 | ofs = ptrs->ptr[index].fp_timing_offset; | |
192 | if (ofs < data_ofs || | |
193 | ofs + sizeof(struct lvds_fp_timing) > data_ofs + data_size) | |
194 | return NULL; | |
195 | return (const struct lvds_fp_timing *)((const u8 *)bdb + ofs); | |
196 | } | |
197 | ||
88631706 ML |
198 | /* Try to find integrated panel data */ |
199 | static void | |
200 | parse_lfp_panel_data(struct drm_i915_private *dev_priv, | |
201 | struct bdb_header *bdb) | |
79e53945 | 202 | { |
99834ea4 CW |
203 | const struct bdb_lvds_options *lvds_options; |
204 | const struct bdb_lvds_lfp_data *lvds_lfp_data; | |
205 | const struct bdb_lvds_lfp_data_ptrs *lvds_lfp_data_ptrs; | |
206 | const struct lvds_dvo_timing *panel_dvo_timing; | |
b0354385 | 207 | const struct lvds_fp_timing *fp_timing; |
79e53945 | 208 | struct drm_display_mode *panel_fixed_mode; |
99834ea4 | 209 | int i, downclock; |
79e53945 | 210 | |
79e53945 JB |
211 | lvds_options = find_section(bdb, BDB_LVDS_OPTIONS); |
212 | if (!lvds_options) | |
213 | return; | |
214 | ||
41aa3448 | 215 | dev_priv->vbt.lvds_dither = lvds_options->pixel_dither; |
79e53945 JB |
216 | if (lvds_options->panel_type == 0xff) |
217 | return; | |
6a04002b | 218 | |
500a8cc4 | 219 | panel_type = lvds_options->panel_type; |
79e53945 JB |
220 | |
221 | lvds_lfp_data = find_section(bdb, BDB_LVDS_LFP_DATA); | |
222 | if (!lvds_lfp_data) | |
223 | return; | |
224 | ||
1b16de0b JB |
225 | lvds_lfp_data_ptrs = find_section(bdb, BDB_LVDS_LFP_DATA_PTRS); |
226 | if (!lvds_lfp_data_ptrs) | |
227 | return; | |
228 | ||
41aa3448 | 229 | dev_priv->vbt.lvds_vbt = 1; |
79e53945 | 230 | |
99834ea4 CW |
231 | panel_dvo_timing = get_lvds_dvo_timing(lvds_lfp_data, |
232 | lvds_lfp_data_ptrs, | |
233 | lvds_options->panel_type); | |
79e53945 | 234 | |
9a298b2a | 235 | panel_fixed_mode = kzalloc(sizeof(*panel_fixed_mode), GFP_KERNEL); |
6edc3242 CW |
236 | if (!panel_fixed_mode) |
237 | return; | |
79e53945 | 238 | |
99834ea4 | 239 | fill_detail_timing_data(panel_fixed_mode, panel_dvo_timing); |
79e53945 | 240 | |
41aa3448 | 241 | dev_priv->vbt.lfp_lvds_vbt_mode = panel_fixed_mode; |
79e53945 | 242 | |
28c97730 | 243 | DRM_DEBUG_KMS("Found panel mode in BIOS VBT tables:\n"); |
88631706 | 244 | drm_mode_debug_printmodeline(panel_fixed_mode); |
37df9673 | 245 | |
d1fcea6a | 246 | /* |
99834ea4 CW |
247 | * Iterate over the LVDS panel timing info to find the lowest clock |
248 | * for the native resolution. | |
d1fcea6a | 249 | */ |
99834ea4 | 250 | downclock = panel_dvo_timing->clock; |
d1fcea6a | 251 | for (i = 0; i < 16; i++) { |
99834ea4 CW |
252 | const struct lvds_dvo_timing *dvo_timing; |
253 | ||
254 | dvo_timing = get_lvds_dvo_timing(lvds_lfp_data, | |
255 | lvds_lfp_data_ptrs, | |
256 | i); | |
257 | if (lvds_dvo_timing_equal_size(dvo_timing, panel_dvo_timing) && | |
258 | dvo_timing->clock < downclock) | |
259 | downclock = dvo_timing->clock; | |
d1fcea6a | 260 | } |
99834ea4 CW |
261 | |
262 | if (downclock < panel_dvo_timing->clock && i915_lvds_downclock) { | |
d1fcea6a | 263 | dev_priv->lvds_downclock_avail = 1; |
99834ea4 | 264 | dev_priv->lvds_downclock = downclock * 10; |
bbb0aef5 JP |
265 | DRM_DEBUG_KMS("LVDS downclock is found in VBT. " |
266 | "Normal Clock %dKHz, downclock %dKHz\n", | |
99834ea4 | 267 | panel_fixed_mode->clock, 10*downclock); |
d1fcea6a | 268 | } |
b0354385 TI |
269 | |
270 | fp_timing = get_lvds_fp_timing(bdb, lvds_lfp_data, | |
271 | lvds_lfp_data_ptrs, | |
272 | lvds_options->panel_type); | |
273 | if (fp_timing) { | |
274 | /* check the resolution, just to be sure */ | |
275 | if (fp_timing->x_res == panel_fixed_mode->hdisplay && | |
276 | fp_timing->y_res == panel_fixed_mode->vdisplay) { | |
41aa3448 | 277 | dev_priv->vbt.bios_lvds_val = fp_timing->lvds_reg_val; |
b0354385 | 278 | DRM_DEBUG_KMS("VBT initial LVDS value %x\n", |
41aa3448 | 279 | dev_priv->vbt.bios_lvds_val); |
b0354385 TI |
280 | } |
281 | } | |
88631706 ML |
282 | } |
283 | ||
284 | /* Try to find sdvo panel data */ | |
285 | static void | |
286 | parse_sdvo_panel_data(struct drm_i915_private *dev_priv, | |
287 | struct bdb_header *bdb) | |
288 | { | |
88631706 ML |
289 | struct lvds_dvo_timing *dvo_timing; |
290 | struct drm_display_mode *panel_fixed_mode; | |
5a1e5b6c | 291 | int index; |
79e53945 | 292 | |
5a1e5b6c | 293 | index = i915_vbt_sdvo_panel_type; |
c10e408a MF |
294 | if (index == -2) { |
295 | DRM_DEBUG_KMS("Ignore SDVO panel mode from BIOS VBT tables.\n"); | |
296 | return; | |
297 | } | |
298 | ||
5a1e5b6c CW |
299 | if (index == -1) { |
300 | struct bdb_sdvo_lvds_options *sdvo_lvds_options; | |
301 | ||
302 | sdvo_lvds_options = find_section(bdb, BDB_SDVO_LVDS_OPTIONS); | |
303 | if (!sdvo_lvds_options) | |
304 | return; | |
305 | ||
306 | index = sdvo_lvds_options->panel_type; | |
307 | } | |
88631706 ML |
308 | |
309 | dvo_timing = find_section(bdb, BDB_SDVO_PANEL_DTDS); | |
310 | if (!dvo_timing) | |
311 | return; | |
312 | ||
9a298b2a | 313 | panel_fixed_mode = kzalloc(sizeof(*panel_fixed_mode), GFP_KERNEL); |
88631706 ML |
314 | if (!panel_fixed_mode) |
315 | return; | |
316 | ||
5a1e5b6c | 317 | fill_detail_timing_data(panel_fixed_mode, dvo_timing + index); |
88631706 | 318 | |
41aa3448 | 319 | dev_priv->vbt.sdvo_lvds_vbt_mode = panel_fixed_mode; |
79e53945 | 320 | |
5a1e5b6c CW |
321 | DRM_DEBUG_KMS("Found SDVO panel mode in BIOS VBT tables:\n"); |
322 | drm_mode_debug_printmodeline(panel_fixed_mode); | |
79e53945 JB |
323 | } |
324 | ||
9a4114ff BF |
325 | static int intel_bios_ssc_frequency(struct drm_device *dev, |
326 | bool alternate) | |
327 | { | |
328 | switch (INTEL_INFO(dev)->gen) { | |
329 | case 2: | |
330 | return alternate ? 66 : 48; | |
331 | case 3: | |
332 | case 4: | |
333 | return alternate ? 100 : 96; | |
334 | default: | |
335 | return alternate ? 100 : 120; | |
336 | } | |
337 | } | |
338 | ||
79e53945 JB |
339 | static void |
340 | parse_general_features(struct drm_i915_private *dev_priv, | |
341 | struct bdb_header *bdb) | |
342 | { | |
bad720ff | 343 | struct drm_device *dev = dev_priv->dev; |
79e53945 JB |
344 | struct bdb_general_features *general; |
345 | ||
79e53945 JB |
346 | general = find_section(bdb, BDB_GENERAL_FEATURES); |
347 | if (general) { | |
41aa3448 RV |
348 | dev_priv->vbt.int_tv_support = general->int_tv_support; |
349 | dev_priv->vbt.int_crt_support = general->int_crt_support; | |
350 | dev_priv->vbt.lvds_use_ssc = general->enable_ssc; | |
351 | dev_priv->vbt.lvds_ssc_freq = | |
9a4114ff | 352 | intel_bios_ssc_frequency(dev, general->ssc_freq); |
41aa3448 RV |
353 | dev_priv->vbt.display_clock_mode = general->display_clock_mode; |
354 | dev_priv->vbt.fdi_rx_polarity_inverted = general->fdi_rx_polarity_inverted; | |
3f704fa2 | 355 | DRM_DEBUG_KMS("BDB_GENERAL_FEATURES int_tv_support %d int_crt_support %d lvds_use_ssc %d lvds_ssc_freq %d display_clock_mode %d fdi_rx_polarity_inverted %d\n", |
41aa3448 RV |
356 | dev_priv->vbt.int_tv_support, |
357 | dev_priv->vbt.int_crt_support, | |
358 | dev_priv->vbt.lvds_use_ssc, | |
359 | dev_priv->vbt.lvds_ssc_freq, | |
360 | dev_priv->vbt.display_clock_mode, | |
361 | dev_priv->vbt.fdi_rx_polarity_inverted); | |
79e53945 JB |
362 | } |
363 | } | |
364 | ||
db545019 DMEA |
365 | static void |
366 | parse_general_definitions(struct drm_i915_private *dev_priv, | |
367 | struct bdb_header *bdb) | |
368 | { | |
369 | struct bdb_general_definitions *general; | |
db545019 | 370 | |
db545019 DMEA |
371 | general = find_section(bdb, BDB_GENERAL_DEFINITIONS); |
372 | if (general) { | |
373 | u16 block_size = get_blocksize(general); | |
374 | if (block_size >= sizeof(*general)) { | |
375 | int bus_pin = general->crt_ddc_gmbus_pin; | |
28c97730 | 376 | DRM_DEBUG_KMS("crt_ddc_bus_pin: %d\n", bus_pin); |
3bd7d909 | 377 | if (intel_gmbus_is_port_valid(bus_pin)) |
41aa3448 | 378 | dev_priv->vbt.crt_ddc_pin = bus_pin; |
db545019 | 379 | } else { |
28c97730 | 380 | DRM_DEBUG_KMS("BDB_GD too small (%d). Invalid.\n", |
3bd7d909 | 381 | block_size); |
db545019 DMEA |
382 | } |
383 | } | |
384 | } | |
385 | ||
9b9d172d | 386 | static void |
387 | parse_sdvo_device_mapping(struct drm_i915_private *dev_priv, | |
44834a67 | 388 | struct bdb_header *bdb) |
9b9d172d | 389 | { |
390 | struct sdvo_device_mapping *p_mapping; | |
391 | struct bdb_general_definitions *p_defs; | |
768f69c9 | 392 | union child_device_config *p_child; |
9b9d172d | 393 | int i, child_device_num, count; |
db545019 | 394 | u16 block_size; |
9b9d172d | 395 | |
396 | p_defs = find_section(bdb, BDB_GENERAL_DEFINITIONS); | |
397 | if (!p_defs) { | |
44834a67 | 398 | DRM_DEBUG_KMS("No general definition block is found, unable to construct sdvo mapping.\n"); |
9b9d172d | 399 | return; |
400 | } | |
401 | /* judge whether the size of child device meets the requirements. | |
402 | * If the child device size obtained from general definition block | |
403 | * is different with sizeof(struct child_device_config), skip the | |
404 | * parsing of sdvo device info | |
405 | */ | |
406 | if (p_defs->child_dev_size != sizeof(*p_child)) { | |
407 | /* different child dev size . Ignore it */ | |
28c97730 | 408 | DRM_DEBUG_KMS("different child size is found. Invalid.\n"); |
9b9d172d | 409 | return; |
410 | } | |
411 | /* get the block size of general definitions */ | |
db545019 | 412 | block_size = get_blocksize(p_defs); |
9b9d172d | 413 | /* get the number of child device */ |
414 | child_device_num = (block_size - sizeof(*p_defs)) / | |
415 | sizeof(*p_child); | |
416 | count = 0; | |
417 | for (i = 0; i < child_device_num; i++) { | |
418 | p_child = &(p_defs->devices[i]); | |
768f69c9 | 419 | if (!p_child->old.device_type) { |
9b9d172d | 420 | /* skip the device block if device type is invalid */ |
421 | continue; | |
422 | } | |
768f69c9 PZ |
423 | if (p_child->old.slave_addr != SLAVE_ADDR1 && |
424 | p_child->old.slave_addr != SLAVE_ADDR2) { | |
9b9d172d | 425 | /* |
426 | * If the slave address is neither 0x70 nor 0x72, | |
427 | * it is not a SDVO device. Skip it. | |
428 | */ | |
429 | continue; | |
430 | } | |
768f69c9 PZ |
431 | if (p_child->old.dvo_port != DEVICE_PORT_DVOB && |
432 | p_child->old.dvo_port != DEVICE_PORT_DVOC) { | |
9b9d172d | 433 | /* skip the incorrect SDVO port */ |
0206e353 | 434 | DRM_DEBUG_KMS("Incorrect SDVO port. Skip it\n"); |
9b9d172d | 435 | continue; |
436 | } | |
28c97730 ZY |
437 | DRM_DEBUG_KMS("the SDVO device with slave addr %2x is found on" |
438 | " %s port\n", | |
768f69c9 PZ |
439 | p_child->old.slave_addr, |
440 | (p_child->old.dvo_port == DEVICE_PORT_DVOB) ? | |
9b9d172d | 441 | "SDVOB" : "SDVOC"); |
768f69c9 | 442 | p_mapping = &(dev_priv->sdvo_mappings[p_child->old.dvo_port - 1]); |
9b9d172d | 443 | if (!p_mapping->initialized) { |
768f69c9 PZ |
444 | p_mapping->dvo_port = p_child->old.dvo_port; |
445 | p_mapping->slave_addr = p_child->old.slave_addr; | |
446 | p_mapping->dvo_wiring = p_child->old.dvo_wiring; | |
447 | p_mapping->ddc_pin = p_child->old.ddc_pin; | |
448 | p_mapping->i2c_pin = p_child->old.i2c_pin; | |
9b9d172d | 449 | p_mapping->initialized = 1; |
46eb3036 | 450 | DRM_DEBUG_KMS("SDVO device: dvo=%x, addr=%x, wiring=%d, ddc_pin=%d, i2c_pin=%d\n", |
e957d772 CW |
451 | p_mapping->dvo_port, |
452 | p_mapping->slave_addr, | |
453 | p_mapping->dvo_wiring, | |
454 | p_mapping->ddc_pin, | |
46eb3036 | 455 | p_mapping->i2c_pin); |
9b9d172d | 456 | } else { |
28c97730 | 457 | DRM_DEBUG_KMS("Maybe one SDVO port is shared by " |
9b9d172d | 458 | "two SDVO device.\n"); |
459 | } | |
768f69c9 | 460 | if (p_child->old.slave2_addr) { |
9b9d172d | 461 | /* Maybe this is a SDVO device with multiple inputs */ |
462 | /* And the mapping info is not added */ | |
28c97730 ZY |
463 | DRM_DEBUG_KMS("there exists the slave2_addr. Maybe this" |
464 | " is a SDVO device with multiple inputs.\n"); | |
9b9d172d | 465 | } |
466 | count++; | |
467 | } | |
468 | ||
469 | if (!count) { | |
470 | /* No SDVO device info is found */ | |
28c97730 | 471 | DRM_DEBUG_KMS("No SDVO device info is found in VBT\n"); |
9b9d172d | 472 | } |
473 | return; | |
474 | } | |
32f9d658 ZW |
475 | |
476 | static void | |
477 | parse_driver_features(struct drm_i915_private *dev_priv, | |
478 | struct bdb_header *bdb) | |
479 | { | |
32f9d658 ZW |
480 | struct bdb_driver_features *driver; |
481 | ||
32f9d658 | 482 | driver = find_section(bdb, BDB_DRIVER_FEATURES); |
652c393a JB |
483 | if (!driver) |
484 | return; | |
485 | ||
6fca55b1 | 486 | if (driver->lvds_config == BDB_DRIVER_FEATURE_EDP) |
41aa3448 | 487 | dev_priv->vbt.edp_support = 1; |
652c393a | 488 | |
5ceb0f9b | 489 | if (driver->dual_frequency) |
652c393a | 490 | dev_priv->render_reclock_avail = true; |
32f9d658 ZW |
491 | } |
492 | ||
500a8cc4 ZW |
493 | static void |
494 | parse_edp(struct drm_i915_private *dev_priv, struct bdb_header *bdb) | |
495 | { | |
496 | struct bdb_edp *edp; | |
9f0e7ff4 JB |
497 | struct edp_power_seq *edp_pps; |
498 | struct edp_link_params *edp_link_params; | |
500a8cc4 ZW |
499 | |
500 | edp = find_section(bdb, BDB_EDP); | |
501 | if (!edp) { | |
6fca55b1 | 502 | if (dev_priv->vbt.edp_support) |
9a30a61f | 503 | DRM_DEBUG_KMS("No eDP BDB found but eDP panel supported.\n"); |
500a8cc4 ZW |
504 | return; |
505 | } | |
506 | ||
507 | switch ((edp->color_depth >> (panel_type * 2)) & 3) { | |
508 | case EDP_18BPP: | |
41aa3448 | 509 | dev_priv->vbt.edp_bpp = 18; |
500a8cc4 ZW |
510 | break; |
511 | case EDP_24BPP: | |
41aa3448 | 512 | dev_priv->vbt.edp_bpp = 24; |
500a8cc4 ZW |
513 | break; |
514 | case EDP_30BPP: | |
41aa3448 | 515 | dev_priv->vbt.edp_bpp = 30; |
500a8cc4 ZW |
516 | break; |
517 | } | |
5ceb0f9b | 518 | |
9f0e7ff4 JB |
519 | /* Get the eDP sequencing and link info */ |
520 | edp_pps = &edp->power_seqs[panel_type]; | |
521 | edp_link_params = &edp->link_params[panel_type]; | |
5ceb0f9b | 522 | |
41aa3448 | 523 | dev_priv->vbt.edp_pps = *edp_pps; |
5ceb0f9b | 524 | |
41aa3448 | 525 | dev_priv->vbt.edp_rate = edp_link_params->rate ? DP_LINK_BW_2_7 : |
9f0e7ff4 JB |
526 | DP_LINK_BW_1_62; |
527 | switch (edp_link_params->lanes) { | |
528 | case 0: | |
41aa3448 | 529 | dev_priv->vbt.edp_lanes = 1; |
9f0e7ff4 JB |
530 | break; |
531 | case 1: | |
41aa3448 | 532 | dev_priv->vbt.edp_lanes = 2; |
9f0e7ff4 JB |
533 | break; |
534 | case 3: | |
535 | default: | |
41aa3448 | 536 | dev_priv->vbt.edp_lanes = 4; |
9f0e7ff4 JB |
537 | break; |
538 | } | |
539 | switch (edp_link_params->preemphasis) { | |
540 | case 0: | |
41aa3448 | 541 | dev_priv->vbt.edp_preemphasis = DP_TRAIN_PRE_EMPHASIS_0; |
9f0e7ff4 JB |
542 | break; |
543 | case 1: | |
41aa3448 | 544 | dev_priv->vbt.edp_preemphasis = DP_TRAIN_PRE_EMPHASIS_3_5; |
9f0e7ff4 JB |
545 | break; |
546 | case 2: | |
41aa3448 | 547 | dev_priv->vbt.edp_preemphasis = DP_TRAIN_PRE_EMPHASIS_6; |
9f0e7ff4 JB |
548 | break; |
549 | case 3: | |
41aa3448 | 550 | dev_priv->vbt.edp_preemphasis = DP_TRAIN_PRE_EMPHASIS_9_5; |
9f0e7ff4 JB |
551 | break; |
552 | } | |
553 | switch (edp_link_params->vswing) { | |
554 | case 0: | |
41aa3448 | 555 | dev_priv->vbt.edp_vswing = DP_TRAIN_VOLTAGE_SWING_400; |
9f0e7ff4 JB |
556 | break; |
557 | case 1: | |
41aa3448 | 558 | dev_priv->vbt.edp_vswing = DP_TRAIN_VOLTAGE_SWING_600; |
9f0e7ff4 JB |
559 | break; |
560 | case 2: | |
41aa3448 | 561 | dev_priv->vbt.edp_vswing = DP_TRAIN_VOLTAGE_SWING_800; |
9f0e7ff4 JB |
562 | break; |
563 | case 3: | |
41aa3448 | 564 | dev_priv->vbt.edp_vswing = DP_TRAIN_VOLTAGE_SWING_1200; |
9f0e7ff4 JB |
565 | break; |
566 | } | |
500a8cc4 ZW |
567 | } |
568 | ||
d17c5443 SK |
569 | static void |
570 | parse_mipi(struct drm_i915_private *dev_priv, struct bdb_header *bdb) | |
571 | { | |
572 | struct bdb_mipi *mipi; | |
573 | ||
574 | mipi = find_section(bdb, BDB_MIPI); | |
575 | if (!mipi) { | |
576 | DRM_DEBUG_KMS("No MIPI BDB found"); | |
577 | return; | |
578 | } | |
579 | ||
580 | /* XXX: add more info */ | |
581 | dev_priv->vbt.dsi.panel_id = mipi->panel_id; | |
582 | } | |
583 | ||
6acab15a PZ |
584 | static void parse_ddi_port(struct drm_i915_private *dev_priv, enum port port, |
585 | struct bdb_header *bdb) | |
586 | { | |
587 | union child_device_config *it, *child = NULL; | |
588 | struct ddi_vbt_port_info *info = &dev_priv->vbt.ddi_port_info[port]; | |
589 | uint8_t hdmi_level_shift; | |
590 | int i, j; | |
554d6af5 | 591 | bool is_dvi, is_hdmi, is_dp, is_edp, is_crt; |
6bf19e7c | 592 | uint8_t aux_channel; |
6acab15a PZ |
593 | /* Each DDI port can have more than one value on the "DVO Port" field, |
594 | * so look for all the possible values for each port and abort if more | |
595 | * than one is found. */ | |
596 | int dvo_ports[][2] = { | |
597 | {DVO_PORT_HDMIA, DVO_PORT_DPA}, | |
598 | {DVO_PORT_HDMIB, DVO_PORT_DPB}, | |
599 | {DVO_PORT_HDMIC, DVO_PORT_DPC}, | |
600 | {DVO_PORT_HDMID, DVO_PORT_DPD}, | |
601 | {DVO_PORT_CRT, -1 /* Port E can only be DVO_PORT_CRT */ }, | |
602 | }; | |
603 | ||
604 | /* Find the child device to use, abort if more than one found. */ | |
605 | for (i = 0; i < dev_priv->vbt.child_dev_num; i++) { | |
606 | it = dev_priv->vbt.child_dev + i; | |
607 | ||
608 | for (j = 0; j < 2; j++) { | |
609 | if (dvo_ports[port][j] == -1) | |
610 | break; | |
611 | ||
612 | if (it->common.dvo_port == dvo_ports[port][j]) { | |
613 | if (child) { | |
614 | DRM_DEBUG_KMS("More than one child device for port %c in VBT.\n", | |
615 | port_name(port)); | |
616 | return; | |
617 | } | |
618 | child = it; | |
619 | } | |
620 | } | |
621 | } | |
622 | if (!child) | |
623 | return; | |
624 | ||
6bf19e7c PZ |
625 | aux_channel = child->raw[25]; |
626 | ||
627 | is_dvi = child->common.device_type & (1 << 4); | |
628 | is_dp = child->common.device_type & (1 << 2); | |
554d6af5 PZ |
629 | is_crt = child->common.device_type & (1 << 0); |
630 | is_hdmi = is_dvi && (child->common.device_type & (1 << 11)) == 0; | |
631 | is_edp = is_dp && (child->common.device_type & (1 << 12)); | |
632 | ||
311a2094 PZ |
633 | info->supports_dvi = is_dvi; |
634 | info->supports_hdmi = is_hdmi; | |
635 | info->supports_dp = is_dp; | |
636 | ||
554d6af5 PZ |
637 | DRM_DEBUG_KMS("Port %c VBT info: DP:%d HDMI:%d DVI:%d EDP:%d CRT:%d\n", |
638 | port_name(port), is_dp, is_hdmi, is_dvi, is_edp, is_crt); | |
639 | ||
640 | if (is_edp && is_dvi) | |
641 | DRM_DEBUG_KMS("Internal DP port %c is TMDS compatible\n", | |
642 | port_name(port)); | |
643 | if (is_crt && port != PORT_E) | |
644 | DRM_DEBUG_KMS("Port %c is analog\n", port_name(port)); | |
645 | if (is_crt && (is_dvi || is_dp)) | |
646 | DRM_DEBUG_KMS("Analog port %c is also DP or TMDS compatible\n", | |
647 | port_name(port)); | |
648 | if (is_dvi && (port == PORT_A || port == PORT_E)) | |
649 | DRM_DEBUG_KMS("Port %c is TMDS compabile\n", port_name(port)); | |
650 | if (!is_dvi && !is_dp && !is_crt) | |
651 | DRM_DEBUG_KMS("Port %c is not DP/TMDS/CRT compatible\n", | |
652 | port_name(port)); | |
653 | if (is_edp && (port == PORT_B || port == PORT_C || port == PORT_E)) | |
654 | DRM_DEBUG_KMS("Port %c is internal DP\n", port_name(port)); | |
6bf19e7c PZ |
655 | |
656 | if (is_dvi) { | |
657 | if (child->common.ddc_pin == 0x05 && port != PORT_B) | |
658 | DRM_DEBUG_KMS("Unexpected DDC pin for port B\n"); | |
659 | if (child->common.ddc_pin == 0x04 && port != PORT_C) | |
660 | DRM_DEBUG_KMS("Unexpected DDC pin for port C\n"); | |
661 | if (child->common.ddc_pin == 0x06 && port != PORT_D) | |
662 | DRM_DEBUG_KMS("Unexpected DDC pin for port D\n"); | |
663 | } | |
664 | ||
665 | if (is_dp) { | |
666 | if (aux_channel == 0x40 && port != PORT_A) | |
667 | DRM_DEBUG_KMS("Unexpected AUX channel for port A\n"); | |
668 | if (aux_channel == 0x10 && port != PORT_B) | |
669 | DRM_DEBUG_KMS("Unexpected AUX channel for port B\n"); | |
670 | if (aux_channel == 0x20 && port != PORT_C) | |
671 | DRM_DEBUG_KMS("Unexpected AUX channel for port C\n"); | |
672 | if (aux_channel == 0x30 && port != PORT_D) | |
673 | DRM_DEBUG_KMS("Unexpected AUX channel for port D\n"); | |
674 | } | |
675 | ||
6acab15a PZ |
676 | if (bdb->version >= 158) { |
677 | /* The VBT HDMI level shift values match the table we have. */ | |
678 | hdmi_level_shift = child->raw[7] & 0xF; | |
679 | if (hdmi_level_shift < 0xC) { | |
680 | DRM_DEBUG_KMS("VBT HDMI level shift for port %c: %d\n", | |
681 | port_name(port), | |
682 | hdmi_level_shift); | |
683 | info->hdmi_level_shift = hdmi_level_shift; | |
684 | } | |
685 | } | |
686 | } | |
687 | ||
688 | static void parse_ddi_ports(struct drm_i915_private *dev_priv, | |
689 | struct bdb_header *bdb) | |
690 | { | |
691 | struct drm_device *dev = dev_priv->dev; | |
692 | enum port port; | |
693 | ||
694 | if (!HAS_DDI(dev)) | |
695 | return; | |
696 | ||
697 | if (!dev_priv->vbt.child_dev_num) | |
698 | return; | |
699 | ||
700 | if (bdb->version < 155) | |
701 | return; | |
702 | ||
703 | for (port = PORT_A; port < I915_MAX_PORTS; port++) | |
704 | parse_ddi_port(dev_priv, port, bdb); | |
705 | } | |
706 | ||
6363ee6f ZY |
707 | static void |
708 | parse_device_mapping(struct drm_i915_private *dev_priv, | |
709 | struct bdb_header *bdb) | |
710 | { | |
711 | struct bdb_general_definitions *p_defs; | |
768f69c9 | 712 | union child_device_config *p_child, *child_dev_ptr; |
6363ee6f ZY |
713 | int i, child_device_num, count; |
714 | u16 block_size; | |
715 | ||
716 | p_defs = find_section(bdb, BDB_GENERAL_DEFINITIONS); | |
717 | if (!p_defs) { | |
44834a67 | 718 | DRM_DEBUG_KMS("No general definition block is found, no devices defined.\n"); |
6363ee6f ZY |
719 | return; |
720 | } | |
721 | /* judge whether the size of child device meets the requirements. | |
722 | * If the child device size obtained from general definition block | |
723 | * is different with sizeof(struct child_device_config), skip the | |
724 | * parsing of sdvo device info | |
725 | */ | |
726 | if (p_defs->child_dev_size != sizeof(*p_child)) { | |
727 | /* different child dev size . Ignore it */ | |
728 | DRM_DEBUG_KMS("different child size is found. Invalid.\n"); | |
729 | return; | |
730 | } | |
731 | /* get the block size of general definitions */ | |
732 | block_size = get_blocksize(p_defs); | |
733 | /* get the number of child device */ | |
734 | child_device_num = (block_size - sizeof(*p_defs)) / | |
735 | sizeof(*p_child); | |
736 | count = 0; | |
737 | /* get the number of child device that is present */ | |
738 | for (i = 0; i < child_device_num; i++) { | |
739 | p_child = &(p_defs->devices[i]); | |
768f69c9 | 740 | if (!p_child->common.device_type) { |
6363ee6f ZY |
741 | /* skip the device block if device type is invalid */ |
742 | continue; | |
743 | } | |
744 | count++; | |
745 | } | |
746 | if (!count) { | |
0206e353 | 747 | DRM_DEBUG_KMS("no child dev is parsed from VBT\n"); |
6363ee6f ZY |
748 | return; |
749 | } | |
41aa3448 RV |
750 | dev_priv->vbt.child_dev = kcalloc(count, sizeof(*p_child), GFP_KERNEL); |
751 | if (!dev_priv->vbt.child_dev) { | |
6363ee6f ZY |
752 | DRM_DEBUG_KMS("No memory space for child device\n"); |
753 | return; | |
754 | } | |
755 | ||
41aa3448 | 756 | dev_priv->vbt.child_dev_num = count; |
6363ee6f ZY |
757 | count = 0; |
758 | for (i = 0; i < child_device_num; i++) { | |
759 | p_child = &(p_defs->devices[i]); | |
768f69c9 | 760 | if (!p_child->common.device_type) { |
6363ee6f ZY |
761 | /* skip the device block if device type is invalid */ |
762 | continue; | |
763 | } | |
41aa3448 | 764 | child_dev_ptr = dev_priv->vbt.child_dev + count; |
6363ee6f ZY |
765 | count++; |
766 | memcpy((void *)child_dev_ptr, (void *)p_child, | |
767 | sizeof(*p_child)); | |
768 | } | |
769 | return; | |
770 | } | |
44834a67 | 771 | |
6a04002b SQ |
772 | static void |
773 | init_vbt_defaults(struct drm_i915_private *dev_priv) | |
774 | { | |
9a4114ff | 775 | struct drm_device *dev = dev_priv->dev; |
6acab15a | 776 | enum port port; |
9a4114ff | 777 | |
41aa3448 | 778 | dev_priv->vbt.crt_ddc_pin = GMBUS_PORT_VGADDC; |
6a04002b SQ |
779 | |
780 | /* LFP panel data */ | |
41aa3448 RV |
781 | dev_priv->vbt.lvds_dither = 1; |
782 | dev_priv->vbt.lvds_vbt = 0; | |
6a04002b SQ |
783 | |
784 | /* SDVO panel data */ | |
41aa3448 | 785 | dev_priv->vbt.sdvo_lvds_vbt_mode = NULL; |
6a04002b SQ |
786 | |
787 | /* general features */ | |
41aa3448 RV |
788 | dev_priv->vbt.int_tv_support = 1; |
789 | dev_priv->vbt.int_crt_support = 1; | |
9a4114ff BF |
790 | |
791 | /* Default to using SSC */ | |
41aa3448 RV |
792 | dev_priv->vbt.lvds_use_ssc = 1; |
793 | dev_priv->vbt.lvds_ssc_freq = intel_bios_ssc_frequency(dev, 1); | |
794 | DRM_DEBUG_KMS("Set default to SSC at %dMHz\n", dev_priv->vbt.lvds_ssc_freq); | |
6acab15a PZ |
795 | |
796 | for (port = PORT_A; port < I915_MAX_PORTS; port++) { | |
311a2094 PZ |
797 | struct ddi_vbt_port_info *info = |
798 | &dev_priv->vbt.ddi_port_info[port]; | |
799 | ||
6acab15a | 800 | /* Recommended BSpec default: 800mV 0dB. */ |
311a2094 PZ |
801 | info->hdmi_level_shift = 6; |
802 | ||
803 | info->supports_dvi = (port != PORT_A && port != PORT_E); | |
804 | info->supports_hdmi = info->supports_dvi; | |
805 | info->supports_dp = (port != PORT_E); | |
6acab15a | 806 | } |
6a04002b SQ |
807 | } |
808 | ||
25e341cf DV |
809 | static int __init intel_no_opregion_vbt_callback(const struct dmi_system_id *id) |
810 | { | |
811 | DRM_DEBUG_KMS("Falling back to manually reading VBT from " | |
812 | "VBIOS ROM for %s\n", | |
813 | id->ident); | |
814 | return 1; | |
815 | } | |
816 | ||
817 | static const struct dmi_system_id intel_no_opregion_vbt[] = { | |
818 | { | |
819 | .callback = intel_no_opregion_vbt_callback, | |
820 | .ident = "ThinkCentre A57", | |
821 | .matches = { | |
822 | DMI_MATCH(DMI_SYS_VENDOR, "LENOVO"), | |
823 | DMI_MATCH(DMI_PRODUCT_NAME, "97027RG"), | |
824 | }, | |
825 | }, | |
826 | { } | |
827 | }; | |
828 | ||
79e53945 | 829 | /** |
6d139a87 | 830 | * intel_parse_bios - find VBT and initialize settings from the BIOS |
79e53945 JB |
831 | * @dev: DRM device |
832 | * | |
833 | * Loads the Video BIOS and checks that the VBT exists. Sets scratch registers | |
834 | * to appropriate values. | |
835 | * | |
79e53945 JB |
836 | * Returns 0 on success, nonzero on failure. |
837 | */ | |
0317c6ce | 838 | int |
6d139a87 | 839 | intel_parse_bios(struct drm_device *dev) |
79e53945 JB |
840 | { |
841 | struct drm_i915_private *dev_priv = dev->dev_private; | |
842 | struct pci_dev *pdev = dev->pdev; | |
44834a67 CW |
843 | struct bdb_header *bdb = NULL; |
844 | u8 __iomem *bios = NULL; | |
845 | ||
ab5c608b BW |
846 | if (HAS_PCH_NOP(dev)) |
847 | return -ENODEV; | |
848 | ||
6a04002b | 849 | init_vbt_defaults(dev_priv); |
f899fc64 | 850 | |
44834a67 | 851 | /* XXX Should this validation be moved to intel_opregion.c? */ |
25e341cf | 852 | if (!dmi_check_system(intel_no_opregion_vbt) && dev_priv->opregion.vbt) { |
44834a67 CW |
853 | struct vbt_header *vbt = dev_priv->opregion.vbt; |
854 | if (memcmp(vbt->signature, "$VBT", 4) == 0) { | |
562396b9 | 855 | DRM_DEBUG_KMS("Using VBT from OpRegion: %20s\n", |
44834a67 CW |
856 | vbt->signature); |
857 | bdb = (struct bdb_header *)((char *)vbt + vbt->bdb_offset); | |
858 | } else | |
859 | dev_priv->opregion.vbt = NULL; | |
79e53945 JB |
860 | } |
861 | ||
44834a67 CW |
862 | if (bdb == NULL) { |
863 | struct vbt_header *vbt = NULL; | |
864 | size_t size; | |
865 | int i; | |
79e53945 | 866 | |
44834a67 CW |
867 | bios = pci_map_rom(pdev, &size); |
868 | if (!bios) | |
869 | return -1; | |
870 | ||
871 | /* Scour memory looking for the VBT signature */ | |
872 | for (i = 0; i + 4 < size; i++) { | |
873 | if (!memcmp(bios + i, "$VBT", 4)) { | |
874 | vbt = (struct vbt_header *)(bios + i); | |
875 | break; | |
876 | } | |
877 | } | |
878 | ||
879 | if (!vbt) { | |
bd45545f | 880 | DRM_DEBUG_DRIVER("VBT signature missing\n"); |
44834a67 CW |
881 | pci_unmap_rom(pdev, bios); |
882 | return -1; | |
883 | } | |
884 | ||
885 | bdb = (struct bdb_header *)(bios + i + vbt->bdb_offset); | |
886 | } | |
79e53945 JB |
887 | |
888 | /* Grab useful general definitions */ | |
889 | parse_general_features(dev_priv, bdb); | |
db545019 | 890 | parse_general_definitions(dev_priv, bdb); |
88631706 ML |
891 | parse_lfp_panel_data(dev_priv, bdb); |
892 | parse_sdvo_panel_data(dev_priv, bdb); | |
9b9d172d | 893 | parse_sdvo_device_mapping(dev_priv, bdb); |
6363ee6f | 894 | parse_device_mapping(dev_priv, bdb); |
32f9d658 | 895 | parse_driver_features(dev_priv, bdb); |
500a8cc4 | 896 | parse_edp(dev_priv, bdb); |
d17c5443 | 897 | parse_mipi(dev_priv, bdb); |
6acab15a | 898 | parse_ddi_ports(dev_priv, bdb); |
32f9d658 | 899 | |
44834a67 CW |
900 | if (bios) |
901 | pci_unmap_rom(pdev, bios); | |
79e53945 JB |
902 | |
903 | return 0; | |
904 | } | |
6d139a87 BF |
905 | |
906 | /* Ensure that vital registers have been initialised, even if the BIOS | |
907 | * is absent or just failing to do its job. | |
908 | */ | |
909 | void intel_setup_bios(struct drm_device *dev) | |
910 | { | |
911 | struct drm_i915_private *dev_priv = dev->dev_private; | |
912 | ||
913 | /* Set the Panel Power On/Off timings if uninitialized. */ | |
42d42e7e DL |
914 | if (!HAS_PCH_SPLIT(dev) && |
915 | I915_READ(PP_ON_DELAYS) == 0 && I915_READ(PP_OFF_DELAYS) == 0) { | |
6d139a87 BF |
916 | /* Set T2 to 40ms and T5 to 200ms */ |
917 | I915_WRITE(PP_ON_DELAYS, 0x019007d0); | |
918 | ||
919 | /* Set T3 to 35ms and Tx to 200ms */ | |
920 | I915_WRITE(PP_OFF_DELAYS, 0x015e07d0); | |
921 | } | |
922 | } |