summaryrefslogtreecommitdiffstats
path: root/include/linux/cec.h
diff options
context:
space:
mode:
authorHans Verkuil2016-07-12 16:10:42 +0200
committerMauro Carvalho Chehab2016-07-13 12:59:30 +0200
commit980e0b36b55985dd0a37acd25d29c8f21482db32 (patch)
tree4c4e44239d8e0ca2a8579bc9bf1673403348bf81 /include/linux/cec.h
parent[media] cec: add sanity check for msg->len (diff)
downloadkernel-qcow2-linux-980e0b36b55985dd0a37acd25d29c8f21482db32.tar.gz
kernel-qcow2-linux-980e0b36b55985dd0a37acd25d29c8f21482db32.tar.xz
kernel-qcow2-linux-980e0b36b55985dd0a37acd25d29c8f21482db32.zip
[media] cec: split the timestamp into an rx and tx timestamp
When transmitting a message and waiting for a reply it would be good to know the time between when the message was transmitted and when the reply arrived. With only one timestamp field it was set to when the reply arrived and the original transmit time was overwritten. Just taking the timestamp in userspace right before CEC_TRANSMIT is called is not reliable, since the actual transmit can be delayed if the CEC bus is busy. Only the driver can fill this in accurately. So split up the ts field into an rx_ts and a tx_ts. Also move the status fields to after the 'reply' field: they were placed in a strange position and make much more sense when grouped with the other status-related fields. This patch also makes sure that the timestamp is taken as soon as possible. Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Diffstat (limited to 'include/linux/cec.h')
-rw-r--r--include/linux/cec.h18
1 files changed, 10 insertions, 8 deletions
diff --git a/include/linux/cec.h b/include/linux/cec.h
index 6678afe26844..b3e22893a002 100644
--- a/include/linux/cec.h
+++ b/include/linux/cec.h
@@ -48,9 +48,10 @@
/**
* struct cec_msg - CEC message structure.
- * @ts: Timestamp in nanoseconds using CLOCK_MONOTONIC. Set by the
- * driver. It is set when the message transmission has finished
- * and it is set when a message was received.
+ * @tx_ts: Timestamp in nanoseconds using CLOCK_MONOTONIC. Set by the
+ * driver when the message transmission has finished.
+ * @rx_ts: Timestamp in nanoseconds using CLOCK_MONOTONIC. Set by the
+ * driver when the message was received.
* @len: Length in bytes of the message.
* @timeout: The timeout (in ms) that is used to timeout CEC_RECEIVE.
* Set to 0 if you want to wait forever. This timeout can also be
@@ -61,8 +62,6 @@
* sent. This can be used to track replies to previously sent
* messages.
* @flags: Set to 0.
- * @rx_status: The message receive status bits. Set by the driver.
- * @tx_status: The message transmit status bits. Set by the driver.
* @msg: The message payload.
* @reply: This field is ignored with CEC_RECEIVE and is only used by
* CEC_TRANSMIT. If non-zero, then wait for a reply with this
@@ -80,6 +79,8 @@
* broadcast, then -EINVAL is returned.
* if reply is non-zero, then timeout is set to 1000 (the required
* maximum response time).
+ * @rx_status: The message receive status bits. Set by the driver.
+ * @tx_status: The message transmit status bits. Set by the driver.
* @tx_arb_lost_cnt: The number of 'Arbitration Lost' events. Set by the driver.
* @tx_nack_cnt: The number of 'Not Acknowledged' events. Set by the driver.
* @tx_low_drive_cnt: The number of 'Low Drive Detected' events. Set by the
@@ -87,15 +88,16 @@
* @tx_error_cnt: The number of 'Error' events. Set by the driver.
*/
struct cec_msg {
- __u64 ts;
+ __u64 tx_ts;
+ __u64 rx_ts;
__u32 len;
__u32 timeout;
__u32 sequence;
__u32 flags;
- __u8 rx_status;
- __u8 tx_status;
__u8 msg[CEC_MAX_MSG_SIZE];
__u8 reply;
+ __u8 rx_status;
+ __u8 tx_status;
__u8 tx_arb_lost_cnt;
__u8 tx_nack_cnt;
__u8 tx_low_drive_cnt;