1 // SPDX-License-Identifier: GPL-2.0-or-later 2 /* 3 * Synopsys DesignWare I2C adapter driver. 4 * 5 * Based on the TI DAVINCI I2C adapter driver. 6 * 7 * Copyright (C) 2006 Texas Instruments. 8 * Copyright (C) 2007 MontaVista Software Inc. 9 * Copyright (C) 2009 Provigent Ltd. 10 */ 11 #include <linux/acpi.h> 12 #include <linux/clk-provider.h> 13 #include <linux/clk.h> 14 #include <linux/delay.h> 15 #include <linux/dmi.h> 16 #include <linux/err.h> 17 #include <linux/errno.h> 18 #include <linux/i2c.h> 19 #include <linux/interrupt.h> 20 #include <linux/io.h> 21 #include <linux/kernel.h> 22 #include <linux/module.h> 23 #include <linux/of.h> 24 #include <linux/platform_data/i2c-designware.h> 25 #include <linux/platform_device.h> 26 #include <linux/pm.h> 27 #include <linux/pm_runtime.h> 28 #include <linux/property.h> 29 #include <linux/reset.h> 30 #include <linux/sched.h> 31 #include <linux/slab.h> 32 #include <linux/suspend.h> 33 34 #include "i2c-designware-core.h" 35 36 static u32 i2c_dw_get_clk_rate_khz(struct dw_i2c_dev *dev) 37 { 38 return clk_get_rate(dev->clk)/1000; 39 } 40 41 #ifdef CONFIG_ACPI 42 /* 43 * The HCNT/LCNT information coming from ACPI should be the most accurate 44 * for given platform. However, some systems get it wrong. On such systems 45 * we get better results by calculating those based on the input clock. 46 */ 47 static const struct dmi_system_id dw_i2c_no_acpi_params[] = { 48 { 49 .ident = "Dell Inspiron 7348", 50 .matches = { 51 DMI_MATCH(DMI_SYS_VENDOR, "Dell Inc."), 52 DMI_MATCH(DMI_PRODUCT_NAME, "Inspiron 7348"), 53 }, 54 }, 55 { } 56 }; 57 58 static void dw_i2c_acpi_params(struct platform_device *pdev, char method[], 59 u16 *hcnt, u16 *lcnt, u32 *sda_hold) 60 { 61 struct acpi_buffer buf = { ACPI_ALLOCATE_BUFFER }; 62 acpi_handle handle = ACPI_HANDLE(&pdev->dev); 63 union acpi_object *obj; 64 65 if (dmi_check_system(dw_i2c_no_acpi_params)) 66 return; 67 68 if (ACPI_FAILURE(acpi_evaluate_object(handle, method, NULL, &buf))) 69 return; 70 71 obj = (union acpi_object *)buf.pointer; 72 if (obj->type == ACPI_TYPE_PACKAGE && obj->package.count == 3) { 73 const union acpi_object *objs = obj->package.elements; 74 75 *hcnt = (u16)objs[0].integer.value; 76 *lcnt = (u16)objs[1].integer.value; 77 *sda_hold = (u32)objs[2].integer.value; 78 } 79 80 kfree(buf.pointer); 81 } 82 83 static int dw_i2c_acpi_configure(struct platform_device *pdev) 84 { 85 struct dw_i2c_dev *dev = platform_get_drvdata(pdev); 86 struct i2c_timings *t = &dev->timings; 87 u32 ss_ht = 0, fp_ht = 0, hs_ht = 0, fs_ht = 0; 88 89 dev->tx_fifo_depth = 32; 90 dev->rx_fifo_depth = 32; 91 92 /* 93 * Try to get SDA hold time and *CNT values from an ACPI method for 94 * selected speed modes. 95 */ 96 dw_i2c_acpi_params(pdev, "SSCN", &dev->ss_hcnt, &dev->ss_lcnt, &ss_ht); 97 dw_i2c_acpi_params(pdev, "FPCN", &dev->fp_hcnt, &dev->fp_lcnt, &fp_ht); 98 dw_i2c_acpi_params(pdev, "HSCN", &dev->hs_hcnt, &dev->hs_lcnt, &hs_ht); 99 dw_i2c_acpi_params(pdev, "FMCN", &dev->fs_hcnt, &dev->fs_lcnt, &fs_ht); 100 101 switch (t->bus_freq_hz) { 102 case 100000: 103 dev->sda_hold_time = ss_ht; 104 break; 105 case 1000000: 106 dev->sda_hold_time = fp_ht; 107 break; 108 case 3400000: 109 dev->sda_hold_time = hs_ht; 110 break; 111 case 400000: 112 default: 113 dev->sda_hold_time = fs_ht; 114 break; 115 } 116 117 return 0; 118 } 119 120 static const struct acpi_device_id dw_i2c_acpi_match[] = { 121 { "INT33C2", 0 }, 122 { "INT33C3", 0 }, 123 { "INT3432", 0 }, 124 { "INT3433", 0 }, 125 { "80860F41", ACCESS_NO_IRQ_SUSPEND }, 126 { "808622C1", ACCESS_NO_IRQ_SUSPEND | MODEL_CHERRYTRAIL }, 127 { "AMD0010", ACCESS_INTR_MASK }, 128 { "AMDI0010", ACCESS_INTR_MASK }, 129 { "AMDI0510", 0 }, 130 { "APMC0D0F", 0 }, 131 { "HISI02A1", 0 }, 132 { "HISI02A2", 0 }, 133 { } 134 }; 135 MODULE_DEVICE_TABLE(acpi, dw_i2c_acpi_match); 136 #else 137 static inline int dw_i2c_acpi_configure(struct platform_device *pdev) 138 { 139 return -ENODEV; 140 } 141 #endif 142 143 #ifdef CONFIG_OF 144 #define MSCC_ICPU_CFG_TWI_DELAY 0x0 145 #define MSCC_ICPU_CFG_TWI_DELAY_ENABLE BIT(0) 146 #define MSCC_ICPU_CFG_TWI_SPIKE_FILTER 0x4 147 148 static int mscc_twi_set_sda_hold_time(struct dw_i2c_dev *dev) 149 { 150 writel((dev->sda_hold_time << 1) | MSCC_ICPU_CFG_TWI_DELAY_ENABLE, 151 dev->ext + MSCC_ICPU_CFG_TWI_DELAY); 152 153 return 0; 154 } 155 156 static int dw_i2c_of_configure(struct platform_device *pdev) 157 { 158 struct dw_i2c_dev *dev = platform_get_drvdata(pdev); 159 struct resource *mem; 160 161 switch (dev->flags & MODEL_MASK) { 162 case MODEL_MSCC_OCELOT: 163 mem = platform_get_resource(pdev, IORESOURCE_MEM, 1); 164 dev->ext = devm_ioremap_resource(&pdev->dev, mem); 165 if (!IS_ERR(dev->ext)) 166 dev->set_sda_hold_time = mscc_twi_set_sda_hold_time; 167 break; 168 default: 169 break; 170 } 171 172 return 0; 173 } 174 175 static const struct of_device_id dw_i2c_of_match[] = { 176 { .compatible = "snps,designware-i2c", }, 177 { .compatible = "mscc,ocelot-i2c", .data = (void *)MODEL_MSCC_OCELOT }, 178 {}, 179 }; 180 MODULE_DEVICE_TABLE(of, dw_i2c_of_match); 181 #else 182 static inline int dw_i2c_of_configure(struct platform_device *pdev) 183 { 184 return -ENODEV; 185 } 186 #endif 187 188 static void i2c_dw_configure_master(struct dw_i2c_dev *dev) 189 { 190 struct i2c_timings *t = &dev->timings; 191 192 dev->functionality = I2C_FUNC_10BIT_ADDR | DW_IC_DEFAULT_FUNCTIONALITY; 193 194 dev->master_cfg = DW_IC_CON_MASTER | DW_IC_CON_SLAVE_DISABLE | 195 DW_IC_CON_RESTART_EN; 196 197 dev->mode = DW_IC_MASTER; 198 199 switch (t->bus_freq_hz) { 200 case 100000: 201 dev->master_cfg |= DW_IC_CON_SPEED_STD; 202 break; 203 case 3400000: 204 dev->master_cfg |= DW_IC_CON_SPEED_HIGH; 205 break; 206 default: 207 dev->master_cfg |= DW_IC_CON_SPEED_FAST; 208 } 209 } 210 211 static void i2c_dw_configure_slave(struct dw_i2c_dev *dev) 212 { 213 dev->functionality = I2C_FUNC_SLAVE | DW_IC_DEFAULT_FUNCTIONALITY; 214 215 dev->slave_cfg = DW_IC_CON_RX_FIFO_FULL_HLD_CTRL | 216 DW_IC_CON_RESTART_EN | DW_IC_CON_STOP_DET_IFADDRESSED; 217 218 dev->mode = DW_IC_SLAVE; 219 } 220 221 static void dw_i2c_set_fifo_size(struct dw_i2c_dev *dev) 222 { 223 u32 param, tx_fifo_depth, rx_fifo_depth; 224 225 /* 226 * Try to detect the FIFO depth if not set by interface driver, 227 * the depth could be from 2 to 256 from HW spec. 228 */ 229 param = i2c_dw_read_comp_param(dev); 230 tx_fifo_depth = ((param >> 16) & 0xff) + 1; 231 rx_fifo_depth = ((param >> 8) & 0xff) + 1; 232 if (!dev->tx_fifo_depth) { 233 dev->tx_fifo_depth = tx_fifo_depth; 234 dev->rx_fifo_depth = rx_fifo_depth; 235 } else if (tx_fifo_depth >= 2) { 236 dev->tx_fifo_depth = min_t(u32, dev->tx_fifo_depth, 237 tx_fifo_depth); 238 dev->rx_fifo_depth = min_t(u32, dev->rx_fifo_depth, 239 rx_fifo_depth); 240 } 241 } 242 243 static void dw_i2c_plat_pm_cleanup(struct dw_i2c_dev *dev) 244 { 245 pm_runtime_disable(dev->dev); 246 247 if (dev->shared_with_punit) 248 pm_runtime_put_noidle(dev->dev); 249 } 250 251 static int dw_i2c_plat_probe(struct platform_device *pdev) 252 { 253 struct dw_i2c_platform_data *pdata = dev_get_platdata(&pdev->dev); 254 struct i2c_adapter *adap; 255 struct dw_i2c_dev *dev; 256 struct i2c_timings *t; 257 u32 acpi_speed; 258 struct resource *mem; 259 int i, irq, ret; 260 static const int supported_speeds[] = { 261 0, 100000, 400000, 1000000, 3400000 262 }; 263 264 irq = platform_get_irq(pdev, 0); 265 if (irq < 0) 266 return irq; 267 268 dev = devm_kzalloc(&pdev->dev, sizeof(struct dw_i2c_dev), GFP_KERNEL); 269 if (!dev) 270 return -ENOMEM; 271 272 mem = platform_get_resource(pdev, IORESOURCE_MEM, 0); 273 dev->base = devm_ioremap_resource(&pdev->dev, mem); 274 if (IS_ERR(dev->base)) 275 return PTR_ERR(dev->base); 276 277 dev->dev = &pdev->dev; 278 dev->irq = irq; 279 platform_set_drvdata(pdev, dev); 280 281 dev->rst = devm_reset_control_get_optional_exclusive(&pdev->dev, NULL); 282 if (IS_ERR(dev->rst)) { 283 if (PTR_ERR(dev->rst) == -EPROBE_DEFER) 284 return -EPROBE_DEFER; 285 } else { 286 reset_control_deassert(dev->rst); 287 } 288 289 t = &dev->timings; 290 if (pdata) 291 t->bus_freq_hz = pdata->i2c_scl_freq; 292 else 293 i2c_parse_fw_timings(&pdev->dev, t, false); 294 295 acpi_speed = i2c_acpi_find_bus_speed(&pdev->dev); 296 /* 297 * Some DSTDs use a non standard speed, round down to the lowest 298 * standard speed. 299 */ 300 for (i = 1; i < ARRAY_SIZE(supported_speeds); i++) { 301 if (acpi_speed < supported_speeds[i]) 302 break; 303 } 304 acpi_speed = supported_speeds[i - 1]; 305 306 /* 307 * Find bus speed from the "clock-frequency" device property, ACPI 308 * or by using fast mode if neither is set. 309 */ 310 if (acpi_speed && t->bus_freq_hz) 311 t->bus_freq_hz = min(t->bus_freq_hz, acpi_speed); 312 else if (acpi_speed || t->bus_freq_hz) 313 t->bus_freq_hz = max(t->bus_freq_hz, acpi_speed); 314 else 315 t->bus_freq_hz = 400000; 316 317 dev->flags |= (uintptr_t)device_get_match_data(&pdev->dev); 318 319 if (pdev->dev.of_node) 320 dw_i2c_of_configure(pdev); 321 322 if (has_acpi_companion(&pdev->dev)) 323 dw_i2c_acpi_configure(pdev); 324 325 /* 326 * Only standard mode at 100kHz, fast mode at 400kHz, 327 * fast mode plus at 1MHz and high speed mode at 3.4MHz are supported. 328 */ 329 if (t->bus_freq_hz != 100000 && t->bus_freq_hz != 400000 && 330 t->bus_freq_hz != 1000000 && t->bus_freq_hz != 3400000) { 331 dev_err(&pdev->dev, 332 "%d Hz is unsupported, only 100kHz, 400kHz, 1MHz and 3.4MHz are supported\n", 333 t->bus_freq_hz); 334 ret = -EINVAL; 335 goto exit_reset; 336 } 337 338 ret = i2c_dw_probe_lock_support(dev); 339 if (ret) 340 goto exit_reset; 341 342 if (i2c_detect_slave_mode(&pdev->dev)) 343 i2c_dw_configure_slave(dev); 344 else 345 i2c_dw_configure_master(dev); 346 347 dev->clk = devm_clk_get(&pdev->dev, NULL); 348 if (!i2c_dw_prepare_clk(dev, true)) { 349 u64 clk_khz; 350 351 dev->get_clk_rate_khz = i2c_dw_get_clk_rate_khz; 352 clk_khz = dev->get_clk_rate_khz(dev); 353 354 if (!dev->sda_hold_time && t->sda_hold_ns) 355 dev->sda_hold_time = 356 div_u64(clk_khz * t->sda_hold_ns + 500000, 1000000); 357 } 358 359 dw_i2c_set_fifo_size(dev); 360 361 adap = &dev->adapter; 362 adap->owner = THIS_MODULE; 363 adap->class = I2C_CLASS_DEPRECATED; 364 ACPI_COMPANION_SET(&adap->dev, ACPI_COMPANION(&pdev->dev)); 365 adap->dev.of_node = pdev->dev.of_node; 366 adap->nr = -1; 367 368 dev_pm_set_driver_flags(&pdev->dev, 369 DPM_FLAG_SMART_PREPARE | 370 DPM_FLAG_SMART_SUSPEND | 371 DPM_FLAG_LEAVE_SUSPENDED); 372 373 /* The code below assumes runtime PM to be disabled. */ 374 WARN_ON(pm_runtime_enabled(&pdev->dev)); 375 376 pm_runtime_set_autosuspend_delay(&pdev->dev, 1000); 377 pm_runtime_use_autosuspend(&pdev->dev); 378 pm_runtime_set_active(&pdev->dev); 379 380 if (dev->shared_with_punit) 381 pm_runtime_get_noresume(&pdev->dev); 382 383 pm_runtime_enable(&pdev->dev); 384 385 if (dev->mode == DW_IC_SLAVE) 386 ret = i2c_dw_probe_slave(dev); 387 else 388 ret = i2c_dw_probe(dev); 389 390 if (ret) 391 goto exit_probe; 392 393 return ret; 394 395 exit_probe: 396 dw_i2c_plat_pm_cleanup(dev); 397 exit_reset: 398 if (!IS_ERR_OR_NULL(dev->rst)) 399 reset_control_assert(dev->rst); 400 return ret; 401 } 402 403 static int dw_i2c_plat_remove(struct platform_device *pdev) 404 { 405 struct dw_i2c_dev *dev = platform_get_drvdata(pdev); 406 407 pm_runtime_get_sync(&pdev->dev); 408 409 i2c_del_adapter(&dev->adapter); 410 411 dev->disable(dev); 412 413 pm_runtime_dont_use_autosuspend(&pdev->dev); 414 pm_runtime_put_sync(&pdev->dev); 415 dw_i2c_plat_pm_cleanup(dev); 416 417 if (!IS_ERR_OR_NULL(dev->rst)) 418 reset_control_assert(dev->rst); 419 420 return 0; 421 } 422 423 #ifdef CONFIG_PM_SLEEP 424 static int dw_i2c_plat_prepare(struct device *dev) 425 { 426 /* 427 * If the ACPI companion device object is present for this device, it 428 * may be accessed during suspend and resume of other devices via I2C 429 * operation regions, so tell the PM core and middle layers to avoid 430 * skipping system suspend/resume callbacks for it in that case. 431 */ 432 return !has_acpi_companion(dev); 433 } 434 435 static void dw_i2c_plat_complete(struct device *dev) 436 { 437 /* 438 * The device can only be in runtime suspend at this point if it has not 439 * been resumed throughout the ending system suspend/resume cycle, so if 440 * the platform firmware might mess up with it, request the runtime PM 441 * framework to resume it. 442 */ 443 if (pm_runtime_suspended(dev) && pm_resume_via_firmware()) 444 pm_request_resume(dev); 445 } 446 #else 447 #define dw_i2c_plat_prepare NULL 448 #define dw_i2c_plat_complete NULL 449 #endif 450 451 #ifdef CONFIG_PM 452 static int dw_i2c_plat_suspend(struct device *dev) 453 { 454 struct dw_i2c_dev *i_dev = dev_get_drvdata(dev); 455 456 i_dev->suspended = true; 457 458 if (i_dev->shared_with_punit) 459 return 0; 460 461 i_dev->disable(i_dev); 462 i2c_dw_prepare_clk(i_dev, false); 463 464 return 0; 465 } 466 467 static int dw_i2c_plat_resume(struct device *dev) 468 { 469 struct dw_i2c_dev *i_dev = dev_get_drvdata(dev); 470 471 if (!i_dev->shared_with_punit) 472 i2c_dw_prepare_clk(i_dev, true); 473 474 i_dev->init(i_dev); 475 i_dev->suspended = false; 476 477 return 0; 478 } 479 480 static const struct dev_pm_ops dw_i2c_dev_pm_ops = { 481 .prepare = dw_i2c_plat_prepare, 482 .complete = dw_i2c_plat_complete, 483 SET_LATE_SYSTEM_SLEEP_PM_OPS(dw_i2c_plat_suspend, dw_i2c_plat_resume) 484 SET_RUNTIME_PM_OPS(dw_i2c_plat_suspend, dw_i2c_plat_resume, NULL) 485 }; 486 487 #define DW_I2C_DEV_PMOPS (&dw_i2c_dev_pm_ops) 488 #else 489 #define DW_I2C_DEV_PMOPS NULL 490 #endif 491 492 /* Work with hotplug and coldplug */ 493 MODULE_ALIAS("platform:i2c_designware"); 494 495 static struct platform_driver dw_i2c_driver = { 496 .probe = dw_i2c_plat_probe, 497 .remove = dw_i2c_plat_remove, 498 .driver = { 499 .name = "i2c_designware", 500 .of_match_table = of_match_ptr(dw_i2c_of_match), 501 .acpi_match_table = ACPI_PTR(dw_i2c_acpi_match), 502 .pm = DW_I2C_DEV_PMOPS, 503 }, 504 }; 505 506 static int __init dw_i2c_init_driver(void) 507 { 508 return platform_driver_register(&dw_i2c_driver); 509 } 510 subsys_initcall(dw_i2c_init_driver); 511 512 static void __exit dw_i2c_exit_driver(void) 513 { 514 platform_driver_unregister(&dw_i2c_driver); 515 } 516 module_exit(dw_i2c_exit_driver); 517 518 MODULE_AUTHOR("Baruch Siach <baruch@tkos.co.il>"); 519 MODULE_DESCRIPTION("Synopsys DesignWare I2C bus adapter"); 520 MODULE_LICENSE("GPL"); 521