Patchset enabling hardware based cross-timestamps for next gen Intel platforms
Subsystems (6)
v2 cover Patchset enabling hardware based cross-timestamps for next gen Intel platforms
6th generation Intel platforms will have an Always Running Timer (ART) that always runs when the system is powered and is available to both the CPU and various on-board devices. Initially, those devices include audio and network. The ART will give these devices the capability of precisely cross timestamping their local device clock with the system clock.
A system clock value like TSC or ART is not useful unless translated to system time. The first *two* patches enable this by changing the timekeeping code to return a system time given a system clock value and translating ART to TSC.
The last two patches modify the PTP driver to call a cross timestamp function in the driver when available and perform the cross timestamp in the e1000e driver.
Given the precise relationship between the network device clock and system time enables better synchronization of events on multiple network connected devices.
Changelog:
* The PTP portion of the patch set was posted 7/8/2015 (v3) and rejected because of there wasn't a driver that implemented the new API. Now, the driver patch is added and the PTP patch operation is modified to revert to previous behavior when cross timestamp can't be completed. This is indicated by the driver returning a non-zero value.
* v2 re-submit based on tglx provided correlated clocksource patch. This has been included verbatim as the first patch in the series. Additions and modifications are in the second patch. The PTP driver patch is unchanged and the e1000e driver patch uses the *new* correlated clocksource interface but is otherwise (in terms of hardware and PTP driver) unchanged.
* ART is removed as a compile option
* ART is added as an X86_FEATURE
Christopher Hall (4):
Add generic correlated clocksource code and ART to TSC conversion code Add ART initialization code
Add support for driver cross-timestamp to PTP_SYS_OFFSET ioctl Added getsynctime64() callback
Documentation/ptp/testptp.c | 6 +- arch/x86/include/asm/cpufeature.h | 3 +- arch/x86/include/asm/tsc.h | 1 + arch/x86/kernel/tsc.c | 45 +++++++++++++++ drivers/net/ethernet/intel/e1000e/defines.h | 7 +++ drivers/net/ethernet/intel/e1000e/ptp.c | 88 +++++++++++++++++++++++++++++ drivers/net/ethernet/intel/e1000e/regs.h | 4 ++ drivers/ptp/ptp_chardev.c | 29 +++++++--- include/linux/clocksource.h | 32 +++++++++++ include/linux/ptp_clock_kernel.h | 7 +++ include/linux/timekeeping.h | 4 ++ include/uapi/linux/ptp_clock.h | 4 +- kernel/time/timekeeping.c | 64 +++++++++++++++++++++ 13 files changed, 282 insertions(+), 12 deletions(-)
Signature · 1 line
1.9.1
PATCH v2 1/4 Add generic correlated clocksource code and ART to TSC conversion code
Original patch description:
Subject: ptp: Get sync timestamps
From: Thomas Gleixner <[email protected]>
Date: Wed, 29 Jul 2015 10:52:06 +0200
The ART stuff wants to be splitted out.
======== Changes =======
Add struct correlated_cs (clocksource) with pointer to original clocksource
and function pointer to convert correlated clocksource to the original
Add struct correlated_ts (timestamp) with function pointer to read correlated
clocksource, device and system (in terms of correlated clocksource) counter values (input) with resulting converted real and monotonic raw system times (output)
Add get_correlated_timestamp() function which given specific correlated_cs
and correlated_ts convert correlated counter value to system time
Add art_to_tsc conversion function translated Always Running Timer (ART) to
TSC value
--- arch/x86/kernel/tsc.c | 31 ++++++++++++++++++++++ include/linux/clocksource.h | 30 +++++++++++++++++++++ include/linux/timekeeping.h | 4 +++ kernel/time/timekeeping.c | 63 +++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 128 insertions(+)
arch/x86/kernel/tsc.c +31 -0
@@ -1059,6 +1059,27 @@ int unsynchronized_tsc(void)return 0 ; } +static u32 tsc_numerator; +static u32 tsc_denominator; +/* +* CHECKME: Do we need the adjust value? It should be 0, but if we run +* in a VM this might be a different story. +*/ +static u64 tsc_adjust; + +static u64 art_to_tsc (u64 cycles) +{ +u64 tmp, res = tsc_adjust; + + res += (cycles / tsc_denominator) * tsc_numerator; + tmp = (cycles % tsc_denominator) * tsc_numerator; + res += tmp / tsc_denominator; +return res; +} + +struct correlated_cs art_timestamper = { + .convert = art_to_tsc, +};static void tsc_refine_calibration_work (struct work_struct *work); static DECLARE_DELAYED_WORK(tsc_irqwork, tsc_refine_calibration_work);
@@ -1129,6 +1150,16 @@ static void tsc_refine_calibration_work(struct work_struct *work) (unsigned long )tsc_khz /1000 , (unsigned long)tsc_khz % 1000); +/* +* TODO: +* +* If the system has ART, initialize the art_to_tsc conversion +* and set: art_timestamp.related_cs = &tsc_clocksource. +* +* Before that point a call to get_correlated_timestamp will +* fail the clocksource match check. +*/ + out:clocksource_register_khz (&clocksource_tsc, tsc_khz); }
include/linux/clocksource.h +30 -0
@@ -258,4 +258,34 @@ void acpi_generic_timer_init(void);static inline void acpi_generic_timer_init (void ) { }#endif +/** +* struct correlated_cs - Descriptor for a clocksource correlated to another clocksource +* @related_cs: Pointer to the related timekeeping clocksource +* @convert: Conversion function to convert a timestamp from +* the correlated clocksource to cycles of the related +* timekeeping clocksource +*/ +struct correlated_cs { +struct clocksource *related_cs; +u64 (*convert)(u64 cycles); +}; + +struct correlated_ts ; + +/** +* struct correlated_ts - Descriptor for taking a correlated time stamp +* @get_ts: Function to read out a synced system and device +* timestamp +* @system_ts: The raw system clock timestamp +* @device_ts: The raw device timestamp +* @system_real: @system_ts converted to CLOCK_REALTIME +* @system_raw: @system_ts converted to CLOCK_MONOTONIC_RAW +*/ +struct correlated_ts { +int (*get_ts)(struct correlated_ts *ts); +u64 system_ts; +u64 device_ts; +u64 system_real; +u64 system_raw; +};#endif /* _LINUX_CLOCKSOURCE_H */
include/linux/timekeeping.h +4 -0
@@ -258,6 +258,10 @@ extern void timekeeping_inject_sleeptime64(struct timespec64 *delta);*/ extern void getnstime_raw_and_real (struct timespec *ts_raw,struct timespec *ts_real); +struct correlated_ts ; +struct correlated_cs ; +extern int get_correlated_timestamp (struct correlated_ts *crt, +struct correlated_cs *crs);/* * Persistent clock related interfaces
kernel/time/timekeeping.c +63 -0
75 lines not on this page · raw message
Signature · 1 line
1.9.1
PATCH v2 2/4 Add ART initialization code
In reply to Christopher Halladd private struct correlated_ts member used by get_ts() code
added EXPORTs making get_correlated_timestamp() function and
art_timestamper accessible
Add special case for denominator of 2 (art_to_tsc())
--- arch/x86/include/asm/cpufeature.h | 3 ++- arch/x86/include/asm/tsc.h | 1 + arch/x86/kernel/tsc.c | 42 ++++++++++++++++++++++++++------------- include/linux/clocksource.h | 8 +++++--- kernel/time/timekeeping.c | 1 + 5 files changed, 37 insertions(+), 18 deletions(-)
arch/x86/include/asm/cpufeature.h +2 -1
@@ -85,7 +85,7 @@#define X86_FEATURE_P4 ( 3*32+ 7)/* "" P4 */ #define X86_FEATURE_CONSTANT_TSC ( 3*32+ 8)/* TSC ticks at a constant rate */ #define X86_FEATURE_UP ( 3*32+ 9)/* smp kernel running on up */ -/* free, was #define X86_FEATURE_FXSAVE_LEAK ( 3*32+10) * "" FXSAVE leaks FOP/FIP/FOP */ +#define X86_FEATURE_ART (3*32+10)/* Platform has always running timer (ART) */ #define X86_FEATURE_ARCH_PERFMON ( 3*32+11)/* Intel Architectural PerfMon */ #define X86_FEATURE_PEBS ( 3*32+12)/* Precise-Event Based Sampling */ #define X86_FEATURE_BTS ( 3*32+13)/* Branch Trace Store */
@@ -352,6 +352,7 @@ extern const char * const x86_bug_flags[NBUGINTS*32];#define cpu_has_de boot_cpu_has(X86_FEATURE_DE)#define cpu_has_pse boot_cpu_has(X86_FEATURE_PSE)#define cpu_has_tsc boot_cpu_has(X86_FEATURE_TSC) +#define cpu_has_art boot_cpu_has(X86_FEATURE_ART)#define cpu_has_pge boot_cpu_has(X86_FEATURE_PGE)#define cpu_has_apic boot_cpu_has(X86_FEATURE_APIC)#define cpu_has_sep boot_cpu_has(X86_FEATURE_SEP)
arch/x86/include/asm/tsc.h +1 -0
@@ -53,6 +53,7 @@ extern int check_tsc_disabled(void);extern unsigned long native_calibrate_tsc (void );extern int tsc_clocksource_reliable; +extern struct correlated_cs art_timestamper;/* * Boot-time check whether the TSCs are synchronized across
arch/x86/kernel/tsc.c +28 -14
76 lines not on this page · raw message
include/linux/clocksource.h +5 -3
@@ -267,7 +267,8 @@ static inline void acpi_generic_timer_init(void) { }*/ struct correlated_cs {struct clocksource *related_cs; -u64 (*convert)(u64 cycles); +u64 (*convert)(struct correlated_cs *cs, +u64 cycles); };struct correlated_ts ;
@@ -285,7 +286,8 @@ struct correlated_ts {int (*get_ts)(struct correlated_ts *ts);u64 system_ts;u64 device_ts; -u64 system_real; - u64 system_raw; +ktime_t system_real; +ktime_t system_raw; + void *private; };#endif /* _LINUX_CLOCKSOURCE_H */
kernel/time/timekeeping.c +1 -0
@@ -946,6 +946,7 @@ int get_correlated_timestamp(struct correlated_ts *crt, }while (read_seqcount_retry (&tk_core.seq, seq));return 0 ; } +EXPORT_SYMBOL (get_correlated_timestamp);/** * do_gettimeofday - Returns the time of day in a timeval
Signature · 1 line
1.9.1
PATCH v2 3/4 Add support for driver cross-timestamp to PTP_SYS_OFFSET ioctl
In reply to Christopher HallThis patch allows system and device time ("cross-timestamp") to be performed by the driver. Currently, the cross-timestamping is performed in the PTP_SYS_OFFSET ioctl. The PTP clock driver reads gettimeofday() and the gettime64() callback provided by the driver. The cross-timestamp is best effort where the latency between the capture of system time (getnstimeofday()) and the device time (driver callback) may be significant.
This patch adds an additional callback getsynctime64(). Which will be called when the driver is able to perform a more accurate, implementation specific cross-timestamping. For example, future network devices that implement PCIE PTM will be able to precisely correlate the device clock with the system clock with virtually zero latency between captures. This added callback can be used by the driver to expose this functionality.
The callback, getsynctime64(), will only be called when defined and n_samples == 1 because the driver returns only 1 cross-timestamp where multiple samples cannot be chained together.
This patch also adds to the capabilities ioctl (PTP_CLOCK_GETCAPS), allowing applications to query whether or not drivers implement the getsynctime callback, providing more precise cross timestamping.
Commit Details:
Added additional callback to ptp_clock_info:
* getsynctime64()
This takes 2 arguments referring to system and device time
With this callback drivers may provide both system time and device time to ensure precise correlation
Modified PTP_SYS_OFFSET ioctl in PTP clock driver to use the above callback if it's available
Added capability (PTP_CLOCK_GETCAPS) for checking whether driver supports cross timestamping
Added check for cross timestamping flag to testptp.c
--- Documentation/ptp/testptp.c | 6 ++++-- drivers/ptp/ptp_chardev.c | 29 +++++++++++++++++++++-------- include/linux/ptp_clock_kernel.h | 7 +++++++ include/uapi/linux/ptp_clock.h | 4 +++- 4 files changed, 35 insertions(+), 11 deletions(-)
Documentation/ptp/testptp.c +4 -2
@@ -276,13 +276,15 @@ int main(int argc, char *argv[])" %d external time stamp channels\n" " %d programmable periodic signals\n" " %d pulse per second\n" -" %d programmable pins\n" , +" %d programmable pins\n" +" %d cross timestamping\n" , caps.max_adj, caps.n_alarm, caps.n_ext_ts, caps.n_per_out, caps.pps, - caps.n_pins); + caps.n_pins, + caps.cross_timestamping); } }
drivers/ptp/ptp_chardev.c +21 -8
@@ -124,7 +124,7 @@ long ptp_ioctl(struct posix_clock *pc, unsigned int cmd, unsigned long arg) struct ptp_clock *ptp = container_of(pc, struct ptp_clock, clock);struct ptp_clock_info *ops = ptp->info;struct ptp_clock_time *pct; -struct timespec64 ts; +struct timespec64 ts, systs;int enable, err =0 ;unsigned int i, pin_index;
@@ -138,6 +138,7 @@ long ptp_ioctl(struct posix_clock *pc, unsigned int cmd, unsigned long arg) caps.n_per_out = ptp->info->n_per_out; caps.pps = ptp->info->pps; caps.n_pins = ptp->info->n_pins; + caps.cross_timestamping = ptp->info->getsynctime64 !=NULL ;if (copy_to_user ((void __user *)arg, &caps,sizeof (caps))) err = -EFAULT ;break ;
@@ -196,19 +197,31 @@ long ptp_ioctl(struct posix_clock *pc, unsigned int cmd, unsigned long arg)break ; } pct = &sysoff->ts[0 ]; -for (i =0 ; i < sysoff->n_samples; i++) { -getnstimeofday64 (&ts); +if (ptp->info->getsynctime64 && sysoff->n_samples ==1 && + ptp->info->getsynctime64 (ptp->info, &ts, &systs) ==0 ) { + pct->sec = systs.tv_sec; + pct->nsec = systs.tv_nsec; + pct++; pct->sec = ts.tv_sec; pct->nsec = ts.tv_nsec; pct++; - ptp->info->gettime64 (ptp->info, &ts); + pct->sec = systs.tv_sec; + pct->nsec = systs.tv_nsec; + }else { +for (i =0 ; i < sysoff->n_samples; i++) { +getnstimeofday64 (&ts); + pct->sec = ts.tv_sec; + pct->nsec = ts.tv_nsec; + pct++; + ptp->info->gettime64 (ptp->info, &ts); + pct->sec = ts.tv_sec; + pct->nsec = ts.tv_nsec; + pct++; + } +getnstimeofday64 (&ts); pct->sec = ts.tv_sec; pct->nsec = ts.tv_nsec; - pct++; } -getnstimeofday64 (&ts); - pct->sec = ts.tv_sec; - pct->nsec = ts.tv_nsec;if (copy_to_user ((void __user *)arg, sysoff,sizeof (*sysoff))) err = -EFAULT ;break ;
include/linux/ptp_clock_kernel.h +7 -0
@@ -67,6 +67,11 @@ struct ptp_clock_request {* @gettime64: Reads the current time from the hardware clock. * parameter ts: Holds the result. * +* @getsynctime64: Reads the current time from the hardware clock and system +* clock simultaneously. +* parameter dev: Holds the device time +* parameter sys: Holds the system time +* * @settime64: Set the current time on the hardware clock. * parameter ts: Time value to set. *
@@ -105,6 +110,8 @@ struct ptp_clock_info {int (*adjfreq)(struct ptp_clock_info *ptp,s32 delta);int (*adjtime)(struct ptp_clock_info *ptp,s64 delta);int (*gettime64)(struct ptp_clock_info *ptp,struct timespec64 *ts); +int (*getsynctime64)(struct ptp_clock_info *ptp,struct timespec64 *dev, +struct timespec64 *sys);int (*settime64)(struct ptp_clock_info *p,const struct timespec64 *ts);int (*enable)(struct ptp_clock_info *ptp,struct ptp_clock_request *request,int on);
include/uapi/linux/ptp_clock.h +3 -1
@@ -51,7 +51,9 @@ struct ptp_clock_caps {int n_per_out;/* Number of programmable periodic signals. */ int pps;/* Whether the clock supports a PPS callback. */ int n_pins;/* Number of input/output pins. */ -int rsv[14 ];/* Reserved for future use. */ +/* Whether the clock supports precise system-device cross timestamps */ +int cross_timestamping; +int rsv[13 ];/* Reserved for future use. */ };struct ptp_extts_request {
Signature · 1 line
1.9.1
PATCH v2 4/4 Added getsynctime64() callback
In reply to Christopher HallReads ART (TSC correlated clocksource), converts to realtime clock, and
reports cross timestamp to PTP driver
--- drivers/net/ethernet/intel/e1000e/defines.h | 7 +++ drivers/net/ethernet/intel/e1000e/ptp.c | 88 +++++++++++++++++++++++++++++ drivers/net/ethernet/intel/e1000e/regs.h | 4 ++ 3 files changed, 99 insertions(+)
drivers/net/ethernet/intel/e1000e/defines.h +7 -0
@@ -527,6 +527,13 @@#define E1000_RXCW_C 0x20000000/* Receive config */ #define E1000_RXCW_SYNCH 0x40000000/* Receive config synch */ +/* HH Time Sync */ +#define E1000_TSYNCTXCTL_MAX_ALLOWED_DLY_MASK 0x0000F000/* max delay */ +#define E1000_TSYNCTXCTL_SYNC_COMP 0x40000000/* sync complete +*/ +#define E1000_TSYNCTXCTL_START_SYNC 0x80000000/* initiate sync +*/ +#define E1000_TSYNCTXCTL_VALID 0x00000001/* Tx timestamp valid */ #define E1000_TSYNCTXCTL_ENABLED 0x00000010/* enable Tx timestamping */
drivers/net/ethernet/intel/e1000e/ptp.c +88 -0
106 lines not on this page · raw message
drivers/net/ethernet/intel/e1000e/regs.h +4 -0
@@ -246,6 +246,10 @@#define E1000_SYSTIML 0x0B600/* System time register Low - RO */ #define E1000_SYSTIMH 0x0B604/* System time register High - RO */ #define E1000_TIMINCA 0x0B608/* Increment attributes register - RW */ +#define E1000_SYSSTMPL 0x0B648/* HH Timesync system stamp low register */ +#define E1000_SYSSTMPH 0x0B64C/* HH Timesync system stamp hi register */ +#define E1000_PLTSTMPL 0x0B640/* HH Timesync platform stamp low register */ +#define E1000_PLTSTMPH 0x0B644/* HH Timesync platform stamp hi register */ #define E1000_RXMTRL 0x0B634/* Time sync Rx EtherType and Msg Type - RW */ #define E1000_RXUDP 0x0B638/* Time Sync Rx UDP Port - RW */
Signature · 1 line
1.9.1