1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * OMAP3/4 Voltage Controller (VC) structure and macro definitions
4 *
5 * Copyright (C) 2007, 2010 Texas Instruments, Inc.
6 * Rajendra Nayak <rnayak@ti.com>
7 * Lesly A M <x0080970@ti.com>
8 * Thara Gopinath <thara@ti.com>
9 *
10 * Copyright (C) 2008, 2011 Nokia Corporation
11 * Kalle Jokiniemi
12 * Paul Walmsley
13 */
14#ifndef __ARCH_ARM_MACH_OMAP2_VC_H
15#define __ARCH_ARM_MACH_OMAP2_VC_H
16
17#include <linux/kernel.h>
18
19struct voltagedomain;
20
21/**
22 * struct omap_vc_common - per-VC register/bitfield data
23 * @cmd_on_mask: ON bitmask in PRM_VC_CMD_VAL* register
24 * @valid: VALID bitmask in PRM_VC_BYPASS_VAL register
25 * @bypass_val_reg: Offset of PRM_VC_BYPASS_VAL reg from PRM start
26 * @data_shift: DATA field shift in PRM_VC_BYPASS_VAL register
27 * @slaveaddr_shift: SLAVEADDR field shift in PRM_VC_BYPASS_VAL register
28 * @regaddr_shift: REGADDR field shift in PRM_VC_BYPASS_VAL register
29 * @cmd_on_shift: ON field shift in PRM_VC_CMD_VAL_* register
30 * @cmd_onlp_shift: ONLP field shift in PRM_VC_CMD_VAL_* register
31 * @cmd_ret_shift: RET field shift in PRM_VC_CMD_VAL_* register
32 * @cmd_off_shift: OFF field shift in PRM_VC_CMD_VAL_* register
33 * @i2c_cfg_reg: I2C configuration register offset
34 * @i2c_cfg_clear_mask: high-speed mode bit clear mask in I2C config register
35 * @i2c_cfg_hsen_mask: high-speed mode bit field mask in I2C config register
36 * @i2c_mcode_mask: MCODE field mask for I2C config register
37 *
38 * XXX One of cmd_on_mask and cmd_on_shift are not needed
39 * XXX VALID should probably be a shift, not a mask
40 */
41struct omap_vc_common {
42	u32 cmd_on_mask;
43	u32 valid;
44	u8 bypass_val_reg;
45	u8 data_shift;
46	u8 slaveaddr_shift;
47	u8 regaddr_shift;
48	u8 cmd_on_shift;
49	u8 cmd_onlp_shift;
50	u8 cmd_ret_shift;
51	u8 cmd_off_shift;
52	u8 i2c_cfg_reg;
53	u8 i2c_cfg_clear_mask;
54	u8 i2c_cfg_hsen_mask;
55	u8 i2c_mcode_mask;
56};
57
58/* omap_vc_channel.flags values */
59#define OMAP_VC_CHANNEL_DEFAULT BIT(0)
60#define OMAP_VC_CHANNEL_CFG_MUTANT BIT(1)
61
62/**
63 * struct omap_vc_channel - VC per-instance data
64 * @i2c_slave_addr: I2C slave address of PMIC for this VC channel
65 * @volt_reg_addr: voltage configuration register address
66 * @cmd_reg_addr: command configuration register address
67 * @setup_time: setup time (in sys_clk cycles) of regulator for this channel
68 * @cfg_channel: current value of VC channel configuration register
69 * @i2c_high_speed: whether or not to use I2C high-speed mode
70 *
71 * @common: pointer to VC common data for this platform
72 * @smps_sa_mask: i2c slave address bitmask in the PRM_VC_SMPS_SA register
73 * @smps_volra_mask: VOLRA* bitmask in the PRM_VC_VOL_RA register
74 * @smps_cmdra_mask: CMDRA* bitmask in the PRM_VC_CMD_RA register
75 * @cmdval_reg: register for on/ret/off voltage level values for this channel
76 * @smps_sa_reg: Offset of PRM_VC_SMPS_SA reg from PRM start
77 * @smps_volra_reg: Offset of PRM_VC_SMPS_VOL_RA reg from PRM start
78 * @smps_cmdra_reg: Offset of PRM_VC_SMPS_CMD_RA reg from PRM start
79 * @cfg_channel_reg: VC channel configuration register
80 * @cfg_channel_sa_shift: bit shift for slave address cfg_channel register
81 * @flags: VC channel-specific flags (optional)
82 */
83struct omap_vc_channel {
84	/* channel state */
85	u16 i2c_slave_addr;
86	u16 volt_reg_addr;
87	u16 cmd_reg_addr;
88	u8 cfg_channel;
89	bool i2c_high_speed;
90
91	/* register access data */
92	const struct omap_vc_common *common;
93	u32 smps_sa_mask;
94	u32 smps_volra_mask;
95	u32 smps_cmdra_mask;
96	u8 cmdval_reg;
97	u8 smps_sa_reg;
98	u8 smps_volra_reg;
99	u8 smps_cmdra_reg;
100	u8 cfg_channel_reg;
101	u8 cfg_channel_sa_shift;
102	u8 flags;
103};
104
105extern struct omap_vc_channel omap3_vc_mpu;
106extern struct omap_vc_channel omap3_vc_core;
107
108extern struct omap_vc_channel omap4_vc_mpu;
109extern struct omap_vc_channel omap4_vc_iva;
110extern struct omap_vc_channel omap4_vc_core;
111
112extern struct omap_vc_param omap3_mpu_vc_data;
113extern struct omap_vc_param omap3_core_vc_data;
114
115extern struct omap_vc_param omap4_mpu_vc_data;
116extern struct omap_vc_param omap4_iva_vc_data;
117extern struct omap_vc_param omap4_core_vc_data;
118
119void omap3_vc_set_pmic_signaling(int core_next_state);
120void omap4_vc_set_pmic_signaling(int core_next_state);
121
122void omap_vc_init_channel(struct voltagedomain *voltdm);
123int omap_vc_pre_scale(struct voltagedomain *voltdm,
124		      unsigned long target_volt,
125		      u8 *target_vsel, u8 *current_vsel);
126void omap_vc_post_scale(struct voltagedomain *voltdm,
127			unsigned long target_volt,
128			u8 target_vsel, u8 current_vsel);
129int omap_vc_bypass_scale(struct voltagedomain *voltdm,
130			 unsigned long target_volt);
131
132#endif
133
134