1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* Copyright (c) 2013, The Linux Foundation. All rights reserved. */ 3 4 #ifndef __QCOM_CLK_BRANCH_H__ 5 #define __QCOM_CLK_BRANCH_H__ 6 7 #include <linux/bitfield.h> 8 #include <linux/clk-provider.h> 9 10 #include "clk-regmap.h" 11 12 /** 13 * struct clk_branch - gating clock with status bit and dynamic hardware gating 14 * 15 * @hwcg_reg: dynamic hardware clock gating register 16 * @hwcg_bit: ORed with @hwcg_reg to enable dynamic hardware clock gating 17 * @halt_reg: halt register 18 * @halt_bit: ANDed with @halt_reg to test for clock halted 19 * @halt_check: type of halt checking to perform 20 * @clkr: handle between common and hardware-specific interfaces 21 * 22 * Clock which can gate its output. 23 */ 24 struct clk_branch { 25 u32 hwcg_reg; 26 u32 halt_reg; 27 u8 hwcg_bit; 28 u8 halt_bit; 29 u8 halt_check; 30 #define BRANCH_VOTED BIT(7) /* Delay on disable */ 31 #define BRANCH_HALT 0 /* pol: 1 = halt */ 32 #define BRANCH_HALT_VOTED (BRANCH_HALT | BRANCH_VOTED) 33 #define BRANCH_HALT_ENABLE 1 /* pol: 0 = halt */ 34 #define BRANCH_HALT_ENABLE_VOTED (BRANCH_HALT_ENABLE | BRANCH_VOTED) 35 #define BRANCH_HALT_DELAY 2 /* No bit to check; just delay */ 36 #define BRANCH_HALT_SKIP 3 /* Don't check halt bit */ 37 38 struct clk_regmap clkr; 39 }; 40 41 /** 42 * struct clk_mem_branch - gating clock which are associated with memories 43 * 44 * @mem_enable_reg: branch clock memory gating register 45 * @mem_ack_reg: branch clock memory ack register 46 * @mem_enable_ack_mask: branch clock memory enable and ack field in @mem_ack_reg 47 * @mem_enable_mask: branch clock memory enable mask 48 * @mem_enable_invert: branch clock memory enable and disable has invert logic 49 * @branch: branch clock gating handle 50 * 51 * Clock which can gate its memories. 52 */ 53 struct clk_mem_branch { 54 u32 mem_enable_reg; 55 u32 mem_ack_reg; 56 u32 mem_enable_ack_mask; 57 u32 mem_enable_mask; 58 bool mem_enable_invert; 59 struct clk_branch branch; 60 }; 61 62 /* Branch clock common bits for HLOS-owned clocks */ 63 #define CBCR_CLK_OFF BIT(31) 64 #define CBCR_NOC_FSM_STATUS GENMASK(30, 28) 65 #define FSM_STATUS_ON BIT(1) 66 #define CBCR_FORCE_MEM_CORE_ON BIT(14) 67 #define CBCR_FORCE_MEM_PERIPH_ON BIT(13) 68 #define CBCR_FORCE_MEM_PERIPH_OFF BIT(12) 69 #define CBCR_WAKEUP GENMASK(11, 8) 70 #define CBCR_SLEEP GENMASK(7, 4) 71 #define CBCR_CLOCK_ENABLE BIT(0) 72 73 static inline void qcom_branch_set_force_mem_core(struct regmap *regmap, 74 struct clk_branch clk, bool on) 75 { 76 regmap_update_bits(regmap, clk.halt_reg, CBCR_FORCE_MEM_CORE_ON, 77 on ? CBCR_FORCE_MEM_CORE_ON : 0); 78 } 79 80 static inline void qcom_branch_set_force_periph_on(struct regmap *regmap, 81 struct clk_branch clk, bool on) 82 { 83 regmap_update_bits(regmap, clk.halt_reg, CBCR_FORCE_MEM_PERIPH_ON, 84 on ? CBCR_FORCE_MEM_PERIPH_ON : 0); 85 } 86 87 static inline void qcom_branch_set_force_periph_off(struct regmap *regmap, 88 struct clk_branch clk, bool on) 89 { 90 regmap_update_bits(regmap, clk.halt_reg, CBCR_FORCE_MEM_PERIPH_OFF, 91 on ? CBCR_FORCE_MEM_PERIPH_OFF : 0); 92 } 93 94 static inline void qcom_branch_set_wakeup(struct regmap *regmap, struct clk_branch clk, u32 val) 95 { 96 regmap_update_bits(regmap, clk.halt_reg, CBCR_WAKEUP, 97 FIELD_PREP(CBCR_WAKEUP, val)); 98 } 99 100 static inline void qcom_branch_set_sleep(struct regmap *regmap, struct clk_branch clk, u32 val) 101 { 102 regmap_update_bits(regmap, clk.halt_reg, CBCR_SLEEP, 103 FIELD_PREP(CBCR_SLEEP, val)); 104 } 105 106 static inline void qcom_branch_set_clk_en(struct regmap *regmap, u32 cbcr) 107 { 108 regmap_update_bits(regmap, cbcr, CBCR_CLOCK_ENABLE, CBCR_CLOCK_ENABLE); 109 } 110 111 extern const struct clk_ops clk_branch_ops; 112 extern const struct clk_ops clk_branch2_ops; 113 extern const struct clk_ops clk_branch_simple_ops; 114 extern const struct clk_ops clk_branch2_aon_ops; 115 extern const struct clk_ops clk_branch2_mem_ops; 116 extern const struct clk_ops clk_branch2_prepare_ops; 117 118 #define to_clk_branch(_hw) \ 119 container_of(to_clk_regmap(_hw), struct clk_branch, clkr) 120 121 #define to_clk_mem_branch(_hw) \ 122 container_of(to_clk_branch(_hw), struct clk_mem_branch, branch) 123 124 #endif 125