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