root/drivers/phy/freescale/phy-fsl-imx8-mipi-dphy.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. phy_write
  2. get_best_ratio
  3. mixel_dphy_config_from_opts
  4. mixel_phy_set_hs_timings
  5. mixel_dphy_set_pll_params
  6. mixel_dphy_configure
  7. mixel_dphy_validate
  8. mixel_dphy_init
  9. mixel_dphy_exit
  10. mixel_dphy_power_on
  11. mixel_dphy_power_off
  12. mixel_dphy_probe

   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 resource *res;
 438         struct phy *phy;
 439         void __iomem *base;
 440 
 441         if (!np)
 442                 return -ENODEV;
 443 
 444         priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
 445         if (!priv)
 446                 return -ENOMEM;
 447 
 448         priv->devdata = of_device_get_match_data(&pdev->dev);
 449         if (!priv->devdata)
 450                 return -EINVAL;
 451 
 452         res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 453         base = devm_ioremap_resource(dev, res);
 454         if (IS_ERR(base))
 455                 return PTR_ERR(base);
 456 
 457         priv->regmap = devm_regmap_init_mmio(&pdev->dev, base,
 458                                              &mixel_dphy_regmap_config);
 459         if (IS_ERR(priv->regmap)) {
 460                 dev_err(dev, "Couldn't create the DPHY regmap\n");
 461                 return PTR_ERR(priv->regmap);
 462         }
 463 
 464         priv->phy_ref_clk = devm_clk_get(&pdev->dev, "phy_ref");
 465         if (IS_ERR(priv->phy_ref_clk)) {
 466                 dev_err(dev, "No phy_ref clock found\n");
 467                 return PTR_ERR(priv->phy_ref_clk);
 468         }
 469         dev_dbg(dev, "phy_ref clock rate: %lu\n",
 470                 clk_get_rate(priv->phy_ref_clk));
 471 
 472         dev_set_drvdata(dev, priv);
 473 
 474         phy = devm_phy_create(dev, np, &mixel_dphy_phy_ops);
 475         if (IS_ERR(phy)) {
 476                 dev_err(dev, "Failed to create phy %ld\n", PTR_ERR(phy));
 477                 return PTR_ERR(phy);
 478         }
 479         phy_set_drvdata(phy, priv);
 480 
 481         phy_provider = devm_of_phy_provider_register(dev, of_phy_simple_xlate);
 482 
 483         return PTR_ERR_OR_ZERO(phy_provider);
 484 }
 485 
 486 static struct platform_driver mixel_dphy_driver = {
 487         .probe  = mixel_dphy_probe,
 488         .driver = {
 489                 .name = "mixel-mipi-dphy",
 490                 .of_match_table = mixel_dphy_of_match,
 491         }
 492 };
 493 module_platform_driver(mixel_dphy_driver);
 494 
 495 MODULE_AUTHOR("NXP Semiconductor");
 496 MODULE_DESCRIPTION("Mixel MIPI-DSI PHY driver");
 497 MODULE_LICENSE("GPL");

/* [<][>][^][v][top][bottom][index][help] */