Kontron AM4020 IPMI Firmware - Manual (Page 27)

AM4020 IPMI Firmware
ID 1036-5671, Rev. 2.0 Page 19
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 AM4020 and is a prerequisite for
the hot swap feature. For further information on hot swap, refer to Chapter 9, Hot Swap.
If the software environment does not support ACPI, a self-written shutdown daemon, can be
used to shut down the system in an orderly manner. For this purpose, Kontron’s latest BSP in-
cludes a Graceful Reboot and Shutdown Daemon, “grnsd”.
If ACPI is fully supported, this command can be used to set a timeout time for the case that the
ACPI means (ACPI daemon, etc.) are unable to shut down the system in time. As a default val-
ue at system start this time is set to 0 (endless wait).
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 (default after reset,) 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)