1 // SPDX-License-Identifier: GPL-2.0+ 2 /* 3 * Copyright 2017,2018 NXP 4 * Copyright 2019 Purism SPC 5 */ 6 7 #include <linux/clk.h> 8 #include <linux/clk-provider.h> 9 #include <linux/delay.h> 10 #include <linux/io.h> 11 #include <linux/kernel.h> 12 #include <linux/module.h> 13 #include <linux/of.h> 14 #include <linux/of_platform.h> 15 #include <linux/phy/phy.h> 16 #include <linux/platform_device.h> 17 #include <linux/regmap.h> 18 19 /* DPHY registers */ 20 #define DPHY_PD_DPHY 0x00 21 #define DPHY_M_PRG_HS_PREPARE 0x04 22 #define DPHY_MC_PRG_HS_PREPARE 0x08 23 #define DPHY_M_PRG_HS_ZERO 0x0c 24 #define DPHY_MC_PRG_HS_ZERO 0x10 25 #define DPHY_M_PRG_HS_TRAIL 0x14 26 #define DPHY_MC_PRG_HS_TRAIL 0x18 27 #define DPHY_PD_PLL 0x1c 28 #define DPHY_TST 0x20 29 #define DPHY_CN 0x24 30 #define DPHY_CM 0x28 31 #define DPHY_CO 0x2c 32 #define DPHY_LOCK 0x30 33 #define DPHY_LOCK_BYP 0x34 34 #define DPHY_REG_BYPASS_PLL 0x4C 35 36 #define MBPS(x) ((x) * 1000000) 37 38 #define DATA_RATE_MAX_SPEED MBPS(1500) 39 #define DATA_RATE_MIN_SPEED MBPS(80) 40 41 #define PLL_LOCK_SLEEP 10 42 #define PLL_LOCK_TIMEOUT 1000 43 44 #define CN_BUF 0xcb7a89c0 45 #define CO_BUF 0x63 46 #define CM(x) ( \ 47 ((x) < 32) ? 0xe0 | ((x) - 16) : \ 48 ((x) < 64) ? 0xc0 | ((x) - 32) : \ 49 ((x) < 128) ? 0x80 | ((x) - 64) : \ 50 ((x) - 128)) 51 #define CN(x) (((x) == 1) ? 0x1f : (((CN_BUF) >> ((x) - 1)) & 0x1f)) 52 #define CO(x) ((CO_BUF) >> (8 - (x)) & 0x03) 53 54 /* PHY power on is active low */ 55 #define PWR_ON 0 56 #define PWR_OFF 1 57 58 enum mixel_dphy_devtype { 59 MIXEL_IMX8MQ, 60 }; 61 62 struct mixel_dphy_devdata { 63 u8 reg_tx_rcal; 64 u8 reg_auto_pd_en; 65 u8 reg_rxlprp; 66 u8 reg_rxcdrp; 67 u8 reg_rxhs_settle; 68 }; 69 70 static const struct mixel_dphy_devdata mixel_dphy_devdata[] = { 71 [MIXEL_IMX8MQ] = { 72 .reg_tx_rcal = 0x38, 73 .reg_auto_pd_en = 0x3c, 74 .reg_rxlprp = 0x40, 75 .reg_rxcdrp = 0x44, 76 .reg_rxhs_settle = 0x48, 77 }, 78 }; 79 80 struct mixel_dphy_cfg { 81 /* DPHY PLL parameters */ 82 u32 cm; 83 u32 cn; 84 u32 co; 85 /* DPHY register values */ 86 u8 mc_prg_hs_prepare; 87 u8 m_prg_hs_prepare; 88 u8 mc_prg_hs_zero; 89 u8 m_prg_hs_zero; 90 u8 mc_prg_hs_trail; 91 u8 m_prg_hs_trail; 92 u8 rxhs_settle; 93 }; 94 95 struct mixel_dphy_priv { 96 struct mixel_dphy_cfg cfg; 97 struct regmap *regmap; 98 struct clk *phy_ref_clk; 99 const struct mixel_dphy_devdata *devdata; 100 }; 101 102 static const struct regmap_config mixel_dphy_regmap_config = { 103 .reg_bits = 8, 104 .val_bits = 32, 105 .reg_stride = 4, 106 .max_register = DPHY_REG_BYPASS_PLL, 107 .name = "mipi-dphy", 108 }; 109 110 static int phy_write(struct phy *phy, u32 value, unsigned int reg) 111 { 112 struct mixel_dphy_priv *priv = phy_get_drvdata(phy); 113 int ret; 114 115 ret = regmap_write(priv->regmap, reg, value); 116 if (ret < 0) 117 dev_err(&phy->dev, "Failed to write DPHY reg %d: %d\n", reg, 118 ret); 119 return ret; 120 } 121 122 /* 123 * Find a ratio close to the desired one using continued fraction 124 * approximation ending either at exact match or maximum allowed 125 * nominator, denominator. 126 */ 127 static void get_best_ratio(u32 *pnum, u32 *pdenom, u32 max_n, u32 max_d) 128 { 129 u32 a = *pnum; 130 u32 b = *pdenom; 131 u32 c; 132 u32 n[] = {0, 1}; 133 u32 d[] = {1, 0}; 134 u32 whole; 135 unsigned int i = 1; 136 137 while (b) { 138 i ^= 1; 139 whole = a / b; 140 n[i] += (n[i ^ 1] * whole); 141 d[i] += (d[i ^ 1] * whole); 142 if ((n[i] > max_n) || (d[i] > max_d)) { 143 i ^= 1; 144 break; 145 } 146 c = a - (b * whole); 147 a = b; 148 b = c; 149 } 150 *pnum = n[i]; 151 *pdenom = d[i]; 152 } 153 154 static int mixel_dphy_config_from_opts(struct phy *phy, 155 struct phy_configure_opts_mipi_dphy *dphy_opts, 156 struct mixel_dphy_cfg *cfg) 157 { 158 struct mixel_dphy_priv *priv = dev_get_drvdata(phy->dev.parent); 159 unsigned long ref_clk = clk_get_rate(priv->phy_ref_clk); 160 u32 lp_t, numerator, denominator; 161 unsigned long long tmp; 162 u32 n; 163 int i; 164 165 if (dphy_opts->hs_clk_rate > DATA_RATE_MAX_SPEED || 166 dphy_opts->hs_clk_rate < DATA_RATE_MIN_SPEED) 167 return -EINVAL; 168 169 numerator = dphy_opts->hs_clk_rate; 170 denominator = ref_clk; 171 get_best_ratio(&numerator, &denominator, 255, 256); 172 if (!numerator || !denominator) { 173 dev_err(&phy->dev, "Invalid %d/%d for %ld/%ld\n", 174 numerator, denominator, 175 dphy_opts->hs_clk_rate, ref_clk); 176 return -EINVAL; 177 } 178 179 while ((numerator < 16) && (denominator <= 128)) { 180 numerator <<= 1; 181 denominator <<= 1; 182 } 183 /* 184 * CM ranges between 16 and 255 185 * CN ranges between 1 and 32 186 * CO is power of 2: 1, 2, 4, 8 187 */ 188 i = __ffs(denominator); 189 if (i > 3) 190 i = 3; 191 cfg->cn = denominator >> i; 192 cfg->co = 1 << i; 193 cfg->cm = numerator; 194 195 if (cfg->cm < 16 || cfg->cm > 255 || 196 cfg->cn < 1 || cfg->cn > 32 || 197 cfg->co < 1 || cfg->co > 8) { 198 dev_err(&phy->dev, "Invalid CM/CN/CO values: %u/%u/%u\n", 199 cfg->cm, cfg->cn, cfg->co); 200 dev_err(&phy->dev, "for hs_clk/ref_clk=%ld/%ld ~ %d/%d\n", 201 dphy_opts->hs_clk_rate, ref_clk, 202 numerator, denominator); 203 return -EINVAL; 204 } 205 206 dev_dbg(&phy->dev, "hs_clk/ref_clk=%ld/%ld ~ %d/%d\n", 207 dphy_opts->hs_clk_rate, ref_clk, numerator, denominator); 208 209 /* LP clock period */ 210 tmp = 1000000000000LL; 211 do_div(tmp, dphy_opts->lp_clk_rate); /* ps */ 212 if (tmp > ULONG_MAX) 213 return -EINVAL; 214 215 lp_t = tmp; 216 dev_dbg(&phy->dev, "LP clock %lu, period: %u ps\n", 217 dphy_opts->lp_clk_rate, lp_t); 218 219 /* hs_prepare: in lp clock periods */ 220 if (2 * dphy_opts->hs_prepare > 5 * lp_t) { 221 dev_err(&phy->dev, 222 "hs_prepare (%u) > 2.5 * lp clock period (%u)\n", 223 dphy_opts->hs_prepare, lp_t); 224 return -EINVAL; 225 } 226 /* 00: lp_t, 01: 1.5 * lp_t, 10: 2 * lp_t, 11: 2.5 * lp_t */ 227 if (dphy_opts->hs_prepare < lp_t) { 228 n = 0; 229 } else { 230 tmp = 2 * (dphy_opts->hs_prepare - lp_t); 231 do_div(tmp, lp_t); 232 n = tmp; 233 } 234 cfg->m_prg_hs_prepare = n; 235 236 /* clk_prepare: in lp clock periods */ 237 if (2 * dphy_opts->clk_prepare > 3 * lp_t) { 238 dev_err(&phy->dev, 239 "clk_prepare (%u) > 1.5 * lp clock period (%u)\n", 240 dphy_opts->clk_prepare, lp_t); 241 return -EINVAL; 242 } 243 /* 00: lp_t, 01: 1.5 * lp_t */ 244 cfg->mc_prg_hs_prepare = dphy_opts->clk_prepare > lp_t ? 1 : 0; 245 246 /* hs_zero: formula from NXP BSP */ 247 n = (144 * (dphy_opts->hs_clk_rate / 1000000) - 47500) / 10000; 248 cfg->m_prg_hs_zero = n < 1 ? 1 : n; 249 250 /* clk_zero: formula from NXP BSP */ 251 n = (34 * (dphy_opts->hs_clk_rate / 1000000) - 2500) / 1000; 252 cfg->mc_prg_hs_zero = n < 1 ? 1 : n; 253 254 /* clk_trail, hs_trail: formula from NXP BSP */ 255 n = (103 * (dphy_opts->hs_clk_rate / 1000000) + 10000) / 10000; 256 if (n > 15) 257 n = 15; 258 if (n < 1) 259 n = 1; 260 cfg->m_prg_hs_trail = n; 261 cfg->mc_prg_hs_trail = n; 262 263 /* rxhs_settle: formula from NXP BSP */ 264 if (dphy_opts->hs_clk_rate < MBPS(80)) 265 cfg->rxhs_settle = 0x0d; 266 else if (dphy_opts->hs_clk_rate < MBPS(90)) 267 cfg->rxhs_settle = 0x0c; 268 else if (dphy_opts->hs_clk_rate < MBPS(125)) 269 cfg->rxhs_settle = 0x0b; 270 else if (dphy_opts->hs_clk_rate < MBPS(150)) 271 cfg->rxhs_settle = 0x0a; 272 else if (dphy_opts->hs_clk_rate < MBPS(225)) 273 cfg->rxhs_settle = 0x09; 274 else if (dphy_opts->hs_clk_rate < MBPS(500)) 275 cfg->rxhs_settle = 0x08; 276 else 277 cfg->rxhs_settle = 0x07; 278 279 dev_dbg(&phy->dev, "phy_config: %u %u %u %u %u %u %u\n", 280 cfg->m_prg_hs_prepare, cfg->mc_prg_hs_prepare, 281 cfg->m_prg_hs_zero, cfg->mc_prg_hs_zero, 282 cfg->m_prg_hs_trail, cfg->mc_prg_hs_trail, 283 cfg->rxhs_settle); 284 285 return 0; 286 } 287 288 static void mixel_phy_set_hs_timings(struct phy *phy) 289 { 290 struct mixel_dphy_priv *priv = phy_get_drvdata(phy); 291 292 phy_write(phy, priv->cfg.m_prg_hs_prepare, DPHY_M_PRG_HS_PREPARE); 293 phy_write(phy, priv->cfg.mc_prg_hs_prepare, DPHY_MC_PRG_HS_PREPARE); 294 phy_write(phy, priv->cfg.m_prg_hs_zero, DPHY_M_PRG_HS_ZERO); 295 phy_write(phy, priv->cfg.mc_prg_hs_zero, DPHY_MC_PRG_HS_ZERO); 296 phy_write(phy, priv->cfg.m_prg_hs_trail, DPHY_M_PRG_HS_TRAIL); 297 phy_write(phy, priv->cfg.mc_prg_hs_trail, DPHY_MC_PRG_HS_TRAIL); 298 phy_write(phy, priv->cfg.rxhs_settle, priv->devdata->reg_rxhs_settle); 299 } 300 301 static int mixel_dphy_set_pll_params(struct phy *phy) 302 { 303 struct mixel_dphy_priv *priv = dev_get_drvdata(phy->dev.parent); 304 305 if (priv->cfg.cm < 16 || priv->cfg.cm > 255 || 306 priv->cfg.cn < 1 || priv->cfg.cn > 32 || 307 priv->cfg.co < 1 || priv->cfg.co > 8) { 308 dev_err(&phy->dev, "Invalid CM/CN/CO values! (%u/%u/%u)\n", 309 priv->cfg.cm, priv->cfg.cn, priv->cfg.co); 310 return -EINVAL; 311 } 312 dev_dbg(&phy->dev, "Using CM:%u CN:%u CO:%u\n", 313 priv->cfg.cm, priv->cfg.cn, priv->cfg.co); 314 phy_write(phy, CM(priv->cfg.cm), DPHY_CM); 315 phy_write(phy, CN(priv->cfg.cn), DPHY_CN); 316 phy_write(phy, CO(priv->cfg.co), DPHY_CO); 317 return 0; 318 } 319 320 static int mixel_dphy_configure(struct phy *phy, union phy_configure_opts *opts) 321 { 322 struct mixel_dphy_priv *priv = phy_get_drvdata(phy); 323 struct mixel_dphy_cfg cfg = { 0 }; 324 int ret; 325 326 ret = mixel_dphy_config_from_opts(phy, &opts->mipi_dphy, &cfg); 327 if (ret) 328 return ret; 329 330 /* Update the configuration */ 331 memcpy(&priv->cfg, &cfg, sizeof(struct mixel_dphy_cfg)); 332 333 phy_write(phy, 0x00, DPHY_LOCK_BYP); 334 phy_write(phy, 0x01, priv->devdata->reg_tx_rcal); 335 phy_write(phy, 0x00, priv->devdata->reg_auto_pd_en); 336 phy_write(phy, 0x02, priv->devdata->reg_rxlprp); 337 phy_write(phy, 0x02, priv->devdata->reg_rxcdrp); 338 phy_write(phy, 0x25, DPHY_TST); 339 340 mixel_phy_set_hs_timings(phy); 341 ret = mixel_dphy_set_pll_params(phy); 342 if (ret < 0) 343 return ret; 344 345 return 0; 346 } 347 348 static int mixel_dphy_validate(struct phy *phy, enum phy_mode mode, int submode, 349 union phy_configure_opts *opts) 350 { 351 struct mixel_dphy_cfg cfg = { 0 }; 352 353 if (mode != PHY_MODE_MIPI_DPHY) 354 return -EINVAL; 355 356 return mixel_dphy_config_from_opts(phy, &opts->mipi_dphy, &cfg); 357 } 358 359 static int mixel_dphy_init(struct phy *phy) 360 { 361 phy_write(phy, PWR_OFF, DPHY_PD_PLL); 362 phy_write(phy, PWR_OFF, DPHY_PD_DPHY); 363 364 return 0; 365 } 366 367 static int mixel_dphy_exit(struct phy *phy) 368 { 369 phy_write(phy, 0, DPHY_CM); 370 phy_write(phy, 0, DPHY_CN); 371 phy_write(phy, 0, DPHY_CO); 372 373 return 0; 374 } 375 376 static int mixel_dphy_power_on(struct phy *phy) 377 { 378 struct mixel_dphy_priv *priv = phy_get_drvdata(phy); 379 u32 locked; 380 int ret; 381 382 ret = clk_prepare_enable(priv->phy_ref_clk); 383 if (ret < 0) 384 return ret; 385 386 phy_write(phy, PWR_ON, DPHY_PD_PLL); 387 ret = regmap_read_poll_timeout(priv->regmap, DPHY_LOCK, locked, 388 locked, PLL_LOCK_SLEEP, 389 PLL_LOCK_TIMEOUT); 390 if (ret < 0) { 391 dev_err(&phy->dev, "Could not get DPHY lock (%d)!\n", ret); 392 goto clock_disable; 393 } 394 phy_write(phy, PWR_ON, DPHY_PD_DPHY); 395 396 return 0; 397 clock_disable: 398 clk_disable_unprepare(priv->phy_ref_clk); 399 return ret; 400 } 401 402 static int mixel_dphy_power_off(struct phy *phy) 403 { 404 struct mixel_dphy_priv *priv = phy_get_drvdata(phy); 405 406 phy_write(phy, PWR_OFF, DPHY_PD_PLL); 407 phy_write(phy, PWR_OFF, DPHY_PD_DPHY); 408 409 clk_disable_unprepare(priv->phy_ref_clk); 410 411 return 0; 412 } 413 414 static const struct phy_ops mixel_dphy_phy_ops = { 415 .init = mixel_dphy_init, 416 .exit = mixel_dphy_exit, 417 .power_on = mixel_dphy_power_on, 418 .power_off = mixel_dphy_power_off, 419 .configure = mixel_dphy_configure, 420 .validate = mixel_dphy_validate, 421 .owner = THIS_MODULE, 422 }; 423 424 static const struct of_device_id mixel_dphy_of_match[] = { 425 { .compatible = "fsl,imx8mq-mipi-dphy", 426 .data = &mixel_dphy_devdata[MIXEL_IMX8MQ] }, 427 { /* sentinel */ }, 428 }; 429 MODULE_DEVICE_TABLE(of, mixel_dphy_of_match); 430 431 static int mixel_dphy_probe(struct platform_device *pdev) 432 { 433 struct device *dev = &pdev->dev; 434 struct device_node *np = dev->of_node; 435 struct phy_provider *phy_provider; 436 struct mixel_dphy_priv *priv; 437 struct phy *phy; 438 void __iomem *base; 439 440 if (!np) 441 return -ENODEV; 442 443 priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL); 444 if (!priv) 445 return -ENOMEM; 446 447 priv->devdata = of_device_get_match_data(&pdev->dev); 448 if (!priv->devdata) 449 return -EINVAL; 450 451 base = devm_platform_ioremap_resource(pdev, 0); 452 if (IS_ERR(base)) 453 return PTR_ERR(base); 454 455 priv->regmap = devm_regmap_init_mmio(&pdev->dev, base, 456 &mixel_dphy_regmap_config); 457 if (IS_ERR(priv->regmap)) { 458 dev_err(dev, "Couldn't create the DPHY regmap\n"); 459 return PTR_ERR(priv->regmap); 460 } 461 462 priv->phy_ref_clk = devm_clk_get(&pdev->dev, "phy_ref"); 463 if (IS_ERR(priv->phy_ref_clk)) { 464 dev_err(dev, "No phy_ref clock found\n"); 465 return PTR_ERR(priv->phy_ref_clk); 466 } 467 dev_dbg(dev, "phy_ref clock rate: %lu\n", 468 clk_get_rate(priv->phy_ref_clk)); 469 470 dev_set_drvdata(dev, priv); 471 472 phy = devm_phy_create(dev, np, &mixel_dphy_phy_ops); 473 if (IS_ERR(phy)) { 474 dev_err(dev, "Failed to create phy %ld\n", PTR_ERR(phy)); 475 return PTR_ERR(phy); 476 } 477 phy_set_drvdata(phy, priv); 478 479 phy_provider = devm_of_phy_provider_register(dev, of_phy_simple_xlate); 480 481 return PTR_ERR_OR_ZERO(phy_provider); 482 } 483 484 static struct platform_driver mixel_dphy_driver = { 485 .probe = mixel_dphy_probe, 486 .driver = { 487 .name = "mixel-mipi-dphy", 488 .of_match_table = mixel_dphy_of_match, 489 } 490 }; 491 module_platform_driver(mixel_dphy_driver); 492 493 MODULE_AUTHOR("NXP Semiconductor"); 494 MODULE_DESCRIPTION("Mixel MIPI-DSI PHY driver"); 495 MODULE_LICENSE("GPL"); 496