summaryrefslogtreecommitdiff
path: root/driver/mp4245.h
blob: b453ad20765c71c5ce04b8e461a88aeff66f7efa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
/* Copyright 2020 The Chromium OS Authors. All rights reserved.
 * Use of this source code is governed by a BSD-style license that can be
 * found in the LICENSE file.
 */
/* MPS MP4245 Buck-Boost converter driver definitions */

/* I2C addresses */
#define MP4245_I2C_ADDR_0_FLAGS 0x61  /* R1 -> GND */
#define MP4245_I2C_ADDR_1_FLAGS 0x62  /* R1 -> 15.0k */
#define MP4245_I2C_ADDR_2_FLAGS 0x63  /* R1 -> 25.5k */
#define MP4245_I2C_ADDR_3_FLAGS 0x64  /* R1 -> 35.7k */
#define MP4245_I2C_ADDR_4_FLAGS 0x65  /* R1 -> 45.3k */
#define MP4245_I2C_ADDR_5_FLAGS 0x66  /* R1 -> 56.0k */
#define MP4245_I2C_ADDR_6_FLAGS 0x67  /* R1 -> VCC */


/* MP4245 CMD Offsets */
#define MP4245_CMD_OPERATION         0x01
#define MP4245_CMD_CLEAR_FAULTS      0x03
#define MP4245_CMD_WRITE_PROTECT     0x10
#define MP4245_CMD_STORE_USER_ALL    0x15
#define MP4245_CMD_RESTORE_USER_ALL  0x16
#define MP4245_CMD_VOUT_MODE         0x20
#define MP4245_CMD_VOUT_COMMAND      0x21
#define MP4245_CMD_VOUT_SCALE_LOOP   0x29
#define MP4245_CMD_STATUS_BYTE       0x78
#define MP4245_CMD_STATUS_WORD       0x79
#define MP4245_CMD_STATUS_VOUT       0x7A
#define MP4245_CMD_STATUS_INPUT      0x7C
#define MP4245_CMD_STATUS_TEMP       0x7D
#define MP4245_CMD_STATUS_CML        0x7E
#define MP4245_CMD_READ_VIN          0x88
#define MP4245_CMD_READ_VOUT         0x8B
#define MP4245_CMD_READ_IOUT         0x8C
#define MP4245_CMD_READ_TEMP         0x8D
#define MP4245_CMD_MFR_MODE_CTRL     0xD0
#define MP4245_CMD_MFR_CURRENT_LIM   0xD1
#define MP4245_CMD_MFR_LINE_DROP     0xD2
#define MP4245_CMD_MFR_OT_FAULT_LIM  0xD3
#define MP4245_CMD_MFR_OT_WARN_LIM   0xD4
#define MP4245_CMD_MFR_CRC_ERROR     0xD5
#define MP4245_CMD_MFF_MTP_CFG_CODE  0xD6
#define MP4245_CMD_MFR_MTP_REV_NUM   0xD7
#define MP4245_CMD_MFR_STATUS_MASK   0xD8

#define MP4245_CMD_OPERATION_ON      BIT(7)

#define MP4245_VOUT_1V               BIT(10)
#define MP4245_VOUT_FROM_MV          (MP4245_VOUT_1V * MP4245_VOUT_1V / 1000)
#define MP4245_VOUT_TO_MV(v)         ((v * 1000) / MP4245_VOUT_1V)
#define MP4245_IOUT_TO_MA(i)         (((i & 0x7ff) * 1000) / BIT(6))
#define MP4245_ILIM_STEP_MA          50
#define MP4245_VOUT_5V_DELAY_MS      10


#define MP4245_MFR_STATUS_MASK_VOUT        BIT(7)
#define MP4245_MFR_STATUS_MASK_IOUT        BIT(6)
#define MP4245_MFR_STATUS_MASK_INPUT       BIT(5)
#define MP4245_MFR_STATUS_MASK_TEMP        BIT(4)
#define MP4245_MFR_STATUS_MASK_PG_STATUS   BIT(3)
#define MP4245_MFR_STATUS_MASK_PG_ALT_EDGE BIT(2)
#define MP4245_MFR_STATUS_MASK_OTHER       BIT(1)
#define MP4245_MFR_STATUS_MASK_UNKNOWN     BIT(0)

/**
 * MP4245 set output voltage level
 *
 * @param desired_mv -> voltage level in mV
 * @return i2c write result
 */
int mp4245_set_voltage_out(int desired_mv);

/**
 * MP4245 set output current limit
 *
 * @param desired_ma -> current limit in mA
 * @return i2c write result
 */
int mp4245_set_current_lim(int desired_ma);

/**
 * MP4245 set output current limit
 *
 * @param enable -> 0 = off, else on
 * @return i2c write result
 */
int mp4245_votlage_out_enable(int enable);

/**
 * MP4245 get Vbus voltage/current values
 *
 * @param *mv -> vbus voltage in mV
 * @param *ma -> vbus current in mA
 * @return i2c read results
 */
int mp3245_get_vbus(int *mv, int *ma);