1 What: /sys/class/ptp/ 1 What: /sys/class/ptp/
2 Date: September 2010 2 Date: September 2010
3 Contact: Richard Cochran <richardcochran 3 Contact: Richard Cochran <richardcochran@gmail.com>
4 Description: 4 Description:
5 This directory contains files 5 This directory contains files and directories
6 providing a standardized inter 6 providing a standardized interface to the ancillary
7 features of PTP hardware clock 7 features of PTP hardware clocks.
8 8
9 What: /sys/class/ptp/ptp<N>/ !! 9 What: /sys/class/ptp/ptpN/
10 Date: September 2010 10 Date: September 2010
11 Contact: Richard Cochran <richardcochran 11 Contact: Richard Cochran <richardcochran@gmail.com>
12 Description: 12 Description:
13 This directory contains the at 13 This directory contains the attributes of the Nth PTP
14 hardware clock registered into 14 hardware clock registered into the PTP class driver
15 subsystem. 15 subsystem.
16 16
17 What: /sys/class/ptp/ptp<N>/clock_na !! 17 What: /sys/class/ptp/ptpN/clock_name
18 Date: September 2010 18 Date: September 2010
19 Contact: Richard Cochran <richardcochran 19 Contact: Richard Cochran <richardcochran@gmail.com>
20 Description: 20 Description:
21 This file contains the name of 21 This file contains the name of the PTP hardware clock
22 as a human readable string. Th 22 as a human readable string. The purpose of this
23 attribute is to provide the us 23 attribute is to provide the user with a "friendly
24 name" and to help distinguish 24 name" and to help distinguish PHY based devices from
25 MAC based ones. The string doe 25 MAC based ones. The string does not necessarily have
26 to be any kind of unique id. 26 to be any kind of unique id.
27 27
28 What: /sys/class/ptp/ptp<N>/max_adju !! 28 What: /sys/class/ptp/ptpN/max_adjustment
29 Date: September 2010 29 Date: September 2010
30 Contact: Richard Cochran <richardcochran 30 Contact: Richard Cochran <richardcochran@gmail.com>
31 Description: 31 Description:
32 This file contains the PTP har 32 This file contains the PTP hardware clock's maximum
33 frequency adjustment value (a 33 frequency adjustment value (a positive integer) in
34 parts per billion. 34 parts per billion.
35 35
36 What: /sys/class/ptp/ptp<N>/max_vclo !! 36 What: /sys/class/ptp/ptpN/n_alarms
37 Date: May 2021 <<
38 Contact: Yangbo Lu <yangbo.lu@nxp.com> <<
39 Description: <<
40 This file contains the maximum <<
41 Write integer to re-configure <<
42 <<
43 What: /sys/class/ptp/ptp<N>/n_alarms <<
44 Date: September 2010 37 Date: September 2010
45 Contact: Richard Cochran <richardcochran 38 Contact: Richard Cochran <richardcochran@gmail.com>
46 Description: 39 Description:
47 This file contains the number 40 This file contains the number of periodic or one shot
48 alarms offer by the PTP hardwa 41 alarms offer by the PTP hardware clock.
49 42
50 What: /sys/class/ptp/ptp<N>/n_extern !! 43 What: /sys/class/ptp/ptpN/n_external_timestamps
51 Date: September 2010 44 Date: September 2010
52 Contact: Richard Cochran <richardcochran 45 Contact: Richard Cochran <richardcochran@gmail.com>
53 Description: 46 Description:
54 This file contains the number 47 This file contains the number of external timestamp
55 channels offered by the PTP ha 48 channels offered by the PTP hardware clock.
56 49
57 What: /sys/class/ptp/ptp<N>/n_period !! 50 What: /sys/class/ptp/ptpN/n_periodic_outputs
58 Date: September 2010 51 Date: September 2010
59 Contact: Richard Cochran <richardcochran 52 Contact: Richard Cochran <richardcochran@gmail.com>
60 Description: 53 Description:
61 This file contains the number 54 This file contains the number of programmable periodic
62 output channels offered by the 55 output channels offered by the PTP hardware clock.
63 56
64 What: /sys/class/ptp/ptp<N>/n_pins !! 57 What: /sys/class/ptp/ptpN/pps_avaiable
65 Date: March 2014 <<
66 Contact: Richard Cochran <richardcochran <<
67 Description: <<
68 This file contains the number <<
69 offered by the PTP hardware cl <<
70 <<
71 What: /sys/class/ptp/ptp<N>/n_vclock <<
72 Date: May 2021 <<
73 Contact: Yangbo Lu <yangbo.lu@nxp.com> <<
74 Description: <<
75 This file contains the number <<
76 use. By default, the value is <<
77 physical clock is in use. Set <<
78 the corresponding number of vi <<
79 the physical clock to become f <<
80 value back to 0 deletes the vi <<
81 switches the physical clock ba <<
82 operation. <<
83 <<
84 What: /sys/class/ptp/ptp<N>/pins <<
85 Date: March 2014 <<
86 Contact: Richard Cochran <richardcochran <<
87 Description: <<
88 This directory contains one fi <<
89 pin offered by the PTP hardwar <<
90 is the hardware dependent pin <<
91 file produces two numbers, the <<
92 the `PTP_PF_` enumeration valu <<
93 and the channel number. The fu <<
94 assignment may be changed by t <<
95 the file. <<
96 <<
97 What: /sys/class/ptp/ptp<N>/pps_avai <<
98 Date: September 2010 58 Date: September 2010
99 Contact: Richard Cochran <richardcochran 59 Contact: Richard Cochran <richardcochran@gmail.com>
100 Description: 60 Description:
101 This file indicates whether th 61 This file indicates whether the PTP hardware clock
102 supports a Pulse Per Second to 62 supports a Pulse Per Second to the host CPU. Reading
103 "1" means that the PPS is supp 63 "1" means that the PPS is supported, while "0" means
104 not supported. 64 not supported.
105 65
106 What: /sys/class/ptp/ptp<N>/extts_en !! 66 What: /sys/class/ptp/ptpN/extts_enable
107 Date: September 2010 67 Date: September 2010
108 Contact: Richard Cochran <richardcochran 68 Contact: Richard Cochran <richardcochran@gmail.com>
109 Description: 69 Description:
110 This write-only file enables o 70 This write-only file enables or disables external
111 timestamps. To enable external 71 timestamps. To enable external timestamps, write the
112 channel index followed by a "1 72 channel index followed by a "1" into the file.
113 To disable external timestamps 73 To disable external timestamps, write the channel
114 index followed by a "0" into t 74 index followed by a "0" into the file.
115 75
116 What: /sys/class/ptp/ptp<N>/fifo !! 76 What: /sys/class/ptp/ptpN/fifo
117 Date: September 2010 77 Date: September 2010
118 Contact: Richard Cochran <richardcochran 78 Contact: Richard Cochran <richardcochran@gmail.com>
119 Description: 79 Description:
120 This file provides timestamps 80 This file provides timestamps on external events, in
121 the form of three integers: ch 81 the form of three integers: channel index, seconds,
122 and nanoseconds. 82 and nanoseconds.
123 83
124 What: /sys/class/ptp/ptp<N>/period !! 84 What: /sys/class/ptp/ptpN/period
125 Date: September 2010 85 Date: September 2010
126 Contact: Richard Cochran <richardcochran 86 Contact: Richard Cochran <richardcochran@gmail.com>
127 Description: 87 Description:
128 This write-only file enables o 88 This write-only file enables or disables periodic
129 outputs. To enable a periodic 89 outputs. To enable a periodic output, write five
130 integers into the file: channe 90 integers into the file: channel index, start time
131 seconds, start time nanosecond 91 seconds, start time nanoseconds, period seconds, and
132 period nanoseconds. To disable 92 period nanoseconds. To disable a periodic output, set
133 all the seconds and nanosecond 93 all the seconds and nanoseconds values to zero.
134 94
135 What: /sys/class/ptp/ptp<N>/pps_enab !! 95 What: /sys/class/ptp/ptpN/pps_enable
136 Date: September 2010 96 Date: September 2010
137 Contact: Richard Cochran <richardcochran 97 Contact: Richard Cochran <richardcochran@gmail.com>
138 Description: 98 Description:
139 This write-only file enables o 99 This write-only file enables or disables delivery of
140 PPS events to the Linux PPS su 100 PPS events to the Linux PPS subsystem. To enable PPS
141 events, write a "1" into the f 101 events, write a "1" into the file. To disable events,
142 write a "0" into the file. 102 write a "0" into the file.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.