blob: b89074b8acdb5753ce8558dc53c73cd02a535295 [file] [log] [blame]
Tom Rini83d290c2018-05-06 17:58:06 -04001/* SPDX-License-Identifier: GPL-2.0+ */
Simon Glass1aa7e232012-04-02 13:18:44 +00002/*
3 * (C) Copyright 2010,2011
4 * NVIDIA Corporation <www.nvidia.com>
Simon Glass1aa7e232012-04-02 13:18:44 +00005 */
6
Jeroen Hofstee7ffdc832014-06-10 23:01:58 +02007#ifndef _TPS6586X_H_
Simon Glass1aa7e232012-04-02 13:18:44 +00008#define _TPS6586X_H_
9
Simon Glass401d1c42020-10-30 21:38:53 -060010struct udevice;
11
Simon Glass1aa7e232012-04-02 13:18:44 +000012enum {
13 /* SM0-2 PWM/PFM Mode Selection */
14 TPS6586X_PWM_SM0 = 1 << 0,
15 TPS6586X_PWM_SM1 = 1 << 1,
16 TPS6586X_PWM_SM2 = 1 << 2,
17};
18
19/**
20 * Enable PWM mode for selected SM0-2
21 *
22 * @param mask Mask of synchronous converter to enable (TPS6586X_PWM_...)
Heinrich Schuchardt185f8122022-01-19 18:05:50 +010023 * Return: 0 if ok, -1 on error
Simon Glass1aa7e232012-04-02 13:18:44 +000024 */
25int tps6586x_set_pwm_mode(int mask);
26
27/**
28 * Adjust SM0 and SM1 voltages to the given targets in incremental steps.
29 *
30 * @param sm0_target Target voltage for SM0 in 25mW units, 0=725mV, 31=1.5V
31 * @param sm1_target Target voltage for SM1 in 25mW units, 0=725mV, 31=1.5V
32 * @param step Amount to change voltage in each step, in 25mW units
33 * @param rate Slew ratein mV/us: 0=instantly, 1=0.11, 2=0.22,
34 * 3=0.44, 4=0.88, 5=1.76, 6=3.52, 7=7.04
35 * @param min_sm0_over_sm1 Minimum amount by which sm0 must exceed sm1.
36 * If this condition is not met, no adjustment will be
37 * done and an error will be reported. Use -1 to skip
38 * this check.
Heinrich Schuchardt185f8122022-01-19 18:05:50 +010039 * Return: 0 if ok, -1 on error
Simon Glass1aa7e232012-04-02 13:18:44 +000040 */
41int tps6586x_adjust_sm0_sm1(int sm0_target, int sm1_target, int step, int rate,
42 int min_sm0_over_sm1);
43
44/**
45 * Set up the TPS6586X I2C bus number. This will be used for all operations
46 * on the device. This function must be called before using other functions.
47 *
Simon Glassb0e6ef42014-12-10 08:55:57 -070048 * @param bus I2C bus containing the TPS6586X chip
Heinrich Schuchardt185f8122022-01-19 18:05:50 +010049 * Return: 0 (always succeeds)
Simon Glass1aa7e232012-04-02 13:18:44 +000050 */
Simon Glassb0e6ef42014-12-10 08:55:57 -070051int tps6586x_init(struct udevice *bus);
Simon Glass1aa7e232012-04-02 13:18:44 +000052
53#endif /* _TPS6586X_H_ */