CLASSIC
Modul: linif
Rolle: constitutive
Konfidenz: 95%
SNIP_CLASSIC_LINIF_SECTION_8_2_3_LinIf_Transmit
Wortlaut
8.2.3 LinIf_Transmit
[SWS_LinIf_00201] Definition of API function LinIf_Transmit ⌈
Service Name
LinIf_Transmit
Syntax
Std_ReturnType LinIf_Transmit (
PduIdType TxPduId,
const PduInfoType* PduInfoPtr
)
Service ID [hex]
0x49
Sync/Async
Synchronous
Reentrancy
Reentrant for different PduIds. Non reentrant for the same PduId.
TxPduId
Identifier of the PDU to be transmitted
Parameters (in)
PduInfoPtr
Length of and pointer to the PDU data and pointer to MetaData.
Parameters (inout)
None
Parameters (out)
None
Return value
Std_ReturnType
E_OK: Transmit request has been accepted.
E_NOT_OK: Transmit request has not been accepted.
Description
Requests transmission of a PDU.
Available via
LinIf.h
⌋(SRS_Lin_01571)
Note: TxPduId is the identifier of LIN frame for upper layer (not the LIN protected ID).
This parameter is used to determine the corresponding LIN protected ID (PID) and
implicitly the LIN Driver instance as well as the corresponding LIN Controller device.
[SWS_LinIf_00105] ⌈The function LinIf_Transmit shall indicate a request from an
upper layer to transmit a frame specified by the parameter TxPduId.⌋()
[SWS_LinIf_00341] ⌈The function LinIf_Transmit shall only mark a Sporadic
frame (LIN master node) or an Event-triggered frame (LIN slave node) as pending for transmission and shall ignore other frame types.⌋()
[SWS_LinIf_00700] ⌈The function LinIf_Transmit shall also return E_OK in case
the Pdu belongs to a non-Sporadic frame (LIN master node) or non-Event-triggered frame (LIN slave node) and LIN Interface is initialized.⌋()
[SWS_LinIf_00106] ⌈The function LinIf_Transmit shall tolerate repeated invocations while the Sporadic frame (LIN master node) or Event-triggered frame
(LIN slave node) is still pending.⌋()
[SWS_LinIf_00570] ⌈If development error detection is enabled and the parameter
PduInfoPtr has an invalid value, the function LinIf_Transmit shall raise the development error code LINIF_E_PARAM_POINTER.⌋()
[SWS_LinIf_00575] ⌈If development error detection is enabled and the parameter
TxPduId has an invalid value, the function LinIf_Transmit shall raise the development error code LINIF_E_PARAMETER.⌋()
[SWS_LinIf_00719] ⌈LinIf_Transmit() shall return E_NOT_OK in case the LinIf’s
current schedule is NULL_SCHEDULE. This requirement is only applicable to LIN master nodes.⌋()
Caveats: The LIN Interface has to be initialized with a call of LinIf_Init before this
API service may be called, see [SRS_BSW_00487].
Versionen & Provenienz · Zugeordnete Anforderungen
Diese Angaben zeigt der Versions-Explorer.
Begründung & Zuweisungs-Evidenz
Cited verbatim in the snippet (deterministic citation).
Dokumenten-Herkunft & Rückverfolgbarkeit
| Spezifikations-Dokument | SWS_LINInterface.pdf |
|---|---|
| Dokumentseite | Seite 79 |
| Ziel-Modul | linif (classic) |
| Ziel-Anforderung | SWS_Std_00005 |
| Semantische Rolle | constitutive |
| Automatisierungs-Konfidenz | 0.95 |