Wireless Ethernet Transceiver Driver (WEthTrcv)

Initializes the Wireless Ethernet Transceiver Driver

Enables / disables the indexed transceiver

Ob tains the state of the indexed transceiver

Obtains the link state of the indexed transceiver

Returns the version information of this module

Used for polling state changes. Calls Eth If_ Trcv Mode Indication when the transceiver mode changed.

Set values related to a transceiver's wireless radio. For example, this could be the selection of the radio settings (channel, ...).

Set values related to the receive direction of a transceiver's wireless channel .For example, this could be a channel parameter like the frequency.

Set values related to the transmit direction of a transceiver's wireless channel. For example, this could be the bitrate of a channel.

Read values related to the receive direction of the transceiver. For example, this could be a Channel Busy Ratio (CBR) or the average Channel Idle Time (CIT).

Implementation specific structure of the post build configuration

Wireless channel properties of the receive side

Wireless radio settings for the transceiver

Wireless channel settings for the receive side

-

Bandwidth of a radio channel

Power of frame, in 0.5 d Bm units, raw value 0 equals - 100 d Bm

Power of frame, in 0.5 d Bm units, raw value 0 equals - 100 d Bm

Radio operation mode with multiple radio channel configurations

The Wi reless Ethernet Transceiver Driver is using a zero - based index to abstract the access for upper software layers. The parameter WEthTrcvId within configuration corresponds to parameter TrcvId used in the API.

I n case development error detection is enabled for the Wireless Ethernet Transceiver Driver module: The Wireless Ethernet Transceiver Driver module shall check API parameters for validity and repo rt detected errors to the DET.

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

Module Header File Imported Type Dem Rte_ Dem_ Type.h Dem _ Event Id Type Rte_ Dem_ Type.h Dem _ Event Status Type Eth Eth_ General Types.h Eth _ Mode Type (draft) Eth Trcv Eth_ General Types.h Eth Trcv _ Link State Type Std Std_ Types.h Std _ Return Type Std_ Types.h Std _ Version Info Type

[SWS_WEthTrcv_00044] ⌈If development error detection is enabled: The function shall check that the service WEthTrcv_Init was previously called. If the check fails, the function shall raise the development error WETHTRCV_E_UNINIT otherwise (if DET is disabled) return E_NOT_OK.⌋

[SWS_WEthTrcv_00045] ⌈If development error detection is enabled: The function shall check the parameter TrcvIdx for being valid. If the check fails, the function shall raise the development error WETHTRCV_E_INV_TRCV_IDX otherwise (if DET is dis- abled) return E_NOT_OK.⌋

[SWS_WEthTrcv_00046] ⌈The function shall be pre compile time configurable On/Off by the configuration parameter: WEthTrcvSetTransceiverModeApi.⌋

[SWS_WEthTrcv_00047] ⌈Caveat: The function requires previous transceiver initial- ization (EthTrcv_Init).⌋

[SWS_WEthTrcv_00050] ⌈If development error detection is enabled: The function shall check that the service EthTrcv_Init was previously called. If the check fails, the function shall raise the development error WETHTRCV_E_UNINIT otherwise (if DET is disabled) return E_NOT_OK.⌋

[SWS_WEthTrcv_00051] ⌈If development error detection is enabled: The function shall check the parameter TrcvIdx for being valid. If the check fails, the function shall raise the development error WETHTRCV_E_INV_TRCV_IDX otherwise (if DET is disabled) return E_NOT_OK.⌋

[SWS_WEthTrcv_00052] ⌈If development error detection is enabled: The function shall check the parameter TrcvModePtr for being valid. If the check fails, the function shall raise the development error WETHTRCV_E_PARAM_POINTER otherwise (if DET is disabled) return E_NOT_OK.⌋

[SWS_WEthTrcv_00053] ⌈The function shall be pre compile time configurable On/Off by the configuration parameter: WEthTrcvGetTransceiverModeApi.⌋ Driver

[SWS_WEthTrcv_00054] ⌈Caveat: The function requires previous transceiver initial- ization (WEthTrcv_Init).⌋

If development error detection is enabled: The function shall check that t he service WEthTrcv_Init was previously called. If the check fails, the function shall raise the development error WETHTRCV_E_UNINIT otherwise (if DET is disabled) return E_NOT_OK.

[SWS_WEthTrcv_00064] ⌈If development error detection is enabled: The function shall check the parameter TrcvIdx for being valid. If the check fails, the function shall raise the development error WETHTRCV_E_INV_TRCV_IDX otherwise (if DET is disabled) return E_NOT_OK.⌋

[SWS_WEthTrcv_00065] ⌈If development error detection is enabled: The function shall check the parameter LinkStatePtr for being valid. If the check fails, the function shall raise the development error WETHTRCV_E_PARAM_POINTER otherwise (if DET is disabled) return E_NOT_OK.⌋

[SWS_WEthTrcv_00066] ⌈The function shall be pre compile time configurable On/Off by the configuration parameter: WEthTrcvGetLinkStateApi.⌋ Driver

[SWS_WEthTrcv_00067] ⌈Caveat: The function requires previous transceiver initial- ization (WEthTrcv_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 _ Trcv - Mode - Indication Eth If.h Called asynchronously when a mode change has been read out. If the function is triggered by pre vious call of Eth Trcv_ Set Transceiver Mode it can directly be called within the trigger function. Sch M _ - Enter _ W - Eth Trcv Sch M_<Mip>.h Invokes the Sch M_ Enter function to enter a module local exclusive area. Sch M _ Exit _ - W Eth Trcv Sch M_<Mip>.h Invokes the Sch M_ Exit function to exit an exclusive area. W Eth _ - Read Trcv - Regs WEth.h Reads a transceiver register W Eth _ Write - Trcv Regs WEth.h Configures a transceivers registers or triggers a function offered by the receiver

[SWS_WEthTrcv_00093] ⌈If development error detection is enabled: The function shall check the parameter VersionInfoPtr for being valid. If the check fails, the func- tion shall raise the development error WETHTRCV_E_PARAM_POINTER.⌋

[SWS_WEthTrcv_00104] ⌈The function shall check the access to the Wireless Eth- ernet transceiver. If the check fails, the function shall raise the production error WETHTRCV_E_ACCESS and return E_NOT_OK, otherwise pass the production error WETHTRCV_E_ACCESS and return E_OK.⌋ Driver

Error Name: WETHTRCV_E_ACCESS Short Description: Wireless Ethernet Transceiver Access Failure. Long Description: Monitors the access to the Wireless Ethernet Transceiver if a transceiver hardware is seperate f rom the baseband modem hardware . Detection Criter ia: Fail When access to the Wireless Ethernet Transceiver fails the module shall report the extended production error with event status DEM_EVENT_STATUS_PREFAILED to DEM. Pass When access to the Wireless Ethernet Transceiver succeds the module shall re port the extended production error with event status DEM_EVENT_STATUS_PREPASSED to DEM. Secondary Parameters: None. Time Required: None. Monitor Frequency None.

[SWS_WEthTrcv_00107] ⌈If the transceiver is already in the requested mode E_OK shall be returned and no development error shall be raised.⌋

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

The function s hall put the index transceiver in the specified mode and indicate the new mode by the API EthIf_TrcvModeIndication latest during the next WEthTrcv_MainFunction.

The function shall read the current transceiver mode.

The function WEthTrcv_SetRadioParams shall set properties of type WEthTrcv_SetRadioParamIdType to the access layer of a specific wireless radio indexed by RadioId.

If development error detection is enabled : Th e function shall check that the service WEthTrcv_Init was previously called . If the check fails, the function shall raise the development error WETHTRCV_E_UNINIT .

If development error detection is enabled : Th e function shall check the parameter Trcv Id for being valid . If the check fails, the function shall raise the development error W ETHTRCV _E_INV_TRCV_ ID otherwise (if DET is disabled) return E_NOT_OK .

If development error detection is enabled : Th e function shall check the parameter Radio Id for being valid . If the check fails, the function shall raise the development error W ETHTRCV_E_INV_PARAM otherwise (if DET is disabled) return E_NOT_OK .

If development error detection is enabled : Th e function shall check the parameter ParamIds for being valid. If the check fails, the func tion shall raise the development error W ETHTRCV_E_PARAM_POINTER .

If development error detection is enabled : Th e function shall check the parameter ParamValues for being valid. If the check fails, the function shall raise the dev elopment error W ETHTRCV_E_PARAM_POINTER .

[SWS_WEthTrcv_10034] Upstream requirements: SRS_BSW_00487 ⌈If development error detection is enabled: The function shall check that the service WEthTrcv_Init was previously called. If the check fails, the function shall raise the development error WETHTRCV_E_UNINIT.⌋

[SWS_WEthTrcv_10035] ⌈If development error detection is enabled: The function shall check the parameter TrcvId for being valid. If the check fails, the function shall Driver raise the development error WETHTRCV_E_INV_TRCV_ID otherwise (if DET is dis- abled) return E_NOT_OK.⌋

If development error detection is enabled : Th e function shall check the parameter Radio Id for being valid . If the check fails, the function shall raise the development error W ETHTRCV_E_INV_PARAM otherwise (if DET is disabl ed) return E_NOT_OK .

If development error detection is enabled : Th e function shall check the parameter ParamIds for being valid. If the check fails, the function shall raise the development error W ETHTRCV_E_PARAM_POINTER .

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

If development error detection is enabled : Th e fun ction shall check that the service WEthTrcv_Init was previously called . If the check fails, the function shall raise the development error WETHTRCV_E_UNINIT .

If development error detection is enabled : Th e function s hall check the parameter Trcv Id for being valid . If the check fails, the function shall raise the development error W ETHTRCV_E_INV_TRCV_ ID otherwise (if DET is disabled) return E_NOT_OK .

If development error detection is enabled : Th e function shall check the parameter Radio Id for being valid . If the check fails, the function shall raise the development error W ETHTRCV_E_INV_PARAM otherwise (if DET is disabled) return E_NOT_OK .

If development error detec tion is enabled : Th e function shall check the parameter Tx ParamIds for being valid. If the check fails, the function shall raise the development error W ETHTRCV_E_PARAM_POINTER .

If development error detection is enabled : Th e func tion shall check the parameter ParamValues for being valid. If the check fails, the function shall raise the development error W ETHTRCV_E_PARAM_POINTER .

If development error detection is enabled : Th e function shall check that the service WEthTrcv_Init was previously called . If the check fails, the function shall raise the development error WETHTRCV_E_UNINIT .

If development error detection is enabled : Th e function shall check the parameter Trcv Id for bei ng valid. If the check f ails, the function shall raise the development error W ETHTRCV_E_INV_TRCV_ ID otherwise (if DET is disabled) return E_NOT_OK .

If development error detection is enabled : Th e function shall check the parameter Radio Id for being vali d . If the check fails, the function shall raise the development error W ETHTRCV_E_INV_PARAM otherwise (if DET is disabled) return E_NOT_OK .

If development error detection is enabled : Th e function shall check the parameter ParamId s for being valid. If the check fails, the function shall raise the development error W ETHTRCV_E_PARAM_POINTER .

If development error detection is enabled : Th e function shall check the parameter ParamValues for being valid . If th e check fails, the function shall raise the development error W ETHTRCV_E_PARAM_POINTER .

Functi ons using the WEthTrcv_SetRadioParamIdType shall use the foll owing type mapping for the corresponding values: ParamId ParamValue Type WETHTRCV_SETRADIOPID_SEL_TRCV_CHCFG uint8 WETHTRCV_SETRADIOPID_SET_CHCFGID uint8 WETHTRCV_SETRADIOPID_TOLLINGZONE_INFO uint8

Functions using the type WEthTrcv_SetChanRxParamIdType shall use a generic list of uint 32 values for the list of corresponding values.

Functions using the WEthTrcv_SetChanRxParamIdType shall use the fo llowing type mapping for the corresponding values: P aramId ParamValue Type WETHTRCV_SETCHRXPID_BITRATE uint8 WETHTRCV_SETCHRXPID_BANDWIDTH WEthTrcv_Bandwidth Type WETHTRCV_SETCHRXPID_FREQ uint16 WETHTRCV_SETCHRXPID_CSPWRTRESH WEthTrcv_ RssiType WETHTRC V_SETCHRXPID_RADIO_MODE WEthTrcv_RadioModeType WETHT RCV_SETCHRXPID_ANTENNA uint8

Functions using the type WEthTrcv_SetChanTxParamIdType shall use a generic list of uint32 values for the list of corresponding values.

Functions using the WEthTrcv_SetChanTxParamIdType shall use the fo llowing type mapping for the corresponding values: ParamId ParamValue Type WETHTRCV_SETCHTXPID_BITRATE uint8 WETHTRCV_SETCHTXPID_BANDWIDTH WEthTrcv_Bandwidth Type WETHTRCV_SETCHTXPID_TXPOWER WEthTrcv_TxPwrLvlType WETHTRCV_SETCHTXPID_DCC_CBR uint8 WETH TRCV_SETCHTXPID_TXQSEL uint8 WETHTRCV_SETCHTXPID_TXQCFG_AIFSN uint8 WETHTRCV_SETCHTXPID_TXQCFG_CWMIN uint8 WETHTRCV_SETCHTXPID_TXQCFG_CWMAX uint16 WETHTRCV_SETCHTXPID_TXQCFG_TXOP uint8 WETHTRCV_SETCHTXPID_RADIO_MODE WEthTrcv_RadioModeType WETHTRCV_SE TCHTXPID_ANTENNA uint8 WETHTRCV_SETCHTXPID_PACKET_INTERVAL uint16 WETHTRCV_SETCHTXPID_DCC_STATE uint8

Functions using the type WEthTrcv_GetChanRxParamIdType shall use a generic list of uint32 values for the list of correspondi ng values.

Functions using the WEthTrcv_GetChanRxParamIdType shall use the following type mapping for the corresponding values: ParamId ParamValue Type WETHTRCV_GETCHRXPID_CBR uint8 WETHTRCV_GETCHRXPID_CIT uint16

For unique reference to transmission and reception paramete rs, unique enumeration IDs shall be used within this module.

The function shall use the type mapping f rom SWS_WEt hTrcv_10059 for the ParamIds and ParamValues parameters .

The function shall use the type mapping from SWS_WEthTrcv_10061 for the ParamIds and ParamValues parameters .

The function shall use the type mapping from SWS_WEthTrcv_10063 for the Tx ParamIds and ParamValues parameters .

The function shall use the type mapping from SWS_WEthTrcv_10065 for the ParamIds and ParamValues parameters .

The following requirements are only valid for WEth Transceivers used within the V2X Communication Stack [14] .

[SWS_WEthTrcv_10073] ⌈The function shall read the current transceiver link state.⌋

RF output power of the WEthTrcv module shall be adjustable.

The WEthTrcv module sh all abide by the following maximum message rates:  For the relaxed state: the sum of all messages sent on DP1, DP2 and DP3 while in relaxed state shall not surpass R max_relaxed = 16.7 messages per second. Message bursts are allowed for DP0 with R Burst = 20 messages per second, with a maximum duration of T Burst = 1 seconds, and may only take place every T BurstPeriod = 10 seconds. Thus, adding DP0 messages, the maximum message rate amounts to R max_relaxed = 36.7 messages per second.

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

WEthTrcvConfig and WEthCtrlConfig of one communication channel shall all reference the same ECUC partition.

The ECUC partitions referenced by WEthTrcv ConfigEcucPartitionRef shall be a subset of the ECUC partitions referenced by WEth TrcvEcucPartitionRef.

If WEthEcucPartitionRef references one or more ECUC partiti ons, WEthTrcvConfigEcucPartitionRef shall have a multiplicity of one and reference one of these ECUC partitions as well.