Kontron AM4022 IPMI Firmware - Manual (Page 25)

AM4022 IPMI Firmware
ID 1052-3624, Rev. 1.0 Page 25
3.4 OEM Module Quiescence Feedback
This command is used to control a graceful shutdown of the AM4022 and is a prerequisite for
the hot swap feature. For further information on hot swap, refer to Chapter 10, 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)