canfd: remove redundant CAN FD flag

The first idea of the CAN FD implementation started with a new struct
canfd_frame to be used for both CAN FD frames and legacy CAN frames.
The now mainlined implementation supports both CAN frame types simultaneously
and distinguishes them only by their required sizes: CAN_MTU and CANFD_MTU.

Only the struct canfd_frame contains a flags element which is needed for the
additional CAN FD information. As CAN FD implicitly means that the 'Extened
Data Length' mode is enabled the formerly defined CANFD_EDL bit became
redundant and also confusing as an unset bit would be an error and would
always need to be tested.

This patch removes the obsolete CANFD_EDL bit and clarifies the documentation
for the use of struct canfd_frame and the CAN FD relevant flags.

Signed-off-by: Oliver Hartkopp <socketcan@hartkopp.net>
Signed-off-by: Marc Kleine-Budde <mkl@pengutronix.de>
This commit is contained in:
Oliver Hartkopp 2012-08-06 18:02:29 +02:00 committed by Marc Kleine-Budde
parent 5d299f3d3c
commit 035534ed33

View file

@ -74,20 +74,21 @@ struct can_frame {
/* /*
* defined bits for canfd_frame.flags * defined bits for canfd_frame.flags
* *
* As the default for CAN FD should be to support the high data rate in the * The use of struct canfd_frame implies the Extended Data Length (EDL) bit to
* payload section of the frame (HDR) and to support up to 64 byte in the * be set in the CAN frame bitstream on the wire. The EDL bit switch turns
* data section (EDL) the bits are only set in the non-default case. * the CAN controllers bitstream processor into the CAN FD mode which creates
* Btw. as long as there's no real implementation for CAN FD network driver * two new options within the CAN FD frame specification:
* these bits are only preliminary.
* *
* RX: NOHDR/NOEDL - info about received CAN FD frame * Bit Rate Switch - to indicate a second bitrate is/was used for the payload
* ESI - bit from originating CAN controller * Error State Indicator - represents the error state of the transmitting node
* TX: NOHDR/NOEDL - control per-frame settings if supported by CAN controller *
* ESI - bit is set by local CAN controller * As the CANFD_ESI bit is internally generated by the transmitting CAN
* controller only the CANFD_BRS bit is relevant for real CAN controllers when
* building a CAN FD frame for transmission. Setting the CANFD_ESI bit can make
* sense for virtual CAN interfaces to test applications with echoed frames.
*/ */
#define CANFD_NOHDR 0x01 /* frame without high data rate */ #define CANFD_BRS 0x01 /* bit rate switch (second bitrate for payload data) */
#define CANFD_NOEDL 0x02 /* frame without extended data length */ #define CANFD_ESI 0x02 /* error state indicator of the transmitting node */
#define CANFD_ESI 0x04 /* error state indicator */
/** /**
* struct canfd_frame - CAN flexible data rate frame structure * struct canfd_frame - CAN flexible data rate frame structure