1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright 2010 Matt Turner. 4 * Copyright 2012 Red Hat 5 * 6 * Authors: Matthew Garrett 7 * Matt Turner 8 * Dave Airlie 9 */ 10 #ifndef __MGAG200_DRV_H__ 11 #define __MGAG200_DRV_H__ 12 13 #include <video/vga.h> 14 15 #include <drm/drm_connector.h> 16 #include <drm/drm_crtc.h> 17 #include <drm/drm_encoder.h> 18 #include <drm/drm_gem.h> 19 #include <drm/drm_gem_shmem_helper.h> 20 #include <drm/drm_plane.h> 21 22 #include "mgag200_reg.h" 23 24 #define DRIVER_AUTHOR "Matthew Garrett" 25 26 #define DRIVER_NAME "mgag200" 27 #define DRIVER_DESC "MGA G200 SE" 28 #define DRIVER_DATE "20110418" 29 30 #define DRIVER_MAJOR 1 31 #define DRIVER_MINOR 0 32 #define DRIVER_PATCHLEVEL 0 33 34 #define RREG8(reg) ioread8(((void __iomem *)mdev->rmmio) + (reg)) 35 #define WREG8(reg, v) iowrite8(v, ((void __iomem *)mdev->rmmio) + (reg)) 36 #define RREG32(reg) ioread32(((void __iomem *)mdev->rmmio) + (reg)) 37 #define WREG32(reg, v) iowrite32(v, ((void __iomem *)mdev->rmmio) + (reg)) 38 39 #define MGA_BIOS_OFFSET 0x7ffc 40 41 #define ATTR_INDEX 0x1fc0 42 #define ATTR_DATA 0x1fc1 43 44 #define WREG_MISC(v) \ 45 WREG8(MGA_MISC_OUT, v) 46 47 #define RREG_MISC(v) \ 48 ((v) = RREG8(MGA_MISC_IN)) 49 50 #define WREG_MISC_MASKED(v, mask) \ 51 do { \ 52 u8 misc_; \ 53 u8 mask_ = (mask); \ 54 RREG_MISC(misc_); \ 55 misc_ &= ~mask_; \ 56 misc_ |= ((v) & mask_); \ 57 WREG_MISC(misc_); \ 58 } while (0) 59 60 #define WREG_ATTR(reg, v) \ 61 do { \ 62 RREG8(0x1fda); \ 63 WREG8(ATTR_INDEX, reg); \ 64 WREG8(ATTR_DATA, v); \ 65 } while (0) \ 66 67 #define RREG_SEQ(reg, v) \ 68 do { \ 69 WREG8(MGAREG_SEQ_INDEX, reg); \ 70 v = RREG8(MGAREG_SEQ_DATA); \ 71 } while (0) \ 72 73 #define WREG_SEQ(reg, v) \ 74 do { \ 75 WREG8(MGAREG_SEQ_INDEX, reg); \ 76 WREG8(MGAREG_SEQ_DATA, v); \ 77 } while (0) \ 78 79 #define RREG_CRT(reg, v) \ 80 do { \ 81 WREG8(MGAREG_CRTC_INDEX, reg); \ 82 v = RREG8(MGAREG_CRTC_DATA); \ 83 } while (0) \ 84 85 #define WREG_CRT(reg, v) \ 86 do { \ 87 WREG8(MGAREG_CRTC_INDEX, reg); \ 88 WREG8(MGAREG_CRTC_DATA, v); \ 89 } while (0) \ 90 91 #define RREG_ECRT(reg, v) \ 92 do { \ 93 WREG8(MGAREG_CRTCEXT_INDEX, reg); \ 94 v = RREG8(MGAREG_CRTCEXT_DATA); \ 95 } while (0) \ 96 97 #define WREG_ECRT(reg, v) \ 98 do { \ 99 WREG8(MGAREG_CRTCEXT_INDEX, reg); \ 100 WREG8(MGAREG_CRTCEXT_DATA, v); \ 101 } while (0) \ 102 103 #define GFX_INDEX 0x1fce 104 #define GFX_DATA 0x1fcf 105 106 #define WREG_GFX(reg, v) \ 107 do { \ 108 WREG8(GFX_INDEX, reg); \ 109 WREG8(GFX_DATA, v); \ 110 } while (0) \ 111 112 #define DAC_INDEX 0x3c00 113 #define DAC_DATA 0x3c0a 114 115 #define WREG_DAC(reg, v) \ 116 do { \ 117 WREG8(DAC_INDEX, reg); \ 118 WREG8(DAC_DATA, v); \ 119 } while (0) \ 120 121 #define MGA_MISC_OUT 0x1fc2 122 #define MGA_MISC_IN 0x1fcc 123 124 /* 125 * TODO: This is a pretty large set of default values for all kinds of 126 * settings. It should be split and set in the various DRM helpers, 127 * such as the CRTC reset or atomic_enable helpers. The PLL values 128 * probably belong to each model's PLL code. 129 */ 130 #define MGAG200_DAC_DEFAULT(xvrefctrl, xpixclkctrl, xmiscctrl, xsyspllm, xsysplln, xsyspllp) \ 131 /* 0x00: */ 0, 0, 0, 0, 0, 0, 0x00, 0, \ 132 /* 0x08: */ 0, 0, 0, 0, 0, 0, 0, 0, \ 133 /* 0x10: */ 0, 0, 0, 0, 0, 0, 0, 0, \ 134 /* 0x18: */ (xvrefctrl), \ 135 /* 0x19: */ 0, \ 136 /* 0x1a: */ (xpixclkctrl), \ 137 /* 0x1b: */ 0xff, 0xbf, 0x20, \ 138 /* 0x1e: */ (xmiscctrl), \ 139 /* 0x1f: */ 0x20, \ 140 /* 0x20: */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \ 141 /* 0x28: */ 0x00, 0x00, 0x00, 0x00, \ 142 /* 0x2c: */ (xsyspllm), \ 143 /* 0x2d: */ (xsysplln), \ 144 /* 0x2e: */ (xsyspllp), \ 145 /* 0x2f: */ 0x40, \ 146 /* 0x30: */ 0x00, 0xb0, 0x00, 0xc2, 0x34, 0x14, 0x02, 0x83, \ 147 /* 0x38: */ 0x00, 0x93, 0x00, 0x77, 0x00, 0x00, 0x00, 0x3a, \ 148 /* 0x40: */ 0, 0, 0, 0, 0, 0, 0, 0, \ 149 /* 0x48: */ 0, 0, 0, 0, 0, 0, 0, 0 \ 150 151 #define MGAG200_LUT_SIZE 256 152 153 #define MGAG200_MAX_FB_HEIGHT 4096 154 #define MGAG200_MAX_FB_WIDTH 4096 155 156 struct mga_device; 157 158 /* 159 * Stores parameters for programming the PLLs 160 * 161 * Fref: reference frequency (A: 25.175 Mhz, B: 28.361, C: XX Mhz) 162 * Fo: output frequency 163 * Fvco = Fref * (N / M) 164 * Fo = Fvco / P 165 * 166 * S = [0..3] 167 */ 168 struct mgag200_pll_values { 169 unsigned int m; 170 unsigned int n; 171 unsigned int p; 172 unsigned int s; 173 }; 174 175 struct mgag200_crtc_state { 176 struct drm_crtc_state base; 177 178 /* Primary-plane format; required for modesetting and color mgmt. */ 179 const struct drm_format_info *format; 180 181 struct mgag200_pll_values pixpllc; 182 }; 183 184 static inline struct mgag200_crtc_state *to_mgag200_crtc_state(struct drm_crtc_state *base) 185 { 186 return container_of(base, struct mgag200_crtc_state, base); 187 } 188 189 struct mgag200_bmc_connector { 190 struct drm_connector base; 191 struct drm_connector *physical_connector; 192 }; 193 194 enum mga_type { 195 G200_PCI, 196 G200_AGP, 197 G200_SE_A, 198 G200_SE_B, 199 G200_WB, 200 G200_EV, 201 G200_EH, 202 G200_EH3, 203 G200_ER, 204 G200_EW3, 205 }; 206 207 struct mgag200_device_info { 208 u16 max_hdisplay; 209 u16 max_vdisplay; 210 211 /* 212 * Maximum memory bandwidth (MiB/sec). Setting this to zero disables 213 * the rsp test during mode validation. 214 */ 215 unsigned long max_mem_bandwidth; 216 217 /* HW has external source (e.g., BMC) to synchronize with */ 218 bool has_vidrst:1; 219 220 struct { 221 unsigned data_bit:3; 222 unsigned clock_bit:3; 223 } i2c; 224 225 /* 226 * HW does not handle 'startadd' register correctly. Always set 227 * it's value to 0. 228 */ 229 bool bug_no_startadd:1; 230 }; 231 232 #define MGAG200_DEVICE_INFO_INIT(_max_hdisplay, _max_vdisplay, _max_mem_bandwidth, \ 233 _has_vidrst, _i2c_data_bit, _i2c_clock_bit, \ 234 _bug_no_startadd) \ 235 { \ 236 .max_hdisplay = (_max_hdisplay), \ 237 .max_vdisplay = (_max_vdisplay), \ 238 .max_mem_bandwidth = (_max_mem_bandwidth), \ 239 .has_vidrst = (_has_vidrst), \ 240 .i2c = { \ 241 .data_bit = (_i2c_data_bit), \ 242 .clock_bit = (_i2c_clock_bit), \ 243 }, \ 244 .bug_no_startadd = (_bug_no_startadd), \ 245 } 246 247 struct mgag200_device_funcs { 248 /* 249 * Disables an external reset source (i.e., BMC) before programming 250 * a new display mode. 251 */ 252 void (*disable_vidrst)(struct mga_device *mdev); 253 254 /* 255 * Enables an external reset source (i.e., BMC) after programming 256 * a new display mode. 257 */ 258 void (*enable_vidrst)(struct mga_device *mdev); 259 260 /* 261 * Validate that the given state can be programmed into PIXPLLC. On 262 * success, the calculated parameters should be stored in the CRTC's 263 * state in struct @mgag200_crtc_state.pixpllc. 264 */ 265 int (*pixpllc_atomic_check)(struct drm_crtc *crtc, struct drm_atomic_state *new_state); 266 267 /* 268 * Program PIXPLLC from the CRTC state. The parameters should have been 269 * stored in struct @mgag200_crtc_state.pixpllc by the corresponding 270 * implementation of @pixpllc_atomic_check. 271 */ 272 void (*pixpllc_atomic_update)(struct drm_crtc *crtc, struct drm_atomic_state *old_state); 273 }; 274 275 struct mga_device { 276 struct drm_device base; 277 278 const struct mgag200_device_info *info; 279 const struct mgag200_device_funcs *funcs; 280 281 struct resource *rmmio_res; 282 void __iomem *rmmio; 283 struct mutex rmmio_lock; /* Protects access to rmmio */ 284 285 struct resource *vram_res; 286 void __iomem *vram; 287 resource_size_t vram_available; 288 289 struct drm_plane primary_plane; 290 struct drm_crtc crtc; 291 struct { 292 struct { 293 struct drm_encoder encoder; 294 struct drm_connector connector; 295 } vga; 296 struct { 297 struct drm_encoder encoder; 298 struct mgag200_bmc_connector bmc_connector; 299 } bmc; 300 } output; 301 }; 302 303 static inline struct mga_device *to_mga_device(struct drm_device *dev) 304 { 305 return container_of(dev, struct mga_device, base); 306 } 307 308 struct mgag200_g200_device { 309 struct mga_device base; 310 311 /* PLL constants */ 312 long ref_clk; 313 long pclk_min; 314 long pclk_max; 315 }; 316 317 static inline struct mgag200_g200_device *to_mgag200_g200_device(struct drm_device *dev) 318 { 319 return container_of(to_mga_device(dev), struct mgag200_g200_device, base); 320 } 321 322 struct mgag200_g200se_device { 323 struct mga_device base; 324 325 /* SE model number stored in reg 0x1e24 */ 326 u32 unique_rev_id; 327 }; 328 329 static inline struct mgag200_g200se_device *to_mgag200_g200se_device(struct drm_device *dev) 330 { 331 return container_of(to_mga_device(dev), struct mgag200_g200se_device, base); 332 } 333 334 /* mgag200_drv.c */ 335 int mgag200_init_pci_options(struct pci_dev *pdev, u32 option, u32 option2); 336 resource_size_t mgag200_probe_vram(void __iomem *mem, resource_size_t size); 337 resource_size_t mgag200_device_probe_vram(struct mga_device *mdev); 338 int mgag200_device_preinit(struct mga_device *mdev); 339 int mgag200_device_init(struct mga_device *mdev, 340 const struct mgag200_device_info *info, 341 const struct mgag200_device_funcs *funcs); 342 343 /* mgag200_<device type>.c */ 344 struct mga_device *mgag200_g200_device_create(struct pci_dev *pdev, const struct drm_driver *drv); 345 struct mga_device *mgag200_g200se_device_create(struct pci_dev *pdev, const struct drm_driver *drv, 346 enum mga_type type); 347 void mgag200_g200wb_init_registers(struct mga_device *mdev); 348 void mgag200_g200wb_pixpllc_atomic_update(struct drm_crtc *crtc, struct drm_atomic_state *old_state); 349 struct mga_device *mgag200_g200wb_device_create(struct pci_dev *pdev, const struct drm_driver *drv); 350 struct mga_device *mgag200_g200ev_device_create(struct pci_dev *pdev, const struct drm_driver *drv); 351 void mgag200_g200eh_init_registers(struct mga_device *mdev); 352 void mgag200_g200eh_pixpllc_atomic_update(struct drm_crtc *crtc, struct drm_atomic_state *old_state); 353 struct mga_device *mgag200_g200eh_device_create(struct pci_dev *pdev, 354 const struct drm_driver *drv); 355 struct mga_device *mgag200_g200eh3_device_create(struct pci_dev *pdev, 356 const struct drm_driver *drv); 357 struct mga_device *mgag200_g200er_device_create(struct pci_dev *pdev, 358 const struct drm_driver *drv); 359 struct mga_device *mgag200_g200ew3_device_create(struct pci_dev *pdev, 360 const struct drm_driver *drv); 361 362 /* 363 * mgag200_mode.c 364 */ 365 366 struct drm_crtc; 367 struct drm_crtc_state; 368 struct drm_display_mode; 369 struct drm_plane; 370 struct drm_atomic_state; 371 struct drm_scanout_buffer; 372 373 extern const uint32_t mgag200_primary_plane_formats[]; 374 extern const size_t mgag200_primary_plane_formats_size; 375 extern const uint64_t mgag200_primary_plane_fmtmods[]; 376 377 int mgag200_primary_plane_helper_atomic_check(struct drm_plane *plane, 378 struct drm_atomic_state *new_state); 379 void mgag200_primary_plane_helper_atomic_update(struct drm_plane *plane, 380 struct drm_atomic_state *old_state); 381 void mgag200_primary_plane_helper_atomic_enable(struct drm_plane *plane, 382 struct drm_atomic_state *state); 383 void mgag200_primary_plane_helper_atomic_disable(struct drm_plane *plane, 384 struct drm_atomic_state *old_state); 385 int mgag200_primary_plane_helper_get_scanout_buffer(struct drm_plane *plane, 386 struct drm_scanout_buffer *sb); 387 388 #define MGAG200_PRIMARY_PLANE_HELPER_FUNCS \ 389 DRM_GEM_SHADOW_PLANE_HELPER_FUNCS, \ 390 .atomic_check = mgag200_primary_plane_helper_atomic_check, \ 391 .atomic_update = mgag200_primary_plane_helper_atomic_update, \ 392 .atomic_enable = mgag200_primary_plane_helper_atomic_enable, \ 393 .atomic_disable = mgag200_primary_plane_helper_atomic_disable, \ 394 .get_scanout_buffer = mgag200_primary_plane_helper_get_scanout_buffer 395 396 #define MGAG200_PRIMARY_PLANE_FUNCS \ 397 .update_plane = drm_atomic_helper_update_plane, \ 398 .disable_plane = drm_atomic_helper_disable_plane, \ 399 .destroy = drm_plane_cleanup, \ 400 DRM_GEM_SHADOW_PLANE_FUNCS 401 402 void mgag200_crtc_set_gamma_linear(struct mga_device *mdev, const struct drm_format_info *format); 403 void mgag200_crtc_set_gamma(struct mga_device *mdev, 404 const struct drm_format_info *format, 405 struct drm_color_lut *lut); 406 407 enum drm_mode_status mgag200_crtc_helper_mode_valid(struct drm_crtc *crtc, 408 const struct drm_display_mode *mode); 409 int mgag200_crtc_helper_atomic_check(struct drm_crtc *crtc, struct drm_atomic_state *new_state); 410 void mgag200_crtc_helper_atomic_flush(struct drm_crtc *crtc, struct drm_atomic_state *old_state); 411 void mgag200_crtc_helper_atomic_enable(struct drm_crtc *crtc, struct drm_atomic_state *old_state); 412 void mgag200_crtc_helper_atomic_disable(struct drm_crtc *crtc, struct drm_atomic_state *old_state); 413 414 #define MGAG200_CRTC_HELPER_FUNCS \ 415 .mode_valid = mgag200_crtc_helper_mode_valid, \ 416 .atomic_check = mgag200_crtc_helper_atomic_check, \ 417 .atomic_flush = mgag200_crtc_helper_atomic_flush, \ 418 .atomic_enable = mgag200_crtc_helper_atomic_enable, \ 419 .atomic_disable = mgag200_crtc_helper_atomic_disable 420 421 void mgag200_crtc_reset(struct drm_crtc *crtc); 422 struct drm_crtc_state *mgag200_crtc_atomic_duplicate_state(struct drm_crtc *crtc); 423 void mgag200_crtc_atomic_destroy_state(struct drm_crtc *crtc, struct drm_crtc_state *crtc_state); 424 425 #define MGAG200_CRTC_FUNCS \ 426 .reset = mgag200_crtc_reset, \ 427 .destroy = drm_crtc_cleanup, \ 428 .set_config = drm_atomic_helper_set_config, \ 429 .page_flip = drm_atomic_helper_page_flip, \ 430 .atomic_duplicate_state = mgag200_crtc_atomic_duplicate_state, \ 431 .atomic_destroy_state = mgag200_crtc_atomic_destroy_state 432 433 void mgag200_set_mode_regs(struct mga_device *mdev, const struct drm_display_mode *mode); 434 void mgag200_set_format_regs(struct mga_device *mdev, const struct drm_format_info *format); 435 void mgag200_enable_display(struct mga_device *mdev); 436 void mgag200_init_registers(struct mga_device *mdev); 437 int mgag200_mode_config_init(struct mga_device *mdev, resource_size_t vram_available); 438 439 /* mgag200_vga.c */ 440 int mgag200_vga_output_init(struct mga_device *mdev); 441 442 /* mgag200_bmc.c */ 443 void mgag200_bmc_disable_vidrst(struct mga_device *mdev); 444 void mgag200_bmc_enable_vidrst(struct mga_device *mdev); 445 int mgag200_bmc_output_init(struct mga_device *mdev, struct drm_connector *physical_connector); 446 447 #endif /* __MGAG200_DRV_H__ */ 448