SNIP_CLASSIC_LIN_SECTION_8_3_2_2_Lin_GoToSleep
Wortlaut
8.3.2.2 Lin_GoToSleep
Note: This service is only applicable for LIN master node (available only if the ECU has
any LIN master channel).
[SWS_Lin_00166] Definition of API function Lin_GoToSleep ⌈
Service Name
Lin_GoToSleep
Syntax
Std_ReturnType Lin_GoToSleep (
uint8 Channel
)
Service ID [hex]
0x06
Sync/Async
Asynchronous
Reentrancy
Non Reentrant for the same Channel. Reentrant for different Channel.
Parameters (in)
Channel
LIN channel to be addressed
Parameters (inout)
None
Parameters (out)
None
Return value
Std_ReturnType
E_OK: Sleep command has been accepted
E_NOT_OK: Sleep command has not been accepted,
development or production error occurred
Description
The service instructs the driver to transmit a go-to-sleep-command on the addressed LIN
channel.
Only used for LIN master nodes.
Available via
Lin.h
⌋
[SWS_Lin_00089] ⌈The function Lin_GoToSleep shall send a go-to-sleep-command
on the addressed LIN channel as defined in LIN Specification 2.1.⌋
[SWS_Lin_00266]
Upstream requirements: SRS_Lin_01566
⌈The
function
Lin_GoToSleep
shall
set
the
channel
state
to
LIN_CH_SLEEP_PENDING, even in case of an erroneous transmission of the
go-to-sleep-command.⌋
[SWS_Lin_00220] ⌈If external wake-up detection is supported by configuration parameter LinChannelWakeupSupport, then the function Lin_GoToSleep shall enable bus
monitoring for a wake-up request on that channel, even in case of an erroneous transmission of the go-to-sleep command.⌋
[SWS_Lin_00221] ⌈The function Lin_GoToSleep shall optionally set the LIN hardware
unit to reduced power operation mode (if supported by HW), even in case of an erroneous transmission of the go-to-sleep-command.⌋
[SWS_Lin_00255] ⌈The LIN channel shall enter the state LIN_CH_SLEEP the next
time Lin_GetStatus is called, independent of the success of the transmission of the
goto-sleep-command on the bus.⌋
[SWS_Lin_00074] ⌈The function Lin_GoToSleep shall terminate ongoing frame transmission of prior transmission requests, even if the transmission is unsuccessfully completed.⌋
[SWS_Lin_00129] ⌈If development error detection for the LIN module is enabled: if
the function Lin_GoToSleep is called before the LIN module was initialized, the function
Lin_GoToSleep shall raise the development error LIN_E_UNINIT.⌋
[SWS_Lin_00131] ⌈If development error detection for the LIN module is enabled: the
function Lin_GoToSleep shall raise the development error LIN_E_INVALID_CHANNEL
if the channel parameter is invalid.⌋
[SWS_Lin_00288] ⌈The function Lin_GotoSleep is only available if the Lin module is
configured as LIN master node on at least one channel. In a pure LIN slave configuration, this function is not available. This depends on the configuration parameters
LinNodeType.⌋
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_LINDriver.pdf |
|---|---|
| Dokumentseite | Seite 43 |
| Ziel-Modul | lin (classic) |
| Ziel-Anforderung | SWS_Std_00005 |
| Semantische Rolle | constitutive |
| Automatisierungs-Konfidenz | 0.95 |