kernel/drivers/clk/clk-si570.c

   1 /*
   2  * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
   3  *
   4  * Copyright (C) 2010, 2011 Ericsson AB.
   5  * Copyright (C) 2011 Guenter Roeck.
   6  * Copyright (C) 2011 - 2013 Xilinx Inc.
   7  *
   8  * Author: Guenter Roeck <guenter.roeck@ericsson.com>
   9  *         Sören Brinkmann <soren.brinkmann@xilinx.com>
  10  *
  11  * This program is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License as published by
  13  * the Free Software Foundation; either version 2 of the License, or
  14  * (at your option) any later version.
  15  *
  16  * This program is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19  * GNU General Public License for more details.
  20  */
  21
  22 #include <linux/clk-provider.h>
  23 #include <linux/delay.h>
  24 #include <linux/module.h>
  25 #include <linux/i2c.h>
  26 #include <linux/regmap.h>
  27 #include <linux/slab.h>
  28
  29 /* Si570 registers */
  30 #define SI570_REG_HS_N1         7
  31 #define SI570_REG_N1_RFREQ0     8
  32 #define SI570_REG_RFREQ1        9
  33 #define SI570_REG_RFREQ2        10
  34 #define SI570_REG_RFREQ3        11
  35 #define SI570_REG_RFREQ4        12
  36 #define SI570_REG_CONTROL       135
  37 #define SI570_REG_FREEZE_DCO    137
  38 #define SI570_DIV_OFFSET_7PPM   6
  39
  40 #define HS_DIV_SHIFT            5
  41 #define HS_DIV_MASK             0xe0
  42 #define HS_DIV_OFFSET           4
  43 #define N1_6_2_MASK             0x1f
  44 #define N1_1_0_MASK             0xc0
  45 #define RFREQ_37_32_MASK        0x3f
  46
  47 #define SI570_MIN_FREQ          10000000L
  48 #define SI570_MAX_FREQ          1417500000L
  49 #define SI598_MAX_FREQ          525000000L
  50
  51 #define FDCO_MIN                4850000000LL
  52 #define FDCO_MAX                5670000000LL
  53
  54 #define SI570_CNTRL_RECALL      (1 << 0)
  55 #define SI570_CNTRL_FREEZE_M    (1 << 5)
  56 #define SI570_CNTRL_NEWFREQ     (1 << 6)
  57
  58 #define SI570_FREEZE_DCO        (1 << 4)
  59
  60 /**
  61  * struct clk_si570:
  62  * @hw: Clock hw struct
  63  * @regmap:     Device's regmap
  64  * @div_offset: Rgister offset for dividers
  65  * @max_freq:   Maximum frequency for this device
  66  * @fxtal:      Factory xtal frequency
  67  * @n1:         Clock divider N1
  68  * @hs_div:     Clock divider HSDIV
  69  * @rfreq:      Clock multiplier RFREQ
  70  * @frequency:  Current output frequency
  71  * @i2c_client: I2C client pointer
  72  */
  73 struct clk_si570 {
  74         struct clk_hw hw;
  75         struct regmap *regmap;
  76         unsigned int div_offset;
  77         u64 max_freq;
  78         u64 fxtal;
  79         unsigned int n1;
  80         unsigned int hs_div;
  81         u64 rfreq;
  82         u64 frequency;
  83         struct i2c_client *i2c_client;
  84 };
  85 #define to_clk_si570(_hw)       container_of(_hw, struct clk_si570, hw)
  86
  87 enum clk_si570_variant {
  88         si57x,
  89         si59x
  90 };
  91
  92 /**
  93  * si570_get_divs() - Read clock dividers from HW
  94  * @data:       Pointer to struct clk_si570
  95  * @rfreq:      Fractional multiplier (output)
  96  * @n1:         Divider N1 (output)
  97  * @hs_div:     Divider HSDIV (output)
  98  * Returns 0 on success, negative errno otherwise.
  99  *
 100  * Retrieve clock dividers and multipliers from the HW.
 101  */
 102 static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
 103                 unsigned int *n1, unsigned int *hs_div)
 104 {
 105         int err;
 106         u8 reg[6];
 107         u64 tmp;
 108
 109         err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
 110                         reg, ARRAY_SIZE(reg));
 111         if (err)
 112                 return err;
 113
 114         *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
 115         *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
 116         /* Handle invalid cases */
 117         if (*n1 > 1)
 118                 *n1 &= ~1;
 119
 120         tmp = reg[1] & RFREQ_37_32_MASK;
 121         tmp = (tmp << 8) + reg[2];
 122         tmp = (tmp << 8) + reg[3];
 123         tmp = (tmp << 8) + reg[4];
 124         tmp = (tmp << 8) + reg[5];
 125         *rfreq = tmp;
 126
 127         return 0;
 128 }
 129
 130 /**
 131  * si570_get_defaults() - Get default values
 132  * @data:       Driver data structure
 133  * @fout:       Factory frequency output
 134  * Returns 0 on success, negative errno otherwise.
 135  */
 136 static int si570_get_defaults(struct clk_si570 *data, u64 fout)
 137 {
 138         int err;
 139         u64 fdco;
 140
 141         regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
 142
 143         err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
 144         if (err)
 145                 return err;
 146
 147         /*
 148          * Accept optional precision loss to avoid arithmetic overflows.
 149          * Acceptable per Silicon Labs Application Note AN334.
 150          */
 151         fdco = fout * data->n1 * data->hs_div;
 152         if (fdco >= (1LL << 36))
 153                 data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
 154         else
 155                 data->fxtal = div64_u64(fdco << 28, data->rfreq);
 156
 157         data->frequency = fout;
 158
 159         return 0;
 160 }
 161
 162 /**
 163  * si570_update_rfreq() - Update clock multiplier
 164  * @data:       Driver data structure
 165  * Passes on regmap_bulk_write() return value.
 166  */
 167 static int si570_update_rfreq(struct clk_si570 *data)
 168 {
 169         u8 reg[5];
 170
 171         reg[0] = ((data->n1 - 1) << 6) |
 172                 ((data->rfreq >> 32) & RFREQ_37_32_MASK);
 173         reg[1] = (data->rfreq >> 24) & 0xff;
 174         reg[2] = (data->rfreq >> 16) & 0xff;
 175         reg[3] = (data->rfreq >> 8) & 0xff;
 176         reg[4] = data->rfreq & 0xff;
 177
 178         return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
 179                         data->div_offset, reg, ARRAY_SIZE(reg));
 180 }
 181
 182 /**
 183  * si570_calc_divs() - Caluclate clock dividers
 184  * @frequency:  Target frequency
 185  * @data:       Driver data structure
 186  * @out_rfreq:  RFREG fractional multiplier (output)
 187  * @out_n1:     Clock divider N1 (output)
 188  * @out_hs_div: Clock divider HSDIV (output)
 189  * Returns 0 on success, negative errno otherwise.
 190  *
 191  * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
 192  * (@out_rfreq) for a given target @frequency.
 193  */
 194 static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
 195                 u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
 196 {
 197         int i;
 198         unsigned int n1, hs_div;
 199         u64 fdco, best_fdco = ULLONG_MAX;
 200         static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
 201
 202         for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
 203                 hs_div = si570_hs_div_values[i];
 204                 /* Calculate lowest possible value for n1 */
 205                 n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
 206                 if (!n1 || (n1 & 1))
 207                         n1++;
 208                 while (n1 <= 128) {
 209                         fdco = (u64)frequency * (u64)hs_div * (u64)n1;
 210                         if (fdco > FDCO_MAX)
 211                                 break;
 212                         if (fdco >= FDCO_MIN && fdco < best_fdco) {
 213                                 *out_n1 = n1;
 214                                 *out_hs_div = hs_div;
 215                                 *out_rfreq = div64_u64(fdco << 28, data->fxtal);
 216                                 best_fdco = fdco;
 217                         }
 218                         n1 += (n1 == 1 ? 1 : 2);
 219                 }
 220         }
 221
 222         if (best_fdco == ULLONG_MAX)
 223                 return -EINVAL;
 224
 225         return 0;
 226 }
 227
 228 static unsigned long si570_recalc_rate(struct clk_hw *hw,
 229                 unsigned long parent_rate)
 230 {
 231         int err;
 232         u64 rfreq, rate;
 233         unsigned int n1, hs_div;
 234         struct clk_si570 *data = to_clk_si570(hw);
 235
 236         err = si570_get_divs(data, &rfreq, &n1, &hs_div);
 237         if (err) {
 238                 dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
 239                 return data->frequency;
 240         }
 241
 242         rfreq = div_u64(rfreq, hs_div * n1);
 243         rate = (data->fxtal * rfreq) >> 28;
 244
 245         return rate;
 246 }
 247
 248 static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
 249                 unsigned long *parent_rate)
 250 {
 251         int err;
 252         u64 rfreq;
 253         unsigned int n1, hs_div;
 254         struct clk_si570 *data = to_clk_si570(hw);
 255
 256         if (!rate)
 257                 return 0;
 258
 259         if (div64_u64(abs(rate - data->frequency) * 10000LL,
 260                                 data->frequency) < 35) {
 261                 rfreq = div64_u64((data->rfreq * rate) +
 262                                 div64_u64(data->frequency, 2), data->frequency);
 263                 n1 = data->n1;
 264                 hs_div = data->hs_div;
 265
 266         } else {
 267                 err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
 268                 if (err) {
 269                         dev_err(&data->i2c_client->dev,
 270                                         "unable to round rate\n");
 271                         return 0;
 272                 }
 273         }
 274
 275         return rate;
 276 }
 277
 278 /**
 279  * si570_set_frequency() - Adjust output frequency
 280  * @data:       Driver data structure
 281  * @frequency:  Target frequency
 282  * Returns 0 on success.
 283  *
 284  * Update output frequency for big frequency changes (> 3,500 ppm).
 285  */
 286 static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
 287 {
 288         int err;
 289
 290         err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
 291                         &data->hs_div);
 292         if (err)
 293                 return err;
 294
 295         /*
 296          * The DCO reg should be accessed with a read-modify-write operation
 297          * per AN334
 298          */
 299         regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
 300         regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
 301                         ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
 302                         (((data->n1 - 1) >> 2) & N1_6_2_MASK));
 303         si570_update_rfreq(data);
 304         regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
 305         regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
 306
 307         /* Applying a new frequency can take up to 10ms */
 308         usleep_range(10000, 12000);
 309
 310         return 0;
 311 }
 312
 313 /**
 314  * si570_set_frequency_small() - Adjust output frequency
 315  * @data:       Driver data structure
 316  * @frequency:  Target frequency
 317  * Returns 0 on success.
 318  *
 319  * Update output frequency for small frequency changes (< 3,500 ppm).
 320  */
 321 static int si570_set_frequency_small(struct clk_si570 *data,
 322                                      unsigned long frequency)
 323 {
 324         /*
 325          * This is a re-implementation of DIV_ROUND_CLOSEST
 326          * using the div64_u64 function lieu of letting the compiler
 327          * insert EABI calls
 328          */
 329         data->rfreq = div64_u64((data->rfreq * frequency) +
 330                         div_u64(data->frequency, 2), data->frequency);
 331         regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
 332         si570_update_rfreq(data);
 333         regmap_write(data->regmap, SI570_REG_CONTROL, 0);
 334
 335         /* Applying a new frequency (small change) can take up to 100us */
 336         usleep_range(100, 200);
 337
 338         return 0;
 339 }
 340
 341 static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
 342                 unsigned long parent_rate)
 343 {
 344         struct clk_si570 *data = to_clk_si570(hw);
 345         struct i2c_client *client = data->i2c_client;
 346         int err;
 347
 348         if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
 349                 dev_err(&client->dev,
 350                         "requested frequency %lu Hz is out of range\n", rate);
 351                 return -EINVAL;
 352         }
 353
 354         if (div64_u64(abs(rate - data->frequency) * 10000LL,
 355                                 data->frequency) < 35)
 356                 err = si570_set_frequency_small(data, rate);
 357         else
 358                 err = si570_set_frequency(data, rate);
 359
 360         if (err)
 361                 return err;
 362
 363         data->frequency = rate;
 364
 365         return 0;
 366 }
 367
 368 static const struct clk_ops si570_clk_ops = {
 369         .recalc_rate = si570_recalc_rate,
 370         .round_rate = si570_round_rate,
 371         .set_rate = si570_set_rate,
 372 };
 373
 374 static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
 375 {
 376         switch (reg) {
 377         case SI570_REG_CONTROL:
 378                 return true;
 379         default:
 380                 return false;
 381         }
 382 }
 383
 384 static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
 385 {
 386         switch (reg) {
 387         case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
 388         case SI570_REG_CONTROL:
 389         case SI570_REG_FREEZE_DCO:
 390                 return true;
 391         default:
 392                 return false;
 393         }
 394 }
 395
 396 static const struct regmap_config si570_regmap_config = {
 397         .reg_bits = 8,
 398         .val_bits = 8,
 399         .cache_type = REGCACHE_RBTREE,
 400         .max_register = 137,
 401         .writeable_reg = si570_regmap_is_writeable,
 402         .volatile_reg = si570_regmap_is_volatile,
 403 };
 404
 405 static int si570_probe(struct i2c_client *client,
 406                 const struct i2c_device_id *id)
 407 {
 408         struct clk_si570 *data;
 409         struct clk_init_data init;
 410         struct clk *clk;
 411         u32 initial_fout, factory_fout, stability;
 412         int err;
 413         enum clk_si570_variant variant = id->driver_data;
 414
 415         data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
 416         if (!data)
 417                 return -ENOMEM;
 418
 419         init.ops = &si570_clk_ops;
 420         init.flags = CLK_IS_ROOT;
 421         init.num_parents = 0;
 422         data->hw.init = &init;
 423         data->i2c_client = client;
 424
 425         if (variant == si57x) {
 426                 err = of_property_read_u32(client->dev.of_node,
 427                                 "temperature-stability", &stability);
 428                 if (err) {
 429                         dev_err(&client->dev,
 430                                   "'temperature-stability' property missing\n");
 431                         return err;
 432                 }
 433                 /* adjust register offsets for 7ppm devices */
 434                 if (stability == 7)
 435                         data->div_offset = SI570_DIV_OFFSET_7PPM;
 436
 437                 data->max_freq = SI570_MAX_FREQ;
 438         } else {
 439                 data->max_freq = SI598_MAX_FREQ;
 440         }
 441
 442         if (of_property_read_string(client->dev.of_node, "clock-output-names",
 443                         &init.name))
 444                 init.name = client->dev.of_node->name;
 445
 446         err = of_property_read_u32(client->dev.of_node, "factory-fout",
 447                         &factory_fout);
 448         if (err) {
 449                 dev_err(&client->dev, "'factory-fout' property missing\n");
 450                 return err;
 451         }
 452
 453         data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
 454         if (IS_ERR(data->regmap)) {
 455                 dev_err(&client->dev, "failed to allocate register map\n");
 456                 return PTR_ERR(data->regmap);
 457         }
 458
 459         i2c_set_clientdata(client, data);
 460         err = si570_get_defaults(data, factory_fout);
 461         if (err)
 462                 return err;
 463
 464         clk = devm_clk_register(&client->dev, &data->hw);
 465         if (IS_ERR(clk)) {
 466                 dev_err(&client->dev, "clock registration failed\n");
 467                 return PTR_ERR(clk);
 468         }
 469         err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
 470                         clk);
 471         if (err) {
 472                 dev_err(&client->dev, "unable to add clk provider\n");
 473                 return err;
 474         }
 475
 476         /* Read the requested initial output frequency from device tree */
 477         if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
 478                                 &initial_fout)) {
 479                 err = clk_set_rate(clk, initial_fout);
 480                 if (err) {
 481                         of_clk_del_provider(client->dev.of_node);
 482                         return err;
 483                 }
 484         }
 485
 486         /* Display a message indicating that we've successfully registered */
 487         dev_info(&client->dev, "registered, current frequency %llu Hz\n",
 488                         data->frequency);
 489
 490         return 0;
 491 }
 492
 493 static int si570_remove(struct i2c_client *client)
 494 {
 495         of_clk_del_provider(client->dev.of_node);
 496         return 0;
 497 }
 498
 499 static const struct i2c_device_id si570_id[] = {
 500         { "si570", si57x },
 501         { "si571", si57x },
 502         { "si598", si59x },
 503         { "si599", si59x },
 504         { }
 505 };
 506 MODULE_DEVICE_TABLE(i2c, si570_id);
 507
 508 static const struct of_device_id clk_si570_of_match[] = {
 509         { .compatible = "silabs,si570" },
 510         { .compatible = "silabs,si571" },
 511         { .compatible = "silabs,si598" },
 512         { .compatible = "silabs,si599" },
 513         { },
 514 };
 515 MODULE_DEVICE_TABLE(of, clk_si570_of_match);
 516
 517 static struct i2c_driver si570_driver = {
 518         .driver = {
 519                 .name = "si570",
 520                 .of_match_table = clk_si570_of_match,
 521         },
 522         .probe          = si570_probe,
 523         .remove         = si570_remove,
 524         .id_table       = si570_id,
 525 };
 526 module_i2c_driver(si570_driver);
 527
 528 MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
 529 MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com>");
 530 MODULE_DESCRIPTION("Si570 driver");
 531 MODULE_LICENSE("GPL");