1 // SPDX-License-Identifier: GPL-2.0
2 /* Copyright(c) 1999 - 2018 Intel Corporation. */
4 /* PTP 1588 Hardware Clock (PHC)
5 * Derived from PTP Hardware Clock driver for Intel 82576 and 82580 (igb)
6 * Copyright (C) 2011 Richard Cochran <richardcochran@gmail.com>
11 #ifdef CONFIG_E1000E_HWTS
12 #include <linux/clocksource.h>
13 #include <linux/ktime.h>
18 * e1000e_phc_adjfreq - adjust the frequency of the hardware clock
19 * @ptp: ptp clock structure
20 * @delta: Desired frequency change in parts per billion
22 * Adjust the frequency of the PHC cycle counter by the indicated delta from
25 static int e1000e_phc_adjfreq(struct ptp_clock_info *ptp, s32 delta)
27 struct e1000_adapter *adapter = container_of(ptp, struct e1000_adapter,
29 struct e1000_hw *hw = &adapter->hw;
33 u32 timinca, incvalue;
36 if ((delta > ptp->max_adj) || (delta <= -1000000000))
44 /* Get the System Time Register SYSTIM base frequency */
45 ret_val = e1000e_get_base_timinca(adapter, &timinca);
49 spin_lock_irqsave(&adapter->systim_lock, flags);
51 incvalue = timinca & E1000_TIMINCA_INCVALUE_MASK;
53 adjustment = incvalue;
55 adjustment = div_u64(adjustment, 1000000000);
57 incvalue = neg_adj ? (incvalue - adjustment) : (incvalue + adjustment);
59 timinca &= ~E1000_TIMINCA_INCVALUE_MASK;
62 ew32(TIMINCA, timinca);
64 adapter->ptp_delta = delta;
66 spin_unlock_irqrestore(&adapter->systim_lock, flags);
72 * e1000e_phc_adjtime - Shift the time of the hardware clock
73 * @ptp: ptp clock structure
74 * @delta: Desired change in nanoseconds
76 * Adjust the timer by resetting the timecounter structure.
78 static int e1000e_phc_adjtime(struct ptp_clock_info *ptp, s64 delta)
80 struct e1000_adapter *adapter = container_of(ptp, struct e1000_adapter,
84 spin_lock_irqsave(&adapter->systim_lock, flags);
85 timecounter_adjtime(&adapter->tc, delta);
86 spin_unlock_irqrestore(&adapter->systim_lock, flags);
91 #ifdef CONFIG_E1000E_HWTS
92 #define MAX_HW_WAIT_COUNT (3)
95 * e1000e_phc_get_syncdevicetime - Callback given to timekeeping code reads system/device registers
96 * @device: current device time
97 * @system: system counter value read synchronously with device time
98 * @ctx: context provided by timekeeping code
100 * Read device and system (ART) clock simultaneously and return the corrected
101 * clock values in ns.
103 static int e1000e_phc_get_syncdevicetime(ktime_t *device,
104 struct system_counterval_t *system,
107 struct e1000_adapter *adapter = (struct e1000_adapter *)ctx;
108 struct e1000_hw *hw = &adapter->hw;
115 tsync_ctrl = er32(TSYNCTXCTL);
116 tsync_ctrl |= E1000_TSYNCTXCTL_START_SYNC |
117 E1000_TSYNCTXCTL_MAX_ALLOWED_DLY_MASK;
118 ew32(TSYNCTXCTL, tsync_ctrl);
119 for (i = 0; i < MAX_HW_WAIT_COUNT; ++i) {
121 tsync_ctrl = er32(TSYNCTXCTL);
122 if (tsync_ctrl & E1000_TSYNCTXCTL_SYNC_COMP)
126 if (i == MAX_HW_WAIT_COUNT)
129 dev_cycles = er32(SYSSTMPH);
131 dev_cycles |= er32(SYSSTMPL);
132 spin_lock_irqsave(&adapter->systim_lock, flags);
133 *device = ns_to_ktime(timecounter_cyc2time(&adapter->tc, dev_cycles));
134 spin_unlock_irqrestore(&adapter->systim_lock, flags);
136 sys_cycles = er32(PLTSTMPH);
138 sys_cycles |= er32(PLTSTMPL);
139 *system = convert_art_to_tsc(sys_cycles);
145 * e1000e_phc_getsynctime - Reads the current system/device cross timestamp
146 * @ptp: ptp clock structure
147 * @cts: structure containing timestamp
149 * Read device and system (ART) clock simultaneously and return the scaled
150 * clock values in ns.
152 static int e1000e_phc_getcrosststamp(struct ptp_clock_info *ptp,
153 struct system_device_crosststamp *xtstamp)
155 struct e1000_adapter *adapter = container_of(ptp, struct e1000_adapter,
158 return get_device_system_crosststamp(e1000e_phc_get_syncdevicetime,
159 adapter, NULL, xtstamp);
161 #endif/*CONFIG_E1000E_HWTS*/
164 * e1000e_phc_gettime - Reads the current time from the hardware clock
165 * @ptp: ptp clock structure
166 * @ts: timespec structure to hold the current time value
168 * Read the timecounter and return the correct value in ns after converting
169 * it into a struct timespec.
171 static int e1000e_phc_gettime(struct ptp_clock_info *ptp, struct timespec64 *ts)
173 struct e1000_adapter *adapter = container_of(ptp, struct e1000_adapter,
178 spin_lock_irqsave(&adapter->systim_lock, flags);
180 /* Use timecounter_cyc2time() to allow non-monotonic SYSTIM readings */
181 cycles = adapter->cc.read(&adapter->cc);
182 ns = timecounter_cyc2time(&adapter->tc, cycles);
184 spin_unlock_irqrestore(&adapter->systim_lock, flags);
186 *ts = ns_to_timespec64(ns);
192 * e1000e_phc_settime - Set the current time on the hardware clock
193 * @ptp: ptp clock structure
194 * @ts: timespec containing the new time for the cycle counter
196 * Reset the timecounter to use a new base value instead of the kernel
199 static int e1000e_phc_settime(struct ptp_clock_info *ptp,
200 const struct timespec64 *ts)
202 struct e1000_adapter *adapter = container_of(ptp, struct e1000_adapter,
207 ns = timespec64_to_ns(ts);
209 /* reset the timecounter */
210 spin_lock_irqsave(&adapter->systim_lock, flags);
211 timecounter_init(&adapter->tc, &adapter->cc, ns);
212 spin_unlock_irqrestore(&adapter->systim_lock, flags);
218 * e1000e_phc_enable - enable or disable an ancillary feature
219 * @ptp: ptp clock structure
220 * @request: Desired resource to enable or disable
221 * @on: Caller passes one to enable or zero to disable
223 * Enable (or disable) ancillary features of the PHC subsystem.
224 * Currently, no ancillary features are supported.
226 static int e1000e_phc_enable(struct ptp_clock_info __always_unused *ptp,
227 struct ptp_clock_request __always_unused *request,
228 int __always_unused on)
233 static void e1000e_systim_overflow_work(struct work_struct *work)
235 struct e1000_adapter *adapter = container_of(work, struct e1000_adapter,
236 systim_overflow_work.work);
237 struct e1000_hw *hw = &adapter->hw;
238 struct timespec64 ts;
241 /* Update the timecounter */
242 ns = timecounter_read(&adapter->tc);
244 ts = ns_to_timespec64(ns);
245 e_dbg("SYSTIM overflow check at %lld.%09lu\n",
246 (long long) ts.tv_sec, ts.tv_nsec);
248 schedule_delayed_work(&adapter->systim_overflow_work,
249 E1000_SYSTIM_OVERFLOW_PERIOD);
252 static const struct ptp_clock_info e1000e_ptp_clock_info = {
253 .owner = THIS_MODULE,
259 .adjfreq = e1000e_phc_adjfreq,
260 .adjtime = e1000e_phc_adjtime,
261 .gettime64 = e1000e_phc_gettime,
262 .settime64 = e1000e_phc_settime,
263 .enable = e1000e_phc_enable,
267 * e1000e_ptp_init - initialize PTP for devices which support it
268 * @adapter: board private structure
270 * This function performs the required steps for enabling PTP support.
271 * If PTP support has already been loaded it simply calls the cyclecounter
272 * init routine and exits.
274 void e1000e_ptp_init(struct e1000_adapter *adapter)
276 struct e1000_hw *hw = &adapter->hw;
278 adapter->ptp_clock = NULL;
280 if (!(adapter->flags & FLAG_HAS_HW_TIMESTAMP))
283 adapter->ptp_clock_info = e1000e_ptp_clock_info;
285 snprintf(adapter->ptp_clock_info.name,
286 sizeof(adapter->ptp_clock_info.name), "%pm",
287 adapter->netdev->perm_addr);
289 switch (hw->mac.type) {
294 if ((hw->mac.type < e1000_pch_lpt) ||
295 (er32(TSYNCRXCTL) & E1000_TSYNCRXCTL_SYSCFI)) {
296 adapter->ptp_clock_info.max_adj = 24000000 - 1;
302 adapter->ptp_clock_info.max_adj = 600000000 - 1;
308 #ifdef CONFIG_E1000E_HWTS
309 /* CPU must have ART and GBe must be from Sunrise Point or greater */
310 if (hw->mac.type >= e1000_pch_spt && boot_cpu_has(X86_FEATURE_ART))
311 adapter->ptp_clock_info.getcrosststamp =
312 e1000e_phc_getcrosststamp;
313 #endif/*CONFIG_E1000E_HWTS*/
315 INIT_DELAYED_WORK(&adapter->systim_overflow_work,
316 e1000e_systim_overflow_work);
318 schedule_delayed_work(&adapter->systim_overflow_work,
319 E1000_SYSTIM_OVERFLOW_PERIOD);
321 adapter->ptp_clock = ptp_clock_register(&adapter->ptp_clock_info,
322 &adapter->pdev->dev);
323 if (IS_ERR(adapter->ptp_clock)) {
324 adapter->ptp_clock = NULL;
325 e_err("ptp_clock_register failed\n");
326 } else if (adapter->ptp_clock) {
327 e_info("registered PHC clock\n");
332 * e1000e_ptp_remove - disable PTP device and stop the overflow check
333 * @adapter: board private structure
335 * Stop the PTP support, and cancel the delayed work.
337 void e1000e_ptp_remove(struct e1000_adapter *adapter)
339 if (!(adapter->flags & FLAG_HAS_HW_TIMESTAMP))
342 cancel_delayed_work_sync(&adapter->systim_overflow_work);
344 if (adapter->ptp_clock) {
345 ptp_clock_unregister(adapter->ptp_clock);
346 adapter->ptp_clock = NULL;
347 e_info("removed PHC\n");