linux-toradex.git/include/linux/clk-provider.h, branch v3.5

clk: Provide dummy clk_unregister()

2012-05-15T19:02:39+00:00

While there's no actual implementation behind it having the call to use
in drivers makes them feel neater from a driver author point of view. An
actual implementation can wait for someone who needs to use the function
in a real system.

Signed-off-by: Mark Brown 
[mturquette@linaro.org: void return type instead of int -EINVAL]
Signed-off-by: Mike Turquette

clk: add a fixed factor clock

2012-05-08T21:13:25+00:00

Having fixed factors/dividers in hardware is a common pattern, so
add a basic clock type doing this. It basically describes a fixed
factor clock using a nominator and a denominator.

Signed-off-by: Sascha Hauer 
Reviewed-by: Viresh Kumar 
Tested-by: Shawn Guo 
[mturquette@linaro.org: constify parent_names in static init macro]
[mturquette@linaro.org: copy/paste bug from mux in static init macro]
[mturquette@linaro.org: fix error handling in clk_register_fixed_factor]
[mturquette@linaro.org: improve division accuracy; thanks to Saravana]
Signed-off-by: Mike Turquette

clk: Use a separate struct for holding init data.

2012-05-02T01:13:20+00:00

Create a struct clk_init_data to hold all data that needs to be passed from
the platfrom specific driver to the common clock framework during clock
registration. Add a pointer to this struct inside clk_hw.

This has several advantages:
* Completely hides struct clk from many clock platform drivers and static
  clock initialization code that don't care for static initialization of
  the struct clks.
* For platforms that want to do complete static initialization, it removed
  the need to directly mess with the struct clk's fields while still
  allowing to statically allocate struct clk. This keeps the code more
  future proof even if they include clk-private.h.
* Simplifies the generic clk_register() function and allows adding optional
  fields in the future without modifying the function signature.
* Simplifies the static initialization of clocks on all platforms by
  removing the need for forward delcarations or convoluted macros.

Signed-off-by: Saravana Kannan 
[mturquette@linaro.org: kept DEFINE_CLK_* macros and __clk_init]
Signed-off-by: Mike Turquette 
Cc: Andrew Lunn 
Cc: Rob Herring 
Cc: Russell King 
Cc: Jeremy Kerr 
Cc: Thomas Gleixner 
Cc: Arnd Bergman 
Cc: Paul Walmsley 
Cc: Shawn Guo 
Cc: Sascha Hauer 
Cc: Jamie Iles 
Cc: Richard Zhao 
Cc: Saravana Kannan 
Cc: Magnus Damm 
Cc: Mark Brown 
Cc: Linus Walleij 
Cc: Stephen Boyd 
Cc: Amit Kucheria 
Cc: Deepak Saxena 
Cc: Grant Likely

clk: Fix typo in comment

2012-04-24T23:37:40+00:00

CLK_MUX_INDEX_BIT is mistakenly written as CLK_MUX_INDEX_BITWISE in comment. Fix
it.

CLK_GATE_SET_TO_DISABLE is mistakenly written as CLK_GATE_SET_DISABLE in
comment. Fix it.

Signed-off-by: Viresh Kumar 
Signed-off-by: Mike Turquette

clk: pass parent_rate into .set_rate

2012-04-24T23:37:40+00:00

For most of .set_rate implementation, parent_rate will be used, so just
like passing parent_rate into .recalc_rate, let's pass parent_rate into
.set_rate too.

It also updates the kernel doc for .set_rate ops.

Signed-off-by: Shawn Guo 
Signed-off-by: Mike Turquette

clk: basic: improve parent_names & return errors

2012-04-24T23:37:39+00:00

This patch is the basic clk version of 'clk: core: copy parent_names &
return error codes'.

The registration functions are changed to allow the core code to copy
the array of strings and allow platforms to declare those arrays as
__initdata.

This patch also converts all of the basic clk registration functions to
return error codes which better aligns them with the existing clk.h api.

Signed-off-by: Mike Turquette

clk: core: copy parent_names & return error codes

2012-04-24T23:37:39+00:00

This patch cleans up clk_register and solves a few bugs by teaching
clk_register and __clk_init to return error codes (instead of just NULL)
to better align with the existing clk.h api.

Along with that change this patch also introduces a new behavior whereby
clk_register copies the parent_names array, thus allowing platforms to
declare their parent_names arrays as __initdata.

Signed-off-by: Mike Turquette

clk: Constify parent name arrays

2012-04-24T23:37:39+00:00

Drivers should be able to declare their arrays of parent names as const
so the APIs need to accept const arguments.

Signed-off-by: Mark Brown 
[mturquette@linaro.org: constified gate]
Signed-off-by: Mike Turquette

clk: declare clk_ops of basic clks in clk-provider.h

2012-04-24T23:37:38+00:00

Besides the static initialization, the clk_ops of basic clks could
also be used by particular clk type being subclass of the basic clks.

For example, clk_busy_divider has the same clk_ops as clk_divider,
except it has to wait for a busy bit before return success with
.set_rate.  clk_busy_divider will somehow reuse clk_ops of clk_divider.

Since clk-provider.h is included by clk-private.h, it's safe to move
those clk_ops declaration of basic clks form  clk-private.h into
clk-provider.h, so that implementation of clks like clk_busy_divider
above do not need to include clk-private.h to access those clk_ops.

Signed-off-by: Shawn Guo 
Signed-off-by: Mike Turquette

clk: basic clock hardware types

2012-03-16T20:35:02+00:00

Many platforms support simple gateable clocks, fixed-rate clocks,
adjustable divider clocks and multi-parent multiplexer clocks.

This patch introduces basic clock types for the above-mentioned hardware
which share some common characteristics.

Based on original work by Jeremy Kerr and contribution by Jamie Iles.
Dividers and multiplexor clocks originally contributed by Richard Zhao &
Sascha Hauer.

Signed-off-by: Mike Turquette 
Signed-off-by: Mike Turquette 
Reviewed-by: Andrew Lunn 
Tested-by: Andrew Lunn 
Reviewed-by: Rob Herring 
Cc: Russell King 
Cc: Jeremy Kerr 
Cc: Thomas Gleixner 
Cc: Arnd Bergman 
Cc: Paul Walmsley 
Cc: Shawn Guo 
Cc: Sascha Hauer 
Cc: Jamie Iles 
Cc: Richard Zhao 
Cc: Saravana Kannan 
Cc: Magnus Damm 
Cc: Mark Brown 
Cc: Linus Walleij 
Cc: Stephen Boyd 
Cc: Amit Kucheria 
Cc: Deepak Saxena 
Cc: Grant Likely 
Signed-off-by: Arnd Bergmann