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