Autosar Sws Saej1939transportlayer
Autosar Sws Saej1939transportlayer
Autosar Sws Saej1939transportlayer
AUTOSAR CP R20-11
Disclaimer
This work (specification and/or software implementation) and the material contained
in it, as released by AUTOSAR, is for the purpose of information only. AUTOSAR
and the companies that have contributed to it shall not be liable for any use of the
work.
The material contained in this work is protected by copyright and other types of
intellectual property rights. The commercial exploitation of the material contained in
this work requires a license to such intellectual property rights.
This work may be utilized or reproduced without any modification, in any form or by
any means, for informational purposes only. For any other purpose, no part of the
work may be utilized or reproduced, in any form or by any means, without permission
in writing from the publisher.
The work has been developed for automotive applications only. It has neither been
developed, nor tested for non-automotive applications.
The word AUTOSAR and the AUTOSAR logo are registered trademarks.
Table of Contents
10.1.16 J1939TpTxDirectNPdu......................................................................... 81
10.1.17 J1939TpTxNSdu .................................................................................. 82
10.2 Published Information ................................................................................. 83
11 Not applicable requirements ............................................................................ 84
SAE J1939 has a broad acceptance in the truck domain, and consists of several
documents describing the layers of the communication protocol from the physical
layer to diagnostics and the application layer. SAE J1939-21 describes the data link
and transport layer, which includes two transport protocol variants:
BAM (Broadcast Announce Message) for broadcast messages, and
CMDT (Connection Mode Data Transfer) for point-to-point connections.
This specification defines how the transport protocol of SAE J1939-21 can be
implemented in the AUTOSAR architecture. It only describes those parts of the
implementation that are relevant to the AUTOSAR architecture. Protocol specific
details like exact timings are not part of this specification. Therefore, to be able to
implement the J1939 Transport Layer module, the reader of this specification must
have access to the original SAE J1939-21specification document.
The module J1939Tp interfaces to the PDU Router and the CAN Interface, as shown
in the following figure:
The purpose of J1939Tp is to segment and reassemble J1939 PGNs (N-SDUs) that
are longer than 8 bytes. The segmented messages are sent and received via the
CAN Interface.
7 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
The PDU-Router (PduR) deploys AUTOSAR COM and DCM I-PDUs onto different
communication protocols (e.g. CAN or J1939, segmented via transport layer or
directly). At runtime, the PduR decides where to route I-PDUs based on the I-PDU
(L-SDU or N-SDU) identifier. In the same way, the CanIf uses the L-SDU (I-PDU or
N-PDU) identifier to decide whether a received message must be processed by one
of the available transport layer modules or may be forwarded directly to the PduR.
J1939Tp supports fixed and variable size N-SDUs (I-PDUs) with more than 8 bytes.
I-PDUs that do not exceed 8 bytes are exchanged directly between PduR and CanIf.
Fixed size N-SDUs are always segmented by the J1939Tp, while variable size N-
SDUs are only segmented when they exceed 8 bytes. J1939Tp forwards variable
size N-SDUs with an actual size of 8bytes or less and a configured maximum size of
more than 8 bytes directly to the CanIf. The transport protocol variant (BAM or
CMDT) is chosen based on received N-PDUs when a large N-SDU is received, and
on the configuration and the actual DA when a large N-SDU is transmitted.
J1939Tp supports handling of N-PDUs and N-SDUs with variable SA, DA, and
Priority. In this case, the N-PDUs and N-SDUs will contain parts of the CAN ID in the
MetaData.
The following table lists acronyms and abbreviations that are specific to the J1939
transport layer. For all other abbreviations, please check the AUTOSAR Glossary
and the AUTOSAR BSW Module List.
Acronym / Description
Abbreviation
BAM Broadcast Announce Message, broadcast variant of SAE J1939
transport protocol
CMDT Connection Mode Data Transfer, peer-to-peer variant of SAE J1939
transport protocol
DA Destination Address, part of the 29 bit identifier of SAE J1939
messages
DET Default Error Tracer, supports development and runtime error reporting
DMx Diagnostic messages of the SAE J1939 diagnostics layer
NAME Unique 64 bit identifier of each ECU connected to an SAE J1939
network
PDUF PDU Format, part of the 29 bit identifier of SAE J1939 messages which
identifies the message and determines the layout of the 29 bit identifier
PDUS PDU Specific, part of the 29 bit identifier of SAE J1939 messages which
identifies broadcast messages which do not have a destination address
PG Parameter Group, SAE J1939 term for a specific message layout,
corresponds to an N-SDU of J1939Tp
PGN Parameter Group Number, unique identifier of an SAE J1939 parameter
group
SA Source Address, part of the 29 bit identifier of SAE J1939 messages
SPN Suspect Parameter Number, unique identifier of an SAE J1939
parameter
TP.CM Connection Management message (PGN 00EC00) used by SAE J1939
transport protocol, corresponds to an N-PDU of J1939Tp
TP.CM_BAM Broadcast Announce Message, variant of TP.CM that initiates a BAM
transmission
TP.CM_CTS Connection Mode Clear To Send, variant of TP.CM that is used for
handshake during CMDT transmission
TP.CM_EndOfMsg End Of Message Acknowledge, variant of TP.CM that acknowledges
Ack correct reception of a CMDT transmission
TP.CM_RTS Connection Mode Request To Send, variant of TP.CM that initiates a
CMDT transmission
TP.Conn_Abort Connection Abort, variant of TP.CM that terminates a CMDT
transmission
TP.DT Data Transfer message (PGN 00EB00) used by SAE J1939 transport
protocol, corresponds to an N-PDU of J1939Tp
3 Related Documentation
Thus, the specification SWS BSW General shall be considered as additional and
required specification for SAE J1939 Transport Layer.
4.1 Limitations
The AUTOSAR architecture contains several communication system specific
transport layers (J1939Tp, CanTp, FrTp, etc.). All of these modules need to have
identical APIs, with the exception of API functions for which the PduR has separate
configuration abilities.
The J1939Tp module does not implement the TriggerTransmit API, because it is only
needed for time triggered bus architectures.
5 Module Architecture
The figure below shows the interactions between J1939Tp, PduR, and CanIf.
The J1939Tp’s upper interface offers the PduR module access to transmitted and
received N-SDUs corresponding to J1939 PGs with a maximum length of more than
8 bytes of data.
J1939 PGs with a maximum length of 8 bytes or less are exchanged directly between
PduR and CanIf.
The file hierarchy defined in this section allows the separation of platform, compiler,
and implementation specific definitions and declarations from general definitions, as
well as the separation of source code and configuration.
For details, refer to the chapter 5.1.6 “Code file structure” in SWS BSW General [15].
[SWS_J1939Tp_00007] ⌈
Internally used data types and functions shall be defined locally in the implementation
source files. ⌋ ( )
For details, refer to the chapter 5.1.7 “Header file structure” in SWS BSW General
[15].
6 Requirements Traceability
template
SRS_BSW_00433 Main processing functions are only allowed to SWS_J1939Tp_99999
be called from task bodies provided by the
BSW Scheduler
SRS_BSW_00437 Memory mapping shall provide the possibility SWS_J1939Tp_99999
to define RAM segments which are not to be
initialized during startup
SRS_BSW_00438 Configuration data shall be defined in a SWS_J1939Tp_00187
structure
SRS_BSW_00439 Enable BSW modules to handle interrupts SWS_J1939Tp_99999
SRS_BSW_00440 The callback function invocation by the BSW SWS_J1939Tp_99999
module shall follow the signature provided by
RTE to invoke servers via Rte_Call API
SRS_BSW_00441 Naming convention for type, macro and SWS_J1939Tp_00019,
function SWS_J1939Tp_00115
SRS_BSW_00447 Standardizing Include file structure of BSW SWS_J1939Tp_99999
Modules Implementing Autosar Service
SRS_BSW_00449 BSW Service APIs used by Autosar SWS_J1939Tp_99999
Application Software shall return a
Std_ReturnType
SRS_BSW_00450 A Main function of a un-initialized module SWS_J1939Tp_00023
shall return immediately
SRS_BSW_00453 BSW Modules shall be harmonized SWS_J1939Tp_99999
SRS_J1939_00001 The J1939 Transport Layer module shall be SWS_J1939Tp_00125
configurable to support only transport
protocol variant BAM
SRS_J1939_00010 The J1939 Transport Layer module shall SWS_J1939Tp_00024
implement an interface for initialization
SRS_J1939_00011 The J1939 Transport Layer services shall not SWS_J1939Tp_00023
be operational before initializing the module
SRS_J1939_00019 The J1939 Transport Layer module shall SWS_J1939Tp_00155
support the transport protocol variant BAM
SRS_J1939_00020 The AUTOSAR J1939 Transport Layer SWS_J1939Tp_00155
module shall support the transport protocol
variant CMDT
SRS_J1939_00022 The timeout values of the J1939 transport SWS_J1939Tp_00018,
protocol variants shall be supervised SWS_J1939Tp_00121,
SWS_J1939Tp_00123
SRS_J1939_00023 The J1939 Transport Layer module shall SWS_J1939Tp_00018,
handle unexpected PDUs according to the SWS_J1939Tp_00064
SAE J1939 specification
SRS_J1939_00024 Unused Bytes in N-PDUs shall be padded SWS_J1939Tp_00068
SRS_J1939_00025 The J1939 Transport Layer module shall be SWS_J1939Tp_00062
able to manage connections via BAM and
CMDT in parallel
SRS_J1939_00040 The AUTOSAR J1939 Transport Layer SWS_J1939Tp_00018
module shall be based on SAE J1939
specifications
SRS_J1939_00042 The J1939 Transport Layer interface shall be SWS_J1939Tp_00157
18 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
7 Functional Specification
This chapter describes the functionality of the AUTOSAR J1939 Transport Layer. It
explains the services provided to the upper and lower layers and the internal
behavior of J1939Tp.
PGNs with PDU-Format < 240 (format 1) identify point-to-point messages, while
PGNs with PDU-Format >= 240 (format 2) identify broadcast messages. The PDU-
Specific field is only relevant for broadcast messages (format 2); it is always zero for
point-to-point messages (format 1).
J1939 uses 29-bit CAN identifiers to identify each message. The CAN identifier
contains a 3-bit-priority, the PGN, the Source Address (SA), and the Destination
Address (DA, only for point-to-point messages).
Usually, an ECU has just one node address, which is used as DA in received
messages and as SA in transmitted messages. However, a single ECU can also
implement several different J1939 nodes at once, each with its own node address. In
this case, the ECU accepts any of these node addresses as DA and sends with any
of the defined node addresses as SA.
The SAE J1939 transport layer uses two special point-to-point messages identified
by PGNs of format 1 to transport segmented messages, both with a fixed length of 8
bytes. These messages are called transport frames in the context of this document.
TP.CM is used for connection management. The first byte of the payload identifies its
role, which may be one of the following:
TP.CM_BAM is used to initiate a BAM transfer.
TP.CM_RTS is transmitted to initiate a CMDT transfer.
TP.CM_CTS is used for flow control during a CMDT transfer.
TP.CM_EndOfMsgAck indicates the end of a CMDT transfer.
TP.Conn_Abort indicates an error and terminates the CMDT transfer.
TP.DT contains a sequence number in the first byte and 7 bytes of data.
A single TP.CM or TP.DT frame, identified by a certain CAN Identifier, is used for
different PGs. The PGN of the transported PG is contained in the payload of the
TP.CM frames as specified in [16].
20 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
The destination address (DA) of CMDT related transport frames contains a legal
node address and thus allows a point-to-point connection, while the DA of BAM
related transport frames is always set to FF16 to create a broadcast connection.
[SWS_J1939Tp_00018] ⌈
The J1939Tp module shall follow the recommendations of SAE J1939-21 [16] if they
are not explicitly excluded in this document. ⌋ (SRS_J1939_00022, SRS_J1939_00023,
SRS_J1939_00040)
[SWS_J1939Tp_00071] ⌈
On errors and exceptions, the J1939Tp module shall not modify its current module
state (see Figure 7-1: J1939 Transport Layer life cycle) but shall simply report the
error event. ⌋ ( )
To assure a unique PDU router handling of all J1939 PGs which is independent of
the Payload Length type (variable or fixed), the J1939Tp is used for the transmission
of all Parameter Groups that are longer than 8 Bytes, independent of their length
being fixed or variable.
This means that PGs with variable length that have a configured maximum size of
more than 8 bytes but do not exceed 8 bytes at runtime shall be transported using
J1939Tp even though no segmentation is necessary and a direct transmission from
PDU router to CAN Interface would be possible.
[SWS_J1939Tp_00155] ⌈
The J1939 transport layer shall implement the following two J1939 transport protocol
variants defined in [16]:
- BAM for broadcast transmission
- CMDT for point-to-point transmission⌋ (SRS_J1939_00019, SRS_J1939_00020)
[SWS_J1939Tp_00125] ⌈
The J1939 Transport Layer shall be configurable to either use both BAM and CMDT
transport protocol variants, or only BAM, or only CMDT. ⌋ (SRS_BSW_00171,
SRS_J1939_00001)
[SWS_J1939Tp_00198] ⌈
The J1939 Transport Layer shall use meta data items of type
SOURCE_ADDRESS_16, TARGET_ADDRESS_16, and PRIORITY_8 of all N-
SDUs, and meta data items of type CAN_ID_32 for all N-PDUs. ⌋ ( )
[SWS_J1939Tp_00231] ⌈
The J1939 Transport Layer module shall support several connections for the same
PGN in parallel as long as they can be received or transmitted independently. ⌋ ( )
[SWS_J1939Tp_00233] ⌈
If several receiving connections are configured with identical PGNs and matching
channel parameters, the J1939Tp shall allocate an arbitrary free connection with
matching parameters. ⌋ ( )
Note: This scenario is typically only useful if all of these similar connections are
configured to end up at the same upper layer module.
J1939Tp_OFF
PowerUp PowerDown
Initial
PowerDown
J1939Tp_ON
[SWS_J1939Tp_00019] ⌈
The J1939Tp module shall have two global states, J1939TP_ON and
J1939TP_OFF. ⌋ (SRS_BSW_00335, SRS_BSW_00441)
[SWS_J1939Tp_00020] ⌈
The J1939Tp module shall be in the J1939TP_OFF state after power up. ⌋ ( )
In the state J1939TP_OFF, the J1939Tp allows for an update of the post build
configuration.
[SWS_J1939Tp_00023] ⌈
The J1939Tp module shall perform segmentation and reassembly tasks only when
the J1939Tp is in the J1939TP_ON state. ⌋ (SRS_BSW_00406, SRS_BSW_00450,
SRS_J1939_00011)
[SWS_J1939Tp_00076] ⌈
The global state (see SWS_J1939Tp_00019) shall be used to check if the module
has been initialized before calling an API. ⌋ ( )
[SWS_J1939Tp_00157] ⌈
All service interfaces provided to the lower layer shall be independent of the internal
communication configuration and implementation of the J1939Tp. ⌋
(SRS_J1939_00042)
[SWS_J1939Tp_00041] ⌈
J1939Tp shall send the transport frames TP.CM and TP.DT and direct frames using
the service function CanIf_Transmit().⌋ ( )
[SWS_J1939Tp_00035] ⌈
When J1939Tp_TxConfirmation() is called with result E_NOT_OK, the J1939Tp
module shall abort the corresponding session. ⌋ ( )
The J1939Tp module shall provide a J1939Tp_RxIndication() API to allow the CanIf
to notify that a new N-PDU has been received (see SWS_J1939Tp_00108).
CanIf shall perform the Reception Indication according to its configuration (i.e. in ISR
context if configured so).
[SWS_J1939Tp_00119] ⌈
When the transport transmission session is successfully completed, the J1939Tp
module shall call a notification service of the upper layer,
PduR_J1939TpTxConfirmation, with the result E_OK, to notify that the N-SDU
transfer is successfully processed.⌋ ( )
[SWS_J1939Tp_00032] ⌈
An Abort Transmission feature shall indicate the upper layer that the transmission of
a given N-SDU has been aborted. It uses the callback function
PduR_J1939TpTxConfirmation with E_NOT_OK.⌋ ( )
[SWS_J1939Tp_00118] ⌈
A close connection feature shall indicate the upper layer that the transport reception
session is completed. It uses the PduR_J1939TpRxIndication() with E_OK to
indicate that the N-SDU reception is successfully processed.⌋ ( )
[SWS_J1939Tp_00031] ⌈
An Abort Reception feature shall indicate the upper layer that the reception of a given
N-SDU has been aborted. It uses the PduR_J1939TpRxIndication() with state
E_NOT_OK.⌋ ( )
[SWS_J1939Tp_00097] ⌈
An Abort CMDT Connection feature shall indicate to the other ECU participating in
the concerned connection that the current CMDT session (transmission or reception)
cannot be completed successfully. A TP.Conn_Abort abort message shall be
transmitted to the other ECU via CAN as specified by [16]. ⌋ ( )
[SWS_J1939Tp_00043] ⌈
Depending on the control byte of the initializing TP.CM frame (BAM or RTS), the
J1939Tp module shall use the variant BAM or CMDT of the J1939 transport protocol
to handle the data reception. ⌋ ( )
[SWS_J1939Tp_00038] ⌈
When receiving an N-PDU containing a TP.CM_BAM or a TP.CM_RTS the J1939Tp
module shall first notify the upper layer (PDU Router) before processing the frame
reassembly. It uses the PduR_J1939TpStartOfReception function with the
following parameters:
- the Identifier of the corresponding N-SDU,
- depending on the configured meta data items: the SA, DA and Priority,
- the total Data Length (after reassembly) and
- a pointer to a location where the upper layer stores its currently available
buffer size. ⌋ ( )
[SWS_J1939Tp_00162] ⌈
After the reception of an N-PDU containing a TP.DT frame, the function
PduR_J1939TpCopyRxData shall be called with the following parameters:
- the Identifier of the corresponding N-SDU,
- PduInfoPtr with max. 7 bytes of data,
- a pointer to a location where the upper layer stores its currently available
buffer size. ⌋ ( )
[SWS_J1939Tp_00173] ⌈
The J1939Tp module shall abort the reception silently if any of the following
conditions occurs:
- The PduR_J1939TpStartOfReception function returns
BUFREQ_E_NOT_OK or BUFREQ_E_OVFL or
- the protocol chosen in SWS_J1939Tp_00043 does not match the transport
protocol configured for the transported PGN (see ECUC_J1939Tp_00029 : )
or
- the SA/DA of N-PDUs with MetaData do not match the configured SA/DA (see
ECUC_J1939Tp_00179 : /ECUC_J1939Tp_00178 : ).
In case of a BAM connection, no further activity is required.
In case of a CMDT connection, a CMDT Connection Abort shall be performed as
described in SWS_J1939Tp_00097, and the connection abort reason shall be set to
1 (Already in one or more connection managed sessions and cannot support
another). ⌋ ( )
25 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
[SWS_J1939Tp_00040] ⌈
The J1939Tp module shall abort the reception like indicated in
SWS_J1939Tp_00031 if any of the following conditions occurs:
- The value returned by PduR_J1939TpStartOfReception via bufferSizePtr
is smaller than the total data length of the N-SDU when received via the direct
N-PDU,
- the PduR_J1939TpCopyRxData function returns BUFREQ_E_NOT_OK, or
- the J1939Tp_CancelReceive function is called.
In case of a BAM connection, no further activity is required.
In case of a CMDT connection, a CMDT Connection Abort shall be performed as
described in SWS_J1939Tp_00097, and the connection abort reason shall be set to
1 (Already in one or more connection managed sessions and cannot support
another) after the call to PduR_J1939TpStartOfReception, and to 2 (System
resources were needed for another task so this connection managed session was
terminated) in the other two cases. ⌋ ( )
As described in section 7.3.2, the upper layer (PDU Router) asks for the transmission
of an N-SDU by calling J1939Tp_Transmit(). The parameters of
J1939Tp_Transmit()describe the Identifier of the N-SDU (NSduId) and a
reference to a PduInfoType that indicates the full length of the N-SDU to transmit (full
Tx N-SDU data length) and a pointer to the payload N-SDU, which may contain
MetaData with SA, DA and Priority depending on the meta data configuration of the
N-SDU.
[SWS_J1939Tp_00039] ⌈
When configured, the transport protocol variant (BAM/CMDT, see
ECUC_J1939Tp_00137 : ) and the SA/DA (see ECUC_J1939Tp_00181 : /
ECUC_J1939Tp_00180 : ) shall be used for transmission. For N-SDUs with
MetaInfo, these parameters are optional. If SA or DA is not configured, the value
provided via the MetaData shall be used. If the transport protocol is not configured, it
shall be chosen based on the actual DA: BAM when DA is 0xFF, CMDT otherwise. ⌋
()
[SWS_J1939Tp_00045] ⌈
The function J1939Tp_Transmit shall use the NSduId and the SduLength provided in
the PduInfoType structure. It shall not use the payload of N-SDUs, only the contained
MetaData. ⌋ ( )
[SWS_J1939Tp_00047] ⌈
After a transmission request from the upper layer, the J1939Tp module shall initiate
the transmission by sending:
- For CMDT: a TP.CM_RTS frame
- For BAM: a TP.CM_BAM frame ⌋ ( )
[SWS_J1939Tp_00046] ⌈
For each TP.DT frame to be sent, the J1939Tp module shall previously call
PduR_J1939TpCopyTxData with the following parameters:
- the Identifier of the corresponding N-SDU,
- PduInfoType structure with up to 7 bytes as SduLength,
- the retry parameter, and
- a pointer to a location where the upper layer stores its currently available data.
⌋()
[SWS_J1939Tp_00228] ⌈
When PduR_J1939TpCopyTxData returns BUFREQ_E_BUSY, the J1939Tp shall
retry the call to PduR_J1939TpCopyTxData until the data is available or a timeout
occurs. ⌋ ( )
[SWS_J1939Tp_00218] ⌈
If J1939TpTxRetrySupport is disabled, the parameter retry of
PduR_J1939TpCopyTxData shall allways be set to the NULL_PTR. ⌋ ( )
[SWS_J1939Tp_00219] ⌈
For BAM transmissions, the parameter retry of PduR_J1939TpCopyTxData shall
allways be set to the NULL_PTR. ⌋ ( )
[SWS_J1939Tp_00220] ⌈
If J1939TpTxRetrySupport is enabled, a valid RetryInfoType stuct shall be provided
via the parameter retry of PduR_J1939TpCopyTxData during CMDT transmissions.
⌋()
See section 7.5.4.2 for a description how the J1939 Transport Layer module uses the
RetryInfoType during CMDT transmission.
[SWS_J1939Tp_00048] ⌈
The J1939Tp module shall abort the transmission session like specified in
SWS_J1939Tp_00032 if any of the following conditions occur:
- The upper Layer returns the PduR_J1939TpCopyTxData function call with
BUFREQ_E_NOT_OK or
- the J1939Tp_CancelTransmit function is called.
In case of a CMDT connection, a CMDT Connection Abort shall be performed as
described in SWS_J1939Tp_00097, and the connection abort reason shall be set to
2 (System resources were needed for another task so this connection managed
session was terminated). ⌋ ( )
The following figure shows an example of direct message transmission between two
ECUs using J1939Tp. This is the only case of transmission of a J1939Tp N-SDU
using no TP.CM or TP.DT frame. The SA is always included in the CAN identifier.
Depending on the PDU-Format of the concerned PG, the CAN Identifier might
contain the DA.
Sender Receiver
Actual PG
Figure 7-2: Example of direct data flow for PGs of variable length <= 8 Bytes
Sender Receiver
Tr TP.DT T2
Tr
TP.DT T1
TP.DT
TP.CM_EndOfMsgACK
Figure 7-3: Example of data flow without error using CMDT as transport protocol variant
The J1939 transport protocol uses the initial sequence of RTS and CTS to determine
the number of packets per block.
[SWS_J1939Tp_00165] ⌈
If J1939TpTxDynamicBlockCalculation is enabled, after J1939Tp_Transmit has been
called, the J1939Tp shall call PduR_J1939TpCopyTxData once with info-
>SduLength set to 0 and retry set to NULL_PTR to obtain the available amount of
data via availableDataPtr. ⌋ ( )
[SWS_J1939Tp_00207] ⌈
If J1939TpTxDynamicBlockCalculation and J1939TpTxMaxPacketsPerBlock are
enabled, the J1939Tp shall compare the available amount of data returned by
PduR_J1939TpCopyTxData to J1939TpTxMaxPacketsPerBlock and use use the
smaller of these two values to calculate the maximum number of packets field of the
TP.CM_RTS message. ⌋ ( )
[SWS_J1939Tp_00208] ⌈
If J1939TpTxDynamicBlockCalculation is enabled but
J1939TpTxMaxPacketsPerBlock is disabled, the J1939Tp shall use the available
amount of data returned by PduR_J1939TpCopyTxData to calculate the maximum
number of packets field of the TP.CM_RTS message. ⌋ ( )
[SWS_J1939Tp_00209] ⌈
If J1939TpTxDynamicBlockCalculation is disabled, the J1939Tp shall use
J1939TpTxMaxPacketsPerBlock for the maximum number of packets field of the
TP.CM_RTS message. ⌋ ( )
[SWS_J1939Tp_00210] ⌈
If J1939TpRxDynamicBlockCalculation and J1939TpRxPacketsPerBlock are
enabled, the J1939Tp shall compare the value returned by
PduR_J1939TpStartOfReception for the available buffer size to
J1939TpRxPacketsPerBlock and use the lower value to calculate the number of
packets field of the TP.CM_CTS message. ⌋ ( )
[SWS_J1939Tp_00211] ⌈
If J1939TpRxDynamicBlockCalculation is enabled but J1939TpRxPacketsPerBlock is
disabled, the J1939Tp shall use the value returned by
PduR_J1939TpStartOfReception for the available buffer size to calculate the
number of packets field of the TP.CM_CTS message. ⌋ ( )
[SWS_J1939Tp_00226] ⌈
After reception of the TP.CM_RTS and after reception of the last N-PDU of a block, if
the reported buffer size is large enough for the next block, the J1939Tp shall transmit
a TP.CM_CTS message requesting the next block. The number of packets requested
by TP.CM_CTS shall be constant during the complete reception of one N-SDU, only
in the last TP.CM_CTS this number shall be reduced to the number of remaining
packets. ⌋ ( )
[SWS_J1939Tp_00227] ⌈
When there is not enough buffer reported by PduR_J1939TpStartOfReception
or PduR_J1939TpCopyRxData for the reception of a complete block, the J1939Tp
shall call PduR_J1939TpCopyRxData with info->SduLength set to 0 until the
buffer is large enough for one block, or a timeout occurs. ⌋ ( )
[SWS_J1939Tp_00229] ⌈
While monitoring the buffer state as defined by SWS_J1939Tp_00227, the J1939Tp
shall send TP.CM_CTS wait frames (number of packets set to 0, see also [16])
according to the timing requirements defined in [16]. ⌋ ( )
[SWS_J1939Tp_00212] ⌈
If J1939TpRxRetrySupport is enabled, the J1939Tp shall adapt the value returned by
PduR_J1939TpStartOfReception for the available buffer size according to
J1939TpRxDynamicBufferRatio before using it to calculate the number of packets
field of the TP.CM_CTS message as specified in SWS_J1939Tp_00210 and
SWS_J1939Tp_00211. ⌋ ( )
[SWS_J1939Tp_00213] ⌈
If J1939TpRxDynamicBlockCalculation is disabled, the J1939Tp shall use
J1939TpRxPacketsPerBlock to calculate the number of packets field of the
TP.CM_CTS message. ⌋ ( )
[SWS_J1939Tp_00217] ⌈
If J1939TpTxRetrySupport is enabled, the J1939Tp shall call
PduR_J1939TpCopyTxData with
- TpDataState set to TP_DATACONF for the first call after reception of a
TP.CM_CTS, and
- TpDataState set to TP_CONFPENDING for the following calls. ⌋ ( )
[SWS_J1939Tp_00195] ⌈
If a TP.CM_CTS wait frame (number of packets set to 0, see also [16]) is received,
the J1939Tp shall wait for another TP.CM_CTS frame. ⌋ ( )
[SWS_J1939Tp_00223] ⌈
When the J1939Tp receives a TP.CM_CTS frame that requests data beyond the
current position or preceding the position where the last TP.CM_CTS was received, it
shall abort the transmission using the mechanisms described by
SWS_J1939Tp_00032 and SWS_J1939Tp_00097 with reason FF16 (SNA). ⌋ ( )
[SWS_J1939Tp_00221] ⌈
The number of bytes that need to be retransmitted is calculated from the position of
the requested package relative to the current package.
[SWS_J1939Tp_00194] ⌈
If J1939TpTxRetrySupport is disabled, when the J1939Tp receives a TP.CM_CTS
frame requesting already sent data, it shall abort the transmission using the
mechanisms described by SWS_J1939Tp_00032 and SWS_J1939Tp_00097 with
reason 255 (unassigned). ⌋ ( )
[SWS_J1939Tp_00222] ⌈
If J1939TpRxRetrySupport is enabled, when a sequence error occurs during
reception, the J1939Tp module shall, after the last TP.DT message of the block was
received, send a TP.CM_CTS frame requesting the packages that follow the last
correctly received package of the current block. ⌋ ( )
[SWS_J1939Tp_00232] ⌈
The content of a TP.DT message with a sequence error and of the TP.DT messages
following a sequence error in the same block shall be discarded. ⌋ ( )
Note: This means that for such messages PduR_J1939TpCopyRxData shall not be
called.
[SWS_J1939Tp_00216] ⌈
If J1939TpRxRetrySupport is disabled, when a sequence error occurs during
reception, the J1939Tp module shall abort the reception session
- as specified in SWS_J1939Tp_00031 and
- as specified in SWS_J1939Tp_00097 with connection abort reason FF16
(SNA). ⌋ ( )
[SWS_J1939Tp_00123] ⌈
J1939Tp shall implement all CMDT related timing constraints (Tr, Th, T1, T2, T3, T4)
as described in [16]. They supervise the CMDT data flow. ⌋ (SRS_J1939_00022)
[SWS_J1939Tp_00100] ⌈
If a timeout occurs during CMDT transmission (see [16] for details) then the J1939Tp
module shall abort the transmission session
- as specified in SWS_J1939Tp_00032 and
- as specified in SWS_J1939Tp_00097 with connection abort reason 3 (A
timeout occurred and this is the connection abort to close the session) when
the timeout occurred after successful transmission of the TP.CM_RTS frame.
⌋()
31 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
[SWS_J1939Tp_00159] ⌈
If a timeout occurs during reception (see [16] for details) then the J1939Tp module
shall abort the reception session
- as specified in SWS_J1939Tp_00031 and
- as specified in SWS_J1939Tp_00097 with connection abort reason 3 (A
timeout occurred and this is the connection abort to close the session). ⌋ ( )
[SWS_J1939Tp_00098] ⌈
If a TP.Conn_Abort frame is received after a TP.CM_RTS frame has been
successfully sent by the ECU, the transmission shall be aborted like indicated in
SWS_J1939Tp_00032. No transmission of TP.Conn_Abort is necessary. ⌋ ( )
[SWS_J1939Tp_00163] ⌈
If a TP.Conn_Abort frame is received after a TP.CM_RTS frame has been received,
the reception shall be aborted like indicated in SWS_J1939Tp_00031. No
transmission of TP.Conn_Abort is necessary. ⌋ ( )
[SWS_J1939Tp_00121] ⌈
J1939Tp shall implement the BAM related timing constraints (50ms, Tr, T1) as
described in [16]. They supervise the BAM data flow. ⌋ (SRS_J1939_00022)
[SWS_J1939Tp_00160] ⌈
If a timeout occurs during the BAM reception, the J1939Tp module shall abort the
reception session as specified in SWS_J1939Tp_00031. ⌋ ( )
[SWS_J1939Tp_00192] ⌈
After a sequence error, J1939Tp shall abort BAM connections as specified in
SWS_J1939Tp_00031. ⌋ ( )
Sender Receiver
50ms .. Tr
TP.DT T1
TP.DT
TP.DT
Figure 7-4: Example of data flow using BAM as transport protocol variant
J1939Tp shall have no internal PDU buffers. It requests data for sending directly from
the upper layers via PduR_J1939TpCopyTxData() and provides received data
directly to the upper layers via PduR_J1939TpCopyRxData().
To guarantee data consistency, the complete buffer of the upper layers must be
locked during the whole data transmission or reception.
LOCK
J1939Tp_Transmit PduR_J1939TpTxConfirmation
=> E_OK
UNLOCK
LOCK
PduR_J1939TpStartOfReception PduR_J1939TpRxIndication
=> E_OK
UNLOCK
This section describes the relation that exists between an N-SDU and the set of N-
PDUs that is required to transport the N-SDU data, as shown in the following figure.
cd Data Model
N-SDU NSduId
1 1
N-PDU NPduId
1 1
<CMDT> <CMDT>
<CMDT> <BAM> <BAM> <Direct>
The N-PDUs as well as the N-SDU may use MetaData. In that case, the N-SDU
stands for a certain PGN, and the N-PDUs stand for TP.CM, TP.DT, and direct PG,
regardless of source and/or destination addresses.
[SWS_J1939Tp_00057] ⌈
35 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
[SWS_J1939Tp_00199] ⌈
During transmission, the relevant set of N-PDUs is identified by the configured
SA/DA of N-SDUs without MetaData, or by the SA/DA explicitly provided in the
MetaData by the upper layer. ⌋ ( )
Connections only concern internal J1939Tp purposes. They are transparent for the
upper and lower layers of J1939Tp but influence the handling of J1939Tp.
The CAN-Identifier corresponding to those transport specific frames is the same for
all J1939 PGs longer than 8 bytes:
- sent from a given SA - in the BAM case
- sent from a given SA to a given DA - in the CMDT case
This reduces the possibility for J1939Tp to process concurrent connections.
[SWS_J1939Tp_00120] ⌈
The J1939Tp shall be able to handle connections in parallel for all N-SDUs that do
not interfere in the usage of TP.DT frames with the same SA and DA. For channels
with defined SA/DA and protocol type, only one TP connection and one direct
connection for each PG can be open at any time. For channels with variable SA/DA,
the maximum number of parallel connections is limited by the number of N-SDUs
assigned to this channel. ⌋ ( )
[SWS_J1939Tp_00062] ⌈
Each connection shall be independent of the other connections. ⌋ (SRS_J1939_00025)
This means that a connection shall use its own resources, such as timer or state
machine.
[SWS_J1939Tp_00200] ⌈
The J1939 Transport Layer module shall send TP.DT frames always with 8 bytes
according to [16]. ⌋ ( )
[SWS_J1939Tp_00068] ⌈
According to [16], all unused data bytes within the last TP.DT frame or the direct
frame shall be set to 0xFF. ⌋ (SRS_J1939_00024)
[SWS_J1939Tp_00064] ⌈
The J1939Tp shall ignore unexpected N-PDUs that do not correspond to a currently
active connection. ⌋ (SRS_J1939_00023)
[SWS_J1939Tp_00224] ⌈
If J1939TpTxRetrySupport is disabled, when a TP.CM_CTS is received while TP.DT
messages are being transmitted, J1939Tp shall abort the connection as specified in
SWS_J1939Tp_00032 and in SWS_J1939Tp_00097 with connection abort reason 4
(CTS messages received when data transfer is in progress). ⌋ ()
[SWS_J1939Tp_00225] ⌈
When a TP.CM_RTS is received for a currently active connection, the J1939Tp shall
stop this connection as specified in SWS_J1939Tp_00031 and start a new
connection as described in SWS_J1939Tp_00038. ⌋ ()
Based on this foundation, this section specifies particular errors arranged in the
respective subsections below.
[SWS_J1939Tp_00115]⌈
Error
Type of error Related error code
value
J1939TP_E_INVALID_PDU_
API service called with wrong ID. 0x11
SDU_ID
[SWS_J1939Tp_00234]⌈
Error
Type of error Related error code
value
Timeout occurred on receiver side while trying to send the next J1939TP_E_
0x35
TP.CM/CTS frame after a TP.CM/CTS(0) frame. TIMEOUT_TH
J1939TP_E_
Unexpected PGN in received TP.CM frame. 0x43
INVALID_PGN
INVALID_SN
⌋()
8 API Specification
[SWS_J1939Tp_00188] ⌈
If development error detection for the J1939Tp is enabled, all APIs using a SDU- or
PDU-Identifier shall check the input Identifier and raise the development error:
J1939TP_E_INVALID_PDU_SDU_ID in case the API has been called for a not
configured PDU or SDU. ⌋ (SRS_BSW_00323)
[SWS_J1939Tp_00230]⌈
Module Header File Imported Type
ComStack_Types.h BufReq_ReturnType
ComStack_Types.h PduIdType
ComStack_Types.h PduInfoType
ComStack_Types.h RetryInfoType
ComStack_Types.h TPParameterType
ComStack_Types.h TpDataStateType
Std_Types.h Std_ReturnType
Std
Std_Types.h Std_VersionInfoType
⌋()
[SWS_J1939Tp_00175]⌈
Name J1939Tp_ConfigType
Kind Structure
implementation specific
Elements Type --
⌋()
8.4.1 J1939Tp_Init
[SWS_J1939Tp_00087]⌈
Service Name J1939Tp_Init
void J1939Tp_Init (
Syntax const J1939Tp_ConfigType* ConfigPtr
)
Sync/Async Synchronous
⌋(SRS_BSW_00101, SRS_BSW_00358)
After power up, J1939Tp is in a state called J1939TP_OFF. In this state, J1939Tp is
not yet configured, and therefore cannot perform any communication task. The
J1939Tp module’s environment (usually the ECU Manager) will call
J1939Tp_Init() before using the J1939Tp module for further processing.
[SWS_J1939Tp_00024] ⌈
The function J1939Tp_Init() shall initialize all global variables of the module and
reset all transport protocol connections. ⌋ (SRS_J1939_00010)
[SWS_J1939Tp_00022] ⌈
J1939Tp_Init() shall change to the internal state J1939TP_ON after successful
initialization. ⌋ ( )
[SWS_J1939Tp_00026] ⌈
If called when the J1939Tp module is in the global state J1939TP_ON, the function
J1939Tp_Init() shall raise the development error J1939TP_E_REINIT and do
nothing. ⌋ ( )
[SWS_J1939Tp_00187] ⌈
The provided ConfigPtr shall only be used, when post-build configuration is enabled,
or when different configuration variants must be supported. Otherwise, the
parameters should be accessed directly to avoid indirection via the ConfigPtr. ⌋
(SRS_BSW_00400, SRS_BSW_00405, SRS_BSW_00414, SRS_BSW_00438)
8.4.2 J1939Tp_Shutdown
[SWS_J1939Tp_00093]⌈
Service Name J1939Tp_Shutdown
void J1939Tp_Shutdown (
Syntax void
)
Sync/Async Synchronous
⌋(SRS_BSW_00336)
To close down communication, the state handling (usually the ECU Manager) calls
J1939Tp_Shutdown().
[SWS_J1939Tp_00094] ⌈
J1939Tp_Shutdown() shall close all pending transport protocol connections, free
all resources and set the J1939Tp module into the global state J1939TP_OFF state.
⌋()
[SWS_J1939Tp_00095] ⌈
J1939Tp_Shutdown() shall not raise a notification about the pending frame
transmission or reception. ⌋ ( )
8.4.3 J1939Tp_GetVersionInfo
[SWS_J1939Tp_00089]⌈
Service Name J1939Tp_GetVersionInfo
void J1939Tp_GetVersionInfo (
Syntax Std_VersionInfoType* VersionInfo
)
Sync/Async Synchronous
Reentrancy Reentrant
Parameters
None
(inout)
43 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
⌋(SRS_BSW_00407)
8.4.4 J1939Tp_Transmit
[SWS_J1939Tp_00096]⌈
Service Name J1939Tp_Transmit
Std_ReturnType J1939Tp_Transmit (
PduIdType TxPduId,
Syntax const PduInfoType* PduInfoPtr
)
Sync/Async Synchronous
Reentrancy Reentrant for different PduIds. Non reentrant for the same PduId.
Parameters
None
(inout)
⌋(SRS_BSW_00357)
[SWS_J1939Tp_00101] ⌈
44 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
[SWS_J1939Tp_00030] ⌈
The function J1939Tp_Transmit() shall reject the transmit request and return the
status value E_NOT_OK if the transmission needs a transport protocol and the
channel is occupied (see also 7.5.7). ⌋ ( )
The term channel refers to a communication relation with identical SA and DA.
8.4.5 J1939Tp_CancelTransmit
[SWS_J1939Tp_00177]⌈
Service Name J1939Tp_CancelTransmit
Std_ReturnType J1939Tp_CancelTransmit (
Syntax PduIdType TxPduId
)
Sync/Async Synchronous
Reentrancy Reentrant for different PduIds. Non reentrant for the same PduId.
Parameters
None
(inout)
⌋()
[SWS_J1939Tp_00203] ⌈
J1939Tp_CancelTransmit shall return E_NOT_OK if ‘TxPduId’ is invalid, if
‘TxPduId’ is currently not active, if currently a direct frame is transmitted, if the last
TP.DT frame has already been transmitted during BAM transmission, or if the
TP.CM_EOMAck frame has already been received during CMDT transmission.⌋ ( )
[SWS_J1939Tp_00214] ⌈
45 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
8.4.6 J1939Tp_CancelReceive
[SWS_J1939Tp_00176]⌈
Service Name J1939Tp_CancelReceive
Std_ReturnType J1939Tp_CancelReceive (
Syntax PduIdType RxPduId
)
Sync/Async Synchronous
Parameters
None
(inout)
⌋()
[SWS_J1939Tp_00204] ⌈
J1939Tp_CancelReceive shall return E_NOT_OK if ‘RxPduId’ is invalid, if
‘RxPduId’ is currently not active, if currently a direct frame is received, if the last
TP.DT frame has already been received during BAM reception, or if the
TP.CM_EOMAck frame has already been sent during CMDT reception.⌋ ( )
[SWS_J1939Tp_00215] ⌈
The J1939Tp_CancelReceive API shall only be available when
J1939TpCancellationSupport is enabled. ⌋ ( )
8.4.7 J1939Tp_ChangeParameter
[SWS_J1939Tp_00180]⌈
Service Name J1939Tp_ChangeParameter
46 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
Std_ReturnType J1939Tp_ChangeParameter (
PduIdType id,
Syntax TPParameterType parameter,
uint16 value
)
Sync/Async Synchronous
Parameters
None
(inout)
Description Request to change a specific transport protocol parameter (e.g. block size).
⌋()
[SWS_J1939Tp_00206] ⌈
J1939Tp_ChangeParameter shall return E_NOT_OK if ‘id’ is invalid, if ‘parameter’
is not TP_BS, or if ‘value’ is larger than 255. ⌋ ( )
8.5.1 J1939Tp_RxIndication
[SWS_J1939Tp_00108]⌈
Service Name J1939Tp_RxIndication
void J1939Tp_RxIndication (
PduIdType RxPduId,
Syntax const PduInfoType* PduInfoPtr
)
Service ID
0x42
[hex]
Sync/Async Synchronous
Reentrancy Reentrant for different PduIds. Non reentrant for the same PduId.
RxPdu
ID of the received PDU.
Id
Parameters
(in) Contains the length (SduLength) of the received PDU, a pointer to a
Pdu
buffer (SduDataPtr) containing the PDU, and the MetaData related to this
InfoPtr
PDU.
Parameters
None
(inout)
Parameters
None
(out)
Description Indication of a received PDU from a lower layer communication interface module.
⌋(SRS_BSW_00359, SRS_BSW_00360)
The J1939Tp module provides the J1939Tp_RxIndication() API to allow the CanIf to
notify that a new N-PDU has been received.
[SWS_J1939Tp_00110] ⌈
The function J1939Tp_RxIndication shall be callable in interrupt context (it could be
called from the CAN receive interrupt). ⌋ (SRS_BSW_00333)
8.5.2 J1939Tp_TxConfirmation
[SWS_J1939Tp_00112]⌈
Service Name J1939Tp_TxConfirmation
void J1939Tp_TxConfirmation (
PduIdType TxPduId,
Syntax Std_ReturnType result
)
Sync/Async Synchronous
Reentrancy Reentrant for different PduIds. Non reentrant for the same PduId.
Parameters
None
(inout)
Parameters
None
(out)
⌋(SRS_BSW_00359, SRS_BSW_00360)
[SWS_J1939Tp_00114] ⌈
The function J1939Tp_TxConfirmation shall be callable in interrupt context (it could
be called from the CAN transmit interrupt). ⌋ (SRS_BSW_00333)
8.6.1 J1939Tp_MainFunction
[SWS_J1939Tp_00104]⌈
Service Name J1939Tp_MainFunction
void J1939Tp_MainFunction (
Syntax void
)
Service ID
0x04
[hex]
Main function of the J1939Tp. Used for scheduling purposes and timeout
Description
supervision.
⌋(SRS_BSW_00373)
[SWS_J1939Tp_00106] ⌈
The calling frequency of the function J1939Tp_MainFunction is determined by the
parameter J1939TpMainFunctionPeriod (see ECUC_J1939Tp_00044 : ). ⌋ ( )
This section defines all interfaces, which are required to fulfill the core functionality of
the module.
[SWS_J1939Tp_00116]⌈
Header
API Function Description
File
Det_Report- Service to report runtime errors. If a callout has been configured then
Det.h
RuntimeError this callout shall be called.
PduR_J1939- PduR_ Called after an I-PDU has been received via the TP API, the result
TpRxIndication J1939Tp.h indicates whether the transmission was successful or not.
PduR_J1939- This function is called after the I-PDU has been transmitted on its
PduR_
TpTx- network, the result indicates whether the transmission was
J1939Tp.h
Confirmation successful or not.
⌋()
This section defines all interfaces that are required to fulfill an optional functionality of
the module.
[SWS_J1939Tp_00060]⌈
API Function Header File Description
⌋()
9 Sequence Diagrams
The following sequence diagrams shall give an impression of the way the J1939
Transport Layer module shall behave and interoperate with other BSW modules.
They are not complete and not binding for the implementation.
J1939Tp_RxIndication()
PduR_J1939TpStartOfReception()
Direct PG
PduR_J1939TpCopyRxData()
PduR_J1939TpRxIndication()
J1939Tp_RxIndication()
J1939Tp_RxIndication()
PduR_J1939TpStartOfReception()
TP.CM_BAM
J1939Tp_RxIndication()
J1939Tp_RxIndication()
PduR_J1939TpStartOfReception()
TP.CM_RTS
J1939Tp_TxConfirmation()
CanIf_Transmit()
TP.CM_CTS
J1939Tp_TxConfirmation()
J1939Tp_TxConfirmation()
PduR_J1939TpRxIndication()
J1939Tp_Transmit()
PduR_J1939TpCopyTxData()
CanIf_Transmit()
J1939Tp_Transmit() Direct PG
J1939Tp_TxConfirmation()
PduR_J1939TpTxConfirmation()
J1939Tp_TxConfirmation()
J1939Tp_Transmit()
CanIf_Transmit()
J1939Tp_Transmit() TP.CM_BAM
CanIf_Transmit()
TP.DT
J1939Tp_TxConfirmation()
J1939Tp_TxConfirmation()
J1939Tp_Transmit()
CanIf_Transmit()
TP.CM_RTS
CanIf_Transmit()
TP.DT
J1939Tp_TxConfirmation()
J1939Tp_RxIndication()
PduR_J1939TpTxConfirmation()
TP.EOMACK
J1939Tp_Transmit()
TP.CM_RTS()
PduR_J1939TpStartOfReception()
TP.DT()
[YES]
TP.CM_CTS()
Next Packet set to first Packet of Block
TP.DT()
PduR_J1939TpCopyRxData()
PduR_J1939TpRxIndication()
TP.EOMACK()
PduR_J1939TpTxConfirmation()
10 Configuration Specification
In general, this chapter defines configuration parameters and their clustering into
containers. For general information about the definition of containers and
parameters, refer to the chapter 10.1 “Introduction to configuration specification” in
the SWS BSW General [15].
[SWS_J1939Tp_00084] ⌈
The consistency of the configuration must be checked by the configuration tool at
configuration time. Configuration rules and constraints for plausibility checks will be
performed where possible, during configuration time. ⌋ (SRS_BSW_00167)
+container
J1939TpTxChannel:
+subContainer EcucParamConfContainerDef
upperMultiplicity = *
lowerMultiplicity = 0
J1939TpGeneral:
+container EcucParamConfContainerDef
J1939TpGeneral: J1939TpDevErrorDetect:
+parameter
EcucParamConfContainerDef EcucBooleanParamDef J1939TpCancellationSupport:
EcucBooleanParamDef
defaultValue = false
+parameter lowerMultiplicity = 0
upperMultiplicity = 1
defaultValue = false
J1939Tp: EcucModuleDef J1939TpMainFunctionPeriod:
+container
+parameter EcucFloatParamDef
upperMultiplicity = 1
lowerMultiplicity = 0 min = 0
max = INF
+parameter J1939TpVersionInfoApi:
EcucBooleanParamDef
defaultValue = false
+subContainer
J1939Tp: EcucModuleDef J1939TpRxChannel: J1939TpRxProtocolType: +literal J1939TP_PROTOCOL_BAM:
EcucParamConfContainerDef EcucEnumerationParamDef EcucEnumerationLiteralDef
upperMultiplicity = 1
+parameter
lowerMultiplicity = 0 upperMultiplicity = * lowerMultiplicity = 0
lowerMultiplicity = 0 upperMultiplicity = 1
+literal J1939TP_PROTOCOL_CMDT:
EcucEnumerationLiteralDef
+container
J1939TpConfiguration: J1939TpRxCmNPduId:
EcucParamConfContainerDef J1939TpRxCmNPdu:
EcucParamConfContainerDef EcucIntegerParamDef
+parameter
symbolicNameValue = true
+subContainer max = 65535
min = 0
J1939TpRxRetrySupport:
EcucBooleanParamDef
+parameter
+reference J1939TpRxCmNPduRef:
lowerMultiplicity = 0
upperMultiplicity = 1 EcucReferenceDef
defaultValue = false
J1939TpRxDtNPdu: J1939TpRxDtNPduId:
J1939TpRxCancellationSupport:
EcucParamConfContainerDef EcucIntegerParamDef
EcucBooleanParamDef +parameter
+parameter
symbolicNameValue = true
lowerMultiplicity = 0 +subContainer max = 65535
upperMultiplicity = 1
min = 0
defaultValue = false
+reference J1939TpRxDtNPduRef:
J1939TpRxDynamicBlockCalculation: EcucReferenceDef
EcucBooleanParamDef
+parameter
lowerMultiplicity = 0
upperMultiplicity = 1
J1939TpTxFcNPdu: J1939TpTxFcNPduTxConfId:
defaultValue = false
EcucParamConfContainerDef +parameter EcucIntegerParamDef
min = 0 +parameter
max = 100 +reference J1939TpTxFcNPduRef:
lowerMultiplicity = 0 EcucReferenceDef
upperMultiplicity = 1
defaultValue = 80
J1939TpRxDa:
EcucIntegerParamDef
J1939TpRxPacketsPerBlock: +parameter
EcucIntegerParamDef max = 253
+parameter min = 0
min = 1 J1939TpRxSa:
lowerMultiplicity = 0
max = 255 EcucIntegerParamDef
upperMultiplicity = 1
lowerMultiplicity = 0 +parameter max = 253
upperMultiplicity = 1 min = 0
defaultValue = 16 lowerMultiplicity = 0
upperMultiplicity = 1
+subContainer
J1939TpRxPgPGN:
J1939TpRxPg: EcucIntegerParamDef
+parameter
EcucParamConfContainerDef
max = 262143
upperMultiplicity = * min = 0
lowerMultiplicity = 1
+parameter J1939TpRxPgDynLength:
EcucBooleanParamDef
+reference J1939TpRxNSduRef:
J1939TpRxNSdu:
EcucReferenceDef
EcucParamConfContainerDef
+subContainer lowerMultiplicity = 1
upperMultiplicity = * J1939TpRxNSduId:
+parameter EcucIntegerParamDef
symbolicNameValue = true
max = 65535
min = 0
J1939TpRxDirectNPdu: J1939TpRxDirectNPduId:
EcucParamConfContainerDef EcucIntegerParamDef
+parameter
symbolicNameValue = true
upperMultiplicity = 1
+subContainer lowerMultiplicity = 0 max = 65535
min = 0
+reference J1939TpRxDirectNPduRef:
EcucReferenceDef
J1939TpConfiguration:
EcucParamConfContainerDef J1939TpTxCmNPdu: J1939TpTxCmNPduTxConfId:
EcucParamConfContainerDef EcucIntegerParamDef
+parameter
symbolicNameValue = true
+subContainer max = 65535
min = 0
J1939TpTxDynamicBlockCalculation:
EcucBooleanParamDef
+parameter J1939TpTxDtNPduTxConfId:
J1939TpTxDtNPdu:
lowerMultiplicity = 0 EcucIntegerParamDef
EcucParamConfContainerDef +parameter
upperMultiplicity = 1
defaultValue = false symbolicNameValue = true
+subContainer max = 65535
min = 0
J1939TpTxCancellationSupport:
EcucBooleanParamDef +reference J1939TpTxDtNPduRef:
+parameter
EcucReferenceDef
lowerMultiplicity = 0
upperMultiplicity = 1
defaultValue = false
J1939TpRxFcNPduId:
J1939TpRxFcNPdu:
EcucIntegerParamDef
EcucParamConfContainerDef +parameter
J1939TpTxRetrySupport:
symbolicNameValue = true
EcucBooleanParamDef upperMultiplicity = 1
+parameter +subContainer max = 65535
lowerMultiplicity = 0
lowerMultiplicity = 0 min = 0
upperMultiplicity = 1
defaultValue = false
+reference J1939TpRxFcNPduRef:
EcucReferenceDef
J1939TpTxMaxPacketsPerBlock:
EcucIntegerParamDef
J1939TpTxDa:
min = 1 +parameter EcucIntegerParamDef
max = 255 +parameter
max = 253
lowerMultiplicity = 0
min = 0
upperMultiplicity = 1
lowerMultiplicity = 0
defaultValue = 255
upperMultiplicity = 1 J1939TpTxSa:
EcucIntegerParamDef
+parameter
max = 253
min = 0
lowerMultiplicity = 0
upperMultiplicity = 1
+subContainer
J1939TpTxPg: J1939TpTxPgPGN:
EcucParamConfContainerDef +parameter EcucIntegerParamDef
+parameter J1939TpTxPgDynLength:
EcucBooleanParamDef
J1939TpTxNSdu: J1939TpTxNSduId:
EcucIntegerParamDef
EcucParamConfContainerDef +parameter
lowerMultiplicity = 1 symbolicNameValue = true
+subContainer upperMultiplicity = * max = 65535
min = 0
+reference J1939TpTxNSduRef:
EcucReferenceDef
J1939TpTxDirectNPduTxConfId:
J1939TpTxDirectNPdu:
EcucIntegerParamDef
EcucParamConfContainerDef +parameter
symbolicNameValue = true
upperMultiplicity = 1
+subContainer max = 65535
lowerMultiplicity = 0
min = 0
+reference J1939TpTxDirectNPduRef:
EcucReferenceDef
J1939TpRxNSdu:
EcucParamConfContainerDef +reference J1939TpRxNSduRef: +destination Pdu:
EcucReferenceDef EcucParamConfContainerDef
lowerMultiplicity = 1
upperMultiplicity = * lowerMultiplicity = 0
upperMultiplicity = *
upperMultiplicity = 1
lowerMultiplicity = 0
upperMultiplicity = 1
lowerMultiplicity = 0 Shared Pdu for Shared Pdu for
bidirectional bidirectional
CMDT channels CMDT channels
J1939TpTxNSdu:
EcucParamConfContainerDef +reference J1939TpTxNSduRef: +destination
EcucReferenceDef
lowerMultiplicity = 1
upperMultiplicity = *
10.1.1 J1939Tp
Included Containers
Container Name Multiplicity Scope / Dependency
This container contains the configuration parameters and sub
J1939TpConfiguration 1 containers of the J1939Tp module that define the
communication paths.
This container describes the general configuration parameters
J1939TpGeneral 1
of the J1939Tp module.
10.1.2 J1939TpGeneral
Multiplicity 1
Type EcucBooleanParamDef
Default value false
Post-Build Variant Value false
Value Configuration Class Pre-compile time X All Variants
Link time --
Post-build time --
Scope / Dependency scope: local
No Included Containers
10.1.3 J1939TpConfiguration
Included Containers
Container Name Multiplicity Scope / Dependency
This container describes a reception channel of the J1939Tp
module. A channel referencing N-PDUs without MetaData is
used for all N-SDUs that share the same source address (SA)
J1939TpRxChannel 0..*
and the same destination address (BAM: DA = 0xFF, CMDT:
DA != 0xFF). A channel with N-PDUs with MetaData is used
for all possible source and destination addresses.
This container describes a transmission channel of the
J1939Tp module. A channel referencing N-PDUs without
MetaData is used for all N-SDUs that share the same source
J1939TpTxChannel 0..* address (SA) and the same destination address (BAM: DA =
0xFF, CMDT: DA != 0xFF). A channel with N-PDUs with
MetaData is used for all possible source and destination
addresses.
10.1.4 J1939TpRxChannel
Type EcucIntegerParamDef
Range 0 .. 253
Default value --
Post-Build Variant
true
Multiplicity
Post-Build Variant Value true
Multiplicity ConfigurationPre-compile time X VARIANT-PRE-COMPILE
Class Link time X VARIANT-LINK-TIME
Post-build time X VARIANT-POST-BUILD
Value Configuration Class Pre-compile time X VARIANT-PRE-COMPILE
Link time X VARIANT-LINK-TIME
Post-build time X VARIANT-POST-BUILD
Scope / Dependency scope: local
Included Containers
Container Name Multiplicity Scope / Dependency
This N-PDU represents the TP.CM frame of a J1939 transport
protocol session. TP.CM is used both by BAM and CMDT to
J1939TpRxCmNPdu 1 initialize the connection. For CMDT, it is also used to abort the
connection. This N-PDU consumes a meta data item of type
CAN_ID_32.
This N-PDU represents the TP.DT frame of a J1939 transport
protocol session. TP.DT is used both by BAM and CMDT to
J1939TpRxDtNPdu 1
transfer the contents of an N-SDU. This N-PDU consumes a
meta data item of type CAN_ID_32.
J1939TpRxPg 1..* Parameter group received by the J1939 transport layer.
This N-PDU represents the TP.CM frame that is used in
J1939TpTxFcNPdu 0..1 reverse direction for a J1939 transport protocol session using
the CMDT protocol type. TP.CM in reverse direction is used for
69 of 84 Document ID 425: AUTOSAR_SWS_SAEJ1939TransportLayer
Specification of a Transport Layer for SAE J1939
AUTOSAR CP R20-11
10.1.5 J1939TpRxCmNPdu
No Included Containers
10.1.6 J1939TpRxDtNPdu
No Included Containers
10.1.7 J1939TpRxPg
Included Containers
Container Name Multiplicity Scope / Dependency
This N-PDU represents the short frame that is used for a
dynamic length PGN when it has a length of less that 8 bytes.
J1939TpRxDirectNPdu 0..1 This N-PDU consumes a meta data item of type CAN_ID_32.
Please note: This sub container is only necessary when
J1939TpRxPgDynLength is TRUE.
This container describes the parameters that are relevant for
the reception of a specific N-SDU. This N-SDU produces meta
J1939TpRxNSdu 1..*
data items of type SOURCE_ADDRESS_16,
TARGET_ADDRESS_16, and PRIORITY_8.
10.1.8 J1939TpRxDirectNPdu
No Included Containers
10.1.9 J1939TpRxNSdu
No Included Containers
10.1.10 J1939TpTxFcNPdu
No Included Containers
10.1.11 J1939TpTxChannel
Name J1939TpTxDynamicBlockCalculation
Parent Container J1939TpTxChannel
Description Enable dynamic calculation of "maximum number of packets that can be
sent" value in TP.CM_RTS, based on the available amount of data in
upper layers reported via PduR_J1939TpCopyTxData.
Multiplicity 0..1
Type EcucBooleanParamDef
Default value false
Post-Build Variant
false
Multiplicity
Post-Build Variant Value false
Multiplicity ConfigurationPre-compile time X All Variants
Class Link time --
Post-build time --
Value Configuration Class Pre-compile time X All Variants
Link time --
Post-build time --
Scope / Dependency scope: local
Included Containers
Container Name Multiplicity Scope / Dependency
This N-PDU represents the TP.CM frame that is used in
reverse direction for a J1939 transport protocol session using
the CMDT protocol type. TP.CM in reverse direction is used for
intermediate and final acknowledgement of received data and
J1939TpRxFcNPdu 0..1 to abort the connection. This N-PDU consumes a meta data
item of type CAN_ID_32.
Please note: This sub container is only required when
J1939TpTxProtocolType is J1939TP_PROTOCOL_CMDT or
when it is not configured at all.
This N-PDU represents the TP.CM frame of a J1939 transport
protocol session. TP.CM is used both by BAM and CMDT to
J1939TpTxCmNPdu 1 initialize the connection. For CMDT, it is also used to abort the
connection. This N-PDU produces a meta data item of type
CAN_ID_32.
This N-PDU represents the TP.DT frame of a J1939 transport
protocol session. TP.DT is used both by BAM and CMDT to
J1939TpTxDtNPdu 1
transfer the contents of an N-SDU. This N-PDU produces a
meta data item of type CAN_ID_32.
J1939TpTxPg 1..* Parameter group transmitted by the J1939 transport layer.
10.1.12 J1939TpRxFcNPdu
No Included Containers
10.1.13 J1939TpTxCmNPdu
No Included Containers
10.1.14 J1939TpTxDtNPdu
No Included Containers
10.1.15 J1939TpTxPg
Included Containers
Container Name Multiplicity Scope / Dependency
This N-PDU represents the short frame that is used for a
dynamic length PGN when it has a length of less that 8 bytes.
J1939TpTxDirectNPdu 0..1 This N-PDU produces a meta data item of type CAN_ID_32.
Please note: This sub container is only necessary when
J1939TpTxPgDynLength is TRUE.
This container describes the parameters that are relevant for
the transmission of a specific N-SDU. This N-SDU consumes
J1939TpTxNSdu 1..*
meta data items of type SOURCE_ADDRESS_16,
TARGET_ADDRESS_16, and PRIORITY_8.
10.1.16 J1939TpTxDirectNPdu
J1939TpTxPgDynLength is TRUE.
Configuration Parameters
No Included Containers
10.1.17 J1939TpTxNSdu
Link time --
Post-build time --
Scope / Dependency scope: ECU
No Included Containers