* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-09-21 23:40 ` Soren Brinkmann
0 siblings, 0 replies; 27+ messages in thread
From: Soren Brinkmann @ 2013-09-21 23:40 UTC (permalink / raw)
To: Rob Herring, Pawel Moll, Mark Rutland, Stephen Warren,
Ian Campbell, Rob Landley, Mike Turquette, Grant Likely,
Guenter Roeck, Sebastian Hesselbarth, Joe Perches
Cc: devicetree, linux-doc, linux-kernel, linux-arm-kernel, Hyun Kwon,
Soren Brinkmann
Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
The devices generate low-jitter clock signals and are reprogrammable via
an I2C interface.
Cc: Guenter Roeck <linux@roeck-us.net>
Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
---
v5:
- fix typo in bindings documentation
- mention the unit for the 'temperature-stability' property
- remove calls to clk_unregister() (the device managed code takes care
of it)
v4:
- actually check and handle error on clk_set_rate() call
v3:
- add delay in the path for small frequency changes, which can take up
to 100us according to the data sheet
- use real range for usleep_range() argument
- use dev_err() over dev_warn() in set_rate()
- add list of applicable devices for 7ppm DT prop
- remove comments regarding platform data
- ignore 7ppm DT prop for incompatible devices
- replace raw numbers with #defines
- convert DT prop 'temperature-stability' from boolean to u32
- make 'temperature-stability' DT prop required (actually not fully
true, for 59x it is ignored and the driver does not require its
presence)
v2:
- document clock-output-names in bindings documentation
- don't use wildcards in compatibility string
- change Kconfig entry to "... 570 and compatible devices"
- change some indentation flaws
- use 10000 as MIN and MAX value in usleep_range
- fail probe() if 'factory-fout' is not provided in DT
- default factory fout #defines removed
- use i2c driver_data instead of OF data
- remove some related structs and data
- rename DT property 'initial-fout' => 'clock-frequency' (like si5351
driver)
- add some more details regarding the 'factory-fout' DT property
---
.../devicetree/bindings/clock/silabs,si570.txt | 39 ++
drivers/clk/Kconfig | 10 +
drivers/clk/Makefile | 1 +
drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
4 files changed, 581 insertions(+)
create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
create mode 100644 drivers/clk/clk-si570.c
diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
new file mode 100644
index 0000000..c09f21e
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
@@ -0,0 +1,39 @@
+Binding for Silicon Labs 570, 571, 598 and 599 programmable
+I2C clock generators.
+
+Reference
+This binding uses the common clock binding[1]. Details about the devices can be
+found in the data sheets[2][3].
+
+[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
+[2] Si570/571 Data Sheet
+ http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
+[3] Si598/599 Data Sheet
+ http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
+
+Required properties:
+ - compatible: Shall be one of "silabs,si570", "silabs,si571",
+ "silabs,si598", "silabs,si599"
+ - reg: I2C device address.
+ - #clock-cells: From common clock bindings: Shall be 0.
+ - factory-fout: Factory set default frequency. This frequency is part specific.
+ The correct frequency for the part used has to be provided in
+ order to generate the correct output frequencies. For more
+ details, please refer to the data sheet.
+ - temperature-stability: Temperature stability of the device in PPM. Should be
+ one of: 7, 20, 50 or 100.
+
+Optional properties:
+ - clock-output-names: From common clock bindings. Recommended to be "si570".
+ - clock-frequency: Output frequency to generate. This defines the output
+ frequency set during boot. It can be reprogrammed during
+ runtime through the common clock framework.
+
+Example:
+ si570: clock-generator@5d {
+ #clock-cells = <0>;
+ compatible = "silabs,si570";
+ temperature-stability = <50>;
+ reg = <0x5d>;
+ factory-fout = <156250000>;
+ };
diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
index 279407a..349b88a 100644
--- a/drivers/clk/Kconfig
+++ b/drivers/clk/Kconfig
@@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
This driver supports Silicon Labs 5351A/B/C programmable clock
generators.
+config COMMON_CLK_SI570
+ tristate "Clock driver for SiLabs 570 and compatible devices"
+ depends on I2C
+ depends on OF
+ select REGMAP_I2C
+ help
+ ---help---
+ This driver supports Silicon Labs 570/571/598/599 programmable
+ clock generators.
+
config COMMON_CLK_S2MPS11
tristate "Clock driver for S2MPS11 MFD"
depends on MFD_SEC_CORE
diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
index 7b11106..c0e94b3 100644
--- a/drivers/clk/Makefile
+++ b/drivers/clk/Makefile
@@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
+obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
new file mode 100644
index 0000000..5d0ac9f
--- /dev/null
+++ b/drivers/clk/clk-si570.c
@@ -0,0 +1,531 @@
+/*
+ * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
+ *
+ * Copyright (C) 2010, 2011 Ericsson AB.
+ * Copyright (C) 2011 Guenter Roeck.
+ * Copyright (C) 2011 - 2013 Xilinx Inc.
+ *
+ * Author: Guenter Roeck <guenter.roeck@ericsson.com>
+ * Sören Brinkmann <soren.brinkmann@xilinx.com>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ */
+
+#include <linux/clk-provider.h>
+#include <linux/delay.h>
+#include <linux/module.h>
+#include <linux/i2c.h>
+#include <linux/regmap.h>
+#include <linux/slab.h>
+
+/* Si570 registers */
+#define SI570_REG_HS_N1 7
+#define SI570_REG_N1_RFREQ0 8
+#define SI570_REG_RFREQ1 9
+#define SI570_REG_RFREQ2 10
+#define SI570_REG_RFREQ3 11
+#define SI570_REG_RFREQ4 12
+#define SI570_REG_CONTROL 135
+#define SI570_REG_FREEZE_DCO 137
+#define SI570_DIV_OFFSET_7PPM 6
+
+#define HS_DIV_SHIFT 5
+#define HS_DIV_MASK 0xe0
+#define HS_DIV_OFFSET 4
+#define N1_6_2_MASK 0x1f
+#define N1_1_0_MASK 0xc0
+#define RFREQ_37_32_MASK 0x3f
+
+#define SI570_MIN_FREQ 10000000L
+#define SI570_MAX_FREQ 1417500000L
+#define SI598_MAX_FREQ 525000000L
+
+#define FDCO_MIN 4850000000LL
+#define FDCO_MAX 5670000000LL
+
+#define SI570_CNTRL_RECALL (1 << 0)
+#define SI570_CNTRL_FREEZE_M (1 << 5)
+#define SI570_CNTRL_NEWFREQ (1 << 6)
+
+#define SI570_FREEZE_DCO (1 << 4)
+
+/**
+ * struct clk_si570:
+ * @hw: Clock hw struct
+ * @regmap: Device's regmap
+ * @div_offset: Rgister offset for dividers
+ * @max_freq: Maximum frequency for this device
+ * @fxtal: Factory xtal frequency
+ * @n1: Clock divider N1
+ * @hs_div: Clock divider HSDIV
+ * @rfreq: Clock multiplier RFREQ
+ * @frequency: Current output frequency
+ * @i2c_client: I2C client pointer
+ */
+struct clk_si570 {
+ struct clk_hw hw;
+ struct regmap *regmap;
+ unsigned int div_offset;
+ u64 max_freq;
+ u64 fxtal;
+ unsigned int n1;
+ unsigned int hs_div;
+ u64 rfreq;
+ u64 frequency;
+ struct i2c_client *i2c_client;
+};
+#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
+
+enum clk_si570_variant {
+ si57x,
+ si59x
+};
+
+/**
+ * si570_get_divs() - Read clock dividers from HW
+ * @data: Pointer to struct clk_si570
+ * @rfreq: Fractional multiplier (output)
+ * @n1: Divider N1 (output)
+ * @hs_div: Divider HSDIV (output)
+ * Returns 0 on success, negative errno otherwise.
+ *
+ * Retrieve clock dividers and multipliers from the HW.
+ */
+static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
+ unsigned int *n1, unsigned int *hs_div)
+{
+ int err;
+ u8 reg[6];
+ u64 tmp;
+
+ err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
+ reg, ARRAY_SIZE(reg));
+ if (err)
+ return err;
+
+ *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
+ *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
+ /* Handle invalid cases */
+ if (*n1 > 1)
+ *n1 &= ~1;
+
+ tmp = reg[1] & RFREQ_37_32_MASK;
+ tmp = (tmp << 8) + reg[2];
+ tmp = (tmp << 8) + reg[3];
+ tmp = (tmp << 8) + reg[4];
+ tmp = (tmp << 8) + reg[5];
+ *rfreq = tmp;
+
+ return 0;
+}
+
+/**
+ * si570_get_defaults() - Get default values
+ * @data: Driver data structure
+ * @fout: Factory frequency output
+ * Returns 0 on success, negative errno otherwise.
+ */
+static int si570_get_defaults(struct clk_si570 *data, u64 fout)
+{
+ int err;
+ u64 fdco;
+
+ regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
+
+ err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
+ if (err)
+ return err;
+
+ /*
+ * Accept optional precision loss to avoid arithmetic overflows.
+ * Acceptable per Silicon Labs Application Note AN334.
+ */
+ fdco = fout * data->n1 * data->hs_div;
+ if (fdco >= (1LL << 36))
+ data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
+ else
+ data->fxtal = div64_u64(fdco << 28, data->rfreq);
+
+ data->frequency = fout;
+
+ return 0;
+}
+
+/**
+ * si570_update_rfreq() - Update clock multiplier
+ * @data: Driver data structure
+ * Passes on regmap_bulk_write() return value.
+ */
+static int si570_update_rfreq(struct clk_si570 *data)
+{
+ u8 reg[5];
+
+ reg[0] = ((data->n1 - 1) << 6) |
+ ((data->rfreq >> 32) & RFREQ_37_32_MASK);
+ reg[1] = (data->rfreq >> 24) & 0xff;
+ reg[2] = (data->rfreq >> 16) & 0xff;
+ reg[3] = (data->rfreq >> 8) & 0xff;
+ reg[4] = data->rfreq & 0xff;
+
+ return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
+ data->div_offset, reg, ARRAY_SIZE(reg));
+}
+
+/**
+ * si570_calc_divs() - Caluclate clock dividers
+ * @frequency: Target frequency
+ * @data: Driver data structure
+ * @out_rfreq: RFREG fractional multiplier (output)
+ * @out_n1: Clock divider N1 (output)
+ * @out_hs_div: Clock divider HSDIV (output)
+ * Returns 0 on success, negative errno otherwise.
+ *
+ * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
+ * (@out_rfreq) for a given target @frequency.
+ */
+static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
+ u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
+{
+ int i;
+ unsigned int n1, hs_div;
+ u64 fdco, best_fdco = ULLONG_MAX;
+ static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
+
+ for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
+ hs_div = si570_hs_div_values[i];
+ /* Calculate lowest possible value for n1 */
+ n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
+ if (!n1 || (n1 & 1))
+ n1++;
+ while (n1 <= 128) {
+ fdco = (u64)frequency * (u64)hs_div * (u64)n1;
+ if (fdco > FDCO_MAX)
+ break;
+ if (fdco >= FDCO_MIN && fdco < best_fdco) {
+ *out_n1 = n1;
+ *out_hs_div = hs_div;
+ *out_rfreq = div64_u64(fdco << 28, data->fxtal);
+ best_fdco = fdco;
+ }
+ n1 += (n1 == 1 ? 1 : 2);
+ }
+ }
+
+ if (best_fdco == ULLONG_MAX)
+ return -EINVAL;
+
+ return 0;
+}
+
+static unsigned long si570_recalc_rate(struct clk_hw *hw,
+ unsigned long parent_rate)
+{
+ int err;
+ u64 rfreq, rate;
+ unsigned int n1, hs_div;
+ struct clk_si570 *data = to_clk_si570(hw);
+
+ err = si570_get_divs(data, &rfreq, &n1, &hs_div);
+ if (err) {
+ dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
+ return data->frequency;
+ }
+
+ rfreq = div_u64(rfreq, hs_div * n1);
+ rate = (data->fxtal * rfreq) >> 28;
+
+ return rate;
+}
+
+static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
+ unsigned long *parent_rate)
+{
+ int err;
+ u64 rfreq;
+ unsigned int n1, hs_div;
+ struct clk_si570 *data = to_clk_si570(hw);
+
+ if (!rate)
+ return 0;
+
+ if (div64_u64(abs(rate - data->frequency) * 10000LL,
+ data->frequency) < 35) {
+ rfreq = div64_u64((data->rfreq * rate) +
+ div64_u64(data->frequency, 2), data->frequency);
+ n1 = data->n1;
+ hs_div = data->hs_div;
+
+ } else {
+ err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
+ if (err) {
+ dev_err(&data->i2c_client->dev,
+ "unable to round rate\n");
+ return 0;
+ }
+ }
+
+ return rate;
+}
+
+/**
+ * si570_set_frequency() - Adjust output frequency
+ * @data: Driver data structure
+ * @frequency: Target frequency
+ * Returns 0 on success.
+ *
+ * Update output frequency for big frequency changes (> 3,500 ppm).
+ */
+static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
+{
+ int err;
+
+ err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
+ &data->hs_div);
+ if (err)
+ return err;
+
+ /*
+ * The DCO reg should be accessed with a read-modify-write operation
+ * per AN334
+ */
+ regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
+ regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
+ ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
+ (((data->n1 - 1) >> 2) & N1_6_2_MASK));
+ si570_update_rfreq(data);
+ regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
+ regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
+
+ /* Applying a new frequency can take up to 10ms */
+ usleep_range(10000, 12000);
+
+ return 0;
+}
+
+/**
+ * si570_set_frequency_small() - Adjust output frequency
+ * @data: Driver data structure
+ * @frequency: Target frequency
+ * Returns 0 on success.
+ *
+ * Update output frequency for small frequency changes (< 3,500 ppm).
+ */
+static int si570_set_frequency_small(struct clk_si570 *data,
+ unsigned long frequency)
+{
+ /*
+ * This is a re-implementation of DIV_ROUND_CLOSEST
+ * using the div64_u64 function lieu of letting the compiler
+ * insert EABI calls
+ */
+ data->rfreq = div64_u64((data->rfreq * frequency) +
+ div_u64(data->frequency, 2), data->frequency);
+ regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
+ si570_update_rfreq(data);
+ regmap_write(data->regmap, SI570_REG_CONTROL, 0);
+
+ /* Applying a new frequency (small change) can take up to 100us */
+ usleep_range(100, 200);
+
+ return 0;
+}
+
+static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
+ unsigned long parent_rate)
+{
+ struct clk_si570 *data = to_clk_si570(hw);
+ struct i2c_client *client = data->i2c_client;
+ int err;
+
+ if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
+ dev_err(&client->dev,
+ "requested frequency %lu Hz is out of range\n", rate);
+ return -EINVAL;
+ }
+
+ if (div64_u64(abs(rate - data->frequency) * 10000LL,
+ data->frequency) < 35)
+ err = si570_set_frequency_small(data, rate);
+ else
+ err = si570_set_frequency(data, rate);
+
+ if (err)
+ return err;
+
+ data->frequency = rate;
+
+ return 0;
+}
+
+static const struct clk_ops si570_clk_ops = {
+ .recalc_rate = si570_recalc_rate,
+ .round_rate = si570_round_rate,
+ .set_rate = si570_set_rate,
+};
+
+static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
+{
+ switch (reg) {
+ case SI570_REG_CONTROL:
+ return true;
+ default:
+ return false;
+ }
+}
+
+static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
+{
+ switch (reg) {
+ case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
+ case SI570_REG_CONTROL:
+ case SI570_REG_FREEZE_DCO:
+ return true;
+ default:
+ return false;
+ }
+}
+
+static struct regmap_config si570_regmap_config = {
+ .reg_bits = 8,
+ .val_bits = 8,
+ .cache_type = REGCACHE_RBTREE,
+ .max_register = 137,
+ .writeable_reg = si570_regmap_is_writeable,
+ .volatile_reg = si570_regmap_is_volatile,
+};
+
+static int si570_probe(struct i2c_client *client,
+ const struct i2c_device_id *id)
+{
+ struct clk_si570 *data;
+ struct clk_init_data init;
+ struct clk *clk;
+ u32 initial_fout, factory_fout, stability;
+ int err;
+ enum clk_si570_variant variant = id->driver_data;
+
+ data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
+ if (!data)
+ return -ENOMEM;
+
+ init.ops = &si570_clk_ops;
+ init.flags = CLK_IS_ROOT;
+ init.num_parents = 0;
+ data->hw.init = &init;
+ data->i2c_client = client;
+
+ if (variant == si57x) {
+ err = of_property_read_u32(client->dev.of_node,
+ "temperature-stability", &stability);
+ if (err) {
+ dev_err(&client->dev,
+ "'temperature-stability' property missing\n");
+ return err;
+ }
+ /* adjust register offsets for 7ppm devices */
+ if (stability == 7)
+ data->div_offset = SI570_DIV_OFFSET_7PPM;
+
+ data->max_freq = SI570_MAX_FREQ;
+ } else {
+ data->max_freq = SI598_MAX_FREQ;
+ }
+
+ if (of_property_read_string(client->dev.of_node, "clock-output-names",
+ &init.name))
+ init.name = client->dev.of_node->name;
+
+ err = of_property_read_u32(client->dev.of_node, "factory-fout",
+ &factory_fout);
+ if (err) {
+ dev_err(&client->dev, "'factory-fout' property missing\n");
+ return err;
+ }
+
+ data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
+ if (IS_ERR(data->regmap)) {
+ dev_err(&client->dev, "failed to allocate register map\n");
+ return PTR_ERR(data->regmap);
+ }
+
+ i2c_set_clientdata(client, data);
+ err = si570_get_defaults(data, factory_fout);
+ if (err)
+ return err;
+
+ clk = devm_clk_register(&client->dev, &data->hw);
+ if (IS_ERR(clk)) {
+ dev_err(&client->dev, "clock registration failed\n");
+ return PTR_ERR(clk);
+ }
+ err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
+ clk);
+ if (err) {
+ dev_err(&client->dev, "unable to add clk provider\n");
+ return err;
+ }
+
+ /* Read the requested initial output frequency from device tree */
+ if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
+ &initial_fout)) {
+ err = clk_set_rate(clk, initial_fout);
+ if (err) {
+ of_clk_del_provider(client->dev.of_node);
+ return err;
+ }
+ }
+
+ /* Display a message indicating that we've successfully registered */
+ dev_info(&client->dev, "registered, current frequency %llu Hz\n",
+ data->frequency);
+
+ return 0;
+}
+
+static int si570_remove(struct i2c_client *client)
+{
+ of_clk_del_provider(client->dev.of_node);
+ return 0;
+}
+
+static const struct i2c_device_id si570_id[] = {
+ { "si570", si57x },
+ { "si571", si57x },
+ { "si598", si59x },
+ { "si599", si59x },
+ { }
+};
+MODULE_DEVICE_TABLE(i2c, si570_id);
+
+static const struct of_device_id clk_si570_of_match[] = {
+ { .compatible = "silabs,si570" },
+ { .compatible = "silabs,si571" },
+ { .compatible = "silabs,si598" },
+ { .compatible = "silabs,si599" },
+ { },
+};
+MODULE_DEVICE_TABLE(of, clk_si570_of_match);
+
+static struct i2c_driver si570_driver = {
+ .driver = {
+ .name = "si570",
+ .of_match_table = of_match_ptr(clk_si570_of_match),
+ },
+ .probe = si570_probe,
+ .remove = si570_remove,
+ .id_table = si570_id,
+};
+module_i2c_driver(si570_driver);
+
+MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
+MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
+MODULE_DESCRIPTION("Si570 driver");
+MODULE_LICENSE("GPL");
--
1.8.4
^ permalink raw reply related [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-09-21 23:40 ` Soren Brinkmann
0 siblings, 0 replies; 27+ messages in thread
From: Soren Brinkmann @ 2013-09-21 23:40 UTC (permalink / raw)
To: Rob Herring, Pawel Moll, Mark Rutland, Stephen Warren,
Ian Campbell, Rob Landley, Mike Turquette, Grant Likely,
Guenter Roeck, Sebastian Hesselbarth, Joe Perches
Cc: devicetree-u79uwXL29TY76Z2rM5mHXA,
linux-doc-u79uwXL29TY76Z2rM5mHXA,
linux-kernel-u79uwXL29TY76Z2rM5mHXA,
linux-arm-kernel-IAPFreCvJWM7uuMidbF8XUB+6BGkLq7r, Hyun Kwon,
Soren Brinkmann
Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
The devices generate low-jitter clock signals and are reprogrammable via
an I2C interface.
Cc: Guenter Roeck <linux-0h96xk9xTtrk1uMJSBkQmQ@public.gmane.org>
Signed-off-by: Soren Brinkmann <soren.brinkmann-gjFFaj9aHVfQT0dZR+AlfA@public.gmane.org>
---
v5:
- fix typo in bindings documentation
- mention the unit for the 'temperature-stability' property
- remove calls to clk_unregister() (the device managed code takes care
of it)
v4:
- actually check and handle error on clk_set_rate() call
v3:
- add delay in the path for small frequency changes, which can take up
to 100us according to the data sheet
- use real range for usleep_range() argument
- use dev_err() over dev_warn() in set_rate()
- add list of applicable devices for 7ppm DT prop
- remove comments regarding platform data
- ignore 7ppm DT prop for incompatible devices
- replace raw numbers with #defines
- convert DT prop 'temperature-stability' from boolean to u32
- make 'temperature-stability' DT prop required (actually not fully
true, for 59x it is ignored and the driver does not require its
presence)
v2:
- document clock-output-names in bindings documentation
- don't use wildcards in compatibility string
- change Kconfig entry to "... 570 and compatible devices"
- change some indentation flaws
- use 10000 as MIN and MAX value in usleep_range
- fail probe() if 'factory-fout' is not provided in DT
- default factory fout #defines removed
- use i2c driver_data instead of OF data
- remove some related structs and data
- rename DT property 'initial-fout' => 'clock-frequency' (like si5351
driver)
- add some more details regarding the 'factory-fout' DT property
---
.../devicetree/bindings/clock/silabs,si570.txt | 39 ++
drivers/clk/Kconfig | 10 +
drivers/clk/Makefile | 1 +
drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
4 files changed, 581 insertions(+)
create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
create mode 100644 drivers/clk/clk-si570.c
diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
new file mode 100644
index 0000000..c09f21e
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
@@ -0,0 +1,39 @@
+Binding for Silicon Labs 570, 571, 598 and 599 programmable
+I2C clock generators.
+
+Reference
+This binding uses the common clock binding[1]. Details about the devices can be
+found in the data sheets[2][3].
+
+[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
+[2] Si570/571 Data Sheet
+ http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
+[3] Si598/599 Data Sheet
+ http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
+
+Required properties:
+ - compatible: Shall be one of "silabs,si570", "silabs,si571",
+ "silabs,si598", "silabs,si599"
+ - reg: I2C device address.
+ - #clock-cells: From common clock bindings: Shall be 0.
+ - factory-fout: Factory set default frequency. This frequency is part specific.
+ The correct frequency for the part used has to be provided in
+ order to generate the correct output frequencies. For more
+ details, please refer to the data sheet.
+ - temperature-stability: Temperature stability of the device in PPM. Should be
+ one of: 7, 20, 50 or 100.
+
+Optional properties:
+ - clock-output-names: From common clock bindings. Recommended to be "si570".
+ - clock-frequency: Output frequency to generate. This defines the output
+ frequency set during boot. It can be reprogrammed during
+ runtime through the common clock framework.
+
+Example:
+ si570: clock-generator@5d {
+ #clock-cells = <0>;
+ compatible = "silabs,si570";
+ temperature-stability = <50>;
+ reg = <0x5d>;
+ factory-fout = <156250000>;
+ };
diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
index 279407a..349b88a 100644
--- a/drivers/clk/Kconfig
+++ b/drivers/clk/Kconfig
@@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
This driver supports Silicon Labs 5351A/B/C programmable clock
generators.
+config COMMON_CLK_SI570
+ tristate "Clock driver for SiLabs 570 and compatible devices"
+ depends on I2C
+ depends on OF
+ select REGMAP_I2C
+ help
+ ---help---
+ This driver supports Silicon Labs 570/571/598/599 programmable
+ clock generators.
+
config COMMON_CLK_S2MPS11
tristate "Clock driver for S2MPS11 MFD"
depends on MFD_SEC_CORE
diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
index 7b11106..c0e94b3 100644
--- a/drivers/clk/Makefile
+++ b/drivers/clk/Makefile
@@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
+obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
new file mode 100644
index 0000000..5d0ac9f
--- /dev/null
+++ b/drivers/clk/clk-si570.c
@@ -0,0 +1,531 @@
+/*
+ * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
+ *
+ * Copyright (C) 2010, 2011 Ericsson AB.
+ * Copyright (C) 2011 Guenter Roeck.
+ * Copyright (C) 2011 - 2013 Xilinx Inc.
+ *
+ * Author: Guenter Roeck <guenter.roeck-IzeFyvvaP7pWk0Htik3J/w@public.gmane.org>
+ * Sören Brinkmann <soren.brinkmann-gjFFaj9aHVfQT0dZR+AlfA@public.gmane.org>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ */
+
+#include <linux/clk-provider.h>
+#include <linux/delay.h>
+#include <linux/module.h>
+#include <linux/i2c.h>
+#include <linux/regmap.h>
+#include <linux/slab.h>
+
+/* Si570 registers */
+#define SI570_REG_HS_N1 7
+#define SI570_REG_N1_RFREQ0 8
+#define SI570_REG_RFREQ1 9
+#define SI570_REG_RFREQ2 10
+#define SI570_REG_RFREQ3 11
+#define SI570_REG_RFREQ4 12
+#define SI570_REG_CONTROL 135
+#define SI570_REG_FREEZE_DCO 137
+#define SI570_DIV_OFFSET_7PPM 6
+
+#define HS_DIV_SHIFT 5
+#define HS_DIV_MASK 0xe0
+#define HS_DIV_OFFSET 4
+#define N1_6_2_MASK 0x1f
+#define N1_1_0_MASK 0xc0
+#define RFREQ_37_32_MASK 0x3f
+
+#define SI570_MIN_FREQ 10000000L
+#define SI570_MAX_FREQ 1417500000L
+#define SI598_MAX_FREQ 525000000L
+
+#define FDCO_MIN 4850000000LL
+#define FDCO_MAX 5670000000LL
+
+#define SI570_CNTRL_RECALL (1 << 0)
+#define SI570_CNTRL_FREEZE_M (1 << 5)
+#define SI570_CNTRL_NEWFREQ (1 << 6)
+
+#define SI570_FREEZE_DCO (1 << 4)
+
+/**
+ * struct clk_si570:
+ * @hw: Clock hw struct
+ * @regmap: Device's regmap
+ * @div_offset: Rgister offset for dividers
+ * @max_freq: Maximum frequency for this device
+ * @fxtal: Factory xtal frequency
+ * @n1: Clock divider N1
+ * @hs_div: Clock divider HSDIV
+ * @rfreq: Clock multiplier RFREQ
+ * @frequency: Current output frequency
+ * @i2c_client: I2C client pointer
+ */
+struct clk_si570 {
+ struct clk_hw hw;
+ struct regmap *regmap;
+ unsigned int div_offset;
+ u64 max_freq;
+ u64 fxtal;
+ unsigned int n1;
+ unsigned int hs_div;
+ u64 rfreq;
+ u64 frequency;
+ struct i2c_client *i2c_client;
+};
+#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
+
+enum clk_si570_variant {
+ si57x,
+ si59x
+};
+
+/**
+ * si570_get_divs() - Read clock dividers from HW
+ * @data: Pointer to struct clk_si570
+ * @rfreq: Fractional multiplier (output)
+ * @n1: Divider N1 (output)
+ * @hs_div: Divider HSDIV (output)
+ * Returns 0 on success, negative errno otherwise.
+ *
+ * Retrieve clock dividers and multipliers from the HW.
+ */
+static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
+ unsigned int *n1, unsigned int *hs_div)
+{
+ int err;
+ u8 reg[6];
+ u64 tmp;
+
+ err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
+ reg, ARRAY_SIZE(reg));
+ if (err)
+ return err;
+
+ *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
+ *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
+ /* Handle invalid cases */
+ if (*n1 > 1)
+ *n1 &= ~1;
+
+ tmp = reg[1] & RFREQ_37_32_MASK;
+ tmp = (tmp << 8) + reg[2];
+ tmp = (tmp << 8) + reg[3];
+ tmp = (tmp << 8) + reg[4];
+ tmp = (tmp << 8) + reg[5];
+ *rfreq = tmp;
+
+ return 0;
+}
+
+/**
+ * si570_get_defaults() - Get default values
+ * @data: Driver data structure
+ * @fout: Factory frequency output
+ * Returns 0 on success, negative errno otherwise.
+ */
+static int si570_get_defaults(struct clk_si570 *data, u64 fout)
+{
+ int err;
+ u64 fdco;
+
+ regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
+
+ err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
+ if (err)
+ return err;
+
+ /*
+ * Accept optional precision loss to avoid arithmetic overflows.
+ * Acceptable per Silicon Labs Application Note AN334.
+ */
+ fdco = fout * data->n1 * data->hs_div;
+ if (fdco >= (1LL << 36))
+ data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
+ else
+ data->fxtal = div64_u64(fdco << 28, data->rfreq);
+
+ data->frequency = fout;
+
+ return 0;
+}
+
+/**
+ * si570_update_rfreq() - Update clock multiplier
+ * @data: Driver data structure
+ * Passes on regmap_bulk_write() return value.
+ */
+static int si570_update_rfreq(struct clk_si570 *data)
+{
+ u8 reg[5];
+
+ reg[0] = ((data->n1 - 1) << 6) |
+ ((data->rfreq >> 32) & RFREQ_37_32_MASK);
+ reg[1] = (data->rfreq >> 24) & 0xff;
+ reg[2] = (data->rfreq >> 16) & 0xff;
+ reg[3] = (data->rfreq >> 8) & 0xff;
+ reg[4] = data->rfreq & 0xff;
+
+ return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
+ data->div_offset, reg, ARRAY_SIZE(reg));
+}
+
+/**
+ * si570_calc_divs() - Caluclate clock dividers
+ * @frequency: Target frequency
+ * @data: Driver data structure
+ * @out_rfreq: RFREG fractional multiplier (output)
+ * @out_n1: Clock divider N1 (output)
+ * @out_hs_div: Clock divider HSDIV (output)
+ * Returns 0 on success, negative errno otherwise.
+ *
+ * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
+ * (@out_rfreq) for a given target @frequency.
+ */
+static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
+ u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
+{
+ int i;
+ unsigned int n1, hs_div;
+ u64 fdco, best_fdco = ULLONG_MAX;
+ static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
+
+ for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
+ hs_div = si570_hs_div_values[i];
+ /* Calculate lowest possible value for n1 */
+ n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
+ if (!n1 || (n1 & 1))
+ n1++;
+ while (n1 <= 128) {
+ fdco = (u64)frequency * (u64)hs_div * (u64)n1;
+ if (fdco > FDCO_MAX)
+ break;
+ if (fdco >= FDCO_MIN && fdco < best_fdco) {
+ *out_n1 = n1;
+ *out_hs_div = hs_div;
+ *out_rfreq = div64_u64(fdco << 28, data->fxtal);
+ best_fdco = fdco;
+ }
+ n1 += (n1 == 1 ? 1 : 2);
+ }
+ }
+
+ if (best_fdco == ULLONG_MAX)
+ return -EINVAL;
+
+ return 0;
+}
+
+static unsigned long si570_recalc_rate(struct clk_hw *hw,
+ unsigned long parent_rate)
+{
+ int err;
+ u64 rfreq, rate;
+ unsigned int n1, hs_div;
+ struct clk_si570 *data = to_clk_si570(hw);
+
+ err = si570_get_divs(data, &rfreq, &n1, &hs_div);
+ if (err) {
+ dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
+ return data->frequency;
+ }
+
+ rfreq = div_u64(rfreq, hs_div * n1);
+ rate = (data->fxtal * rfreq) >> 28;
+
+ return rate;
+}
+
+static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
+ unsigned long *parent_rate)
+{
+ int err;
+ u64 rfreq;
+ unsigned int n1, hs_div;
+ struct clk_si570 *data = to_clk_si570(hw);
+
+ if (!rate)
+ return 0;
+
+ if (div64_u64(abs(rate - data->frequency) * 10000LL,
+ data->frequency) < 35) {
+ rfreq = div64_u64((data->rfreq * rate) +
+ div64_u64(data->frequency, 2), data->frequency);
+ n1 = data->n1;
+ hs_div = data->hs_div;
+
+ } else {
+ err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
+ if (err) {
+ dev_err(&data->i2c_client->dev,
+ "unable to round rate\n");
+ return 0;
+ }
+ }
+
+ return rate;
+}
+
+/**
+ * si570_set_frequency() - Adjust output frequency
+ * @data: Driver data structure
+ * @frequency: Target frequency
+ * Returns 0 on success.
+ *
+ * Update output frequency for big frequency changes (> 3,500 ppm).
+ */
+static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
+{
+ int err;
+
+ err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
+ &data->hs_div);
+ if (err)
+ return err;
+
+ /*
+ * The DCO reg should be accessed with a read-modify-write operation
+ * per AN334
+ */
+ regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
+ regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
+ ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
+ (((data->n1 - 1) >> 2) & N1_6_2_MASK));
+ si570_update_rfreq(data);
+ regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
+ regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
+
+ /* Applying a new frequency can take up to 10ms */
+ usleep_range(10000, 12000);
+
+ return 0;
+}
+
+/**
+ * si570_set_frequency_small() - Adjust output frequency
+ * @data: Driver data structure
+ * @frequency: Target frequency
+ * Returns 0 on success.
+ *
+ * Update output frequency for small frequency changes (< 3,500 ppm).
+ */
+static int si570_set_frequency_small(struct clk_si570 *data,
+ unsigned long frequency)
+{
+ /*
+ * This is a re-implementation of DIV_ROUND_CLOSEST
+ * using the div64_u64 function lieu of letting the compiler
+ * insert EABI calls
+ */
+ data->rfreq = div64_u64((data->rfreq * frequency) +
+ div_u64(data->frequency, 2), data->frequency);
+ regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
+ si570_update_rfreq(data);
+ regmap_write(data->regmap, SI570_REG_CONTROL, 0);
+
+ /* Applying a new frequency (small change) can take up to 100us */
+ usleep_range(100, 200);
+
+ return 0;
+}
+
+static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
+ unsigned long parent_rate)
+{
+ struct clk_si570 *data = to_clk_si570(hw);
+ struct i2c_client *client = data->i2c_client;
+ int err;
+
+ if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
+ dev_err(&client->dev,
+ "requested frequency %lu Hz is out of range\n", rate);
+ return -EINVAL;
+ }
+
+ if (div64_u64(abs(rate - data->frequency) * 10000LL,
+ data->frequency) < 35)
+ err = si570_set_frequency_small(data, rate);
+ else
+ err = si570_set_frequency(data, rate);
+
+ if (err)
+ return err;
+
+ data->frequency = rate;
+
+ return 0;
+}
+
+static const struct clk_ops si570_clk_ops = {
+ .recalc_rate = si570_recalc_rate,
+ .round_rate = si570_round_rate,
+ .set_rate = si570_set_rate,
+};
+
+static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
+{
+ switch (reg) {
+ case SI570_REG_CONTROL:
+ return true;
+ default:
+ return false;
+ }
+}
+
+static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
+{
+ switch (reg) {
+ case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
+ case SI570_REG_CONTROL:
+ case SI570_REG_FREEZE_DCO:
+ return true;
+ default:
+ return false;
+ }
+}
+
+static struct regmap_config si570_regmap_config = {
+ .reg_bits = 8,
+ .val_bits = 8,
+ .cache_type = REGCACHE_RBTREE,
+ .max_register = 137,
+ .writeable_reg = si570_regmap_is_writeable,
+ .volatile_reg = si570_regmap_is_volatile,
+};
+
+static int si570_probe(struct i2c_client *client,
+ const struct i2c_device_id *id)
+{
+ struct clk_si570 *data;
+ struct clk_init_data init;
+ struct clk *clk;
+ u32 initial_fout, factory_fout, stability;
+ int err;
+ enum clk_si570_variant variant = id->driver_data;
+
+ data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
+ if (!data)
+ return -ENOMEM;
+
+ init.ops = &si570_clk_ops;
+ init.flags = CLK_IS_ROOT;
+ init.num_parents = 0;
+ data->hw.init = &init;
+ data->i2c_client = client;
+
+ if (variant == si57x) {
+ err = of_property_read_u32(client->dev.of_node,
+ "temperature-stability", &stability);
+ if (err) {
+ dev_err(&client->dev,
+ "'temperature-stability' property missing\n");
+ return err;
+ }
+ /* adjust register offsets for 7ppm devices */
+ if (stability == 7)
+ data->div_offset = SI570_DIV_OFFSET_7PPM;
+
+ data->max_freq = SI570_MAX_FREQ;
+ } else {
+ data->max_freq = SI598_MAX_FREQ;
+ }
+
+ if (of_property_read_string(client->dev.of_node, "clock-output-names",
+ &init.name))
+ init.name = client->dev.of_node->name;
+
+ err = of_property_read_u32(client->dev.of_node, "factory-fout",
+ &factory_fout);
+ if (err) {
+ dev_err(&client->dev, "'factory-fout' property missing\n");
+ return err;
+ }
+
+ data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
+ if (IS_ERR(data->regmap)) {
+ dev_err(&client->dev, "failed to allocate register map\n");
+ return PTR_ERR(data->regmap);
+ }
+
+ i2c_set_clientdata(client, data);
+ err = si570_get_defaults(data, factory_fout);
+ if (err)
+ return err;
+
+ clk = devm_clk_register(&client->dev, &data->hw);
+ if (IS_ERR(clk)) {
+ dev_err(&client->dev, "clock registration failed\n");
+ return PTR_ERR(clk);
+ }
+ err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
+ clk);
+ if (err) {
+ dev_err(&client->dev, "unable to add clk provider\n");
+ return err;
+ }
+
+ /* Read the requested initial output frequency from device tree */
+ if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
+ &initial_fout)) {
+ err = clk_set_rate(clk, initial_fout);
+ if (err) {
+ of_clk_del_provider(client->dev.of_node);
+ return err;
+ }
+ }
+
+ /* Display a message indicating that we've successfully registered */
+ dev_info(&client->dev, "registered, current frequency %llu Hz\n",
+ data->frequency);
+
+ return 0;
+}
+
+static int si570_remove(struct i2c_client *client)
+{
+ of_clk_del_provider(client->dev.of_node);
+ return 0;
+}
+
+static const struct i2c_device_id si570_id[] = {
+ { "si570", si57x },
+ { "si571", si57x },
+ { "si598", si59x },
+ { "si599", si59x },
+ { }
+};
+MODULE_DEVICE_TABLE(i2c, si570_id);
+
+static const struct of_device_id clk_si570_of_match[] = {
+ { .compatible = "silabs,si570" },
+ { .compatible = "silabs,si571" },
+ { .compatible = "silabs,si598" },
+ { .compatible = "silabs,si599" },
+ { },
+};
+MODULE_DEVICE_TABLE(of, clk_si570_of_match);
+
+static struct i2c_driver si570_driver = {
+ .driver = {
+ .name = "si570",
+ .of_match_table = of_match_ptr(clk_si570_of_match),
+ },
+ .probe = si570_probe,
+ .remove = si570_remove,
+ .id_table = si570_id,
+};
+module_i2c_driver(si570_driver);
+
+MODULE_AUTHOR("Guenter Roeck <guenter.roeck-IzeFyvvaP7pWk0Htik3J/w@public.gmane.org>");
+MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann-gjFFaj9aHVfQT0dZR+AlfA@public.gmane.org");
+MODULE_DESCRIPTION("Si570 driver");
+MODULE_LICENSE("GPL");
--
1.8.4
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply related [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-09-21 23:40 ` Soren Brinkmann
0 siblings, 0 replies; 27+ messages in thread
From: Soren Brinkmann @ 2013-09-21 23:40 UTC (permalink / raw)
To: linux-arm-kernel
Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
The devices generate low-jitter clock signals and are reprogrammable via
an I2C interface.
Cc: Guenter Roeck <linux@roeck-us.net>
Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
---
v5:
- fix typo in bindings documentation
- mention the unit for the 'temperature-stability' property
- remove calls to clk_unregister() (the device managed code takes care
of it)
v4:
- actually check and handle error on clk_set_rate() call
v3:
- add delay in the path for small frequency changes, which can take up
to 100us according to the data sheet
- use real range for usleep_range() argument
- use dev_err() over dev_warn() in set_rate()
- add list of applicable devices for 7ppm DT prop
- remove comments regarding platform data
- ignore 7ppm DT prop for incompatible devices
- replace raw numbers with #defines
- convert DT prop 'temperature-stability' from boolean to u32
- make 'temperature-stability' DT prop required (actually not fully
true, for 59x it is ignored and the driver does not require its
presence)
v2:
- document clock-output-names in bindings documentation
- don't use wildcards in compatibility string
- change Kconfig entry to "... 570 and compatible devices"
- change some indentation flaws
- use 10000 as MIN and MAX value in usleep_range
- fail probe() if 'factory-fout' is not provided in DT
- default factory fout #defines removed
- use i2c driver_data instead of OF data
- remove some related structs and data
- rename DT property 'initial-fout' => 'clock-frequency' (like si5351
driver)
- add some more details regarding the 'factory-fout' DT property
---
.../devicetree/bindings/clock/silabs,si570.txt | 39 ++
drivers/clk/Kconfig | 10 +
drivers/clk/Makefile | 1 +
drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
4 files changed, 581 insertions(+)
create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
create mode 100644 drivers/clk/clk-si570.c
diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
new file mode 100644
index 0000000..c09f21e
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
@@ -0,0 +1,39 @@
+Binding for Silicon Labs 570, 571, 598 and 599 programmable
+I2C clock generators.
+
+Reference
+This binding uses the common clock binding[1]. Details about the devices can be
+found in the data sheets[2][3].
+
+[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
+[2] Si570/571 Data Sheet
+ http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
+[3] Si598/599 Data Sheet
+ http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
+
+Required properties:
+ - compatible: Shall be one of "silabs,si570", "silabs,si571",
+ "silabs,si598", "silabs,si599"
+ - reg: I2C device address.
+ - #clock-cells: From common clock bindings: Shall be 0.
+ - factory-fout: Factory set default frequency. This frequency is part specific.
+ The correct frequency for the part used has to be provided in
+ order to generate the correct output frequencies. For more
+ details, please refer to the data sheet.
+ - temperature-stability: Temperature stability of the device in PPM. Should be
+ one of: 7, 20, 50 or 100.
+
+Optional properties:
+ - clock-output-names: From common clock bindings. Recommended to be "si570".
+ - clock-frequency: Output frequency to generate. This defines the output
+ frequency set during boot. It can be reprogrammed during
+ runtime through the common clock framework.
+
+Example:
+ si570: clock-generator at 5d {
+ #clock-cells = <0>;
+ compatible = "silabs,si570";
+ temperature-stability = <50>;
+ reg = <0x5d>;
+ factory-fout = <156250000>;
+ };
diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
index 279407a..349b88a 100644
--- a/drivers/clk/Kconfig
+++ b/drivers/clk/Kconfig
@@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
This driver supports Silicon Labs 5351A/B/C programmable clock
generators.
+config COMMON_CLK_SI570
+ tristate "Clock driver for SiLabs 570 and compatible devices"
+ depends on I2C
+ depends on OF
+ select REGMAP_I2C
+ help
+ ---help---
+ This driver supports Silicon Labs 570/571/598/599 programmable
+ clock generators.
+
config COMMON_CLK_S2MPS11
tristate "Clock driver for S2MPS11 MFD"
depends on MFD_SEC_CORE
diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
index 7b11106..c0e94b3 100644
--- a/drivers/clk/Makefile
+++ b/drivers/clk/Makefile
@@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
+obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
new file mode 100644
index 0000000..5d0ac9f
--- /dev/null
+++ b/drivers/clk/clk-si570.c
@@ -0,0 +1,531 @@
+/*
+ * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
+ *
+ * Copyright (C) 2010, 2011 Ericsson AB.
+ * Copyright (C) 2011 Guenter Roeck.
+ * Copyright (C) 2011 - 2013 Xilinx Inc.
+ *
+ * Author: Guenter Roeck <guenter.roeck@ericsson.com>
+ * S?ren Brinkmann <soren.brinkmann@xilinx.com>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ */
+
+#include <linux/clk-provider.h>
+#include <linux/delay.h>
+#include <linux/module.h>
+#include <linux/i2c.h>
+#include <linux/regmap.h>
+#include <linux/slab.h>
+
+/* Si570 registers */
+#define SI570_REG_HS_N1 7
+#define SI570_REG_N1_RFREQ0 8
+#define SI570_REG_RFREQ1 9
+#define SI570_REG_RFREQ2 10
+#define SI570_REG_RFREQ3 11
+#define SI570_REG_RFREQ4 12
+#define SI570_REG_CONTROL 135
+#define SI570_REG_FREEZE_DCO 137
+#define SI570_DIV_OFFSET_7PPM 6
+
+#define HS_DIV_SHIFT 5
+#define HS_DIV_MASK 0xe0
+#define HS_DIV_OFFSET 4
+#define N1_6_2_MASK 0x1f
+#define N1_1_0_MASK 0xc0
+#define RFREQ_37_32_MASK 0x3f
+
+#define SI570_MIN_FREQ 10000000L
+#define SI570_MAX_FREQ 1417500000L
+#define SI598_MAX_FREQ 525000000L
+
+#define FDCO_MIN 4850000000LL
+#define FDCO_MAX 5670000000LL
+
+#define SI570_CNTRL_RECALL (1 << 0)
+#define SI570_CNTRL_FREEZE_M (1 << 5)
+#define SI570_CNTRL_NEWFREQ (1 << 6)
+
+#define SI570_FREEZE_DCO (1 << 4)
+
+/**
+ * struct clk_si570:
+ * @hw: Clock hw struct
+ * @regmap: Device's regmap
+ * @div_offset: Rgister offset for dividers
+ * @max_freq: Maximum frequency for this device
+ * @fxtal: Factory xtal frequency
+ * @n1: Clock divider N1
+ * @hs_div: Clock divider HSDIV
+ * @rfreq: Clock multiplier RFREQ
+ * @frequency: Current output frequency
+ * @i2c_client: I2C client pointer
+ */
+struct clk_si570 {
+ struct clk_hw hw;
+ struct regmap *regmap;
+ unsigned int div_offset;
+ u64 max_freq;
+ u64 fxtal;
+ unsigned int n1;
+ unsigned int hs_div;
+ u64 rfreq;
+ u64 frequency;
+ struct i2c_client *i2c_client;
+};
+#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
+
+enum clk_si570_variant {
+ si57x,
+ si59x
+};
+
+/**
+ * si570_get_divs() - Read clock dividers from HW
+ * @data: Pointer to struct clk_si570
+ * @rfreq: Fractional multiplier (output)
+ * @n1: Divider N1 (output)
+ * @hs_div: Divider HSDIV (output)
+ * Returns 0 on success, negative errno otherwise.
+ *
+ * Retrieve clock dividers and multipliers from the HW.
+ */
+static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
+ unsigned int *n1, unsigned int *hs_div)
+{
+ int err;
+ u8 reg[6];
+ u64 tmp;
+
+ err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
+ reg, ARRAY_SIZE(reg));
+ if (err)
+ return err;
+
+ *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
+ *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
+ /* Handle invalid cases */
+ if (*n1 > 1)
+ *n1 &= ~1;
+
+ tmp = reg[1] & RFREQ_37_32_MASK;
+ tmp = (tmp << 8) + reg[2];
+ tmp = (tmp << 8) + reg[3];
+ tmp = (tmp << 8) + reg[4];
+ tmp = (tmp << 8) + reg[5];
+ *rfreq = tmp;
+
+ return 0;
+}
+
+/**
+ * si570_get_defaults() - Get default values
+ * @data: Driver data structure
+ * @fout: Factory frequency output
+ * Returns 0 on success, negative errno otherwise.
+ */
+static int si570_get_defaults(struct clk_si570 *data, u64 fout)
+{
+ int err;
+ u64 fdco;
+
+ regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
+
+ err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
+ if (err)
+ return err;
+
+ /*
+ * Accept optional precision loss to avoid arithmetic overflows.
+ * Acceptable per Silicon Labs Application Note AN334.
+ */
+ fdco = fout * data->n1 * data->hs_div;
+ if (fdco >= (1LL << 36))
+ data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
+ else
+ data->fxtal = div64_u64(fdco << 28, data->rfreq);
+
+ data->frequency = fout;
+
+ return 0;
+}
+
+/**
+ * si570_update_rfreq() - Update clock multiplier
+ * @data: Driver data structure
+ * Passes on regmap_bulk_write() return value.
+ */
+static int si570_update_rfreq(struct clk_si570 *data)
+{
+ u8 reg[5];
+
+ reg[0] = ((data->n1 - 1) << 6) |
+ ((data->rfreq >> 32) & RFREQ_37_32_MASK);
+ reg[1] = (data->rfreq >> 24) & 0xff;
+ reg[2] = (data->rfreq >> 16) & 0xff;
+ reg[3] = (data->rfreq >> 8) & 0xff;
+ reg[4] = data->rfreq & 0xff;
+
+ return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
+ data->div_offset, reg, ARRAY_SIZE(reg));
+}
+
+/**
+ * si570_calc_divs() - Caluclate clock dividers
+ * @frequency: Target frequency
+ * @data: Driver data structure
+ * @out_rfreq: RFREG fractional multiplier (output)
+ * @out_n1: Clock divider N1 (output)
+ * @out_hs_div: Clock divider HSDIV (output)
+ * Returns 0 on success, negative errno otherwise.
+ *
+ * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
+ * (@out_rfreq) for a given target @frequency.
+ */
+static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
+ u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
+{
+ int i;
+ unsigned int n1, hs_div;
+ u64 fdco, best_fdco = ULLONG_MAX;
+ static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
+
+ for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
+ hs_div = si570_hs_div_values[i];
+ /* Calculate lowest possible value for n1 */
+ n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
+ if (!n1 || (n1 & 1))
+ n1++;
+ while (n1 <= 128) {
+ fdco = (u64)frequency * (u64)hs_div * (u64)n1;
+ if (fdco > FDCO_MAX)
+ break;
+ if (fdco >= FDCO_MIN && fdco < best_fdco) {
+ *out_n1 = n1;
+ *out_hs_div = hs_div;
+ *out_rfreq = div64_u64(fdco << 28, data->fxtal);
+ best_fdco = fdco;
+ }
+ n1 += (n1 == 1 ? 1 : 2);
+ }
+ }
+
+ if (best_fdco == ULLONG_MAX)
+ return -EINVAL;
+
+ return 0;
+}
+
+static unsigned long si570_recalc_rate(struct clk_hw *hw,
+ unsigned long parent_rate)
+{
+ int err;
+ u64 rfreq, rate;
+ unsigned int n1, hs_div;
+ struct clk_si570 *data = to_clk_si570(hw);
+
+ err = si570_get_divs(data, &rfreq, &n1, &hs_div);
+ if (err) {
+ dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
+ return data->frequency;
+ }
+
+ rfreq = div_u64(rfreq, hs_div * n1);
+ rate = (data->fxtal * rfreq) >> 28;
+
+ return rate;
+}
+
+static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
+ unsigned long *parent_rate)
+{
+ int err;
+ u64 rfreq;
+ unsigned int n1, hs_div;
+ struct clk_si570 *data = to_clk_si570(hw);
+
+ if (!rate)
+ return 0;
+
+ if (div64_u64(abs(rate - data->frequency) * 10000LL,
+ data->frequency) < 35) {
+ rfreq = div64_u64((data->rfreq * rate) +
+ div64_u64(data->frequency, 2), data->frequency);
+ n1 = data->n1;
+ hs_div = data->hs_div;
+
+ } else {
+ err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
+ if (err) {
+ dev_err(&data->i2c_client->dev,
+ "unable to round rate\n");
+ return 0;
+ }
+ }
+
+ return rate;
+}
+
+/**
+ * si570_set_frequency() - Adjust output frequency
+ * @data: Driver data structure
+ * @frequency: Target frequency
+ * Returns 0 on success.
+ *
+ * Update output frequency for big frequency changes (> 3,500 ppm).
+ */
+static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
+{
+ int err;
+
+ err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
+ &data->hs_div);
+ if (err)
+ return err;
+
+ /*
+ * The DCO reg should be accessed with a read-modify-write operation
+ * per AN334
+ */
+ regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
+ regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
+ ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
+ (((data->n1 - 1) >> 2) & N1_6_2_MASK));
+ si570_update_rfreq(data);
+ regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
+ regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
+
+ /* Applying a new frequency can take up to 10ms */
+ usleep_range(10000, 12000);
+
+ return 0;
+}
+
+/**
+ * si570_set_frequency_small() - Adjust output frequency
+ * @data: Driver data structure
+ * @frequency: Target frequency
+ * Returns 0 on success.
+ *
+ * Update output frequency for small frequency changes (< 3,500 ppm).
+ */
+static int si570_set_frequency_small(struct clk_si570 *data,
+ unsigned long frequency)
+{
+ /*
+ * This is a re-implementation of DIV_ROUND_CLOSEST
+ * using the div64_u64 function lieu of letting the compiler
+ * insert EABI calls
+ */
+ data->rfreq = div64_u64((data->rfreq * frequency) +
+ div_u64(data->frequency, 2), data->frequency);
+ regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
+ si570_update_rfreq(data);
+ regmap_write(data->regmap, SI570_REG_CONTROL, 0);
+
+ /* Applying a new frequency (small change) can take up to 100us */
+ usleep_range(100, 200);
+
+ return 0;
+}
+
+static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
+ unsigned long parent_rate)
+{
+ struct clk_si570 *data = to_clk_si570(hw);
+ struct i2c_client *client = data->i2c_client;
+ int err;
+
+ if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
+ dev_err(&client->dev,
+ "requested frequency %lu Hz is out of range\n", rate);
+ return -EINVAL;
+ }
+
+ if (div64_u64(abs(rate - data->frequency) * 10000LL,
+ data->frequency) < 35)
+ err = si570_set_frequency_small(data, rate);
+ else
+ err = si570_set_frequency(data, rate);
+
+ if (err)
+ return err;
+
+ data->frequency = rate;
+
+ return 0;
+}
+
+static const struct clk_ops si570_clk_ops = {
+ .recalc_rate = si570_recalc_rate,
+ .round_rate = si570_round_rate,
+ .set_rate = si570_set_rate,
+};
+
+static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
+{
+ switch (reg) {
+ case SI570_REG_CONTROL:
+ return true;
+ default:
+ return false;
+ }
+}
+
+static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
+{
+ switch (reg) {
+ case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
+ case SI570_REG_CONTROL:
+ case SI570_REG_FREEZE_DCO:
+ return true;
+ default:
+ return false;
+ }
+}
+
+static struct regmap_config si570_regmap_config = {
+ .reg_bits = 8,
+ .val_bits = 8,
+ .cache_type = REGCACHE_RBTREE,
+ .max_register = 137,
+ .writeable_reg = si570_regmap_is_writeable,
+ .volatile_reg = si570_regmap_is_volatile,
+};
+
+static int si570_probe(struct i2c_client *client,
+ const struct i2c_device_id *id)
+{
+ struct clk_si570 *data;
+ struct clk_init_data init;
+ struct clk *clk;
+ u32 initial_fout, factory_fout, stability;
+ int err;
+ enum clk_si570_variant variant = id->driver_data;
+
+ data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
+ if (!data)
+ return -ENOMEM;
+
+ init.ops = &si570_clk_ops;
+ init.flags = CLK_IS_ROOT;
+ init.num_parents = 0;
+ data->hw.init = &init;
+ data->i2c_client = client;
+
+ if (variant == si57x) {
+ err = of_property_read_u32(client->dev.of_node,
+ "temperature-stability", &stability);
+ if (err) {
+ dev_err(&client->dev,
+ "'temperature-stability' property missing\n");
+ return err;
+ }
+ /* adjust register offsets for 7ppm devices */
+ if (stability == 7)
+ data->div_offset = SI570_DIV_OFFSET_7PPM;
+
+ data->max_freq = SI570_MAX_FREQ;
+ } else {
+ data->max_freq = SI598_MAX_FREQ;
+ }
+
+ if (of_property_read_string(client->dev.of_node, "clock-output-names",
+ &init.name))
+ init.name = client->dev.of_node->name;
+
+ err = of_property_read_u32(client->dev.of_node, "factory-fout",
+ &factory_fout);
+ if (err) {
+ dev_err(&client->dev, "'factory-fout' property missing\n");
+ return err;
+ }
+
+ data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
+ if (IS_ERR(data->regmap)) {
+ dev_err(&client->dev, "failed to allocate register map\n");
+ return PTR_ERR(data->regmap);
+ }
+
+ i2c_set_clientdata(client, data);
+ err = si570_get_defaults(data, factory_fout);
+ if (err)
+ return err;
+
+ clk = devm_clk_register(&client->dev, &data->hw);
+ if (IS_ERR(clk)) {
+ dev_err(&client->dev, "clock registration failed\n");
+ return PTR_ERR(clk);
+ }
+ err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
+ clk);
+ if (err) {
+ dev_err(&client->dev, "unable to add clk provider\n");
+ return err;
+ }
+
+ /* Read the requested initial output frequency from device tree */
+ if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
+ &initial_fout)) {
+ err = clk_set_rate(clk, initial_fout);
+ if (err) {
+ of_clk_del_provider(client->dev.of_node);
+ return err;
+ }
+ }
+
+ /* Display a message indicating that we've successfully registered */
+ dev_info(&client->dev, "registered, current frequency %llu Hz\n",
+ data->frequency);
+
+ return 0;
+}
+
+static int si570_remove(struct i2c_client *client)
+{
+ of_clk_del_provider(client->dev.of_node);
+ return 0;
+}
+
+static const struct i2c_device_id si570_id[] = {
+ { "si570", si57x },
+ { "si571", si57x },
+ { "si598", si59x },
+ { "si599", si59x },
+ { }
+};
+MODULE_DEVICE_TABLE(i2c, si570_id);
+
+static const struct of_device_id clk_si570_of_match[] = {
+ { .compatible = "silabs,si570" },
+ { .compatible = "silabs,si571" },
+ { .compatible = "silabs,si598" },
+ { .compatible = "silabs,si599" },
+ { },
+};
+MODULE_DEVICE_TABLE(of, clk_si570_of_match);
+
+static struct i2c_driver si570_driver = {
+ .driver = {
+ .name = "si570",
+ .of_match_table = of_match_ptr(clk_si570_of_match),
+ },
+ .probe = si570_probe,
+ .remove = si570_remove,
+ .id_table = si570_id,
+};
+module_i2c_driver(si570_driver);
+
+MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
+MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
+MODULE_DESCRIPTION("Si570 driver");
+MODULE_LICENSE("GPL");
--
1.8.4
^ permalink raw reply related [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
2013-09-21 23:40 ` Soren Brinkmann
@ 2013-09-22 2:31 ` Guenter Roeck
-1 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-09-22 2:31 UTC (permalink / raw)
To: Soren Brinkmann
Cc: Rob Herring, Pawel Moll, Mark Rutland, Stephen Warren,
Ian Campbell, Rob Landley, Mike Turquette, Grant Likely,
Sebastian Hesselbarth, Joe Perches, devicetree, linux-doc,
linux-kernel, linux-arm-kernel, Hyun Kwon
On 09/21/2013 04:40 PM, Soren Brinkmann wrote:
> Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> The devices generate low-jitter clock signals and are reprogrammable via
> an I2C interface.
>
> Cc: Guenter Roeck <linux@roeck-us.net>
> Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
Looks good to me. Thanks a lot for picking this up.
Reviewed-by: Guenter Roeck <linux@roeck-us.net>
Guenter
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-09-22 2:31 ` Guenter Roeck
0 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-09-22 2:31 UTC (permalink / raw)
To: linux-arm-kernel
On 09/21/2013 04:40 PM, Soren Brinkmann wrote:
> Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> The devices generate low-jitter clock signals and are reprogrammable via
> an I2C interface.
>
> Cc: Guenter Roeck <linux@roeck-us.net>
> Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
Looks good to me. Thanks a lot for picking this up.
Reviewed-by: Guenter Roeck <linux@roeck-us.net>
Guenter
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
2013-09-21 23:40 ` Soren Brinkmann
(?)
@ 2013-10-02 17:20 ` Sören Brinkmann
-1 siblings, 0 replies; 27+ messages in thread
From: Sören Brinkmann @ 2013-10-02 17:20 UTC (permalink / raw)
To: Rob Herring, Pawel Moll, Mark Rutland, Stephen Warren,
Ian Campbell, Rob Landley, Mike Turquette, Grant Likely,
Guenter Roeck, Sebastian Hesselbarth, Joe Perches
Cc: devicetree, linux-doc, linux-kernel, linux-arm-kernel, Hyun Kwon
Hi Mike,
could you please comment on this/apply it to clk-next?
Thanks,
Sören
On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
> Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> The devices generate low-jitter clock signals and are reprogrammable via
> an I2C interface.
>
> Cc: Guenter Roeck <linux@roeck-us.net>
> Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
> ---
> v5:
> - fix typo in bindings documentation
> - mention the unit for the 'temperature-stability' property
> - remove calls to clk_unregister() (the device managed code takes care
> of it)
>
> v4:
> - actually check and handle error on clk_set_rate() call
>
> v3:
> - add delay in the path for small frequency changes, which can take up
> to 100us according to the data sheet
> - use real range for usleep_range() argument
> - use dev_err() over dev_warn() in set_rate()
> - add list of applicable devices for 7ppm DT prop
> - remove comments regarding platform data
> - ignore 7ppm DT prop for incompatible devices
> - replace raw numbers with #defines
> - convert DT prop 'temperature-stability' from boolean to u32
> - make 'temperature-stability' DT prop required (actually not fully
> true, for 59x it is ignored and the driver does not require its
> presence)
>
> v2:
> - document clock-output-names in bindings documentation
> - don't use wildcards in compatibility string
> - change Kconfig entry to "... 570 and compatible devices"
> - change some indentation flaws
> - use 10000 as MIN and MAX value in usleep_range
> - fail probe() if 'factory-fout' is not provided in DT
> - default factory fout #defines removed
> - use i2c driver_data instead of OF data
> - remove some related structs and data
> - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
> driver)
> - add some more details regarding the 'factory-fout' DT property
> ---
> .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
> drivers/clk/Kconfig | 10 +
> drivers/clk/Makefile | 1 +
> drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
> 4 files changed, 581 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
> create mode 100644 drivers/clk/clk-si570.c
>
> diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> new file mode 100644
> index 0000000..c09f21e
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> @@ -0,0 +1,39 @@
> +Binding for Silicon Labs 570, 571, 598 and 599 programmable
> +I2C clock generators.
> +
> +Reference
> +This binding uses the common clock binding[1]. Details about the devices can be
> +found in the data sheets[2][3].
> +
> +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
> +[2] Si570/571 Data Sheet
> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
> +[3] Si598/599 Data Sheet
> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
> +
> +Required properties:
> + - compatible: Shall be one of "silabs,si570", "silabs,si571",
> + "silabs,si598", "silabs,si599"
> + - reg: I2C device address.
> + - #clock-cells: From common clock bindings: Shall be 0.
> + - factory-fout: Factory set default frequency. This frequency is part specific.
> + The correct frequency for the part used has to be provided in
> + order to generate the correct output frequencies. For more
> + details, please refer to the data sheet.
> + - temperature-stability: Temperature stability of the device in PPM. Should be
> + one of: 7, 20, 50 or 100.
> +
> +Optional properties:
> + - clock-output-names: From common clock bindings. Recommended to be "si570".
> + - clock-frequency: Output frequency to generate. This defines the output
> + frequency set during boot. It can be reprogrammed during
> + runtime through the common clock framework.
> +
> +Example:
> + si570: clock-generator@5d {
> + #clock-cells = <0>;
> + compatible = "silabs,si570";
> + temperature-stability = <50>;
> + reg = <0x5d>;
> + factory-fout = <156250000>;
> + };
> diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
> index 279407a..349b88a 100644
> --- a/drivers/clk/Kconfig
> +++ b/drivers/clk/Kconfig
> @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
> This driver supports Silicon Labs 5351A/B/C programmable clock
> generators.
>
> +config COMMON_CLK_SI570
> + tristate "Clock driver for SiLabs 570 and compatible devices"
> + depends on I2C
> + depends on OF
> + select REGMAP_I2C
> + help
> + ---help---
> + This driver supports Silicon Labs 570/571/598/599 programmable
> + clock generators.
> +
> config COMMON_CLK_S2MPS11
> tristate "Clock driver for S2MPS11 MFD"
> depends on MFD_SEC_CORE
> diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
> index 7b11106..c0e94b3 100644
> --- a/drivers/clk/Makefile
> +++ b/drivers/clk/Makefile
> @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
> obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
> obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
> obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
> +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
> obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
> obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
> obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
> diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
> new file mode 100644
> index 0000000..5d0ac9f
> --- /dev/null
> +++ b/drivers/clk/clk-si570.c
> @@ -0,0 +1,531 @@
> +/*
> + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
> + *
> + * Copyright (C) 2010, 2011 Ericsson AB.
> + * Copyright (C) 2011 Guenter Roeck.
> + * Copyright (C) 2011 - 2013 Xilinx Inc.
> + *
> + * Author: Guenter Roeck <guenter.roeck@ericsson.com>
> + * Sören Brinkmann <soren.brinkmann@xilinx.com>
> + *
> + * This program is free software; you can redistribute it and/or modify
> + * it under the terms of the GNU General Public License as published by
> + * the Free Software Foundation; either version 2 of the License, or
> + * (at your option) any later version.
> + *
> + * This program is distributed in the hope that it will be useful,
> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
> + * GNU General Public License for more details.
> + */
> +
> +#include <linux/clk-provider.h>
> +#include <linux/delay.h>
> +#include <linux/module.h>
> +#include <linux/i2c.h>
> +#include <linux/regmap.h>
> +#include <linux/slab.h>
> +
> +/* Si570 registers */
> +#define SI570_REG_HS_N1 7
> +#define SI570_REG_N1_RFREQ0 8
> +#define SI570_REG_RFREQ1 9
> +#define SI570_REG_RFREQ2 10
> +#define SI570_REG_RFREQ3 11
> +#define SI570_REG_RFREQ4 12
> +#define SI570_REG_CONTROL 135
> +#define SI570_REG_FREEZE_DCO 137
> +#define SI570_DIV_OFFSET_7PPM 6
> +
> +#define HS_DIV_SHIFT 5
> +#define HS_DIV_MASK 0xe0
> +#define HS_DIV_OFFSET 4
> +#define N1_6_2_MASK 0x1f
> +#define N1_1_0_MASK 0xc0
> +#define RFREQ_37_32_MASK 0x3f
> +
> +#define SI570_MIN_FREQ 10000000L
> +#define SI570_MAX_FREQ 1417500000L
> +#define SI598_MAX_FREQ 525000000L
> +
> +#define FDCO_MIN 4850000000LL
> +#define FDCO_MAX 5670000000LL
> +
> +#define SI570_CNTRL_RECALL (1 << 0)
> +#define SI570_CNTRL_FREEZE_M (1 << 5)
> +#define SI570_CNTRL_NEWFREQ (1 << 6)
> +
> +#define SI570_FREEZE_DCO (1 << 4)
> +
> +/**
> + * struct clk_si570:
> + * @hw: Clock hw struct
> + * @regmap: Device's regmap
> + * @div_offset: Rgister offset for dividers
> + * @max_freq: Maximum frequency for this device
> + * @fxtal: Factory xtal frequency
> + * @n1: Clock divider N1
> + * @hs_div: Clock divider HSDIV
> + * @rfreq: Clock multiplier RFREQ
> + * @frequency: Current output frequency
> + * @i2c_client: I2C client pointer
> + */
> +struct clk_si570 {
> + struct clk_hw hw;
> + struct regmap *regmap;
> + unsigned int div_offset;
> + u64 max_freq;
> + u64 fxtal;
> + unsigned int n1;
> + unsigned int hs_div;
> + u64 rfreq;
> + u64 frequency;
> + struct i2c_client *i2c_client;
> +};
> +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
> +
> +enum clk_si570_variant {
> + si57x,
> + si59x
> +};
> +
> +/**
> + * si570_get_divs() - Read clock dividers from HW
> + * @data: Pointer to struct clk_si570
> + * @rfreq: Fractional multiplier (output)
> + * @n1: Divider N1 (output)
> + * @hs_div: Divider HSDIV (output)
> + * Returns 0 on success, negative errno otherwise.
> + *
> + * Retrieve clock dividers and multipliers from the HW.
> + */
> +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
> + unsigned int *n1, unsigned int *hs_div)
> +{
> + int err;
> + u8 reg[6];
> + u64 tmp;
> +
> + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> + reg, ARRAY_SIZE(reg));
> + if (err)
> + return err;
> +
> + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
> + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
> + /* Handle invalid cases */
> + if (*n1 > 1)
> + *n1 &= ~1;
> +
> + tmp = reg[1] & RFREQ_37_32_MASK;
> + tmp = (tmp << 8) + reg[2];
> + tmp = (tmp << 8) + reg[3];
> + tmp = (tmp << 8) + reg[4];
> + tmp = (tmp << 8) + reg[5];
> + *rfreq = tmp;
> +
> + return 0;
> +}
> +
> +/**
> + * si570_get_defaults() - Get default values
> + * @data: Driver data structure
> + * @fout: Factory frequency output
> + * Returns 0 on success, negative errno otherwise.
> + */
> +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
> +{
> + int err;
> + u64 fdco;
> +
> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
> +
> + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
> + if (err)
> + return err;
> +
> + /*
> + * Accept optional precision loss to avoid arithmetic overflows.
> + * Acceptable per Silicon Labs Application Note AN334.
> + */
> + fdco = fout * data->n1 * data->hs_div;
> + if (fdco >= (1LL << 36))
> + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
> + else
> + data->fxtal = div64_u64(fdco << 28, data->rfreq);
> +
> + data->frequency = fout;
> +
> + return 0;
> +}
> +
> +/**
> + * si570_update_rfreq() - Update clock multiplier
> + * @data: Driver data structure
> + * Passes on regmap_bulk_write() return value.
> + */
> +static int si570_update_rfreq(struct clk_si570 *data)
> +{
> + u8 reg[5];
> +
> + reg[0] = ((data->n1 - 1) << 6) |
> + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
> + reg[1] = (data->rfreq >> 24) & 0xff;
> + reg[2] = (data->rfreq >> 16) & 0xff;
> + reg[3] = (data->rfreq >> 8) & 0xff;
> + reg[4] = data->rfreq & 0xff;
> +
> + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
> + data->div_offset, reg, ARRAY_SIZE(reg));
> +}
> +
> +/**
> + * si570_calc_divs() - Caluclate clock dividers
> + * @frequency: Target frequency
> + * @data: Driver data structure
> + * @out_rfreq: RFREG fractional multiplier (output)
> + * @out_n1: Clock divider N1 (output)
> + * @out_hs_div: Clock divider HSDIV (output)
> + * Returns 0 on success, negative errno otherwise.
> + *
> + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
> + * (@out_rfreq) for a given target @frequency.
> + */
> +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
> + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
> +{
> + int i;
> + unsigned int n1, hs_div;
> + u64 fdco, best_fdco = ULLONG_MAX;
> + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
> +
> + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
> + hs_div = si570_hs_div_values[i];
> + /* Calculate lowest possible value for n1 */
> + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
> + if (!n1 || (n1 & 1))
> + n1++;
> + while (n1 <= 128) {
> + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
> + if (fdco > FDCO_MAX)
> + break;
> + if (fdco >= FDCO_MIN && fdco < best_fdco) {
> + *out_n1 = n1;
> + *out_hs_div = hs_div;
> + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
> + best_fdco = fdco;
> + }
> + n1 += (n1 == 1 ? 1 : 2);
> + }
> + }
> +
> + if (best_fdco == ULLONG_MAX)
> + return -EINVAL;
> +
> + return 0;
> +}
> +
> +static unsigned long si570_recalc_rate(struct clk_hw *hw,
> + unsigned long parent_rate)
> +{
> + int err;
> + u64 rfreq, rate;
> + unsigned int n1, hs_div;
> + struct clk_si570 *data = to_clk_si570(hw);
> +
> + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
> + if (err) {
> + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
> + return data->frequency;
> + }
> +
> + rfreq = div_u64(rfreq, hs_div * n1);
> + rate = (data->fxtal * rfreq) >> 28;
> +
> + return rate;
> +}
> +
> +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
> + unsigned long *parent_rate)
> +{
> + int err;
> + u64 rfreq;
> + unsigned int n1, hs_div;
> + struct clk_si570 *data = to_clk_si570(hw);
> +
> + if (!rate)
> + return 0;
> +
> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> + data->frequency) < 35) {
> + rfreq = div64_u64((data->rfreq * rate) +
> + div64_u64(data->frequency, 2), data->frequency);
> + n1 = data->n1;
> + hs_div = data->hs_div;
> +
> + } else {
> + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
> + if (err) {
> + dev_err(&data->i2c_client->dev,
> + "unable to round rate\n");
> + return 0;
> + }
> + }
> +
> + return rate;
> +}
> +
> +/**
> + * si570_set_frequency() - Adjust output frequency
> + * @data: Driver data structure
> + * @frequency: Target frequency
> + * Returns 0 on success.
> + *
> + * Update output frequency for big frequency changes (> 3,500 ppm).
> + */
> +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
> +{
> + int err;
> +
> + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
> + &data->hs_div);
> + if (err)
> + return err;
> +
> + /*
> + * The DCO reg should be accessed with a read-modify-write operation
> + * per AN334
> + */
> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
> + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
> + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
> + si570_update_rfreq(data);
> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
> +
> + /* Applying a new frequency can take up to 10ms */
> + usleep_range(10000, 12000);
> +
> + return 0;
> +}
> +
> +/**
> + * si570_set_frequency_small() - Adjust output frequency
> + * @data: Driver data structure
> + * @frequency: Target frequency
> + * Returns 0 on success.
> + *
> + * Update output frequency for small frequency changes (< 3,500 ppm).
> + */
> +static int si570_set_frequency_small(struct clk_si570 *data,
> + unsigned long frequency)
> +{
> + /*
> + * This is a re-implementation of DIV_ROUND_CLOSEST
> + * using the div64_u64 function lieu of letting the compiler
> + * insert EABI calls
> + */
> + data->rfreq = div64_u64((data->rfreq * frequency) +
> + div_u64(data->frequency, 2), data->frequency);
> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
> + si570_update_rfreq(data);
> + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
> +
> + /* Applying a new frequency (small change) can take up to 100us */
> + usleep_range(100, 200);
> +
> + return 0;
> +}
> +
> +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
> + unsigned long parent_rate)
> +{
> + struct clk_si570 *data = to_clk_si570(hw);
> + struct i2c_client *client = data->i2c_client;
> + int err;
> +
> + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
> + dev_err(&client->dev,
> + "requested frequency %lu Hz is out of range\n", rate);
> + return -EINVAL;
> + }
> +
> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> + data->frequency) < 35)
> + err = si570_set_frequency_small(data, rate);
> + else
> + err = si570_set_frequency(data, rate);
> +
> + if (err)
> + return err;
> +
> + data->frequency = rate;
> +
> + return 0;
> +}
> +
> +static const struct clk_ops si570_clk_ops = {
> + .recalc_rate = si570_recalc_rate,
> + .round_rate = si570_round_rate,
> + .set_rate = si570_set_rate,
> +};
> +
> +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
> +{
> + switch (reg) {
> + case SI570_REG_CONTROL:
> + return true;
> + default:
> + return false;
> + }
> +}
> +
> +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
> +{
> + switch (reg) {
> + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
> + case SI570_REG_CONTROL:
> + case SI570_REG_FREEZE_DCO:
> + return true;
> + default:
> + return false;
> + }
> +}
> +
> +static struct regmap_config si570_regmap_config = {
> + .reg_bits = 8,
> + .val_bits = 8,
> + .cache_type = REGCACHE_RBTREE,
> + .max_register = 137,
> + .writeable_reg = si570_regmap_is_writeable,
> + .volatile_reg = si570_regmap_is_volatile,
> +};
> +
> +static int si570_probe(struct i2c_client *client,
> + const struct i2c_device_id *id)
> +{
> + struct clk_si570 *data;
> + struct clk_init_data init;
> + struct clk *clk;
> + u32 initial_fout, factory_fout, stability;
> + int err;
> + enum clk_si570_variant variant = id->driver_data;
> +
> + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
> + if (!data)
> + return -ENOMEM;
> +
> + init.ops = &si570_clk_ops;
> + init.flags = CLK_IS_ROOT;
> + init.num_parents = 0;
> + data->hw.init = &init;
> + data->i2c_client = client;
> +
> + if (variant == si57x) {
> + err = of_property_read_u32(client->dev.of_node,
> + "temperature-stability", &stability);
> + if (err) {
> + dev_err(&client->dev,
> + "'temperature-stability' property missing\n");
> + return err;
> + }
> + /* adjust register offsets for 7ppm devices */
> + if (stability == 7)
> + data->div_offset = SI570_DIV_OFFSET_7PPM;
> +
> + data->max_freq = SI570_MAX_FREQ;
> + } else {
> + data->max_freq = SI598_MAX_FREQ;
> + }
> +
> + if (of_property_read_string(client->dev.of_node, "clock-output-names",
> + &init.name))
> + init.name = client->dev.of_node->name;
> +
> + err = of_property_read_u32(client->dev.of_node, "factory-fout",
> + &factory_fout);
> + if (err) {
> + dev_err(&client->dev, "'factory-fout' property missing\n");
> + return err;
> + }
> +
> + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
> + if (IS_ERR(data->regmap)) {
> + dev_err(&client->dev, "failed to allocate register map\n");
> + return PTR_ERR(data->regmap);
> + }
> +
> + i2c_set_clientdata(client, data);
> + err = si570_get_defaults(data, factory_fout);
> + if (err)
> + return err;
> +
> + clk = devm_clk_register(&client->dev, &data->hw);
> + if (IS_ERR(clk)) {
> + dev_err(&client->dev, "clock registration failed\n");
> + return PTR_ERR(clk);
> + }
> + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
> + clk);
> + if (err) {
> + dev_err(&client->dev, "unable to add clk provider\n");
> + return err;
> + }
> +
> + /* Read the requested initial output frequency from device tree */
> + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
> + &initial_fout)) {
> + err = clk_set_rate(clk, initial_fout);
> + if (err) {
> + of_clk_del_provider(client->dev.of_node);
> + return err;
> + }
> + }
> +
> + /* Display a message indicating that we've successfully registered */
> + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
> + data->frequency);
> +
> + return 0;
> +}
> +
> +static int si570_remove(struct i2c_client *client)
> +{
> + of_clk_del_provider(client->dev.of_node);
> + return 0;
> +}
> +
> +static const struct i2c_device_id si570_id[] = {
> + { "si570", si57x },
> + { "si571", si57x },
> + { "si598", si59x },
> + { "si599", si59x },
> + { }
> +};
> +MODULE_DEVICE_TABLE(i2c, si570_id);
> +
> +static const struct of_device_id clk_si570_of_match[] = {
> + { .compatible = "silabs,si570" },
> + { .compatible = "silabs,si571" },
> + { .compatible = "silabs,si598" },
> + { .compatible = "silabs,si599" },
> + { },
> +};
> +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
> +
> +static struct i2c_driver si570_driver = {
> + .driver = {
> + .name = "si570",
> + .of_match_table = of_match_ptr(clk_si570_of_match),
> + },
> + .probe = si570_probe,
> + .remove = si570_remove,
> + .id_table = si570_id,
> +};
> +module_i2c_driver(si570_driver);
> +
> +MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
> +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
> +MODULE_DESCRIPTION("Si570 driver");
> +MODULE_LICENSE("GPL");
> --
> 1.8.4
>
>
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-10-02 17:20 ` Sören Brinkmann
0 siblings, 0 replies; 27+ messages in thread
From: Sören Brinkmann @ 2013-10-02 17:20 UTC (permalink / raw)
To: Rob Herring, Pawel Moll, Mark Rutland, Stephen Warren,
Ian Campbell, Rob Landley, Mike Turquette, Grant Likely,
Guenter Roeck, Sebastian Hesselbarth, Joe Perches
Cc: devicetree, linux-doc, linux-kernel, linux-arm-kernel, Hyun Kwon
Hi Mike,
could you please comment on this/apply it to clk-next?
Thanks,
Sören
On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
> Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> The devices generate low-jitter clock signals and are reprogrammable via
> an I2C interface.
>
> Cc: Guenter Roeck <linux@roeck-us.net>
> Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
> ---
> v5:
> - fix typo in bindings documentation
> - mention the unit for the 'temperature-stability' property
> - remove calls to clk_unregister() (the device managed code takes care
> of it)
>
> v4:
> - actually check and handle error on clk_set_rate() call
>
> v3:
> - add delay in the path for small frequency changes, which can take up
> to 100us according to the data sheet
> - use real range for usleep_range() argument
> - use dev_err() over dev_warn() in set_rate()
> - add list of applicable devices for 7ppm DT prop
> - remove comments regarding platform data
> - ignore 7ppm DT prop for incompatible devices
> - replace raw numbers with #defines
> - convert DT prop 'temperature-stability' from boolean to u32
> - make 'temperature-stability' DT prop required (actually not fully
> true, for 59x it is ignored and the driver does not require its
> presence)
>
> v2:
> - document clock-output-names in bindings documentation
> - don't use wildcards in compatibility string
> - change Kconfig entry to "... 570 and compatible devices"
> - change some indentation flaws
> - use 10000 as MIN and MAX value in usleep_range
> - fail probe() if 'factory-fout' is not provided in DT
> - default factory fout #defines removed
> - use i2c driver_data instead of OF data
> - remove some related structs and data
> - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
> driver)
> - add some more details regarding the 'factory-fout' DT property
> ---
> .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
> drivers/clk/Kconfig | 10 +
> drivers/clk/Makefile | 1 +
> drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
> 4 files changed, 581 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
> create mode 100644 drivers/clk/clk-si570.c
>
> diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> new file mode 100644
> index 0000000..c09f21e
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> @@ -0,0 +1,39 @@
> +Binding for Silicon Labs 570, 571, 598 and 599 programmable
> +I2C clock generators.
> +
> +Reference
> +This binding uses the common clock binding[1]. Details about the devices can be
> +found in the data sheets[2][3].
> +
> +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
> +[2] Si570/571 Data Sheet
> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
> +[3] Si598/599 Data Sheet
> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
> +
> +Required properties:
> + - compatible: Shall be one of "silabs,si570", "silabs,si571",
> + "silabs,si598", "silabs,si599"
> + - reg: I2C device address.
> + - #clock-cells: From common clock bindings: Shall be 0.
> + - factory-fout: Factory set default frequency. This frequency is part specific.
> + The correct frequency for the part used has to be provided in
> + order to generate the correct output frequencies. For more
> + details, please refer to the data sheet.
> + - temperature-stability: Temperature stability of the device in PPM. Should be
> + one of: 7, 20, 50 or 100.
> +
> +Optional properties:
> + - clock-output-names: From common clock bindings. Recommended to be "si570".
> + - clock-frequency: Output frequency to generate. This defines the output
> + frequency set during boot. It can be reprogrammed during
> + runtime through the common clock framework.
> +
> +Example:
> + si570: clock-generator@5d {
> + #clock-cells = <0>;
> + compatible = "silabs,si570";
> + temperature-stability = <50>;
> + reg = <0x5d>;
> + factory-fout = <156250000>;
> + };
> diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
> index 279407a..349b88a 100644
> --- a/drivers/clk/Kconfig
> +++ b/drivers/clk/Kconfig
> @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
> This driver supports Silicon Labs 5351A/B/C programmable clock
> generators.
>
> +config COMMON_CLK_SI570
> + tristate "Clock driver for SiLabs 570 and compatible devices"
> + depends on I2C
> + depends on OF
> + select REGMAP_I2C
> + help
> + ---help---
> + This driver supports Silicon Labs 570/571/598/599 programmable
> + clock generators.
> +
> config COMMON_CLK_S2MPS11
> tristate "Clock driver for S2MPS11 MFD"
> depends on MFD_SEC_CORE
> diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
> index 7b11106..c0e94b3 100644
> --- a/drivers/clk/Makefile
> +++ b/drivers/clk/Makefile
> @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
> obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
> obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
> obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
> +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
> obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
> obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
> obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
> diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
> new file mode 100644
> index 0000000..5d0ac9f
> --- /dev/null
> +++ b/drivers/clk/clk-si570.c
> @@ -0,0 +1,531 @@
> +/*
> + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
> + *
> + * Copyright (C) 2010, 2011 Ericsson AB.
> + * Copyright (C) 2011 Guenter Roeck.
> + * Copyright (C) 2011 - 2013 Xilinx Inc.
> + *
> + * Author: Guenter Roeck <guenter.roeck@ericsson.com>
> + * Sören Brinkmann <soren.brinkmann@xilinx.com>
> + *
> + * This program is free software; you can redistribute it and/or modify
> + * it under the terms of the GNU General Public License as published by
> + * the Free Software Foundation; either version 2 of the License, or
> + * (at your option) any later version.
> + *
> + * This program is distributed in the hope that it will be useful,
> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
> + * GNU General Public License for more details.
> + */
> +
> +#include <linux/clk-provider.h>
> +#include <linux/delay.h>
> +#include <linux/module.h>
> +#include <linux/i2c.h>
> +#include <linux/regmap.h>
> +#include <linux/slab.h>
> +
> +/* Si570 registers */
> +#define SI570_REG_HS_N1 7
> +#define SI570_REG_N1_RFREQ0 8
> +#define SI570_REG_RFREQ1 9
> +#define SI570_REG_RFREQ2 10
> +#define SI570_REG_RFREQ3 11
> +#define SI570_REG_RFREQ4 12
> +#define SI570_REG_CONTROL 135
> +#define SI570_REG_FREEZE_DCO 137
> +#define SI570_DIV_OFFSET_7PPM 6
> +
> +#define HS_DIV_SHIFT 5
> +#define HS_DIV_MASK 0xe0
> +#define HS_DIV_OFFSET 4
> +#define N1_6_2_MASK 0x1f
> +#define N1_1_0_MASK 0xc0
> +#define RFREQ_37_32_MASK 0x3f
> +
> +#define SI570_MIN_FREQ 10000000L
> +#define SI570_MAX_FREQ 1417500000L
> +#define SI598_MAX_FREQ 525000000L
> +
> +#define FDCO_MIN 4850000000LL
> +#define FDCO_MAX 5670000000LL
> +
> +#define SI570_CNTRL_RECALL (1 << 0)
> +#define SI570_CNTRL_FREEZE_M (1 << 5)
> +#define SI570_CNTRL_NEWFREQ (1 << 6)
> +
> +#define SI570_FREEZE_DCO (1 << 4)
> +
> +/**
> + * struct clk_si570:
> + * @hw: Clock hw struct
> + * @regmap: Device's regmap
> + * @div_offset: Rgister offset for dividers
> + * @max_freq: Maximum frequency for this device
> + * @fxtal: Factory xtal frequency
> + * @n1: Clock divider N1
> + * @hs_div: Clock divider HSDIV
> + * @rfreq: Clock multiplier RFREQ
> + * @frequency: Current output frequency
> + * @i2c_client: I2C client pointer
> + */
> +struct clk_si570 {
> + struct clk_hw hw;
> + struct regmap *regmap;
> + unsigned int div_offset;
> + u64 max_freq;
> + u64 fxtal;
> + unsigned int n1;
> + unsigned int hs_div;
> + u64 rfreq;
> + u64 frequency;
> + struct i2c_client *i2c_client;
> +};
> +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
> +
> +enum clk_si570_variant {
> + si57x,
> + si59x
> +};
> +
> +/**
> + * si570_get_divs() - Read clock dividers from HW
> + * @data: Pointer to struct clk_si570
> + * @rfreq: Fractional multiplier (output)
> + * @n1: Divider N1 (output)
> + * @hs_div: Divider HSDIV (output)
> + * Returns 0 on success, negative errno otherwise.
> + *
> + * Retrieve clock dividers and multipliers from the HW.
> + */
> +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
> + unsigned int *n1, unsigned int *hs_div)
> +{
> + int err;
> + u8 reg[6];
> + u64 tmp;
> +
> + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> + reg, ARRAY_SIZE(reg));
> + if (err)
> + return err;
> +
> + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
> + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
> + /* Handle invalid cases */
> + if (*n1 > 1)
> + *n1 &= ~1;
> +
> + tmp = reg[1] & RFREQ_37_32_MASK;
> + tmp = (tmp << 8) + reg[2];
> + tmp = (tmp << 8) + reg[3];
> + tmp = (tmp << 8) + reg[4];
> + tmp = (tmp << 8) + reg[5];
> + *rfreq = tmp;
> +
> + return 0;
> +}
> +
> +/**
> + * si570_get_defaults() - Get default values
> + * @data: Driver data structure
> + * @fout: Factory frequency output
> + * Returns 0 on success, negative errno otherwise.
> + */
> +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
> +{
> + int err;
> + u64 fdco;
> +
> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
> +
> + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
> + if (err)
> + return err;
> +
> + /*
> + * Accept optional precision loss to avoid arithmetic overflows.
> + * Acceptable per Silicon Labs Application Note AN334.
> + */
> + fdco = fout * data->n1 * data->hs_div;
> + if (fdco >= (1LL << 36))
> + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
> + else
> + data->fxtal = div64_u64(fdco << 28, data->rfreq);
> +
> + data->frequency = fout;
> +
> + return 0;
> +}
> +
> +/**
> + * si570_update_rfreq() - Update clock multiplier
> + * @data: Driver data structure
> + * Passes on regmap_bulk_write() return value.
> + */
> +static int si570_update_rfreq(struct clk_si570 *data)
> +{
> + u8 reg[5];
> +
> + reg[0] = ((data->n1 - 1) << 6) |
> + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
> + reg[1] = (data->rfreq >> 24) & 0xff;
> + reg[2] = (data->rfreq >> 16) & 0xff;
> + reg[3] = (data->rfreq >> 8) & 0xff;
> + reg[4] = data->rfreq & 0xff;
> +
> + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
> + data->div_offset, reg, ARRAY_SIZE(reg));
> +}
> +
> +/**
> + * si570_calc_divs() - Caluclate clock dividers
> + * @frequency: Target frequency
> + * @data: Driver data structure
> + * @out_rfreq: RFREG fractional multiplier (output)
> + * @out_n1: Clock divider N1 (output)
> + * @out_hs_div: Clock divider HSDIV (output)
> + * Returns 0 on success, negative errno otherwise.
> + *
> + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
> + * (@out_rfreq) for a given target @frequency.
> + */
> +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
> + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
> +{
> + int i;
> + unsigned int n1, hs_div;
> + u64 fdco, best_fdco = ULLONG_MAX;
> + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
> +
> + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
> + hs_div = si570_hs_div_values[i];
> + /* Calculate lowest possible value for n1 */
> + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
> + if (!n1 || (n1 & 1))
> + n1++;
> + while (n1 <= 128) {
> + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
> + if (fdco > FDCO_MAX)
> + break;
> + if (fdco >= FDCO_MIN && fdco < best_fdco) {
> + *out_n1 = n1;
> + *out_hs_div = hs_div;
> + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
> + best_fdco = fdco;
> + }
> + n1 += (n1 == 1 ? 1 : 2);
> + }
> + }
> +
> + if (best_fdco == ULLONG_MAX)
> + return -EINVAL;
> +
> + return 0;
> +}
> +
> +static unsigned long si570_recalc_rate(struct clk_hw *hw,
> + unsigned long parent_rate)
> +{
> + int err;
> + u64 rfreq, rate;
> + unsigned int n1, hs_div;
> + struct clk_si570 *data = to_clk_si570(hw);
> +
> + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
> + if (err) {
> + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
> + return data->frequency;
> + }
> +
> + rfreq = div_u64(rfreq, hs_div * n1);
> + rate = (data->fxtal * rfreq) >> 28;
> +
> + return rate;
> +}
> +
> +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
> + unsigned long *parent_rate)
> +{
> + int err;
> + u64 rfreq;
> + unsigned int n1, hs_div;
> + struct clk_si570 *data = to_clk_si570(hw);
> +
> + if (!rate)
> + return 0;
> +
> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> + data->frequency) < 35) {
> + rfreq = div64_u64((data->rfreq * rate) +
> + div64_u64(data->frequency, 2), data->frequency);
> + n1 = data->n1;
> + hs_div = data->hs_div;
> +
> + } else {
> + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
> + if (err) {
> + dev_err(&data->i2c_client->dev,
> + "unable to round rate\n");
> + return 0;
> + }
> + }
> +
> + return rate;
> +}
> +
> +/**
> + * si570_set_frequency() - Adjust output frequency
> + * @data: Driver data structure
> + * @frequency: Target frequency
> + * Returns 0 on success.
> + *
> + * Update output frequency for big frequency changes (> 3,500 ppm).
> + */
> +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
> +{
> + int err;
> +
> + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
> + &data->hs_div);
> + if (err)
> + return err;
> +
> + /*
> + * The DCO reg should be accessed with a read-modify-write operation
> + * per AN334
> + */
> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
> + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
> + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
> + si570_update_rfreq(data);
> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
> +
> + /* Applying a new frequency can take up to 10ms */
> + usleep_range(10000, 12000);
> +
> + return 0;
> +}
> +
> +/**
> + * si570_set_frequency_small() - Adjust output frequency
> + * @data: Driver data structure
> + * @frequency: Target frequency
> + * Returns 0 on success.
> + *
> + * Update output frequency for small frequency changes (< 3,500 ppm).
> + */
> +static int si570_set_frequency_small(struct clk_si570 *data,
> + unsigned long frequency)
> +{
> + /*
> + * This is a re-implementation of DIV_ROUND_CLOSEST
> + * using the div64_u64 function lieu of letting the compiler
> + * insert EABI calls
> + */
> + data->rfreq = div64_u64((data->rfreq * frequency) +
> + div_u64(data->frequency, 2), data->frequency);
> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
> + si570_update_rfreq(data);
> + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
> +
> + /* Applying a new frequency (small change) can take up to 100us */
> + usleep_range(100, 200);
> +
> + return 0;
> +}
> +
> +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
> + unsigned long parent_rate)
> +{
> + struct clk_si570 *data = to_clk_si570(hw);
> + struct i2c_client *client = data->i2c_client;
> + int err;
> +
> + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
> + dev_err(&client->dev,
> + "requested frequency %lu Hz is out of range\n", rate);
> + return -EINVAL;
> + }
> +
> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> + data->frequency) < 35)
> + err = si570_set_frequency_small(data, rate);
> + else
> + err = si570_set_frequency(data, rate);
> +
> + if (err)
> + return err;
> +
> + data->frequency = rate;
> +
> + return 0;
> +}
> +
> +static const struct clk_ops si570_clk_ops = {
> + .recalc_rate = si570_recalc_rate,
> + .round_rate = si570_round_rate,
> + .set_rate = si570_set_rate,
> +};
> +
> +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
> +{
> + switch (reg) {
> + case SI570_REG_CONTROL:
> + return true;
> + default:
> + return false;
> + }
> +}
> +
> +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
> +{
> + switch (reg) {
> + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
> + case SI570_REG_CONTROL:
> + case SI570_REG_FREEZE_DCO:
> + return true;
> + default:
> + return false;
> + }
> +}
> +
> +static struct regmap_config si570_regmap_config = {
> + .reg_bits = 8,
> + .val_bits = 8,
> + .cache_type = REGCACHE_RBTREE,
> + .max_register = 137,
> + .writeable_reg = si570_regmap_is_writeable,
> + .volatile_reg = si570_regmap_is_volatile,
> +};
> +
> +static int si570_probe(struct i2c_client *client,
> + const struct i2c_device_id *id)
> +{
> + struct clk_si570 *data;
> + struct clk_init_data init;
> + struct clk *clk;
> + u32 initial_fout, factory_fout, stability;
> + int err;
> + enum clk_si570_variant variant = id->driver_data;
> +
> + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
> + if (!data)
> + return -ENOMEM;
> +
> + init.ops = &si570_clk_ops;
> + init.flags = CLK_IS_ROOT;
> + init.num_parents = 0;
> + data->hw.init = &init;
> + data->i2c_client = client;
> +
> + if (variant == si57x) {
> + err = of_property_read_u32(client->dev.of_node,
> + "temperature-stability", &stability);
> + if (err) {
> + dev_err(&client->dev,
> + "'temperature-stability' property missing\n");
> + return err;
> + }
> + /* adjust register offsets for 7ppm devices */
> + if (stability == 7)
> + data->div_offset = SI570_DIV_OFFSET_7PPM;
> +
> + data->max_freq = SI570_MAX_FREQ;
> + } else {
> + data->max_freq = SI598_MAX_FREQ;
> + }
> +
> + if (of_property_read_string(client->dev.of_node, "clock-output-names",
> + &init.name))
> + init.name = client->dev.of_node->name;
> +
> + err = of_property_read_u32(client->dev.of_node, "factory-fout",
> + &factory_fout);
> + if (err) {
> + dev_err(&client->dev, "'factory-fout' property missing\n");
> + return err;
> + }
> +
> + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
> + if (IS_ERR(data->regmap)) {
> + dev_err(&client->dev, "failed to allocate register map\n");
> + return PTR_ERR(data->regmap);
> + }
> +
> + i2c_set_clientdata(client, data);
> + err = si570_get_defaults(data, factory_fout);
> + if (err)
> + return err;
> +
> + clk = devm_clk_register(&client->dev, &data->hw);
> + if (IS_ERR(clk)) {
> + dev_err(&client->dev, "clock registration failed\n");
> + return PTR_ERR(clk);
> + }
> + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
> + clk);
> + if (err) {
> + dev_err(&client->dev, "unable to add clk provider\n");
> + return err;
> + }
> +
> + /* Read the requested initial output frequency from device tree */
> + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
> + &initial_fout)) {
> + err = clk_set_rate(clk, initial_fout);
> + if (err) {
> + of_clk_del_provider(client->dev.of_node);
> + return err;
> + }
> + }
> +
> + /* Display a message indicating that we've successfully registered */
> + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
> + data->frequency);
> +
> + return 0;
> +}
> +
> +static int si570_remove(struct i2c_client *client)
> +{
> + of_clk_del_provider(client->dev.of_node);
> + return 0;
> +}
> +
> +static const struct i2c_device_id si570_id[] = {
> + { "si570", si57x },
> + { "si571", si57x },
> + { "si598", si59x },
> + { "si599", si59x },
> + { }
> +};
> +MODULE_DEVICE_TABLE(i2c, si570_id);
> +
> +static const struct of_device_id clk_si570_of_match[] = {
> + { .compatible = "silabs,si570" },
> + { .compatible = "silabs,si571" },
> + { .compatible = "silabs,si598" },
> + { .compatible = "silabs,si599" },
> + { },
> +};
> +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
> +
> +static struct i2c_driver si570_driver = {
> + .driver = {
> + .name = "si570",
> + .of_match_table = of_match_ptr(clk_si570_of_match),
> + },
> + .probe = si570_probe,
> + .remove = si570_remove,
> + .id_table = si570_id,
> +};
> +module_i2c_driver(si570_driver);
> +
> +MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
> +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
> +MODULE_DESCRIPTION("Si570 driver");
> +MODULE_LICENSE("GPL");
> --
> 1.8.4
>
>
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-10-02 17:20 ` Sören Brinkmann
0 siblings, 0 replies; 27+ messages in thread
From: Sören Brinkmann @ 2013-10-02 17:20 UTC (permalink / raw)
To: linux-arm-kernel
Hi Mike,
could you please comment on this/apply it to clk-next?
Thanks,
S?ren
On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
> Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> The devices generate low-jitter clock signals and are reprogrammable via
> an I2C interface.
>
> Cc: Guenter Roeck <linux@roeck-us.net>
> Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
> ---
> v5:
> - fix typo in bindings documentation
> - mention the unit for the 'temperature-stability' property
> - remove calls to clk_unregister() (the device managed code takes care
> of it)
>
> v4:
> - actually check and handle error on clk_set_rate() call
>
> v3:
> - add delay in the path for small frequency changes, which can take up
> to 100us according to the data sheet
> - use real range for usleep_range() argument
> - use dev_err() over dev_warn() in set_rate()
> - add list of applicable devices for 7ppm DT prop
> - remove comments regarding platform data
> - ignore 7ppm DT prop for incompatible devices
> - replace raw numbers with #defines
> - convert DT prop 'temperature-stability' from boolean to u32
> - make 'temperature-stability' DT prop required (actually not fully
> true, for 59x it is ignored and the driver does not require its
> presence)
>
> v2:
> - document clock-output-names in bindings documentation
> - don't use wildcards in compatibility string
> - change Kconfig entry to "... 570 and compatible devices"
> - change some indentation flaws
> - use 10000 as MIN and MAX value in usleep_range
> - fail probe() if 'factory-fout' is not provided in DT
> - default factory fout #defines removed
> - use i2c driver_data instead of OF data
> - remove some related structs and data
> - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
> driver)
> - add some more details regarding the 'factory-fout' DT property
> ---
> .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
> drivers/clk/Kconfig | 10 +
> drivers/clk/Makefile | 1 +
> drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
> 4 files changed, 581 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
> create mode 100644 drivers/clk/clk-si570.c
>
> diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> new file mode 100644
> index 0000000..c09f21e
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> @@ -0,0 +1,39 @@
> +Binding for Silicon Labs 570, 571, 598 and 599 programmable
> +I2C clock generators.
> +
> +Reference
> +This binding uses the common clock binding[1]. Details about the devices can be
> +found in the data sheets[2][3].
> +
> +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
> +[2] Si570/571 Data Sheet
> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
> +[3] Si598/599 Data Sheet
> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
> +
> +Required properties:
> + - compatible: Shall be one of "silabs,si570", "silabs,si571",
> + "silabs,si598", "silabs,si599"
> + - reg: I2C device address.
> + - #clock-cells: From common clock bindings: Shall be 0.
> + - factory-fout: Factory set default frequency. This frequency is part specific.
> + The correct frequency for the part used has to be provided in
> + order to generate the correct output frequencies. For more
> + details, please refer to the data sheet.
> + - temperature-stability: Temperature stability of the device in PPM. Should be
> + one of: 7, 20, 50 or 100.
> +
> +Optional properties:
> + - clock-output-names: From common clock bindings. Recommended to be "si570".
> + - clock-frequency: Output frequency to generate. This defines the output
> + frequency set during boot. It can be reprogrammed during
> + runtime through the common clock framework.
> +
> +Example:
> + si570: clock-generator at 5d {
> + #clock-cells = <0>;
> + compatible = "silabs,si570";
> + temperature-stability = <50>;
> + reg = <0x5d>;
> + factory-fout = <156250000>;
> + };
> diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
> index 279407a..349b88a 100644
> --- a/drivers/clk/Kconfig
> +++ b/drivers/clk/Kconfig
> @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
> This driver supports Silicon Labs 5351A/B/C programmable clock
> generators.
>
> +config COMMON_CLK_SI570
> + tristate "Clock driver for SiLabs 570 and compatible devices"
> + depends on I2C
> + depends on OF
> + select REGMAP_I2C
> + help
> + ---help---
> + This driver supports Silicon Labs 570/571/598/599 programmable
> + clock generators.
> +
> config COMMON_CLK_S2MPS11
> tristate "Clock driver for S2MPS11 MFD"
> depends on MFD_SEC_CORE
> diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
> index 7b11106..c0e94b3 100644
> --- a/drivers/clk/Makefile
> +++ b/drivers/clk/Makefile
> @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
> obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
> obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
> obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
> +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
> obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
> obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
> obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
> diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
> new file mode 100644
> index 0000000..5d0ac9f
> --- /dev/null
> +++ b/drivers/clk/clk-si570.c
> @@ -0,0 +1,531 @@
> +/*
> + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
> + *
> + * Copyright (C) 2010, 2011 Ericsson AB.
> + * Copyright (C) 2011 Guenter Roeck.
> + * Copyright (C) 2011 - 2013 Xilinx Inc.
> + *
> + * Author: Guenter Roeck <guenter.roeck@ericsson.com>
> + * S?ren Brinkmann <soren.brinkmann@xilinx.com>
> + *
> + * This program is free software; you can redistribute it and/or modify
> + * it under the terms of the GNU General Public License as published by
> + * the Free Software Foundation; either version 2 of the License, or
> + * (at your option) any later version.
> + *
> + * This program is distributed in the hope that it will be useful,
> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
> + * GNU General Public License for more details.
> + */
> +
> +#include <linux/clk-provider.h>
> +#include <linux/delay.h>
> +#include <linux/module.h>
> +#include <linux/i2c.h>
> +#include <linux/regmap.h>
> +#include <linux/slab.h>
> +
> +/* Si570 registers */
> +#define SI570_REG_HS_N1 7
> +#define SI570_REG_N1_RFREQ0 8
> +#define SI570_REG_RFREQ1 9
> +#define SI570_REG_RFREQ2 10
> +#define SI570_REG_RFREQ3 11
> +#define SI570_REG_RFREQ4 12
> +#define SI570_REG_CONTROL 135
> +#define SI570_REG_FREEZE_DCO 137
> +#define SI570_DIV_OFFSET_7PPM 6
> +
> +#define HS_DIV_SHIFT 5
> +#define HS_DIV_MASK 0xe0
> +#define HS_DIV_OFFSET 4
> +#define N1_6_2_MASK 0x1f
> +#define N1_1_0_MASK 0xc0
> +#define RFREQ_37_32_MASK 0x3f
> +
> +#define SI570_MIN_FREQ 10000000L
> +#define SI570_MAX_FREQ 1417500000L
> +#define SI598_MAX_FREQ 525000000L
> +
> +#define FDCO_MIN 4850000000LL
> +#define FDCO_MAX 5670000000LL
> +
> +#define SI570_CNTRL_RECALL (1 << 0)
> +#define SI570_CNTRL_FREEZE_M (1 << 5)
> +#define SI570_CNTRL_NEWFREQ (1 << 6)
> +
> +#define SI570_FREEZE_DCO (1 << 4)
> +
> +/**
> + * struct clk_si570:
> + * @hw: Clock hw struct
> + * @regmap: Device's regmap
> + * @div_offset: Rgister offset for dividers
> + * @max_freq: Maximum frequency for this device
> + * @fxtal: Factory xtal frequency
> + * @n1: Clock divider N1
> + * @hs_div: Clock divider HSDIV
> + * @rfreq: Clock multiplier RFREQ
> + * @frequency: Current output frequency
> + * @i2c_client: I2C client pointer
> + */
> +struct clk_si570 {
> + struct clk_hw hw;
> + struct regmap *regmap;
> + unsigned int div_offset;
> + u64 max_freq;
> + u64 fxtal;
> + unsigned int n1;
> + unsigned int hs_div;
> + u64 rfreq;
> + u64 frequency;
> + struct i2c_client *i2c_client;
> +};
> +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
> +
> +enum clk_si570_variant {
> + si57x,
> + si59x
> +};
> +
> +/**
> + * si570_get_divs() - Read clock dividers from HW
> + * @data: Pointer to struct clk_si570
> + * @rfreq: Fractional multiplier (output)
> + * @n1: Divider N1 (output)
> + * @hs_div: Divider HSDIV (output)
> + * Returns 0 on success, negative errno otherwise.
> + *
> + * Retrieve clock dividers and multipliers from the HW.
> + */
> +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
> + unsigned int *n1, unsigned int *hs_div)
> +{
> + int err;
> + u8 reg[6];
> + u64 tmp;
> +
> + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> + reg, ARRAY_SIZE(reg));
> + if (err)
> + return err;
> +
> + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
> + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
> + /* Handle invalid cases */
> + if (*n1 > 1)
> + *n1 &= ~1;
> +
> + tmp = reg[1] & RFREQ_37_32_MASK;
> + tmp = (tmp << 8) + reg[2];
> + tmp = (tmp << 8) + reg[3];
> + tmp = (tmp << 8) + reg[4];
> + tmp = (tmp << 8) + reg[5];
> + *rfreq = tmp;
> +
> + return 0;
> +}
> +
> +/**
> + * si570_get_defaults() - Get default values
> + * @data: Driver data structure
> + * @fout: Factory frequency output
> + * Returns 0 on success, negative errno otherwise.
> + */
> +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
> +{
> + int err;
> + u64 fdco;
> +
> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
> +
> + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
> + if (err)
> + return err;
> +
> + /*
> + * Accept optional precision loss to avoid arithmetic overflows.
> + * Acceptable per Silicon Labs Application Note AN334.
> + */
> + fdco = fout * data->n1 * data->hs_div;
> + if (fdco >= (1LL << 36))
> + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
> + else
> + data->fxtal = div64_u64(fdco << 28, data->rfreq);
> +
> + data->frequency = fout;
> +
> + return 0;
> +}
> +
> +/**
> + * si570_update_rfreq() - Update clock multiplier
> + * @data: Driver data structure
> + * Passes on regmap_bulk_write() return value.
> + */
> +static int si570_update_rfreq(struct clk_si570 *data)
> +{
> + u8 reg[5];
> +
> + reg[0] = ((data->n1 - 1) << 6) |
> + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
> + reg[1] = (data->rfreq >> 24) & 0xff;
> + reg[2] = (data->rfreq >> 16) & 0xff;
> + reg[3] = (data->rfreq >> 8) & 0xff;
> + reg[4] = data->rfreq & 0xff;
> +
> + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
> + data->div_offset, reg, ARRAY_SIZE(reg));
> +}
> +
> +/**
> + * si570_calc_divs() - Caluclate clock dividers
> + * @frequency: Target frequency
> + * @data: Driver data structure
> + * @out_rfreq: RFREG fractional multiplier (output)
> + * @out_n1: Clock divider N1 (output)
> + * @out_hs_div: Clock divider HSDIV (output)
> + * Returns 0 on success, negative errno otherwise.
> + *
> + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
> + * (@out_rfreq) for a given target @frequency.
> + */
> +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
> + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
> +{
> + int i;
> + unsigned int n1, hs_div;
> + u64 fdco, best_fdco = ULLONG_MAX;
> + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
> +
> + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
> + hs_div = si570_hs_div_values[i];
> + /* Calculate lowest possible value for n1 */
> + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
> + if (!n1 || (n1 & 1))
> + n1++;
> + while (n1 <= 128) {
> + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
> + if (fdco > FDCO_MAX)
> + break;
> + if (fdco >= FDCO_MIN && fdco < best_fdco) {
> + *out_n1 = n1;
> + *out_hs_div = hs_div;
> + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
> + best_fdco = fdco;
> + }
> + n1 += (n1 == 1 ? 1 : 2);
> + }
> + }
> +
> + if (best_fdco == ULLONG_MAX)
> + return -EINVAL;
> +
> + return 0;
> +}
> +
> +static unsigned long si570_recalc_rate(struct clk_hw *hw,
> + unsigned long parent_rate)
> +{
> + int err;
> + u64 rfreq, rate;
> + unsigned int n1, hs_div;
> + struct clk_si570 *data = to_clk_si570(hw);
> +
> + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
> + if (err) {
> + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
> + return data->frequency;
> + }
> +
> + rfreq = div_u64(rfreq, hs_div * n1);
> + rate = (data->fxtal * rfreq) >> 28;
> +
> + return rate;
> +}
> +
> +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
> + unsigned long *parent_rate)
> +{
> + int err;
> + u64 rfreq;
> + unsigned int n1, hs_div;
> + struct clk_si570 *data = to_clk_si570(hw);
> +
> + if (!rate)
> + return 0;
> +
> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> + data->frequency) < 35) {
> + rfreq = div64_u64((data->rfreq * rate) +
> + div64_u64(data->frequency, 2), data->frequency);
> + n1 = data->n1;
> + hs_div = data->hs_div;
> +
> + } else {
> + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
> + if (err) {
> + dev_err(&data->i2c_client->dev,
> + "unable to round rate\n");
> + return 0;
> + }
> + }
> +
> + return rate;
> +}
> +
> +/**
> + * si570_set_frequency() - Adjust output frequency
> + * @data: Driver data structure
> + * @frequency: Target frequency
> + * Returns 0 on success.
> + *
> + * Update output frequency for big frequency changes (> 3,500 ppm).
> + */
> +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
> +{
> + int err;
> +
> + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
> + &data->hs_div);
> + if (err)
> + return err;
> +
> + /*
> + * The DCO reg should be accessed with a read-modify-write operation
> + * per AN334
> + */
> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
> + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
> + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
> + si570_update_rfreq(data);
> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
> +
> + /* Applying a new frequency can take up to 10ms */
> + usleep_range(10000, 12000);
> +
> + return 0;
> +}
> +
> +/**
> + * si570_set_frequency_small() - Adjust output frequency
> + * @data: Driver data structure
> + * @frequency: Target frequency
> + * Returns 0 on success.
> + *
> + * Update output frequency for small frequency changes (< 3,500 ppm).
> + */
> +static int si570_set_frequency_small(struct clk_si570 *data,
> + unsigned long frequency)
> +{
> + /*
> + * This is a re-implementation of DIV_ROUND_CLOSEST
> + * using the div64_u64 function lieu of letting the compiler
> + * insert EABI calls
> + */
> + data->rfreq = div64_u64((data->rfreq * frequency) +
> + div_u64(data->frequency, 2), data->frequency);
> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
> + si570_update_rfreq(data);
> + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
> +
> + /* Applying a new frequency (small change) can take up to 100us */
> + usleep_range(100, 200);
> +
> + return 0;
> +}
> +
> +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
> + unsigned long parent_rate)
> +{
> + struct clk_si570 *data = to_clk_si570(hw);
> + struct i2c_client *client = data->i2c_client;
> + int err;
> +
> + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
> + dev_err(&client->dev,
> + "requested frequency %lu Hz is out of range\n", rate);
> + return -EINVAL;
> + }
> +
> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> + data->frequency) < 35)
> + err = si570_set_frequency_small(data, rate);
> + else
> + err = si570_set_frequency(data, rate);
> +
> + if (err)
> + return err;
> +
> + data->frequency = rate;
> +
> + return 0;
> +}
> +
> +static const struct clk_ops si570_clk_ops = {
> + .recalc_rate = si570_recalc_rate,
> + .round_rate = si570_round_rate,
> + .set_rate = si570_set_rate,
> +};
> +
> +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
> +{
> + switch (reg) {
> + case SI570_REG_CONTROL:
> + return true;
> + default:
> + return false;
> + }
> +}
> +
> +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
> +{
> + switch (reg) {
> + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
> + case SI570_REG_CONTROL:
> + case SI570_REG_FREEZE_DCO:
> + return true;
> + default:
> + return false;
> + }
> +}
> +
> +static struct regmap_config si570_regmap_config = {
> + .reg_bits = 8,
> + .val_bits = 8,
> + .cache_type = REGCACHE_RBTREE,
> + .max_register = 137,
> + .writeable_reg = si570_regmap_is_writeable,
> + .volatile_reg = si570_regmap_is_volatile,
> +};
> +
> +static int si570_probe(struct i2c_client *client,
> + const struct i2c_device_id *id)
> +{
> + struct clk_si570 *data;
> + struct clk_init_data init;
> + struct clk *clk;
> + u32 initial_fout, factory_fout, stability;
> + int err;
> + enum clk_si570_variant variant = id->driver_data;
> +
> + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
> + if (!data)
> + return -ENOMEM;
> +
> + init.ops = &si570_clk_ops;
> + init.flags = CLK_IS_ROOT;
> + init.num_parents = 0;
> + data->hw.init = &init;
> + data->i2c_client = client;
> +
> + if (variant == si57x) {
> + err = of_property_read_u32(client->dev.of_node,
> + "temperature-stability", &stability);
> + if (err) {
> + dev_err(&client->dev,
> + "'temperature-stability' property missing\n");
> + return err;
> + }
> + /* adjust register offsets for 7ppm devices */
> + if (stability == 7)
> + data->div_offset = SI570_DIV_OFFSET_7PPM;
> +
> + data->max_freq = SI570_MAX_FREQ;
> + } else {
> + data->max_freq = SI598_MAX_FREQ;
> + }
> +
> + if (of_property_read_string(client->dev.of_node, "clock-output-names",
> + &init.name))
> + init.name = client->dev.of_node->name;
> +
> + err = of_property_read_u32(client->dev.of_node, "factory-fout",
> + &factory_fout);
> + if (err) {
> + dev_err(&client->dev, "'factory-fout' property missing\n");
> + return err;
> + }
> +
> + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
> + if (IS_ERR(data->regmap)) {
> + dev_err(&client->dev, "failed to allocate register map\n");
> + return PTR_ERR(data->regmap);
> + }
> +
> + i2c_set_clientdata(client, data);
> + err = si570_get_defaults(data, factory_fout);
> + if (err)
> + return err;
> +
> + clk = devm_clk_register(&client->dev, &data->hw);
> + if (IS_ERR(clk)) {
> + dev_err(&client->dev, "clock registration failed\n");
> + return PTR_ERR(clk);
> + }
> + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
> + clk);
> + if (err) {
> + dev_err(&client->dev, "unable to add clk provider\n");
> + return err;
> + }
> +
> + /* Read the requested initial output frequency from device tree */
> + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
> + &initial_fout)) {
> + err = clk_set_rate(clk, initial_fout);
> + if (err) {
> + of_clk_del_provider(client->dev.of_node);
> + return err;
> + }
> + }
> +
> + /* Display a message indicating that we've successfully registered */
> + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
> + data->frequency);
> +
> + return 0;
> +}
> +
> +static int si570_remove(struct i2c_client *client)
> +{
> + of_clk_del_provider(client->dev.of_node);
> + return 0;
> +}
> +
> +static const struct i2c_device_id si570_id[] = {
> + { "si570", si57x },
> + { "si571", si57x },
> + { "si598", si59x },
> + { "si599", si59x },
> + { }
> +};
> +MODULE_DEVICE_TABLE(i2c, si570_id);
> +
> +static const struct of_device_id clk_si570_of_match[] = {
> + { .compatible = "silabs,si570" },
> + { .compatible = "silabs,si571" },
> + { .compatible = "silabs,si598" },
> + { .compatible = "silabs,si599" },
> + { },
> +};
> +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
> +
> +static struct i2c_driver si570_driver = {
> + .driver = {
> + .name = "si570",
> + .of_match_table = of_match_ptr(clk_si570_of_match),
> + },
> + .probe = si570_probe,
> + .remove = si570_remove,
> + .id_table = si570_id,
> +};
> +module_i2c_driver(si570_driver);
> +
> +MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
> +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
> +MODULE_DESCRIPTION("Si570 driver");
> +MODULE_LICENSE("GPL");
> --
> 1.8.4
>
>
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-10-02 23:17 ` Mike Turquette
0 siblings, 0 replies; 27+ messages in thread
From: Mike Turquette @ 2013-10-02 23:17 UTC (permalink / raw)
To: Sören Brinkmann, Rob Herring, Pawel Moll, Mark Rutland,
Stephen Warren, Ian Campbell, Rob Landley, Grant Likely,
Guenter Roeck, Sebastian Hesselbarth, Joe Perches
Cc: devicetree, linux-doc, linux-kernel, linux-arm-kernel, Hyun Kwon
Quoting Sören Brinkmann (2013-10-02 10:20:38)
> Hi Mike,
>
> could you please comment on this/apply it to clk-next?
It looks good and is in the queue. Will show up in clk-next in a few
days.
Thanks,
Mike
>
> Thanks,
> Sören
>
> On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
> > Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> > The devices generate low-jitter clock signals and are reprogrammable via
> > an I2C interface.
> >
> > Cc: Guenter Roeck <linux@roeck-us.net>
> > Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
> > ---
> > v5:
> > - fix typo in bindings documentation
> > - mention the unit for the 'temperature-stability' property
> > - remove calls to clk_unregister() (the device managed code takes care
> > of it)
> >
> > v4:
> > - actually check and handle error on clk_set_rate() call
> >
> > v3:
> > - add delay in the path for small frequency changes, which can take up
> > to 100us according to the data sheet
> > - use real range for usleep_range() argument
> > - use dev_err() over dev_warn() in set_rate()
> > - add list of applicable devices for 7ppm DT prop
> > - remove comments regarding platform data
> > - ignore 7ppm DT prop for incompatible devices
> > - replace raw numbers with #defines
> > - convert DT prop 'temperature-stability' from boolean to u32
> > - make 'temperature-stability' DT prop required (actually not fully
> > true, for 59x it is ignored and the driver does not require its
> > presence)
> >
> > v2:
> > - document clock-output-names in bindings documentation
> > - don't use wildcards in compatibility string
> > - change Kconfig entry to "... 570 and compatible devices"
> > - change some indentation flaws
> > - use 10000 as MIN and MAX value in usleep_range
> > - fail probe() if 'factory-fout' is not provided in DT
> > - default factory fout #defines removed
> > - use i2c driver_data instead of OF data
> > - remove some related structs and data
> > - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
> > driver)
> > - add some more details regarding the 'factory-fout' DT property
> > ---
> > .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
> > drivers/clk/Kconfig | 10 +
> > drivers/clk/Makefile | 1 +
> > drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
> > 4 files changed, 581 insertions(+)
> > create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
> > create mode 100644 drivers/clk/clk-si570.c
> >
> > diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> > new file mode 100644
> > index 0000000..c09f21e
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> > @@ -0,0 +1,39 @@
> > +Binding for Silicon Labs 570, 571, 598 and 599 programmable
> > +I2C clock generators.
> > +
> > +Reference
> > +This binding uses the common clock binding[1]. Details about the devices can be
> > +found in the data sheets[2][3].
> > +
> > +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
> > +[2] Si570/571 Data Sheet
> > + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
> > +[3] Si598/599 Data Sheet
> > + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
> > +
> > +Required properties:
> > + - compatible: Shall be one of "silabs,si570", "silabs,si571",
> > + "silabs,si598", "silabs,si599"
> > + - reg: I2C device address.
> > + - #clock-cells: From common clock bindings: Shall be 0.
> > + - factory-fout: Factory set default frequency. This frequency is part specific.
> > + The correct frequency for the part used has to be provided in
> > + order to generate the correct output frequencies. For more
> > + details, please refer to the data sheet.
> > + - temperature-stability: Temperature stability of the device in PPM. Should be
> > + one of: 7, 20, 50 or 100.
> > +
> > +Optional properties:
> > + - clock-output-names: From common clock bindings. Recommended to be "si570".
> > + - clock-frequency: Output frequency to generate. This defines the output
> > + frequency set during boot. It can be reprogrammed during
> > + runtime through the common clock framework.
> > +
> > +Example:
> > + si570: clock-generator@5d {
> > + #clock-cells = <0>;
> > + compatible = "silabs,si570";
> > + temperature-stability = <50>;
> > + reg = <0x5d>;
> > + factory-fout = <156250000>;
> > + };
> > diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
> > index 279407a..349b88a 100644
> > --- a/drivers/clk/Kconfig
> > +++ b/drivers/clk/Kconfig
> > @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
> > This driver supports Silicon Labs 5351A/B/C programmable clock
> > generators.
> >
> > +config COMMON_CLK_SI570
> > + tristate "Clock driver for SiLabs 570 and compatible devices"
> > + depends on I2C
> > + depends on OF
> > + select REGMAP_I2C
> > + help
> > + ---help---
> > + This driver supports Silicon Labs 570/571/598/599 programmable
> > + clock generators.
> > +
> > config COMMON_CLK_S2MPS11
> > tristate "Clock driver for S2MPS11 MFD"
> > depends on MFD_SEC_CORE
> > diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
> > index 7b11106..c0e94b3 100644
> > --- a/drivers/clk/Makefile
> > +++ b/drivers/clk/Makefile
> > @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
> > obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
> > obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
> > obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
> > +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
> > obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
> > obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
> > obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
> > diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
> > new file mode 100644
> > index 0000000..5d0ac9f
> > --- /dev/null
> > +++ b/drivers/clk/clk-si570.c
> > @@ -0,0 +1,531 @@
> > +/*
> > + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
> > + *
> > + * Copyright (C) 2010, 2011 Ericsson AB.
> > + * Copyright (C) 2011 Guenter Roeck.
> > + * Copyright (C) 2011 - 2013 Xilinx Inc.
> > + *
> > + * Author: Guenter Roeck <guenter.roeck@ericsson.com>
> > + * Sören Brinkmann <soren.brinkmann@xilinx.com>
> > + *
> > + * This program is free software; you can redistribute it and/or modify
> > + * it under the terms of the GNU General Public License as published by
> > + * the Free Software Foundation; either version 2 of the License, or
> > + * (at your option) any later version.
> > + *
> > + * This program is distributed in the hope that it will be useful,
> > + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> > + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
> > + * GNU General Public License for more details.
> > + */
> > +
> > +#include <linux/clk-provider.h>
> > +#include <linux/delay.h>
> > +#include <linux/module.h>
> > +#include <linux/i2c.h>
> > +#include <linux/regmap.h>
> > +#include <linux/slab.h>
> > +
> > +/* Si570 registers */
> > +#define SI570_REG_HS_N1 7
> > +#define SI570_REG_N1_RFREQ0 8
> > +#define SI570_REG_RFREQ1 9
> > +#define SI570_REG_RFREQ2 10
> > +#define SI570_REG_RFREQ3 11
> > +#define SI570_REG_RFREQ4 12
> > +#define SI570_REG_CONTROL 135
> > +#define SI570_REG_FREEZE_DCO 137
> > +#define SI570_DIV_OFFSET_7PPM 6
> > +
> > +#define HS_DIV_SHIFT 5
> > +#define HS_DIV_MASK 0xe0
> > +#define HS_DIV_OFFSET 4
> > +#define N1_6_2_MASK 0x1f
> > +#define N1_1_0_MASK 0xc0
> > +#define RFREQ_37_32_MASK 0x3f
> > +
> > +#define SI570_MIN_FREQ 10000000L
> > +#define SI570_MAX_FREQ 1417500000L
> > +#define SI598_MAX_FREQ 525000000L
> > +
> > +#define FDCO_MIN 4850000000LL
> > +#define FDCO_MAX 5670000000LL
> > +
> > +#define SI570_CNTRL_RECALL (1 << 0)
> > +#define SI570_CNTRL_FREEZE_M (1 << 5)
> > +#define SI570_CNTRL_NEWFREQ (1 << 6)
> > +
> > +#define SI570_FREEZE_DCO (1 << 4)
> > +
> > +/**
> > + * struct clk_si570:
> > + * @hw: Clock hw struct
> > + * @regmap: Device's regmap
> > + * @div_offset: Rgister offset for dividers
> > + * @max_freq: Maximum frequency for this device
> > + * @fxtal: Factory xtal frequency
> > + * @n1: Clock divider N1
> > + * @hs_div: Clock divider HSDIV
> > + * @rfreq: Clock multiplier RFREQ
> > + * @frequency: Current output frequency
> > + * @i2c_client: I2C client pointer
> > + */
> > +struct clk_si570 {
> > + struct clk_hw hw;
> > + struct regmap *regmap;
> > + unsigned int div_offset;
> > + u64 max_freq;
> > + u64 fxtal;
> > + unsigned int n1;
> > + unsigned int hs_div;
> > + u64 rfreq;
> > + u64 frequency;
> > + struct i2c_client *i2c_client;
> > +};
> > +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
> > +
> > +enum clk_si570_variant {
> > + si57x,
> > + si59x
> > +};
> > +
> > +/**
> > + * si570_get_divs() - Read clock dividers from HW
> > + * @data: Pointer to struct clk_si570
> > + * @rfreq: Fractional multiplier (output)
> > + * @n1: Divider N1 (output)
> > + * @hs_div: Divider HSDIV (output)
> > + * Returns 0 on success, negative errno otherwise.
> > + *
> > + * Retrieve clock dividers and multipliers from the HW.
> > + */
> > +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
> > + unsigned int *n1, unsigned int *hs_div)
> > +{
> > + int err;
> > + u8 reg[6];
> > + u64 tmp;
> > +
> > + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> > + reg, ARRAY_SIZE(reg));
> > + if (err)
> > + return err;
> > +
> > + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
> > + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
> > + /* Handle invalid cases */
> > + if (*n1 > 1)
> > + *n1 &= ~1;
> > +
> > + tmp = reg[1] & RFREQ_37_32_MASK;
> > + tmp = (tmp << 8) + reg[2];
> > + tmp = (tmp << 8) + reg[3];
> > + tmp = (tmp << 8) + reg[4];
> > + tmp = (tmp << 8) + reg[5];
> > + *rfreq = tmp;
> > +
> > + return 0;
> > +}
> > +
> > +/**
> > + * si570_get_defaults() - Get default values
> > + * @data: Driver data structure
> > + * @fout: Factory frequency output
> > + * Returns 0 on success, negative errno otherwise.
> > + */
> > +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
> > +{
> > + int err;
> > + u64 fdco;
> > +
> > + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
> > +
> > + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
> > + if (err)
> > + return err;
> > +
> > + /*
> > + * Accept optional precision loss to avoid arithmetic overflows.
> > + * Acceptable per Silicon Labs Application Note AN334.
> > + */
> > + fdco = fout * data->n1 * data->hs_div;
> > + if (fdco >= (1LL << 36))
> > + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
> > + else
> > + data->fxtal = div64_u64(fdco << 28, data->rfreq);
> > +
> > + data->frequency = fout;
> > +
> > + return 0;
> > +}
> > +
> > +/**
> > + * si570_update_rfreq() - Update clock multiplier
> > + * @data: Driver data structure
> > + * Passes on regmap_bulk_write() return value.
> > + */
> > +static int si570_update_rfreq(struct clk_si570 *data)
> > +{
> > + u8 reg[5];
> > +
> > + reg[0] = ((data->n1 - 1) << 6) |
> > + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
> > + reg[1] = (data->rfreq >> 24) & 0xff;
> > + reg[2] = (data->rfreq >> 16) & 0xff;
> > + reg[3] = (data->rfreq >> 8) & 0xff;
> > + reg[4] = data->rfreq & 0xff;
> > +
> > + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
> > + data->div_offset, reg, ARRAY_SIZE(reg));
> > +}
> > +
> > +/**
> > + * si570_calc_divs() - Caluclate clock dividers
> > + * @frequency: Target frequency
> > + * @data: Driver data structure
> > + * @out_rfreq: RFREG fractional multiplier (output)
> > + * @out_n1: Clock divider N1 (output)
> > + * @out_hs_div: Clock divider HSDIV (output)
> > + * Returns 0 on success, negative errno otherwise.
> > + *
> > + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
> > + * (@out_rfreq) for a given target @frequency.
> > + */
> > +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
> > + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
> > +{
> > + int i;
> > + unsigned int n1, hs_div;
> > + u64 fdco, best_fdco = ULLONG_MAX;
> > + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
> > +
> > + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
> > + hs_div = si570_hs_div_values[i];
> > + /* Calculate lowest possible value for n1 */
> > + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
> > + if (!n1 || (n1 & 1))
> > + n1++;
> > + while (n1 <= 128) {
> > + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
> > + if (fdco > FDCO_MAX)
> > + break;
> > + if (fdco >= FDCO_MIN && fdco < best_fdco) {
> > + *out_n1 = n1;
> > + *out_hs_div = hs_div;
> > + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
> > + best_fdco = fdco;
> > + }
> > + n1 += (n1 == 1 ? 1 : 2);
> > + }
> > + }
> > +
> > + if (best_fdco == ULLONG_MAX)
> > + return -EINVAL;
> > +
> > + return 0;
> > +}
> > +
> > +static unsigned long si570_recalc_rate(struct clk_hw *hw,
> > + unsigned long parent_rate)
> > +{
> > + int err;
> > + u64 rfreq, rate;
> > + unsigned int n1, hs_div;
> > + struct clk_si570 *data = to_clk_si570(hw);
> > +
> > + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
> > + if (err) {
> > + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
> > + return data->frequency;
> > + }
> > +
> > + rfreq = div_u64(rfreq, hs_div * n1);
> > + rate = (data->fxtal * rfreq) >> 28;
> > +
> > + return rate;
> > +}
> > +
> > +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
> > + unsigned long *parent_rate)
> > +{
> > + int err;
> > + u64 rfreq;
> > + unsigned int n1, hs_div;
> > + struct clk_si570 *data = to_clk_si570(hw);
> > +
> > + if (!rate)
> > + return 0;
> > +
> > + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> > + data->frequency) < 35) {
> > + rfreq = div64_u64((data->rfreq * rate) +
> > + div64_u64(data->frequency, 2), data->frequency);
> > + n1 = data->n1;
> > + hs_div = data->hs_div;
> > +
> > + } else {
> > + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
> > + if (err) {
> > + dev_err(&data->i2c_client->dev,
> > + "unable to round rate\n");
> > + return 0;
> > + }
> > + }
> > +
> > + return rate;
> > +}
> > +
> > +/**
> > + * si570_set_frequency() - Adjust output frequency
> > + * @data: Driver data structure
> > + * @frequency: Target frequency
> > + * Returns 0 on success.
> > + *
> > + * Update output frequency for big frequency changes (> 3,500 ppm).
> > + */
> > +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
> > +{
> > + int err;
> > +
> > + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
> > + &data->hs_div);
> > + if (err)
> > + return err;
> > +
> > + /*
> > + * The DCO reg should be accessed with a read-modify-write operation
> > + * per AN334
> > + */
> > + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
> > + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> > + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
> > + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
> > + si570_update_rfreq(data);
> > + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
> > + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
> > +
> > + /* Applying a new frequency can take up to 10ms */
> > + usleep_range(10000, 12000);
> > +
> > + return 0;
> > +}
> > +
> > +/**
> > + * si570_set_frequency_small() - Adjust output frequency
> > + * @data: Driver data structure
> > + * @frequency: Target frequency
> > + * Returns 0 on success.
> > + *
> > + * Update output frequency for small frequency changes (< 3,500 ppm).
> > + */
> > +static int si570_set_frequency_small(struct clk_si570 *data,
> > + unsigned long frequency)
> > +{
> > + /*
> > + * This is a re-implementation of DIV_ROUND_CLOSEST
> > + * using the div64_u64 function lieu of letting the compiler
> > + * insert EABI calls
> > + */
> > + data->rfreq = div64_u64((data->rfreq * frequency) +
> > + div_u64(data->frequency, 2), data->frequency);
> > + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
> > + si570_update_rfreq(data);
> > + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
> > +
> > + /* Applying a new frequency (small change) can take up to 100us */
> > + usleep_range(100, 200);
> > +
> > + return 0;
> > +}
> > +
> > +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
> > + unsigned long parent_rate)
> > +{
> > + struct clk_si570 *data = to_clk_si570(hw);
> > + struct i2c_client *client = data->i2c_client;
> > + int err;
> > +
> > + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
> > + dev_err(&client->dev,
> > + "requested frequency %lu Hz is out of range\n", rate);
> > + return -EINVAL;
> > + }
> > +
> > + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> > + data->frequency) < 35)
> > + err = si570_set_frequency_small(data, rate);
> > + else
> > + err = si570_set_frequency(data, rate);
> > +
> > + if (err)
> > + return err;
> > +
> > + data->frequency = rate;
> > +
> > + return 0;
> > +}
> > +
> > +static const struct clk_ops si570_clk_ops = {
> > + .recalc_rate = si570_recalc_rate,
> > + .round_rate = si570_round_rate,
> > + .set_rate = si570_set_rate,
> > +};
> > +
> > +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
> > +{
> > + switch (reg) {
> > + case SI570_REG_CONTROL:
> > + return true;
> > + default:
> > + return false;
> > + }
> > +}
> > +
> > +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
> > +{
> > + switch (reg) {
> > + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
> > + case SI570_REG_CONTROL:
> > + case SI570_REG_FREEZE_DCO:
> > + return true;
> > + default:
> > + return false;
> > + }
> > +}
> > +
> > +static struct regmap_config si570_regmap_config = {
> > + .reg_bits = 8,
> > + .val_bits = 8,
> > + .cache_type = REGCACHE_RBTREE,
> > + .max_register = 137,
> > + .writeable_reg = si570_regmap_is_writeable,
> > + .volatile_reg = si570_regmap_is_volatile,
> > +};
> > +
> > +static int si570_probe(struct i2c_client *client,
> > + const struct i2c_device_id *id)
> > +{
> > + struct clk_si570 *data;
> > + struct clk_init_data init;
> > + struct clk *clk;
> > + u32 initial_fout, factory_fout, stability;
> > + int err;
> > + enum clk_si570_variant variant = id->driver_data;
> > +
> > + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
> > + if (!data)
> > + return -ENOMEM;
> > +
> > + init.ops = &si570_clk_ops;
> > + init.flags = CLK_IS_ROOT;
> > + init.num_parents = 0;
> > + data->hw.init = &init;
> > + data->i2c_client = client;
> > +
> > + if (variant == si57x) {
> > + err = of_property_read_u32(client->dev.of_node,
> > + "temperature-stability", &stability);
> > + if (err) {
> > + dev_err(&client->dev,
> > + "'temperature-stability' property missing\n");
> > + return err;
> > + }
> > + /* adjust register offsets for 7ppm devices */
> > + if (stability == 7)
> > + data->div_offset = SI570_DIV_OFFSET_7PPM;
> > +
> > + data->max_freq = SI570_MAX_FREQ;
> > + } else {
> > + data->max_freq = SI598_MAX_FREQ;
> > + }
> > +
> > + if (of_property_read_string(client->dev.of_node, "clock-output-names",
> > + &init.name))
> > + init.name = client->dev.of_node->name;
> > +
> > + err = of_property_read_u32(client->dev.of_node, "factory-fout",
> > + &factory_fout);
> > + if (err) {
> > + dev_err(&client->dev, "'factory-fout' property missing\n");
> > + return err;
> > + }
> > +
> > + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
> > + if (IS_ERR(data->regmap)) {
> > + dev_err(&client->dev, "failed to allocate register map\n");
> > + return PTR_ERR(data->regmap);
> > + }
> > +
> > + i2c_set_clientdata(client, data);
> > + err = si570_get_defaults(data, factory_fout);
> > + if (err)
> > + return err;
> > +
> > + clk = devm_clk_register(&client->dev, &data->hw);
> > + if (IS_ERR(clk)) {
> > + dev_err(&client->dev, "clock registration failed\n");
> > + return PTR_ERR(clk);
> > + }
> > + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
> > + clk);
> > + if (err) {
> > + dev_err(&client->dev, "unable to add clk provider\n");
> > + return err;
> > + }
> > +
> > + /* Read the requested initial output frequency from device tree */
> > + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
> > + &initial_fout)) {
> > + err = clk_set_rate(clk, initial_fout);
> > + if (err) {
> > + of_clk_del_provider(client->dev.of_node);
> > + return err;
> > + }
> > + }
> > +
> > + /* Display a message indicating that we've successfully registered */
> > + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
> > + data->frequency);
> > +
> > + return 0;
> > +}
> > +
> > +static int si570_remove(struct i2c_client *client)
> > +{
> > + of_clk_del_provider(client->dev.of_node);
> > + return 0;
> > +}
> > +
> > +static const struct i2c_device_id si570_id[] = {
> > + { "si570", si57x },
> > + { "si571", si57x },
> > + { "si598", si59x },
> > + { "si599", si59x },
> > + { }
> > +};
> > +MODULE_DEVICE_TABLE(i2c, si570_id);
> > +
> > +static const struct of_device_id clk_si570_of_match[] = {
> > + { .compatible = "silabs,si570" },
> > + { .compatible = "silabs,si571" },
> > + { .compatible = "silabs,si598" },
> > + { .compatible = "silabs,si599" },
> > + { },
> > +};
> > +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
> > +
> > +static struct i2c_driver si570_driver = {
> > + .driver = {
> > + .name = "si570",
> > + .of_match_table = of_match_ptr(clk_si570_of_match),
> > + },
> > + .probe = si570_probe,
> > + .remove = si570_remove,
> > + .id_table = si570_id,
> > +};
> > +module_i2c_driver(si570_driver);
> > +
> > +MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
> > +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
> > +MODULE_DESCRIPTION("Si570 driver");
> > +MODULE_LICENSE("GPL");
> > --
> > 1.8.4
> >
> >
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-10-02 23:17 ` Mike Turquette
0 siblings, 0 replies; 27+ messages in thread
From: Mike Turquette @ 2013-10-02 23:17 UTC (permalink / raw)
To: Sören Brinkmann, Rob Herring, Pawel Moll, Mark Rutland,
Stephen Warren, Ian Campbell, Rob Landley, Grant Likely,
Guenter Roeck, Sebastian Hesselbarth, Joe Perches
Cc: devicetree-u79uwXL29TY76Z2rM5mHXA,
linux-doc-u79uwXL29TY76Z2rM5mHXA,
linux-kernel-u79uwXL29TY76Z2rM5mHXA,
linux-arm-kernel-IAPFreCvJWM7uuMidbF8XUB+6BGkLq7r, Hyun Kwon
Quoting Sören Brinkmann (2013-10-02 10:20:38)
> Hi Mike,
>
> could you please comment on this/apply it to clk-next?
It looks good and is in the queue. Will show up in clk-next in a few
days.
Thanks,
Mike
>
> Thanks,
> Sören
>
> On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
> > Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> > The devices generate low-jitter clock signals and are reprogrammable via
> > an I2C interface.
> >
> > Cc: Guenter Roeck <linux-0h96xk9xTtrk1uMJSBkQmQ@public.gmane.org>
> > Signed-off-by: Soren Brinkmann <soren.brinkmann-gjFFaj9aHVfQT0dZR+AlfA@public.gmane.org>
> > ---
> > v5:
> > - fix typo in bindings documentation
> > - mention the unit for the 'temperature-stability' property
> > - remove calls to clk_unregister() (the device managed code takes care
> > of it)
> >
> > v4:
> > - actually check and handle error on clk_set_rate() call
> >
> > v3:
> > - add delay in the path for small frequency changes, which can take up
> > to 100us according to the data sheet
> > - use real range for usleep_range() argument
> > - use dev_err() over dev_warn() in set_rate()
> > - add list of applicable devices for 7ppm DT prop
> > - remove comments regarding platform data
> > - ignore 7ppm DT prop for incompatible devices
> > - replace raw numbers with #defines
> > - convert DT prop 'temperature-stability' from boolean to u32
> > - make 'temperature-stability' DT prop required (actually not fully
> > true, for 59x it is ignored and the driver does not require its
> > presence)
> >
> > v2:
> > - document clock-output-names in bindings documentation
> > - don't use wildcards in compatibility string
> > - change Kconfig entry to "... 570 and compatible devices"
> > - change some indentation flaws
> > - use 10000 as MIN and MAX value in usleep_range
> > - fail probe() if 'factory-fout' is not provided in DT
> > - default factory fout #defines removed
> > - use i2c driver_data instead of OF data
> > - remove some related structs and data
> > - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
> > driver)
> > - add some more details regarding the 'factory-fout' DT property
> > ---
> > .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
> > drivers/clk/Kconfig | 10 +
> > drivers/clk/Makefile | 1 +
> > drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
> > 4 files changed, 581 insertions(+)
> > create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
> > create mode 100644 drivers/clk/clk-si570.c
> >
> > diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> > new file mode 100644
> > index 0000000..c09f21e
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> > @@ -0,0 +1,39 @@
> > +Binding for Silicon Labs 570, 571, 598 and 599 programmable
> > +I2C clock generators.
> > +
> > +Reference
> > +This binding uses the common clock binding[1]. Details about the devices can be
> > +found in the data sheets[2][3].
> > +
> > +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
> > +[2] Si570/571 Data Sheet
> > + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
> > +[3] Si598/599 Data Sheet
> > + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
> > +
> > +Required properties:
> > + - compatible: Shall be one of "silabs,si570", "silabs,si571",
> > + "silabs,si598", "silabs,si599"
> > + - reg: I2C device address.
> > + - #clock-cells: From common clock bindings: Shall be 0.
> > + - factory-fout: Factory set default frequency. This frequency is part specific.
> > + The correct frequency for the part used has to be provided in
> > + order to generate the correct output frequencies. For more
> > + details, please refer to the data sheet.
> > + - temperature-stability: Temperature stability of the device in PPM. Should be
> > + one of: 7, 20, 50 or 100.
> > +
> > +Optional properties:
> > + - clock-output-names: From common clock bindings. Recommended to be "si570".
> > + - clock-frequency: Output frequency to generate. This defines the output
> > + frequency set during boot. It can be reprogrammed during
> > + runtime through the common clock framework.
> > +
> > +Example:
> > + si570: clock-generator@5d {
> > + #clock-cells = <0>;
> > + compatible = "silabs,si570";
> > + temperature-stability = <50>;
> > + reg = <0x5d>;
> > + factory-fout = <156250000>;
> > + };
> > diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
> > index 279407a..349b88a 100644
> > --- a/drivers/clk/Kconfig
> > +++ b/drivers/clk/Kconfig
> > @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
> > This driver supports Silicon Labs 5351A/B/C programmable clock
> > generators.
> >
> > +config COMMON_CLK_SI570
> > + tristate "Clock driver for SiLabs 570 and compatible devices"
> > + depends on I2C
> > + depends on OF
> > + select REGMAP_I2C
> > + help
> > + ---help---
> > + This driver supports Silicon Labs 570/571/598/599 programmable
> > + clock generators.
> > +
> > config COMMON_CLK_S2MPS11
> > tristate "Clock driver for S2MPS11 MFD"
> > depends on MFD_SEC_CORE
> > diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
> > index 7b11106..c0e94b3 100644
> > --- a/drivers/clk/Makefile
> > +++ b/drivers/clk/Makefile
> > @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
> > obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
> > obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
> > obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
> > +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
> > obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
> > obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
> > obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
> > diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
> > new file mode 100644
> > index 0000000..5d0ac9f
> > --- /dev/null
> > +++ b/drivers/clk/clk-si570.c
> > @@ -0,0 +1,531 @@
> > +/*
> > + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
> > + *
> > + * Copyright (C) 2010, 2011 Ericsson AB.
> > + * Copyright (C) 2011 Guenter Roeck.
> > + * Copyright (C) 2011 - 2013 Xilinx Inc.
> > + *
> > + * Author: Guenter Roeck <guenter.roeck-IzeFyvvaP7pWk0Htik3J/w@public.gmane.org>
> > + * Sören Brinkmann <soren.brinkmann-gjFFaj9aHVfQT0dZR+AlfA@public.gmane.org>
> > + *
> > + * This program is free software; you can redistribute it and/or modify
> > + * it under the terms of the GNU General Public License as published by
> > + * the Free Software Foundation; either version 2 of the License, or
> > + * (at your option) any later version.
> > + *
> > + * This program is distributed in the hope that it will be useful,
> > + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> > + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
> > + * GNU General Public License for more details.
> > + */
> > +
> > +#include <linux/clk-provider.h>
> > +#include <linux/delay.h>
> > +#include <linux/module.h>
> > +#include <linux/i2c.h>
> > +#include <linux/regmap.h>
> > +#include <linux/slab.h>
> > +
> > +/* Si570 registers */
> > +#define SI570_REG_HS_N1 7
> > +#define SI570_REG_N1_RFREQ0 8
> > +#define SI570_REG_RFREQ1 9
> > +#define SI570_REG_RFREQ2 10
> > +#define SI570_REG_RFREQ3 11
> > +#define SI570_REG_RFREQ4 12
> > +#define SI570_REG_CONTROL 135
> > +#define SI570_REG_FREEZE_DCO 137
> > +#define SI570_DIV_OFFSET_7PPM 6
> > +
> > +#define HS_DIV_SHIFT 5
> > +#define HS_DIV_MASK 0xe0
> > +#define HS_DIV_OFFSET 4
> > +#define N1_6_2_MASK 0x1f
> > +#define N1_1_0_MASK 0xc0
> > +#define RFREQ_37_32_MASK 0x3f
> > +
> > +#define SI570_MIN_FREQ 10000000L
> > +#define SI570_MAX_FREQ 1417500000L
> > +#define SI598_MAX_FREQ 525000000L
> > +
> > +#define FDCO_MIN 4850000000LL
> > +#define FDCO_MAX 5670000000LL
> > +
> > +#define SI570_CNTRL_RECALL (1 << 0)
> > +#define SI570_CNTRL_FREEZE_M (1 << 5)
> > +#define SI570_CNTRL_NEWFREQ (1 << 6)
> > +
> > +#define SI570_FREEZE_DCO (1 << 4)
> > +
> > +/**
> > + * struct clk_si570:
> > + * @hw: Clock hw struct
> > + * @regmap: Device's regmap
> > + * @div_offset: Rgister offset for dividers
> > + * @max_freq: Maximum frequency for this device
> > + * @fxtal: Factory xtal frequency
> > + * @n1: Clock divider N1
> > + * @hs_div: Clock divider HSDIV
> > + * @rfreq: Clock multiplier RFREQ
> > + * @frequency: Current output frequency
> > + * @i2c_client: I2C client pointer
> > + */
> > +struct clk_si570 {
> > + struct clk_hw hw;
> > + struct regmap *regmap;
> > + unsigned int div_offset;
> > + u64 max_freq;
> > + u64 fxtal;
> > + unsigned int n1;
> > + unsigned int hs_div;
> > + u64 rfreq;
> > + u64 frequency;
> > + struct i2c_client *i2c_client;
> > +};
> > +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
> > +
> > +enum clk_si570_variant {
> > + si57x,
> > + si59x
> > +};
> > +
> > +/**
> > + * si570_get_divs() - Read clock dividers from HW
> > + * @data: Pointer to struct clk_si570
> > + * @rfreq: Fractional multiplier (output)
> > + * @n1: Divider N1 (output)
> > + * @hs_div: Divider HSDIV (output)
> > + * Returns 0 on success, negative errno otherwise.
> > + *
> > + * Retrieve clock dividers and multipliers from the HW.
> > + */
> > +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
> > + unsigned int *n1, unsigned int *hs_div)
> > +{
> > + int err;
> > + u8 reg[6];
> > + u64 tmp;
> > +
> > + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> > + reg, ARRAY_SIZE(reg));
> > + if (err)
> > + return err;
> > +
> > + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
> > + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
> > + /* Handle invalid cases */
> > + if (*n1 > 1)
> > + *n1 &= ~1;
> > +
> > + tmp = reg[1] & RFREQ_37_32_MASK;
> > + tmp = (tmp << 8) + reg[2];
> > + tmp = (tmp << 8) + reg[3];
> > + tmp = (tmp << 8) + reg[4];
> > + tmp = (tmp << 8) + reg[5];
> > + *rfreq = tmp;
> > +
> > + return 0;
> > +}
> > +
> > +/**
> > + * si570_get_defaults() - Get default values
> > + * @data: Driver data structure
> > + * @fout: Factory frequency output
> > + * Returns 0 on success, negative errno otherwise.
> > + */
> > +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
> > +{
> > + int err;
> > + u64 fdco;
> > +
> > + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
> > +
> > + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
> > + if (err)
> > + return err;
> > +
> > + /*
> > + * Accept optional precision loss to avoid arithmetic overflows.
> > + * Acceptable per Silicon Labs Application Note AN334.
> > + */
> > + fdco = fout * data->n1 * data->hs_div;
> > + if (fdco >= (1LL << 36))
> > + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
> > + else
> > + data->fxtal = div64_u64(fdco << 28, data->rfreq);
> > +
> > + data->frequency = fout;
> > +
> > + return 0;
> > +}
> > +
> > +/**
> > + * si570_update_rfreq() - Update clock multiplier
> > + * @data: Driver data structure
> > + * Passes on regmap_bulk_write() return value.
> > + */
> > +static int si570_update_rfreq(struct clk_si570 *data)
> > +{
> > + u8 reg[5];
> > +
> > + reg[0] = ((data->n1 - 1) << 6) |
> > + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
> > + reg[1] = (data->rfreq >> 24) & 0xff;
> > + reg[2] = (data->rfreq >> 16) & 0xff;
> > + reg[3] = (data->rfreq >> 8) & 0xff;
> > + reg[4] = data->rfreq & 0xff;
> > +
> > + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
> > + data->div_offset, reg, ARRAY_SIZE(reg));
> > +}
> > +
> > +/**
> > + * si570_calc_divs() - Caluclate clock dividers
> > + * @frequency: Target frequency
> > + * @data: Driver data structure
> > + * @out_rfreq: RFREG fractional multiplier (output)
> > + * @out_n1: Clock divider N1 (output)
> > + * @out_hs_div: Clock divider HSDIV (output)
> > + * Returns 0 on success, negative errno otherwise.
> > + *
> > + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
> > + * (@out_rfreq) for a given target @frequency.
> > + */
> > +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
> > + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
> > +{
> > + int i;
> > + unsigned int n1, hs_div;
> > + u64 fdco, best_fdco = ULLONG_MAX;
> > + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
> > +
> > + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
> > + hs_div = si570_hs_div_values[i];
> > + /* Calculate lowest possible value for n1 */
> > + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
> > + if (!n1 || (n1 & 1))
> > + n1++;
> > + while (n1 <= 128) {
> > + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
> > + if (fdco > FDCO_MAX)
> > + break;
> > + if (fdco >= FDCO_MIN && fdco < best_fdco) {
> > + *out_n1 = n1;
> > + *out_hs_div = hs_div;
> > + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
> > + best_fdco = fdco;
> > + }
> > + n1 += (n1 == 1 ? 1 : 2);
> > + }
> > + }
> > +
> > + if (best_fdco == ULLONG_MAX)
> > + return -EINVAL;
> > +
> > + return 0;
> > +}
> > +
> > +static unsigned long si570_recalc_rate(struct clk_hw *hw,
> > + unsigned long parent_rate)
> > +{
> > + int err;
> > + u64 rfreq, rate;
> > + unsigned int n1, hs_div;
> > + struct clk_si570 *data = to_clk_si570(hw);
> > +
> > + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
> > + if (err) {
> > + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
> > + return data->frequency;
> > + }
> > +
> > + rfreq = div_u64(rfreq, hs_div * n1);
> > + rate = (data->fxtal * rfreq) >> 28;
> > +
> > + return rate;
> > +}
> > +
> > +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
> > + unsigned long *parent_rate)
> > +{
> > + int err;
> > + u64 rfreq;
> > + unsigned int n1, hs_div;
> > + struct clk_si570 *data = to_clk_si570(hw);
> > +
> > + if (!rate)
> > + return 0;
> > +
> > + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> > + data->frequency) < 35) {
> > + rfreq = div64_u64((data->rfreq * rate) +
> > + div64_u64(data->frequency, 2), data->frequency);
> > + n1 = data->n1;
> > + hs_div = data->hs_div;
> > +
> > + } else {
> > + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
> > + if (err) {
> > + dev_err(&data->i2c_client->dev,
> > + "unable to round rate\n");
> > + return 0;
> > + }
> > + }
> > +
> > + return rate;
> > +}
> > +
> > +/**
> > + * si570_set_frequency() - Adjust output frequency
> > + * @data: Driver data structure
> > + * @frequency: Target frequency
> > + * Returns 0 on success.
> > + *
> > + * Update output frequency for big frequency changes (> 3,500 ppm).
> > + */
> > +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
> > +{
> > + int err;
> > +
> > + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
> > + &data->hs_div);
> > + if (err)
> > + return err;
> > +
> > + /*
> > + * The DCO reg should be accessed with a read-modify-write operation
> > + * per AN334
> > + */
> > + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
> > + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> > + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
> > + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
> > + si570_update_rfreq(data);
> > + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
> > + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
> > +
> > + /* Applying a new frequency can take up to 10ms */
> > + usleep_range(10000, 12000);
> > +
> > + return 0;
> > +}
> > +
> > +/**
> > + * si570_set_frequency_small() - Adjust output frequency
> > + * @data: Driver data structure
> > + * @frequency: Target frequency
> > + * Returns 0 on success.
> > + *
> > + * Update output frequency for small frequency changes (< 3,500 ppm).
> > + */
> > +static int si570_set_frequency_small(struct clk_si570 *data,
> > + unsigned long frequency)
> > +{
> > + /*
> > + * This is a re-implementation of DIV_ROUND_CLOSEST
> > + * using the div64_u64 function lieu of letting the compiler
> > + * insert EABI calls
> > + */
> > + data->rfreq = div64_u64((data->rfreq * frequency) +
> > + div_u64(data->frequency, 2), data->frequency);
> > + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
> > + si570_update_rfreq(data);
> > + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
> > +
> > + /* Applying a new frequency (small change) can take up to 100us */
> > + usleep_range(100, 200);
> > +
> > + return 0;
> > +}
> > +
> > +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
> > + unsigned long parent_rate)
> > +{
> > + struct clk_si570 *data = to_clk_si570(hw);
> > + struct i2c_client *client = data->i2c_client;
> > + int err;
> > +
> > + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
> > + dev_err(&client->dev,
> > + "requested frequency %lu Hz is out of range\n", rate);
> > + return -EINVAL;
> > + }
> > +
> > + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> > + data->frequency) < 35)
> > + err = si570_set_frequency_small(data, rate);
> > + else
> > + err = si570_set_frequency(data, rate);
> > +
> > + if (err)
> > + return err;
> > +
> > + data->frequency = rate;
> > +
> > + return 0;
> > +}
> > +
> > +static const struct clk_ops si570_clk_ops = {
> > + .recalc_rate = si570_recalc_rate,
> > + .round_rate = si570_round_rate,
> > + .set_rate = si570_set_rate,
> > +};
> > +
> > +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
> > +{
> > + switch (reg) {
> > + case SI570_REG_CONTROL:
> > + return true;
> > + default:
> > + return false;
> > + }
> > +}
> > +
> > +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
> > +{
> > + switch (reg) {
> > + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
> > + case SI570_REG_CONTROL:
> > + case SI570_REG_FREEZE_DCO:
> > + return true;
> > + default:
> > + return false;
> > + }
> > +}
> > +
> > +static struct regmap_config si570_regmap_config = {
> > + .reg_bits = 8,
> > + .val_bits = 8,
> > + .cache_type = REGCACHE_RBTREE,
> > + .max_register = 137,
> > + .writeable_reg = si570_regmap_is_writeable,
> > + .volatile_reg = si570_regmap_is_volatile,
> > +};
> > +
> > +static int si570_probe(struct i2c_client *client,
> > + const struct i2c_device_id *id)
> > +{
> > + struct clk_si570 *data;
> > + struct clk_init_data init;
> > + struct clk *clk;
> > + u32 initial_fout, factory_fout, stability;
> > + int err;
> > + enum clk_si570_variant variant = id->driver_data;
> > +
> > + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
> > + if (!data)
> > + return -ENOMEM;
> > +
> > + init.ops = &si570_clk_ops;
> > + init.flags = CLK_IS_ROOT;
> > + init.num_parents = 0;
> > + data->hw.init = &init;
> > + data->i2c_client = client;
> > +
> > + if (variant == si57x) {
> > + err = of_property_read_u32(client->dev.of_node,
> > + "temperature-stability", &stability);
> > + if (err) {
> > + dev_err(&client->dev,
> > + "'temperature-stability' property missing\n");
> > + return err;
> > + }
> > + /* adjust register offsets for 7ppm devices */
> > + if (stability == 7)
> > + data->div_offset = SI570_DIV_OFFSET_7PPM;
> > +
> > + data->max_freq = SI570_MAX_FREQ;
> > + } else {
> > + data->max_freq = SI598_MAX_FREQ;
> > + }
> > +
> > + if (of_property_read_string(client->dev.of_node, "clock-output-names",
> > + &init.name))
> > + init.name = client->dev.of_node->name;
> > +
> > + err = of_property_read_u32(client->dev.of_node, "factory-fout",
> > + &factory_fout);
> > + if (err) {
> > + dev_err(&client->dev, "'factory-fout' property missing\n");
> > + return err;
> > + }
> > +
> > + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
> > + if (IS_ERR(data->regmap)) {
> > + dev_err(&client->dev, "failed to allocate register map\n");
> > + return PTR_ERR(data->regmap);
> > + }
> > +
> > + i2c_set_clientdata(client, data);
> > + err = si570_get_defaults(data, factory_fout);
> > + if (err)
> > + return err;
> > +
> > + clk = devm_clk_register(&client->dev, &data->hw);
> > + if (IS_ERR(clk)) {
> > + dev_err(&client->dev, "clock registration failed\n");
> > + return PTR_ERR(clk);
> > + }
> > + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
> > + clk);
> > + if (err) {
> > + dev_err(&client->dev, "unable to add clk provider\n");
> > + return err;
> > + }
> > +
> > + /* Read the requested initial output frequency from device tree */
> > + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
> > + &initial_fout)) {
> > + err = clk_set_rate(clk, initial_fout);
> > + if (err) {
> > + of_clk_del_provider(client->dev.of_node);
> > + return err;
> > + }
> > + }
> > +
> > + /* Display a message indicating that we've successfully registered */
> > + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
> > + data->frequency);
> > +
> > + return 0;
> > +}
> > +
> > +static int si570_remove(struct i2c_client *client)
> > +{
> > + of_clk_del_provider(client->dev.of_node);
> > + return 0;
> > +}
> > +
> > +static const struct i2c_device_id si570_id[] = {
> > + { "si570", si57x },
> > + { "si571", si57x },
> > + { "si598", si59x },
> > + { "si599", si59x },
> > + { }
> > +};
> > +MODULE_DEVICE_TABLE(i2c, si570_id);
> > +
> > +static const struct of_device_id clk_si570_of_match[] = {
> > + { .compatible = "silabs,si570" },
> > + { .compatible = "silabs,si571" },
> > + { .compatible = "silabs,si598" },
> > + { .compatible = "silabs,si599" },
> > + { },
> > +};
> > +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
> > +
> > +static struct i2c_driver si570_driver = {
> > + .driver = {
> > + .name = "si570",
> > + .of_match_table = of_match_ptr(clk_si570_of_match),
> > + },
> > + .probe = si570_probe,
> > + .remove = si570_remove,
> > + .id_table = si570_id,
> > +};
> > +module_i2c_driver(si570_driver);
> > +
> > +MODULE_AUTHOR("Guenter Roeck <guenter.roeck-IzeFyvvaP7pWk0Htik3J/w@public.gmane.org>");
> > +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann-gjFFaj9aHVfQT0dZR+AlfA@public.gmane.org");
> > +MODULE_DESCRIPTION("Si570 driver");
> > +MODULE_LICENSE("GPL");
> > --
> > 1.8.4
> >
> >
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-10-02 23:17 ` Mike Turquette
0 siblings, 0 replies; 27+ messages in thread
From: Mike Turquette @ 2013-10-02 23:17 UTC (permalink / raw)
To: linux-arm-kernel
Quoting S?ren Brinkmann (2013-10-02 10:20:38)
> Hi Mike,
>
> could you please comment on this/apply it to clk-next?
It looks good and is in the queue. Will show up in clk-next in a few
days.
Thanks,
Mike
>
> Thanks,
> S?ren
>
> On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
> > Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> > The devices generate low-jitter clock signals and are reprogrammable via
> > an I2C interface.
> >
> > Cc: Guenter Roeck <linux@roeck-us.net>
> > Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
> > ---
> > v5:
> > - fix typo in bindings documentation
> > - mention the unit for the 'temperature-stability' property
> > - remove calls to clk_unregister() (the device managed code takes care
> > of it)
> >
> > v4:
> > - actually check and handle error on clk_set_rate() call
> >
> > v3:
> > - add delay in the path for small frequency changes, which can take up
> > to 100us according to the data sheet
> > - use real range for usleep_range() argument
> > - use dev_err() over dev_warn() in set_rate()
> > - add list of applicable devices for 7ppm DT prop
> > - remove comments regarding platform data
> > - ignore 7ppm DT prop for incompatible devices
> > - replace raw numbers with #defines
> > - convert DT prop 'temperature-stability' from boolean to u32
> > - make 'temperature-stability' DT prop required (actually not fully
> > true, for 59x it is ignored and the driver does not require its
> > presence)
> >
> > v2:
> > - document clock-output-names in bindings documentation
> > - don't use wildcards in compatibility string
> > - change Kconfig entry to "... 570 and compatible devices"
> > - change some indentation flaws
> > - use 10000 as MIN and MAX value in usleep_range
> > - fail probe() if 'factory-fout' is not provided in DT
> > - default factory fout #defines removed
> > - use i2c driver_data instead of OF data
> > - remove some related structs and data
> > - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
> > driver)
> > - add some more details regarding the 'factory-fout' DT property
> > ---
> > .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
> > drivers/clk/Kconfig | 10 +
> > drivers/clk/Makefile | 1 +
> > drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
> > 4 files changed, 581 insertions(+)
> > create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
> > create mode 100644 drivers/clk/clk-si570.c
> >
> > diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> > new file mode 100644
> > index 0000000..c09f21e
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> > @@ -0,0 +1,39 @@
> > +Binding for Silicon Labs 570, 571, 598 and 599 programmable
> > +I2C clock generators.
> > +
> > +Reference
> > +This binding uses the common clock binding[1]. Details about the devices can be
> > +found in the data sheets[2][3].
> > +
> > +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
> > +[2] Si570/571 Data Sheet
> > + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
> > +[3] Si598/599 Data Sheet
> > + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
> > +
> > +Required properties:
> > + - compatible: Shall be one of "silabs,si570", "silabs,si571",
> > + "silabs,si598", "silabs,si599"
> > + - reg: I2C device address.
> > + - #clock-cells: From common clock bindings: Shall be 0.
> > + - factory-fout: Factory set default frequency. This frequency is part specific.
> > + The correct frequency for the part used has to be provided in
> > + order to generate the correct output frequencies. For more
> > + details, please refer to the data sheet.
> > + - temperature-stability: Temperature stability of the device in PPM. Should be
> > + one of: 7, 20, 50 or 100.
> > +
> > +Optional properties:
> > + - clock-output-names: From common clock bindings. Recommended to be "si570".
> > + - clock-frequency: Output frequency to generate. This defines the output
> > + frequency set during boot. It can be reprogrammed during
> > + runtime through the common clock framework.
> > +
> > +Example:
> > + si570: clock-generator at 5d {
> > + #clock-cells = <0>;
> > + compatible = "silabs,si570";
> > + temperature-stability = <50>;
> > + reg = <0x5d>;
> > + factory-fout = <156250000>;
> > + };
> > diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
> > index 279407a..349b88a 100644
> > --- a/drivers/clk/Kconfig
> > +++ b/drivers/clk/Kconfig
> > @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
> > This driver supports Silicon Labs 5351A/B/C programmable clock
> > generators.
> >
> > +config COMMON_CLK_SI570
> > + tristate "Clock driver for SiLabs 570 and compatible devices"
> > + depends on I2C
> > + depends on OF
> > + select REGMAP_I2C
> > + help
> > + ---help---
> > + This driver supports Silicon Labs 570/571/598/599 programmable
> > + clock generators.
> > +
> > config COMMON_CLK_S2MPS11
> > tristate "Clock driver for S2MPS11 MFD"
> > depends on MFD_SEC_CORE
> > diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
> > index 7b11106..c0e94b3 100644
> > --- a/drivers/clk/Makefile
> > +++ b/drivers/clk/Makefile
> > @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
> > obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
> > obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
> > obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
> > +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
> > obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
> > obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
> > obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
> > diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
> > new file mode 100644
> > index 0000000..5d0ac9f
> > --- /dev/null
> > +++ b/drivers/clk/clk-si570.c
> > @@ -0,0 +1,531 @@
> > +/*
> > + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
> > + *
> > + * Copyright (C) 2010, 2011 Ericsson AB.
> > + * Copyright (C) 2011 Guenter Roeck.
> > + * Copyright (C) 2011 - 2013 Xilinx Inc.
> > + *
> > + * Author: Guenter Roeck <guenter.roeck@ericsson.com>
> > + * S?ren Brinkmann <soren.brinkmann@xilinx.com>
> > + *
> > + * This program is free software; you can redistribute it and/or modify
> > + * it under the terms of the GNU General Public License as published by
> > + * the Free Software Foundation; either version 2 of the License, or
> > + * (at your option) any later version.
> > + *
> > + * This program is distributed in the hope that it will be useful,
> > + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> > + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
> > + * GNU General Public License for more details.
> > + */
> > +
> > +#include <linux/clk-provider.h>
> > +#include <linux/delay.h>
> > +#include <linux/module.h>
> > +#include <linux/i2c.h>
> > +#include <linux/regmap.h>
> > +#include <linux/slab.h>
> > +
> > +/* Si570 registers */
> > +#define SI570_REG_HS_N1 7
> > +#define SI570_REG_N1_RFREQ0 8
> > +#define SI570_REG_RFREQ1 9
> > +#define SI570_REG_RFREQ2 10
> > +#define SI570_REG_RFREQ3 11
> > +#define SI570_REG_RFREQ4 12
> > +#define SI570_REG_CONTROL 135
> > +#define SI570_REG_FREEZE_DCO 137
> > +#define SI570_DIV_OFFSET_7PPM 6
> > +
> > +#define HS_DIV_SHIFT 5
> > +#define HS_DIV_MASK 0xe0
> > +#define HS_DIV_OFFSET 4
> > +#define N1_6_2_MASK 0x1f
> > +#define N1_1_0_MASK 0xc0
> > +#define RFREQ_37_32_MASK 0x3f
> > +
> > +#define SI570_MIN_FREQ 10000000L
> > +#define SI570_MAX_FREQ 1417500000L
> > +#define SI598_MAX_FREQ 525000000L
> > +
> > +#define FDCO_MIN 4850000000LL
> > +#define FDCO_MAX 5670000000LL
> > +
> > +#define SI570_CNTRL_RECALL (1 << 0)
> > +#define SI570_CNTRL_FREEZE_M (1 << 5)
> > +#define SI570_CNTRL_NEWFREQ (1 << 6)
> > +
> > +#define SI570_FREEZE_DCO (1 << 4)
> > +
> > +/**
> > + * struct clk_si570:
> > + * @hw: Clock hw struct
> > + * @regmap: Device's regmap
> > + * @div_offset: Rgister offset for dividers
> > + * @max_freq: Maximum frequency for this device
> > + * @fxtal: Factory xtal frequency
> > + * @n1: Clock divider N1
> > + * @hs_div: Clock divider HSDIV
> > + * @rfreq: Clock multiplier RFREQ
> > + * @frequency: Current output frequency
> > + * @i2c_client: I2C client pointer
> > + */
> > +struct clk_si570 {
> > + struct clk_hw hw;
> > + struct regmap *regmap;
> > + unsigned int div_offset;
> > + u64 max_freq;
> > + u64 fxtal;
> > + unsigned int n1;
> > + unsigned int hs_div;
> > + u64 rfreq;
> > + u64 frequency;
> > + struct i2c_client *i2c_client;
> > +};
> > +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
> > +
> > +enum clk_si570_variant {
> > + si57x,
> > + si59x
> > +};
> > +
> > +/**
> > + * si570_get_divs() - Read clock dividers from HW
> > + * @data: Pointer to struct clk_si570
> > + * @rfreq: Fractional multiplier (output)
> > + * @n1: Divider N1 (output)
> > + * @hs_div: Divider HSDIV (output)
> > + * Returns 0 on success, negative errno otherwise.
> > + *
> > + * Retrieve clock dividers and multipliers from the HW.
> > + */
> > +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
> > + unsigned int *n1, unsigned int *hs_div)
> > +{
> > + int err;
> > + u8 reg[6];
> > + u64 tmp;
> > +
> > + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> > + reg, ARRAY_SIZE(reg));
> > + if (err)
> > + return err;
> > +
> > + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
> > + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
> > + /* Handle invalid cases */
> > + if (*n1 > 1)
> > + *n1 &= ~1;
> > +
> > + tmp = reg[1] & RFREQ_37_32_MASK;
> > + tmp = (tmp << 8) + reg[2];
> > + tmp = (tmp << 8) + reg[3];
> > + tmp = (tmp << 8) + reg[4];
> > + tmp = (tmp << 8) + reg[5];
> > + *rfreq = tmp;
> > +
> > + return 0;
> > +}
> > +
> > +/**
> > + * si570_get_defaults() - Get default values
> > + * @data: Driver data structure
> > + * @fout: Factory frequency output
> > + * Returns 0 on success, negative errno otherwise.
> > + */
> > +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
> > +{
> > + int err;
> > + u64 fdco;
> > +
> > + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
> > +
> > + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
> > + if (err)
> > + return err;
> > +
> > + /*
> > + * Accept optional precision loss to avoid arithmetic overflows.
> > + * Acceptable per Silicon Labs Application Note AN334.
> > + */
> > + fdco = fout * data->n1 * data->hs_div;
> > + if (fdco >= (1LL << 36))
> > + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
> > + else
> > + data->fxtal = div64_u64(fdco << 28, data->rfreq);
> > +
> > + data->frequency = fout;
> > +
> > + return 0;
> > +}
> > +
> > +/**
> > + * si570_update_rfreq() - Update clock multiplier
> > + * @data: Driver data structure
> > + * Passes on regmap_bulk_write() return value.
> > + */
> > +static int si570_update_rfreq(struct clk_si570 *data)
> > +{
> > + u8 reg[5];
> > +
> > + reg[0] = ((data->n1 - 1) << 6) |
> > + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
> > + reg[1] = (data->rfreq >> 24) & 0xff;
> > + reg[2] = (data->rfreq >> 16) & 0xff;
> > + reg[3] = (data->rfreq >> 8) & 0xff;
> > + reg[4] = data->rfreq & 0xff;
> > +
> > + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
> > + data->div_offset, reg, ARRAY_SIZE(reg));
> > +}
> > +
> > +/**
> > + * si570_calc_divs() - Caluclate clock dividers
> > + * @frequency: Target frequency
> > + * @data: Driver data structure
> > + * @out_rfreq: RFREG fractional multiplier (output)
> > + * @out_n1: Clock divider N1 (output)
> > + * @out_hs_div: Clock divider HSDIV (output)
> > + * Returns 0 on success, negative errno otherwise.
> > + *
> > + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
> > + * (@out_rfreq) for a given target @frequency.
> > + */
> > +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
> > + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
> > +{
> > + int i;
> > + unsigned int n1, hs_div;
> > + u64 fdco, best_fdco = ULLONG_MAX;
> > + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
> > +
> > + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
> > + hs_div = si570_hs_div_values[i];
> > + /* Calculate lowest possible value for n1 */
> > + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
> > + if (!n1 || (n1 & 1))
> > + n1++;
> > + while (n1 <= 128) {
> > + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
> > + if (fdco > FDCO_MAX)
> > + break;
> > + if (fdco >= FDCO_MIN && fdco < best_fdco) {
> > + *out_n1 = n1;
> > + *out_hs_div = hs_div;
> > + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
> > + best_fdco = fdco;
> > + }
> > + n1 += (n1 == 1 ? 1 : 2);
> > + }
> > + }
> > +
> > + if (best_fdco == ULLONG_MAX)
> > + return -EINVAL;
> > +
> > + return 0;
> > +}
> > +
> > +static unsigned long si570_recalc_rate(struct clk_hw *hw,
> > + unsigned long parent_rate)
> > +{
> > + int err;
> > + u64 rfreq, rate;
> > + unsigned int n1, hs_div;
> > + struct clk_si570 *data = to_clk_si570(hw);
> > +
> > + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
> > + if (err) {
> > + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
> > + return data->frequency;
> > + }
> > +
> > + rfreq = div_u64(rfreq, hs_div * n1);
> > + rate = (data->fxtal * rfreq) >> 28;
> > +
> > + return rate;
> > +}
> > +
> > +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
> > + unsigned long *parent_rate)
> > +{
> > + int err;
> > + u64 rfreq;
> > + unsigned int n1, hs_div;
> > + struct clk_si570 *data = to_clk_si570(hw);
> > +
> > + if (!rate)
> > + return 0;
> > +
> > + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> > + data->frequency) < 35) {
> > + rfreq = div64_u64((data->rfreq * rate) +
> > + div64_u64(data->frequency, 2), data->frequency);
> > + n1 = data->n1;
> > + hs_div = data->hs_div;
> > +
> > + } else {
> > + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
> > + if (err) {
> > + dev_err(&data->i2c_client->dev,
> > + "unable to round rate\n");
> > + return 0;
> > + }
> > + }
> > +
> > + return rate;
> > +}
> > +
> > +/**
> > + * si570_set_frequency() - Adjust output frequency
> > + * @data: Driver data structure
> > + * @frequency: Target frequency
> > + * Returns 0 on success.
> > + *
> > + * Update output frequency for big frequency changes (> 3,500 ppm).
> > + */
> > +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
> > +{
> > + int err;
> > +
> > + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
> > + &data->hs_div);
> > + if (err)
> > + return err;
> > +
> > + /*
> > + * The DCO reg should be accessed with a read-modify-write operation
> > + * per AN334
> > + */
> > + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
> > + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> > + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
> > + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
> > + si570_update_rfreq(data);
> > + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
> > + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
> > +
> > + /* Applying a new frequency can take up to 10ms */
> > + usleep_range(10000, 12000);
> > +
> > + return 0;
> > +}
> > +
> > +/**
> > + * si570_set_frequency_small() - Adjust output frequency
> > + * @data: Driver data structure
> > + * @frequency: Target frequency
> > + * Returns 0 on success.
> > + *
> > + * Update output frequency for small frequency changes (< 3,500 ppm).
> > + */
> > +static int si570_set_frequency_small(struct clk_si570 *data,
> > + unsigned long frequency)
> > +{
> > + /*
> > + * This is a re-implementation of DIV_ROUND_CLOSEST
> > + * using the div64_u64 function lieu of letting the compiler
> > + * insert EABI calls
> > + */
> > + data->rfreq = div64_u64((data->rfreq * frequency) +
> > + div_u64(data->frequency, 2), data->frequency);
> > + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
> > + si570_update_rfreq(data);
> > + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
> > +
> > + /* Applying a new frequency (small change) can take up to 100us */
> > + usleep_range(100, 200);
> > +
> > + return 0;
> > +}
> > +
> > +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
> > + unsigned long parent_rate)
> > +{
> > + struct clk_si570 *data = to_clk_si570(hw);
> > + struct i2c_client *client = data->i2c_client;
> > + int err;
> > +
> > + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
> > + dev_err(&client->dev,
> > + "requested frequency %lu Hz is out of range\n", rate);
> > + return -EINVAL;
> > + }
> > +
> > + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> > + data->frequency) < 35)
> > + err = si570_set_frequency_small(data, rate);
> > + else
> > + err = si570_set_frequency(data, rate);
> > +
> > + if (err)
> > + return err;
> > +
> > + data->frequency = rate;
> > +
> > + return 0;
> > +}
> > +
> > +static const struct clk_ops si570_clk_ops = {
> > + .recalc_rate = si570_recalc_rate,
> > + .round_rate = si570_round_rate,
> > + .set_rate = si570_set_rate,
> > +};
> > +
> > +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
> > +{
> > + switch (reg) {
> > + case SI570_REG_CONTROL:
> > + return true;
> > + default:
> > + return false;
> > + }
> > +}
> > +
> > +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
> > +{
> > + switch (reg) {
> > + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
> > + case SI570_REG_CONTROL:
> > + case SI570_REG_FREEZE_DCO:
> > + return true;
> > + default:
> > + return false;
> > + }
> > +}
> > +
> > +static struct regmap_config si570_regmap_config = {
> > + .reg_bits = 8,
> > + .val_bits = 8,
> > + .cache_type = REGCACHE_RBTREE,
> > + .max_register = 137,
> > + .writeable_reg = si570_regmap_is_writeable,
> > + .volatile_reg = si570_regmap_is_volatile,
> > +};
> > +
> > +static int si570_probe(struct i2c_client *client,
> > + const struct i2c_device_id *id)
> > +{
> > + struct clk_si570 *data;
> > + struct clk_init_data init;
> > + struct clk *clk;
> > + u32 initial_fout, factory_fout, stability;
> > + int err;
> > + enum clk_si570_variant variant = id->driver_data;
> > +
> > + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
> > + if (!data)
> > + return -ENOMEM;
> > +
> > + init.ops = &si570_clk_ops;
> > + init.flags = CLK_IS_ROOT;
> > + init.num_parents = 0;
> > + data->hw.init = &init;
> > + data->i2c_client = client;
> > +
> > + if (variant == si57x) {
> > + err = of_property_read_u32(client->dev.of_node,
> > + "temperature-stability", &stability);
> > + if (err) {
> > + dev_err(&client->dev,
> > + "'temperature-stability' property missing\n");
> > + return err;
> > + }
> > + /* adjust register offsets for 7ppm devices */
> > + if (stability == 7)
> > + data->div_offset = SI570_DIV_OFFSET_7PPM;
> > +
> > + data->max_freq = SI570_MAX_FREQ;
> > + } else {
> > + data->max_freq = SI598_MAX_FREQ;
> > + }
> > +
> > + if (of_property_read_string(client->dev.of_node, "clock-output-names",
> > + &init.name))
> > + init.name = client->dev.of_node->name;
> > +
> > + err = of_property_read_u32(client->dev.of_node, "factory-fout",
> > + &factory_fout);
> > + if (err) {
> > + dev_err(&client->dev, "'factory-fout' property missing\n");
> > + return err;
> > + }
> > +
> > + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
> > + if (IS_ERR(data->regmap)) {
> > + dev_err(&client->dev, "failed to allocate register map\n");
> > + return PTR_ERR(data->regmap);
> > + }
> > +
> > + i2c_set_clientdata(client, data);
> > + err = si570_get_defaults(data, factory_fout);
> > + if (err)
> > + return err;
> > +
> > + clk = devm_clk_register(&client->dev, &data->hw);
> > + if (IS_ERR(clk)) {
> > + dev_err(&client->dev, "clock registration failed\n");
> > + return PTR_ERR(clk);
> > + }
> > + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
> > + clk);
> > + if (err) {
> > + dev_err(&client->dev, "unable to add clk provider\n");
> > + return err;
> > + }
> > +
> > + /* Read the requested initial output frequency from device tree */
> > + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
> > + &initial_fout)) {
> > + err = clk_set_rate(clk, initial_fout);
> > + if (err) {
> > + of_clk_del_provider(client->dev.of_node);
> > + return err;
> > + }
> > + }
> > +
> > + /* Display a message indicating that we've successfully registered */
> > + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
> > + data->frequency);
> > +
> > + return 0;
> > +}
> > +
> > +static int si570_remove(struct i2c_client *client)
> > +{
> > + of_clk_del_provider(client->dev.of_node);
> > + return 0;
> > +}
> > +
> > +static const struct i2c_device_id si570_id[] = {
> > + { "si570", si57x },
> > + { "si571", si57x },
> > + { "si598", si59x },
> > + { "si599", si59x },
> > + { }
> > +};
> > +MODULE_DEVICE_TABLE(i2c, si570_id);
> > +
> > +static const struct of_device_id clk_si570_of_match[] = {
> > + { .compatible = "silabs,si570" },
> > + { .compatible = "silabs,si571" },
> > + { .compatible = "silabs,si598" },
> > + { .compatible = "silabs,si599" },
> > + { },
> > +};
> > +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
> > +
> > +static struct i2c_driver si570_driver = {
> > + .driver = {
> > + .name = "si570",
> > + .of_match_table = of_match_ptr(clk_si570_of_match),
> > + },
> > + .probe = si570_probe,
> > + .remove = si570_remove,
> > + .id_table = si570_id,
> > +};
> > +module_i2c_driver(si570_driver);
> > +
> > +MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
> > +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
> > +MODULE_DESCRIPTION("Si570 driver");
> > +MODULE_LICENSE("GPL");
> > --
> > 1.8.4
> >
> >
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
2013-10-02 23:17 ` Mike Turquette
(?)
@ 2013-10-02 23:22 ` Sören Brinkmann
-1 siblings, 0 replies; 27+ messages in thread
From: Sören Brinkmann @ 2013-10-02 23:22 UTC (permalink / raw)
To: Mike Turquette
Cc: Rob Herring, Pawel Moll, Mark Rutland, Stephen Warren,
Ian Campbell, Rob Landley, Grant Likely, Guenter Roeck,
Sebastian Hesselbarth, Joe Perches, devicetree, linux-doc,
linux-kernel, linux-arm-kernel, Hyun Kwon
On Wed, Oct 02, 2013 at 04:17:51PM -0700, Mike Turquette wrote:
> Quoting Sören Brinkmann (2013-10-02 10:20:38)
> > Hi Mike,
> >
> > could you please comment on this/apply it to clk-next?
>
> It looks good and is in the queue. Will show up in clk-next in a few
> days.
Thanks, Mike.
Sören
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-10-02 23:22 ` Sören Brinkmann
0 siblings, 0 replies; 27+ messages in thread
From: Sören Brinkmann @ 2013-10-02 23:22 UTC (permalink / raw)
To: Mike Turquette
Cc: Rob Herring, Pawel Moll, Mark Rutland, Stephen Warren,
Ian Campbell, Rob Landley, Grant Likely, Guenter Roeck,
Sebastian Hesselbarth, Joe Perches,
devicetree-u79uwXL29TY76Z2rM5mHXA,
linux-doc-u79uwXL29TY76Z2rM5mHXA,
linux-kernel-u79uwXL29TY76Z2rM5mHXA,
linux-arm-kernel-IAPFreCvJWM7uuMidbF8XUB+6BGkLq7r, Hyun Kwon
On Wed, Oct 02, 2013 at 04:17:51PM -0700, Mike Turquette wrote:
> Quoting Sören Brinkmann (2013-10-02 10:20:38)
> > Hi Mike,
> >
> > could you please comment on this/apply it to clk-next?
>
> It looks good and is in the queue. Will show up in clk-next in a few
> days.
Thanks, Mike.
Sören
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-10-02 23:22 ` Sören Brinkmann
0 siblings, 0 replies; 27+ messages in thread
From: Sören Brinkmann @ 2013-10-02 23:22 UTC (permalink / raw)
To: linux-arm-kernel
On Wed, Oct 02, 2013 at 04:17:51PM -0700, Mike Turquette wrote:
> Quoting S?ren Brinkmann (2013-10-02 10:20:38)
> > Hi Mike,
> >
> > could you please comment on this/apply it to clk-next?
>
> It looks good and is in the queue. Will show up in clk-next in a few
> days.
Thanks, Mike.
S?ren
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
2013-10-02 23:17 ` Mike Turquette
@ 2013-12-09 16:34 ` Guenter Roeck
-1 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-12-09 16:34 UTC (permalink / raw)
To: Mike Turquette
Cc: devicetree, linux-doc, linux-kernel, linux-arm-kernel, Hyun Kwon
On Wed, Oct 02, 2013 at 04:17:51PM -0700, Mike Turquette wrote:
> Quoting Sören Brinkmann (2013-10-02 10:20:38)
> > Hi Mike,
> >
> > could you please comment on this/apply it to clk-next?
>
> It looks good and is in the queue. Will show up in clk-next in a few
> days.
>
What happened with this driver ? I just noticed it is not upstream,
nor in -next. I don't recall seeing any objections, so I am a bit puzzled.
Thanks,
Guenter
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-12-09 16:34 ` Guenter Roeck
0 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-12-09 16:34 UTC (permalink / raw)
To: linux-arm-kernel
On Wed, Oct 02, 2013 at 04:17:51PM -0700, Mike Turquette wrote:
> Quoting S?ren Brinkmann (2013-10-02 10:20:38)
> > Hi Mike,
> >
> > could you please comment on this/apply it to clk-next?
>
> It looks good and is in the queue. Will show up in clk-next in a few
> days.
>
What happened with this driver ? I just noticed it is not upstream,
nor in -next. I don't recall seeing any objections, so I am a bit puzzled.
Thanks,
Guenter
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
2013-10-02 23:17 ` Mike Turquette
@ 2013-12-14 16:33 ` Guenter Roeck
-1 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-12-14 16:33 UTC (permalink / raw)
To: Mike Turquette, Sören Brinkmann, Rob Herring, Pawel Moll,
Mark Rutland, Stephen Warren
Cc: devicetree, linux-doc, linux-kernel, linux-arm-kernel, Hyun Kwon
On 10/02/2013 04:17 PM, Mike Turquette wrote:
> Quoting Sören Brinkmann (2013-10-02 10:20:38)
>> Hi Mike,
>>
>> could you please comment on this/apply it to clk-next?
>
> It looks good and is in the queue. Will show up in clk-next in a few
> days.
>
Hi Mike,
trying again ... what happened with this driver ? Any reason for not pushing it after all ?
Thanks,
Guenter
> Thanks,
> Mike
>
>>
>> Thanks,
>> Sören
>>
>> On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
>>> Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
>>> The devices generate low-jitter clock signals and are reprogrammable via
>>> an I2C interface.
>>>
>>> Cc: Guenter Roeck <linux@roeck-us.net>
>>> Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
>>> ---
>>> v5:
>>> - fix typo in bindings documentation
>>> - mention the unit for the 'temperature-stability' property
>>> - remove calls to clk_unregister() (the device managed code takes care
>>> of it)
>>>
>>> v4:
>>> - actually check and handle error on clk_set_rate() call
>>>
>>> v3:
>>> - add delay in the path for small frequency changes, which can take up
>>> to 100us according to the data sheet
>>> - use real range for usleep_range() argument
>>> - use dev_err() over dev_warn() in set_rate()
>>> - add list of applicable devices for 7ppm DT prop
>>> - remove comments regarding platform data
>>> - ignore 7ppm DT prop for incompatible devices
>>> - replace raw numbers with #defines
>>> - convert DT prop 'temperature-stability' from boolean to u32
>>> - make 'temperature-stability' DT prop required (actually not fully
>>> true, for 59x it is ignored and the driver does not require its
>>> presence)
>>>
>>> v2:
>>> - document clock-output-names in bindings documentation
>>> - don't use wildcards in compatibility string
>>> - change Kconfig entry to "... 570 and compatible devices"
>>> - change some indentation flaws
>>> - use 10000 as MIN and MAX value in usleep_range
>>> - fail probe() if 'factory-fout' is not provided in DT
>>> - default factory fout #defines removed
>>> - use i2c driver_data instead of OF data
>>> - remove some related structs and data
>>> - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
>>> driver)
>>> - add some more details regarding the 'factory-fout' DT property
>>> ---
>>> .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
>>> drivers/clk/Kconfig | 10 +
>>> drivers/clk/Makefile | 1 +
>>> drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
>>> 4 files changed, 581 insertions(+)
>>> create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
>>> create mode 100644 drivers/clk/clk-si570.c
>>>
>>> diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
>>> new file mode 100644
>>> index 0000000..c09f21e
>>> --- /dev/null
>>> +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
>>> @@ -0,0 +1,39 @@
>>> +Binding for Silicon Labs 570, 571, 598 and 599 programmable
>>> +I2C clock generators.
>>> +
>>> +Reference
>>> +This binding uses the common clock binding[1]. Details about the devices can be
>>> +found in the data sheets[2][3].
>>> +
>>> +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
>>> +[2] Si570/571 Data Sheet
>>> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
>>> +[3] Si598/599 Data Sheet
>>> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
>>> +
>>> +Required properties:
>>> + - compatible: Shall be one of "silabs,si570", "silabs,si571",
>>> + "silabs,si598", "silabs,si599"
>>> + - reg: I2C device address.
>>> + - #clock-cells: From common clock bindings: Shall be 0.
>>> + - factory-fout: Factory set default frequency. This frequency is part specific.
>>> + The correct frequency for the part used has to be provided in
>>> + order to generate the correct output frequencies. For more
>>> + details, please refer to the data sheet.
>>> + - temperature-stability: Temperature stability of the device in PPM. Should be
>>> + one of: 7, 20, 50 or 100.
>>> +
>>> +Optional properties:
>>> + - clock-output-names: From common clock bindings. Recommended to be "si570".
>>> + - clock-frequency: Output frequency to generate. This defines the output
>>> + frequency set during boot. It can be reprogrammed during
>>> + runtime through the common clock framework.
>>> +
>>> +Example:
>>> + si570: clock-generator@5d {
>>> + #clock-cells = <0>;
>>> + compatible = "silabs,si570";
>>> + temperature-stability = <50>;
>>> + reg = <0x5d>;
>>> + factory-fout = <156250000>;
>>> + };
>>> diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
>>> index 279407a..349b88a 100644
>>> --- a/drivers/clk/Kconfig
>>> +++ b/drivers/clk/Kconfig
>>> @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
>>> This driver supports Silicon Labs 5351A/B/C programmable clock
>>> generators.
>>>
>>> +config COMMON_CLK_SI570
>>> + tristate "Clock driver for SiLabs 570 and compatible devices"
>>> + depends on I2C
>>> + depends on OF
>>> + select REGMAP_I2C
>>> + help
>>> + ---help---
>>> + This driver supports Silicon Labs 570/571/598/599 programmable
>>> + clock generators.
>>> +
>>> config COMMON_CLK_S2MPS11
>>> tristate "Clock driver for S2MPS11 MFD"
>>> depends on MFD_SEC_CORE
>>> diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
>>> index 7b11106..c0e94b3 100644
>>> --- a/drivers/clk/Makefile
>>> +++ b/drivers/clk/Makefile
>>> @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
>>> obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
>>> obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
>>> obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
>>> +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
>>> obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
>>> obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
>>> obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
>>> diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
>>> new file mode 100644
>>> index 0000000..5d0ac9f
>>> --- /dev/null
>>> +++ b/drivers/clk/clk-si570.c
>>> @@ -0,0 +1,531 @@
>>> +/*
>>> + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
>>> + *
>>> + * Copyright (C) 2010, 2011 Ericsson AB.
>>> + * Copyright (C) 2011 Guenter Roeck.
>>> + * Copyright (C) 2011 - 2013 Xilinx Inc.
>>> + *
>>> + * Author: Guenter Roeck <guenter.roeck@ericsson.com>
>>> + * Sören Brinkmann <soren.brinkmann@xilinx.com>
>>> + *
>>> + * This program is free software; you can redistribute it and/or modify
>>> + * it under the terms of the GNU General Public License as published by
>>> + * the Free Software Foundation; either version 2 of the License, or
>>> + * (at your option) any later version.
>>> + *
>>> + * This program is distributed in the hope that it will be useful,
>>> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
>>> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
>>> + * GNU General Public License for more details.
>>> + */
>>> +
>>> +#include <linux/clk-provider.h>
>>> +#include <linux/delay.h>
>>> +#include <linux/module.h>
>>> +#include <linux/i2c.h>
>>> +#include <linux/regmap.h>
>>> +#include <linux/slab.h>
>>> +
>>> +/* Si570 registers */
>>> +#define SI570_REG_HS_N1 7
>>> +#define SI570_REG_N1_RFREQ0 8
>>> +#define SI570_REG_RFREQ1 9
>>> +#define SI570_REG_RFREQ2 10
>>> +#define SI570_REG_RFREQ3 11
>>> +#define SI570_REG_RFREQ4 12
>>> +#define SI570_REG_CONTROL 135
>>> +#define SI570_REG_FREEZE_DCO 137
>>> +#define SI570_DIV_OFFSET_7PPM 6
>>> +
>>> +#define HS_DIV_SHIFT 5
>>> +#define HS_DIV_MASK 0xe0
>>> +#define HS_DIV_OFFSET 4
>>> +#define N1_6_2_MASK 0x1f
>>> +#define N1_1_0_MASK 0xc0
>>> +#define RFREQ_37_32_MASK 0x3f
>>> +
>>> +#define SI570_MIN_FREQ 10000000L
>>> +#define SI570_MAX_FREQ 1417500000L
>>> +#define SI598_MAX_FREQ 525000000L
>>> +
>>> +#define FDCO_MIN 4850000000LL
>>> +#define FDCO_MAX 5670000000LL
>>> +
>>> +#define SI570_CNTRL_RECALL (1 << 0)
>>> +#define SI570_CNTRL_FREEZE_M (1 << 5)
>>> +#define SI570_CNTRL_NEWFREQ (1 << 6)
>>> +
>>> +#define SI570_FREEZE_DCO (1 << 4)
>>> +
>>> +/**
>>> + * struct clk_si570:
>>> + * @hw: Clock hw struct
>>> + * @regmap: Device's regmap
>>> + * @div_offset: Rgister offset for dividers
>>> + * @max_freq: Maximum frequency for this device
>>> + * @fxtal: Factory xtal frequency
>>> + * @n1: Clock divider N1
>>> + * @hs_div: Clock divider HSDIV
>>> + * @rfreq: Clock multiplier RFREQ
>>> + * @frequency: Current output frequency
>>> + * @i2c_client: I2C client pointer
>>> + */
>>> +struct clk_si570 {
>>> + struct clk_hw hw;
>>> + struct regmap *regmap;
>>> + unsigned int div_offset;
>>> + u64 max_freq;
>>> + u64 fxtal;
>>> + unsigned int n1;
>>> + unsigned int hs_div;
>>> + u64 rfreq;
>>> + u64 frequency;
>>> + struct i2c_client *i2c_client;
>>> +};
>>> +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
>>> +
>>> +enum clk_si570_variant {
>>> + si57x,
>>> + si59x
>>> +};
>>> +
>>> +/**
>>> + * si570_get_divs() - Read clock dividers from HW
>>> + * @data: Pointer to struct clk_si570
>>> + * @rfreq: Fractional multiplier (output)
>>> + * @n1: Divider N1 (output)
>>> + * @hs_div: Divider HSDIV (output)
>>> + * Returns 0 on success, negative errno otherwise.
>>> + *
>>> + * Retrieve clock dividers and multipliers from the HW.
>>> + */
>>> +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
>>> + unsigned int *n1, unsigned int *hs_div)
>>> +{
>>> + int err;
>>> + u8 reg[6];
>>> + u64 tmp;
>>> +
>>> + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
>>> + reg, ARRAY_SIZE(reg));
>>> + if (err)
>>> + return err;
>>> +
>>> + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
>>> + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
>>> + /* Handle invalid cases */
>>> + if (*n1 > 1)
>>> + *n1 &= ~1;
>>> +
>>> + tmp = reg[1] & RFREQ_37_32_MASK;
>>> + tmp = (tmp << 8) + reg[2];
>>> + tmp = (tmp << 8) + reg[3];
>>> + tmp = (tmp << 8) + reg[4];
>>> + tmp = (tmp << 8) + reg[5];
>>> + *rfreq = tmp;
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +/**
>>> + * si570_get_defaults() - Get default values
>>> + * @data: Driver data structure
>>> + * @fout: Factory frequency output
>>> + * Returns 0 on success, negative errno otherwise.
>>> + */
>>> +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
>>> +{
>>> + int err;
>>> + u64 fdco;
>>> +
>>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
>>> +
>>> + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
>>> + if (err)
>>> + return err;
>>> +
>>> + /*
>>> + * Accept optional precision loss to avoid arithmetic overflows.
>>> + * Acceptable per Silicon Labs Application Note AN334.
>>> + */
>>> + fdco = fout * data->n1 * data->hs_div;
>>> + if (fdco >= (1LL << 36))
>>> + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
>>> + else
>>> + data->fxtal = div64_u64(fdco << 28, data->rfreq);
>>> +
>>> + data->frequency = fout;
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +/**
>>> + * si570_update_rfreq() - Update clock multiplier
>>> + * @data: Driver data structure
>>> + * Passes on regmap_bulk_write() return value.
>>> + */
>>> +static int si570_update_rfreq(struct clk_si570 *data)
>>> +{
>>> + u8 reg[5];
>>> +
>>> + reg[0] = ((data->n1 - 1) << 6) |
>>> + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
>>> + reg[1] = (data->rfreq >> 24) & 0xff;
>>> + reg[2] = (data->rfreq >> 16) & 0xff;
>>> + reg[3] = (data->rfreq >> 8) & 0xff;
>>> + reg[4] = data->rfreq & 0xff;
>>> +
>>> + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
>>> + data->div_offset, reg, ARRAY_SIZE(reg));
>>> +}
>>> +
>>> +/**
>>> + * si570_calc_divs() - Caluclate clock dividers
>>> + * @frequency: Target frequency
>>> + * @data: Driver data structure
>>> + * @out_rfreq: RFREG fractional multiplier (output)
>>> + * @out_n1: Clock divider N1 (output)
>>> + * @out_hs_div: Clock divider HSDIV (output)
>>> + * Returns 0 on success, negative errno otherwise.
>>> + *
>>> + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
>>> + * (@out_rfreq) for a given target @frequency.
>>> + */
>>> +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
>>> + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
>>> +{
>>> + int i;
>>> + unsigned int n1, hs_div;
>>> + u64 fdco, best_fdco = ULLONG_MAX;
>>> + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
>>> +
>>> + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
>>> + hs_div = si570_hs_div_values[i];
>>> + /* Calculate lowest possible value for n1 */
>>> + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
>>> + if (!n1 || (n1 & 1))
>>> + n1++;
>>> + while (n1 <= 128) {
>>> + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
>>> + if (fdco > FDCO_MAX)
>>> + break;
>>> + if (fdco >= FDCO_MIN && fdco < best_fdco) {
>>> + *out_n1 = n1;
>>> + *out_hs_div = hs_div;
>>> + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
>>> + best_fdco = fdco;
>>> + }
>>> + n1 += (n1 == 1 ? 1 : 2);
>>> + }
>>> + }
>>> +
>>> + if (best_fdco == ULLONG_MAX)
>>> + return -EINVAL;
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static unsigned long si570_recalc_rate(struct clk_hw *hw,
>>> + unsigned long parent_rate)
>>> +{
>>> + int err;
>>> + u64 rfreq, rate;
>>> + unsigned int n1, hs_div;
>>> + struct clk_si570 *data = to_clk_si570(hw);
>>> +
>>> + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
>>> + if (err) {
>>> + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
>>> + return data->frequency;
>>> + }
>>> +
>>> + rfreq = div_u64(rfreq, hs_div * n1);
>>> + rate = (data->fxtal * rfreq) >> 28;
>>> +
>>> + return rate;
>>> +}
>>> +
>>> +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
>>> + unsigned long *parent_rate)
>>> +{
>>> + int err;
>>> + u64 rfreq;
>>> + unsigned int n1, hs_div;
>>> + struct clk_si570 *data = to_clk_si570(hw);
>>> +
>>> + if (!rate)
>>> + return 0;
>>> +
>>> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
>>> + data->frequency) < 35) {
>>> + rfreq = div64_u64((data->rfreq * rate) +
>>> + div64_u64(data->frequency, 2), data->frequency);
>>> + n1 = data->n1;
>>> + hs_div = data->hs_div;
>>> +
>>> + } else {
>>> + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
>>> + if (err) {
>>> + dev_err(&data->i2c_client->dev,
>>> + "unable to round rate\n");
>>> + return 0;
>>> + }
>>> + }
>>> +
>>> + return rate;
>>> +}
>>> +
>>> +/**
>>> + * si570_set_frequency() - Adjust output frequency
>>> + * @data: Driver data structure
>>> + * @frequency: Target frequency
>>> + * Returns 0 on success.
>>> + *
>>> + * Update output frequency for big frequency changes (> 3,500 ppm).
>>> + */
>>> +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
>>> +{
>>> + int err;
>>> +
>>> + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
>>> + &data->hs_div);
>>> + if (err)
>>> + return err;
>>> +
>>> + /*
>>> + * The DCO reg should be accessed with a read-modify-write operation
>>> + * per AN334
>>> + */
>>> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
>>> + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
>>> + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
>>> + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
>>> + si570_update_rfreq(data);
>>> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
>>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
>>> +
>>> + /* Applying a new frequency can take up to 10ms */
>>> + usleep_range(10000, 12000);
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +/**
>>> + * si570_set_frequency_small() - Adjust output frequency
>>> + * @data: Driver data structure
>>> + * @frequency: Target frequency
>>> + * Returns 0 on success.
>>> + *
>>> + * Update output frequency for small frequency changes (< 3,500 ppm).
>>> + */
>>> +static int si570_set_frequency_small(struct clk_si570 *data,
>>> + unsigned long frequency)
>>> +{
>>> + /*
>>> + * This is a re-implementation of DIV_ROUND_CLOSEST
>>> + * using the div64_u64 function lieu of letting the compiler
>>> + * insert EABI calls
>>> + */
>>> + data->rfreq = div64_u64((data->rfreq * frequency) +
>>> + div_u64(data->frequency, 2), data->frequency);
>>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
>>> + si570_update_rfreq(data);
>>> + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
>>> +
>>> + /* Applying a new frequency (small change) can take up to 100us */
>>> + usleep_range(100, 200);
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
>>> + unsigned long parent_rate)
>>> +{
>>> + struct clk_si570 *data = to_clk_si570(hw);
>>> + struct i2c_client *client = data->i2c_client;
>>> + int err;
>>> +
>>> + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
>>> + dev_err(&client->dev,
>>> + "requested frequency %lu Hz is out of range\n", rate);
>>> + return -EINVAL;
>>> + }
>>> +
>>> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
>>> + data->frequency) < 35)
>>> + err = si570_set_frequency_small(data, rate);
>>> + else
>>> + err = si570_set_frequency(data, rate);
>>> +
>>> + if (err)
>>> + return err;
>>> +
>>> + data->frequency = rate;
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static const struct clk_ops si570_clk_ops = {
>>> + .recalc_rate = si570_recalc_rate,
>>> + .round_rate = si570_round_rate,
>>> + .set_rate = si570_set_rate,
>>> +};
>>> +
>>> +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
>>> +{
>>> + switch (reg) {
>>> + case SI570_REG_CONTROL:
>>> + return true;
>>> + default:
>>> + return false;
>>> + }
>>> +}
>>> +
>>> +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
>>> +{
>>> + switch (reg) {
>>> + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
>>> + case SI570_REG_CONTROL:
>>> + case SI570_REG_FREEZE_DCO:
>>> + return true;
>>> + default:
>>> + return false;
>>> + }
>>> +}
>>> +
>>> +static struct regmap_config si570_regmap_config = {
>>> + .reg_bits = 8,
>>> + .val_bits = 8,
>>> + .cache_type = REGCACHE_RBTREE,
>>> + .max_register = 137,
>>> + .writeable_reg = si570_regmap_is_writeable,
>>> + .volatile_reg = si570_regmap_is_volatile,
>>> +};
>>> +
>>> +static int si570_probe(struct i2c_client *client,
>>> + const struct i2c_device_id *id)
>>> +{
>>> + struct clk_si570 *data;
>>> + struct clk_init_data init;
>>> + struct clk *clk;
>>> + u32 initial_fout, factory_fout, stability;
>>> + int err;
>>> + enum clk_si570_variant variant = id->driver_data;
>>> +
>>> + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
>>> + if (!data)
>>> + return -ENOMEM;
>>> +
>>> + init.ops = &si570_clk_ops;
>>> + init.flags = CLK_IS_ROOT;
>>> + init.num_parents = 0;
>>> + data->hw.init = &init;
>>> + data->i2c_client = client;
>>> +
>>> + if (variant == si57x) {
>>> + err = of_property_read_u32(client->dev.of_node,
>>> + "temperature-stability", &stability);
>>> + if (err) {
>>> + dev_err(&client->dev,
>>> + "'temperature-stability' property missing\n");
>>> + return err;
>>> + }
>>> + /* adjust register offsets for 7ppm devices */
>>> + if (stability == 7)
>>> + data->div_offset = SI570_DIV_OFFSET_7PPM;
>>> +
>>> + data->max_freq = SI570_MAX_FREQ;
>>> + } else {
>>> + data->max_freq = SI598_MAX_FREQ;
>>> + }
>>> +
>>> + if (of_property_read_string(client->dev.of_node, "clock-output-names",
>>> + &init.name))
>>> + init.name = client->dev.of_node->name;
>>> +
>>> + err = of_property_read_u32(client->dev.of_node, "factory-fout",
>>> + &factory_fout);
>>> + if (err) {
>>> + dev_err(&client->dev, "'factory-fout' property missing\n");
>>> + return err;
>>> + }
>>> +
>>> + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
>>> + if (IS_ERR(data->regmap)) {
>>> + dev_err(&client->dev, "failed to allocate register map\n");
>>> + return PTR_ERR(data->regmap);
>>> + }
>>> +
>>> + i2c_set_clientdata(client, data);
>>> + err = si570_get_defaults(data, factory_fout);
>>> + if (err)
>>> + return err;
>>> +
>>> + clk = devm_clk_register(&client->dev, &data->hw);
>>> + if (IS_ERR(clk)) {
>>> + dev_err(&client->dev, "clock registration failed\n");
>>> + return PTR_ERR(clk);
>>> + }
>>> + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
>>> + clk);
>>> + if (err) {
>>> + dev_err(&client->dev, "unable to add clk provider\n");
>>> + return err;
>>> + }
>>> +
>>> + /* Read the requested initial output frequency from device tree */
>>> + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
>>> + &initial_fout)) {
>>> + err = clk_set_rate(clk, initial_fout);
>>> + if (err) {
>>> + of_clk_del_provider(client->dev.of_node);
>>> + return err;
>>> + }
>>> + }
>>> +
>>> + /* Display a message indicating that we've successfully registered */
>>> + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
>>> + data->frequency);
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static int si570_remove(struct i2c_client *client)
>>> +{
>>> + of_clk_del_provider(client->dev.of_node);
>>> + return 0;
>>> +}
>>> +
>>> +static const struct i2c_device_id si570_id[] = {
>>> + { "si570", si57x },
>>> + { "si571", si57x },
>>> + { "si598", si59x },
>>> + { "si599", si59x },
>>> + { }
>>> +};
>>> +MODULE_DEVICE_TABLE(i2c, si570_id);
>>> +
>>> +static const struct of_device_id clk_si570_of_match[] = {
>>> + { .compatible = "silabs,si570" },
>>> + { .compatible = "silabs,si571" },
>>> + { .compatible = "silabs,si598" },
>>> + { .compatible = "silabs,si599" },
>>> + { },
>>> +};
>>> +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
>>> +
>>> +static struct i2c_driver si570_driver = {
>>> + .driver = {
>>> + .name = "si570",
>>> + .of_match_table = of_match_ptr(clk_si570_of_match),
>>> + },
>>> + .probe = si570_probe,
>>> + .remove = si570_remove,
>>> + .id_table = si570_id,
>>> +};
>>> +module_i2c_driver(si570_driver);
>>> +
>>> +MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
>>> +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
>>> +MODULE_DESCRIPTION("Si570 driver");
>>> +MODULE_LICENSE("GPL");
>>> --
>>> 1.8.4
>>>
>>>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at http://vger.kernel.org/majordomo-info.html
> Please read the FAQ at http://www.tux.org/lkml/
>
>
>
>
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-12-14 16:33 ` Guenter Roeck
0 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-12-14 16:33 UTC (permalink / raw)
To: linux-arm-kernel
On 10/02/2013 04:17 PM, Mike Turquette wrote:
> Quoting S?ren Brinkmann (2013-10-02 10:20:38)
>> Hi Mike,
>>
>> could you please comment on this/apply it to clk-next?
>
> It looks good and is in the queue. Will show up in clk-next in a few
> days.
>
Hi Mike,
trying again ... what happened with this driver ? Any reason for not pushing it after all ?
Thanks,
Guenter
> Thanks,
> Mike
>
>>
>> Thanks,
>> S?ren
>>
>> On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
>>> Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
>>> The devices generate low-jitter clock signals and are reprogrammable via
>>> an I2C interface.
>>>
>>> Cc: Guenter Roeck <linux@roeck-us.net>
>>> Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
>>> ---
>>> v5:
>>> - fix typo in bindings documentation
>>> - mention the unit for the 'temperature-stability' property
>>> - remove calls to clk_unregister() (the device managed code takes care
>>> of it)
>>>
>>> v4:
>>> - actually check and handle error on clk_set_rate() call
>>>
>>> v3:
>>> - add delay in the path for small frequency changes, which can take up
>>> to 100us according to the data sheet
>>> - use real range for usleep_range() argument
>>> - use dev_err() over dev_warn() in set_rate()
>>> - add list of applicable devices for 7ppm DT prop
>>> - remove comments regarding platform data
>>> - ignore 7ppm DT prop for incompatible devices
>>> - replace raw numbers with #defines
>>> - convert DT prop 'temperature-stability' from boolean to u32
>>> - make 'temperature-stability' DT prop required (actually not fully
>>> true, for 59x it is ignored and the driver does not require its
>>> presence)
>>>
>>> v2:
>>> - document clock-output-names in bindings documentation
>>> - don't use wildcards in compatibility string
>>> - change Kconfig entry to "... 570 and compatible devices"
>>> - change some indentation flaws
>>> - use 10000 as MIN and MAX value in usleep_range
>>> - fail probe() if 'factory-fout' is not provided in DT
>>> - default factory fout #defines removed
>>> - use i2c driver_data instead of OF data
>>> - remove some related structs and data
>>> - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
>>> driver)
>>> - add some more details regarding the 'factory-fout' DT property
>>> ---
>>> .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
>>> drivers/clk/Kconfig | 10 +
>>> drivers/clk/Makefile | 1 +
>>> drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
>>> 4 files changed, 581 insertions(+)
>>> create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
>>> create mode 100644 drivers/clk/clk-si570.c
>>>
>>> diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
>>> new file mode 100644
>>> index 0000000..c09f21e
>>> --- /dev/null
>>> +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
>>> @@ -0,0 +1,39 @@
>>> +Binding for Silicon Labs 570, 571, 598 and 599 programmable
>>> +I2C clock generators.
>>> +
>>> +Reference
>>> +This binding uses the common clock binding[1]. Details about the devices can be
>>> +found in the data sheets[2][3].
>>> +
>>> +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
>>> +[2] Si570/571 Data Sheet
>>> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
>>> +[3] Si598/599 Data Sheet
>>> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
>>> +
>>> +Required properties:
>>> + - compatible: Shall be one of "silabs,si570", "silabs,si571",
>>> + "silabs,si598", "silabs,si599"
>>> + - reg: I2C device address.
>>> + - #clock-cells: From common clock bindings: Shall be 0.
>>> + - factory-fout: Factory set default frequency. This frequency is part specific.
>>> + The correct frequency for the part used has to be provided in
>>> + order to generate the correct output frequencies. For more
>>> + details, please refer to the data sheet.
>>> + - temperature-stability: Temperature stability of the device in PPM. Should be
>>> + one of: 7, 20, 50 or 100.
>>> +
>>> +Optional properties:
>>> + - clock-output-names: From common clock bindings. Recommended to be "si570".
>>> + - clock-frequency: Output frequency to generate. This defines the output
>>> + frequency set during boot. It can be reprogrammed during
>>> + runtime through the common clock framework.
>>> +
>>> +Example:
>>> + si570: clock-generator at 5d {
>>> + #clock-cells = <0>;
>>> + compatible = "silabs,si570";
>>> + temperature-stability = <50>;
>>> + reg = <0x5d>;
>>> + factory-fout = <156250000>;
>>> + };
>>> diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
>>> index 279407a..349b88a 100644
>>> --- a/drivers/clk/Kconfig
>>> +++ b/drivers/clk/Kconfig
>>> @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
>>> This driver supports Silicon Labs 5351A/B/C programmable clock
>>> generators.
>>>
>>> +config COMMON_CLK_SI570
>>> + tristate "Clock driver for SiLabs 570 and compatible devices"
>>> + depends on I2C
>>> + depends on OF
>>> + select REGMAP_I2C
>>> + help
>>> + ---help---
>>> + This driver supports Silicon Labs 570/571/598/599 programmable
>>> + clock generators.
>>> +
>>> config COMMON_CLK_S2MPS11
>>> tristate "Clock driver for S2MPS11 MFD"
>>> depends on MFD_SEC_CORE
>>> diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
>>> index 7b11106..c0e94b3 100644
>>> --- a/drivers/clk/Makefile
>>> +++ b/drivers/clk/Makefile
>>> @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
>>> obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
>>> obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
>>> obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
>>> +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
>>> obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
>>> obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
>>> obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
>>> diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
>>> new file mode 100644
>>> index 0000000..5d0ac9f
>>> --- /dev/null
>>> +++ b/drivers/clk/clk-si570.c
>>> @@ -0,0 +1,531 @@
>>> +/*
>>> + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
>>> + *
>>> + * Copyright (C) 2010, 2011 Ericsson AB.
>>> + * Copyright (C) 2011 Guenter Roeck.
>>> + * Copyright (C) 2011 - 2013 Xilinx Inc.
>>> + *
>>> + * Author: Guenter Roeck <guenter.roeck@ericsson.com>
>>> + * S?ren Brinkmann <soren.brinkmann@xilinx.com>
>>> + *
>>> + * This program is free software; you can redistribute it and/or modify
>>> + * it under the terms of the GNU General Public License as published by
>>> + * the Free Software Foundation; either version 2 of the License, or
>>> + * (at your option) any later version.
>>> + *
>>> + * This program is distributed in the hope that it will be useful,
>>> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
>>> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
>>> + * GNU General Public License for more details.
>>> + */
>>> +
>>> +#include <linux/clk-provider.h>
>>> +#include <linux/delay.h>
>>> +#include <linux/module.h>
>>> +#include <linux/i2c.h>
>>> +#include <linux/regmap.h>
>>> +#include <linux/slab.h>
>>> +
>>> +/* Si570 registers */
>>> +#define SI570_REG_HS_N1 7
>>> +#define SI570_REG_N1_RFREQ0 8
>>> +#define SI570_REG_RFREQ1 9
>>> +#define SI570_REG_RFREQ2 10
>>> +#define SI570_REG_RFREQ3 11
>>> +#define SI570_REG_RFREQ4 12
>>> +#define SI570_REG_CONTROL 135
>>> +#define SI570_REG_FREEZE_DCO 137
>>> +#define SI570_DIV_OFFSET_7PPM 6
>>> +
>>> +#define HS_DIV_SHIFT 5
>>> +#define HS_DIV_MASK 0xe0
>>> +#define HS_DIV_OFFSET 4
>>> +#define N1_6_2_MASK 0x1f
>>> +#define N1_1_0_MASK 0xc0
>>> +#define RFREQ_37_32_MASK 0x3f
>>> +
>>> +#define SI570_MIN_FREQ 10000000L
>>> +#define SI570_MAX_FREQ 1417500000L
>>> +#define SI598_MAX_FREQ 525000000L
>>> +
>>> +#define FDCO_MIN 4850000000LL
>>> +#define FDCO_MAX 5670000000LL
>>> +
>>> +#define SI570_CNTRL_RECALL (1 << 0)
>>> +#define SI570_CNTRL_FREEZE_M (1 << 5)
>>> +#define SI570_CNTRL_NEWFREQ (1 << 6)
>>> +
>>> +#define SI570_FREEZE_DCO (1 << 4)
>>> +
>>> +/**
>>> + * struct clk_si570:
>>> + * @hw: Clock hw struct
>>> + * @regmap: Device's regmap
>>> + * @div_offset: Rgister offset for dividers
>>> + * @max_freq: Maximum frequency for this device
>>> + * @fxtal: Factory xtal frequency
>>> + * @n1: Clock divider N1
>>> + * @hs_div: Clock divider HSDIV
>>> + * @rfreq: Clock multiplier RFREQ
>>> + * @frequency: Current output frequency
>>> + * @i2c_client: I2C client pointer
>>> + */
>>> +struct clk_si570 {
>>> + struct clk_hw hw;
>>> + struct regmap *regmap;
>>> + unsigned int div_offset;
>>> + u64 max_freq;
>>> + u64 fxtal;
>>> + unsigned int n1;
>>> + unsigned int hs_div;
>>> + u64 rfreq;
>>> + u64 frequency;
>>> + struct i2c_client *i2c_client;
>>> +};
>>> +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
>>> +
>>> +enum clk_si570_variant {
>>> + si57x,
>>> + si59x
>>> +};
>>> +
>>> +/**
>>> + * si570_get_divs() - Read clock dividers from HW
>>> + * @data: Pointer to struct clk_si570
>>> + * @rfreq: Fractional multiplier (output)
>>> + * @n1: Divider N1 (output)
>>> + * @hs_div: Divider HSDIV (output)
>>> + * Returns 0 on success, negative errno otherwise.
>>> + *
>>> + * Retrieve clock dividers and multipliers from the HW.
>>> + */
>>> +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
>>> + unsigned int *n1, unsigned int *hs_div)
>>> +{
>>> + int err;
>>> + u8 reg[6];
>>> + u64 tmp;
>>> +
>>> + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
>>> + reg, ARRAY_SIZE(reg));
>>> + if (err)
>>> + return err;
>>> +
>>> + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
>>> + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
>>> + /* Handle invalid cases */
>>> + if (*n1 > 1)
>>> + *n1 &= ~1;
>>> +
>>> + tmp = reg[1] & RFREQ_37_32_MASK;
>>> + tmp = (tmp << 8) + reg[2];
>>> + tmp = (tmp << 8) + reg[3];
>>> + tmp = (tmp << 8) + reg[4];
>>> + tmp = (tmp << 8) + reg[5];
>>> + *rfreq = tmp;
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +/**
>>> + * si570_get_defaults() - Get default values
>>> + * @data: Driver data structure
>>> + * @fout: Factory frequency output
>>> + * Returns 0 on success, negative errno otherwise.
>>> + */
>>> +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
>>> +{
>>> + int err;
>>> + u64 fdco;
>>> +
>>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
>>> +
>>> + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
>>> + if (err)
>>> + return err;
>>> +
>>> + /*
>>> + * Accept optional precision loss to avoid arithmetic overflows.
>>> + * Acceptable per Silicon Labs Application Note AN334.
>>> + */
>>> + fdco = fout * data->n1 * data->hs_div;
>>> + if (fdco >= (1LL << 36))
>>> + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
>>> + else
>>> + data->fxtal = div64_u64(fdco << 28, data->rfreq);
>>> +
>>> + data->frequency = fout;
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +/**
>>> + * si570_update_rfreq() - Update clock multiplier
>>> + * @data: Driver data structure
>>> + * Passes on regmap_bulk_write() return value.
>>> + */
>>> +static int si570_update_rfreq(struct clk_si570 *data)
>>> +{
>>> + u8 reg[5];
>>> +
>>> + reg[0] = ((data->n1 - 1) << 6) |
>>> + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
>>> + reg[1] = (data->rfreq >> 24) & 0xff;
>>> + reg[2] = (data->rfreq >> 16) & 0xff;
>>> + reg[3] = (data->rfreq >> 8) & 0xff;
>>> + reg[4] = data->rfreq & 0xff;
>>> +
>>> + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
>>> + data->div_offset, reg, ARRAY_SIZE(reg));
>>> +}
>>> +
>>> +/**
>>> + * si570_calc_divs() - Caluclate clock dividers
>>> + * @frequency: Target frequency
>>> + * @data: Driver data structure
>>> + * @out_rfreq: RFREG fractional multiplier (output)
>>> + * @out_n1: Clock divider N1 (output)
>>> + * @out_hs_div: Clock divider HSDIV (output)
>>> + * Returns 0 on success, negative errno otherwise.
>>> + *
>>> + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
>>> + * (@out_rfreq) for a given target @frequency.
>>> + */
>>> +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
>>> + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
>>> +{
>>> + int i;
>>> + unsigned int n1, hs_div;
>>> + u64 fdco, best_fdco = ULLONG_MAX;
>>> + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
>>> +
>>> + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
>>> + hs_div = si570_hs_div_values[i];
>>> + /* Calculate lowest possible value for n1 */
>>> + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
>>> + if (!n1 || (n1 & 1))
>>> + n1++;
>>> + while (n1 <= 128) {
>>> + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
>>> + if (fdco > FDCO_MAX)
>>> + break;
>>> + if (fdco >= FDCO_MIN && fdco < best_fdco) {
>>> + *out_n1 = n1;
>>> + *out_hs_div = hs_div;
>>> + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
>>> + best_fdco = fdco;
>>> + }
>>> + n1 += (n1 == 1 ? 1 : 2);
>>> + }
>>> + }
>>> +
>>> + if (best_fdco == ULLONG_MAX)
>>> + return -EINVAL;
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static unsigned long si570_recalc_rate(struct clk_hw *hw,
>>> + unsigned long parent_rate)
>>> +{
>>> + int err;
>>> + u64 rfreq, rate;
>>> + unsigned int n1, hs_div;
>>> + struct clk_si570 *data = to_clk_si570(hw);
>>> +
>>> + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
>>> + if (err) {
>>> + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
>>> + return data->frequency;
>>> + }
>>> +
>>> + rfreq = div_u64(rfreq, hs_div * n1);
>>> + rate = (data->fxtal * rfreq) >> 28;
>>> +
>>> + return rate;
>>> +}
>>> +
>>> +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
>>> + unsigned long *parent_rate)
>>> +{
>>> + int err;
>>> + u64 rfreq;
>>> + unsigned int n1, hs_div;
>>> + struct clk_si570 *data = to_clk_si570(hw);
>>> +
>>> + if (!rate)
>>> + return 0;
>>> +
>>> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
>>> + data->frequency) < 35) {
>>> + rfreq = div64_u64((data->rfreq * rate) +
>>> + div64_u64(data->frequency, 2), data->frequency);
>>> + n1 = data->n1;
>>> + hs_div = data->hs_div;
>>> +
>>> + } else {
>>> + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
>>> + if (err) {
>>> + dev_err(&data->i2c_client->dev,
>>> + "unable to round rate\n");
>>> + return 0;
>>> + }
>>> + }
>>> +
>>> + return rate;
>>> +}
>>> +
>>> +/**
>>> + * si570_set_frequency() - Adjust output frequency
>>> + * @data: Driver data structure
>>> + * @frequency: Target frequency
>>> + * Returns 0 on success.
>>> + *
>>> + * Update output frequency for big frequency changes (> 3,500 ppm).
>>> + */
>>> +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
>>> +{
>>> + int err;
>>> +
>>> + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
>>> + &data->hs_div);
>>> + if (err)
>>> + return err;
>>> +
>>> + /*
>>> + * The DCO reg should be accessed with a read-modify-write operation
>>> + * per AN334
>>> + */
>>> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
>>> + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
>>> + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
>>> + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
>>> + si570_update_rfreq(data);
>>> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
>>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
>>> +
>>> + /* Applying a new frequency can take up to 10ms */
>>> + usleep_range(10000, 12000);
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +/**
>>> + * si570_set_frequency_small() - Adjust output frequency
>>> + * @data: Driver data structure
>>> + * @frequency: Target frequency
>>> + * Returns 0 on success.
>>> + *
>>> + * Update output frequency for small frequency changes (< 3,500 ppm).
>>> + */
>>> +static int si570_set_frequency_small(struct clk_si570 *data,
>>> + unsigned long frequency)
>>> +{
>>> + /*
>>> + * This is a re-implementation of DIV_ROUND_CLOSEST
>>> + * using the div64_u64 function lieu of letting the compiler
>>> + * insert EABI calls
>>> + */
>>> + data->rfreq = div64_u64((data->rfreq * frequency) +
>>> + div_u64(data->frequency, 2), data->frequency);
>>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
>>> + si570_update_rfreq(data);
>>> + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
>>> +
>>> + /* Applying a new frequency (small change) can take up to 100us */
>>> + usleep_range(100, 200);
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
>>> + unsigned long parent_rate)
>>> +{
>>> + struct clk_si570 *data = to_clk_si570(hw);
>>> + struct i2c_client *client = data->i2c_client;
>>> + int err;
>>> +
>>> + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
>>> + dev_err(&client->dev,
>>> + "requested frequency %lu Hz is out of range\n", rate);
>>> + return -EINVAL;
>>> + }
>>> +
>>> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
>>> + data->frequency) < 35)
>>> + err = si570_set_frequency_small(data, rate);
>>> + else
>>> + err = si570_set_frequency(data, rate);
>>> +
>>> + if (err)
>>> + return err;
>>> +
>>> + data->frequency = rate;
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static const struct clk_ops si570_clk_ops = {
>>> + .recalc_rate = si570_recalc_rate,
>>> + .round_rate = si570_round_rate,
>>> + .set_rate = si570_set_rate,
>>> +};
>>> +
>>> +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
>>> +{
>>> + switch (reg) {
>>> + case SI570_REG_CONTROL:
>>> + return true;
>>> + default:
>>> + return false;
>>> + }
>>> +}
>>> +
>>> +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
>>> +{
>>> + switch (reg) {
>>> + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
>>> + case SI570_REG_CONTROL:
>>> + case SI570_REG_FREEZE_DCO:
>>> + return true;
>>> + default:
>>> + return false;
>>> + }
>>> +}
>>> +
>>> +static struct regmap_config si570_regmap_config = {
>>> + .reg_bits = 8,
>>> + .val_bits = 8,
>>> + .cache_type = REGCACHE_RBTREE,
>>> + .max_register = 137,
>>> + .writeable_reg = si570_regmap_is_writeable,
>>> + .volatile_reg = si570_regmap_is_volatile,
>>> +};
>>> +
>>> +static int si570_probe(struct i2c_client *client,
>>> + const struct i2c_device_id *id)
>>> +{
>>> + struct clk_si570 *data;
>>> + struct clk_init_data init;
>>> + struct clk *clk;
>>> + u32 initial_fout, factory_fout, stability;
>>> + int err;
>>> + enum clk_si570_variant variant = id->driver_data;
>>> +
>>> + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
>>> + if (!data)
>>> + return -ENOMEM;
>>> +
>>> + init.ops = &si570_clk_ops;
>>> + init.flags = CLK_IS_ROOT;
>>> + init.num_parents = 0;
>>> + data->hw.init = &init;
>>> + data->i2c_client = client;
>>> +
>>> + if (variant == si57x) {
>>> + err = of_property_read_u32(client->dev.of_node,
>>> + "temperature-stability", &stability);
>>> + if (err) {
>>> + dev_err(&client->dev,
>>> + "'temperature-stability' property missing\n");
>>> + return err;
>>> + }
>>> + /* adjust register offsets for 7ppm devices */
>>> + if (stability == 7)
>>> + data->div_offset = SI570_DIV_OFFSET_7PPM;
>>> +
>>> + data->max_freq = SI570_MAX_FREQ;
>>> + } else {
>>> + data->max_freq = SI598_MAX_FREQ;
>>> + }
>>> +
>>> + if (of_property_read_string(client->dev.of_node, "clock-output-names",
>>> + &init.name))
>>> + init.name = client->dev.of_node->name;
>>> +
>>> + err = of_property_read_u32(client->dev.of_node, "factory-fout",
>>> + &factory_fout);
>>> + if (err) {
>>> + dev_err(&client->dev, "'factory-fout' property missing\n");
>>> + return err;
>>> + }
>>> +
>>> + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
>>> + if (IS_ERR(data->regmap)) {
>>> + dev_err(&client->dev, "failed to allocate register map\n");
>>> + return PTR_ERR(data->regmap);
>>> + }
>>> +
>>> + i2c_set_clientdata(client, data);
>>> + err = si570_get_defaults(data, factory_fout);
>>> + if (err)
>>> + return err;
>>> +
>>> + clk = devm_clk_register(&client->dev, &data->hw);
>>> + if (IS_ERR(clk)) {
>>> + dev_err(&client->dev, "clock registration failed\n");
>>> + return PTR_ERR(clk);
>>> + }
>>> + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
>>> + clk);
>>> + if (err) {
>>> + dev_err(&client->dev, "unable to add clk provider\n");
>>> + return err;
>>> + }
>>> +
>>> + /* Read the requested initial output frequency from device tree */
>>> + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
>>> + &initial_fout)) {
>>> + err = clk_set_rate(clk, initial_fout);
>>> + if (err) {
>>> + of_clk_del_provider(client->dev.of_node);
>>> + return err;
>>> + }
>>> + }
>>> +
>>> + /* Display a message indicating that we've successfully registered */
>>> + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
>>> + data->frequency);
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static int si570_remove(struct i2c_client *client)
>>> +{
>>> + of_clk_del_provider(client->dev.of_node);
>>> + return 0;
>>> +}
>>> +
>>> +static const struct i2c_device_id si570_id[] = {
>>> + { "si570", si57x },
>>> + { "si571", si57x },
>>> + { "si598", si59x },
>>> + { "si599", si59x },
>>> + { }
>>> +};
>>> +MODULE_DEVICE_TABLE(i2c, si570_id);
>>> +
>>> +static const struct of_device_id clk_si570_of_match[] = {
>>> + { .compatible = "silabs,si570" },
>>> + { .compatible = "silabs,si571" },
>>> + { .compatible = "silabs,si598" },
>>> + { .compatible = "silabs,si599" },
>>> + { },
>>> +};
>>> +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
>>> +
>>> +static struct i2c_driver si570_driver = {
>>> + .driver = {
>>> + .name = "si570",
>>> + .of_match_table = of_match_ptr(clk_si570_of_match),
>>> + },
>>> + .probe = si570_probe,
>>> + .remove = si570_remove,
>>> + .id_table = si570_id,
>>> +};
>>> +module_i2c_driver(si570_driver);
>>> +
>>> +MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
>>> +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
>>> +MODULE_DESCRIPTION("Si570 driver");
>>> +MODULE_LICENSE("GPL");
>>> --
>>> 1.8.4
>>>
>>>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
> the body of a message to majordomo at vger.kernel.org
> More majordomo info at http://vger.kernel.org/majordomo-info.html
> Please read the FAQ at http://www.tux.org/lkml/
>
>
>
>
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
2013-12-14 16:33 ` Guenter Roeck
(?)
@ 2013-12-16 17:03 ` Sören Brinkmann
-1 siblings, 0 replies; 27+ messages in thread
From: Sören Brinkmann @ 2013-12-16 17:03 UTC (permalink / raw)
To: Guenter Roeck
Cc: Mike Turquette, Rob Herring, Pawel Moll, Mark Rutland,
Stephen Warren, devicetree, linux-doc, linux-kernel,
linux-arm-kernel, Hyun Kwon
Hi Guenther, Mike,
On Sat, Dec 14, 2013 at 08:33:27AM -0800, Guenter Roeck wrote:
> On 10/02/2013 04:17 PM, Mike Turquette wrote:
> >Quoting Sören Brinkmann (2013-10-02 10:20:38)
> >>Hi Mike,
> >>
> >>could you please comment on this/apply it to clk-next?
> >
> >It looks good and is in the queue. Will show up in clk-next in a few
> >days.
> >
> Hi Mike,
>
> trying again ... what happened with this driver ? Any reason for not pushing it after all ?
I've been waiting for it to appear in clk-next for a while too. I just
fetched the repo and it's there.
Thanks Guenter for following up and Mike for applying.
Sören
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-12-16 17:03 ` Sören Brinkmann
0 siblings, 0 replies; 27+ messages in thread
From: Sören Brinkmann @ 2013-12-16 17:03 UTC (permalink / raw)
To: Guenter Roeck
Cc: Mike Turquette, Rob Herring, Pawel Moll, Mark Rutland,
Stephen Warren, devicetree, linux-doc, linux-kernel,
linux-arm-kernel, Hyun Kwon
Hi Guenther, Mike,
On Sat, Dec 14, 2013 at 08:33:27AM -0800, Guenter Roeck wrote:
> On 10/02/2013 04:17 PM, Mike Turquette wrote:
> >Quoting Sören Brinkmann (2013-10-02 10:20:38)
> >>Hi Mike,
> >>
> >>could you please comment on this/apply it to clk-next?
> >
> >It looks good and is in the queue. Will show up in clk-next in a few
> >days.
> >
> Hi Mike,
>
> trying again ... what happened with this driver ? Any reason for not pushing it after all ?
I've been waiting for it to appear in clk-next for a while too. I just
fetched the repo and it's there.
Thanks Guenter for following up and Mike for applying.
Sören
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-12-16 17:03 ` Sören Brinkmann
0 siblings, 0 replies; 27+ messages in thread
From: Sören Brinkmann @ 2013-12-16 17:03 UTC (permalink / raw)
To: linux-arm-kernel
Hi Guenther, Mike,
On Sat, Dec 14, 2013 at 08:33:27AM -0800, Guenter Roeck wrote:
> On 10/02/2013 04:17 PM, Mike Turquette wrote:
> >Quoting S?ren Brinkmann (2013-10-02 10:20:38)
> >>Hi Mike,
> >>
> >>could you please comment on this/apply it to clk-next?
> >
> >It looks good and is in the queue. Will show up in clk-next in a few
> >days.
> >
> Hi Mike,
>
> trying again ... what happened with this driver ? Any reason for not pushing it after all ?
I've been waiting for it to appear in clk-next for a while too. I just
fetched the repo and it's there.
Thanks Guenter for following up and Mike for applying.
S?ren
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
2013-12-16 17:03 ` Sören Brinkmann
@ 2013-12-16 17:28 ` Guenter Roeck
-1 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-12-16 17:28 UTC (permalink / raw)
To: Sören Brinkmann
Cc: Mike Turquette, Rob Herring, Pawel Moll, Mark Rutland,
Stephen Warren, devicetree, linux-doc, linux-kernel,
linux-arm-kernel, Hyun Kwon
On Mon, Dec 16, 2013 at 09:03:02AM -0800, Sören Brinkmann wrote:
> Hi Guenther, Mike,
>
> On Sat, Dec 14, 2013 at 08:33:27AM -0800, Guenter Roeck wrote:
> > On 10/02/2013 04:17 PM, Mike Turquette wrote:
> > >Quoting Sören Brinkmann (2013-10-02 10:20:38)
> > >>Hi Mike,
> > >>
> > >>could you please comment on this/apply it to clk-next?
> > >
> > >It looks good and is in the queue. Will show up in clk-next in a few
> > >days.
> > >
> > Hi Mike,
> >
> > trying again ... what happened with this driver ? Any reason for not pushing it after all ?
>
> I've been waiting for it to appear in clk-next for a while too. I just
> fetched the repo and it's there.
> Thanks Guenter for following up and Mike for applying.
>
Great!
Thanks,
Guenter
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-12-16 17:28 ` Guenter Roeck
0 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-12-16 17:28 UTC (permalink / raw)
To: linux-arm-kernel
On Mon, Dec 16, 2013 at 09:03:02AM -0800, S?ren Brinkmann wrote:
> Hi Guenther, Mike,
>
> On Sat, Dec 14, 2013 at 08:33:27AM -0800, Guenter Roeck wrote:
> > On 10/02/2013 04:17 PM, Mike Turquette wrote:
> > >Quoting S?ren Brinkmann (2013-10-02 10:20:38)
> > >>Hi Mike,
> > >>
> > >>could you please comment on this/apply it to clk-next?
> > >
> > >It looks good and is in the queue. Will show up in clk-next in a few
> > >days.
> > >
> > Hi Mike,
> >
> > trying again ... what happened with this driver ? Any reason for not pushing it after all ?
>
> I've been waiting for it to appear in clk-next for a while too. I just
> fetched the repo and it's there.
> Thanks Guenter for following up and Mike for applying.
>
Great!
Thanks,
Guenter
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
2013-12-14 16:33 ` Guenter Roeck
@ 2013-12-17 23:43 ` Mike Turquette
-1 siblings, 0 replies; 27+ messages in thread
From: Mike Turquette @ 2013-12-17 23:43 UTC (permalink / raw)
To: Guenter Roeck, Sören Brinkmann, Rob Herring, Pawel Moll,
Mark Rutland, Stephen Warren
Cc: devicetree, linux-doc, linux-kernel, linux-arm-kernel, Hyun Kwon
Quoting Guenter Roeck (2013-12-14 08:33:27)
> On 10/02/2013 04:17 PM, Mike Turquette wrote:
> > Quoting Sören Brinkmann (2013-10-02 10:20:38)
> >> Hi Mike,
> >>
> >> could you please comment on this/apply it to clk-next?
> >
> > It looks good and is in the queue. Will show up in clk-next in a few
> > days.
> >
> Hi Mike,
>
> trying again ... what happened with this driver ? Any reason for not pushing it after all ?
This got reverted with several other patches right before 3.12 dropped.
Unfortunately clk-next broke linux-next two days before 3.12 came out
and I had to revert to a known good state, excluding this driver.
I've added it back to clk-next now towards 3.13. Sorry for the
inconvenience.
Regards,
Mike
>
> Thanks,
> Guenter
>
> > Thanks,
> > Mike
> >
> >>
> >> Thanks,
> >> Sören
> >>
> >> On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
> >>> Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> >>> The devices generate low-jitter clock signals and are reprogrammable via
> >>> an I2C interface.
> >>>
> >>> Cc: Guenter Roeck <linux@roeck-us.net>
> >>> Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
> >>> ---
> >>> v5:
> >>> - fix typo in bindings documentation
> >>> - mention the unit for the 'temperature-stability' property
> >>> - remove calls to clk_unregister() (the device managed code takes care
> >>> of it)
> >>>
> >>> v4:
> >>> - actually check and handle error on clk_set_rate() call
> >>>
> >>> v3:
> >>> - add delay in the path for small frequency changes, which can take up
> >>> to 100us according to the data sheet
> >>> - use real range for usleep_range() argument
> >>> - use dev_err() over dev_warn() in set_rate()
> >>> - add list of applicable devices for 7ppm DT prop
> >>> - remove comments regarding platform data
> >>> - ignore 7ppm DT prop for incompatible devices
> >>> - replace raw numbers with #defines
> >>> - convert DT prop 'temperature-stability' from boolean to u32
> >>> - make 'temperature-stability' DT prop required (actually not fully
> >>> true, for 59x it is ignored and the driver does not require its
> >>> presence)
> >>>
> >>> v2:
> >>> - document clock-output-names in bindings documentation
> >>> - don't use wildcards in compatibility string
> >>> - change Kconfig entry to "... 570 and compatible devices"
> >>> - change some indentation flaws
> >>> - use 10000 as MIN and MAX value in usleep_range
> >>> - fail probe() if 'factory-fout' is not provided in DT
> >>> - default factory fout #defines removed
> >>> - use i2c driver_data instead of OF data
> >>> - remove some related structs and data
> >>> - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
> >>> driver)
> >>> - add some more details regarding the 'factory-fout' DT property
> >>> ---
> >>> .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
> >>> drivers/clk/Kconfig | 10 +
> >>> drivers/clk/Makefile | 1 +
> >>> drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
> >>> 4 files changed, 581 insertions(+)
> >>> create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
> >>> create mode 100644 drivers/clk/clk-si570.c
> >>>
> >>> diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> >>> new file mode 100644
> >>> index 0000000..c09f21e
> >>> --- /dev/null
> >>> +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> >>> @@ -0,0 +1,39 @@
> >>> +Binding for Silicon Labs 570, 571, 598 and 599 programmable
> >>> +I2C clock generators.
> >>> +
> >>> +Reference
> >>> +This binding uses the common clock binding[1]. Details about the devices can be
> >>> +found in the data sheets[2][3].
> >>> +
> >>> +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
> >>> +[2] Si570/571 Data Sheet
> >>> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
> >>> +[3] Si598/599 Data Sheet
> >>> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
> >>> +
> >>> +Required properties:
> >>> + - compatible: Shall be one of "silabs,si570", "silabs,si571",
> >>> + "silabs,si598", "silabs,si599"
> >>> + - reg: I2C device address.
> >>> + - #clock-cells: From common clock bindings: Shall be 0.
> >>> + - factory-fout: Factory set default frequency. This frequency is part specific.
> >>> + The correct frequency for the part used has to be provided in
> >>> + order to generate the correct output frequencies. For more
> >>> + details, please refer to the data sheet.
> >>> + - temperature-stability: Temperature stability of the device in PPM. Should be
> >>> + one of: 7, 20, 50 or 100.
> >>> +
> >>> +Optional properties:
> >>> + - clock-output-names: From common clock bindings. Recommended to be "si570".
> >>> + - clock-frequency: Output frequency to generate. This defines the output
> >>> + frequency set during boot. It can be reprogrammed during
> >>> + runtime through the common clock framework.
> >>> +
> >>> +Example:
> >>> + si570: clock-generator@5d {
> >>> + #clock-cells = <0>;
> >>> + compatible = "silabs,si570";
> >>> + temperature-stability = <50>;
> >>> + reg = <0x5d>;
> >>> + factory-fout = <156250000>;
> >>> + };
> >>> diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
> >>> index 279407a..349b88a 100644
> >>> --- a/drivers/clk/Kconfig
> >>> +++ b/drivers/clk/Kconfig
> >>> @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
> >>> This driver supports Silicon Labs 5351A/B/C programmable clock
> >>> generators.
> >>>
> >>> +config COMMON_CLK_SI570
> >>> + tristate "Clock driver for SiLabs 570 and compatible devices"
> >>> + depends on I2C
> >>> + depends on OF
> >>> + select REGMAP_I2C
> >>> + help
> >>> + ---help---
> >>> + This driver supports Silicon Labs 570/571/598/599 programmable
> >>> + clock generators.
> >>> +
> >>> config COMMON_CLK_S2MPS11
> >>> tristate "Clock driver for S2MPS11 MFD"
> >>> depends on MFD_SEC_CORE
> >>> diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
> >>> index 7b11106..c0e94b3 100644
> >>> --- a/drivers/clk/Makefile
> >>> +++ b/drivers/clk/Makefile
> >>> @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
> >>> obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
> >>> obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
> >>> obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
> >>> +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
> >>> obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
> >>> obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
> >>> obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
> >>> diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
> >>> new file mode 100644
> >>> index 0000000..5d0ac9f
> >>> --- /dev/null
> >>> +++ b/drivers/clk/clk-si570.c
> >>> @@ -0,0 +1,531 @@
> >>> +/*
> >>> + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
> >>> + *
> >>> + * Copyright (C) 2010, 2011 Ericsson AB.
> >>> + * Copyright (C) 2011 Guenter Roeck.
> >>> + * Copyright (C) 2011 - 2013 Xilinx Inc.
> >>> + *
> >>> + * Author: Guenter Roeck <guenter.roeck@ericsson.com>
> >>> + * Sören Brinkmann <soren.brinkmann@xilinx.com>
> >>> + *
> >>> + * This program is free software; you can redistribute it and/or modify
> >>> + * it under the terms of the GNU General Public License as published by
> >>> + * the Free Software Foundation; either version 2 of the License, or
> >>> + * (at your option) any later version.
> >>> + *
> >>> + * This program is distributed in the hope that it will be useful,
> >>> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> >>> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
> >>> + * GNU General Public License for more details.
> >>> + */
> >>> +
> >>> +#include <linux/clk-provider.h>
> >>> +#include <linux/delay.h>
> >>> +#include <linux/module.h>
> >>> +#include <linux/i2c.h>
> >>> +#include <linux/regmap.h>
> >>> +#include <linux/slab.h>
> >>> +
> >>> +/* Si570 registers */
> >>> +#define SI570_REG_HS_N1 7
> >>> +#define SI570_REG_N1_RFREQ0 8
> >>> +#define SI570_REG_RFREQ1 9
> >>> +#define SI570_REG_RFREQ2 10
> >>> +#define SI570_REG_RFREQ3 11
> >>> +#define SI570_REG_RFREQ4 12
> >>> +#define SI570_REG_CONTROL 135
> >>> +#define SI570_REG_FREEZE_DCO 137
> >>> +#define SI570_DIV_OFFSET_7PPM 6
> >>> +
> >>> +#define HS_DIV_SHIFT 5
> >>> +#define HS_DIV_MASK 0xe0
> >>> +#define HS_DIV_OFFSET 4
> >>> +#define N1_6_2_MASK 0x1f
> >>> +#define N1_1_0_MASK 0xc0
> >>> +#define RFREQ_37_32_MASK 0x3f
> >>> +
> >>> +#define SI570_MIN_FREQ 10000000L
> >>> +#define SI570_MAX_FREQ 1417500000L
> >>> +#define SI598_MAX_FREQ 525000000L
> >>> +
> >>> +#define FDCO_MIN 4850000000LL
> >>> +#define FDCO_MAX 5670000000LL
> >>> +
> >>> +#define SI570_CNTRL_RECALL (1 << 0)
> >>> +#define SI570_CNTRL_FREEZE_M (1 << 5)
> >>> +#define SI570_CNTRL_NEWFREQ (1 << 6)
> >>> +
> >>> +#define SI570_FREEZE_DCO (1 << 4)
> >>> +
> >>> +/**
> >>> + * struct clk_si570:
> >>> + * @hw: Clock hw struct
> >>> + * @regmap: Device's regmap
> >>> + * @div_offset: Rgister offset for dividers
> >>> + * @max_freq: Maximum frequency for this device
> >>> + * @fxtal: Factory xtal frequency
> >>> + * @n1: Clock divider N1
> >>> + * @hs_div: Clock divider HSDIV
> >>> + * @rfreq: Clock multiplier RFREQ
> >>> + * @frequency: Current output frequency
> >>> + * @i2c_client: I2C client pointer
> >>> + */
> >>> +struct clk_si570 {
> >>> + struct clk_hw hw;
> >>> + struct regmap *regmap;
> >>> + unsigned int div_offset;
> >>> + u64 max_freq;
> >>> + u64 fxtal;
> >>> + unsigned int n1;
> >>> + unsigned int hs_div;
> >>> + u64 rfreq;
> >>> + u64 frequency;
> >>> + struct i2c_client *i2c_client;
> >>> +};
> >>> +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
> >>> +
> >>> +enum clk_si570_variant {
> >>> + si57x,
> >>> + si59x
> >>> +};
> >>> +
> >>> +/**
> >>> + * si570_get_divs() - Read clock dividers from HW
> >>> + * @data: Pointer to struct clk_si570
> >>> + * @rfreq: Fractional multiplier (output)
> >>> + * @n1: Divider N1 (output)
> >>> + * @hs_div: Divider HSDIV (output)
> >>> + * Returns 0 on success, negative errno otherwise.
> >>> + *
> >>> + * Retrieve clock dividers and multipliers from the HW.
> >>> + */
> >>> +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
> >>> + unsigned int *n1, unsigned int *hs_div)
> >>> +{
> >>> + int err;
> >>> + u8 reg[6];
> >>> + u64 tmp;
> >>> +
> >>> + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> >>> + reg, ARRAY_SIZE(reg));
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
> >>> + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
> >>> + /* Handle invalid cases */
> >>> + if (*n1 > 1)
> >>> + *n1 &= ~1;
> >>> +
> >>> + tmp = reg[1] & RFREQ_37_32_MASK;
> >>> + tmp = (tmp << 8) + reg[2];
> >>> + tmp = (tmp << 8) + reg[3];
> >>> + tmp = (tmp << 8) + reg[4];
> >>> + tmp = (tmp << 8) + reg[5];
> >>> + *rfreq = tmp;
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_get_defaults() - Get default values
> >>> + * @data: Driver data structure
> >>> + * @fout: Factory frequency output
> >>> + * Returns 0 on success, negative errno otherwise.
> >>> + */
> >>> +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
> >>> +{
> >>> + int err;
> >>> + u64 fdco;
> >>> +
> >>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
> >>> +
> >>> + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + /*
> >>> + * Accept optional precision loss to avoid arithmetic overflows.
> >>> + * Acceptable per Silicon Labs Application Note AN334.
> >>> + */
> >>> + fdco = fout * data->n1 * data->hs_div;
> >>> + if (fdco >= (1LL << 36))
> >>> + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
> >>> + else
> >>> + data->fxtal = div64_u64(fdco << 28, data->rfreq);
> >>> +
> >>> + data->frequency = fout;
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_update_rfreq() - Update clock multiplier
> >>> + * @data: Driver data structure
> >>> + * Passes on regmap_bulk_write() return value.
> >>> + */
> >>> +static int si570_update_rfreq(struct clk_si570 *data)
> >>> +{
> >>> + u8 reg[5];
> >>> +
> >>> + reg[0] = ((data->n1 - 1) << 6) |
> >>> + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
> >>> + reg[1] = (data->rfreq >> 24) & 0xff;
> >>> + reg[2] = (data->rfreq >> 16) & 0xff;
> >>> + reg[3] = (data->rfreq >> 8) & 0xff;
> >>> + reg[4] = data->rfreq & 0xff;
> >>> +
> >>> + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
> >>> + data->div_offset, reg, ARRAY_SIZE(reg));
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_calc_divs() - Caluclate clock dividers
> >>> + * @frequency: Target frequency
> >>> + * @data: Driver data structure
> >>> + * @out_rfreq: RFREG fractional multiplier (output)
> >>> + * @out_n1: Clock divider N1 (output)
> >>> + * @out_hs_div: Clock divider HSDIV (output)
> >>> + * Returns 0 on success, negative errno otherwise.
> >>> + *
> >>> + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
> >>> + * (@out_rfreq) for a given target @frequency.
> >>> + */
> >>> +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
> >>> + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
> >>> +{
> >>> + int i;
> >>> + unsigned int n1, hs_div;
> >>> + u64 fdco, best_fdco = ULLONG_MAX;
> >>> + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
> >>> +
> >>> + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
> >>> + hs_div = si570_hs_div_values[i];
> >>> + /* Calculate lowest possible value for n1 */
> >>> + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
> >>> + if (!n1 || (n1 & 1))
> >>> + n1++;
> >>> + while (n1 <= 128) {
> >>> + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
> >>> + if (fdco > FDCO_MAX)
> >>> + break;
> >>> + if (fdco >= FDCO_MIN && fdco < best_fdco) {
> >>> + *out_n1 = n1;
> >>> + *out_hs_div = hs_div;
> >>> + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
> >>> + best_fdco = fdco;
> >>> + }
> >>> + n1 += (n1 == 1 ? 1 : 2);
> >>> + }
> >>> + }
> >>> +
> >>> + if (best_fdco == ULLONG_MAX)
> >>> + return -EINVAL;
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static unsigned long si570_recalc_rate(struct clk_hw *hw,
> >>> + unsigned long parent_rate)
> >>> +{
> >>> + int err;
> >>> + u64 rfreq, rate;
> >>> + unsigned int n1, hs_div;
> >>> + struct clk_si570 *data = to_clk_si570(hw);
> >>> +
> >>> + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
> >>> + if (err) {
> >>> + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
> >>> + return data->frequency;
> >>> + }
> >>> +
> >>> + rfreq = div_u64(rfreq, hs_div * n1);
> >>> + rate = (data->fxtal * rfreq) >> 28;
> >>> +
> >>> + return rate;
> >>> +}
> >>> +
> >>> +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
> >>> + unsigned long *parent_rate)
> >>> +{
> >>> + int err;
> >>> + u64 rfreq;
> >>> + unsigned int n1, hs_div;
> >>> + struct clk_si570 *data = to_clk_si570(hw);
> >>> +
> >>> + if (!rate)
> >>> + return 0;
> >>> +
> >>> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> >>> + data->frequency) < 35) {
> >>> + rfreq = div64_u64((data->rfreq * rate) +
> >>> + div64_u64(data->frequency, 2), data->frequency);
> >>> + n1 = data->n1;
> >>> + hs_div = data->hs_div;
> >>> +
> >>> + } else {
> >>> + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
> >>> + if (err) {
> >>> + dev_err(&data->i2c_client->dev,
> >>> + "unable to round rate\n");
> >>> + return 0;
> >>> + }
> >>> + }
> >>> +
> >>> + return rate;
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_set_frequency() - Adjust output frequency
> >>> + * @data: Driver data structure
> >>> + * @frequency: Target frequency
> >>> + * Returns 0 on success.
> >>> + *
> >>> + * Update output frequency for big frequency changes (> 3,500 ppm).
> >>> + */
> >>> +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
> >>> +{
> >>> + int err;
> >>> +
> >>> + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
> >>> + &data->hs_div);
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + /*
> >>> + * The DCO reg should be accessed with a read-modify-write operation
> >>> + * per AN334
> >>> + */
> >>> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
> >>> + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> >>> + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
> >>> + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
> >>> + si570_update_rfreq(data);
> >>> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
> >>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
> >>> +
> >>> + /* Applying a new frequency can take up to 10ms */
> >>> + usleep_range(10000, 12000);
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_set_frequency_small() - Adjust output frequency
> >>> + * @data: Driver data structure
> >>> + * @frequency: Target frequency
> >>> + * Returns 0 on success.
> >>> + *
> >>> + * Update output frequency for small frequency changes (< 3,500 ppm).
> >>> + */
> >>> +static int si570_set_frequency_small(struct clk_si570 *data,
> >>> + unsigned long frequency)
> >>> +{
> >>> + /*
> >>> + * This is a re-implementation of DIV_ROUND_CLOSEST
> >>> + * using the div64_u64 function lieu of letting the compiler
> >>> + * insert EABI calls
> >>> + */
> >>> + data->rfreq = div64_u64((data->rfreq * frequency) +
> >>> + div_u64(data->frequency, 2), data->frequency);
> >>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
> >>> + si570_update_rfreq(data);
> >>> + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
> >>> +
> >>> + /* Applying a new frequency (small change) can take up to 100us */
> >>> + usleep_range(100, 200);
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
> >>> + unsigned long parent_rate)
> >>> +{
> >>> + struct clk_si570 *data = to_clk_si570(hw);
> >>> + struct i2c_client *client = data->i2c_client;
> >>> + int err;
> >>> +
> >>> + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
> >>> + dev_err(&client->dev,
> >>> + "requested frequency %lu Hz is out of range\n", rate);
> >>> + return -EINVAL;
> >>> + }
> >>> +
> >>> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> >>> + data->frequency) < 35)
> >>> + err = si570_set_frequency_small(data, rate);
> >>> + else
> >>> + err = si570_set_frequency(data, rate);
> >>> +
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + data->frequency = rate;
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static const struct clk_ops si570_clk_ops = {
> >>> + .recalc_rate = si570_recalc_rate,
> >>> + .round_rate = si570_round_rate,
> >>> + .set_rate = si570_set_rate,
> >>> +};
> >>> +
> >>> +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
> >>> +{
> >>> + switch (reg) {
> >>> + case SI570_REG_CONTROL:
> >>> + return true;
> >>> + default:
> >>> + return false;
> >>> + }
> >>> +}
> >>> +
> >>> +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
> >>> +{
> >>> + switch (reg) {
> >>> + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
> >>> + case SI570_REG_CONTROL:
> >>> + case SI570_REG_FREEZE_DCO:
> >>> + return true;
> >>> + default:
> >>> + return false;
> >>> + }
> >>> +}
> >>> +
> >>> +static struct regmap_config si570_regmap_config = {
> >>> + .reg_bits = 8,
> >>> + .val_bits = 8,
> >>> + .cache_type = REGCACHE_RBTREE,
> >>> + .max_register = 137,
> >>> + .writeable_reg = si570_regmap_is_writeable,
> >>> + .volatile_reg = si570_regmap_is_volatile,
> >>> +};
> >>> +
> >>> +static int si570_probe(struct i2c_client *client,
> >>> + const struct i2c_device_id *id)
> >>> +{
> >>> + struct clk_si570 *data;
> >>> + struct clk_init_data init;
> >>> + struct clk *clk;
> >>> + u32 initial_fout, factory_fout, stability;
> >>> + int err;
> >>> + enum clk_si570_variant variant = id->driver_data;
> >>> +
> >>> + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
> >>> + if (!data)
> >>> + return -ENOMEM;
> >>> +
> >>> + init.ops = &si570_clk_ops;
> >>> + init.flags = CLK_IS_ROOT;
> >>> + init.num_parents = 0;
> >>> + data->hw.init = &init;
> >>> + data->i2c_client = client;
> >>> +
> >>> + if (variant == si57x) {
> >>> + err = of_property_read_u32(client->dev.of_node,
> >>> + "temperature-stability", &stability);
> >>> + if (err) {
> >>> + dev_err(&client->dev,
> >>> + "'temperature-stability' property missing\n");
> >>> + return err;
> >>> + }
> >>> + /* adjust register offsets for 7ppm devices */
> >>> + if (stability == 7)
> >>> + data->div_offset = SI570_DIV_OFFSET_7PPM;
> >>> +
> >>> + data->max_freq = SI570_MAX_FREQ;
> >>> + } else {
> >>> + data->max_freq = SI598_MAX_FREQ;
> >>> + }
> >>> +
> >>> + if (of_property_read_string(client->dev.of_node, "clock-output-names",
> >>> + &init.name))
> >>> + init.name = client->dev.of_node->name;
> >>> +
> >>> + err = of_property_read_u32(client->dev.of_node, "factory-fout",
> >>> + &factory_fout);
> >>> + if (err) {
> >>> + dev_err(&client->dev, "'factory-fout' property missing\n");
> >>> + return err;
> >>> + }
> >>> +
> >>> + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
> >>> + if (IS_ERR(data->regmap)) {
> >>> + dev_err(&client->dev, "failed to allocate register map\n");
> >>> + return PTR_ERR(data->regmap);
> >>> + }
> >>> +
> >>> + i2c_set_clientdata(client, data);
> >>> + err = si570_get_defaults(data, factory_fout);
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + clk = devm_clk_register(&client->dev, &data->hw);
> >>> + if (IS_ERR(clk)) {
> >>> + dev_err(&client->dev, "clock registration failed\n");
> >>> + return PTR_ERR(clk);
> >>> + }
> >>> + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
> >>> + clk);
> >>> + if (err) {
> >>> + dev_err(&client->dev, "unable to add clk provider\n");
> >>> + return err;
> >>> + }
> >>> +
> >>> + /* Read the requested initial output frequency from device tree */
> >>> + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
> >>> + &initial_fout)) {
> >>> + err = clk_set_rate(clk, initial_fout);
> >>> + if (err) {
> >>> + of_clk_del_provider(client->dev.of_node);
> >>> + return err;
> >>> + }
> >>> + }
> >>> +
> >>> + /* Display a message indicating that we've successfully registered */
> >>> + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
> >>> + data->frequency);
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static int si570_remove(struct i2c_client *client)
> >>> +{
> >>> + of_clk_del_provider(client->dev.of_node);
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static const struct i2c_device_id si570_id[] = {
> >>> + { "si570", si57x },
> >>> + { "si571", si57x },
> >>> + { "si598", si59x },
> >>> + { "si599", si59x },
> >>> + { }
> >>> +};
> >>> +MODULE_DEVICE_TABLE(i2c, si570_id);
> >>> +
> >>> +static const struct of_device_id clk_si570_of_match[] = {
> >>> + { .compatible = "silabs,si570" },
> >>> + { .compatible = "silabs,si571" },
> >>> + { .compatible = "silabs,si598" },
> >>> + { .compatible = "silabs,si599" },
> >>> + { },
> >>> +};
> >>> +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
> >>> +
> >>> +static struct i2c_driver si570_driver = {
> >>> + .driver = {
> >>> + .name = "si570",
> >>> + .of_match_table = of_match_ptr(clk_si570_of_match),
> >>> + },
> >>> + .probe = si570_probe,
> >>> + .remove = si570_remove,
> >>> + .id_table = si570_id,
> >>> +};
> >>> +module_i2c_driver(si570_driver);
> >>> +
> >>> +MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
> >>> +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
> >>> +MODULE_DESCRIPTION("Si570 driver");
> >>> +MODULE_LICENSE("GPL");
> >>> --
> >>> 1.8.4
> >>>
> >>>
> > --
> > To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
> > the body of a message to majordomo@vger.kernel.org
> > More majordomo info at http://vger.kernel.org/majordomo-info.html
> > Please read the FAQ at http://www.tux.org/lkml/
> >
> >
> >
> >
>
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-12-17 23:43 ` Mike Turquette
0 siblings, 0 replies; 27+ messages in thread
From: Mike Turquette @ 2013-12-17 23:43 UTC (permalink / raw)
To: linux-arm-kernel
Quoting Guenter Roeck (2013-12-14 08:33:27)
> On 10/02/2013 04:17 PM, Mike Turquette wrote:
> > Quoting S?ren Brinkmann (2013-10-02 10:20:38)
> >> Hi Mike,
> >>
> >> could you please comment on this/apply it to clk-next?
> >
> > It looks good and is in the queue. Will show up in clk-next in a few
> > days.
> >
> Hi Mike,
>
> trying again ... what happened with this driver ? Any reason for not pushing it after all ?
This got reverted with several other patches right before 3.12 dropped.
Unfortunately clk-next broke linux-next two days before 3.12 came out
and I had to revert to a known good state, excluding this driver.
I've added it back to clk-next now towards 3.13. Sorry for the
inconvenience.
Regards,
Mike
>
> Thanks,
> Guenter
>
> > Thanks,
> > Mike
> >
> >>
> >> Thanks,
> >> S?ren
> >>
> >> On Sat, Sep 21, 2013 at 04:40:39PM -0700, Soren Brinkmann wrote:
> >>> Add a driver for SILabs 570, 571, 598, 599 programmable oscillators.
> >>> The devices generate low-jitter clock signals and are reprogrammable via
> >>> an I2C interface.
> >>>
> >>> Cc: Guenter Roeck <linux@roeck-us.net>
> >>> Signed-off-by: Soren Brinkmann <soren.brinkmann@xilinx.com>
> >>> ---
> >>> v5:
> >>> - fix typo in bindings documentation
> >>> - mention the unit for the 'temperature-stability' property
> >>> - remove calls to clk_unregister() (the device managed code takes care
> >>> of it)
> >>>
> >>> v4:
> >>> - actually check and handle error on clk_set_rate() call
> >>>
> >>> v3:
> >>> - add delay in the path for small frequency changes, which can take up
> >>> to 100us according to the data sheet
> >>> - use real range for usleep_range() argument
> >>> - use dev_err() over dev_warn() in set_rate()
> >>> - add list of applicable devices for 7ppm DT prop
> >>> - remove comments regarding platform data
> >>> - ignore 7ppm DT prop for incompatible devices
> >>> - replace raw numbers with #defines
> >>> - convert DT prop 'temperature-stability' from boolean to u32
> >>> - make 'temperature-stability' DT prop required (actually not fully
> >>> true, for 59x it is ignored and the driver does not require its
> >>> presence)
> >>>
> >>> v2:
> >>> - document clock-output-names in bindings documentation
> >>> - don't use wildcards in compatibility string
> >>> - change Kconfig entry to "... 570 and compatible devices"
> >>> - change some indentation flaws
> >>> - use 10000 as MIN and MAX value in usleep_range
> >>> - fail probe() if 'factory-fout' is not provided in DT
> >>> - default factory fout #defines removed
> >>> - use i2c driver_data instead of OF data
> >>> - remove some related structs and data
> >>> - rename DT property 'initial-fout' => 'clock-frequency' (like si5351
> >>> driver)
> >>> - add some more details regarding the 'factory-fout' DT property
> >>> ---
> >>> .../devicetree/bindings/clock/silabs,si570.txt | 39 ++
> >>> drivers/clk/Kconfig | 10 +
> >>> drivers/clk/Makefile | 1 +
> >>> drivers/clk/clk-si570.c | 531 +++++++++++++++++++++
> >>> 4 files changed, 581 insertions(+)
> >>> create mode 100644 Documentation/devicetree/bindings/clock/silabs,si570.txt
> >>> create mode 100644 drivers/clk/clk-si570.c
> >>>
> >>> diff --git a/Documentation/devicetree/bindings/clock/silabs,si570.txt b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> >>> new file mode 100644
> >>> index 0000000..c09f21e
> >>> --- /dev/null
> >>> +++ b/Documentation/devicetree/bindings/clock/silabs,si570.txt
> >>> @@ -0,0 +1,39 @@
> >>> +Binding for Silicon Labs 570, 571, 598 and 599 programmable
> >>> +I2C clock generators.
> >>> +
> >>> +Reference
> >>> +This binding uses the common clock binding[1]. Details about the devices can be
> >>> +found in the data sheets[2][3].
> >>> +
> >>> +[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
> >>> +[2] Si570/571 Data Sheet
> >>> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si570.pdf
> >>> +[3] Si598/599 Data Sheet
> >>> + http://www.silabs.com/Support%20Documents/TechnicalDocs/si598-99.pdf
> >>> +
> >>> +Required properties:
> >>> + - compatible: Shall be one of "silabs,si570", "silabs,si571",
> >>> + "silabs,si598", "silabs,si599"
> >>> + - reg: I2C device address.
> >>> + - #clock-cells: From common clock bindings: Shall be 0.
> >>> + - factory-fout: Factory set default frequency. This frequency is part specific.
> >>> + The correct frequency for the part used has to be provided in
> >>> + order to generate the correct output frequencies. For more
> >>> + details, please refer to the data sheet.
> >>> + - temperature-stability: Temperature stability of the device in PPM. Should be
> >>> + one of: 7, 20, 50 or 100.
> >>> +
> >>> +Optional properties:
> >>> + - clock-output-names: From common clock bindings. Recommended to be "si570".
> >>> + - clock-frequency: Output frequency to generate. This defines the output
> >>> + frequency set during boot. It can be reprogrammed during
> >>> + runtime through the common clock framework.
> >>> +
> >>> +Example:
> >>> + si570: clock-generator at 5d {
> >>> + #clock-cells = <0>;
> >>> + compatible = "silabs,si570";
> >>> + temperature-stability = <50>;
> >>> + reg = <0x5d>;
> >>> + factory-fout = <156250000>;
> >>> + };
> >>> diff --git a/drivers/clk/Kconfig b/drivers/clk/Kconfig
> >>> index 279407a..349b88a 100644
> >>> --- a/drivers/clk/Kconfig
> >>> +++ b/drivers/clk/Kconfig
> >>> @@ -64,6 +64,16 @@ config COMMON_CLK_SI5351
> >>> This driver supports Silicon Labs 5351A/B/C programmable clock
> >>> generators.
> >>>
> >>> +config COMMON_CLK_SI570
> >>> + tristate "Clock driver for SiLabs 570 and compatible devices"
> >>> + depends on I2C
> >>> + depends on OF
> >>> + select REGMAP_I2C
> >>> + help
> >>> + ---help---
> >>> + This driver supports Silicon Labs 570/571/598/599 programmable
> >>> + clock generators.
> >>> +
> >>> config COMMON_CLK_S2MPS11
> >>> tristate "Clock driver for S2MPS11 MFD"
> >>> depends on MFD_SEC_CORE
> >>> diff --git a/drivers/clk/Makefile b/drivers/clk/Makefile
> >>> index 7b11106..c0e94b3 100644
> >>> --- a/drivers/clk/Makefile
> >>> +++ b/drivers/clk/Makefile
> >>> @@ -40,6 +40,7 @@ obj-$(CONFIG_COMMON_CLK_AXI_CLKGEN) += clk-axi-clkgen.o
> >>> obj-$(CONFIG_COMMON_CLK_WM831X) += clk-wm831x.o
> >>> obj-$(CONFIG_COMMON_CLK_MAX77686) += clk-max77686.o
> >>> obj-$(CONFIG_COMMON_CLK_SI5351) += clk-si5351.o
> >>> +obj-$(CONFIG_COMMON_CLK_SI570) += clk-si570.o
> >>> obj-$(CONFIG_COMMON_CLK_S2MPS11) += clk-s2mps11.o
> >>> obj-$(CONFIG_CLK_TWL6040) += clk-twl6040.o
> >>> obj-$(CONFIG_CLK_PPC_CORENET) += clk-ppc-corenet.o
> >>> diff --git a/drivers/clk/clk-si570.c b/drivers/clk/clk-si570.c
> >>> new file mode 100644
> >>> index 0000000..5d0ac9f
> >>> --- /dev/null
> >>> +++ b/drivers/clk/clk-si570.c
> >>> @@ -0,0 +1,531 @@
> >>> +/*
> >>> + * Driver for Silicon Labs Si570/Si571 Programmable XO/VCXO
> >>> + *
> >>> + * Copyright (C) 2010, 2011 Ericsson AB.
> >>> + * Copyright (C) 2011 Guenter Roeck.
> >>> + * Copyright (C) 2011 - 2013 Xilinx Inc.
> >>> + *
> >>> + * Author: Guenter Roeck <guenter.roeck@ericsson.com>
> >>> + * S?ren Brinkmann <soren.brinkmann@xilinx.com>
> >>> + *
> >>> + * This program is free software; you can redistribute it and/or modify
> >>> + * it under the terms of the GNU General Public License as published by
> >>> + * the Free Software Foundation; either version 2 of the License, or
> >>> + * (at your option) any later version.
> >>> + *
> >>> + * This program is distributed in the hope that it will be useful,
> >>> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> >>> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
> >>> + * GNU General Public License for more details.
> >>> + */
> >>> +
> >>> +#include <linux/clk-provider.h>
> >>> +#include <linux/delay.h>
> >>> +#include <linux/module.h>
> >>> +#include <linux/i2c.h>
> >>> +#include <linux/regmap.h>
> >>> +#include <linux/slab.h>
> >>> +
> >>> +/* Si570 registers */
> >>> +#define SI570_REG_HS_N1 7
> >>> +#define SI570_REG_N1_RFREQ0 8
> >>> +#define SI570_REG_RFREQ1 9
> >>> +#define SI570_REG_RFREQ2 10
> >>> +#define SI570_REG_RFREQ3 11
> >>> +#define SI570_REG_RFREQ4 12
> >>> +#define SI570_REG_CONTROL 135
> >>> +#define SI570_REG_FREEZE_DCO 137
> >>> +#define SI570_DIV_OFFSET_7PPM 6
> >>> +
> >>> +#define HS_DIV_SHIFT 5
> >>> +#define HS_DIV_MASK 0xe0
> >>> +#define HS_DIV_OFFSET 4
> >>> +#define N1_6_2_MASK 0x1f
> >>> +#define N1_1_0_MASK 0xc0
> >>> +#define RFREQ_37_32_MASK 0x3f
> >>> +
> >>> +#define SI570_MIN_FREQ 10000000L
> >>> +#define SI570_MAX_FREQ 1417500000L
> >>> +#define SI598_MAX_FREQ 525000000L
> >>> +
> >>> +#define FDCO_MIN 4850000000LL
> >>> +#define FDCO_MAX 5670000000LL
> >>> +
> >>> +#define SI570_CNTRL_RECALL (1 << 0)
> >>> +#define SI570_CNTRL_FREEZE_M (1 << 5)
> >>> +#define SI570_CNTRL_NEWFREQ (1 << 6)
> >>> +
> >>> +#define SI570_FREEZE_DCO (1 << 4)
> >>> +
> >>> +/**
> >>> + * struct clk_si570:
> >>> + * @hw: Clock hw struct
> >>> + * @regmap: Device's regmap
> >>> + * @div_offset: Rgister offset for dividers
> >>> + * @max_freq: Maximum frequency for this device
> >>> + * @fxtal: Factory xtal frequency
> >>> + * @n1: Clock divider N1
> >>> + * @hs_div: Clock divider HSDIV
> >>> + * @rfreq: Clock multiplier RFREQ
> >>> + * @frequency: Current output frequency
> >>> + * @i2c_client: I2C client pointer
> >>> + */
> >>> +struct clk_si570 {
> >>> + struct clk_hw hw;
> >>> + struct regmap *regmap;
> >>> + unsigned int div_offset;
> >>> + u64 max_freq;
> >>> + u64 fxtal;
> >>> + unsigned int n1;
> >>> + unsigned int hs_div;
> >>> + u64 rfreq;
> >>> + u64 frequency;
> >>> + struct i2c_client *i2c_client;
> >>> +};
> >>> +#define to_clk_si570(_hw) container_of(_hw, struct clk_si570, hw)
> >>> +
> >>> +enum clk_si570_variant {
> >>> + si57x,
> >>> + si59x
> >>> +};
> >>> +
> >>> +/**
> >>> + * si570_get_divs() - Read clock dividers from HW
> >>> + * @data: Pointer to struct clk_si570
> >>> + * @rfreq: Fractional multiplier (output)
> >>> + * @n1: Divider N1 (output)
> >>> + * @hs_div: Divider HSDIV (output)
> >>> + * Returns 0 on success, negative errno otherwise.
> >>> + *
> >>> + * Retrieve clock dividers and multipliers from the HW.
> >>> + */
> >>> +static int si570_get_divs(struct clk_si570 *data, u64 *rfreq,
> >>> + unsigned int *n1, unsigned int *hs_div)
> >>> +{
> >>> + int err;
> >>> + u8 reg[6];
> >>> + u64 tmp;
> >>> +
> >>> + err = regmap_bulk_read(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> >>> + reg, ARRAY_SIZE(reg));
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + *hs_div = ((reg[0] & HS_DIV_MASK) >> HS_DIV_SHIFT) + HS_DIV_OFFSET;
> >>> + *n1 = ((reg[0] & N1_6_2_MASK) << 2) + ((reg[1] & N1_1_0_MASK) >> 6) + 1;
> >>> + /* Handle invalid cases */
> >>> + if (*n1 > 1)
> >>> + *n1 &= ~1;
> >>> +
> >>> + tmp = reg[1] & RFREQ_37_32_MASK;
> >>> + tmp = (tmp << 8) + reg[2];
> >>> + tmp = (tmp << 8) + reg[3];
> >>> + tmp = (tmp << 8) + reg[4];
> >>> + tmp = (tmp << 8) + reg[5];
> >>> + *rfreq = tmp;
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_get_defaults() - Get default values
> >>> + * @data: Driver data structure
> >>> + * @fout: Factory frequency output
> >>> + * Returns 0 on success, negative errno otherwise.
> >>> + */
> >>> +static int si570_get_defaults(struct clk_si570 *data, u64 fout)
> >>> +{
> >>> + int err;
> >>> + u64 fdco;
> >>> +
> >>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_RECALL);
> >>> +
> >>> + err = si570_get_divs(data, &data->rfreq, &data->n1, &data->hs_div);
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + /*
> >>> + * Accept optional precision loss to avoid arithmetic overflows.
> >>> + * Acceptable per Silicon Labs Application Note AN334.
> >>> + */
> >>> + fdco = fout * data->n1 * data->hs_div;
> >>> + if (fdco >= (1LL << 36))
> >>> + data->fxtal = div64_u64(fdco << 24, data->rfreq >> 4);
> >>> + else
> >>> + data->fxtal = div64_u64(fdco << 28, data->rfreq);
> >>> +
> >>> + data->frequency = fout;
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_update_rfreq() - Update clock multiplier
> >>> + * @data: Driver data structure
> >>> + * Passes on regmap_bulk_write() return value.
> >>> + */
> >>> +static int si570_update_rfreq(struct clk_si570 *data)
> >>> +{
> >>> + u8 reg[5];
> >>> +
> >>> + reg[0] = ((data->n1 - 1) << 6) |
> >>> + ((data->rfreq >> 32) & RFREQ_37_32_MASK);
> >>> + reg[1] = (data->rfreq >> 24) & 0xff;
> >>> + reg[2] = (data->rfreq >> 16) & 0xff;
> >>> + reg[3] = (data->rfreq >> 8) & 0xff;
> >>> + reg[4] = data->rfreq & 0xff;
> >>> +
> >>> + return regmap_bulk_write(data->regmap, SI570_REG_N1_RFREQ0 +
> >>> + data->div_offset, reg, ARRAY_SIZE(reg));
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_calc_divs() - Caluclate clock dividers
> >>> + * @frequency: Target frequency
> >>> + * @data: Driver data structure
> >>> + * @out_rfreq: RFREG fractional multiplier (output)
> >>> + * @out_n1: Clock divider N1 (output)
> >>> + * @out_hs_div: Clock divider HSDIV (output)
> >>> + * Returns 0 on success, negative errno otherwise.
> >>> + *
> >>> + * Calculate the clock dividers (@out_hs_div, @out_n1) and clock multiplier
> >>> + * (@out_rfreq) for a given target @frequency.
> >>> + */
> >>> +static int si570_calc_divs(unsigned long frequency, struct clk_si570 *data,
> >>> + u64 *out_rfreq, unsigned int *out_n1, unsigned int *out_hs_div)
> >>> +{
> >>> + int i;
> >>> + unsigned int n1, hs_div;
> >>> + u64 fdco, best_fdco = ULLONG_MAX;
> >>> + static const uint8_t si570_hs_div_values[] = { 11, 9, 7, 6, 5, 4 };
> >>> +
> >>> + for (i = 0; i < ARRAY_SIZE(si570_hs_div_values); i++) {
> >>> + hs_div = si570_hs_div_values[i];
> >>> + /* Calculate lowest possible value for n1 */
> >>> + n1 = div_u64(div_u64(FDCO_MIN, hs_div), frequency);
> >>> + if (!n1 || (n1 & 1))
> >>> + n1++;
> >>> + while (n1 <= 128) {
> >>> + fdco = (u64)frequency * (u64)hs_div * (u64)n1;
> >>> + if (fdco > FDCO_MAX)
> >>> + break;
> >>> + if (fdco >= FDCO_MIN && fdco < best_fdco) {
> >>> + *out_n1 = n1;
> >>> + *out_hs_div = hs_div;
> >>> + *out_rfreq = div64_u64(fdco << 28, data->fxtal);
> >>> + best_fdco = fdco;
> >>> + }
> >>> + n1 += (n1 == 1 ? 1 : 2);
> >>> + }
> >>> + }
> >>> +
> >>> + if (best_fdco == ULLONG_MAX)
> >>> + return -EINVAL;
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static unsigned long si570_recalc_rate(struct clk_hw *hw,
> >>> + unsigned long parent_rate)
> >>> +{
> >>> + int err;
> >>> + u64 rfreq, rate;
> >>> + unsigned int n1, hs_div;
> >>> + struct clk_si570 *data = to_clk_si570(hw);
> >>> +
> >>> + err = si570_get_divs(data, &rfreq, &n1, &hs_div);
> >>> + if (err) {
> >>> + dev_err(&data->i2c_client->dev, "unable to recalc rate\n");
> >>> + return data->frequency;
> >>> + }
> >>> +
> >>> + rfreq = div_u64(rfreq, hs_div * n1);
> >>> + rate = (data->fxtal * rfreq) >> 28;
> >>> +
> >>> + return rate;
> >>> +}
> >>> +
> >>> +static long si570_round_rate(struct clk_hw *hw, unsigned long rate,
> >>> + unsigned long *parent_rate)
> >>> +{
> >>> + int err;
> >>> + u64 rfreq;
> >>> + unsigned int n1, hs_div;
> >>> + struct clk_si570 *data = to_clk_si570(hw);
> >>> +
> >>> + if (!rate)
> >>> + return 0;
> >>> +
> >>> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> >>> + data->frequency) < 35) {
> >>> + rfreq = div64_u64((data->rfreq * rate) +
> >>> + div64_u64(data->frequency, 2), data->frequency);
> >>> + n1 = data->n1;
> >>> + hs_div = data->hs_div;
> >>> +
> >>> + } else {
> >>> + err = si570_calc_divs(rate, data, &rfreq, &n1, &hs_div);
> >>> + if (err) {
> >>> + dev_err(&data->i2c_client->dev,
> >>> + "unable to round rate\n");
> >>> + return 0;
> >>> + }
> >>> + }
> >>> +
> >>> + return rate;
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_set_frequency() - Adjust output frequency
> >>> + * @data: Driver data structure
> >>> + * @frequency: Target frequency
> >>> + * Returns 0 on success.
> >>> + *
> >>> + * Update output frequency for big frequency changes (> 3,500 ppm).
> >>> + */
> >>> +static int si570_set_frequency(struct clk_si570 *data, unsigned long frequency)
> >>> +{
> >>> + int err;
> >>> +
> >>> + err = si570_calc_divs(frequency, data, &data->rfreq, &data->n1,
> >>> + &data->hs_div);
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + /*
> >>> + * The DCO reg should be accessed with a read-modify-write operation
> >>> + * per AN334
> >>> + */
> >>> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, SI570_FREEZE_DCO);
> >>> + regmap_write(data->regmap, SI570_REG_HS_N1 + data->div_offset,
> >>> + ((data->hs_div - HS_DIV_OFFSET) << HS_DIV_SHIFT) |
> >>> + (((data->n1 - 1) >> 2) & N1_6_2_MASK));
> >>> + si570_update_rfreq(data);
> >>> + regmap_write(data->regmap, SI570_REG_FREEZE_DCO, 0);
> >>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_NEWFREQ);
> >>> +
> >>> + /* Applying a new frequency can take up to 10ms */
> >>> + usleep_range(10000, 12000);
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +/**
> >>> + * si570_set_frequency_small() - Adjust output frequency
> >>> + * @data: Driver data structure
> >>> + * @frequency: Target frequency
> >>> + * Returns 0 on success.
> >>> + *
> >>> + * Update output frequency for small frequency changes (< 3,500 ppm).
> >>> + */
> >>> +static int si570_set_frequency_small(struct clk_si570 *data,
> >>> + unsigned long frequency)
> >>> +{
> >>> + /*
> >>> + * This is a re-implementation of DIV_ROUND_CLOSEST
> >>> + * using the div64_u64 function lieu of letting the compiler
> >>> + * insert EABI calls
> >>> + */
> >>> + data->rfreq = div64_u64((data->rfreq * frequency) +
> >>> + div_u64(data->frequency, 2), data->frequency);
> >>> + regmap_write(data->regmap, SI570_REG_CONTROL, SI570_CNTRL_FREEZE_M);
> >>> + si570_update_rfreq(data);
> >>> + regmap_write(data->regmap, SI570_REG_CONTROL, 0);
> >>> +
> >>> + /* Applying a new frequency (small change) can take up to 100us */
> >>> + usleep_range(100, 200);
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static int si570_set_rate(struct clk_hw *hw, unsigned long rate,
> >>> + unsigned long parent_rate)
> >>> +{
> >>> + struct clk_si570 *data = to_clk_si570(hw);
> >>> + struct i2c_client *client = data->i2c_client;
> >>> + int err;
> >>> +
> >>> + if (rate < SI570_MIN_FREQ || rate > data->max_freq) {
> >>> + dev_err(&client->dev,
> >>> + "requested frequency %lu Hz is out of range\n", rate);
> >>> + return -EINVAL;
> >>> + }
> >>> +
> >>> + if (div64_u64(abs(rate - data->frequency) * 10000LL,
> >>> + data->frequency) < 35)
> >>> + err = si570_set_frequency_small(data, rate);
> >>> + else
> >>> + err = si570_set_frequency(data, rate);
> >>> +
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + data->frequency = rate;
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static const struct clk_ops si570_clk_ops = {
> >>> + .recalc_rate = si570_recalc_rate,
> >>> + .round_rate = si570_round_rate,
> >>> + .set_rate = si570_set_rate,
> >>> +};
> >>> +
> >>> +static bool si570_regmap_is_volatile(struct device *dev, unsigned int reg)
> >>> +{
> >>> + switch (reg) {
> >>> + case SI570_REG_CONTROL:
> >>> + return true;
> >>> + default:
> >>> + return false;
> >>> + }
> >>> +}
> >>> +
> >>> +static bool si570_regmap_is_writeable(struct device *dev, unsigned int reg)
> >>> +{
> >>> + switch (reg) {
> >>> + case SI570_REG_HS_N1 ... (SI570_REG_RFREQ4 + SI570_DIV_OFFSET_7PPM):
> >>> + case SI570_REG_CONTROL:
> >>> + case SI570_REG_FREEZE_DCO:
> >>> + return true;
> >>> + default:
> >>> + return false;
> >>> + }
> >>> +}
> >>> +
> >>> +static struct regmap_config si570_regmap_config = {
> >>> + .reg_bits = 8,
> >>> + .val_bits = 8,
> >>> + .cache_type = REGCACHE_RBTREE,
> >>> + .max_register = 137,
> >>> + .writeable_reg = si570_regmap_is_writeable,
> >>> + .volatile_reg = si570_regmap_is_volatile,
> >>> +};
> >>> +
> >>> +static int si570_probe(struct i2c_client *client,
> >>> + const struct i2c_device_id *id)
> >>> +{
> >>> + struct clk_si570 *data;
> >>> + struct clk_init_data init;
> >>> + struct clk *clk;
> >>> + u32 initial_fout, factory_fout, stability;
> >>> + int err;
> >>> + enum clk_si570_variant variant = id->driver_data;
> >>> +
> >>> + data = devm_kzalloc(&client->dev, sizeof(*data), GFP_KERNEL);
> >>> + if (!data)
> >>> + return -ENOMEM;
> >>> +
> >>> + init.ops = &si570_clk_ops;
> >>> + init.flags = CLK_IS_ROOT;
> >>> + init.num_parents = 0;
> >>> + data->hw.init = &init;
> >>> + data->i2c_client = client;
> >>> +
> >>> + if (variant == si57x) {
> >>> + err = of_property_read_u32(client->dev.of_node,
> >>> + "temperature-stability", &stability);
> >>> + if (err) {
> >>> + dev_err(&client->dev,
> >>> + "'temperature-stability' property missing\n");
> >>> + return err;
> >>> + }
> >>> + /* adjust register offsets for 7ppm devices */
> >>> + if (stability == 7)
> >>> + data->div_offset = SI570_DIV_OFFSET_7PPM;
> >>> +
> >>> + data->max_freq = SI570_MAX_FREQ;
> >>> + } else {
> >>> + data->max_freq = SI598_MAX_FREQ;
> >>> + }
> >>> +
> >>> + if (of_property_read_string(client->dev.of_node, "clock-output-names",
> >>> + &init.name))
> >>> + init.name = client->dev.of_node->name;
> >>> +
> >>> + err = of_property_read_u32(client->dev.of_node, "factory-fout",
> >>> + &factory_fout);
> >>> + if (err) {
> >>> + dev_err(&client->dev, "'factory-fout' property missing\n");
> >>> + return err;
> >>> + }
> >>> +
> >>> + data->regmap = devm_regmap_init_i2c(client, &si570_regmap_config);
> >>> + if (IS_ERR(data->regmap)) {
> >>> + dev_err(&client->dev, "failed to allocate register map\n");
> >>> + return PTR_ERR(data->regmap);
> >>> + }
> >>> +
> >>> + i2c_set_clientdata(client, data);
> >>> + err = si570_get_defaults(data, factory_fout);
> >>> + if (err)
> >>> + return err;
> >>> +
> >>> + clk = devm_clk_register(&client->dev, &data->hw);
> >>> + if (IS_ERR(clk)) {
> >>> + dev_err(&client->dev, "clock registration failed\n");
> >>> + return PTR_ERR(clk);
> >>> + }
> >>> + err = of_clk_add_provider(client->dev.of_node, of_clk_src_simple_get,
> >>> + clk);
> >>> + if (err) {
> >>> + dev_err(&client->dev, "unable to add clk provider\n");
> >>> + return err;
> >>> + }
> >>> +
> >>> + /* Read the requested initial output frequency from device tree */
> >>> + if (!of_property_read_u32(client->dev.of_node, "clock-frequency",
> >>> + &initial_fout)) {
> >>> + err = clk_set_rate(clk, initial_fout);
> >>> + if (err) {
> >>> + of_clk_del_provider(client->dev.of_node);
> >>> + return err;
> >>> + }
> >>> + }
> >>> +
> >>> + /* Display a message indicating that we've successfully registered */
> >>> + dev_info(&client->dev, "registered, current frequency %llu Hz\n",
> >>> + data->frequency);
> >>> +
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static int si570_remove(struct i2c_client *client)
> >>> +{
> >>> + of_clk_del_provider(client->dev.of_node);
> >>> + return 0;
> >>> +}
> >>> +
> >>> +static const struct i2c_device_id si570_id[] = {
> >>> + { "si570", si57x },
> >>> + { "si571", si57x },
> >>> + { "si598", si59x },
> >>> + { "si599", si59x },
> >>> + { }
> >>> +};
> >>> +MODULE_DEVICE_TABLE(i2c, si570_id);
> >>> +
> >>> +static const struct of_device_id clk_si570_of_match[] = {
> >>> + { .compatible = "silabs,si570" },
> >>> + { .compatible = "silabs,si571" },
> >>> + { .compatible = "silabs,si598" },
> >>> + { .compatible = "silabs,si599" },
> >>> + { },
> >>> +};
> >>> +MODULE_DEVICE_TABLE(of, clk_si570_of_match);
> >>> +
> >>> +static struct i2c_driver si570_driver = {
> >>> + .driver = {
> >>> + .name = "si570",
> >>> + .of_match_table = of_match_ptr(clk_si570_of_match),
> >>> + },
> >>> + .probe = si570_probe,
> >>> + .remove = si570_remove,
> >>> + .id_table = si570_id,
> >>> +};
> >>> +module_i2c_driver(si570_driver);
> >>> +
> >>> +MODULE_AUTHOR("Guenter Roeck <guenter.roeck@ericsson.com>");
> >>> +MODULE_AUTHOR("Soeren Brinkmann <soren.brinkmann@xilinx.com");
> >>> +MODULE_DESCRIPTION("Si570 driver");
> >>> +MODULE_LICENSE("GPL");
> >>> --
> >>> 1.8.4
> >>>
> >>>
> > --
> > To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
> > the body of a message to majordomo at vger.kernel.org
> > More majordomo info at http://vger.kernel.org/majordomo-info.html
> > Please read the FAQ at http://www.tux.org/lkml/
> >
> >
> >
> >
>
^ permalink raw reply [flat|nested] 27+ messages in thread
* Re: [PATCH v5] clk: si570: Add a driver for SI570 oscillators
2013-12-17 23:43 ` Mike Turquette
@ 2013-12-18 0:04 ` Guenter Roeck
-1 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-12-18 0:04 UTC (permalink / raw)
To: Mike Turquette
Cc: Sören Brinkmann, Rob Herring, Pawel Moll, Mark Rutland,
Stephen Warren, devicetree, linux-doc, linux-kernel,
linux-arm-kernel, Hyun Kwon
On Tue, Dec 17, 2013 at 03:43:40PM -0800, Mike Turquette wrote:
> Quoting Guenter Roeck (2013-12-14 08:33:27)
> > On 10/02/2013 04:17 PM, Mike Turquette wrote:
> > > Quoting Sören Brinkmann (2013-10-02 10:20:38)
> > >> Hi Mike,
> > >>
> > >> could you please comment on this/apply it to clk-next?
> > >
> > > It looks good and is in the queue. Will show up in clk-next in a few
> > > days.
> > >
> > Hi Mike,
> >
> > trying again ... what happened with this driver ? Any reason for not pushing it after all ?
>
> This got reverted with several other patches right before 3.12 dropped.
> Unfortunately clk-next broke linux-next two days before 3.12 came out
> and I had to revert to a known good state, excluding this driver.
>
> I've added it back to clk-next now towards 3.13. Sorry for the
> inconvenience.
>
No problem. Thanks a lot for the update.
Guenter
^ permalink raw reply [flat|nested] 27+ messages in thread
* [PATCH v5] clk: si570: Add a driver for SI570 oscillators
@ 2013-12-18 0:04 ` Guenter Roeck
0 siblings, 0 replies; 27+ messages in thread
From: Guenter Roeck @ 2013-12-18 0:04 UTC (permalink / raw)
To: linux-arm-kernel
On Tue, Dec 17, 2013 at 03:43:40PM -0800, Mike Turquette wrote:
> Quoting Guenter Roeck (2013-12-14 08:33:27)
> > On 10/02/2013 04:17 PM, Mike Turquette wrote:
> > > Quoting S?ren Brinkmann (2013-10-02 10:20:38)
> > >> Hi Mike,
> > >>
> > >> could you please comment on this/apply it to clk-next?
> > >
> > > It looks good and is in the queue. Will show up in clk-next in a few
> > > days.
> > >
> > Hi Mike,
> >
> > trying again ... what happened with this driver ? Any reason for not pushing it after all ?
>
> This got reverted with several other patches right before 3.12 dropped.
> Unfortunately clk-next broke linux-next two days before 3.12 came out
> and I had to revert to a known good state, excluding this driver.
>
> I've added it back to clk-next now towards 3.13. Sorry for the
> inconvenience.
>
No problem. Thanks a lot for the update.
Guenter
^ permalink raw reply [flat|nested] 27+ messages in thread
end of thread, other threads:[~2013-12-18 0:04 UTC | newest]
Thread overview: 27+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2013-09-21 23:40 [PATCH v5] clk: si570: Add a driver for SI570 oscillators Soren Brinkmann
2013-09-21 23:40 ` Soren Brinkmann
2013-09-21 23:40 ` Soren Brinkmann
2013-09-22 2:31 ` Guenter Roeck
2013-09-22 2:31 ` Guenter Roeck
2013-10-02 17:20 ` Sören Brinkmann
2013-10-02 17:20 ` Sören Brinkmann
2013-10-02 17:20 ` Sören Brinkmann
2013-10-02 23:17 ` Mike Turquette
2013-10-02 23:17 ` Mike Turquette
2013-10-02 23:17 ` Mike Turquette
2013-10-02 23:22 ` Sören Brinkmann
2013-10-02 23:22 ` Sören Brinkmann
2013-10-02 23:22 ` Sören Brinkmann
2013-12-09 16:34 ` Guenter Roeck
2013-12-09 16:34 ` Guenter Roeck
2013-12-14 16:33 ` Guenter Roeck
2013-12-14 16:33 ` Guenter Roeck
2013-12-16 17:03 ` Sören Brinkmann
2013-12-16 17:03 ` Sören Brinkmann
2013-12-16 17:03 ` Sören Brinkmann
2013-12-16 17:28 ` Guenter Roeck
2013-12-16 17:28 ` Guenter Roeck
2013-12-17 23:43 ` Mike Turquette
2013-12-17 23:43 ` Mike Turquette
2013-12-18 0:04 ` Guenter Roeck
2013-12-18 0:04 ` Guenter Roeck
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.