Wireless Ethernet Driver (WEth)

Initializes the Wireless Ethernet Driver

Enables / disables the indexed controller

Obtains the state of the indexed controller

Obtains the physical source address used by the indexed controller

Provides access to a transmit buffer of the specified controller

Triggers transmission of a previously filled transmit buffer

Triggers frame reception.

Triggers frame transmission confirmation

Returns the version information of this module

Sets the physical source address used by the indexed controller

Update the physical source address to/ from the indexed context filter. If the Wireless Ethernet Controller is not capable to do the filtering, the software has to do this.

Support for indirect transmissions (extended frame timing constraints) and mechanisms for channel selection when using multiple channels. Used for polling state changes. Calls Eth If _ Ctrl Mode Indication when the controller mode changed.

Returns the following list according to IEEE 802.11 - 2012, where the maximal possible value shall denote an invalid value, e.g. if this counter is not available: 1. dot11STAStatistics Transmitted Octets In AMSDUCount 2. dot11STAStatistics Receiv ed Octets In AMSDUCount 3. dot11STAStatistics Transmitted Octets In AMPDUCount 4. dot11STAStatistics Received Octets In AMPDUCount 5. dot11STAStatistics Transmitted Octets In Granted RDGCount

Configures a transceivers registers or triggers a function offered by the receiver

Reads a transceiver register

Read out values related to the transmit direction for a transmitte d packet. For example, this could be transaction ID belonging to one single packet.This API is valid only within the context of WEth_ Tx Confirmation.

Set values related to the transmit direction for a specific buffer (packet to be sent). For example, this can be the desired transmit power or the channel belonging to one single packet.

Read out values related to the receive direction for a received packet. For example, this could be RSSI or Channel belonging to one single packet.This API is valid only within the context of WEth_ Receive

Returns the following list according to IEEE 802.11 - 2012, where the maximal possible value shall denote an invalid value, e.g. if this counter is not available: 1. dot11STAStatistics Transmitted F ragment Count 2. dot11STAStatistics Group Transmitted Frame Count 3. dot11STAStatistics Failed Count 4. dot11STAStatistics Retry Count 5. dot11STAStatistics Multiple Retry Count 6. dot11STAStatistics Frame Duplicate Count 7. dot11STAStatistics RTSSuccess C ount 8. dot11STAStatistics RTSFailure Count 9. dot11STAStatistics ACKFailure Count 10. dot11STAStatistics Qos Transmitted Fragment Count 11. dot11STAStatistics Qos Failed Count 12. dot11STAStatistics Qos Retry Count 13. dot11STAStatistics Qos Multiple Retr y Count 14. dot11STAStatistics Qos Frame Duplicate Count 15. dot11STAStatistics Qos RTSSuccess Count 16. dot11STAStatistics Qos RTSFailure Count 17. dot11STAStatistics Qos ACKFailure Count 18. dot11STAStatistics Qos Received Fragment Count 19. dot11STAStat istics Qos Transmitted Frame Count 20. dot11STAStatistics Qos Discarded Frame Count 21. dot11STAStatistics Qos MPDUs Received Count 22. dot11STAStatistics Qos Retries Received Count 23. dot11STAStatistics Received Fragment Count 24. dot11STAStatistics Grou p Received Frame Count 25. dot11STAStatistics FCSError Count 26. dot11STAStatistics Transmitted Frame Count 27. dot11STAStatistics RSNAStats CMACICVErrors 28. dot11STAStatistics RSNAStats CMACReplays 29. dot11STAStatistics RSNAStats Robust Mgmt CCMPReplays 30. dot11STAStatistics RSNAStats TKIPICVErrors 31. dot11STAStatistics RSNAStats TKIPReplays 32. dot11STAStatistics RSNAStats CCMPDecrypt Errors 33. dot11STAStatistics RSNAStats CCMPReplays 34. dot11STAStatistics Transmitted AMSDUCount 35. dot11STAStatisti cs Failed AMSDUCount 36. dot11STAStatistics Retry AMSDUCount 37. dot11STAStatistics Multiple Retry AMSDUCount 38. dot11STAStatistics AMSDUAck Failure Count 39. dot11STAStatistics Received AMSDUCount 40. dot11STAStatistics Transmitted AMPDUCount 41. dot11ST AStatistics Transmitted MPDUs In AMPDUCount 42. dot11STAStatistics AMPDUReceived Count 43. dot11STAStatistics MPDUIn Received AMPDUCount 44. dot11STAStatistics AMPDUDelimiter CRCError Count 45. dot11STAStatistics Implicit BARFailure Count 46. dot11STAStati stics Explicit BARFailure Count 47. dot11STAStatistics Channel Width Switch Count 48. dot11STAStatistics Twenty MHz Frame Transmitted Count 49. dot11STAStatistics Forty MHz Frame Transmitted Count 50. dot11STAStatistics Twenty MHz Frame Received Count 51. dot11STAStatistics Forty MHz Frame Received Count 52. dot11STAStatistics PSMPUTTGrant Duration 53. dot11STAStatistics PSMPUTTUsed Duration 54. dot11STAStatistics Granted RDGUsed Count 55. dot11STAStatistics Granted RDGUnused Count 56. dot11STAStatistics Tr ansmitted Frames In Granted RDGCount 57. dot11STAStatistics Dual CTSSuccess Count 58. dot11STAStatistics Dual CTSFailure Count 59. dot11STAStatistics RTSLSIGSuccess Count 60. dot11STAStatistics RTSLSIGFailure Count 61. dot11STAStatistics Beamforming Frame Count 62. dot11STAStatistics STBCCTSSuccess Count 63. dot11STAStatistics STBCCTSFailure Count 64. dot11STAStatisticsnon STBCCTSSuccess Count 65. dot11STAStatisticsnon STBCCTSFailure Count

Triggers transmission of a previously filled transmit buffer that is waiting in a software priority queue.

Request transmission of an Ethernet frame, where each upper layer a header part as element of a single linked list. All headers together with the payload form an entire Ethernet frame Tags: atp.Status=draft

Implementation specific structure of the post build configuration

Wir eless radio parameters for a packet that has been received.

Wireless radio parameters for a packet that has to be transmitted.

The Wireless Ethernet Driver is using a zero - based index to abstract the access for upper software layers. The parameter WEth_CtrlId within configuration corresponds to parameter CtrlId used in the API.

A buffer index ( BufId) indent ifies a Wireless Ethernet buffer processed by Wireless Ethernet Driver API functions. Each controller’s buffers are identified by buffer indexes 0 to (n - 1) where n is the number of buffers processed by the corresponding controller. Buffer indexes are valid within a tuple <CtrlId, BufId> only. A BufId uniquely identifies the buffer used for a Wireless Ethernet Driver.

The Wireless Ethernet Driver module shall support pre - com pile time, link time and post - build time configuration.

In case development error detection is enabled for the Wireless Ethernet Driver module: The Wireless Ethernet Driver module shall check API parameters for validity and report detected errors to the DET.

Type of error Related error code Error value Invalid controller index WETH_ E_ INV_ CTRL_ ID 0x01 WEth module was not initialized WETH_ E_ UNINIT 0x02 Invalid pointer in parameter list WETH_ E_ PARAM_ POINTER 0x03

Module Header File Imported Type Com Stack_ Types Com Stack_ Types.h Buf Req _ Return Type Dem Rte_ Dem_ Type.h Dem _ Event Id Type Rte_ Dem_ Type.h Dem _ Event Status Type Eth Eth_ General Types.h Eth _ Buf Idx Type Eth_ General Types.h Eth _ Data Type Eth_ General Types.h Eth _ Filter Action Type Eth_ General Types.h Eth _ Frame Type Eth_ General Types.h Eth _ Mode Type (draft) Eth_ General Types.h Eth _ Rx Status Type Std Std_ Types.h Std _ Return Type Std_ Types.h Std _ Version Info Type

The Wireless Ethernet Driver module shall reject configurations with partition mappings, which are not supported by the implementation.

[SWS_WEth_00042] ⌈The function shall: • Put the controller in the specified mode given in the parameter ’CtrlMode’ – Upon mode ETH_MODE_DOWN the driver shall: * Disable the Wireless Ethernet controller * Reset all transmit and receive buffers (i.e. ignore all pending transmis- sion and reception requests) – Upon mode ETH_MODE_ACTIVE: * Enable all transmit and receive buffers * Enable the Wireless Ethernet controller ⌋

[SWS_WEth_00043] ⌈If development error detection is enabled: the function shall check that the service WEth_Init was previously called. If the check fails, the function shall raise the development error WETH_E_UNINIT.⌋

[SWS_WEth_00044] ⌈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 WETH_E_INV_CTRL_IDX.⌋

[SWS_WEth_00045] ⌈Caveat: The function requires previous controller initialization (WEth_Init).⌋

[SWS_WEth_00047] ⌈The function shall read the current controller mode.⌋

[SWS_WEth_00048] ⌈If development error detection is enabled: the function shall check that the service WEth_Init was previously called. If the check fails, the function shall raise the development error WETH_E_UNINIT.⌋

[SWS_WEth_00049] ⌈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 WETH_E_INV_CTRL_IDX.⌋

[SWS_WEth_00050] ⌈If development error detection is enabled: the function shall check the parameter CtrlModePtr for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋

[SWS_WEth_00051] ⌈Caveat: The function requires previous controller initialization (WEth_Init).⌋

Th e function shall write the specified parameters in the transceivers registers for the indexed radio through a controller specific bus interface of the indexed controller.

[SWS_WEth_00060] ⌈If development error detection is enabled: the function shall check that the service WEth_Init was previously called. If the check fails, the function shall raise the development error WETH_E_UNINIT.⌋()

[SWS_WEth_00061] ⌈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 WETH_E_INV_CTRL_IDX.⌋()

[SWS_WEth_00063] ⌈Caveat: The function requires previous controller initialization (WEth_Init).⌋()

[SWS_WEth_00065] ⌈The function shall read the specified transceiver register through the MII of the indexed controller.⌋()

If development error detection is enabled: the function shall check that the service W Eth_Init was previously called . If the check fails, the function shall raise the development error W ETH_E_UNINIT .

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 W ETH_E_INV_CTRL_IDX .

If development error detection is e nabled: the function shall check the parameter RegValPtr for being valid . If the check fails, the function shall raise the development error W ETH_E_PARAM_POINTER .

[SWS_WEth_00070] ⌈Caveat: The function requires previous controller initialization (WEth_Init).⌋()

[SWS_WEth_00078] ⌈The function shall provide a transmit buffer resource. The Wire- less Ethernet Driver shall lock the buffer until it receives a subsequent call of WEth_ Transmit service with the buffer index returned in the BufIdxPtr parameter.⌋

[SWS_WEth_00079] ⌈If a buffer requested with WEth_ProvideTxBuffer that is larger than the available buffer length, the buffer shall not be locked but return the available length and BUFREQ_E_OVFL.⌋

[SWS_WEth_00080] ⌈If all available buffers are in use the component shall return BUFREQ_E_BUSY.⌋

[SWS_WEth_00081] ⌈If development error detection is enabled: the function shall check that the service WEth_Init was previously called. If the check fails, the function shall raise the development error WETH_E_UNINIT.⌋

[SWS_WEth_00082] ⌈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 WETH_E_INV_CTRL_IDX.⌋

[SWS_WEth_00083] ⌈If development error detection is enabled: the function shall check the parameter BufIdxPtr for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋

[SWS_WEth_00084] ⌈If development error detection is enabled: the function shall check the parameter BufPtr for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋

[SWS_WEth_00085] ⌈If development error detection is enabled: the function shall check the parameter LenBytePtr for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋

[SWS_WEth_00086] ⌈Caveat: The function requires previous controller initialization (WEth_Init).⌋

[SWS_WEth_00088] ⌈The function shall build the Ethernet header with the given phys- ical target address (MAC address) and trigger the transmission of a previously filled transmit buffer.⌋ After transmission, the driver needs to release the allocated buffer. It is up to the implementation when the actual buffer release shall occur, e.g. within the context of the WEth_TxConfirmation, the WEth_MainFunction, or during the next WEth_ ProvideTxBuffer.

[SWS_WEth_00090] ⌈If development error detection is enabled: the function shall check that the service WEth_Init was previously called. If the check fails, the function shall raise the development error WETH_E_UNINIT.⌋

[SWS_WEth_00091] ⌈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 WETH_E_INV_CTRL_IDX.⌋

[SWS_WEth_00092] ⌈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 WETH_E_INV_PARAM.⌋

[SWS_WEth_00093] ⌈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 WETH_E_PARAM_POINTER.⌋

[SWS_WEth_00094] ⌈Caveat: The function requires previous buffer request (WEth_ ProvideTxBuffer).⌋

[SWS_WEth_00096] ⌈The function shall read the next frame from the receive buffers. The function passes the received frame to the Ethernet interface using the callback function WEthIf_RxIndication and indicates if there are more frames in the receive buffers.⌋

[SWS_WEth_00097] ⌈If development error detection is enabled: the function shall check that the service WEth_Init was previously called. If the check fails, the function shall raise the development error WETH_E_UNINIT.⌋

[SWS_WEth_00098] ⌈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 WETH_E_INV_CTRL_IDX.⌋

[SWS_WEth_00099] ⌈Caveat: The function requires previous controller initialization (WEth_Init).⌋

[SWS_WEth_00101] ⌈The function shall check all filled transmit buffers for successful transmission. The function issues transmit confirmation for each transmitted frame using the callback function EthIf_TxConfirmation if requested by the previous call of WEth_Transmit service.⌋

[SWS_WEth_00102] ⌈If transmission confirmation was enabled by a previous call to WEth_Transmit function the function shall release the buffer resource.⌋

If development error detection is enabled: the function shall check that the service W Eth_Init was previously called . If the check fails, the function shall raise the development error W ETH_E_UNINIT .

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 W ETH_E_INV_CTRL_IDX .

[SWS_WEth_00105] ⌈Caveat: The function requires previous initialization (WEth_ Init).⌋

Dem _ Set - Event Status Dem.h Called by SW - Cs or BSW modules to report monitor status information to the Dem. BSW modules calling Dem_ Set Event Status can safely ignore the return value. This API will be available only if ({Dem/ Dem Config Set/ Dem Event Parameter/ Dem Event Reporting Type} == STANDARD_ REPORTING) Eth If _ Ctrl - Mode - Indication Eth If.h Called asynchronously when mode has been read out. Triggered by previous Eth_ Set Controller Mode call. Can directly be called within the trigger functions. Eth If _ Get - Version Info E th If.h Returns the version information of this module Eth If _ Main - Function Rx Sch M_ Eth If.h The function checks for new received frames and issues reception indications in polling mode. Eth If _ Main - Function Tx Sch M_ Eth If.h The function issues t ransmission confirmations in polling mode. It checks also for transceiver state changes. Eth If _ Rx - Indication Eth If.h Handles a received frame received by the indexed controller Eth If _ Tx - Confirmation Eth If.h Confirms frame transmission by the indexed controller

Det _ Report Error Det.h Service to report development errors.

[SWS_WEth_00129] ⌈If development error detection is enabled: the function shall check the controller mode for being active (ETH_MODE_ACTIVE). If the check fails, the function shall raise the development error WETH_E_INV_MODE.⌋

[SWS_WEth_00132] ⌈If development error detection is enabled: the function shall check the controller mode for being active (ETH_MODE_ACTIVE). If the check fails, the function shall raise the development error WETH_E_INV_MODE.⌋

If development error detection is enabled: the function shall check the controller mode for being active (ETH_MODE_ACTIVE). If the check fails, the function shall raise the development error W ETH_E_INV_MODE.

[SWS_WEth_00136] ⌈If development error detection is enabled: the function shall check the parameter VersionInfoPtr for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

[SWS_WEth_00144] ⌈If the physical source address (MAC address) is set to FF:FF:FF: FF:FF:FF, this shall completely open the filter.⌋

[SWS_WEth_00146] ⌈If this API is used and the hardware does not support filtering, promiscuous mode shall be enabled during initialization.⌋

If the physical source address (MAC address) is set to 00 : 00 : 00 : 00 : 00 : 00 , this shall reduce the filter to the controllers unique unicast MAC address and end promiscuous mode if it was turned on .

[SWS_WEth_00150] ⌈The function shall update the physical address receive filter of the indexed controller.⌋

[SWS_WEth_00153] ⌈When calling the callback function WEthIf_RxIndication broad- cast frames shall be indicated to the Ethernet Interface (see [9]).⌋

If development error detection is enabled: the function shall check that the service W Eth_Init was previously called . If the check fails, the function shall raise the development error W ETH_E_UNINIT .

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 WETH_E_INV_CTRL_IDX .

If development error detection is enabled the function shall check t he parameter PhysAddrPtr for being valid . If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER .

Caveat: The function requires previous controller initialization ( Eth_Init ).

[SWS_WEth_00168] ⌈The function shall check the access to the Wireless Ethernet controller. If the check fails, the function shall raise the production error WETH_E_ ACCESS and return E_NOT_OK.⌋

Error Name: WETH_ E_ACCESS Short Description: Wireless Ethernet Controller Access Failure. Long Description: Monitors the access to the Wireless Ethernet Controller in the context of the WEth_MainFunction. . Detection Criteria: Fail When polling for sta te changes of the Wireless Ethernet Controller fails the module shall report the extended production error with event status DEM_EVENT_STATUS_PREFAILED to DEM. Pass When polling for state changes of the Wireless Ethernet Controller succeeds the module sh all report the extended production error with event status DEM_EVENT_STATUS_PREPASSED to DEM. Secondary Parameters: None . Time Required: None. Monitor Frequency None .

The Wireless Ethern et Driver shall ensure that the base addresses of all reception and transmission buffers fulfill the memory alignment requirements for all AUTOSAR data types of the respective platform such that efficient DMA and Memcopy operations are possible.

The function shall read a list of values from the indexed controller according to [17] .

[SWS_WEth_00235] ⌈If development error detection is enabled: the function shall check that the service WEth_Init was previously called. If the check fails, the function shall raise the development error WETH_E_UNINIT.⌋()

[SWS_WEth_00236] ⌈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 WETH_E_INV_CTRL_IDX.⌋()

[SWS_WEth_00237] ⌈If development error detection is enabled: the function shall check the parameter RxStats for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

The function WEth_GetWEthertStats 32 shall be pre compile time configurable On/Off by the configuration parameter: W EthGetWEtherSta tsApi.

Used for polling state changes. Calls EthIf_CtrlModeIndication when the controller mode changed.

[SWS_WEth_00243] Upstream requirements: SRS_BSW_00359 ⌈Wireless Ethernet Driver shall call EthIf_TxConfirmation to indicate a successful transmission from the Interrupt routine (if the notification has been enabled).⌋

Wireless Ethernet Driver shall call EthIf_RxIndication to indicate a successful reception from the Interrupt routine .

[SWS_WEth_00245] ⌈The Wireless Ethernet driver module will receive a frame when the destination Address match the PhyAddrPtr passed here. (e.g matching can be done via hash table or simple pattern matching)⌋ Note: Underlying HW mechanism can be used if available. Otherwise the Ethernet driver needs to do this by software.

[SWS_WEth_00246] ⌈If the matching is positive, the upper layer shall be notified by calling RxIndication() callback. If the matching is negative, the frame shall be discarded.⌋

[SWS_WEth_00256] Call of EthIf_TxConfirmation with result set to E_NOT_OK. Status: DRAFT Upstream requirements: SRS_Eth_00190, SRS_Eth_00191 ⌈Wireless Ethernet SW Driver shall call EthIf_TxConfirmation with Result set to E_NOT_OK if the transmission failed.⌋

[SWS_WEth_00280] Release all locked transmission buffer of an Ethernet con- troller for wireless communication Status: DRAFT Upstream requirements: SRS_Eth_00191 ⌈All locked transmit buffers shall be released if the Rx/Tx communication of the indexed controller is disabled via WEth_SetControllerMode.⌋

[SWS_WEth_00281] Release all locked transmission buffer of an Ethernet con- troller for wireless communication Status: DRAFT Upstream requirements: SRS_Eth_00191 ⌈All pending transmit buffers shall be released if the Rx/Tx communication of the in- dexed controller is disabled via WEth_SetControllerMode.⌋

[SWS_WEth_00313] Precondition checks for transmission request with direct data provision Status: DRAFT Upstream requirements: SRS_Eth_00190, SRS_BSW_00350, SRS_BSW_00386 ⌈If WEth_ImmediateTransmit has been called and the given CtrlIdx has a trans- mission buffer configured, then the Ethernet driver shall perform the following precon- dition checks in the following order: 1. If the Ethernet frame, which is requested to be transmitted, matches the config- ured priority of the transmission buffer at the given CtrlIdx, then skip the next precondition check and proceed. Otherwise report runtime error WETH_E_UN- KNOWN_EGRESS_PRIORITY and procceed. 2. If the Ethernet frame could be enqueued in a transmission buffer at the given CtrlIdx where no priority is configured (i.e. try to enqueue the Ethernet frame in a default transmission queue (see [SWS_WEth_CONSTR_00311])), then pro- ceed. Otherwise return with E_NOT_OK. 3. If on transmission buffer is available, then proceed. Otherwise report an runtime error error code WETH_E_EGRESS_QUEUE_OCCUPIED and return with E_NOT_- OK If all precondition checks passed successfully, then proceed with the evaluation of the Ethernet frame.⌋

[SWS_WEth_00314] Evaluation of an Ethernet frame given with WEth_Immedi- ateTransmit transmit request Status: DRAFT Upstream requirements: SRS_Eth_00190, SRS_BSW_00350, SRS_BSW_00386 ⌈If WEth_ImmediateTransmit has been called, a transmission buffer is reserved and the Wireless Ethernet driver is requested to evaluate the given Ethernet frame parts (according to [SWS_WEth_00313]), then the Wireless Ethernet driver shall eval- uate the given single linked list given with HeaderListPtr and the payload Pay- loadPtr and payload length PayloadLength by considering the following steps: 1. Traverse the single linked list given with HeaderListPtr by starting with the first element HeaderListPtr and continue with next element of the single linked list given with NextListElemPtr until an element of the single linked list is reached where NextListElemPtr is set to NULL_PTR. Perform the following action at each element of the single linked list: • Store the the given data location (DataPtr) and the given data length ( DataLength) • accumulate the DataLength) 2. calculate the overall length by considering accumulated DataLength of all single linked list elements and the length of payload given with PayloadLength If the calculated Ethernet frame length is larger then the available egress queue ele- ment, then abort the evaluation and return with E_NOT_OK, or if WEthDevErrorDe- tect is set to TRUE, WEth driver shall call Det_ReportError with the error code WETH_E_EXCEED_EGRESS_QUEUE_ELEMENT. Otherwise proceed with construction of the Ethernet frame.⌋

[SWS_WEth_00315] Construction of an Ethernet frame given with WEth_Imme- diateTransmit transmit request and WEthCtrlEnableEgressHardwareSup- portedDataTransfer is set to FALSE Status: DRAFT Upstream requirements: SRS_Eth_00190, SRS_BSW_00350, SRS_BSW_00386 ⌈If WEth_ImmediateTransmit has been called, a transmission buffer is reserved, the Wireless Ethernet driver is requested to construct the Ethernet frame (according to [SWS_WEth_00314]) and WEthCtrlEnableEgressHardwareSupportedData- Transfer is set to FALSE, then the Ethernet driver shall consider the following con- struction steps: • iterate over the stored list of header pointers (see [SWS_WEth_00314]) and per- form for each header the following step: – Copy data from the given data location (DataPtr) with respect to the given data length (DataLength) to the next available position in reserved trans- mission buffer element in consecutive order without gaps and continue • copy payload data from the given location PayloadPtr with respect to the given length (PayloadLength) to the next available position in the transmission buffer in consecutive order without gaps • trigger a transmission for content of this transmission buffer • store the given TxHandleId with the used transmission buffer index and the given CtrlIdx ⌋

[SWS_WEth_00316] Construction of an Ethernet frame given with WEth_Imme- diateTransmit transmit request and WEthCtrlEnableEgressHardwareSup- portedDataTransfer is set to TRUE Status: DRAFT Upstream requirements: SRS_Eth_00190, SRS_BSW_00350, SRS_BSW_00386 ⌈If WEth_ImmediateTransmit has been called, a transmission buffer is reserved, the Wireless Ethernet driver is requested to construct the Ethernet frame (according to [SWS_WEth_00314]) and WEthCtrlEnableEgressHardwareSupportedData- Transfer is set to TRUE, then the Wireless Ethernet driver shall consider the following construction steps: • iterate over the stored list of header pointers (see [SWS_WEth_00314])and per- form for each header to the following steps: – if the given header length (DataLength) of a list element exceeds the configured WEthCtrEgressHardwareSupportedDataTransfer- Threshold, then the Ethernet driver shall prepare a hardware supported transfer with respect to the given header length (DataLength) and header location (DataPtr), trigger the data transfer and reserve space according the given DataLength in the reserved transmission buffer element, store the data transfer session handle (by considering given TxHandleId, Ctr- lIdx and transmission buffer index) and continue at next available position + DataLength + 1 of the transmission buffer – if the given length (DataLength) is equal or smaller than the configured WEthCtrEgressHardwareSupportedDataTransferThreshold, then the Ethernet driver shall copy data from the given header location (Dat- aPtr) with respect to the given header length (DataLength) to the next available position in reserved transmission buffer element in consecutive or- der and continue • check the payload length given with (PayloadLength) – if the given payload length (PayloadLength) of a list element exceeds the configured WEthCtrEgressHardwareSupportedDataTransfer- Threshold, then the Wireless Ethernet driver shall prepare a hard- ware supported transfer with respect to the given payload length (Pay- loadLength) and payload location (PayloadPtr), trigger the data transfer and reserve space according the given PayloadLengthin the transmission buffer, store the data transfer session handle (by considering given TxHan- dleId, CtrlIdx and transmission buffer index) – if the given payload length (PayloadLength) is equal or smaller than the configured WEthCtrEgressHardwareSupportedDataTransfer- Threshold, then the Ethernet driver shall copy the payload from the given payload location (PayloadPtr) with respect to the given payload length ( PayloadLength) to the next available position in reserved transmission buffer element in consecutive order • store the given TxHandleId with the used transmission buffer index and the given CtrlIdx ⌋ Note: The mapping of TxHandleId with the used transmission buffer index and the given CtrlIdx are used to identify the provided TxHandleId, which is needed if confirmation of the transmission has to be indicated via WEth_TxConfirmation. All sessions for hardware supported data transfer which relate to the same transmis- sion buffer need to be confirmed by hardware. Therefore the Ethernet driver needs to supervise the state of triggered hardware supported data transfer in relation to the affected TxHandleId, CtrlIdx and transmission buffer index. After all data transfers which relate to the same transmission buffer have been finalized, the transmission for this transmission buffer can be triggered.

[SWS_WEth_00317] Handling if a hardware supported data transfer for a specific transmission request has been finalized Status: DRAFT Upstream requirements: SRS_Eth_00189, SRS_BSW_00350, SRS_BSW_00386 ⌈If WEth_ImmediateTransmit has been called, WEthCtrlEnableEgressHard- wareSupportedDataTransfer is set to TRUE and all data transfer sessions have confirmed successful transfer for a specific transmission buffer, then the Wireless Eth- ernet driver shall perform the following actions: • remove all data transfer session handles which are associated with this transmis- sion buffer • trigger a transmission of the content of this transmission buffer0311 ⌋ Please note: Mapping of the transmission buffer index and the given CtrlIdx to TxHandleId is needed for asynchronous check in the EthIf_MainFunctionTx or within an interrupt.

[SWS_WEth_00318] Value range of the returned buffer index Status: DRAFT Upstream requirements: SRS_Eth_00191 ⌈The returned buffer index value of type Eth_BufIdxType shall be greater than 216-1. The value range for the buffer index shall be: • 0x00 01 00 00 ... 0xFF FF FF FF: valid • 0x00 00 00 00 ... 0x00 00 FF FF: reserved for TxHandleId of WEth_Immedi- ateTransmit ⌋ Note: Constraining the buffer index is needed, since TxHandleId of WEth_Immedi- ateTransmit used for direct data provision (used as PDU-ID) and BufIdxPtr of WEth_ProvideTxBuffer used for indirect data provision could overlap. EthIf need an unambiguous id (non-overlapping value range) that corresponds to a transmission request, to idenfy the affected tranmssion request for transmission confirmation via EthIf_TxConfirmation.

If the Wireless Ethernet controller is on - chip, the Wireless Ethernet Driver module shall not use any service of other drivers.

The function WEth_Init shall initialize all on - chip hardware resources that are used by the Wireless Ethernet con troller.

If an off - chip Wireless Ethernet controller is used 1 , the Wireless Ethernet driver shall use services o f other MCAL drivers (e.g. SPI).

All the Wireless Ethernet driver interfaces shall be implemented in a non - blocking manner. In cases where the action can be performed imm ediately and atomically, the confirmation is reported in the request function's return code. Alternatively, the initiation of an action is performed by a call to a 'request' function and the result of the action is reported by a corresponding 'confirm' cal lback.

The Wireless Ethernet Driver shall provide an API WEth_GetBufWRxParams that can provide a list of buffer based reception parameters .

The Wireless Ethernet Driver shall provide an API WEth_SetBufWTxParams that sets a list of buffer based transmission parameters .

The Wireless Ethernet Driver shall provide an API that enables the Wireless Ethernet Transceiver to set the general radio specific parameters via an API WEth_WriteTrcvRegs to the transceiver.

[SWS_WEth_10008] Upstream requirements: SRS_V2X_00451 ⌈The Wireless Ethernet Driver shall provide an API that enables the Wireless Ethernet Transceiver to get the general radio specific parameters via an API WEth_ReadTrcv Regs from the transceiver.⌋

[SWS_WEth_10009] ⌈For reception the Wireless Ethernet Controller shall enable hardware capabilities to discard frames with incorrect Frame Check Sequence (FCS).⌋ (SRS_V2X_00391)

The function shall read a list of values from the indexed controller according to [17] .

The function WEth_GetWEthertStats 64 shall be pre compile time configurable On/Off by the configuration parameter: W EthGetWEtherStatsApi.

[SWS_WEth_10030] ⌈If development error detection is enabled: the function shall check the parameter RegIds for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

[SWS_WEth_10031] ⌈If development error detection is enabled: the function shall check the parameter RegVals for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

[SWS_WEth_10034] ⌈If development error detection is enabled: the function shall check the parameter RegIds for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

[SWS_WEth_10035] ⌈If development error detection is enabled: the function shall check the parameter RegVals for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

The Wireless Ethernet Driver shall provide an API WEth_GetBufWTxParams that can provide a list of buffer based transmission parameters .

The API WEth_ GetBufWRxParams shall read properties of type WEth_BufWRxParamIdType of the access l ayer properties of a received packet.

If development error detection is enabled: the function shall check that the service WEth_Init was previously called . If the check fails, the function shall raise the development error WETH_E_UNINIT .

If development erro r detection is enabled: the function shall check the parameter CtrlId for being valid . If the check fails, the function shall raise the development error WETH_E_INV_CTRL_ID .

[SWS_WEth_10041] ⌈If development error detection is enabled: the function shall check the parameter RxParamIds for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

[SWS_WEth_10042] ⌈If development error detection is enabled: the function shall check the parameter ParamValues for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

The API W Eth_ GetBufWTxParams sha ll read properties of type WEth_BufWTxParamIdType of the access layer properties of a received packet.

If development error detection is enabled: the function shall check tha t the service WEth_Init was previously called . If the check fails, the function shall raise the development error WETH_E_UNINIT .

If development error detection is enabled: the function shall check the parameter CtrlId f or being valid . If the check fails, the function shall raise the development error WETH_E_INV_CTRL_ID .

[SWS_WEth_10048] ⌈If development error detection is enabled: the function shall check the parameter TxParamIds for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

[SWS_WEth_10049] ⌈If development error detection is enabled: the function shall check the parameter ParamValues for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

The API WEth_SetBufWTxParams shall set properties of type WEth_BufWTxParamIdType of the access layer properties for a packet to be sent.

If develop ment error detection is enabled: the function shall check that the service WEth _Init was previously called . If the check fails, the function shall raise the development error WETH _E_NOT_INITIALIZED .

If development error detection i s enabled: the function shall check the parameter CtrlId for being valid . If the check fails, the function shall raise the development error WETH_E_INV_CTRL_ID .

If development error detection is enabled: the function shall check the parameter BufId for being valid . If the check fails, the function shall raise the development error WETH_E_INV_PARAM .

[SWS_WEth_10056] ⌈If development error detection is enabled: the function shall check the parameter TxParamIds for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

[SWS_WEth_10057] ⌈If development error detection is enabled: the function shall check the parameter ParamValues for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

Used for hardware / software imple mentation specific execution of cyclic tasks.

The module must ensure that within the interrupt/polling context of this function call, reception parameters of the wireless channel for the current buffer could be retrieved by the function WEth_GetBufWRxParams.

The module must ensure that within the interrupt/polling context of this function call, transmission parameters of the wireless channel for the current buffer could be retrieved by the function WEth_GetB ufWTxParams.

Functions using the type WEth_ BufWRxParamIdType shall use a list of uint 32 values for the list of corresponding val ues.

Functions using the type WEth_ BufWRxParamIdType shall use the following type mapping for the corresponding values: ParamId ParamValue Type WETH_BUFWRXPID_RSSI uint8 WETH_BUFWRXPID_CHANNEL_ID uint16 WETH_BUFWRXPID_FREQ uint 16 WETH_BUFWRXPID_TRANSACTION_ID _32 uint32 WETH_BUFWRXPID_ANTENNA_ID uint8

Function s using the WEth_ BufWTxParamIdType shall use the following type mapping for the corresponding values: ParamId ParamValue Type WETH_BUFWTXPID_POWER uint8 WETH_BUFWTXPID_CHANNEL_ID uint16 WETH_BUFWTXPID_QUEUE_ID uint8 WETH_BUFWTXPID_TRANSACTION_ID _16 ui nt16 WETH_BUFWTXPID_ANTENNA_ID uint8

[SWS_WEth_10235] ⌈If development error detection is enabled: the function shall check that the service WEth_Init was previously called. If the check fails, the function shall raise the development error WETH_E_UNINIT.⌋()

[SWS_WEth_10236] ⌈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 WETH_E_INV_CTRL_IDX.⌋()

[SWS_WEth_10237] ⌈If development error detection is enabled: the function shall check the parameter RxStats for being valid. If the check fails, the function shall raise the development error WETH_E_PARAM_POINTER.⌋()

The WEth module shall support at least the following DCC - Profiles defined ins ide [18] : DP0, DP1, DP2 and DP3 .  DP0, used for TC = 0  DP1: used for TC = 1  DP2: used for TC = 2  DP3: used for other low priority messages with TC > 2

The WEth module shall discard a message with the DCC - Profile ID DP2 in the DCC_Access queues if a new message with the DCC - Profile ID DP2 arrives in the DCC_Access queues.

The module will operate as an independent instance in each of the partitions, means the called API will only target the partition it is called in.

If WEthEcucPartitionRef references one or more ECUC partitions, WEthCtrlEcucPartitionRef shall have a multiplicity of one and ref- erence one of these ECUC partitions as well.

[SWS_WEth_CONSTR_00311] At most one Transmission buffer with no priority per WEthCtrlConfig Status: DRAFT Upstream requirements: SRS_Eth_00190, SRS_Eth_00191, SRS_BSW_00350, SRS_BSW_- ⌈An WEthCtrlConfig shall have at most one transmission buffer with no priority con- figured.⌋ Note: A transmission buffer at the same Ethernet controller for wireless communica- tion with no priority configured, could be used as default transmission buffer where all Ethernet frames are added which could not be sorted in other transmission buffers.

[SWS_WEth_CONSTR_00312] A transmission buffer with no priority configured shall be handled with lowest priority Status: DRAFT Upstream requirements: SRS_Eth_00190, SRS_Eth_00191, SRS_BSW_00350, SRS_BSW_- ⌈A transmission buffer with no priority configured, shall be handled with lowest priority .⌋