1 /* 2 * OMAP Voltage Management Routines 3 * 4 * Author: Thara Gopinath <thara@ti.com> 5 * 6 * Copyright (C) 2009 Texas Instruments, Inc. 7 * Thara Gopinath <thara@ti.com> 8 * 9 * This program is free software; you can redistribute it and/or modify 10 * it under the terms of the GNU General Public License version 2 as 11 * published by the Free Software Foundation. 12 */ 13 14 #ifndef __ARCH_ARM_MACH_OMAP2_VOLTAGE_H 15 #define __ARCH_ARM_MACH_OMAP2_VOLTAGE_H 16 17 #include <linux/err.h> 18 19 #include <linux/platform_data/voltage-omap.h> 20 21 #include "vc.h" 22 #include "vp.h" 23 24 struct powerdomain; 25 26 /* 27 * OMAP3 GENERIC setup times. Revisit to see if these needs to be 28 * passed from board or PMIC file 29 */ 30 #define OMAP3_CLKSETUP 0xff 31 #define OMAP3_VOLTOFFSET 0xff 32 #define OMAP3_VOLTSETUP2 0xff 33 34 /** 35 * struct omap_vfsm_instance - per-voltage manager FSM register/bitfield 36 * data 37 * @voltsetup_mask: SETUP_TIME* bitmask in the PRM_VOLTSETUP* register 38 * @voltsetup_reg: register offset of PRM_VOLTSETUP from PRM base 39 * @voltsetup_off_reg: register offset of PRM_VOLTSETUP_OFF from PRM base 40 * 41 * XXX What about VOLTOFFSET/VOLTCTRL? 42 */ 43 struct omap_vfsm_instance { 44 u32 voltsetup_mask; 45 u8 voltsetup_reg; 46 u8 voltsetup_off_reg; 47 }; 48 49 /** 50 * struct voltagedomain - omap voltage domain global structure. 51 * @name: Name of the voltage domain which can be used as a unique identifier. 52 * @scalable: Whether or not this voltage domain is scalable 53 * @node: list_head linking all voltage domains 54 * @vc: pointer to VC channel associated with this voltagedomain 55 * @vp: pointer to VP associated with this voltagedomain 56 * @read: read a VC/VP register 57 * @write: write a VC/VP register 58 * @read: read-modify-write a VC/VP register 59 * @sys_clk: system clock name/frequency, used for various timing calculations 60 * @scale: function used to scale the voltage of the voltagedomain 61 * @nominal_volt: current nominal voltage for this voltage domain 62 * @volt_data: voltage table having the distinct voltages supported 63 * by the domain and other associated per voltage data. 64 */ 65 struct voltagedomain { 66 char *name; 67 bool scalable; 68 struct list_head node; 69 struct omap_vc_channel *vc; 70 const struct omap_vfsm_instance *vfsm; 71 struct omap_vp_instance *vp; 72 struct omap_voltdm_pmic *pmic; 73 struct omap_vp_param *vp_param; 74 struct omap_vc_param *vc_param; 75 76 /* VC/VP register access functions: SoC specific */ 77 u32 (*read) (u8 offset); 78 void (*write) (u32 val, u8 offset); 79 u32 (*rmw)(u32 mask, u32 bits, u8 offset); 80 81 union { 82 const char *name; 83 u32 rate; 84 } sys_clk; 85 86 int (*scale) (struct voltagedomain *voltdm, 87 unsigned long target_volt); 88 89 u32 nominal_volt; 90 struct omap_volt_data *volt_data; 91 }; 92 93 /* Min and max voltages from OMAP perspective */ 94 #define OMAP3430_VP1_VLIMITTO_VDDMIN 850000 95 #define OMAP3430_VP1_VLIMITTO_VDDMAX 1425000 96 #define OMAP3430_VP2_VLIMITTO_VDDMIN 900000 97 #define OMAP3430_VP2_VLIMITTO_VDDMAX 1150000 98 99 #define OMAP3630_VP1_VLIMITTO_VDDMIN 900000 100 #define OMAP3630_VP1_VLIMITTO_VDDMAX 1350000 101 #define OMAP3630_VP2_VLIMITTO_VDDMIN 900000 102 #define OMAP3630_VP2_VLIMITTO_VDDMAX 1200000 103 104 #define OMAP4_VP_MPU_VLIMITTO_VDDMIN 830000 105 #define OMAP4_VP_MPU_VLIMITTO_VDDMAX 1410000 106 #define OMAP4_VP_IVA_VLIMITTO_VDDMIN 830000 107 #define OMAP4_VP_IVA_VLIMITTO_VDDMAX 1260000 108 #define OMAP4_VP_CORE_VLIMITTO_VDDMIN 830000 109 #define OMAP4_VP_CORE_VLIMITTO_VDDMAX 1200000 110 111 /** 112 * struct omap_voltdm_pmic - PMIC specific data required by voltage driver. 113 * @slew_rate: PMIC slew rate (in uv/us) 114 * @step_size: PMIC voltage step size (in uv) 115 * @i2c_slave_addr: I2C slave address of PMIC 116 * @volt_reg_addr: voltage configuration register address 117 * @cmd_reg_addr: command (on, on-LP, ret, off) configuration register address 118 * @i2c_high_speed: whether VC uses I2C high-speed mode to PMIC 119 * @i2c_mcode: master code value for I2C high-speed preamble transmission 120 * @vsel_to_uv: PMIC API to convert vsel value to actual voltage in uV. 121 * @uv_to_vsel: PMIC API to convert voltage in uV to vsel value. 122 */ 123 struct omap_voltdm_pmic { 124 int slew_rate; 125 int step_size; 126 u16 i2c_slave_addr; 127 u16 volt_reg_addr; 128 u16 cmd_reg_addr; 129 u8 vp_erroroffset; 130 u8 vp_vstepmin; 131 u8 vp_vstepmax; 132 u32 vddmin; 133 u32 vddmax; 134 u8 vp_timeout_us; 135 bool i2c_high_speed; 136 u32 i2c_pad_load; 137 u8 i2c_mcode; 138 unsigned long (*vsel_to_uv) (const u8 vsel); 139 u8 (*uv_to_vsel) (unsigned long uV); 140 }; 141 142 struct omap_vp_param { 143 u32 vddmax; 144 u32 vddmin; 145 }; 146 147 struct omap_vc_param { 148 u32 on; 149 u32 onlp; 150 u32 ret; 151 u32 off; 152 }; 153 154 void omap_voltage_get_volttable(struct voltagedomain *voltdm, 155 struct omap_volt_data **volt_data); 156 struct omap_volt_data *omap_voltage_get_voltdata(struct voltagedomain *voltdm, 157 unsigned long volt); 158 int omap_voltage_register_pmic(struct voltagedomain *voltdm, 159 struct omap_voltdm_pmic *pmic); 160 int omap_voltage_late_init(void); 161 162 extern void omap2xxx_voltagedomains_init(void); 163 extern void omap3xxx_voltagedomains_init(void); 164 extern void omap44xx_voltagedomains_init(void); 165 extern void omap54xx_voltagedomains_init(void); 166 167 struct voltagedomain *voltdm_lookup(const char *name); 168 void voltdm_init(struct voltagedomain **voltdm_list); 169 int voltdm_add_pwrdm(struct voltagedomain *voltdm, struct powerdomain *pwrdm); 170 int voltdm_scale(struct voltagedomain *voltdm, unsigned long target_volt); 171 void voltdm_reset(struct voltagedomain *voltdm); 172 unsigned long voltdm_get_voltage(struct voltagedomain *voltdm); 173 #endif 174