1d38ceaf9SAlex Deucher /* 2d38ceaf9SAlex Deucher * Copyright 2000 ATI Technologies Inc., Markham, Ontario, and 3d38ceaf9SAlex Deucher * VA Linux Systems Inc., Fremont, California. 4d38ceaf9SAlex Deucher * Copyright 2008 Red Hat Inc. 5d38ceaf9SAlex Deucher * 6d38ceaf9SAlex Deucher * Permission is hereby granted, free of charge, to any person obtaining a 7d38ceaf9SAlex Deucher * copy of this software and associated documentation files (the "Software"), 8d38ceaf9SAlex Deucher * to deal in the Software without restriction, including without limitation 9d38ceaf9SAlex Deucher * the rights to use, copy, modify, merge, publish, distribute, sublicense, 10d38ceaf9SAlex Deucher * and/or sell copies of the Software, and to permit persons to whom the 11d38ceaf9SAlex Deucher * Software is furnished to do so, subject to the following conditions: 12d38ceaf9SAlex Deucher * 13d38ceaf9SAlex Deucher * The above copyright notice and this permission notice shall be included in 14d38ceaf9SAlex Deucher * all copies or substantial portions of the Software. 15d38ceaf9SAlex Deucher * 16d38ceaf9SAlex Deucher * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17d38ceaf9SAlex Deucher * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18d38ceaf9SAlex Deucher * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 19d38ceaf9SAlex Deucher * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR 20d38ceaf9SAlex Deucher * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 21d38ceaf9SAlex Deucher * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 22d38ceaf9SAlex Deucher * OTHER DEALINGS IN THE SOFTWARE. 23d38ceaf9SAlex Deucher * 24d38ceaf9SAlex Deucher * Original Authors: 25d38ceaf9SAlex Deucher * Kevin E. Martin, Rickard E. Faith, Alan Hourihane 26d38ceaf9SAlex Deucher * 27d38ceaf9SAlex Deucher * Kernel port Author: Dave Airlie 28d38ceaf9SAlex Deucher */ 29d38ceaf9SAlex Deucher 30d38ceaf9SAlex Deucher #ifndef AMDGPU_MODE_H 31d38ceaf9SAlex Deucher #define AMDGPU_MODE_H 32d38ceaf9SAlex Deucher 33d38ceaf9SAlex Deucher #include <drm/drm_crtc.h> 34d38ceaf9SAlex Deucher #include <drm/drm_edid.h> 359338203cSLaurent Pinchart #include <drm/drm_encoder.h> 36d38ceaf9SAlex Deucher #include <drm/drm_dp_helper.h> 37d38ceaf9SAlex Deucher #include <drm/drm_fixed.h> 38d38ceaf9SAlex Deucher #include <drm/drm_crtc_helper.h> 39b516a9efSDaniel Vetter #include <drm/drm_fb_helper.h> 40d38ceaf9SAlex Deucher #include <drm/drm_plane_helper.h> 414562236bSHarry Wentland #include <drm/drm_fb_helper.h> 42d38ceaf9SAlex Deucher #include <linux/i2c.h> 43d38ceaf9SAlex Deucher #include <linux/i2c-algo-bit.h> 4446ac3622SEmily Deng #include <linux/hrtimer.h> 4546ac3622SEmily Deng #include "amdgpu_irq.h" 46d38ceaf9SAlex Deucher 474562236bSHarry Wentland #include <drm/drm_dp_mst_helper.h> 484562236bSHarry Wentland #include "modules/inc/mod_freesync.h" 494562236bSHarry Wentland 50d38ceaf9SAlex Deucher struct amdgpu_bo; 51d38ceaf9SAlex Deucher struct amdgpu_device; 52d38ceaf9SAlex Deucher struct amdgpu_encoder; 53d38ceaf9SAlex Deucher struct amdgpu_router; 54d38ceaf9SAlex Deucher struct amdgpu_hpd; 55d38ceaf9SAlex Deucher 56d38ceaf9SAlex Deucher #define to_amdgpu_crtc(x) container_of(x, struct amdgpu_crtc, base) 57d38ceaf9SAlex Deucher #define to_amdgpu_connector(x) container_of(x, struct amdgpu_connector, base) 58d38ceaf9SAlex Deucher #define to_amdgpu_encoder(x) container_of(x, struct amdgpu_encoder, base) 59d38ceaf9SAlex Deucher #define to_amdgpu_framebuffer(x) container_of(x, struct amdgpu_framebuffer, base) 6064d8b780SShirish S #define to_amdgpu_plane(x) container_of(x, struct amdgpu_plane, base) 61d38ceaf9SAlex Deucher 620604b36cSAndrey Grodzovsky #define to_dm_plane_state(x) container_of(x, struct dm_plane_state, base); 630604b36cSAndrey Grodzovsky 64d38ceaf9SAlex Deucher #define AMDGPU_MAX_HPD_PINS 6 65d38ceaf9SAlex Deucher #define AMDGPU_MAX_CRTCS 6 66d4e13b0dSAlex Deucher #define AMDGPU_MAX_PLANES 6 6722384459SAlex Deucher #define AMDGPU_MAX_AFMT_BLOCKS 9 68d38ceaf9SAlex Deucher 69d38ceaf9SAlex Deucher enum amdgpu_rmx_type { 70d38ceaf9SAlex Deucher RMX_OFF, 71d38ceaf9SAlex Deucher RMX_FULL, 72d38ceaf9SAlex Deucher RMX_CENTER, 73d38ceaf9SAlex Deucher RMX_ASPECT 74d38ceaf9SAlex Deucher }; 75d38ceaf9SAlex Deucher 76d38ceaf9SAlex Deucher enum amdgpu_underscan_type { 77d38ceaf9SAlex Deucher UNDERSCAN_OFF, 78d38ceaf9SAlex Deucher UNDERSCAN_ON, 79d38ceaf9SAlex Deucher UNDERSCAN_AUTO, 80d38ceaf9SAlex Deucher }; 81d38ceaf9SAlex Deucher 82d38ceaf9SAlex Deucher #define AMDGPU_HPD_CONNECT_INT_DELAY_IN_MS 50 83d38ceaf9SAlex Deucher #define AMDGPU_HPD_DISCONNECT_INT_DELAY_IN_MS 10 84d38ceaf9SAlex Deucher 85d38ceaf9SAlex Deucher enum amdgpu_hpd_id { 86d38ceaf9SAlex Deucher AMDGPU_HPD_1 = 0, 87d38ceaf9SAlex Deucher AMDGPU_HPD_2, 88d38ceaf9SAlex Deucher AMDGPU_HPD_3, 89d38ceaf9SAlex Deucher AMDGPU_HPD_4, 90d38ceaf9SAlex Deucher AMDGPU_HPD_5, 91d38ceaf9SAlex Deucher AMDGPU_HPD_6, 92d38ceaf9SAlex Deucher AMDGPU_HPD_NONE = 0xff, 93d38ceaf9SAlex Deucher }; 94d38ceaf9SAlex Deucher 95d38ceaf9SAlex Deucher enum amdgpu_crtc_irq { 96d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VBLANK1 = 0, 97d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VBLANK2, 98d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VBLANK3, 99d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VBLANK4, 100d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VBLANK5, 101d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VBLANK6, 102d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VLINE1, 103d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VLINE2, 104d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VLINE3, 105d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VLINE4, 106d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VLINE5, 107d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_VLINE6, 108d38ceaf9SAlex Deucher AMDGPU_CRTC_IRQ_NONE = 0xff 109d38ceaf9SAlex Deucher }; 110d38ceaf9SAlex Deucher 111d38ceaf9SAlex Deucher enum amdgpu_pageflip_irq { 112d38ceaf9SAlex Deucher AMDGPU_PAGEFLIP_IRQ_D1 = 0, 113d38ceaf9SAlex Deucher AMDGPU_PAGEFLIP_IRQ_D2, 114d38ceaf9SAlex Deucher AMDGPU_PAGEFLIP_IRQ_D3, 115d38ceaf9SAlex Deucher AMDGPU_PAGEFLIP_IRQ_D4, 116d38ceaf9SAlex Deucher AMDGPU_PAGEFLIP_IRQ_D5, 117d38ceaf9SAlex Deucher AMDGPU_PAGEFLIP_IRQ_D6, 118d38ceaf9SAlex Deucher AMDGPU_PAGEFLIP_IRQ_NONE = 0xff 119d38ceaf9SAlex Deucher }; 120d38ceaf9SAlex Deucher 121d38ceaf9SAlex Deucher enum amdgpu_flip_status { 122d38ceaf9SAlex Deucher AMDGPU_FLIP_NONE, 123d38ceaf9SAlex Deucher AMDGPU_FLIP_PENDING, 124d38ceaf9SAlex Deucher AMDGPU_FLIP_SUBMITTED 125d38ceaf9SAlex Deucher }; 126d38ceaf9SAlex Deucher 127d38ceaf9SAlex Deucher #define AMDGPU_MAX_I2C_BUS 16 128d38ceaf9SAlex Deucher 129d38ceaf9SAlex Deucher /* amdgpu gpio-based i2c 130d38ceaf9SAlex Deucher * 1. "mask" reg and bits 131d38ceaf9SAlex Deucher * grabs the gpio pins for software use 132d38ceaf9SAlex Deucher * 0=not held 1=held 133d38ceaf9SAlex Deucher * 2. "a" reg and bits 134d38ceaf9SAlex Deucher * output pin value 135d38ceaf9SAlex Deucher * 0=low 1=high 136d38ceaf9SAlex Deucher * 3. "en" reg and bits 137d38ceaf9SAlex Deucher * sets the pin direction 138d38ceaf9SAlex Deucher * 0=input 1=output 139d38ceaf9SAlex Deucher * 4. "y" reg and bits 140d38ceaf9SAlex Deucher * input pin value 141d38ceaf9SAlex Deucher * 0=low 1=high 142d38ceaf9SAlex Deucher */ 143d38ceaf9SAlex Deucher struct amdgpu_i2c_bus_rec { 144d38ceaf9SAlex Deucher bool valid; 145d38ceaf9SAlex Deucher /* id used by atom */ 146d38ceaf9SAlex Deucher uint8_t i2c_id; 147d38ceaf9SAlex Deucher /* id used by atom */ 148d38ceaf9SAlex Deucher enum amdgpu_hpd_id hpd; 149d38ceaf9SAlex Deucher /* can be used with hw i2c engine */ 150d38ceaf9SAlex Deucher bool hw_capable; 151d38ceaf9SAlex Deucher /* uses multi-media i2c engine */ 152d38ceaf9SAlex Deucher bool mm_i2c; 153d38ceaf9SAlex Deucher /* regs and bits */ 154d38ceaf9SAlex Deucher uint32_t mask_clk_reg; 155d38ceaf9SAlex Deucher uint32_t mask_data_reg; 156d38ceaf9SAlex Deucher uint32_t a_clk_reg; 157d38ceaf9SAlex Deucher uint32_t a_data_reg; 158d38ceaf9SAlex Deucher uint32_t en_clk_reg; 159d38ceaf9SAlex Deucher uint32_t en_data_reg; 160d38ceaf9SAlex Deucher uint32_t y_clk_reg; 161d38ceaf9SAlex Deucher uint32_t y_data_reg; 162d38ceaf9SAlex Deucher uint32_t mask_clk_mask; 163d38ceaf9SAlex Deucher uint32_t mask_data_mask; 164d38ceaf9SAlex Deucher uint32_t a_clk_mask; 165d38ceaf9SAlex Deucher uint32_t a_data_mask; 166d38ceaf9SAlex Deucher uint32_t en_clk_mask; 167d38ceaf9SAlex Deucher uint32_t en_data_mask; 168d38ceaf9SAlex Deucher uint32_t y_clk_mask; 169d38ceaf9SAlex Deucher uint32_t y_data_mask; 170d38ceaf9SAlex Deucher }; 171d38ceaf9SAlex Deucher 172d38ceaf9SAlex Deucher #define AMDGPU_MAX_BIOS_CONNECTOR 16 173d38ceaf9SAlex Deucher 174d38ceaf9SAlex Deucher /* pll flags */ 175d38ceaf9SAlex Deucher #define AMDGPU_PLL_USE_BIOS_DIVS (1 << 0) 176d38ceaf9SAlex Deucher #define AMDGPU_PLL_NO_ODD_POST_DIV (1 << 1) 177d38ceaf9SAlex Deucher #define AMDGPU_PLL_USE_REF_DIV (1 << 2) 178d38ceaf9SAlex Deucher #define AMDGPU_PLL_LEGACY (1 << 3) 179d38ceaf9SAlex Deucher #define AMDGPU_PLL_PREFER_LOW_REF_DIV (1 << 4) 180d38ceaf9SAlex Deucher #define AMDGPU_PLL_PREFER_HIGH_REF_DIV (1 << 5) 181d38ceaf9SAlex Deucher #define AMDGPU_PLL_PREFER_LOW_FB_DIV (1 << 6) 182d38ceaf9SAlex Deucher #define AMDGPU_PLL_PREFER_HIGH_FB_DIV (1 << 7) 183d38ceaf9SAlex Deucher #define AMDGPU_PLL_PREFER_LOW_POST_DIV (1 << 8) 184d38ceaf9SAlex Deucher #define AMDGPU_PLL_PREFER_HIGH_POST_DIV (1 << 9) 185d38ceaf9SAlex Deucher #define AMDGPU_PLL_USE_FRAC_FB_DIV (1 << 10) 186d38ceaf9SAlex Deucher #define AMDGPU_PLL_PREFER_CLOSEST_LOWER (1 << 11) 187d38ceaf9SAlex Deucher #define AMDGPU_PLL_USE_POST_DIV (1 << 12) 188d38ceaf9SAlex Deucher #define AMDGPU_PLL_IS_LCD (1 << 13) 189d38ceaf9SAlex Deucher #define AMDGPU_PLL_PREFER_MINM_OVER_MAXP (1 << 14) 190d38ceaf9SAlex Deucher 191d38ceaf9SAlex Deucher struct amdgpu_pll { 192d38ceaf9SAlex Deucher /* reference frequency */ 193d38ceaf9SAlex Deucher uint32_t reference_freq; 194d38ceaf9SAlex Deucher 195d38ceaf9SAlex Deucher /* fixed dividers */ 196d38ceaf9SAlex Deucher uint32_t reference_div; 197d38ceaf9SAlex Deucher uint32_t post_div; 198d38ceaf9SAlex Deucher 199d38ceaf9SAlex Deucher /* pll in/out limits */ 200d38ceaf9SAlex Deucher uint32_t pll_in_min; 201d38ceaf9SAlex Deucher uint32_t pll_in_max; 202d38ceaf9SAlex Deucher uint32_t pll_out_min; 203d38ceaf9SAlex Deucher uint32_t pll_out_max; 204d38ceaf9SAlex Deucher uint32_t lcd_pll_out_min; 205d38ceaf9SAlex Deucher uint32_t lcd_pll_out_max; 206d38ceaf9SAlex Deucher uint32_t best_vco; 207d38ceaf9SAlex Deucher 208d38ceaf9SAlex Deucher /* divider limits */ 209d38ceaf9SAlex Deucher uint32_t min_ref_div; 210d38ceaf9SAlex Deucher uint32_t max_ref_div; 211d38ceaf9SAlex Deucher uint32_t min_post_div; 212d38ceaf9SAlex Deucher uint32_t max_post_div; 213d38ceaf9SAlex Deucher uint32_t min_feedback_div; 214d38ceaf9SAlex Deucher uint32_t max_feedback_div; 215d38ceaf9SAlex Deucher uint32_t min_frac_feedback_div; 216d38ceaf9SAlex Deucher uint32_t max_frac_feedback_div; 217d38ceaf9SAlex Deucher 218d38ceaf9SAlex Deucher /* flags for the current clock */ 219d38ceaf9SAlex Deucher uint32_t flags; 220d38ceaf9SAlex Deucher 221d38ceaf9SAlex Deucher /* pll id */ 222d38ceaf9SAlex Deucher uint32_t id; 223d38ceaf9SAlex Deucher }; 224d38ceaf9SAlex Deucher 225d38ceaf9SAlex Deucher struct amdgpu_i2c_chan { 226d38ceaf9SAlex Deucher struct i2c_adapter adapter; 227d38ceaf9SAlex Deucher struct drm_device *dev; 228d38ceaf9SAlex Deucher struct i2c_algo_bit_data bit; 229d38ceaf9SAlex Deucher struct amdgpu_i2c_bus_rec rec; 230d38ceaf9SAlex Deucher struct drm_dp_aux aux; 231d38ceaf9SAlex Deucher bool has_aux; 232d38ceaf9SAlex Deucher struct mutex mutex; 233d38ceaf9SAlex Deucher }; 234d38ceaf9SAlex Deucher 235d38ceaf9SAlex Deucher struct amdgpu_fbdev; 236d38ceaf9SAlex Deucher 237d38ceaf9SAlex Deucher struct amdgpu_afmt { 238d38ceaf9SAlex Deucher bool enabled; 239d38ceaf9SAlex Deucher int offset; 240d38ceaf9SAlex Deucher bool last_buffer_filled_status; 241d38ceaf9SAlex Deucher int id; 242d38ceaf9SAlex Deucher struct amdgpu_audio_pin *pin; 243d38ceaf9SAlex Deucher }; 244d38ceaf9SAlex Deucher 245d38ceaf9SAlex Deucher /* 246d38ceaf9SAlex Deucher * Audio 247d38ceaf9SAlex Deucher */ 248d38ceaf9SAlex Deucher struct amdgpu_audio_pin { 249d38ceaf9SAlex Deucher int channels; 250d38ceaf9SAlex Deucher int rate; 251d38ceaf9SAlex Deucher int bits_per_sample; 252d38ceaf9SAlex Deucher u8 status_bits; 253d38ceaf9SAlex Deucher u8 category_code; 254d38ceaf9SAlex Deucher u32 offset; 255d38ceaf9SAlex Deucher bool connected; 256d38ceaf9SAlex Deucher u32 id; 257d38ceaf9SAlex Deucher }; 258d38ceaf9SAlex Deucher 259d38ceaf9SAlex Deucher struct amdgpu_audio { 260d38ceaf9SAlex Deucher bool enabled; 261d38ceaf9SAlex Deucher struct amdgpu_audio_pin pin[AMDGPU_MAX_AFMT_BLOCKS]; 262d38ceaf9SAlex Deucher int num_pins; 263d38ceaf9SAlex Deucher }; 264d38ceaf9SAlex Deucher 265d38ceaf9SAlex Deucher struct amdgpu_display_funcs { 266d38ceaf9SAlex Deucher /* display watermarks */ 267d38ceaf9SAlex Deucher void (*bandwidth_update)(struct amdgpu_device *adev); 268d38ceaf9SAlex Deucher /* get frame count */ 269d38ceaf9SAlex Deucher u32 (*vblank_get_counter)(struct amdgpu_device *adev, int crtc); 270d38ceaf9SAlex Deucher /* wait for vblank */ 271d38ceaf9SAlex Deucher void (*vblank_wait)(struct amdgpu_device *adev, int crtc); 272d38ceaf9SAlex Deucher /* set backlight level */ 273d38ceaf9SAlex Deucher void (*backlight_set_level)(struct amdgpu_encoder *amdgpu_encoder, 274d38ceaf9SAlex Deucher u8 level); 275d38ceaf9SAlex Deucher /* get backlight level */ 276d38ceaf9SAlex Deucher u8 (*backlight_get_level)(struct amdgpu_encoder *amdgpu_encoder); 277d38ceaf9SAlex Deucher /* hotplug detect */ 278d38ceaf9SAlex Deucher bool (*hpd_sense)(struct amdgpu_device *adev, enum amdgpu_hpd_id hpd); 279d38ceaf9SAlex Deucher void (*hpd_set_polarity)(struct amdgpu_device *adev, 280d38ceaf9SAlex Deucher enum amdgpu_hpd_id hpd); 281d38ceaf9SAlex Deucher u32 (*hpd_get_gpio_reg)(struct amdgpu_device *adev); 282d38ceaf9SAlex Deucher /* pageflipping */ 283d38ceaf9SAlex Deucher void (*page_flip)(struct amdgpu_device *adev, 284cb9e59d7SAlex Deucher int crtc_id, u64 crtc_base, bool async); 285d38ceaf9SAlex Deucher int (*page_flip_get_scanoutpos)(struct amdgpu_device *adev, int crtc, 286d38ceaf9SAlex Deucher u32 *vbl, u32 *position); 287d38ceaf9SAlex Deucher /* display topology setup */ 288d38ceaf9SAlex Deucher void (*add_encoder)(struct amdgpu_device *adev, 289d38ceaf9SAlex Deucher uint32_t encoder_enum, 290d38ceaf9SAlex Deucher uint32_t supported_device, 291d38ceaf9SAlex Deucher u16 caps); 292d38ceaf9SAlex Deucher void (*add_connector)(struct amdgpu_device *adev, 293d38ceaf9SAlex Deucher uint32_t connector_id, 294d38ceaf9SAlex Deucher uint32_t supported_device, 295d38ceaf9SAlex Deucher int connector_type, 296d38ceaf9SAlex Deucher struct amdgpu_i2c_bus_rec *i2c_bus, 297d38ceaf9SAlex Deucher uint16_t connector_object_id, 298d38ceaf9SAlex Deucher struct amdgpu_hpd *hpd, 299d38ceaf9SAlex Deucher struct amdgpu_router *router); 3004562236bSHarry Wentland /* it is used to enter or exit into free sync mode */ 3014562236bSHarry Wentland int (*notify_freesync)(struct drm_device *dev, void *data, 3024562236bSHarry Wentland struct drm_file *filp); 3034562236bSHarry Wentland /* it is used to allow enablement of freesync mode */ 3044562236bSHarry Wentland int (*set_freesync_property)(struct drm_connector *connector, 3054562236bSHarry Wentland struct drm_property *property, 3064562236bSHarry Wentland uint64_t val); 3074562236bSHarry Wentland 3084562236bSHarry Wentland 3094562236bSHarry Wentland }; 3104562236bSHarry Wentland 3114562236bSHarry Wentland struct amdgpu_framebuffer { 3124562236bSHarry Wentland struct drm_framebuffer base; 3134562236bSHarry Wentland struct drm_gem_object *obj; 314dd55d12cSAndrey Grodzovsky 315dd55d12cSAndrey Grodzovsky /* caching for later use */ 316dd55d12cSAndrey Grodzovsky uint64_t address; 3174562236bSHarry Wentland }; 3184562236bSHarry Wentland 3194562236bSHarry Wentland struct amdgpu_fbdev { 3204562236bSHarry Wentland struct drm_fb_helper helper; 3214562236bSHarry Wentland struct amdgpu_framebuffer rfb; 3224562236bSHarry Wentland struct list_head fbdev_list; 3234562236bSHarry Wentland struct amdgpu_device *adev; 324d38ceaf9SAlex Deucher }; 325d38ceaf9SAlex Deucher 326d38ceaf9SAlex Deucher struct amdgpu_mode_info { 327d38ceaf9SAlex Deucher struct atom_context *atom_context; 328d38ceaf9SAlex Deucher struct card_info *atom_card_info; 329d38ceaf9SAlex Deucher bool mode_config_initialized; 330f195038cSAlex Deucher struct amdgpu_crtc *crtcs[AMDGPU_MAX_CRTCS]; 331d4e13b0dSAlex Deucher struct amdgpu_plane *planes[AMDGPU_MAX_PLANES]; 332f195038cSAlex Deucher struct amdgpu_afmt *afmt[AMDGPU_MAX_AFMT_BLOCKS]; 333d38ceaf9SAlex Deucher /* DVI-I properties */ 334d38ceaf9SAlex Deucher struct drm_property *coherent_mode_property; 335d38ceaf9SAlex Deucher /* DAC enable load detect */ 336d38ceaf9SAlex Deucher struct drm_property *load_detect_property; 337d38ceaf9SAlex Deucher /* underscan */ 338d38ceaf9SAlex Deucher struct drm_property *underscan_property; 339d38ceaf9SAlex Deucher struct drm_property *underscan_hborder_property; 340d38ceaf9SAlex Deucher struct drm_property *underscan_vborder_property; 341d38ceaf9SAlex Deucher /* audio */ 342d38ceaf9SAlex Deucher struct drm_property *audio_property; 343d38ceaf9SAlex Deucher /* FMT dithering */ 344d38ceaf9SAlex Deucher struct drm_property *dither_property; 345d38ceaf9SAlex Deucher /* hardcoded DFP edid from BIOS */ 346d38ceaf9SAlex Deucher struct edid *bios_hardcoded_edid; 347d38ceaf9SAlex Deucher int bios_hardcoded_edid_size; 348d38ceaf9SAlex Deucher 349d38ceaf9SAlex Deucher /* pointer to fbdev info structure */ 350d38ceaf9SAlex Deucher struct amdgpu_fbdev *rfbdev; 351d38ceaf9SAlex Deucher /* firmware flags */ 352d38ceaf9SAlex Deucher u16 firmware_flags; 353d38ceaf9SAlex Deucher /* pointer to backlight encoder */ 354d38ceaf9SAlex Deucher struct amdgpu_encoder *bl_encoder; 355d38ceaf9SAlex Deucher struct amdgpu_audio audio; /* audio stuff */ 356d38ceaf9SAlex Deucher int num_crtc; /* number of crtcs */ 357d38ceaf9SAlex Deucher int num_hpd; /* number of hpd pins */ 358d38ceaf9SAlex Deucher int num_dig; /* number of dig blocks */ 359d38ceaf9SAlex Deucher int disp_priority; 360d38ceaf9SAlex Deucher const struct amdgpu_display_funcs *funcs; 361e04a6123SDave Airlie const enum drm_plane_type *plane_type; 362d38ceaf9SAlex Deucher }; 363d38ceaf9SAlex Deucher 364d38ceaf9SAlex Deucher #define AMDGPU_MAX_BL_LEVEL 0xFF 365d38ceaf9SAlex Deucher 366d38ceaf9SAlex Deucher #if defined(CONFIG_BACKLIGHT_CLASS_DEVICE) || defined(CONFIG_BACKLIGHT_CLASS_DEVICE_MODULE) 367d38ceaf9SAlex Deucher 368d38ceaf9SAlex Deucher struct amdgpu_backlight_privdata { 369d38ceaf9SAlex Deucher struct amdgpu_encoder *encoder; 370d38ceaf9SAlex Deucher uint8_t negative; 371d38ceaf9SAlex Deucher }; 372d38ceaf9SAlex Deucher 373d38ceaf9SAlex Deucher #endif 374d38ceaf9SAlex Deucher 375d38ceaf9SAlex Deucher struct amdgpu_atom_ss { 376d38ceaf9SAlex Deucher uint16_t percentage; 377d38ceaf9SAlex Deucher uint16_t percentage_divider; 378d38ceaf9SAlex Deucher uint8_t type; 379d38ceaf9SAlex Deucher uint16_t step; 380d38ceaf9SAlex Deucher uint8_t delay; 381d38ceaf9SAlex Deucher uint8_t range; 382d38ceaf9SAlex Deucher uint8_t refdiv; 383d38ceaf9SAlex Deucher /* asic_ss */ 384d38ceaf9SAlex Deucher uint16_t rate; 385d38ceaf9SAlex Deucher uint16_t amount; 386d38ceaf9SAlex Deucher }; 387d38ceaf9SAlex Deucher 388d38ceaf9SAlex Deucher struct amdgpu_crtc { 389d38ceaf9SAlex Deucher struct drm_crtc base; 390d38ceaf9SAlex Deucher int crtc_id; 391d38ceaf9SAlex Deucher bool enabled; 392d38ceaf9SAlex Deucher bool can_tile; 393d38ceaf9SAlex Deucher uint32_t crtc_offset; 394d38ceaf9SAlex Deucher struct drm_gem_object *cursor_bo; 395d38ceaf9SAlex Deucher uint64_t cursor_addr; 39629275a9bSAlex Deucher int cursor_x; 39729275a9bSAlex Deucher int cursor_y; 39829275a9bSAlex Deucher int cursor_hot_x; 39929275a9bSAlex Deucher int cursor_hot_y; 400d38ceaf9SAlex Deucher int cursor_width; 401d38ceaf9SAlex Deucher int cursor_height; 402d38ceaf9SAlex Deucher int max_cursor_width; 403d38ceaf9SAlex Deucher int max_cursor_height; 404d38ceaf9SAlex Deucher enum amdgpu_rmx_type rmx_type; 405d38ceaf9SAlex Deucher u8 h_border; 406d38ceaf9SAlex Deucher u8 v_border; 407d38ceaf9SAlex Deucher fixed20_12 vsc; 408d38ceaf9SAlex Deucher fixed20_12 hsc; 409d38ceaf9SAlex Deucher struct drm_display_mode native_mode; 410d38ceaf9SAlex Deucher u32 pll_id; 411d38ceaf9SAlex Deucher /* page flipping */ 412d38ceaf9SAlex Deucher struct amdgpu_flip_work *pflip_works; 413d38ceaf9SAlex Deucher enum amdgpu_flip_status pflip_status; 414d38ceaf9SAlex Deucher int deferred_flip_completion; 415d38ceaf9SAlex Deucher /* pll sharing */ 416d38ceaf9SAlex Deucher struct amdgpu_atom_ss ss; 417d38ceaf9SAlex Deucher bool ss_enabled; 418d38ceaf9SAlex Deucher u32 adjusted_clock; 419d38ceaf9SAlex Deucher int bpc; 420d38ceaf9SAlex Deucher u32 pll_reference_div; 421d38ceaf9SAlex Deucher u32 pll_post_div; 422d38ceaf9SAlex Deucher u32 pll_flags; 423d38ceaf9SAlex Deucher struct drm_encoder *encoder; 424d38ceaf9SAlex Deucher struct drm_connector *connector; 425d38ceaf9SAlex Deucher /* for dpm */ 426d38ceaf9SAlex Deucher u32 line_time; 427d38ceaf9SAlex Deucher u32 wm_low; 428d38ceaf9SAlex Deucher u32 wm_high; 4298e36f9d3SAlex Deucher u32 lb_vblank_lead_lines; 430d38ceaf9SAlex Deucher struct drm_display_mode hw_mode; 4310f66356dSEmily Deng /* for virtual dce */ 4320f66356dSEmily Deng struct hrtimer vblank_timer; 4330f66356dSEmily Deng enum amdgpu_interrupt_state vsync_timer_enabled; 4344562236bSHarry Wentland 4354562236bSHarry Wentland int otg_inst; 436dd55d12cSAndrey Grodzovsky struct drm_pending_vblank_event *event; 437d38ceaf9SAlex Deucher }; 438d38ceaf9SAlex Deucher 439d4e13b0dSAlex Deucher struct amdgpu_plane { 440d4e13b0dSAlex Deucher struct drm_plane base; 441d4e13b0dSAlex Deucher enum drm_plane_type plane_type; 442d4e13b0dSAlex Deucher }; 443d4e13b0dSAlex Deucher 444d38ceaf9SAlex Deucher struct amdgpu_encoder_atom_dig { 445d38ceaf9SAlex Deucher bool linkb; 446d38ceaf9SAlex Deucher /* atom dig */ 447d38ceaf9SAlex Deucher bool coherent_mode; 448d38ceaf9SAlex Deucher int dig_encoder; /* -1 disabled, 0 DIGA, 1 DIGB, etc. */ 449d38ceaf9SAlex Deucher /* atom lvds/edp */ 450d38ceaf9SAlex Deucher uint32_t lcd_misc; 451d38ceaf9SAlex Deucher uint16_t panel_pwr_delay; 452d38ceaf9SAlex Deucher uint32_t lcd_ss_id; 453d38ceaf9SAlex Deucher /* panel mode */ 454d38ceaf9SAlex Deucher struct drm_display_mode native_mode; 455d38ceaf9SAlex Deucher struct backlight_device *bl_dev; 456d38ceaf9SAlex Deucher int dpms_mode; 457d38ceaf9SAlex Deucher uint8_t backlight_level; 458d38ceaf9SAlex Deucher int panel_mode; 459d38ceaf9SAlex Deucher struct amdgpu_afmt *afmt; 460d38ceaf9SAlex Deucher }; 461d38ceaf9SAlex Deucher 462d38ceaf9SAlex Deucher struct amdgpu_encoder { 463d38ceaf9SAlex Deucher struct drm_encoder base; 464d38ceaf9SAlex Deucher uint32_t encoder_enum; 465d38ceaf9SAlex Deucher uint32_t encoder_id; 466d38ceaf9SAlex Deucher uint32_t devices; 467d38ceaf9SAlex Deucher uint32_t active_device; 468d38ceaf9SAlex Deucher uint32_t flags; 469d38ceaf9SAlex Deucher uint32_t pixel_clock; 470d38ceaf9SAlex Deucher enum amdgpu_rmx_type rmx_type; 471d38ceaf9SAlex Deucher enum amdgpu_underscan_type underscan_type; 472d38ceaf9SAlex Deucher uint32_t underscan_hborder; 473d38ceaf9SAlex Deucher uint32_t underscan_vborder; 474d38ceaf9SAlex Deucher struct drm_display_mode native_mode; 475d38ceaf9SAlex Deucher void *enc_priv; 476d38ceaf9SAlex Deucher int audio_polling_active; 477d38ceaf9SAlex Deucher bool is_ext_encoder; 478d38ceaf9SAlex Deucher u16 caps; 479d38ceaf9SAlex Deucher }; 480d38ceaf9SAlex Deucher 481d38ceaf9SAlex Deucher struct amdgpu_connector_atom_dig { 482d38ceaf9SAlex Deucher /* displayport */ 483d38ceaf9SAlex Deucher u8 dpcd[DP_RECEIVER_CAP_SIZE]; 484d38ceaf9SAlex Deucher u8 dp_sink_type; 485d38ceaf9SAlex Deucher int dp_clock; 486d38ceaf9SAlex Deucher int dp_lane_count; 487d38ceaf9SAlex Deucher bool edp_on; 488d38ceaf9SAlex Deucher }; 489d38ceaf9SAlex Deucher 490d38ceaf9SAlex Deucher struct amdgpu_gpio_rec { 491d38ceaf9SAlex Deucher bool valid; 492d38ceaf9SAlex Deucher u8 id; 493d38ceaf9SAlex Deucher u32 reg; 494d38ceaf9SAlex Deucher u32 mask; 495d38ceaf9SAlex Deucher u32 shift; 496d38ceaf9SAlex Deucher }; 497d38ceaf9SAlex Deucher 498d38ceaf9SAlex Deucher struct amdgpu_hpd { 499d38ceaf9SAlex Deucher enum amdgpu_hpd_id hpd; 500d38ceaf9SAlex Deucher u8 plugged_state; 501d38ceaf9SAlex Deucher struct amdgpu_gpio_rec gpio; 502d38ceaf9SAlex Deucher }; 503d38ceaf9SAlex Deucher 504d38ceaf9SAlex Deucher struct amdgpu_router { 505d38ceaf9SAlex Deucher u32 router_id; 506d38ceaf9SAlex Deucher struct amdgpu_i2c_bus_rec i2c_info; 507d38ceaf9SAlex Deucher u8 i2c_addr; 508d38ceaf9SAlex Deucher /* i2c mux */ 509d38ceaf9SAlex Deucher bool ddc_valid; 510d38ceaf9SAlex Deucher u8 ddc_mux_type; 511d38ceaf9SAlex Deucher u8 ddc_mux_control_pin; 512d38ceaf9SAlex Deucher u8 ddc_mux_state; 513d38ceaf9SAlex Deucher /* clock/data mux */ 514d38ceaf9SAlex Deucher bool cd_valid; 515d38ceaf9SAlex Deucher u8 cd_mux_type; 516d38ceaf9SAlex Deucher u8 cd_mux_control_pin; 517d38ceaf9SAlex Deucher u8 cd_mux_state; 518d38ceaf9SAlex Deucher }; 519d38ceaf9SAlex Deucher 520d38ceaf9SAlex Deucher enum amdgpu_connector_audio { 521d38ceaf9SAlex Deucher AMDGPU_AUDIO_DISABLE = 0, 522d38ceaf9SAlex Deucher AMDGPU_AUDIO_ENABLE = 1, 523d38ceaf9SAlex Deucher AMDGPU_AUDIO_AUTO = 2 524d38ceaf9SAlex Deucher }; 525d38ceaf9SAlex Deucher 526d38ceaf9SAlex Deucher enum amdgpu_connector_dither { 527d38ceaf9SAlex Deucher AMDGPU_FMT_DITHER_DISABLE = 0, 528d38ceaf9SAlex Deucher AMDGPU_FMT_DITHER_ENABLE = 1, 529d38ceaf9SAlex Deucher }; 530d38ceaf9SAlex Deucher 5314562236bSHarry Wentland struct amdgpu_dm_dp_aux { 5324562236bSHarry Wentland struct drm_dp_aux aux; 53346df790cSAndrey Grodzovsky struct ddc_service *ddc_service; 5344562236bSHarry Wentland }; 5354562236bSHarry Wentland 5364562236bSHarry Wentland struct amdgpu_i2c_adapter { 5374562236bSHarry Wentland struct i2c_adapter base; 53846df790cSAndrey Grodzovsky 53946df790cSAndrey Grodzovsky struct ddc_service *ddc_service; 5404562236bSHarry Wentland }; 5414562236bSHarry Wentland 5424562236bSHarry Wentland #define TO_DM_AUX(x) container_of((x), struct amdgpu_dm_dp_aux, aux) 5434562236bSHarry Wentland 544d38ceaf9SAlex Deucher struct amdgpu_connector { 545d38ceaf9SAlex Deucher struct drm_connector base; 546d38ceaf9SAlex Deucher uint32_t connector_id; 547d38ceaf9SAlex Deucher uint32_t devices; 548d38ceaf9SAlex Deucher struct amdgpu_i2c_chan *ddc_bus; 549d38ceaf9SAlex Deucher /* some systems have an hdmi and vga port with a shared ddc line */ 550d38ceaf9SAlex Deucher bool shared_ddc; 551d38ceaf9SAlex Deucher bool use_digital; 552d38ceaf9SAlex Deucher /* we need to mind the EDID between detect 553d38ceaf9SAlex Deucher and get modes due to analog/digital/tvencoder */ 554d38ceaf9SAlex Deucher struct edid *edid; 5554562236bSHarry Wentland /* number of modes generated from EDID at 'dc_sink' */ 5564562236bSHarry Wentland int num_modes; 5574562236bSHarry Wentland /* The 'old' sink - before an HPD. 5584562236bSHarry Wentland * The 'current' sink is in dc_link->sink. */ 559b73a22d3SHarry Wentland struct dc_sink *dc_sink; 560d0778ebfSHarry Wentland struct dc_link *dc_link; 561b73a22d3SHarry Wentland struct dc_sink *dc_em_sink; 562ab2541b6SAric Cyr const struct dc_stream *stream; 563d38ceaf9SAlex Deucher void *con_priv; 564d38ceaf9SAlex Deucher bool dac_load_detect; 565d38ceaf9SAlex Deucher bool detected_by_load; /* if the connection status was determined by load */ 566d38ceaf9SAlex Deucher uint16_t connector_object_id; 567d38ceaf9SAlex Deucher struct amdgpu_hpd hpd; 568d38ceaf9SAlex Deucher struct amdgpu_router router; 569d38ceaf9SAlex Deucher struct amdgpu_i2c_chan *router_bus; 570d38ceaf9SAlex Deucher enum amdgpu_connector_audio audio; 571d38ceaf9SAlex Deucher enum amdgpu_connector_dither dither; 572d38ceaf9SAlex Deucher unsigned pixelclock_for_modeset; 5734562236bSHarry Wentland 5744562236bSHarry Wentland struct drm_dp_mst_topology_mgr mst_mgr; 5754562236bSHarry Wentland struct amdgpu_dm_dp_aux dm_dp_aux; 5764562236bSHarry Wentland struct drm_dp_mst_port *port; 5774562236bSHarry Wentland struct amdgpu_connector *mst_port; 5784562236bSHarry Wentland struct amdgpu_encoder *mst_encoder; 5794562236bSHarry Wentland struct semaphore mst_sem; 5804562236bSHarry Wentland 5814562236bSHarry Wentland /* TODO see if we can merge with ddc_bus or make a dm_connector */ 5824562236bSHarry Wentland struct amdgpu_i2c_adapter *i2c; 5834562236bSHarry Wentland 5844562236bSHarry Wentland /* Monitor range limits */ 5854562236bSHarry Wentland int min_vfreq ; 5864562236bSHarry Wentland int max_vfreq ; 5874562236bSHarry Wentland int pixel_clock_mhz; 5884562236bSHarry Wentland 5894562236bSHarry Wentland /*freesync caps*/ 5904562236bSHarry Wentland struct mod_freesync_caps caps; 5914562236bSHarry Wentland 5924562236bSHarry Wentland struct mutex hpd_lock; 5934562236bSHarry Wentland 594d38ceaf9SAlex Deucher }; 595d38ceaf9SAlex Deucher 5964562236bSHarry Wentland /* TODO: start to use this struct and remove same field from base one */ 5974562236bSHarry Wentland struct amdgpu_mst_connector { 5984562236bSHarry Wentland struct amdgpu_connector base; 5994562236bSHarry Wentland 6004562236bSHarry Wentland struct drm_dp_mst_topology_mgr mst_mgr; 6014562236bSHarry Wentland struct amdgpu_dm_dp_aux dm_dp_aux; 6024562236bSHarry Wentland struct drm_dp_mst_port *port; 6034562236bSHarry Wentland struct amdgpu_connector *mst_port; 6044562236bSHarry Wentland bool is_mst_connector; 6054562236bSHarry Wentland struct amdgpu_encoder *mst_encoder; 606d38ceaf9SAlex Deucher }; 607d38ceaf9SAlex Deucher 608d38ceaf9SAlex Deucher #define ENCODER_MODE_IS_DP(em) (((em) == ATOM_ENCODER_MODE_DP) || \ 609d38ceaf9SAlex Deucher ((em) == ATOM_ENCODER_MODE_DP_MST)) 610d38ceaf9SAlex Deucher 6118e36f9d3SAlex Deucher /* Driver internal use only flags of amdgpu_get_crtc_scanoutpos() */ 6121bf6ad62SDaniel Vetter #define DRM_SCANOUTPOS_VALID (1 << 0) 6131bf6ad62SDaniel Vetter #define DRM_SCANOUTPOS_IN_VBLANK (1 << 1) 6141bf6ad62SDaniel Vetter #define DRM_SCANOUTPOS_ACCURATE (1 << 2) 6158e36f9d3SAlex Deucher #define USE_REAL_VBLANKSTART (1 << 30) 6168e36f9d3SAlex Deucher #define GET_DISTANCE_TO_VBLANKSTART (1 << 31) 6178e36f9d3SAlex Deucher 618d38ceaf9SAlex Deucher void amdgpu_link_encoder_connector(struct drm_device *dev); 619d38ceaf9SAlex Deucher 620d38ceaf9SAlex Deucher struct drm_connector * 621d38ceaf9SAlex Deucher amdgpu_get_connector_for_encoder(struct drm_encoder *encoder); 622d38ceaf9SAlex Deucher struct drm_connector * 623d38ceaf9SAlex Deucher amdgpu_get_connector_for_encoder_init(struct drm_encoder *encoder); 624d38ceaf9SAlex Deucher bool amdgpu_dig_monitor_is_duallink(struct drm_encoder *encoder, 625d38ceaf9SAlex Deucher u32 pixel_clock); 626d38ceaf9SAlex Deucher 627d38ceaf9SAlex Deucher u16 amdgpu_encoder_get_dp_bridge_encoder_id(struct drm_encoder *encoder); 628d38ceaf9SAlex Deucher struct drm_encoder *amdgpu_get_external_encoder(struct drm_encoder *encoder); 629d38ceaf9SAlex Deucher 630d38ceaf9SAlex Deucher bool amdgpu_ddc_probe(struct amdgpu_connector *amdgpu_connector, bool use_aux); 631d38ceaf9SAlex Deucher 632d38ceaf9SAlex Deucher void amdgpu_encoder_set_active_device(struct drm_encoder *encoder); 633d38ceaf9SAlex Deucher 63488e72717SThierry Reding int amdgpu_get_crtc_scanoutpos(struct drm_device *dev, unsigned int pipe, 63588e72717SThierry Reding unsigned int flags, int *vpos, int *hpos, 63688e72717SThierry Reding ktime_t *stime, ktime_t *etime, 6373bb403bfSVille Syrjälä const struct drm_display_mode *mode); 638d38ceaf9SAlex Deucher 639d38ceaf9SAlex Deucher int amdgpu_framebuffer_init(struct drm_device *dev, 640d38ceaf9SAlex Deucher struct amdgpu_framebuffer *rfb, 6411eb83451SVille Syrjälä const struct drm_mode_fb_cmd2 *mode_cmd, 642d38ceaf9SAlex Deucher struct drm_gem_object *obj); 643d38ceaf9SAlex Deucher 644d38ceaf9SAlex Deucher int amdgpufb_remove(struct drm_device *dev, struct drm_framebuffer *fb); 645d38ceaf9SAlex Deucher 646d38ceaf9SAlex Deucher void amdgpu_enc_destroy(struct drm_encoder *encoder); 647d38ceaf9SAlex Deucher void amdgpu_copy_fb(struct drm_device *dev, struct drm_gem_object *dst_obj); 648d38ceaf9SAlex Deucher bool amdgpu_crtc_scaling_mode_fixup(struct drm_crtc *crtc, 649d38ceaf9SAlex Deucher const struct drm_display_mode *mode, 650d38ceaf9SAlex Deucher struct drm_display_mode *adjusted_mode); 651d38ceaf9SAlex Deucher void amdgpu_panel_mode_fixup(struct drm_encoder *encoder, 652d38ceaf9SAlex Deucher struct drm_display_mode *adjusted_mode); 653d38ceaf9SAlex Deucher int amdgpu_crtc_idx_to_irq_type(struct amdgpu_device *adev, int crtc); 654d38ceaf9SAlex Deucher 655d38ceaf9SAlex Deucher /* fbdev layer */ 656d38ceaf9SAlex Deucher int amdgpu_fbdev_init(struct amdgpu_device *adev); 657d38ceaf9SAlex Deucher void amdgpu_fbdev_fini(struct amdgpu_device *adev); 658d38ceaf9SAlex Deucher void amdgpu_fbdev_set_suspend(struct amdgpu_device *adev, int state); 659d38ceaf9SAlex Deucher int amdgpu_fbdev_total_size(struct amdgpu_device *adev); 660d38ceaf9SAlex Deucher bool amdgpu_fbdev_robj_is_fb(struct amdgpu_device *adev, struct amdgpu_bo *robj); 661d38ceaf9SAlex Deucher 662d38ceaf9SAlex Deucher int amdgpu_align_pitch(struct amdgpu_device *adev, int width, int bpp, bool tiled); 663d38ceaf9SAlex Deucher 664d38ceaf9SAlex Deucher /* amdgpu_display.c */ 665d38ceaf9SAlex Deucher void amdgpu_print_display_setup(struct drm_device *dev); 666d38ceaf9SAlex Deucher int amdgpu_modeset_create_props(struct amdgpu_device *adev); 667a4eff9aaSDaniel Vetter int amdgpu_crtc_set_config(struct drm_mode_set *set, 668a4eff9aaSDaniel Vetter struct drm_modeset_acquire_ctx *ctx); 6690cd11932SSamuel Li int amdgpu_display_crtc_page_flip_target(struct drm_crtc *crtc, 670d38ceaf9SAlex Deucher struct drm_framebuffer *fb, 671d38ceaf9SAlex Deucher struct drm_pending_vblank_event *event, 67241292b1fSDaniel Vetter uint32_t page_flip_flags, uint32_t target, 67341292b1fSDaniel Vetter struct drm_modeset_acquire_ctx *ctx); 674d38ceaf9SAlex Deucher extern const struct drm_mode_config_funcs amdgpu_mode_funcs; 675d38ceaf9SAlex Deucher 676d38ceaf9SAlex Deucher #endif 677