Add SOF_TIMESTAMPING_TX_COMPLETION, for requesting a software timestamp when hardware reports a packet completed. Completion tstamp is useful for Bluetooth, as hardware timestamps do not exist in the HCI specification except for ISO packets, and the hardware has a queue where packets may wait. In this case the software SND timestamp only reflects the kernel-side part of the total latency (usually small) and queue length (usually 0 unless HW buffers congested), whereas the completion report time is more informative of the true latency. It may also be useful in other cases where HW TX timestamps cannot be obtained and user wants to estimate an upper bound to when the TX probably happened.
Showing the changes to include/uapi/linux (2 of 7 files). Show all
Unified · Split
| @@ -73,6 +73,7 @@ enum { · 72 unmodified lines | ||
| 73 | 73 | SCM_TSTAMP_SND, /* driver passed skb to NIC, or HW */ |
| 74 | 74 | SCM_TSTAMP_SCHED, /* data entered the packet scheduler */ |
| 75 | 75 | SCM_TSTAMP_ACK, /* data acknowledged by peer */ |
| 76 | + SCM_TSTAMP_COMPLETION, /* packet tx completion */ | |
| 76 | 77 | }; |
| 77 | 78 | |
| 78 | 79 | #endif /* _UAPI_LINUX_ERRQUEUE_H */ |
| @@ -44,8 +44,9 @@ enum { · 43 unmodified lines | ||
| 44 | 44 | SOF_TIMESTAMPING_BIND_PHC = (1 << 15), |
| 45 | 45 | SOF_TIMESTAMPING_OPT_ID_TCP = (1 << 16), |
| 46 | 46 | SOF_TIMESTAMPING_OPT_RX_FILTER = (1 << 17), |
| 47 | + SOF_TIMESTAMPING_TX_COMPLETION = (1 << 18), | |
| 47 | 48 | |
| 48 | − SOF_TIMESTAMPING_LAST = SOF_TIMESTAMPING_OPT_RX_FILTER, | |
| 49 | + SOF_TIMESTAMPING_LAST = SOF_TIMESTAMPING_TX_COMPLETION, | |
| 49 | 50 | SOF_TIMESTAMPING_MASK = (SOF_TIMESTAMPING_LAST - 1) | |
| 50 | 51 | SOF_TIMESTAMPING_LAST |
| 51 | 52 | }; |
| @@ -58,7 +59,8 @@ enum { · 6 unmodified lines | ||
| 58 | 59 | #define SOF_TIMESTAMPING_TX_RECORD_MASK (SOF_TIMESTAMPING_TX_HARDWARE | \ |
| 59 | 60 | SOF_TIMESTAMPING_TX_SOFTWARE | \ |
| 60 | 61 | SOF_TIMESTAMPING_TX_SCHED | \ |
| 61 | − SOF_TIMESTAMPING_TX_ACK) | |
| 62 | + SOF_TIMESTAMPING_TX_ACK | \ | |
| 63 | + SOF_TIMESTAMPING_TX_COMPLETION) | |
| 62 | 64 | |
| 63 | 65 | /** |
| 64 | 66 | * struct so_timestamping - SO_TIMESTAMPING parameter |