1 // SPDX-License-Identifier: GPL-2.0-only
2 /****************************************************************************
3 * Driver for Solarflare network controllers and boards
4 * Copyright 2011-2013 Solarflare Communications Inc.
7 /* Theory of operation:
9 * PTP support is assisted by firmware running on the MC, which provides
10 * the hardware timestamping capabilities. Both transmitted and received
11 * PTP event packets are queued onto internal queues for subsequent processing;
12 * this is because the MC operations are relatively long and would block
13 * block NAPI/interrupt operation.
15 * Receive event processing:
16 * The event contains the packet's UUID and sequence number, together
17 * with the hardware timestamp. The PTP receive packet queue is searched
18 * for this UUID/sequence number and, if found, put on a pending queue.
19 * Packets not matching are delivered without timestamps (MCDI events will
20 * always arrive after the actual packet).
21 * It is important for the operation of the PTP protocol that the ordering
22 * of packets between the event and general port is maintained.
24 * Work queue processing:
25 * If work waiting, synchronise host/hardware time
27 * Transmit: send packet through MC, which returns the transmission time
28 * that is converted to an appropriate timestamp.
30 * Receive: the packet's reception time is converted to an appropriate
34 #include <linux/udp.h>
35 #include <linux/time.h>
36 #include <linux/errno.h>
37 #include <linux/ktime.h>
38 #include <linux/module.h>
39 #include <linux/pps_kernel.h>
40 #include <linux/ptp_clock_kernel.h>
41 #include "net_driver.h"
44 #include "mcdi_pcol.h"
47 #include "nic.h" /* indirectly includes ptp.h */
48 #include "efx_channels.h"
50 /* Maximum number of events expected to make up a PTP event */
51 #define MAX_EVENT_FRAGS 3
53 /* Maximum delay, ms, to begin synchronisation */
54 #define MAX_SYNCHRONISE_WAIT_MS 2
56 /* How long, at most, to spend synchronising */
57 #define SYNCHRONISE_PERIOD_NS 250000
59 /* How often to update the shared memory time */
60 #define SYNCHRONISATION_GRANULARITY_NS 200
62 /* Minimum permitted length of a (corrected) synchronisation time */
63 #define DEFAULT_MIN_SYNCHRONISATION_NS 120
65 /* Maximum permitted length of a (corrected) synchronisation time */
66 #define MAX_SYNCHRONISATION_NS 1000
68 /* How many (MC) receive events that can be queued */
69 #define MAX_RECEIVE_EVENTS 8
71 /* Length of (modified) moving average. */
72 #define AVERAGE_LENGTH 16
74 /* How long an unmatched event or packet can be held */
75 #define PKT_EVENT_LIFETIME_MS 10
77 /* How long unused unicast filters can be held */
78 #define UCAST_FILTER_EXPIRY_JIFFIES msecs_to_jiffies(30000)
80 /* Offsets into PTP packet for identification. These offsets are from the
81 * start of the IP header, not the MAC header. Note that neither PTP V1 nor
82 * PTP V2 permit the use of IPV4 options.
84 #define PTP_DPORT_OFFSET 22
86 #define PTP_V1_VERSION_LENGTH 2
87 #define PTP_V1_VERSION_OFFSET 28
89 #define PTP_V1_SEQUENCE_LENGTH 2
90 #define PTP_V1_SEQUENCE_OFFSET 58
92 /* The minimum length of a PTP V1 packet for offsets, etc. to be valid:
95 #define PTP_V1_MIN_LENGTH 64
97 #define PTP_V2_VERSION_LENGTH 1
98 #define PTP_V2_VERSION_OFFSET 29
100 #define PTP_V2_SEQUENCE_LENGTH 2
101 #define PTP_V2_SEQUENCE_OFFSET 58
103 /* The minimum length of a PTP V2 packet for offsets, etc. to be valid:
104 * includes IP header.
106 #define PTP_V2_MIN_LENGTH 63
108 #define PTP_MIN_LENGTH 63
110 #define PTP_ADDR_IPV4 0xe0000181 /* 224.0.1.129 */
111 #define PTP_ADDR_IPV6 {0xff, 0x0e, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, \
112 0, 0x01, 0x81} /* ff0e::181 */
113 #define PTP_EVENT_PORT 319
114 #define PTP_GENERAL_PORT 320
115 #define PTP_ADDR_ETHER {0x01, 0x1b, 0x19, 0, 0, 0} /* 01-1B-19-00-00-00 */
117 /* Annoyingly the format of the version numbers are different between
118 * versions 1 and 2 so it isn't possible to simply look for 1 or 2.
120 #define PTP_VERSION_V1 1
122 #define PTP_VERSION_V2 2
123 #define PTP_VERSION_V2_MASK 0x0f
125 enum ptp_packet_state {
126 PTP_PACKET_STATE_UNMATCHED = 0,
127 PTP_PACKET_STATE_MATCHED,
128 PTP_PACKET_STATE_TIMED_OUT,
129 PTP_PACKET_STATE_MATCH_UNWANTED
132 /* NIC synchronised with single word of time only comprising
133 * partial seconds and full nanoseconds: 10^9 ~ 2^30 so 2 bits for seconds.
135 #define MC_NANOSECOND_BITS 30
136 #define MC_NANOSECOND_MASK ((1 << MC_NANOSECOND_BITS) - 1)
137 #define MC_SECOND_MASK ((1 << (32 - MC_NANOSECOND_BITS)) - 1)
139 /* Maximum parts-per-billion adjustment that is acceptable */
140 #define MAX_PPB 1000000
142 /* Precalculate scale word to avoid long long division at runtime */
143 /* This is equivalent to 2^66 / 10^9. */
144 #define PPB_SCALE_WORD ((1LL << (57)) / 1953125LL)
146 /* How much to shift down after scaling to convert to FP40 */
147 #define PPB_SHIFT_FP40 26
149 #define PPB_SHIFT_FP44 22
151 #define PTP_SYNC_ATTEMPTS 4
154 * struct efx_ptp_match - Matching structure, stored in sk_buff's cb area.
155 * @expiry: Time after which the packet should be delivered irrespective of
157 * @state: The state of the packet - whether it is ready for processing or
158 * whether that is of no interest.
160 struct efx_ptp_match {
161 unsigned long expiry;
162 enum ptp_packet_state state;
166 * struct efx_ptp_event_rx - A PTP receive event (from MC)
167 * @link: list of events
168 * @seq0: First part of (PTP) UUID
169 * @seq1: Second part of (PTP) UUID and sequence number
170 * @hwtimestamp: Event timestamp
171 * @expiry: Time which the packet arrived
173 struct efx_ptp_event_rx {
174 struct list_head link;
178 unsigned long expiry;
182 * struct efx_ptp_timeset - Synchronisation between host and MC
183 * @host_start: Host time immediately before hardware timestamp taken
184 * @major: Hardware timestamp, major
185 * @minor: Hardware timestamp, minor
186 * @host_end: Host time immediately after hardware timestamp taken
187 * @wait: Number of NIC clock ticks between hardware timestamp being read and
188 * host end time being seen
189 * @window: Difference of host_end and host_start
190 * @valid: Whether this timeset is valid
192 struct efx_ptp_timeset {
198 u32 window; /* Derived: end - start, allowing for wrap */
202 * struct efx_ptp_rxfilter - Filter for PTP packets
203 * @list: Node of the list where the filter is added
204 * @ether_type: Network protocol of the filter (ETHER_P_IP / ETHER_P_IPV6)
205 * @loc_port: UDP port of the filter (PTP_EVENT_PORT / PTP_GENERAL_PORT)
206 * @loc_host: IPv4/v6 address of the filter
207 * @expiry: time when the filter expires, in jiffies
208 * @handle: Handle ID for the MCDI filters table
210 struct efx_ptp_rxfilter {
211 struct list_head list;
215 unsigned long expiry;
220 * struct efx_ptp_data - Precision Time Protocol (PTP) state
221 * @efx: The NIC context
222 * @channel: The PTP channel (for Medford and Medford2)
223 * @rxq: Receive SKB queue (awaiting timestamps)
224 * @txq: Transmit SKB queue
225 * @workwq: Work queue for processing pending PTP operations
227 * @cleanup_work: Work task for periodic cleanup
228 * @reset_required: A serious error has occurred and the PTP task needs to be
229 * reset (disable, enable).
230 * @rxfilters_mcast: Receive filters for multicast PTP packets
231 * @rxfilters_ucast: Receive filters for unicast PTP packets
232 * @config: Current timestamp configuration
233 * @enabled: PTP operation enabled
234 * @mode: Mode in which PTP operating (PTP version)
235 * @ns_to_nic_time: Function to convert from scalar nanoseconds to NIC time
236 * @nic_to_kernel_time: Function to convert from NIC to kernel time
237 * @nic_time: contains time details
238 * @nic_time.minor_max: Wrap point for NIC minor times
239 * @nic_time.sync_event_diff_min: Minimum acceptable difference between time
240 * in packet prefix and last MCDI time sync event i.e. how much earlier than
241 * the last sync event time a packet timestamp can be.
242 * @nic_time.sync_event_diff_max: Maximum acceptable difference between time
243 * in packet prefix and last MCDI time sync event i.e. how much later than
244 * the last sync event time a packet timestamp can be.
245 * @nic_time.sync_event_minor_shift: Shift required to make minor time from
246 * field in MCDI time sync event.
247 * @min_synchronisation_ns: Minimum acceptable corrected sync window
248 * @capabilities: Capabilities flags from the NIC
249 * @ts_corrections: contains corrections details
250 * @ts_corrections.ptp_tx: Required driver correction of PTP packet transmit
252 * @ts_corrections.ptp_rx: Required driver correction of PTP packet receive
254 * @ts_corrections.pps_out: PPS output error (information only)
255 * @ts_corrections.pps_in: Required driver correction of PPS input timestamps
256 * @ts_corrections.general_tx: Required driver correction of general packet
257 * transmit timestamps
258 * @ts_corrections.general_rx: Required driver correction of general packet
260 * @evt_frags: Partly assembled PTP events
261 * @evt_frag_idx: Current fragment number
262 * @evt_code: Last event code
263 * @start: Address at which MC indicates ready for synchronisation
264 * @host_time_pps: Host time at last PPS
265 * @adjfreq_ppb_shift: Shift required to convert scaled parts-per-billion
266 * frequency adjustment into a fixed point fractional nanosecond format.
267 * @current_adjfreq: Current ppb adjustment.
268 * @phc_clock: Pointer to registered phc device (if primary function)
269 * @phc_clock_info: Registration structure for phc device
270 * @pps_work: pps work task for handling pps events
271 * @pps_workwq: pps work queue
272 * @nic_ts_enabled: Flag indicating if NIC generated TS events are handled
273 * @txbuf: Buffer for use when transmitting (PTP) packets to MC (avoids
274 * allocations in main data path).
275 * @good_syncs: Number of successful synchronisations.
276 * @fast_syncs: Number of synchronisations requiring short delay
277 * @bad_syncs: Number of failed synchronisations.
278 * @sync_timeouts: Number of synchronisation timeouts
279 * @no_time_syncs: Number of synchronisations with no good times.
280 * @invalid_sync_windows: Number of sync windows with bad durations.
281 * @undersize_sync_windows: Number of corrected sync windows that are too small
282 * @oversize_sync_windows: Number of corrected sync windows that are too large
283 * @rx_no_timestamp: Number of packets received without a timestamp.
284 * @timeset: Last set of synchronisation statistics.
285 * @xmit_skb: Transmit SKB function.
287 struct efx_ptp_data {
289 struct efx_channel *channel;
290 struct sk_buff_head rxq;
291 struct sk_buff_head txq;
292 struct workqueue_struct *workwq;
293 struct work_struct work;
294 struct delayed_work cleanup_work;
296 struct list_head rxfilters_mcast;
297 struct list_head rxfilters_ucast;
298 struct hwtstamp_config config;
301 void (*ns_to_nic_time)(s64 ns, u32 *nic_major, u32 *nic_minor);
302 ktime_t (*nic_to_kernel_time)(u32 nic_major, u32 nic_minor,
306 u32 sync_event_diff_min;
307 u32 sync_event_diff_max;
308 unsigned int sync_event_minor_shift;
310 unsigned int min_synchronisation_ns;
311 unsigned int capabilities;
320 efx_qword_t evt_frags[MAX_EVENT_FRAGS];
323 struct efx_buffer start;
324 struct pps_event_time host_time_pps;
325 unsigned int adjfreq_ppb_shift;
327 struct ptp_clock *phc_clock;
328 struct ptp_clock_info phc_clock_info;
329 struct work_struct pps_work;
330 struct workqueue_struct *pps_workwq;
332 efx_dword_t txbuf[MCDI_TX_BUF_LEN(MC_CMD_PTP_IN_TRANSMIT_LENMAX)];
334 unsigned int good_syncs;
335 unsigned int fast_syncs;
336 unsigned int bad_syncs;
337 unsigned int sync_timeouts;
338 unsigned int no_time_syncs;
339 unsigned int invalid_sync_windows;
340 unsigned int undersize_sync_windows;
341 unsigned int oversize_sync_windows;
342 unsigned int rx_no_timestamp;
343 struct efx_ptp_timeset
344 timeset[MC_CMD_PTP_OUT_SYNCHRONIZE_TIMESET_MAXNUM];
345 void (*xmit_skb)(struct efx_nic *efx, struct sk_buff *skb);
348 static int efx_phc_adjfine(struct ptp_clock_info *ptp, long scaled_ppm);
349 static int efx_phc_adjtime(struct ptp_clock_info *ptp, s64 delta);
350 static int efx_phc_gettime(struct ptp_clock_info *ptp, struct timespec64 *ts);
351 static int efx_phc_settime(struct ptp_clock_info *ptp,
352 const struct timespec64 *e_ts);
353 static int efx_phc_enable(struct ptp_clock_info *ptp,
354 struct ptp_clock_request *request, int on);
355 static int efx_ptp_insert_unicast_filter(struct efx_nic *efx,
356 struct sk_buff *skb);
358 bool efx_ptp_use_mac_tx_timestamps(struct efx_nic *efx)
360 return efx_has_cap(efx, TX_MAC_TIMESTAMPING);
363 /* PTP 'extra' channel is still a traffic channel, but we only create TX queues
364 * if PTP uses MAC TX timestamps, not if PTP uses the MC directly to transmit.
366 static bool efx_ptp_want_txqs(struct efx_channel *channel)
368 return efx_ptp_use_mac_tx_timestamps(channel->efx);
371 #define PTP_SW_STAT(ext_name, field_name) \
372 { #ext_name, 0, offsetof(struct efx_ptp_data, field_name) }
373 #define PTP_MC_STAT(ext_name, mcdi_name) \
374 { #ext_name, 32, MC_CMD_PTP_OUT_STATUS_STATS_ ## mcdi_name ## _OFST }
375 static const struct efx_hw_stat_desc efx_ptp_stat_desc[] = {
376 PTP_SW_STAT(ptp_good_syncs, good_syncs),
377 PTP_SW_STAT(ptp_fast_syncs, fast_syncs),
378 PTP_SW_STAT(ptp_bad_syncs, bad_syncs),
379 PTP_SW_STAT(ptp_sync_timeouts, sync_timeouts),
380 PTP_SW_STAT(ptp_no_time_syncs, no_time_syncs),
381 PTP_SW_STAT(ptp_invalid_sync_windows, invalid_sync_windows),
382 PTP_SW_STAT(ptp_undersize_sync_windows, undersize_sync_windows),
383 PTP_SW_STAT(ptp_oversize_sync_windows, oversize_sync_windows),
384 PTP_SW_STAT(ptp_rx_no_timestamp, rx_no_timestamp),
385 PTP_MC_STAT(ptp_tx_timestamp_packets, TX),
386 PTP_MC_STAT(ptp_rx_timestamp_packets, RX),
387 PTP_MC_STAT(ptp_timestamp_packets, TS),
388 PTP_MC_STAT(ptp_filter_matches, FM),
389 PTP_MC_STAT(ptp_non_filter_matches, NFM),
391 #define PTP_STAT_COUNT ARRAY_SIZE(efx_ptp_stat_desc)
392 static const unsigned long efx_ptp_stat_mask[] = {
393 [0 ... BITS_TO_LONGS(PTP_STAT_COUNT) - 1] = ~0UL,
396 size_t efx_ptp_describe_stats(struct efx_nic *efx, u8 *strings)
401 return efx_nic_describe_stats(efx_ptp_stat_desc, PTP_STAT_COUNT,
402 efx_ptp_stat_mask, strings);
405 size_t efx_ptp_update_stats(struct efx_nic *efx, u64 *stats)
407 MCDI_DECLARE_BUF(inbuf, MC_CMD_PTP_IN_STATUS_LEN);
408 MCDI_DECLARE_BUF(outbuf, MC_CMD_PTP_OUT_STATUS_LEN);
415 /* Copy software statistics */
416 for (i = 0; i < PTP_STAT_COUNT; i++) {
417 if (efx_ptp_stat_desc[i].dma_width)
419 stats[i] = *(unsigned int *)((char *)efx->ptp_data +
420 efx_ptp_stat_desc[i].offset);
423 /* Fetch MC statistics. We *must* fill in all statistics or
424 * risk leaking kernel memory to userland, so if the MCDI
425 * request fails we pretend we got zeroes.
427 MCDI_SET_DWORD(inbuf, PTP_IN_OP, MC_CMD_PTP_OP_STATUS);
428 MCDI_SET_DWORD(inbuf, PTP_IN_PERIPH_ID, 0);
429 rc = efx_mcdi_rpc(efx, MC_CMD_PTP, inbuf, sizeof(inbuf),
430 outbuf, sizeof(outbuf), NULL);
432 memset(outbuf, 0, sizeof(outbuf));
433 efx_nic_update_stats(efx_ptp_stat_desc, PTP_STAT_COUNT,
435 stats, _MCDI_PTR(outbuf, 0), false);
437 return PTP_STAT_COUNT;
440 /* To convert from s27 format to ns we multiply then divide by a power of 2.
441 * For the conversion from ns to s27, the operation is also converted to a
442 * multiply and shift.
444 #define S27_TO_NS_SHIFT (27)
445 #define NS_TO_S27_MULT (((1ULL << 63) + NSEC_PER_SEC / 2) / NSEC_PER_SEC)
446 #define NS_TO_S27_SHIFT (63 - S27_TO_NS_SHIFT)
447 #define S27_MINOR_MAX (1 << S27_TO_NS_SHIFT)
449 /* For Huntington platforms NIC time is in seconds and fractions of a second
450 * where the minor register only uses 27 bits in units of 2^-27s.
452 static void efx_ptp_ns_to_s27(s64 ns, u32 *nic_major, u32 *nic_minor)
454 struct timespec64 ts = ns_to_timespec64(ns);
455 u32 maj = (u32)ts.tv_sec;
456 u32 min = (u32)(((u64)ts.tv_nsec * NS_TO_S27_MULT +
457 (1ULL << (NS_TO_S27_SHIFT - 1))) >> NS_TO_S27_SHIFT);
459 /* The conversion can result in the minor value exceeding the maximum.
460 * In this case, round up to the next second.
462 if (min >= S27_MINOR_MAX) {
463 min -= S27_MINOR_MAX;
471 static inline ktime_t efx_ptp_s27_to_ktime(u32 nic_major, u32 nic_minor)
473 u32 ns = (u32)(((u64)nic_minor * NSEC_PER_SEC +
474 (1ULL << (S27_TO_NS_SHIFT - 1))) >> S27_TO_NS_SHIFT);
475 return ktime_set(nic_major, ns);
478 static ktime_t efx_ptp_s27_to_ktime_correction(u32 nic_major, u32 nic_minor,
481 /* Apply the correction and deal with carry */
482 nic_minor += correction;
483 if ((s32)nic_minor < 0) {
484 nic_minor += S27_MINOR_MAX;
486 } else if (nic_minor >= S27_MINOR_MAX) {
487 nic_minor -= S27_MINOR_MAX;
491 return efx_ptp_s27_to_ktime(nic_major, nic_minor);
494 /* For Medford2 platforms the time is in seconds and quarter nanoseconds. */
495 static void efx_ptp_ns_to_s_qns(s64 ns, u32 *nic_major, u32 *nic_minor)
497 struct timespec64 ts = ns_to_timespec64(ns);
499 *nic_major = (u32)ts.tv_sec;
500 *nic_minor = ts.tv_nsec * 4;
503 static ktime_t efx_ptp_s_qns_to_ktime_correction(u32 nic_major, u32 nic_minor,
508 nic_minor = DIV_ROUND_CLOSEST(nic_minor, 4);
509 correction = DIV_ROUND_CLOSEST(correction, 4);
511 kt = ktime_set(nic_major, nic_minor);
514 kt = ktime_add_ns(kt, (u64)correction);
516 kt = ktime_sub_ns(kt, (u64)-correction);
520 struct efx_channel *efx_ptp_channel(struct efx_nic *efx)
522 return efx->ptp_data ? efx->ptp_data->channel : NULL;
525 void efx_ptp_update_channel(struct efx_nic *efx, struct efx_channel *channel)
528 efx->ptp_data->channel = channel;
531 static u32 last_sync_timestamp_major(struct efx_nic *efx)
533 struct efx_channel *channel = efx_ptp_channel(efx);
537 major = channel->sync_timestamp_major;
541 /* The 8000 series and later can provide the time from the MAC, which is only
542 * 48 bits long and provides meta-information in the top 2 bits.
545 efx_ptp_mac_nic_to_ktime_correction(struct efx_nic *efx,
546 struct efx_ptp_data *ptp,
547 u32 nic_major, u32 nic_minor,
554 if (!(nic_major & 0x80000000)) {
555 WARN_ON_ONCE(nic_major >> 16);
557 /* Medford provides 48 bits of timestamp, so we must get the top
558 * 16 bits from the timesync event state.
560 * We only have the lower 16 bits of the time now, but we do
561 * have a full resolution timestamp at some point in past. As
562 * long as the difference between the (real) now and the sync
563 * is less than 2^15, then we can reconstruct the difference
564 * between those two numbers using only the lower 16 bits of
569 * a - b = ((a mod k) - b) mod k
571 * when -k/2 < (a-b) < k/2. In our case k is 2^16. We know
572 * (a mod k) and b, so can calculate the delta, a - b.
575 sync_timestamp = last_sync_timestamp_major(efx);
577 /* Because delta is s16 this does an implicit mask down to
578 * 16 bits which is what we need, assuming
579 * MEDFORD_TX_SECS_EVENT_BITS is 16. delta is signed so that
580 * we can deal with the (unlikely) case of sync timestamps
581 * arriving from the future.
583 delta = nic_major - sync_timestamp;
585 /* Recover the fully specified time now, by applying the offset
586 * to the (fully specified) sync time.
588 nic_major = sync_timestamp + delta;
590 kt = ptp->nic_to_kernel_time(nic_major, nic_minor,
596 ktime_t efx_ptp_nic_to_kernel_time(struct efx_tx_queue *tx_queue)
598 struct efx_nic *efx = tx_queue->efx;
599 struct efx_ptp_data *ptp = efx->ptp_data;
602 if (efx_ptp_use_mac_tx_timestamps(efx))
603 kt = efx_ptp_mac_nic_to_ktime_correction(efx, ptp,
604 tx_queue->completed_timestamp_major,
605 tx_queue->completed_timestamp_minor,
606 ptp->ts_corrections.general_tx);
608 kt = ptp->nic_to_kernel_time(
609 tx_queue->completed_timestamp_major,
610 tx_queue->completed_timestamp_minor,
611 ptp->ts_corrections.general_tx);
615 /* Get PTP attributes and set up time conversions */
616 static int efx_ptp_get_attributes(struct efx_nic *efx)
618 MCDI_DECLARE_BUF(inbuf, MC_CMD_PTP_IN_GET_ATTRIBUTES_LEN);
619 MCDI_DECLARE_BUF(outbuf, MC_CMD_PTP_OUT_GET_ATTRIBUTES_LEN);
620 struct efx_ptp_data *ptp = efx->ptp_data;
625 /* Get the PTP attributes. If the NIC doesn't support the operation we
626 * use the default format for compatibility with older NICs i.e.
627 * seconds and nanoseconds.
629 MCDI_SET_DWORD(inbuf, PTP_IN_OP, MC_CMD_PTP_OP_GET_ATTRIBUTES);
630 MCDI_SET_DWORD(inbuf, PTP_IN_PERIPH_ID, 0);
631 rc = efx_mcdi_rpc_quiet(efx, MC_CMD_PTP, inbuf, sizeof(inbuf),
632 outbuf, sizeof(outbuf), &out_len);
634 fmt = MCDI_DWORD(outbuf, PTP_OUT_GET_ATTRIBUTES_TIME_FORMAT);
635 } else if (rc == -EINVAL) {
636 fmt = MC_CMD_PTP_OUT_GET_ATTRIBUTES_SECONDS_NANOSECONDS;
637 } else if (rc == -EPERM) {
638 pci_info(efx->pci_dev, "no PTP support\n");
641 efx_mcdi_display_error(efx, MC_CMD_PTP, sizeof(inbuf),
642 outbuf, sizeof(outbuf), rc);
647 case MC_CMD_PTP_OUT_GET_ATTRIBUTES_SECONDS_27FRACTION:
648 ptp->ns_to_nic_time = efx_ptp_ns_to_s27;
649 ptp->nic_to_kernel_time = efx_ptp_s27_to_ktime_correction;
650 ptp->nic_time.minor_max = 1 << 27;
651 ptp->nic_time.sync_event_minor_shift = 19;
653 case MC_CMD_PTP_OUT_GET_ATTRIBUTES_SECONDS_QTR_NANOSECONDS:
654 ptp->ns_to_nic_time = efx_ptp_ns_to_s_qns;
655 ptp->nic_to_kernel_time = efx_ptp_s_qns_to_ktime_correction;
656 ptp->nic_time.minor_max = 4000000000UL;
657 ptp->nic_time.sync_event_minor_shift = 24;
663 /* Precalculate acceptable difference between the minor time in the
664 * packet prefix and the last MCDI time sync event. We expect the
665 * packet prefix timestamp to be after of sync event by up to one
666 * sync event interval (0.25s) but we allow it to exceed this by a
667 * fuzz factor of (0.1s)
669 ptp->nic_time.sync_event_diff_min = ptp->nic_time.minor_max
670 - (ptp->nic_time.minor_max / 10);
671 ptp->nic_time.sync_event_diff_max = (ptp->nic_time.minor_max / 4)
672 + (ptp->nic_time.minor_max / 10);
674 /* MC_CMD_PTP_OP_GET_ATTRIBUTES has been extended twice from an older
675 * operation MC_CMD_PTP_OP_GET_TIME_FORMAT. The function now may return
676 * a value to use for the minimum acceptable corrected synchronization
677 * window and may return further capabilities.
678 * If we have the extra information store it. For older firmware that
679 * does not implement the extended command use the default value.
682 out_len >= MC_CMD_PTP_OUT_GET_ATTRIBUTES_CAPABILITIES_OFST)
683 ptp->min_synchronisation_ns =
685 PTP_OUT_GET_ATTRIBUTES_SYNC_WINDOW_MIN);
687 ptp->min_synchronisation_ns = DEFAULT_MIN_SYNCHRONISATION_NS;
690 out_len >= MC_CMD_PTP_OUT_GET_ATTRIBUTES_LEN)
691 ptp->capabilities = MCDI_DWORD(outbuf,
692 PTP_OUT_GET_ATTRIBUTES_CAPABILITIES);
694 ptp->capabilities = 0;
696 /* Set up the shift for conversion between frequency
697 * adjustments in parts-per-billion and the fixed-point
698 * fractional ns format that the adapter uses.
700 if (ptp->capabilities & (1 << MC_CMD_PTP_OUT_GET_ATTRIBUTES_FP44_FREQ_ADJ_LBN))
701 ptp->adjfreq_ppb_shift = PPB_SHIFT_FP44;
703 ptp->adjfreq_ppb_shift = PPB_SHIFT_FP40;
708 /* Get PTP timestamp corrections */
709 static int efx_ptp_get_timestamp_corrections(struct efx_nic *efx)
711 MCDI_DECLARE_BUF(inbuf, MC_CMD_PTP_IN_GET_TIMESTAMP_CORRECTIONS_LEN);
712 MCDI_DECLARE_BUF(outbuf, MC_CMD_PTP_OUT_GET_TIMESTAMP_CORRECTIONS_V2_LEN);
716 /* Get the timestamp corrections from the NIC. If this operation is
717 * not supported (older NICs) then no correction is required.
719 MCDI_SET_DWORD(inbuf, PTP_IN_OP,
720 MC_CMD_PTP_OP_GET_TIMESTAMP_CORRECTIONS);
721 MCDI_SET_DWORD(inbuf, PTP_IN_PERIPH_ID, 0);
723 rc = efx_mcdi_rpc_quiet(efx, MC_CMD_PTP, inbuf, sizeof(inbuf),
724 outbuf, sizeof(outbuf), &out_len);
726 efx->ptp_data->ts_corrections.ptp_tx = MCDI_DWORD(outbuf,
727 PTP_OUT_GET_TIMESTAMP_CORRECTIONS_TRANSMIT);
728 efx->ptp_data->ts_corrections.ptp_rx = MCDI_DWORD(outbuf,
729 PTP_OUT_GET_TIMESTAMP_CORRECTIONS_RECEIVE);
730 efx->ptp_data->ts_corrections.pps_out = MCDI_DWORD(outbuf,
731 PTP_OUT_GET_TIMESTAMP_CORRECTIONS_PPS_OUT);
732 efx->ptp_data->ts_corrections.pps_in = MCDI_DWORD(outbuf,
733 PTP_OUT_GET_TIMESTAMP_CORRECTIONS_PPS_IN);
735 if (out_len >= MC_CMD_PTP_OUT_GET_TIMESTAMP_CORRECTIONS_V2_LEN) {
736 efx->ptp_data->ts_corrections.general_tx = MCDI_DWORD(
738 PTP_OUT_GET_TIMESTAMP_CORRECTIONS_V2_GENERAL_TX);
739 efx->ptp_data->ts_corrections.general_rx = MCDI_DWORD(
741 PTP_OUT_GET_TIMESTAMP_CORRECTIONS_V2_GENERAL_RX);
743 efx->ptp_data->ts_corrections.general_tx =
744 efx->ptp_data->ts_corrections.ptp_tx;
745 efx->ptp_data->ts_corrections.general_rx =
746 efx->ptp_data->ts_corrections.ptp_rx;
748 } else if (rc == -EINVAL) {
749 efx->ptp_data->ts_corrections.ptp_tx = 0;
750 efx->ptp_data->ts_corrections.ptp_rx = 0;
751 efx->ptp_data->ts_corrections.pps_out = 0;
752 efx->ptp_data->ts_corrections.pps_in = 0;
753 efx->ptp_data->ts_corrections.general_tx = 0;
754 efx->ptp_data->ts_corrections.general_rx = 0;
756 efx_mcdi_display_error(efx, MC_CMD_PTP, sizeof(inbuf), outbuf,
764 /* Enable MCDI PTP support. */
765 static int efx_ptp_enable(struct efx_nic *efx)
767 MCDI_DECLARE_BUF(inbuf, MC_CMD_PTP_IN_ENABLE_LEN);
768 MCDI_DECLARE_BUF_ERR(outbuf);
771 MCDI_SET_DWORD(inbuf, PTP_IN_OP, MC_CMD_PTP_OP_ENABLE);
772 MCDI_SET_DWORD(inbuf, PTP_IN_PERIPH_ID, 0);
773 MCDI_SET_DWORD(inbuf, PTP_IN_ENABLE_QUEUE,
774 efx->ptp_data->channel ?
775 efx->ptp_data->channel->channel : 0);
776 MCDI_SET_DWORD(inbuf, PTP_IN_ENABLE_MODE, efx->ptp_data->mode);
778 rc = efx_mcdi_rpc_quiet(efx, MC_CMD_PTP, inbuf, sizeof(inbuf),
779 outbuf, sizeof(outbuf), NULL);
780 rc = (rc == -EALREADY) ? 0 : rc;
782 efx_mcdi_display_error(efx, MC_CMD_PTP,
783 MC_CMD_PTP_IN_ENABLE_LEN,
784 outbuf, sizeof(outbuf), rc);
788 /* Disable MCDI PTP support.
790 * Note that this function should never rely on the presence of ptp_data -
791 * may be called before that exists.
793 static int efx_ptp_disable(struct efx_nic *efx)
795 MCDI_DECLARE_BUF(inbuf, MC_CMD_PTP_IN_DISABLE_LEN);
796 MCDI_DECLARE_BUF_ERR(outbuf);
799 MCDI_SET_DWORD(inbuf, PTP_IN_OP, MC_CMD_PTP_OP_DISABLE);
800 MCDI_SET_DWORD(inbuf, PTP_IN_PERIPH_ID, 0);
801 rc = efx_mcdi_rpc_quiet(efx, MC_CMD_PTP, inbuf, sizeof(inbuf),
802 outbuf, sizeof(outbuf), NULL);
803 rc = (rc == -EALREADY) ? 0 : rc;
804 /* If we get ENOSYS, the NIC doesn't support PTP, and thus this function
805 * should only have been called during probe.
807 if (rc == -ENOSYS || rc == -EPERM)
808 pci_info(efx->pci_dev, "no PTP support\n");
810 efx_mcdi_display_error(efx, MC_CMD_PTP,
811 MC_CMD_PTP_IN_DISABLE_LEN,
812 outbuf, sizeof(outbuf), rc);
816 static void efx_ptp_deliver_rx_queue(struct sk_buff_head *q)
820 while ((skb = skb_dequeue(q))) {
822 netif_receive_skb(skb);
827 static void efx_ptp_handle_no_channel(struct efx_nic *efx)
829 netif_err(efx, drv, efx->net_dev,
830 "ERROR: PTP requires MSI-X and 1 additional interrupt"
831 "vector. PTP disabled\n");
834 /* Repeatedly send the host time to the MC which will capture the hardware
837 static void efx_ptp_send_times(struct efx_nic *efx,
838 struct pps_event_time *last_time)
840 struct pps_event_time now;
841 struct timespec64 limit;
842 struct efx_ptp_data *ptp = efx->ptp_data;
843 int *mc_running = ptp->start.addr;
847 timespec64_add_ns(&limit, SYNCHRONISE_PERIOD_NS);
849 /* Write host time for specified period or until MC is done */
850 while ((timespec64_compare(&now.ts_real, &limit) < 0) &&
851 READ_ONCE(*mc_running)) {
852 struct timespec64 update_time;
853 unsigned int host_time;
855 /* Don't update continuously to avoid saturating the PCIe bus */
856 update_time = now.ts_real;
857 timespec64_add_ns(&update_time, SYNCHRONISATION_GRANULARITY_NS);
860 } while ((timespec64_compare(&now.ts_real, &update_time) < 0) &&
861 READ_ONCE(*mc_running));
863 /* Synchronise NIC with single word of time only */
864 host_time = (now.ts_real.tv_sec << MC_NANOSECOND_BITS |
865 now.ts_real.tv_nsec);
866 /* Update host time in NIC memory */
867 efx->type->ptp_write_host_time(efx, host_time);
872 /* Read a timeset from the MC's results and partial process. */
873 static void efx_ptp_read_timeset(MCDI_DECLARE_STRUCT_PTR(data),
874 struct efx_ptp_timeset *timeset)
876 unsigned start_ns, end_ns;
878 timeset->host_start = MCDI_DWORD(data, PTP_OUT_SYNCHRONIZE_HOSTSTART);
879 timeset->major = MCDI_DWORD(data, PTP_OUT_SYNCHRONIZE_MAJOR);
880 timeset->minor = MCDI_DWORD(data, PTP_OUT_SYNCHRONIZE_MINOR);
881 timeset->host_end = MCDI_DWORD(data, PTP_OUT_SYNCHRONIZE_HOSTEND),
882 timeset->wait = MCDI_DWORD(data, PTP_OUT_SYNCHRONIZE_WAITNS);
885 start_ns = timeset->host_start & MC_NANOSECOND_MASK;
886 end_ns = timeset->host_end & MC_NANOSECOND_MASK;
887 /* Allow for rollover */
888 if (end_ns < start_ns)
889 end_ns += NSEC_PER_SEC;
890 /* Determine duration of operation */
891 timeset->window = end_ns - start_ns;
894 /* Process times received from MC.
896 * Extract times from returned results, and establish the minimum value
897 * seen. The minimum value represents the "best" possible time and events
898 * too much greater than this are rejected - the machine is, perhaps, too
899 * busy. A number of readings are taken so that, hopefully, at least one good
900 * synchronisation will be seen in the results.
903 efx_ptp_process_times(struct efx_nic *efx, MCDI_DECLARE_STRUCT_PTR(synch_buf),
904 size_t response_length,
905 const struct pps_event_time *last_time)
907 unsigned number_readings =
908 MCDI_VAR_ARRAY_LEN(response_length,
909 PTP_OUT_SYNCHRONIZE_TIMESET);
912 unsigned last_good = 0;
913 struct efx_ptp_data *ptp = efx->ptp_data;
916 struct timespec64 delta;
919 if (number_readings == 0)
922 /* Read the set of results and find the last good host-MC
923 * synchronization result. The MC times when it finishes reading the
924 * host time so the corrected window time should be fairly constant
925 * for a given platform. Increment stats for any results that appear
928 for (i = 0; i < number_readings; i++) {
929 s32 window, corrected;
930 struct timespec64 wait;
932 efx_ptp_read_timeset(
933 MCDI_ARRAY_STRUCT_PTR(synch_buf,
934 PTP_OUT_SYNCHRONIZE_TIMESET, i),
937 wait = ktime_to_timespec64(
938 ptp->nic_to_kernel_time(0, ptp->timeset[i].wait, 0));
939 window = ptp->timeset[i].window;
940 corrected = window - wait.tv_nsec;
942 /* We expect the uncorrected synchronization window to be at
943 * least as large as the interval between host start and end
944 * times. If it is smaller than this then this is mostly likely
945 * to be a consequence of the host's time being adjusted.
946 * Check that the corrected sync window is in a reasonable
947 * range. If it is out of range it is likely to be because an
948 * interrupt or other delay occurred between reading the system
949 * time and writing it to MC memory.
951 if (window < SYNCHRONISATION_GRANULARITY_NS) {
952 ++ptp->invalid_sync_windows;
953 } else if (corrected >= MAX_SYNCHRONISATION_NS) {
954 ++ptp->oversize_sync_windows;
955 } else if (corrected < ptp->min_synchronisation_ns) {
956 ++ptp->undersize_sync_windows;
964 netif_warn(efx, drv, efx->net_dev,
965 "PTP no suitable synchronisations\n");
969 /* Calculate delay from last good sync (host time) to last_time.
970 * It is possible that the seconds rolled over between taking
971 * the start reading and the last value written by the host. The
972 * timescales are such that a gap of more than one second is never
973 * expected. delta is *not* normalised.
975 start_sec = ptp->timeset[last_good].host_start >> MC_NANOSECOND_BITS;
976 last_sec = last_time->ts_real.tv_sec & MC_SECOND_MASK;
977 if (start_sec != last_sec &&
978 ((start_sec + 1) & MC_SECOND_MASK) != last_sec) {
979 netif_warn(efx, hw, efx->net_dev,
980 "PTP bad synchronisation seconds\n");
983 delta.tv_sec = (last_sec - start_sec) & 1;
985 last_time->ts_real.tv_nsec -
986 (ptp->timeset[last_good].host_start & MC_NANOSECOND_MASK);
988 /* Convert the NIC time at last good sync into kernel time.
989 * No correction is required - this time is the output of a
992 mc_time = ptp->nic_to_kernel_time(ptp->timeset[last_good].major,
993 ptp->timeset[last_good].minor, 0);
995 /* Calculate delay from NIC top of second to last_time */
996 delta.tv_nsec += ktime_to_timespec64(mc_time).tv_nsec;
998 /* Set PPS timestamp to match NIC top of second */
999 ptp->host_time_pps = *last_time;
1000 pps_sub_ts(&ptp->host_time_pps, delta);
1005 /* Synchronize times between the host and the MC */
1006 static int efx_ptp_synchronize(struct efx_nic *efx, unsigned int num_readings)
1008 struct efx_ptp_data *ptp = efx->ptp_data;
1009 MCDI_DECLARE_BUF(synch_buf, MC_CMD_PTP_OUT_SYNCHRONIZE_LENMAX);
1010 size_t response_length;
1012 unsigned long timeout;
1013 struct pps_event_time last_time = {};
1014 unsigned int loops = 0;
1015 int *start = ptp->start.addr;
1017 MCDI_SET_DWORD(synch_buf, PTP_IN_OP, MC_CMD_PTP_OP_SYNCHRONIZE);
1018 MCDI_SET_DWORD(synch_buf, PTP_IN_PERIPH_ID, 0);
1019 MCDI_SET_DWORD(synch_buf, PTP_IN_SYNCHRONIZE_NUMTIMESETS,
1021 MCDI_SET_QWORD(synch_buf, PTP_IN_SYNCHRONIZE_START_ADDR,
1022 ptp->start.dma_addr);
1024 /* Clear flag that signals MC ready */
1025 WRITE_ONCE(*start, 0);
1026 rc = efx_mcdi_rpc_start(efx, MC_CMD_PTP, synch_buf,
1027 MC_CMD_PTP_IN_SYNCHRONIZE_LEN);
1028 EFX_WARN_ON_ONCE_PARANOID(rc);
1030 /* Wait for start from MCDI (or timeout) */
1031 timeout = jiffies + msecs_to_jiffies(MAX_SYNCHRONISE_WAIT_MS);
1032 while (!READ_ONCE(*start) && (time_before(jiffies, timeout))) {
1033 udelay(20); /* Usually start MCDI execution quickly */
1039 if (!time_before(jiffies, timeout))
1040 ++ptp->sync_timeouts;
1042 if (READ_ONCE(*start))
1043 efx_ptp_send_times(efx, &last_time);
1045 /* Collect results */
1046 rc = efx_mcdi_rpc_finish(efx, MC_CMD_PTP,
1047 MC_CMD_PTP_IN_SYNCHRONIZE_LEN,
1048 synch_buf, sizeof(synch_buf),
1051 rc = efx_ptp_process_times(efx, synch_buf, response_length,
1056 ++ptp->no_time_syncs;
1059 /* Increment the bad syncs counter if the synchronize fails, whatever
1068 /* Transmit a PTP packet via the dedicated hardware timestamped queue. */
1069 static void efx_ptp_xmit_skb_queue(struct efx_nic *efx, struct sk_buff *skb)
1071 struct efx_ptp_data *ptp_data = efx->ptp_data;
1072 u8 type = efx_tx_csum_type_skb(skb);
1073 struct efx_tx_queue *tx_queue;
1075 tx_queue = efx_channel_get_tx_queue(ptp_data->channel, type);
1076 if (tx_queue && tx_queue->timestamping) {
1079 /* This code invokes normal driver TX code which is always
1080 * protected from softirqs when called from generic TX code,
1081 * which in turn disables preemption. Look at __dev_queue_xmit
1082 * which uses rcu_read_lock_bh disabling preemption for RCU
1083 * plus disabling softirqs. We do not need RCU reader
1086 * Although it is theoretically safe for current PTP TX/RX code
1087 * running without disabling softirqs, there are three good
1088 * reasond for doing so:
1090 * 1) The code invoked is mainly implemented for non-PTP
1091 * packets and it is always executed with softirqs
1093 * 2) This being a single PTP packet, better to not
1094 * interrupt its processing by softirqs which can lead
1095 * to high latencies.
1096 * 3) netdev_xmit_more checks preemption is disabled and
1097 * triggers a BUG_ON if not.
1100 efx_enqueue_skb(tx_queue, skb);
1103 /* We need to add the filters after enqueuing the packet.
1104 * Otherwise, there's high latency in sending back the
1105 * timestamp, causing ptp4l timeouts
1107 efx_ptp_insert_unicast_filter(efx, skb);
1108 dev_consume_skb_any(skb);
1110 WARN_ONCE(1, "PTP channel has no timestamped tx queue\n");
1111 dev_kfree_skb_any(skb);
1115 /* Transmit a PTP packet, via the MCDI interface, to the wire. */
1116 static void efx_ptp_xmit_skb_mc(struct efx_nic *efx, struct sk_buff *skb)
1118 MCDI_DECLARE_BUF(txtime, MC_CMD_PTP_OUT_TRANSMIT_LEN);
1119 struct efx_ptp_data *ptp_data = efx->ptp_data;
1120 struct skb_shared_hwtstamps timestamps;
1124 MCDI_SET_DWORD(ptp_data->txbuf, PTP_IN_OP, MC_CMD_PTP_OP_TRANSMIT);
1125 MCDI_SET_DWORD(ptp_data->txbuf, PTP_IN_PERIPH_ID, 0);
1126 MCDI_SET_DWORD(ptp_data->txbuf, PTP_IN_TRANSMIT_LENGTH, skb->len);
1127 if (skb_shinfo(skb)->nr_frags != 0) {
1128 rc = skb_linearize(skb);
1133 if (skb->ip_summed == CHECKSUM_PARTIAL) {
1134 rc = skb_checksum_help(skb);
1138 skb_copy_from_linear_data(skb,
1139 MCDI_PTR(ptp_data->txbuf,
1140 PTP_IN_TRANSMIT_PACKET),
1142 rc = efx_mcdi_rpc(efx, MC_CMD_PTP,
1143 ptp_data->txbuf, MC_CMD_PTP_IN_TRANSMIT_LEN(skb->len),
1144 txtime, sizeof(txtime), &len);
1148 memset(×tamps, 0, sizeof(timestamps));
1149 timestamps.hwtstamp = ptp_data->nic_to_kernel_time(
1150 MCDI_DWORD(txtime, PTP_OUT_TRANSMIT_MAJOR),
1151 MCDI_DWORD(txtime, PTP_OUT_TRANSMIT_MINOR),
1152 ptp_data->ts_corrections.ptp_tx);
1154 skb_tstamp_tx(skb, ×tamps);
1156 /* Add the filters after sending back the timestamp to avoid delaying it
1157 * or ptp4l may timeout.
1159 efx_ptp_insert_unicast_filter(efx, skb);
1162 dev_kfree_skb_any(skb);
1167 /* Process any queued receive events and corresponding packets
1169 * q is returned with all the packets that are ready for delivery.
1171 static void efx_ptp_process_events(struct efx_nic *efx, struct sk_buff_head *q)
1173 struct efx_ptp_data *ptp = efx->ptp_data;
1174 struct sk_buff *skb;
1176 while ((skb = skb_dequeue(&ptp->rxq))) {
1177 struct efx_ptp_match *match;
1179 match = (struct efx_ptp_match *)skb->cb;
1180 if (match->state == PTP_PACKET_STATE_MATCH_UNWANTED) {
1181 __skb_queue_tail(q, skb);
1182 } else if (time_after(jiffies, match->expiry)) {
1183 match->state = PTP_PACKET_STATE_TIMED_OUT;
1184 ++ptp->rx_no_timestamp;
1185 __skb_queue_tail(q, skb);
1187 /* Replace unprocessed entry and stop */
1188 skb_queue_head(&ptp->rxq, skb);
1194 /* Complete processing of a received packet */
1195 static inline void efx_ptp_process_rx(struct efx_nic *efx, struct sk_buff *skb)
1198 netif_receive_skb(skb);
1202 static struct efx_ptp_rxfilter *
1203 efx_ptp_find_filter(struct list_head *filter_list, struct efx_filter_spec *spec)
1205 struct efx_ptp_rxfilter *rxfilter;
1207 list_for_each_entry(rxfilter, filter_list, list) {
1208 if (rxfilter->ether_type == spec->ether_type &&
1209 rxfilter->loc_port == spec->loc_port &&
1210 !memcmp(rxfilter->loc_host, spec->loc_host, sizeof(spec->loc_host)))
1217 static void efx_ptp_remove_one_filter(struct efx_nic *efx,
1218 struct efx_ptp_rxfilter *rxfilter)
1220 efx_filter_remove_id_safe(efx, EFX_FILTER_PRI_REQUIRED,
1222 list_del(&rxfilter->list);
1226 static void efx_ptp_remove_filters(struct efx_nic *efx,
1227 struct list_head *filter_list)
1229 struct efx_ptp_rxfilter *rxfilter, *tmp;
1231 list_for_each_entry_safe(rxfilter, tmp, filter_list, list)
1232 efx_ptp_remove_one_filter(efx, rxfilter);
1235 static void efx_ptp_init_filter(struct efx_nic *efx,
1236 struct efx_filter_spec *rxfilter)
1238 struct efx_channel *channel = efx->ptp_data->channel;
1239 struct efx_rx_queue *queue = efx_channel_get_rx_queue(channel);
1241 efx_filter_init_rx(rxfilter, EFX_FILTER_PRI_REQUIRED, 0,
1242 efx_rx_queue_index(queue));
1245 static int efx_ptp_insert_filter(struct efx_nic *efx,
1246 struct list_head *filter_list,
1247 struct efx_filter_spec *spec,
1248 unsigned long expiry)
1250 struct efx_ptp_data *ptp = efx->ptp_data;
1251 struct efx_ptp_rxfilter *rxfilter;
1254 rxfilter = efx_ptp_find_filter(filter_list, spec);
1256 rxfilter->expiry = expiry;
1260 rxfilter = kzalloc(sizeof(*rxfilter), GFP_KERNEL);
1264 rc = efx_filter_insert_filter(efx, spec, true);
1268 rxfilter->handle = rc;
1269 rxfilter->ether_type = spec->ether_type;
1270 rxfilter->loc_port = spec->loc_port;
1271 memcpy(rxfilter->loc_host, spec->loc_host, sizeof(spec->loc_host));
1272 rxfilter->expiry = expiry;
1273 list_add(&rxfilter->list, filter_list);
1275 queue_delayed_work(ptp->workwq, &ptp->cleanup_work,
1276 UCAST_FILTER_EXPIRY_JIFFIES + 1);
1285 static int efx_ptp_insert_ipv4_filter(struct efx_nic *efx,
1286 struct list_head *filter_list,
1287 __be32 addr, u16 port,
1288 unsigned long expiry)
1290 struct efx_filter_spec spec;
1292 efx_ptp_init_filter(efx, &spec);
1293 efx_filter_set_ipv4_local(&spec, IPPROTO_UDP, addr, htons(port));
1294 return efx_ptp_insert_filter(efx, filter_list, &spec, expiry);
1297 static int efx_ptp_insert_ipv6_filter(struct efx_nic *efx,
1298 struct list_head *filter_list,
1299 struct in6_addr *addr, u16 port,
1300 unsigned long expiry)
1302 struct efx_filter_spec spec;
1304 efx_ptp_init_filter(efx, &spec);
1305 efx_filter_set_ipv6_local(&spec, IPPROTO_UDP, addr, htons(port));
1306 return efx_ptp_insert_filter(efx, filter_list, &spec, expiry);
1309 static int efx_ptp_insert_eth_multicast_filter(struct efx_nic *efx)
1311 struct efx_ptp_data *ptp = efx->ptp_data;
1312 const u8 addr[ETH_ALEN] = PTP_ADDR_ETHER;
1313 struct efx_filter_spec spec;
1315 efx_ptp_init_filter(efx, &spec);
1316 efx_filter_set_eth_local(&spec, EFX_FILTER_VID_UNSPEC, addr);
1317 spec.match_flags |= EFX_FILTER_MATCH_ETHER_TYPE;
1318 spec.ether_type = htons(ETH_P_1588);
1319 return efx_ptp_insert_filter(efx, &ptp->rxfilters_mcast, &spec, 0);
1322 static int efx_ptp_insert_multicast_filters(struct efx_nic *efx)
1324 struct efx_ptp_data *ptp = efx->ptp_data;
1327 if (!ptp->channel || !list_empty(&ptp->rxfilters_mcast))
1330 /* Must filter on both event and general ports to ensure
1331 * that there is no packet re-ordering.
1333 rc = efx_ptp_insert_ipv4_filter(efx, &ptp->rxfilters_mcast,
1334 htonl(PTP_ADDR_IPV4), PTP_EVENT_PORT,
1339 rc = efx_ptp_insert_ipv4_filter(efx, &ptp->rxfilters_mcast,
1340 htonl(PTP_ADDR_IPV4), PTP_GENERAL_PORT,
1345 /* if the NIC supports hw timestamps by the MAC, we can support
1346 * PTP over IPv6 and Ethernet
1348 if (efx_ptp_use_mac_tx_timestamps(efx)) {
1349 struct in6_addr ipv6_addr = {{PTP_ADDR_IPV6}};
1351 rc = efx_ptp_insert_ipv6_filter(efx, &ptp->rxfilters_mcast,
1352 &ipv6_addr, PTP_EVENT_PORT, 0);
1356 rc = efx_ptp_insert_ipv6_filter(efx, &ptp->rxfilters_mcast,
1357 &ipv6_addr, PTP_GENERAL_PORT, 0);
1361 rc = efx_ptp_insert_eth_multicast_filter(efx);
1363 /* Not all firmware variants support this filter */
1364 if (rc < 0 && rc != -EPROTONOSUPPORT)
1371 efx_ptp_remove_filters(efx, &ptp->rxfilters_mcast);
1375 static bool efx_ptp_valid_unicast_event_pkt(struct sk_buff *skb)
1377 if (skb->protocol == htons(ETH_P_IP)) {
1378 return ip_hdr(skb)->daddr != htonl(PTP_ADDR_IPV4) &&
1379 ip_hdr(skb)->protocol == IPPROTO_UDP &&
1380 udp_hdr(skb)->source == htons(PTP_EVENT_PORT);
1381 } else if (skb->protocol == htons(ETH_P_IPV6)) {
1382 struct in6_addr mcast_addr = {{PTP_ADDR_IPV6}};
1384 return !ipv6_addr_equal(&ipv6_hdr(skb)->daddr, &mcast_addr) &&
1385 ipv6_hdr(skb)->nexthdr == IPPROTO_UDP &&
1386 udp_hdr(skb)->source == htons(PTP_EVENT_PORT);
1391 static int efx_ptp_insert_unicast_filter(struct efx_nic *efx,
1392 struct sk_buff *skb)
1394 struct efx_ptp_data *ptp = efx->ptp_data;
1395 unsigned long expiry;
1398 if (!efx_ptp_valid_unicast_event_pkt(skb))
1401 expiry = jiffies + UCAST_FILTER_EXPIRY_JIFFIES;
1403 if (skb->protocol == htons(ETH_P_IP)) {
1404 __be32 addr = ip_hdr(skb)->saddr;
1406 rc = efx_ptp_insert_ipv4_filter(efx, &ptp->rxfilters_ucast,
1407 addr, PTP_EVENT_PORT, expiry);
1411 rc = efx_ptp_insert_ipv4_filter(efx, &ptp->rxfilters_ucast,
1412 addr, PTP_GENERAL_PORT, expiry);
1413 } else if (efx_ptp_use_mac_tx_timestamps(efx)) {
1414 /* IPv6 PTP only supported by devices with MAC hw timestamp */
1415 struct in6_addr *addr = &ipv6_hdr(skb)->saddr;
1417 rc = efx_ptp_insert_ipv6_filter(efx, &ptp->rxfilters_ucast,
1418 addr, PTP_EVENT_PORT, expiry);
1422 rc = efx_ptp_insert_ipv6_filter(efx, &ptp->rxfilters_ucast,
1423 addr, PTP_GENERAL_PORT, expiry);
1432 static int efx_ptp_start(struct efx_nic *efx)
1434 struct efx_ptp_data *ptp = efx->ptp_data;
1437 ptp->reset_required = false;
1439 rc = efx_ptp_insert_multicast_filters(efx);
1443 rc = efx_ptp_enable(efx);
1447 ptp->evt_frag_idx = 0;
1448 ptp->current_adjfreq = 0;
1453 efx_ptp_remove_filters(efx, &ptp->rxfilters_mcast);
1457 static int efx_ptp_stop(struct efx_nic *efx)
1459 struct efx_ptp_data *ptp = efx->ptp_data;
1465 rc = efx_ptp_disable(efx);
1467 efx_ptp_remove_filters(efx, &ptp->rxfilters_mcast);
1468 efx_ptp_remove_filters(efx, &ptp->rxfilters_ucast);
1470 /* Make sure RX packets are really delivered */
1471 efx_ptp_deliver_rx_queue(&efx->ptp_data->rxq);
1472 skb_queue_purge(&efx->ptp_data->txq);
1477 static int efx_ptp_restart(struct efx_nic *efx)
1479 if (efx->ptp_data && efx->ptp_data->enabled)
1480 return efx_ptp_start(efx);
1484 static void efx_ptp_pps_worker(struct work_struct *work)
1486 struct efx_ptp_data *ptp =
1487 container_of(work, struct efx_ptp_data, pps_work);
1488 struct efx_nic *efx = ptp->efx;
1489 struct ptp_clock_event ptp_evt;
1491 if (efx_ptp_synchronize(efx, PTP_SYNC_ATTEMPTS))
1494 ptp_evt.type = PTP_CLOCK_PPSUSR;
1495 ptp_evt.pps_times = ptp->host_time_pps;
1496 ptp_clock_event(ptp->phc_clock, &ptp_evt);
1499 static void efx_ptp_worker(struct work_struct *work)
1501 struct efx_ptp_data *ptp_data =
1502 container_of(work, struct efx_ptp_data, work);
1503 struct efx_nic *efx = ptp_data->efx;
1504 struct sk_buff *skb;
1505 struct sk_buff_head tempq;
1507 if (ptp_data->reset_required) {
1513 __skb_queue_head_init(&tempq);
1514 efx_ptp_process_events(efx, &tempq);
1516 while ((skb = skb_dequeue(&ptp_data->txq)))
1517 ptp_data->xmit_skb(efx, skb);
1519 while ((skb = __skb_dequeue(&tempq)))
1520 efx_ptp_process_rx(efx, skb);
1523 static void efx_ptp_cleanup_worker(struct work_struct *work)
1525 struct efx_ptp_data *ptp =
1526 container_of(work, struct efx_ptp_data, cleanup_work.work);
1527 struct efx_ptp_rxfilter *rxfilter, *tmp;
1529 list_for_each_entry_safe(rxfilter, tmp, &ptp->rxfilters_ucast, list) {
1530 if (time_is_before_jiffies(rxfilter->expiry))
1531 efx_ptp_remove_one_filter(ptp->efx, rxfilter);
1534 if (!list_empty(&ptp->rxfilters_ucast)) {
1535 queue_delayed_work(ptp->workwq, &ptp->cleanup_work,
1536 UCAST_FILTER_EXPIRY_JIFFIES + 1);
1540 static const struct ptp_clock_info efx_phc_clock_info = {
1541 .owner = THIS_MODULE,
1549 .adjfine = efx_phc_adjfine,
1550 .adjtime = efx_phc_adjtime,
1551 .gettime64 = efx_phc_gettime,
1552 .settime64 = efx_phc_settime,
1553 .enable = efx_phc_enable,
1556 /* Initialise PTP state. */
1557 int efx_ptp_probe(struct efx_nic *efx, struct efx_channel *channel)
1559 struct efx_ptp_data *ptp;
1562 if (efx->ptp_data) {
1563 efx->ptp_data->channel = channel;
1567 ptp = kzalloc(sizeof(struct efx_ptp_data), GFP_KERNEL);
1568 efx->ptp_data = ptp;
1573 ptp->channel = channel;
1575 rc = efx_nic_alloc_buffer(efx, &ptp->start, sizeof(int), GFP_KERNEL);
1579 skb_queue_head_init(&ptp->rxq);
1580 skb_queue_head_init(&ptp->txq);
1581 ptp->workwq = create_singlethread_workqueue("sfc_ptp");
1587 if (efx_ptp_use_mac_tx_timestamps(efx)) {
1588 ptp->xmit_skb = efx_ptp_xmit_skb_queue;
1589 /* Request sync events on this channel. */
1590 channel->sync_events_state = SYNC_EVENTS_QUIESCENT;
1592 ptp->xmit_skb = efx_ptp_xmit_skb_mc;
1595 INIT_WORK(&ptp->work, efx_ptp_worker);
1596 INIT_DELAYED_WORK(&ptp->cleanup_work, efx_ptp_cleanup_worker);
1597 ptp->config.flags = 0;
1598 ptp->config.tx_type = HWTSTAMP_TX_OFF;
1599 ptp->config.rx_filter = HWTSTAMP_FILTER_NONE;
1600 INIT_LIST_HEAD(&ptp->rxfilters_mcast);
1601 INIT_LIST_HEAD(&ptp->rxfilters_ucast);
1603 /* Get the NIC PTP attributes and set up time conversions */
1604 rc = efx_ptp_get_attributes(efx);
1608 /* Get the timestamp corrections */
1609 rc = efx_ptp_get_timestamp_corrections(efx);
1613 if (efx->mcdi->fn_flags &
1614 (1 << MC_CMD_DRV_ATTACH_EXT_OUT_FLAG_PRIMARY)) {
1615 ptp->phc_clock_info = efx_phc_clock_info;
1616 ptp->phc_clock = ptp_clock_register(&ptp->phc_clock_info,
1617 &efx->pci_dev->dev);
1618 if (IS_ERR(ptp->phc_clock)) {
1619 rc = PTR_ERR(ptp->phc_clock);
1621 } else if (ptp->phc_clock) {
1622 INIT_WORK(&ptp->pps_work, efx_ptp_pps_worker);
1623 ptp->pps_workwq = create_singlethread_workqueue("sfc_pps");
1624 if (!ptp->pps_workwq) {
1630 ptp->nic_ts_enabled = false;
1634 ptp_clock_unregister(efx->ptp_data->phc_clock);
1637 destroy_workqueue(efx->ptp_data->workwq);
1640 efx_nic_free_buffer(efx, &ptp->start);
1643 kfree(efx->ptp_data);
1644 efx->ptp_data = NULL;
1649 /* Initialise PTP channel.
1651 * Setting core_index to zero causes the queue to be initialised and doesn't
1652 * overlap with 'rxq0' because ptp.c doesn't use skb_record_rx_queue.
1654 static int efx_ptp_probe_channel(struct efx_channel *channel)
1656 struct efx_nic *efx = channel->efx;
1659 channel->irq_moderation_us = 0;
1660 channel->rx_queue.core_index = 0;
1662 rc = efx_ptp_probe(efx, channel);
1663 /* Failure to probe PTP is not fatal; this channel will just not be
1664 * used for anything.
1665 * In the case of EPERM, efx_ptp_probe will print its own message (in
1666 * efx_ptp_get_attributes()), so we don't need to.
1668 if (rc && rc != -EPERM)
1669 netif_warn(efx, drv, efx->net_dev,
1670 "Failed to probe PTP, rc=%d\n", rc);
1674 void efx_ptp_remove(struct efx_nic *efx)
1679 (void)efx_ptp_disable(efx);
1681 cancel_work_sync(&efx->ptp_data->work);
1682 cancel_delayed_work_sync(&efx->ptp_data->cleanup_work);
1683 if (efx->ptp_data->pps_workwq)
1684 cancel_work_sync(&efx->ptp_data->pps_work);
1686 skb_queue_purge(&efx->ptp_data->rxq);
1687 skb_queue_purge(&efx->ptp_data->txq);
1689 if (efx->ptp_data->phc_clock) {
1690 destroy_workqueue(efx->ptp_data->pps_workwq);
1691 ptp_clock_unregister(efx->ptp_data->phc_clock);
1694 destroy_workqueue(efx->ptp_data->workwq);
1696 efx_nic_free_buffer(efx, &efx->ptp_data->start);
1697 kfree(efx->ptp_data);
1698 efx->ptp_data = NULL;
1701 static void efx_ptp_remove_channel(struct efx_channel *channel)
1703 efx_ptp_remove(channel->efx);
1706 static void efx_ptp_get_channel_name(struct efx_channel *channel,
1707 char *buf, size_t len)
1709 snprintf(buf, len, "%s-ptp", channel->efx->name);
1712 /* Determine whether this packet should be processed by the PTP module
1713 * or transmitted conventionally.
1715 bool efx_ptp_is_ptp_tx(struct efx_nic *efx, struct sk_buff *skb)
1717 return efx->ptp_data &&
1718 efx->ptp_data->enabled &&
1719 skb->len >= PTP_MIN_LENGTH &&
1720 skb->len <= MC_CMD_PTP_IN_TRANSMIT_PACKET_MAXNUM &&
1721 likely(skb->protocol == htons(ETH_P_IP)) &&
1722 skb_transport_header_was_set(skb) &&
1723 skb_network_header_len(skb) >= sizeof(struct iphdr) &&
1724 ip_hdr(skb)->protocol == IPPROTO_UDP &&
1726 skb_transport_offset(skb) + sizeof(struct udphdr) &&
1727 udp_hdr(skb)->dest == htons(PTP_EVENT_PORT);
1730 /* Receive a PTP packet. Packets are queued until the arrival of
1731 * the receive timestamp from the MC - this will probably occur after the
1732 * packet arrival because of the processing in the MC.
1734 static bool efx_ptp_rx(struct efx_channel *channel, struct sk_buff *skb)
1736 struct efx_nic *efx = channel->efx;
1737 struct efx_ptp_data *ptp = efx->ptp_data;
1738 struct efx_ptp_match *match = (struct efx_ptp_match *)skb->cb;
1739 unsigned int version;
1742 match->expiry = jiffies + msecs_to_jiffies(PKT_EVENT_LIFETIME_MS);
1744 /* Correct version? */
1745 if (ptp->mode == MC_CMD_PTP_MODE_V1) {
1746 if (!pskb_may_pull(skb, PTP_V1_MIN_LENGTH)) {
1750 version = ntohs(*(__be16 *)&data[PTP_V1_VERSION_OFFSET]);
1751 if (version != PTP_VERSION_V1) {
1755 if (!pskb_may_pull(skb, PTP_V2_MIN_LENGTH)) {
1759 version = data[PTP_V2_VERSION_OFFSET];
1760 if ((version & PTP_VERSION_V2_MASK) != PTP_VERSION_V2) {
1765 /* Does this packet require timestamping? */
1766 if (ntohs(*(__be16 *)&data[PTP_DPORT_OFFSET]) == PTP_EVENT_PORT) {
1767 match->state = PTP_PACKET_STATE_UNMATCHED;
1769 /* We expect the sequence number to be in the same position in
1770 * the packet for PTP V1 and V2
1772 BUILD_BUG_ON(PTP_V1_SEQUENCE_OFFSET != PTP_V2_SEQUENCE_OFFSET);
1773 BUILD_BUG_ON(PTP_V1_SEQUENCE_LENGTH != PTP_V2_SEQUENCE_LENGTH);
1775 match->state = PTP_PACKET_STATE_MATCH_UNWANTED;
1778 skb_queue_tail(&ptp->rxq, skb);
1779 queue_work(ptp->workwq, &ptp->work);
1784 /* Transmit a PTP packet. This has to be transmitted by the MC
1785 * itself, through an MCDI call. MCDI calls aren't permitted
1786 * in the transmit path so defer the actual transmission to a suitable worker.
1788 int efx_ptp_tx(struct efx_nic *efx, struct sk_buff *skb)
1790 struct efx_ptp_data *ptp = efx->ptp_data;
1792 skb_queue_tail(&ptp->txq, skb);
1794 if ((udp_hdr(skb)->dest == htons(PTP_EVENT_PORT)) &&
1795 (skb->len <= MC_CMD_PTP_IN_TRANSMIT_PACKET_MAXNUM))
1796 efx_xmit_hwtstamp_pending(skb);
1797 queue_work(ptp->workwq, &ptp->work);
1799 return NETDEV_TX_OK;
1802 int efx_ptp_get_mode(struct efx_nic *efx)
1804 return efx->ptp_data->mode;
1807 int efx_ptp_change_mode(struct efx_nic *efx, bool enable_wanted,
1808 unsigned int new_mode)
1810 if ((enable_wanted != efx->ptp_data->enabled) ||
1811 (enable_wanted && (efx->ptp_data->mode != new_mode))) {
1814 if (enable_wanted) {
1815 /* Change of mode requires disable */
1816 if (efx->ptp_data->enabled &&
1817 (efx->ptp_data->mode != new_mode)) {
1818 efx->ptp_data->enabled = false;
1819 rc = efx_ptp_stop(efx);
1824 /* Set new operating mode and establish
1825 * baseline synchronisation, which must
1828 efx->ptp_data->mode = new_mode;
1829 if (netif_running(efx->net_dev))
1830 rc = efx_ptp_start(efx);
1832 rc = efx_ptp_synchronize(efx,
1833 PTP_SYNC_ATTEMPTS * 2);
1838 rc = efx_ptp_stop(efx);
1844 efx->ptp_data->enabled = enable_wanted;
1850 static int efx_ptp_ts_init(struct efx_nic *efx, struct hwtstamp_config *init)
1854 if ((init->tx_type != HWTSTAMP_TX_OFF) &&
1855 (init->tx_type != HWTSTAMP_TX_ON))
1858 rc = efx->type->ptp_set_ts_config(efx, init);
1862 efx->ptp_data->config = *init;
1866 void efx_ptp_get_ts_info(struct efx_nic *efx, struct ethtool_ts_info *ts_info)
1868 struct efx_ptp_data *ptp = efx->ptp_data;
1869 struct efx_nic *primary = efx->primary;
1876 ts_info->so_timestamping |= (SOF_TIMESTAMPING_TX_HARDWARE |
1877 SOF_TIMESTAMPING_RX_HARDWARE |
1878 SOF_TIMESTAMPING_RAW_HARDWARE);
1879 /* Check licensed features. If we don't have the license for TX
1880 * timestamps, the NIC will not support them.
1882 if (efx_ptp_use_mac_tx_timestamps(efx)) {
1883 struct efx_ef10_nic_data *nic_data = efx->nic_data;
1885 if (!(nic_data->licensed_features &
1886 (1 << LICENSED_V3_FEATURES_TX_TIMESTAMPS_LBN)))
1887 ts_info->so_timestamping &=
1888 ~SOF_TIMESTAMPING_TX_HARDWARE;
1890 if (primary && primary->ptp_data && primary->ptp_data->phc_clock)
1891 ts_info->phc_index =
1892 ptp_clock_index(primary->ptp_data->phc_clock);
1893 ts_info->tx_types = 1 << HWTSTAMP_TX_OFF | 1 << HWTSTAMP_TX_ON;
1894 ts_info->rx_filters = ptp->efx->type->hwtstamp_filters;
1897 int efx_ptp_set_ts_config(struct efx_nic *efx, struct ifreq *ifr)
1899 struct hwtstamp_config config;
1902 /* Not a PTP enabled port */
1906 if (copy_from_user(&config, ifr->ifr_data, sizeof(config)))
1909 rc = efx_ptp_ts_init(efx, &config);
1913 return copy_to_user(ifr->ifr_data, &config, sizeof(config))
1917 int efx_ptp_get_ts_config(struct efx_nic *efx, struct ifreq *ifr)
1922 return copy_to_user(ifr->ifr_data, &efx->ptp_data->config,
1923 sizeof(efx->ptp_data->config)) ? -EFAULT : 0;
1926 static void ptp_event_failure(struct efx_nic *efx, int expected_frag_len)
1928 struct efx_ptp_data *ptp = efx->ptp_data;
1930 netif_err(efx, hw, efx->net_dev,
1931 "PTP unexpected event length: got %d expected %d\n",
1932 ptp->evt_frag_idx, expected_frag_len);
1933 ptp->reset_required = true;
1934 queue_work(ptp->workwq, &ptp->work);
1937 static void ptp_event_fault(struct efx_nic *efx, struct efx_ptp_data *ptp)
1939 int code = EFX_QWORD_FIELD(ptp->evt_frags[0], MCDI_EVENT_DATA);
1940 if (ptp->evt_frag_idx != 1) {
1941 ptp_event_failure(efx, 1);
1945 netif_err(efx, hw, efx->net_dev, "PTP error %d\n", code);
1948 static void ptp_event_pps(struct efx_nic *efx, struct efx_ptp_data *ptp)
1950 if (ptp->nic_ts_enabled)
1951 queue_work(ptp->pps_workwq, &ptp->pps_work);
1954 void efx_ptp_event(struct efx_nic *efx, efx_qword_t *ev)
1956 struct efx_ptp_data *ptp = efx->ptp_data;
1957 int code = EFX_QWORD_FIELD(*ev, MCDI_EVENT_CODE);
1960 if (!efx->ptp_warned) {
1961 netif_warn(efx, drv, efx->net_dev,
1962 "Received PTP event but PTP not set up\n");
1963 efx->ptp_warned = true;
1971 if (ptp->evt_frag_idx == 0) {
1972 ptp->evt_code = code;
1973 } else if (ptp->evt_code != code) {
1974 netif_err(efx, hw, efx->net_dev,
1975 "PTP out of sequence event %d\n", code);
1976 ptp->evt_frag_idx = 0;
1979 ptp->evt_frags[ptp->evt_frag_idx++] = *ev;
1980 if (!MCDI_EVENT_FIELD(*ev, CONT)) {
1981 /* Process resulting event */
1983 case MCDI_EVENT_CODE_PTP_FAULT:
1984 ptp_event_fault(efx, ptp);
1986 case MCDI_EVENT_CODE_PTP_PPS:
1987 ptp_event_pps(efx, ptp);
1990 netif_err(efx, hw, efx->net_dev,
1991 "PTP unknown event %d\n", code);
1994 ptp->evt_frag_idx = 0;
1995 } else if (MAX_EVENT_FRAGS == ptp->evt_frag_idx) {
1996 netif_err(efx, hw, efx->net_dev,
1997 "PTP too many event fragments\n");
1998 ptp->evt_frag_idx = 0;
2002 void efx_time_sync_event(struct efx_channel *channel, efx_qword_t *ev)
2004 struct efx_nic *efx = channel->efx;
2005 struct efx_ptp_data *ptp = efx->ptp_data;
2007 /* When extracting the sync timestamp minor value, we should discard
2008 * the least significant two bits. These are not required in order
2009 * to reconstruct full-range timestamps and they are optionally used
2010 * to report status depending on the options supplied when subscribing
2013 channel->sync_timestamp_major = MCDI_EVENT_FIELD(*ev, PTP_TIME_MAJOR);
2014 channel->sync_timestamp_minor =
2015 (MCDI_EVENT_FIELD(*ev, PTP_TIME_MINOR_MS_8BITS) & 0xFC)
2016 << ptp->nic_time.sync_event_minor_shift;
2018 /* if sync events have been disabled then we want to silently ignore
2019 * this event, so throw away result.
2021 (void) cmpxchg(&channel->sync_events_state, SYNC_EVENTS_REQUESTED,
2025 static inline u32 efx_rx_buf_timestamp_minor(struct efx_nic *efx, const u8 *eh)
2027 #if defined(CONFIG_HAVE_EFFICIENT_UNALIGNED_ACCESS)
2028 return __le32_to_cpup((const __le32 *)(eh + efx->rx_packet_ts_offset));
2030 const u8 *data = eh + efx->rx_packet_ts_offset;
2031 return (u32)data[0] |
2033 (u32)data[2] << 16 |
2038 void __efx_rx_skb_attach_timestamp(struct efx_channel *channel,
2039 struct sk_buff *skb)
2041 struct efx_nic *efx = channel->efx;
2042 struct efx_ptp_data *ptp = efx->ptp_data;
2043 u32 pkt_timestamp_major, pkt_timestamp_minor;
2045 struct skb_shared_hwtstamps *timestamps;
2047 if (channel->sync_events_state != SYNC_EVENTS_VALID)
2050 pkt_timestamp_minor = efx_rx_buf_timestamp_minor(efx, skb_mac_header(skb));
2052 /* get the difference between the packet and sync timestamps,
2055 diff = pkt_timestamp_minor - channel->sync_timestamp_minor;
2056 if (pkt_timestamp_minor < channel->sync_timestamp_minor)
2057 diff += ptp->nic_time.minor_max;
2059 /* do we roll over a second boundary and need to carry the one? */
2060 carry = (channel->sync_timestamp_minor >= ptp->nic_time.minor_max - diff) ?
2063 if (diff <= ptp->nic_time.sync_event_diff_max) {
2064 /* packet is ahead of the sync event by a quarter of a second or
2065 * less (allowing for fuzz)
2067 pkt_timestamp_major = channel->sync_timestamp_major + carry;
2068 } else if (diff >= ptp->nic_time.sync_event_diff_min) {
2069 /* packet is behind the sync event but within the fuzz factor.
2070 * This means the RX packet and sync event crossed as they were
2071 * placed on the event queue, which can sometimes happen.
2073 pkt_timestamp_major = channel->sync_timestamp_major - 1 + carry;
2075 /* it's outside tolerance in both directions. this might be
2076 * indicative of us missing sync events for some reason, so
2077 * we'll call it an error rather than risk giving a bogus
2080 netif_vdbg(efx, drv, efx->net_dev,
2081 "packet timestamp %x too far from sync event %x:%x\n",
2082 pkt_timestamp_minor, channel->sync_timestamp_major,
2083 channel->sync_timestamp_minor);
2087 /* attach the timestamps to the skb */
2088 timestamps = skb_hwtstamps(skb);
2089 timestamps->hwtstamp =
2090 ptp->nic_to_kernel_time(pkt_timestamp_major,
2091 pkt_timestamp_minor,
2092 ptp->ts_corrections.general_rx);
2095 static int efx_phc_adjfine(struct ptp_clock_info *ptp, long scaled_ppm)
2097 struct efx_ptp_data *ptp_data = container_of(ptp,
2098 struct efx_ptp_data,
2100 s32 delta = scaled_ppm_to_ppb(scaled_ppm);
2101 struct efx_nic *efx = ptp_data->efx;
2102 MCDI_DECLARE_BUF(inadj, MC_CMD_PTP_IN_ADJUST_LEN);
2106 if (delta > MAX_PPB)
2108 else if (delta < -MAX_PPB)
2111 /* Convert ppb to fixed point ns taking care to round correctly. */
2112 adjustment_ns = ((s64)delta * PPB_SCALE_WORD +
2113 (1 << (ptp_data->adjfreq_ppb_shift - 1))) >>
2114 ptp_data->adjfreq_ppb_shift;
2116 MCDI_SET_DWORD(inadj, PTP_IN_OP, MC_CMD_PTP_OP_ADJUST);
2117 MCDI_SET_DWORD(inadj, PTP_IN_PERIPH_ID, 0);
2118 MCDI_SET_QWORD(inadj, PTP_IN_ADJUST_FREQ, adjustment_ns);
2119 MCDI_SET_DWORD(inadj, PTP_IN_ADJUST_SECONDS, 0);
2120 MCDI_SET_DWORD(inadj, PTP_IN_ADJUST_NANOSECONDS, 0);
2121 rc = efx_mcdi_rpc(efx, MC_CMD_PTP, inadj, sizeof(inadj),
2126 ptp_data->current_adjfreq = adjustment_ns;
2130 static int efx_phc_adjtime(struct ptp_clock_info *ptp, s64 delta)
2132 u32 nic_major, nic_minor;
2133 struct efx_ptp_data *ptp_data = container_of(ptp,
2134 struct efx_ptp_data,
2136 struct efx_nic *efx = ptp_data->efx;
2137 MCDI_DECLARE_BUF(inbuf, MC_CMD_PTP_IN_ADJUST_LEN);
2139 efx->ptp_data->ns_to_nic_time(delta, &nic_major, &nic_minor);
2141 MCDI_SET_DWORD(inbuf, PTP_IN_OP, MC_CMD_PTP_OP_ADJUST);
2142 MCDI_SET_DWORD(inbuf, PTP_IN_PERIPH_ID, 0);
2143 MCDI_SET_QWORD(inbuf, PTP_IN_ADJUST_FREQ, ptp_data->current_adjfreq);
2144 MCDI_SET_DWORD(inbuf, PTP_IN_ADJUST_MAJOR, nic_major);
2145 MCDI_SET_DWORD(inbuf, PTP_IN_ADJUST_MINOR, nic_minor);
2146 return efx_mcdi_rpc(efx, MC_CMD_PTP, inbuf, sizeof(inbuf),
2150 static int efx_phc_gettime(struct ptp_clock_info *ptp, struct timespec64 *ts)
2152 struct efx_ptp_data *ptp_data = container_of(ptp,
2153 struct efx_ptp_data,
2155 struct efx_nic *efx = ptp_data->efx;
2156 MCDI_DECLARE_BUF(inbuf, MC_CMD_PTP_IN_READ_NIC_TIME_LEN);
2157 MCDI_DECLARE_BUF(outbuf, MC_CMD_PTP_OUT_READ_NIC_TIME_LEN);
2161 MCDI_SET_DWORD(inbuf, PTP_IN_OP, MC_CMD_PTP_OP_READ_NIC_TIME);
2162 MCDI_SET_DWORD(inbuf, PTP_IN_PERIPH_ID, 0);
2164 rc = efx_mcdi_rpc(efx, MC_CMD_PTP, inbuf, sizeof(inbuf),
2165 outbuf, sizeof(outbuf), NULL);
2169 kt = ptp_data->nic_to_kernel_time(
2170 MCDI_DWORD(outbuf, PTP_OUT_READ_NIC_TIME_MAJOR),
2171 MCDI_DWORD(outbuf, PTP_OUT_READ_NIC_TIME_MINOR), 0);
2172 *ts = ktime_to_timespec64(kt);
2176 static int efx_phc_settime(struct ptp_clock_info *ptp,
2177 const struct timespec64 *e_ts)
2179 /* Get the current NIC time, efx_phc_gettime.
2180 * Subtract from the desired time to get the offset
2181 * call efx_phc_adjtime with the offset
2184 struct timespec64 time_now;
2185 struct timespec64 delta;
2187 rc = efx_phc_gettime(ptp, &time_now);
2191 delta = timespec64_sub(*e_ts, time_now);
2193 rc = efx_phc_adjtime(ptp, timespec64_to_ns(&delta));
2200 static int efx_phc_enable(struct ptp_clock_info *ptp,
2201 struct ptp_clock_request *request,
2204 struct efx_ptp_data *ptp_data = container_of(ptp,
2205 struct efx_ptp_data,
2207 if (request->type != PTP_CLK_REQ_PPS)
2210 ptp_data->nic_ts_enabled = !!enable;
2214 static const struct efx_channel_type efx_ptp_channel_type = {
2215 .handle_no_channel = efx_ptp_handle_no_channel,
2216 .pre_probe = efx_ptp_probe_channel,
2217 .post_remove = efx_ptp_remove_channel,
2218 .get_name = efx_ptp_get_channel_name,
2219 .copy = efx_copy_channel,
2220 .receive_skb = efx_ptp_rx,
2221 .want_txqs = efx_ptp_want_txqs,
2222 .keep_eventq = false,
2225 void efx_ptp_defer_probe_with_channel(struct efx_nic *efx)
2227 /* Check whether PTP is implemented on this NIC. The DISABLE
2228 * operation will succeed if and only if it is implemented.
2230 if (efx_ptp_disable(efx) == 0)
2231 efx->extra_channel_type[EFX_EXTRA_CHANNEL_PTP] =
2232 &efx_ptp_channel_type;
2235 void efx_ptp_start_datapath(struct efx_nic *efx)
2237 if (efx_ptp_restart(efx))
2238 netif_err(efx, drv, efx->net_dev, "Failed to restart PTP.\n");
2239 /* re-enable timestamping if it was previously enabled */
2240 if (efx->type->ptp_set_ts_sync_events)
2241 efx->type->ptp_set_ts_sync_events(efx, true, true);
2244 void efx_ptp_stop_datapath(struct efx_nic *efx)
2246 /* temporarily disable timestamping */
2247 if (efx->type->ptp_set_ts_sync_events)
2248 efx->type->ptp_set_ts_sync_events(efx, false, true);