xref: /netbsd-src/sys/external/gpl2/dts/dist/include/dt-bindings/usb/pd.h (revision 9fb66d812c00ebfb445c0b47dea128f32aa6fe96)
1 /*	$NetBSD: pd.h,v 1.1.1.1 2019/01/22 14:57:01 jmcneill Exp $	*/
2 
3 /* SPDX-License-Identifier: GPL-2.0 */
4 #ifndef __DT_POWER_DELIVERY_H
5 #define __DT_POWER_DELIVERY_H
6 
7 /* Power delivery Power Data Object definitions */
8 #define PDO_TYPE_FIXED		0
9 #define PDO_TYPE_BATT		1
10 #define PDO_TYPE_VAR		2
11 #define PDO_TYPE_APDO		3
12 
13 #define PDO_TYPE_SHIFT		30
14 #define PDO_TYPE_MASK		0x3
15 
16 #define PDO_TYPE(t)	((t) << PDO_TYPE_SHIFT)
17 
18 #define PDO_VOLT_MASK		0x3ff
19 #define PDO_CURR_MASK		0x3ff
20 #define PDO_PWR_MASK		0x3ff
21 
22 #define PDO_FIXED_DUAL_ROLE	(1 << 29) /* Power role swap supported */
23 #define PDO_FIXED_SUSPEND	(1 << 28) /* USB Suspend supported (Source) */
24 #define PDO_FIXED_HIGHER_CAP	(1 << 28) /* Requires more than vSafe5V (Sink) */
25 #define PDO_FIXED_EXTPOWER	(1 << 27) /* Externally powered */
26 #define PDO_FIXED_USB_COMM	(1 << 26) /* USB communications capable */
27 #define PDO_FIXED_DATA_SWAP	(1 << 25) /* Data role swap supported */
28 #define PDO_FIXED_VOLT_SHIFT	10	/* 50mV units */
29 #define PDO_FIXED_CURR_SHIFT	0	/* 10mA units */
30 
31 #define PDO_FIXED_VOLT(mv)	((((mv) / 50) & PDO_VOLT_MASK) << PDO_FIXED_VOLT_SHIFT)
32 #define PDO_FIXED_CURR(ma)	((((ma) / 10) & PDO_CURR_MASK) << PDO_FIXED_CURR_SHIFT)
33 
34 #define PDO_FIXED(mv, ma, flags)			\
35 	(PDO_TYPE(PDO_TYPE_FIXED) | (flags) |		\
36 	 PDO_FIXED_VOLT(mv) | PDO_FIXED_CURR(ma))
37 
38 #define VSAFE5V 5000 /* mv units */
39 
40 #define PDO_BATT_MAX_VOLT_SHIFT	20	/* 50mV units */
41 #define PDO_BATT_MIN_VOLT_SHIFT	10	/* 50mV units */
42 #define PDO_BATT_MAX_PWR_SHIFT	0	/* 250mW units */
43 
44 #define PDO_BATT_MIN_VOLT(mv) ((((mv) / 50) & PDO_VOLT_MASK) << PDO_BATT_MIN_VOLT_SHIFT)
45 #define PDO_BATT_MAX_VOLT(mv) ((((mv) / 50) & PDO_VOLT_MASK) << PDO_BATT_MAX_VOLT_SHIFT)
46 #define PDO_BATT_MAX_POWER(mw) ((((mw) / 250) & PDO_PWR_MASK) << PDO_BATT_MAX_PWR_SHIFT)
47 
48 #define PDO_BATT(min_mv, max_mv, max_mw)			\
49 	(PDO_TYPE(PDO_TYPE_BATT) | PDO_BATT_MIN_VOLT(min_mv) |	\
50 	 PDO_BATT_MAX_VOLT(max_mv) | PDO_BATT_MAX_POWER(max_mw))
51 
52 #define PDO_VAR_MAX_VOLT_SHIFT	20	/* 50mV units */
53 #define PDO_VAR_MIN_VOLT_SHIFT	10	/* 50mV units */
54 #define PDO_VAR_MAX_CURR_SHIFT	0	/* 10mA units */
55 
56 #define PDO_VAR_MIN_VOLT(mv) ((((mv) / 50) & PDO_VOLT_MASK) << PDO_VAR_MIN_VOLT_SHIFT)
57 #define PDO_VAR_MAX_VOLT(mv) ((((mv) / 50) & PDO_VOLT_MASK) << PDO_VAR_MAX_VOLT_SHIFT)
58 #define PDO_VAR_MAX_CURR(ma) ((((ma) / 10) & PDO_CURR_MASK) << PDO_VAR_MAX_CURR_SHIFT)
59 
60 #define PDO_VAR(min_mv, max_mv, max_ma)				\
61 	(PDO_TYPE(PDO_TYPE_VAR) | PDO_VAR_MIN_VOLT(min_mv) |	\
62 	 PDO_VAR_MAX_VOLT(max_mv) | PDO_VAR_MAX_CURR(max_ma))
63 
64 #define APDO_TYPE_PPS		0
65 
66 #define PDO_APDO_TYPE_SHIFT	28	/* Only valid value currently is 0x0 - PPS */
67 #define PDO_APDO_TYPE_MASK	0x3
68 
69 #define PDO_APDO_TYPE(t)	((t) << PDO_APDO_TYPE_SHIFT)
70 
71 #define PDO_PPS_APDO_MAX_VOLT_SHIFT	17	/* 100mV units */
72 #define PDO_PPS_APDO_MIN_VOLT_SHIFT	8	/* 100mV units */
73 #define PDO_PPS_APDO_MAX_CURR_SHIFT	0	/* 50mA units */
74 
75 #define PDO_PPS_APDO_VOLT_MASK	0xff
76 #define PDO_PPS_APDO_CURR_MASK	0x7f
77 
78 #define PDO_PPS_APDO_MIN_VOLT(mv)	\
79 	((((mv) / 100) & PDO_PPS_APDO_VOLT_MASK) << PDO_PPS_APDO_MIN_VOLT_SHIFT)
80 #define PDO_PPS_APDO_MAX_VOLT(mv)	\
81 	((((mv) / 100) & PDO_PPS_APDO_VOLT_MASK) << PDO_PPS_APDO_MAX_VOLT_SHIFT)
82 #define PDO_PPS_APDO_MAX_CURR(ma)	\
83 	((((ma) / 50) & PDO_PPS_APDO_CURR_MASK) << PDO_PPS_APDO_MAX_CURR_SHIFT)
84 
85 #define PDO_PPS_APDO(min_mv, max_mv, max_ma)					\
86 	(PDO_TYPE(PDO_TYPE_APDO) | PDO_APDO_TYPE(APDO_TYPE_PPS) |		\
87 	 PDO_PPS_APDO_MIN_VOLT(min_mv) | PDO_PPS_APDO_MAX_VOLT(max_mv) |	\
88 	 PDO_PPS_APDO_MAX_CURR(max_ma))
89 
90  #endif /* __DT_POWER_DELIVERY_H */
91