2  * CPU frequency scaling for Broadcom SoCs with AVS firmware that
18  * "AVS" is the name of a firmware developed at Broadcom. It derives
21  * The AVS firmware still supports "AVS mode", where all it does is
23  * AVS Firmware, despite its unchanged name, also supports DFS mode and
26  * In the context of this document and the related driver, "AVS" by
30  * The Broadcom STB AVS CPUfreq driver provides voltage and frequency
31  * scaling on Broadcom SoCs using AVS firmware with support for DFS and
32  * DVFS. The AVS firmware is running on its own co-processor. The
36  * Actual voltage and frequency scaling is done solely by the AVS
39  * and to userland. It interfaces with the AVS firmware to effect the
53 /* Max number of arguments AVS calls take */
56  * This macro is used to generate AVS parameter register offsets. For
62 /* AVS Mailbox Register offsets */
82 /* AVS Commands */
99 /* Different modes AVS supports (for GET_PMAP/SET_PMAP) */
128 /* Different P-STATES AVS supports (for GET_PSTATE/SET_PSTATE) */
140 /* AVS Command Status Values */
148 /* Non-AVS modes are not supported */
154 /* Max AVS status; higher numbers are used for debugging */
157 /* Other AVS related constants */
162 #define BRCM_AVS_CPUFREQ_PREFIX	"brcmstb-avs"
164 #define BRCM_AVS_CPU_DATA	"brcm,avs-cpu-data-mem"
165 #define BRCM_AVS_CPU_INTR	"brcm,avs-cpu-l2-intr"
239 	 * Make sure no other command is currently running: cmd is 0 if AVS  in __issue_avs_command()
246 	/* Give the caller a chance to retry if AVS is busy. */  in __issue_avs_command()
266 	/* Wait for AVS co-processor to finish processing the command. */  in __issue_avs_command()
270 	 * If the AVS status is not in the expected range, it means AVS didn't  in __issue_avs_command()
276 		dev_err(priv->dev, "AVS command %#x didn't complete in time\n",  in __issue_avs_command()
278 		dev_err(priv->dev, "    Time left: %u ms, AVS status: %#x\n",  in __issue_avs_command()
288 	/* Clear status to tell AVS co-processor we are done. */  in __issue_avs_command()
320 	/* AVS command completed execution. Wake up __issue_avs_command(). */  in irq_handler()
330 		return "AVS";  in brcm_avs_mode_to_string()
438 	 * We allocate space for the 5 different P-STATES AVS,  in brcm_avs_get_freq_table()
515 	 * AVS co-processor, not necessarily the P-state we are running at now.  in brcm_avs_suspend()
598 	dev_err(dev, "AVS firmware is not loaded or doesn't support DVFS\n");  in brcm_avs_prepare_init()
785 MODULE_DESCRIPTION("CPUfreq driver for Broadcom STB AVS");