1 /* SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause) */ 2 /* Copyright(c) 2015-17 Intel Corporation. */ 3 4 #ifndef __SDW_INTEL_LOCAL_H 5 #define __SDW_INTEL_LOCAL_H 6 7 /** 8 * struct sdw_intel_link_res - Soundwire Intel link resource structure, 9 * typically populated by the controller driver. 10 * @hw_ops: platform-specific ops 11 * @mmio_base: mmio base of SoundWire registers 12 * @registers: Link IO registers base 13 * @shim: Audio shim pointer 14 * @alh: ALH (Audio Link Hub) pointer 15 * @irq: Interrupt line 16 * @ops: Shim callback ops 17 * @dev: device implementing hw_params and free callbacks 18 * @shim_lock: mutex to handle access to shared SHIM registers 19 * @shim_mask: global pointer to check SHIM register initialization 20 * @clock_stop_quirks: mask defining requested behavior on pm_suspend 21 * @link_mask: global mask needed for power-up/down sequences 22 * @cdns: Cadence master descriptor 23 * @list: used to walk-through all masters exposed by the same controller 24 */ 25 struct sdw_intel_link_res { 26 const struct sdw_intel_hw_ops *hw_ops; 27 28 void __iomem *mmio_base; /* not strictly needed, useful for debug */ 29 void __iomem *registers; 30 void __iomem *shim; 31 void __iomem *alh; 32 int irq; 33 const struct sdw_intel_ops *ops; 34 struct device *dev; 35 struct mutex *shim_lock; /* protect shared registers */ 36 u32 *shim_mask; 37 u32 clock_stop_quirks; 38 u32 link_mask; 39 struct sdw_cdns *cdns; 40 struct list_head list; 41 }; 42 43 struct sdw_intel { 44 struct sdw_cdns cdns; 45 int instance; 46 struct sdw_intel_link_res *link_res; 47 bool startup_done; 48 #ifdef CONFIG_DEBUG_FS 49 struct dentry *debugfs; 50 #endif 51 }; 52 53 #define cdns_to_intel(_cdns) container_of(_cdns, struct sdw_intel, cdns) 54 55 #define INTEL_MASTER_RESET_ITERATIONS 10 56 57 #define SDW_INTEL_CHECK_OPS(sdw, cb) ((sdw) && (sdw)->link_res && (sdw)->link_res->hw_ops && \ 58 (sdw)->link_res->hw_ops->cb) 59 #define SDW_INTEL_OPS(sdw, cb) ((sdw)->link_res->hw_ops->cb) 60 61 static inline void sdw_intel_debugfs_init(struct sdw_intel *sdw) 62 { 63 if (SDW_INTEL_CHECK_OPS(sdw, debugfs_init)) 64 SDW_INTEL_OPS(sdw, debugfs_init)(sdw); 65 } 66 67 static inline void sdw_intel_debugfs_exit(struct sdw_intel *sdw) 68 { 69 if (SDW_INTEL_CHECK_OPS(sdw, debugfs_exit)) 70 SDW_INTEL_OPS(sdw, debugfs_exit)(sdw); 71 } 72 73 static inline int sdw_intel_register_dai(struct sdw_intel *sdw) 74 { 75 if (SDW_INTEL_CHECK_OPS(sdw, register_dai)) 76 return SDW_INTEL_OPS(sdw, register_dai)(sdw); 77 return -ENOTSUPP; 78 } 79 80 static inline void sdw_intel_check_clock_stop(struct sdw_intel *sdw) 81 { 82 if (SDW_INTEL_CHECK_OPS(sdw, check_clock_stop)) 83 SDW_INTEL_OPS(sdw, check_clock_stop)(sdw); 84 } 85 86 static inline int sdw_intel_start_bus(struct sdw_intel *sdw) 87 { 88 if (SDW_INTEL_CHECK_OPS(sdw, start_bus)) 89 return SDW_INTEL_OPS(sdw, start_bus)(sdw); 90 return -ENOTSUPP; 91 } 92 93 static inline int sdw_intel_start_bus_after_reset(struct sdw_intel *sdw) 94 { 95 if (SDW_INTEL_CHECK_OPS(sdw, start_bus_after_reset)) 96 return SDW_INTEL_OPS(sdw, start_bus_after_reset)(sdw); 97 return -ENOTSUPP; 98 } 99 100 static inline int sdw_intel_start_bus_after_clock_stop(struct sdw_intel *sdw) 101 { 102 if (SDW_INTEL_CHECK_OPS(sdw, start_bus_after_clock_stop)) 103 return SDW_INTEL_OPS(sdw, start_bus_after_clock_stop)(sdw); 104 return -ENOTSUPP; 105 } 106 107 static inline int sdw_intel_stop_bus(struct sdw_intel *sdw, bool clock_stop) 108 { 109 if (SDW_INTEL_CHECK_OPS(sdw, stop_bus)) 110 return SDW_INTEL_OPS(sdw, stop_bus)(sdw, clock_stop); 111 return -ENOTSUPP; 112 } 113 114 static inline int sdw_intel_link_power_up(struct sdw_intel *sdw) 115 { 116 if (SDW_INTEL_CHECK_OPS(sdw, link_power_up)) 117 return SDW_INTEL_OPS(sdw, link_power_up)(sdw); 118 return -ENOTSUPP; 119 } 120 121 static inline int sdw_intel_link_power_down(struct sdw_intel *sdw) 122 { 123 if (SDW_INTEL_CHECK_OPS(sdw, link_power_down)) 124 return SDW_INTEL_OPS(sdw, link_power_down)(sdw); 125 return -ENOTSUPP; 126 } 127 128 static inline int sdw_intel_shim_check_wake(struct sdw_intel *sdw) 129 { 130 if (SDW_INTEL_CHECK_OPS(sdw, shim_check_wake)) 131 return SDW_INTEL_OPS(sdw, shim_check_wake)(sdw); 132 return -ENOTSUPP; 133 } 134 135 static inline void sdw_intel_shim_wake(struct sdw_intel *sdw, bool wake_enable) 136 { 137 if (SDW_INTEL_CHECK_OPS(sdw, shim_wake)) 138 SDW_INTEL_OPS(sdw, shim_wake)(sdw, wake_enable); 139 } 140 141 #endif /* __SDW_INTEL_LOCAL_H */ 142