1 // SPDX-License-Identifier: GPL-2.0
3 * Zynq UltraScale+ MPSoC clock controller
5 * Copyright (C) 2016-2018 Xilinx
7 * Based on drivers/clk/zynq/clkc.c
10 #include <linux/bitfield.h>
11 #include <linux/clk.h>
12 #include <linux/clk-provider.h>
13 #include <linux/module.h>
14 #include <linux/of_platform.h>
15 #include <linux/slab.h>
16 #include <linux/string.h>
18 #include "clk-zynqmp.h"
20 #define MAX_PARENT 100
22 #define MAX_NAME_LEN 50
24 /* Flags for parents */
25 #define PARENT_CLK_SELF 0
26 #define PARENT_CLK_NODE1 1
27 #define PARENT_CLK_NODE2 2
28 #define PARENT_CLK_NODE3 3
29 #define PARENT_CLK_NODE4 4
30 #define PARENT_CLK_EXTERNAL 5
32 #define END_OF_CLK_NAME "END_OF_CLK"
33 #define END_OF_TOPOLOGY_NODE 1
34 #define END_OF_PARENTS 1
35 #define RESERVED_CLK_NAME ""
37 #define CLK_GET_NAME_RESP_LEN 16
38 #define CLK_GET_TOPOLOGY_RESP_WORDS 3
39 #define CLK_GET_PARENTS_RESP_WORDS 3
40 #define CLK_GET_ATTR_RESP_WORDS 1
48 * struct clock_parent - Clock parent
50 * @id: Parent clock ID
54 char name
[MAX_NAME_LEN
];
60 * struct zynqmp_clock - Clock
61 * @clk_name: Clock name
62 * @valid: Validity flag of clock
63 * @type: Clock type (Output/External)
64 * @node: Clock topology nodes
65 * @num_nodes: Number of nodes present in topology
66 * @parent: Parent of clock
67 * @num_parents: Number of parents of clock
71 char clk_name
[MAX_NAME_LEN
];
74 struct clock_topology node
[MAX_NODES
];
76 struct clock_parent parent
[MAX_PARENT
];
82 char name
[CLK_GET_NAME_RESP_LEN
];
85 struct topology_resp
{
86 #define CLK_TOPOLOGY_TYPE GENMASK(3, 0)
87 #define CLK_TOPOLOGY_FLAGS GENMASK(23, 8)
88 #define CLK_TOPOLOGY_TYPE_FLAGS GENMASK(31, 24)
89 u32 topology
[CLK_GET_TOPOLOGY_RESP_WORDS
];
93 #define NA_PARENT 0xFFFFFFFF
94 #define DUMMY_PARENT 0xFFFFFFFE
95 #define CLK_PARENTS_ID GENMASK(15, 0)
96 #define CLK_PARENTS_FLAGS GENMASK(31, 16)
97 u32 parents
[CLK_GET_PARENTS_RESP_WORDS
];
101 #define CLK_ATTR_VALID BIT(0)
102 #define CLK_ATTR_TYPE BIT(2)
103 #define CLK_ATTR_NODE_INDEX GENMASK(13, 0)
104 #define CLK_ATTR_NODE_TYPE GENMASK(19, 14)
105 #define CLK_ATTR_NODE_SUBCLASS GENMASK(25, 20)
106 #define CLK_ATTR_NODE_CLASS GENMASK(31, 26)
107 u32 attr
[CLK_GET_ATTR_RESP_WORDS
];
110 static const char clk_type_postfix
[][10] = {
114 [TYPE_DIV1
] = "_div1",
115 [TYPE_DIV2
] = "_div2",
116 [TYPE_FIXEDFACTOR
] = "_ff",
120 static struct clk_hw
*(* const clk_topology
[]) (const char *name
, u32 clk_id
,
121 const char * const *parents
,
123 const struct clock_topology
*nodes
)
125 [TYPE_INVALID
] = NULL
,
126 [TYPE_MUX
] = zynqmp_clk_register_mux
,
127 [TYPE_PLL
] = zynqmp_clk_register_pll
,
128 [TYPE_FIXEDFACTOR
] = zynqmp_clk_register_fixed_factor
,
129 [TYPE_DIV1
] = zynqmp_clk_register_divider
,
130 [TYPE_DIV2
] = zynqmp_clk_register_divider
,
131 [TYPE_GATE
] = zynqmp_clk_register_gate
134 static struct zynqmp_clock
*clock
;
135 static struct clk_hw_onecell_data
*zynqmp_data
;
136 static unsigned int clock_max_idx
;
137 static const struct zynqmp_eemi_ops
*eemi_ops
;
140 * zynqmp_is_valid_clock() - Check whether clock is valid or not
141 * @clk_id: Clock index
143 * Return: 1 if clock is valid, 0 if clock is invalid else error code
145 static inline int zynqmp_is_valid_clock(u32 clk_id
)
147 if (clk_id
>= clock_max_idx
)
150 return clock
[clk_id
].valid
;
154 * zynqmp_get_clock_name() - Get name of clock from Clock index
155 * @clk_id: Clock index
156 * @clk_name: Name of clock
158 * Return: 0 on success else error code
160 static int zynqmp_get_clock_name(u32 clk_id
, char *clk_name
)
164 ret
= zynqmp_is_valid_clock(clk_id
);
166 strncpy(clk_name
, clock
[clk_id
].clk_name
, MAX_NAME_LEN
);
170 return ret
== 0 ? -EINVAL
: ret
;
174 * zynqmp_get_clock_type() - Get type of clock
175 * @clk_id: Clock index
176 * @type: Clock type: CLK_TYPE_OUTPUT or CLK_TYPE_EXTERNAL
178 * Return: 0 on success else error code
180 static int zynqmp_get_clock_type(u32 clk_id
, u32
*type
)
184 ret
= zynqmp_is_valid_clock(clk_id
);
186 *type
= clock
[clk_id
].type
;
190 return ret
== 0 ? -EINVAL
: ret
;
194 * zynqmp_pm_clock_get_num_clocks() - Get number of clocks in system
195 * @nclocks: Number of clocks in system/board.
197 * Call firmware API to get number of clocks.
199 * Return: 0 on success else error code.
201 static int zynqmp_pm_clock_get_num_clocks(u32
*nclocks
)
203 struct zynqmp_pm_query_data qdata
= {0};
204 u32 ret_payload
[PAYLOAD_ARG_CNT
];
207 qdata
.qid
= PM_QID_CLOCK_GET_NUM_CLOCKS
;
209 ret
= eemi_ops
->query_data(qdata
, ret_payload
);
210 *nclocks
= ret_payload
[1];
216 * zynqmp_pm_clock_get_name() - Get the name of clock for given id
217 * @clock_id: ID of the clock to be queried
218 * @response: Name of the clock with the given id
220 * This function is used to get name of clock specified by given
225 static int zynqmp_pm_clock_get_name(u32 clock_id
,
226 struct name_resp
*response
)
228 struct zynqmp_pm_query_data qdata
= {0};
229 u32 ret_payload
[PAYLOAD_ARG_CNT
];
231 qdata
.qid
= PM_QID_CLOCK_GET_NAME
;
232 qdata
.arg1
= clock_id
;
234 eemi_ops
->query_data(qdata
, ret_payload
);
235 memcpy(response
, ret_payload
, sizeof(*response
));
241 * zynqmp_pm_clock_get_topology() - Get the topology of clock for given id
242 * @clock_id: ID of the clock to be queried
243 * @index: Node index of clock topology
244 * @response: Buffer used for the topology response
246 * This function is used to get topology information for the clock
247 * specified by given clock ID.
249 * This API will return 3 node of topology with a single response. To get
250 * other nodes, master should call same API in loop with new
251 * index till error is returned. E.g First call should have
252 * index 0 which will return nodes 0,1 and 2. Next call, index
253 * should be 3 which will return nodes 3,4 and 5 and so on.
255 * Return: 0 on success else error+reason
257 static int zynqmp_pm_clock_get_topology(u32 clock_id
, u32 index
,
258 struct topology_resp
*response
)
260 struct zynqmp_pm_query_data qdata
= {0};
261 u32 ret_payload
[PAYLOAD_ARG_CNT
];
264 qdata
.qid
= PM_QID_CLOCK_GET_TOPOLOGY
;
265 qdata
.arg1
= clock_id
;
268 ret
= eemi_ops
->query_data(qdata
, ret_payload
);
269 memcpy(response
, &ret_payload
[1], sizeof(*response
));
275 * zynqmp_clk_register_fixed_factor() - Register fixed factor with the
277 * @name: Name of this clock
279 * @parents: Name of this clock's parents
280 * @num_parents: Number of parents
281 * @nodes: Clock topology node
283 * Return: clock hardware to the registered clock
285 struct clk_hw
*zynqmp_clk_register_fixed_factor(const char *name
, u32 clk_id
,
286 const char * const *parents
,
288 const struct clock_topology
*nodes
)
292 struct zynqmp_pm_query_data qdata
= {0};
293 u32 ret_payload
[PAYLOAD_ARG_CNT
];
296 qdata
.qid
= PM_QID_CLOCK_GET_FIXEDFACTOR_PARAMS
;
299 ret
= eemi_ops
->query_data(qdata
, ret_payload
);
303 mult
= ret_payload
[1];
304 div
= ret_payload
[2];
306 hw
= clk_hw_register_fixed_factor(NULL
, name
,
315 * zynqmp_pm_clock_get_parents() - Get the first 3 parents of clock for given id
316 * @clock_id: Clock ID
317 * @index: Parent index
318 * @response: Parents of the given clock
320 * This function is used to get 3 parents for the clock specified by
323 * This API will return 3 parents with a single response. To get
324 * other parents, master should call same API in loop with new
325 * parent index till error is returned. E.g First call should have
326 * index 0 which will return parents 0,1 and 2. Next call, index
327 * should be 3 which will return parent 3,4 and 5 and so on.
329 * Return: 0 on success else error+reason
331 static int zynqmp_pm_clock_get_parents(u32 clock_id
, u32 index
,
332 struct parents_resp
*response
)
334 struct zynqmp_pm_query_data qdata
= {0};
335 u32 ret_payload
[PAYLOAD_ARG_CNT
];
338 qdata
.qid
= PM_QID_CLOCK_GET_PARENTS
;
339 qdata
.arg1
= clock_id
;
342 ret
= eemi_ops
->query_data(qdata
, ret_payload
);
343 memcpy(response
, &ret_payload
[1], sizeof(*response
));
349 * zynqmp_pm_clock_get_attributes() - Get the attributes of clock for given id
350 * @clock_id: Clock ID
351 * @response: Clock attributes response
353 * This function is used to get clock's attributes(e.g. valid, clock type, etc).
355 * Return: 0 on success else error+reason
357 static int zynqmp_pm_clock_get_attributes(u32 clock_id
,
358 struct attr_resp
*response
)
360 struct zynqmp_pm_query_data qdata
= {0};
361 u32 ret_payload
[PAYLOAD_ARG_CNT
];
364 qdata
.qid
= PM_QID_CLOCK_GET_ATTRIBUTES
;
365 qdata
.arg1
= clock_id
;
367 ret
= eemi_ops
->query_data(qdata
, ret_payload
);
368 memcpy(response
, &ret_payload
[1], sizeof(*response
));
374 * __zynqmp_clock_get_topology() - Get topology data of clock from firmware
376 * @topology: Clock topology
377 * @response: Clock topology data received from firmware
378 * @nnodes: Number of nodes
380 * Return: 0 on success else error+reason
382 static int __zynqmp_clock_get_topology(struct clock_topology
*topology
,
383 struct topology_resp
*response
,
389 for (i
= 0; i
< ARRAY_SIZE(response
->topology
); i
++) {
390 type
= FIELD_GET(CLK_TOPOLOGY_TYPE
, response
->topology
[i
]);
391 if (type
== TYPE_INVALID
)
392 return END_OF_TOPOLOGY_NODE
;
393 topology
[*nnodes
].type
= type
;
394 topology
[*nnodes
].flag
= FIELD_GET(CLK_TOPOLOGY_FLAGS
,
395 response
->topology
[i
]);
396 topology
[*nnodes
].type_flag
=
397 FIELD_GET(CLK_TOPOLOGY_TYPE_FLAGS
,
398 response
->topology
[i
]);
406 * zynqmp_clock_get_topology() - Get topology of clock from firmware using
408 * @clk_id: Clock index
409 * @topology: Clock topology
410 * @num_nodes: Number of nodes
412 * Return: 0 on success else error+reason
414 static int zynqmp_clock_get_topology(u32 clk_id
,
415 struct clock_topology
*topology
,
419 struct topology_resp response
= { };
422 for (j
= 0; j
<= MAX_NODES
; j
+= ARRAY_SIZE(response
.topology
)) {
423 ret
= zynqmp_pm_clock_get_topology(clock
[clk_id
].clk_id
, j
,
427 ret
= __zynqmp_clock_get_topology(topology
, &response
,
429 if (ret
== END_OF_TOPOLOGY_NODE
)
437 * __zynqmp_clock_get_parents() - Get parents info of clock from firmware
439 * @parents: Clock parents
440 * @response: Clock parents data received from firmware
441 * @nparent: Number of parent
443 * Return: 0 on success else error+reason
445 static int __zynqmp_clock_get_parents(struct clock_parent
*parents
,
446 struct parents_resp
*response
,
450 struct clock_parent
*parent
;
452 for (i
= 0; i
< ARRAY_SIZE(response
->parents
); i
++) {
453 if (response
->parents
[i
] == NA_PARENT
)
454 return END_OF_PARENTS
;
456 parent
= &parents
[i
];
457 parent
->id
= FIELD_GET(CLK_PARENTS_ID
, response
->parents
[i
]);
458 if (response
->parents
[i
] == DUMMY_PARENT
) {
459 strcpy(parent
->name
, "dummy_name");
462 parent
->flag
= FIELD_GET(CLK_PARENTS_FLAGS
,
463 response
->parents
[i
]);
464 if (zynqmp_get_clock_name(parent
->id
, parent
->name
))
474 * zynqmp_clock_get_parents() - Get parents info from firmware using PM_API
475 * @clk_id: Clock index
476 * @parents: Clock parents
477 * @num_parents: Total number of parents
479 * Return: 0 on success else error+reason
481 static int zynqmp_clock_get_parents(u32 clk_id
, struct clock_parent
*parents
,
485 struct parents_resp response
= { };
489 /* Get parents from firmware */
490 ret
= zynqmp_pm_clock_get_parents(clock
[clk_id
].clk_id
, j
,
495 ret
= __zynqmp_clock_get_parents(&parents
[j
], &response
,
497 if (ret
== END_OF_PARENTS
)
499 j
+= ARRAY_SIZE(response
.parents
);
500 } while (*num_parents
<= MAX_PARENT
);
506 * zynqmp_get_parent_list() - Create list of parents name
508 * @clk_id: Clock index
509 * @parent_list: List of parent's name
510 * @num_parents: Total number of parents
512 * Return: 0 on success else error+reason
514 static int zynqmp_get_parent_list(struct device_node
*np
, u32 clk_id
,
515 const char **parent_list
, u32
*num_parents
)
518 u32 total_parents
= clock
[clk_id
].num_parents
;
519 struct clock_topology
*clk_nodes
;
520 struct clock_parent
*parents
;
522 clk_nodes
= clock
[clk_id
].node
;
523 parents
= clock
[clk_id
].parent
;
525 for (i
= 0; i
< total_parents
; i
++) {
526 if (!parents
[i
].flag
) {
527 parent_list
[i
] = parents
[i
].name
;
528 } else if (parents
[i
].flag
== PARENT_CLK_EXTERNAL
) {
529 ret
= of_property_match_string(np
, "clock-names",
532 strcpy(parents
[i
].name
, "dummy_name");
533 parent_list
[i
] = parents
[i
].name
;
535 strcat(parents
[i
].name
,
536 clk_type_postfix
[clk_nodes
[parents
[i
].flag
- 1].
538 parent_list
[i
] = parents
[i
].name
;
542 *num_parents
= total_parents
;
547 * zynqmp_register_clk_topology() - Register clock topology
548 * @clk_id: Clock index
549 * @clk_name: Clock Name
550 * @num_parents: Total number of parents
551 * @parent_names: List of parents name
553 * Return: Returns either clock hardware or error+reason
555 static struct clk_hw
*zynqmp_register_clk_topology(int clk_id
, char *clk_name
,
557 const char **parent_names
)
560 u32 num_nodes
, clk_dev_id
;
561 char *clk_out
= NULL
;
562 struct clock_topology
*nodes
;
563 struct clk_hw
*hw
= NULL
;
565 nodes
= clock
[clk_id
].node
;
566 num_nodes
= clock
[clk_id
].num_nodes
;
567 clk_dev_id
= clock
[clk_id
].clk_id
;
569 for (j
= 0; j
< num_nodes
; j
++) {
571 * Clock name received from firmware is output clock name.
572 * Intermediate clock names are postfixed with type of clock.
574 if (j
!= (num_nodes
- 1)) {
575 clk_out
= kasprintf(GFP_KERNEL
, "%s%s", clk_name
,
576 clk_type_postfix
[nodes
[j
].type
]);
578 clk_out
= kasprintf(GFP_KERNEL
, "%s", clk_name
);
581 if (!clk_topology
[nodes
[j
].type
])
584 hw
= (*clk_topology
[nodes
[j
].type
])(clk_out
, clk_dev_id
,
589 pr_warn_once("%s() 0x%x: %s register fail with %ld\n",
590 __func__
, clk_dev_id
, clk_name
,
593 parent_names
[0] = clk_out
;
600 * zynqmp_register_clocks() - Register clocks
603 * Return: 0 on success else error code
605 static int zynqmp_register_clocks(struct device_node
*np
)
608 u32 i
, total_parents
= 0, type
= 0;
609 const char *parent_names
[MAX_PARENT
];
611 for (i
= 0; i
< clock_max_idx
; i
++) {
612 char clk_name
[MAX_NAME_LEN
];
614 /* get clock name, continue to next clock if name not found */
615 if (zynqmp_get_clock_name(i
, clk_name
))
618 /* Check if clock is valid and output clock.
619 * Do not register invalid or external clock.
621 ret
= zynqmp_get_clock_type(i
, &type
);
622 if (ret
|| type
!= CLK_TYPE_OUTPUT
)
625 /* Get parents of clock*/
626 if (zynqmp_get_parent_list(np
, i
, parent_names
,
628 WARN_ONCE(1, "No parents found for %s\n",
633 zynqmp_data
->hws
[i
] =
634 zynqmp_register_clk_topology(i
, clk_name
,
639 for (i
= 0; i
< clock_max_idx
; i
++) {
640 if (IS_ERR(zynqmp_data
->hws
[i
])) {
641 pr_err("Zynq Ultrascale+ MPSoC clk %s: register failed with %ld\n",
642 clock
[i
].clk_name
, PTR_ERR(zynqmp_data
->hws
[i
]));
650 * zynqmp_get_clock_info() - Get clock information from firmware using PM_API
652 static void zynqmp_get_clock_info(void)
656 u32 nodetype
, subclass
, class;
657 struct attr_resp attr
;
658 struct name_resp name
;
660 for (i
= 0; i
< clock_max_idx
; i
++) {
661 ret
= zynqmp_pm_clock_get_attributes(i
, &attr
);
665 clock
[i
].valid
= FIELD_GET(CLK_ATTR_VALID
, attr
.attr
[0]);
666 clock
[i
].type
= FIELD_GET(CLK_ATTR_TYPE
, attr
.attr
[0]) ?
667 CLK_TYPE_EXTERNAL
: CLK_TYPE_OUTPUT
;
669 nodetype
= FIELD_GET(CLK_ATTR_NODE_TYPE
, attr
.attr
[0]);
670 subclass
= FIELD_GET(CLK_ATTR_NODE_SUBCLASS
, attr
.attr
[0]);
671 class = FIELD_GET(CLK_ATTR_NODE_CLASS
, attr
.attr
[0]);
673 clock
[i
].clk_id
= FIELD_PREP(CLK_ATTR_NODE_CLASS
, class) |
674 FIELD_PREP(CLK_ATTR_NODE_SUBCLASS
, subclass
) |
675 FIELD_PREP(CLK_ATTR_NODE_TYPE
, nodetype
) |
676 FIELD_PREP(CLK_ATTR_NODE_INDEX
, i
);
678 zynqmp_pm_clock_get_name(clock
[i
].clk_id
, &name
);
679 if (!strcmp(name
.name
, RESERVED_CLK_NAME
))
681 strncpy(clock
[i
].clk_name
, name
.name
, MAX_NAME_LEN
);
684 /* Get topology of all clock */
685 for (i
= 0; i
< clock_max_idx
; i
++) {
686 ret
= zynqmp_get_clock_type(i
, &type
);
687 if (ret
|| type
!= CLK_TYPE_OUTPUT
)
690 ret
= zynqmp_clock_get_topology(i
, clock
[i
].node
,
691 &clock
[i
].num_nodes
);
695 ret
= zynqmp_clock_get_parents(i
, clock
[i
].parent
,
696 &clock
[i
].num_parents
);
703 * zynqmp_clk_setup() - Setup the clock framework and register clocks
706 * Return: 0 on success else error code
708 static int zynqmp_clk_setup(struct device_node
*np
)
712 ret
= zynqmp_pm_clock_get_num_clocks(&clock_max_idx
);
716 zynqmp_data
= kzalloc(struct_size(zynqmp_data
, hws
, clock_max_idx
),
721 clock
= kcalloc(clock_max_idx
, sizeof(*clock
), GFP_KERNEL
);
727 zynqmp_get_clock_info();
728 zynqmp_register_clocks(np
);
730 zynqmp_data
->num
= clock_max_idx
;
731 of_clk_add_hw_provider(np
, of_clk_hw_onecell_get
, zynqmp_data
);
736 static int zynqmp_clock_probe(struct platform_device
*pdev
)
739 struct device
*dev
= &pdev
->dev
;
741 eemi_ops
= zynqmp_pm_get_eemi_ops();
742 if (IS_ERR(eemi_ops
))
743 return PTR_ERR(eemi_ops
);
745 ret
= zynqmp_clk_setup(dev
->of_node
);
750 static const struct of_device_id zynqmp_clock_of_match
[] = {
751 {.compatible
= "xlnx,zynqmp-clk"},
754 MODULE_DEVICE_TABLE(of
, zynqmp_clock_of_match
);
756 static struct platform_driver zynqmp_clock_driver
= {
758 .name
= "zynqmp_clock",
759 .of_match_table
= zynqmp_clock_of_match
,
761 .probe
= zynqmp_clock_probe
,
763 module_platform_driver(zynqmp_clock_driver
);