1 /*	$NetBSD: nouveau_bios.h,v 1.5 2021/12/18 23:45:32 riastradh Exp $	*/
2 
3 /*
4  * Copyright 2007-2008 Nouveau Project
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the "Software"),
8  * to deal in the Software without restriction, including without limitation
9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10  * and/or sell copies of the Software, and to permit persons to whom the
11  * Software is furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice (including the next
14  * paragraph) shall be included in all copies or substantial portions of the
15  * Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
20  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
23  * DEALINGS IN THE SOFTWARE.
24  */
25 
26 #ifndef __NOUVEAU_DISPBIOS_H__
27 #define __NOUVEAU_DISPBIOS_H__
28 
29 #define DCB_MAX_NUM_ENTRIES 16
30 #define DCB_MAX_NUM_I2C_ENTRIES 16
31 #define DCB_MAX_NUM_GPIO_ENTRIES 32
32 #define DCB_MAX_NUM_CONNECTOR_ENTRIES 16
33 
34 #define DCB_LOC_ON_CHIP 0
35 
36 #define ROM16(x) get_unaligned_le16(&(x))
37 #define ROM32(x) get_unaligned_le32(&(x))
38 #define ROMPTR(d,x) ({            \
39 	struct nouveau_drm *drm = nouveau_drm((d)); \
40 	ROM16(x) ? &drm->vbios.data[ROM16(x)] : NULL; \
41 })
42 
43 struct bit_entry {
44 	uint8_t  id;
45 	uint8_t  version;
46 	uint16_t length;
47 	uint16_t offset;
48 	uint8_t *data;
49 };
50 
51 int bit_table(struct drm_device *, u8 id, struct bit_entry *);
52 
53 #include <subdev/bios/dcb.h>
54 #include <subdev/bios/conn.h>
55 
56 struct dcb_table {
57 	uint8_t version;
58 	int entries;
59 	struct dcb_output entry[DCB_MAX_NUM_ENTRIES];
60 };
61 
62 enum nouveau_or {
63 	DCB_OUTPUT_A = (1 << 0),
64 	DCB_OUTPUT_B = (1 << 1),
65 	DCB_OUTPUT_C = (1 << 2)
66 };
67 
68 enum LVDS_script {
69 	/* Order *does* matter here */
70 	LVDS_INIT = 1,
71 	LVDS_RESET,
72 	LVDS_BACKLIGHT_ON,
73 	LVDS_BACKLIGHT_OFF,
74 	LVDS_PANEL_ON,
75 	LVDS_PANEL_OFF
76 };
77 
78 struct nvbios {
79 	struct drm_device *dev;
80 	enum {
81 		NVBIOS_BMP,
82 		NVBIOS_BIT
83 	} type;
84 	uint16_t offset;
85 	uint32_t length;
86 	uint8_t *data;
87 
88 	uint8_t chip_version;
89 
90 	uint32_t dactestval;
91 	uint32_t tvdactestval;
92 	uint8_t digital_min_front_porch;
93 	bool fp_no_ddc;
94 
95 	spinlock_t lock;
96 
97 	bool execute;
98 
99 	uint8_t major_version;
100 	uint8_t feature_byte;
101 	bool is_mobile;
102 
103 	uint32_t fmaxvco, fminvco;
104 
105 	bool old_style_init;
106 	uint16_t init_script_tbls_ptr;
107 	uint16_t extra_init_script_tbl_ptr;
108 
109 	uint16_t ram_restrict_tbl_ptr;
110 	uint8_t ram_restrict_group_count;
111 
112 	struct dcb_table dcb;
113 
114 	struct {
115 		int crtchead;
116 	} state;
117 
118 	struct {
119 		uint16_t fptablepointer;	/* also used by tmds */
120 		uint16_t fpxlatetableptr;
121 		int xlatwidth;
122 		uint16_t lvdsmanufacturerpointer;
123 		uint16_t fpxlatemanufacturertableptr;
124 		uint16_t mode_ptr;
125 		uint16_t xlated_entry;
126 		bool power_off_for_reset;
127 		bool reset_after_pclk_change;
128 		bool dual_link;
129 		bool link_c_increment;
130 		bool if_is_24bit;
131 		int duallink_transition_clk;
132 		uint8_t strapless_is_24bit;
133 		uint8_t *edid;
134 
135 		/* will need resetting after suspend */
136 		int last_script_invoc;
137 		bool lvds_init_run;
138 	} fp;
139 
140 	struct {
141 		uint16_t output0_script_ptr;
142 		uint16_t output1_script_ptr;
143 	} tmds;
144 
145 	struct {
146 		uint16_t mem_init_tbl_ptr;
147 		uint16_t sdr_seq_tbl_ptr;
148 		uint16_t ddr_seq_tbl_ptr;
149 
150 		struct {
151 			uint8_t crt, tv, panel;
152 		} i2c_indices;
153 
154 		uint16_t lvds_single_a_script_ptr;
155 	} legacy;
156 };
157 
158 void *olddcb_table(struct drm_device *);
159 void *olddcb_outp(struct drm_device *, u8 idx);
160 int olddcb_outp_foreach(struct drm_device *, void *data,
161 		     int (*)(struct drm_device *, void *, int idx, u8 *outp));
162 u8 *olddcb_conntab(struct drm_device *);
163 u8 *olddcb_conn(struct drm_device *, u8 idx);
164 
165 int nouveau_bios_init(struct drm_device *);
166 void nouveau_bios_takedown(struct drm_device *dev);
167 int nouveau_run_vbios_init(struct drm_device *);
168 struct dcb_connector_table_entry *
169 nouveau_bios_connector_entry(struct drm_device *, int index);
170 bool nouveau_bios_fp_mode(struct drm_device *, struct drm_display_mode *);
171 uint8_t *nouveau_bios_embedded_edid(struct drm_device *);
172 int nouveau_bios_parse_lvds_table(struct drm_device *, int pxclk,
173 					 bool *dl, bool *if_is_24bit);
174 int run_tmds_table(struct drm_device *, struct dcb_output *,
175 			  int head, int pxclk);
176 int call_lvds_script(struct drm_device *, struct dcb_output *, int head,
177 			    enum LVDS_script, int pxclk);
178 
179 #endif
180