[PATCH v4 2/3] can: length: fix description of the RRS field
From: Vincent Mailhol
Date: Thu Jun 01 2023 - 12:57:28 EST
The CAN-FD frames only have one reserved bit. The bit corresponding to
Classical CAN frame's RTR bit is called the "Remote Request
Substitution (RRS)" [1].
N.B. The RRS is not to be confused with the Substitute remote request
(SRR).
Fix the description in the CANFD_FRAME_OVERHEAD_SFF/EFF.
The total remains unchanged, so this is just a documentation fix.
In addition to the above add myself as copyright owner for 2020 (as
coauthor of the initial version, c.f. Fixes tag).
[1] ISO 11898-1:2015 paragraph 10.4.2.3 "Arbitration field":
RSS bit [only in FD Frames]
The RRS bit shall be transmitted in FD Frames at the position of
the RTR bit in Classical Frames. The RRS bit shall be transmitted
dominant, but receivers shall accept recessive and dominant RRS
bits.
Fixes: 85d99c3e2a13 ("can: length: can_skb_get_frame_len(): introduce function to get data length of frame in data link layer")
Signed-off-by: Vincent Mailhol <mailhol.vincent@xxxxxxxxxx>
Reviewed-by: Thomas Kopp <Thomas.Kopp@xxxxxxxxxxxxx>
---
include/linux/can/length.h | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/include/linux/can/length.h b/include/linux/can/length.h
index b8c12c83bc51..521fdbce2d69 100644
--- a/include/linux/can/length.h
+++ b/include/linux/can/length.h
@@ -1,6 +1,7 @@
/* SPDX-License-Identifier: GPL-2.0 */
/* Copyright (C) 2020 Oliver Hartkopp <socketcan@xxxxxxxxxxxx>
* Copyright (C) 2020 Marc Kleine-Budde <kernel@xxxxxxxxxxxxxx>
+ * Copyright (C) 2020 Vincent Mailhol <mailhol.vincent@xxxxxxxxxx>
*/
#ifndef _CAN_LENGTH_H
@@ -64,7 +65,7 @@
* ---------------------------------------------------------
* Start-of-frame 1
* Identifier 11
- * Reserved bit (r1) 1
+ * Remote Request Substitution (RRS) 1
* Identifier extension bit (IDE) 1
* Flexible data rate format (FDF) 1
* Reserved bit (r0) 1
@@ -95,7 +96,7 @@
* Substitute remote request (SRR) 1
* Identifier extension bit (IDE) 1
* Identifier B 18
- * Reserved bit (r1) 1
+ * Remote Request Substitution (RRS) 1
* Flexible data rate format (FDF) 1
* Reserved bit (r0) 1
* Bit Rate Switch (BRS) 1
--
2.39.3