1 # SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
12 working modes a dpll can support, differentiates if and how dpll selects
13 one of its inputs to syntonize with it, valid values for DPLL_A_MODE
18 doc: input can be only selected by sending a request to dpll
22 doc: highest prio input pin auto selected by dpll
28 provides information of dpll device lock status, valid values for
29 DPLL_A_LOCK_STATUS attribute
34 dpll was not yet locked to any valid input (or forced by setting
35 DPLL_A_MODE to DPLL_MODE_DETACHED)
40 dpll is locked to a valid signal, but no holdover available
44 dpll is locked and holdover acquired
48 dpll is in holdover state - lost a valid lock or was forced
49 by disconnecting all the pins (latter possible only
50 when dpll lock-state was already DPLL_LOCK_STATUS_LOCKED_HO_ACQ,
51 if dpll lock-state was not DPLL_LOCK_STATUS_LOCKED_HO_ACQ, the
52 dpll's lock-state shall remain DPLL_LOCK_STATUS_UNLOCKED)
59 temperature divider allowing userspace to calculate the
60 temperature as float with three digit decimal precision.
61 Value of (DPLL_A_TEMP / DPLL_TEMP_DIVIDER) is integer part of
63 Value of (DPLL_A_TEMP % DPLL_TEMP_DIVIDER) is fractional part of
68 doc: type of dpll, valid values for DPLL_A_TYPE attribute
72 doc: dpll produces Pulse-Per-Second signal
76 doc: dpll drives the Ethernet Equipment Clock
82 defines possible types of a pin, valid values for DPLL_A_PIN_TYPE
87 doc: aggregates another layer of selectable pins
94 doc: ethernet port PHY's recovered clock
97 doc: device internal oscillator
100 doc: GNSS recovered clock
106 defines possible direction of a pin, valid values for
107 DPLL_A_PIN_DIRECTION attribute
111 doc: pin used as a input of a signal
115 doc: pin used to output the signal
119 name: pin-frequency-1-hz
123 name: pin-frequency-10-khz
127 name: pin-frequency-77_5-khz
131 name: pin-frequency-10-mhz
137 defines possible states of a pin, valid values for
138 DPLL_A_PIN_STATE attribute
142 doc: pin connected, active input of phase locked loop
146 doc: pin disconnected, not considered as a valid input
149 doc: pin enabled for automatic input selection
153 name: pin-capabilities
155 defines possible capabilities of a pin, valid flags on
156 DPLL_A_PIN_CAPABILITIES attribute
159 name: direction-can-change
160 doc: pin direction can be changed
162 name: priority-can-change
163 doc: pin priority can be changed
165 name: state-can-change
166 doc: pin state can be changed
169 name: phase-offset-divider
172 phase offset divider allows userspace to calculate a value of
173 measured signal phase difference between a pin and dpll device
174 as a fractional value with three digit decimal precision.
175 Value of (DPLL_A_PHASE_OFFSET / DPLL_PHASE_OFFSET_DIVIDER) is an
176 integer part of a measured phase offset value.
177 Value of (DPLL_A_PHASE_OFFSET % DPLL_PHASE_OFFSET_DIVIDER) is a
178 fractional part of a measured phase offset value.
219 enum-name: dpll_a_pin
257 name: frequency-supported
260 nested-attributes: frequency-range
281 nested-attributes: pin-parent-device
286 nested-attributes: pin-parent-pin
288 name: phase-adjust-min
291 name: phase-adjust-max
300 name: pin-parent-device
322 name: frequency-range
336 Get id of dpll device that matches given attributes
338 flags: [ admin-perm ]
342 post: dpll-unlock-doit
355 Get list of DPLL devices (dump) or attributes of a single dpll device
357 flags: [ admin-perm ]
377 pre: dpll-lock-dumpit
378 post: dpll-unlock-dumpit
383 doc: Set attributes for a DPLL device
385 flags: [ admin-perm ]
394 name: device-create-ntf
395 doc: Notification about device appearing
399 name: device-delete-ntf
400 doc: Notification about device disappearing
404 name: device-change-ntf
405 doc: Notification about device configuration being changed
411 Get id of a pin that matches given attributes
413 flags: [ admin-perm ]
417 post: dpll-unlock-doit
433 Get list of pins and its attributes.
434 - dump request without any attributes given - list all the pins in the
436 - dump request with target dpll - list all the pins registered with
438 - do request with target dpll and target pin - single pin attributes
440 flags: [ admin-perm ]
443 pre: dpll-pin-pre-doit
444 post: dpll-pin-post-doit
456 - frequency-supported
465 pre: dpll-lock-dumpit
466 post: dpll-unlock-dumpit
474 doc: Set attributes of a target pin
476 flags: [ admin-perm ]
479 pre: dpll-pin-pre-doit
480 post: dpll-pin-post-doit
493 doc: Notification about pin appearing
498 doc: Notification about pin disappearing
503 doc: Notification about pin configuration being changed