clk_bulk_get_optional() allows to get a group of clocks where one or more is optional. For a not available clock, e.g. not specifed in the clock consumer node in DT, its respective struct clk pointer will be NULL. This allows for operating on a group of returned clocks (struct clk_bulk_data array) with existing clk_bulk* APIs.
Showing the changes to include/linux (1 of 2 files). Show all
Unified · Split
| @@ -332,6 +332,19 @@ int __must_check clk_bulk_get(struct device *dev, int num_clks, · 331 unmodified lines | ||
| 332 | 332 | */ |
| 333 | 333 | int __must_check clk_bulk_get_all(struct device *dev, |
| 334 | 334 | struct clk_bulk_data **clks); |
| 335 | + | |
| 336 | +/** | |
| 337 | + * clk_bulk_get_optional - lookup and obtain a number of references to clock producer | |
| 338 | + * @dev: device for clock "consumer" | |
| 339 | + * @num_clks: the number of clk_bulk_data | |
| 340 | + * @clks: the clk_bulk_data table of consumer | |
| 341 | + * | |
| 342 | + * Behaves the same as clk_bulk_get() except where there is no clock producer. | |
| 343 | + * In this case, instead of returning -ENOENT, the function returns 0 and | |
| 344 | + * NULL for a clk for which a clock producer could not be determined. | |
| 345 | + */ | |
| 346 | +int __must_check clk_bulk_get_optional(struct device *dev, int num_clks, | |
| 347 | + struct clk_bulk_data *clks); | |
| 335 | 348 | /** |
| 336 | 349 | * devm_clk_bulk_get - managed get multiple clk consumers |
| 337 | 350 | * @dev: device for clock "consumer" |
| @@ -718,6 +731,12 @@ static inline int __must_check clk_bulk_get(struct device *dev, int num_clks, · 380 unmodified lines | ||
| 718 | 731 | return 0; |
| 719 | 732 | } |
| 720 | 733 | |
| 734 | +static inline int __must_check clk_bulk_get_optional(struct device *dev, | |
| 735 | + int num_clks, struct clk_bulk_data *clks) | |
| 736 | +{ | |
| 737 | + return 0; | |
| 738 | +} | |
| 739 | + | |
| 721 | 740 | static inline int __must_check clk_bulk_get_all(struct device *dev, |
| 722 | 741 | struct clk_bulk_data **clks) |
| 723 | 742 | { |