1 /* SPDX-License-Identifier: ((GPL-2.0 WITH Lin 1 /* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) */
2 /* Do not edit directly, auto-generated from: 2 /* Do not edit directly, auto-generated from: */
3 /* Documentation/netlink/specs/dpll.yaml 3 /* Documentation/netlink/specs/dpll.yaml */
4 /* YNL-GEN uapi header */ 4 /* YNL-GEN uapi header */
5 5
6 #ifndef _UAPI_LINUX_DPLL_H 6 #ifndef _UAPI_LINUX_DPLL_H
7 #define _UAPI_LINUX_DPLL_H 7 #define _UAPI_LINUX_DPLL_H
8 8
9 #define DPLL_FAMILY_NAME "dpll" 9 #define DPLL_FAMILY_NAME "dpll"
10 #define DPLL_FAMILY_VERSION 1 10 #define DPLL_FAMILY_VERSION 1
11 11
12 /** 12 /**
13 * enum dpll_mode - working modes a dpll can s 13 * enum dpll_mode - working modes a dpll can support, differentiates if and how
14 * dpll selects one of its inputs to syntoni 14 * dpll selects one of its inputs to syntonize with it, valid values for
15 * DPLL_A_MODE attribute 15 * DPLL_A_MODE attribute
16 * @DPLL_MODE_MANUAL: input can be only select 16 * @DPLL_MODE_MANUAL: input can be only selected by sending a request to dpll
17 * @DPLL_MODE_AUTOMATIC: highest prio input pi 17 * @DPLL_MODE_AUTOMATIC: highest prio input pin auto selected by dpll
18 */ 18 */
19 enum dpll_mode { 19 enum dpll_mode {
20 DPLL_MODE_MANUAL = 1, 20 DPLL_MODE_MANUAL = 1,
21 DPLL_MODE_AUTOMATIC, 21 DPLL_MODE_AUTOMATIC,
22 22
23 /* private: */ 23 /* private: */
24 __DPLL_MODE_MAX, 24 __DPLL_MODE_MAX,
25 DPLL_MODE_MAX = (__DPLL_MODE_MAX - 1) 25 DPLL_MODE_MAX = (__DPLL_MODE_MAX - 1)
26 }; 26 };
27 27
28 /** 28 /**
29 * enum dpll_lock_status - provides informatio 29 * enum dpll_lock_status - provides information of dpll device lock status,
30 * valid values for DPLL_A_LOCK_STATUS attri 30 * valid values for DPLL_A_LOCK_STATUS attribute
31 * @DPLL_LOCK_STATUS_UNLOCKED: dpll was not ye 31 * @DPLL_LOCK_STATUS_UNLOCKED: dpll was not yet locked to any valid input (or
32 * forced by setting DPLL_A_MODE to DPLL_MOD 32 * forced by setting DPLL_A_MODE to DPLL_MODE_DETACHED)
33 * @DPLL_LOCK_STATUS_LOCKED: dpll is locked to 33 * @DPLL_LOCK_STATUS_LOCKED: dpll is locked to a valid signal, but no holdover
34 * available 34 * available
35 * @DPLL_LOCK_STATUS_LOCKED_HO_ACQ: dpll is lo 35 * @DPLL_LOCK_STATUS_LOCKED_HO_ACQ: dpll is locked and holdover acquired
36 * @DPLL_LOCK_STATUS_HOLDOVER: dpll is in hold 36 * @DPLL_LOCK_STATUS_HOLDOVER: dpll is in holdover state - lost a valid lock or
37 * was forced by disconnecting all the pins 37 * was forced by disconnecting all the pins (latter possible only when dpll
38 * lock-state was already DPLL_LOCK_STATUS_L 38 * lock-state was already DPLL_LOCK_STATUS_LOCKED_HO_ACQ, if dpll lock-state
39 * was not DPLL_LOCK_STATUS_LOCKED_HO_ACQ, t 39 * was not DPLL_LOCK_STATUS_LOCKED_HO_ACQ, the dpll's lock-state shall remain
40 * DPLL_LOCK_STATUS_UNLOCKED) 40 * DPLL_LOCK_STATUS_UNLOCKED)
41 */ 41 */
42 enum dpll_lock_status { 42 enum dpll_lock_status {
43 DPLL_LOCK_STATUS_UNLOCKED = 1, 43 DPLL_LOCK_STATUS_UNLOCKED = 1,
44 DPLL_LOCK_STATUS_LOCKED, 44 DPLL_LOCK_STATUS_LOCKED,
45 DPLL_LOCK_STATUS_LOCKED_HO_ACQ, 45 DPLL_LOCK_STATUS_LOCKED_HO_ACQ,
46 DPLL_LOCK_STATUS_HOLDOVER, 46 DPLL_LOCK_STATUS_HOLDOVER,
47 47
48 /* private: */ 48 /* private: */
49 __DPLL_LOCK_STATUS_MAX, 49 __DPLL_LOCK_STATUS_MAX,
50 DPLL_LOCK_STATUS_MAX = (__DPLL_LOCK_ST 50 DPLL_LOCK_STATUS_MAX = (__DPLL_LOCK_STATUS_MAX - 1)
51 }; 51 };
52 52
53 /** 53 /**
54 * enum dpll_lock_status_error - if previous s 54 * enum dpll_lock_status_error - if previous status change was done due to a
55 * failure, this provides information of dpl 55 * failure, this provides information of dpll device lock status error. Valid
56 * values for DPLL_A_LOCK_STATUS_ERROR attri 56 * values for DPLL_A_LOCK_STATUS_ERROR attribute
57 * @DPLL_LOCK_STATUS_ERROR_NONE: dpll device l 57 * @DPLL_LOCK_STATUS_ERROR_NONE: dpll device lock status was changed without
58 * any error 58 * any error
59 * @DPLL_LOCK_STATUS_ERROR_UNDEFINED: dpll dev 59 * @DPLL_LOCK_STATUS_ERROR_UNDEFINED: dpll device lock status was changed due
60 * to undefined error. Driver fills this val 60 * to undefined error. Driver fills this value up in case it is not able to
61 * obtain suitable exact error type. 61 * obtain suitable exact error type.
62 * @DPLL_LOCK_STATUS_ERROR_MEDIA_DOWN: dpll de 62 * @DPLL_LOCK_STATUS_ERROR_MEDIA_DOWN: dpll device lock status was changed
63 * because of associated media got down. Thi 63 * because of associated media got down. This may happen for example if dpll
64 * device was previously locked on an input 64 * device was previously locked on an input pin of type
65 * PIN_TYPE_SYNCE_ETH_PORT. 65 * PIN_TYPE_SYNCE_ETH_PORT.
66 * @DPLL_LOCK_STATUS_ERROR_FRACTIONAL_FREQUENC 66 * @DPLL_LOCK_STATUS_ERROR_FRACTIONAL_FREQUENCY_OFFSET_TOO_HIGH: the FFO
67 * (Fractional Frequency Offset) between the 67 * (Fractional Frequency Offset) between the RX and TX symbol rate on the
68 * media got too high. This may happen for e 68 * media got too high. This may happen for example if dpll device was
69 * previously locked on an input pin of type 69 * previously locked on an input pin of type PIN_TYPE_SYNCE_ETH_PORT.
70 */ 70 */
71 enum dpll_lock_status_error { 71 enum dpll_lock_status_error {
72 DPLL_LOCK_STATUS_ERROR_NONE = 1, 72 DPLL_LOCK_STATUS_ERROR_NONE = 1,
73 DPLL_LOCK_STATUS_ERROR_UNDEFINED, 73 DPLL_LOCK_STATUS_ERROR_UNDEFINED,
74 DPLL_LOCK_STATUS_ERROR_MEDIA_DOWN, 74 DPLL_LOCK_STATUS_ERROR_MEDIA_DOWN,
75 DPLL_LOCK_STATUS_ERROR_FRACTIONAL_FREQ 75 DPLL_LOCK_STATUS_ERROR_FRACTIONAL_FREQUENCY_OFFSET_TOO_HIGH,
76 76
77 /* private: */ 77 /* private: */
78 __DPLL_LOCK_STATUS_ERROR_MAX, 78 __DPLL_LOCK_STATUS_ERROR_MAX,
79 DPLL_LOCK_STATUS_ERROR_MAX = (__DPLL_L 79 DPLL_LOCK_STATUS_ERROR_MAX = (__DPLL_LOCK_STATUS_ERROR_MAX - 1)
80 }; 80 };
81 81
82 #define DPLL_TEMP_DIVIDER 1000 82 #define DPLL_TEMP_DIVIDER 1000
83 83
84 /** 84 /**
85 * enum dpll_type - type of dpll, valid values 85 * enum dpll_type - type of dpll, valid values for DPLL_A_TYPE attribute
86 * @DPLL_TYPE_PPS: dpll produces Pulse-Per-Sec 86 * @DPLL_TYPE_PPS: dpll produces Pulse-Per-Second signal
87 * @DPLL_TYPE_EEC: dpll drives the Ethernet Eq 87 * @DPLL_TYPE_EEC: dpll drives the Ethernet Equipment Clock
88 */ 88 */
89 enum dpll_type { 89 enum dpll_type {
90 DPLL_TYPE_PPS = 1, 90 DPLL_TYPE_PPS = 1,
91 DPLL_TYPE_EEC, 91 DPLL_TYPE_EEC,
92 92
93 /* private: */ 93 /* private: */
94 __DPLL_TYPE_MAX, 94 __DPLL_TYPE_MAX,
95 DPLL_TYPE_MAX = (__DPLL_TYPE_MAX - 1) 95 DPLL_TYPE_MAX = (__DPLL_TYPE_MAX - 1)
96 }; 96 };
97 97
98 /** 98 /**
99 * enum dpll_pin_type - defines possible types 99 * enum dpll_pin_type - defines possible types of a pin, valid values for
100 * DPLL_A_PIN_TYPE attribute 100 * DPLL_A_PIN_TYPE attribute
101 * @DPLL_PIN_TYPE_MUX: aggregates another laye 101 * @DPLL_PIN_TYPE_MUX: aggregates another layer of selectable pins
102 * @DPLL_PIN_TYPE_EXT: external input 102 * @DPLL_PIN_TYPE_EXT: external input
103 * @DPLL_PIN_TYPE_SYNCE_ETH_PORT: ethernet por 103 * @DPLL_PIN_TYPE_SYNCE_ETH_PORT: ethernet port PHY's recovered clock
104 * @DPLL_PIN_TYPE_INT_OSCILLATOR: device inter 104 * @DPLL_PIN_TYPE_INT_OSCILLATOR: device internal oscillator
105 * @DPLL_PIN_TYPE_GNSS: GNSS recovered clock 105 * @DPLL_PIN_TYPE_GNSS: GNSS recovered clock
106 */ 106 */
107 enum dpll_pin_type { 107 enum dpll_pin_type {
108 DPLL_PIN_TYPE_MUX = 1, 108 DPLL_PIN_TYPE_MUX = 1,
109 DPLL_PIN_TYPE_EXT, 109 DPLL_PIN_TYPE_EXT,
110 DPLL_PIN_TYPE_SYNCE_ETH_PORT, 110 DPLL_PIN_TYPE_SYNCE_ETH_PORT,
111 DPLL_PIN_TYPE_INT_OSCILLATOR, 111 DPLL_PIN_TYPE_INT_OSCILLATOR,
112 DPLL_PIN_TYPE_GNSS, 112 DPLL_PIN_TYPE_GNSS,
113 113
114 /* private: */ 114 /* private: */
115 __DPLL_PIN_TYPE_MAX, 115 __DPLL_PIN_TYPE_MAX,
116 DPLL_PIN_TYPE_MAX = (__DPLL_PIN_TYPE_M 116 DPLL_PIN_TYPE_MAX = (__DPLL_PIN_TYPE_MAX - 1)
117 }; 117 };
118 118
119 /** 119 /**
120 * enum dpll_pin_direction - defines possible 120 * enum dpll_pin_direction - defines possible direction of a pin, valid values
121 * for DPLL_A_PIN_DIRECTION attribute 121 * for DPLL_A_PIN_DIRECTION attribute
122 * @DPLL_PIN_DIRECTION_INPUT: pin used as a in 122 * @DPLL_PIN_DIRECTION_INPUT: pin used as a input of a signal
123 * @DPLL_PIN_DIRECTION_OUTPUT: pin used to out 123 * @DPLL_PIN_DIRECTION_OUTPUT: pin used to output the signal
124 */ 124 */
125 enum dpll_pin_direction { 125 enum dpll_pin_direction {
126 DPLL_PIN_DIRECTION_INPUT = 1, 126 DPLL_PIN_DIRECTION_INPUT = 1,
127 DPLL_PIN_DIRECTION_OUTPUT, 127 DPLL_PIN_DIRECTION_OUTPUT,
128 128
129 /* private: */ 129 /* private: */
130 __DPLL_PIN_DIRECTION_MAX, 130 __DPLL_PIN_DIRECTION_MAX,
131 DPLL_PIN_DIRECTION_MAX = (__DPLL_PIN_D 131 DPLL_PIN_DIRECTION_MAX = (__DPLL_PIN_DIRECTION_MAX - 1)
132 }; 132 };
133 133
134 #define DPLL_PIN_FREQUENCY_1_HZ 1 134 #define DPLL_PIN_FREQUENCY_1_HZ 1
135 #define DPLL_PIN_FREQUENCY_10_KHZ 10000 135 #define DPLL_PIN_FREQUENCY_10_KHZ 10000
136 #define DPLL_PIN_FREQUENCY_77_5_KHZ 77500 136 #define DPLL_PIN_FREQUENCY_77_5_KHZ 77500
137 #define DPLL_PIN_FREQUENCY_10_MHZ 100000 137 #define DPLL_PIN_FREQUENCY_10_MHZ 10000000
138 138
139 /** 139 /**
140 * enum dpll_pin_state - defines possible stat 140 * enum dpll_pin_state - defines possible states of a pin, valid values for
141 * DPLL_A_PIN_STATE attribute 141 * DPLL_A_PIN_STATE attribute
142 * @DPLL_PIN_STATE_CONNECTED: pin connected, a 142 * @DPLL_PIN_STATE_CONNECTED: pin connected, active input of phase locked loop
143 * @DPLL_PIN_STATE_DISCONNECTED: pin disconnec 143 * @DPLL_PIN_STATE_DISCONNECTED: pin disconnected, not considered as a valid
144 * input 144 * input
145 * @DPLL_PIN_STATE_SELECTABLE: pin enabled for 145 * @DPLL_PIN_STATE_SELECTABLE: pin enabled for automatic input selection
146 */ 146 */
147 enum dpll_pin_state { 147 enum dpll_pin_state {
148 DPLL_PIN_STATE_CONNECTED = 1, 148 DPLL_PIN_STATE_CONNECTED = 1,
149 DPLL_PIN_STATE_DISCONNECTED, 149 DPLL_PIN_STATE_DISCONNECTED,
150 DPLL_PIN_STATE_SELECTABLE, 150 DPLL_PIN_STATE_SELECTABLE,
151 151
152 /* private: */ 152 /* private: */
153 __DPLL_PIN_STATE_MAX, 153 __DPLL_PIN_STATE_MAX,
154 DPLL_PIN_STATE_MAX = (__DPLL_PIN_STATE 154 DPLL_PIN_STATE_MAX = (__DPLL_PIN_STATE_MAX - 1)
155 }; 155 };
156 156
157 /** 157 /**
158 * enum dpll_pin_capabilities - defines possib 158 * enum dpll_pin_capabilities - defines possible capabilities of a pin, valid
159 * flags on DPLL_A_PIN_CAPABILITIES attribut 159 * flags on DPLL_A_PIN_CAPABILITIES attribute
160 * @DPLL_PIN_CAPABILITIES_DIRECTION_CAN_CHANGE 160 * @DPLL_PIN_CAPABILITIES_DIRECTION_CAN_CHANGE: pin direction can be changed
161 * @DPLL_PIN_CAPABILITIES_PRIORITY_CAN_CHANGE: 161 * @DPLL_PIN_CAPABILITIES_PRIORITY_CAN_CHANGE: pin priority can be changed
162 * @DPLL_PIN_CAPABILITIES_STATE_CAN_CHANGE: pi 162 * @DPLL_PIN_CAPABILITIES_STATE_CAN_CHANGE: pin state can be changed
163 */ 163 */
164 enum dpll_pin_capabilities { 164 enum dpll_pin_capabilities {
165 DPLL_PIN_CAPABILITIES_DIRECTION_CAN_CH 165 DPLL_PIN_CAPABILITIES_DIRECTION_CAN_CHANGE = 1,
166 DPLL_PIN_CAPABILITIES_PRIORITY_CAN_CHA 166 DPLL_PIN_CAPABILITIES_PRIORITY_CAN_CHANGE = 2,
167 DPLL_PIN_CAPABILITIES_STATE_CAN_CHANGE 167 DPLL_PIN_CAPABILITIES_STATE_CAN_CHANGE = 4,
168 }; 168 };
169 169
170 #define DPLL_PHASE_OFFSET_DIVIDER 1000 170 #define DPLL_PHASE_OFFSET_DIVIDER 1000
171 171
172 enum dpll_a { 172 enum dpll_a {
173 DPLL_A_ID = 1, 173 DPLL_A_ID = 1,
174 DPLL_A_MODULE_NAME, 174 DPLL_A_MODULE_NAME,
175 DPLL_A_PAD, 175 DPLL_A_PAD,
176 DPLL_A_CLOCK_ID, 176 DPLL_A_CLOCK_ID,
177 DPLL_A_MODE, 177 DPLL_A_MODE,
178 DPLL_A_MODE_SUPPORTED, 178 DPLL_A_MODE_SUPPORTED,
179 DPLL_A_LOCK_STATUS, 179 DPLL_A_LOCK_STATUS,
180 DPLL_A_TEMP, 180 DPLL_A_TEMP,
181 DPLL_A_TYPE, 181 DPLL_A_TYPE,
182 DPLL_A_LOCK_STATUS_ERROR, 182 DPLL_A_LOCK_STATUS_ERROR,
183 183
184 __DPLL_A_MAX, 184 __DPLL_A_MAX,
185 DPLL_A_MAX = (__DPLL_A_MAX - 1) 185 DPLL_A_MAX = (__DPLL_A_MAX - 1)
186 }; 186 };
187 187
188 enum dpll_a_pin { 188 enum dpll_a_pin {
189 DPLL_A_PIN_ID = 1, 189 DPLL_A_PIN_ID = 1,
190 DPLL_A_PIN_PARENT_ID, 190 DPLL_A_PIN_PARENT_ID,
191 DPLL_A_PIN_MODULE_NAME, 191 DPLL_A_PIN_MODULE_NAME,
192 DPLL_A_PIN_PAD, 192 DPLL_A_PIN_PAD,
193 DPLL_A_PIN_CLOCK_ID, 193 DPLL_A_PIN_CLOCK_ID,
194 DPLL_A_PIN_BOARD_LABEL, 194 DPLL_A_PIN_BOARD_LABEL,
195 DPLL_A_PIN_PANEL_LABEL, 195 DPLL_A_PIN_PANEL_LABEL,
196 DPLL_A_PIN_PACKAGE_LABEL, 196 DPLL_A_PIN_PACKAGE_LABEL,
197 DPLL_A_PIN_TYPE, 197 DPLL_A_PIN_TYPE,
198 DPLL_A_PIN_DIRECTION, 198 DPLL_A_PIN_DIRECTION,
199 DPLL_A_PIN_FREQUENCY, 199 DPLL_A_PIN_FREQUENCY,
200 DPLL_A_PIN_FREQUENCY_SUPPORTED, 200 DPLL_A_PIN_FREQUENCY_SUPPORTED,
201 DPLL_A_PIN_FREQUENCY_MIN, 201 DPLL_A_PIN_FREQUENCY_MIN,
202 DPLL_A_PIN_FREQUENCY_MAX, 202 DPLL_A_PIN_FREQUENCY_MAX,
203 DPLL_A_PIN_PRIO, 203 DPLL_A_PIN_PRIO,
204 DPLL_A_PIN_STATE, 204 DPLL_A_PIN_STATE,
205 DPLL_A_PIN_CAPABILITIES, 205 DPLL_A_PIN_CAPABILITIES,
206 DPLL_A_PIN_PARENT_DEVICE, 206 DPLL_A_PIN_PARENT_DEVICE,
207 DPLL_A_PIN_PARENT_PIN, 207 DPLL_A_PIN_PARENT_PIN,
208 DPLL_A_PIN_PHASE_ADJUST_MIN, 208 DPLL_A_PIN_PHASE_ADJUST_MIN,
209 DPLL_A_PIN_PHASE_ADJUST_MAX, 209 DPLL_A_PIN_PHASE_ADJUST_MAX,
210 DPLL_A_PIN_PHASE_ADJUST, 210 DPLL_A_PIN_PHASE_ADJUST,
211 DPLL_A_PIN_PHASE_OFFSET, 211 DPLL_A_PIN_PHASE_OFFSET,
212 DPLL_A_PIN_FRACTIONAL_FREQUENCY_OFFSET 212 DPLL_A_PIN_FRACTIONAL_FREQUENCY_OFFSET,
213 DPLL_A_PIN_ESYNC_FREQUENCY, <<
214 DPLL_A_PIN_ESYNC_FREQUENCY_SUPPORTED, <<
215 DPLL_A_PIN_ESYNC_PULSE, <<
216 213
217 __DPLL_A_PIN_MAX, 214 __DPLL_A_PIN_MAX,
218 DPLL_A_PIN_MAX = (__DPLL_A_PIN_MAX - 1 215 DPLL_A_PIN_MAX = (__DPLL_A_PIN_MAX - 1)
219 }; 216 };
220 217
221 enum dpll_cmd { 218 enum dpll_cmd {
222 DPLL_CMD_DEVICE_ID_GET = 1, 219 DPLL_CMD_DEVICE_ID_GET = 1,
223 DPLL_CMD_DEVICE_GET, 220 DPLL_CMD_DEVICE_GET,
224 DPLL_CMD_DEVICE_SET, 221 DPLL_CMD_DEVICE_SET,
225 DPLL_CMD_DEVICE_CREATE_NTF, 222 DPLL_CMD_DEVICE_CREATE_NTF,
226 DPLL_CMD_DEVICE_DELETE_NTF, 223 DPLL_CMD_DEVICE_DELETE_NTF,
227 DPLL_CMD_DEVICE_CHANGE_NTF, 224 DPLL_CMD_DEVICE_CHANGE_NTF,
228 DPLL_CMD_PIN_ID_GET, 225 DPLL_CMD_PIN_ID_GET,
229 DPLL_CMD_PIN_GET, 226 DPLL_CMD_PIN_GET,
230 DPLL_CMD_PIN_SET, 227 DPLL_CMD_PIN_SET,
231 DPLL_CMD_PIN_CREATE_NTF, 228 DPLL_CMD_PIN_CREATE_NTF,
232 DPLL_CMD_PIN_DELETE_NTF, 229 DPLL_CMD_PIN_DELETE_NTF,
233 DPLL_CMD_PIN_CHANGE_NTF, 230 DPLL_CMD_PIN_CHANGE_NTF,
234 231
235 __DPLL_CMD_MAX, 232 __DPLL_CMD_MAX,
236 DPLL_CMD_MAX = (__DPLL_CMD_MAX - 1) 233 DPLL_CMD_MAX = (__DPLL_CMD_MAX - 1)
237 }; 234 };
238 235
239 #define DPLL_MCGRP_MONITOR "monitor" 236 #define DPLL_MCGRP_MONITOR "monitor"
240 237
241 #endif /* _UAPI_LINUX_DPLL_H */ 238 #endif /* _UAPI_LINUX_DPLL_H */
242 239
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.