Kontron AM4140 IPMI Firmware - Manual (Page 21)

AM4140 IPMI Firmware
ID 1051-8188, Rev. 1.0 Page 21
P R E L I M I N A R Y
3.4 OEM Module Quiescence Feedback
This command is used to control a graceful shutdown of the AM4140 and is a prerequisite for
the hot swap feature. For further information on hot swap, refer to Chapter 9, Hot Swap.
A shutdown daemon compatible with the OEM Module Quiescence Feedback command
should be used to shut down the system in an orderly manner. For this purpose, Kontron’s
BSPs include a Graceful Reboot and Shutdown Daemon, “grnsd”.
This command can also be used to set a timeout time for the case that the graceful shutdown
daemon or the operating system is not responsive. The default timeout time is set to 20 sec-
onds and is stored in the MMC. Thus, the timeout is triggered even if an operating system with-
out a “grnsd” shutdown daemon is used. OSs with a graceful shutdown daemon “grnsd” can
modify the quiescent wait time as required.
Table 8: OEM Module Quiescence Feedback
COMMAND LUN NetFn CMD
OEM Module Quiescence Feedback 00h OEM = 3Eh 40h
REQUEST DATA
Byte Data Field
1 Control bits:
[7] - 1b = set quiesce wait timeout
[6] - 1b = quiescence acknowledge (OS ready)
[5] - 1b = OS daemon present
[4:0] Reserved
2 Quiesce wait timeout [sec]
a) An OS daemon is present (refer to bits above):
This is the maximum time from the moment on that the MMC receives FRU Control
(Quiesce) request until it sends back the appropriate Module Hot Swap event message.
b) No OS daemon is present (refer to bits above):
This is the maximum time from the moment on that the MMC receives FRU Control
(Quiesce) request until it sends back the appropriate Module Hot Swap event message. If
sleep state is recognized before timeout, the Module Hot Swap event message will be sent
immediately. If the time is set to 0 (endless wait), the Module Hot Swap event message will
only be sent after recognition of sleep state (signal).
RESPONSE DATA
Byte Data Field
1 Completion code
2 Control bits:
[7] - Reserved
[6] - 1b = quiescence acknowledge (OS ready)
[5] - 1b = OS daemon present
[4] - 1b = quiesce request (FRU Control)
[3] - Reserved
[2] - 1b = graceful reboot request (FRU Control)
[1] - 1b = quiescence reached (MMC acknowledge)
[0] - 1b = module hot swap switch opened
4 Quiesce wait timeout (valid only if OS daemon present = 1)