CLASSIC
Modul: ethif
Rolle: constitutive
Konfidenz: 95%
SNIP_CLASSIC_ETHIF_SECTION_8_3_51_EthIf_Transmit
Wortlaut
8.3.51 EthIf_Transmit
[SWS_EthIf_00075] Definition of API function EthIf_Transmit ⌈
Service Name
EthIf_Transmit
Syntax
Std_ReturnType EthIf_Transmit (
uint8 CtrlIdx,
Eth_BufIdxType BufIdx,
Eth_FrameType FrameType,
boolean TxConfirmation,
uint16 LenByte,
const uint8* PhysAddrPtr
)
Service ID [hex]
0x0a
Sync/Async
Synchronous
Reentrancy
Reentrant for different buffer indexes and Ctrl indexes
CtrlIdx
Index of the Ethernet controller within the context of the Ethernet
Interface
BufIdx
Index of the buffer resource
FrameType
Ethernet frame type
TxConfirmation
Activates transmission confirmation
LenByte
Data length in byte
Parameters (in)
PhysAddrPtr
Physical target address (MAC address) in network byte order
Parameters (inout)
None
Parameters (out)
None
Return value
Std_ReturnType
E_OK: success
E_NOT_OK: transmission failed
Description
Triggers transmission of a previously filled transmit buffer
Available via
EthIf.h
⌋()
[SWS_EthIf_00250] ⌈If CtrlIdx refers to an EthIfCtrl where an EthIfVlanID is configured, the parameters FrameType is not used, and 0x8100 is provided to <EthDrv>
_Transmit instead.⌋()
[SWS_EthIf_00076] ⌈If the latest accepted controller mode is equal to ETH_MODE_ACTIVE or ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST for the given EthIfController,
then the function EthIf_Transmit shall forward the call to the respective Ethernet
Controller Driver. Otherwise the function shall reject the request for a transmission and
return with E_NOT_OK.⌋()
[SWS_EthIf_00077] ⌈If development error detection is enabled: the function shall
check that the service EthIf_Init was previously called. If the check fails, the function shall raise the development error ETHIF_E_UNINIT.⌋()
[SWS_EthIf_00078] ⌈If development error detection is enabled: the function shall
check the parameter CtrlIdx for being valid. If the check fails, the function shall
raise the development error ETHIF_E_INV_CTRL_IDX.⌋()
[SWS_EthIf_00079] ⌈If development error detection is enabled: the function shall
check the parameter BufIdx for being valid. If the check fails, the function shall raise
the development error ETHIF_E_INV_PARAM.⌋()
[SWS_EthIf_00080] ⌈If development error detection is enabled: the function shall
check the parameter PhysAddrPtr for being valid. If the check fails, the function
shall raise the development error ETHIF_E_PARAM_POINTER.⌋()
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_EthernetInterface.pdf |
|---|---|
| Dokumentseite | Seite 101 |
| Ziel-Modul | ethif (classic) |
| Ziel-Anforderung | SWS_Std_00005 |
| Semantische Rolle | constitutive |
| Automatisierungs-Konfidenz | 0.95 |