Kontron AM5030 IPMI - Manual (Page 24)

IPMI Firmware User Guide AM5030
Page 24 ID: 1042-7364, Rev. 1.0
3.3 Get Control State (Firmware Hub, Boot Order)
3.4 OEM Module Quiescence Feedback
3.4.1 Overview
If the OS doesn't fully support ACPI this command provides support to control a graceful shut
down of the AM5030. There is a Graceful Reboot and Shutdown Daemon (grnsd) for Linux in-
cluded in the newest Linux BSPs being offered by Kontron. It works as described in the follow-
ing “Usage for a self written shut down daemon” below.
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 value
at system start this time is set to 0 (endless wait).
For further information, refer to 9, Hot Swap.
3.4.2 Usage for a Self Written Shut Down Daemon
This command normally is used by a shut down daemon in a non-ACPI supporting software
environment. If a timeout time has to be set to avoid an endless waiting for the sleep state the
daemon calls this command after system start with the “set quiesce wait timeout” bit set and
the “Quiesce wait timeout” time <> 0. Afterwards the daemon calls this command cyclically with
the “OS daemon present” bit set. When the MMC gets a FRU Control (Quiesce) request from
the carrier (e.g. during a Hot Swap sequence) it sets the “quiesce request (FRU Control)” bit in
its command response. After the daemon sees this bit set in the response it should shut down
the system. After having set the “quiesce request (FRU Control)” bit the MMC starts the timeout
timer (if a timeout time was defined) and monitors the sleep signal line to recognize the sleep
state which should be caused by the shut down. When the MMC detects the sleep state (signal)
or it receives a command with the “quiescence acknowledge” bit set or the timeout timer has
expired, the MMC sends a “Module Hot Swap event” message to the carrier, and in the follow-
ing the payload power will be switched off.
Table 7: Get Control State
COMMAND LUN NetFn CMD
Get Control State (Firmware Hub, Boot Order) 00h OEM = 3Eh 21h
REQUEST DATA
Byte Data Field
1 Control ID:
00h = Firmware Hub (BIOS Flash) selection
9Dh = BIOS Boot Order Configuration
RESPONSE DATA
Byte Data Field
1 Completion Code
4 Control State (refer to 3.2)
00h .. 01h for control ID = Firmware Hub Flash Select
00h .. FFh for control ID = Boot Order Configuration