Kontron AM4120 IPMI Firmware - Manual (Page 23)

AM4120 IPMI Firmware Functional Description
ID 1045-9586, Rev. 1.0 Page 17
3.4 OEM Module Quiescence Feedback
This command is used to control a graceful shutdown of the AM4120 and is a prerequisite for
the hot swap feature. For further information on hot swap, refer to Chapter 9, Hot Swap.
A shutdown daemon 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 is unable to shut down the system in time. As a default value at system start this time
is set to 20 seconds to ensure that the system can be shut down properly in any case (e.g.
U-boot running or OS without graceful shutdown daemon 'grnsd'). OS's with the graceful shut-
down 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)