Dell Systems Management Base Driver

개요

Dell Systems Management Base Driver는 Dell OpenManage 같은 system management software가 일부 Dell system에서 system management interrupt와 host control action을 수행하도록 sysfs interface를 제공합니다. host control은 OS shutdown 뒤 system power cycle 또는 power off를 수행합니다.

Dell OpenManage가 이 driver를 필요로 하는 PowerEdge model은 300, 1300, 1400, 400SC, 500SC, 1500SC, 1550, 600SC, 1600SC, 650, 1655MC, 700, 750입니다.

open-source `libsmbios` 같은 다른 Dell software도 이 driver를 사용할 것으로 예상되며 다른 Dell system에서도 사용할 수 있습니다.

Dell libsmbios project는 가능한 한 많은 BIOS 정보에 접근하는 것을 목표로 합니다. 자세한 내용은 `http://linux.dell.com/libsmbios/main/`입니다.

===================================
Dell Systems Management Base Driver
===================================

Overview
========

The Dell Systems Management Base Driver provides a sysfs interface for
systems management software such as Dell OpenManage to perform system
management interrupts and host control actions (system power cycle or
power off after OS shutdown) on certain Dell systems.

Dell OpenManage requires this driver on the following Dell PowerEdge systems:
300, 1300, 1400, 400SC, 500SC, 1500SC, 1550, 600SC, 1600SC, 650, 1655MC,
700, and 750.  Other Dell software such as the open source libsmbios project
is expected to make use of this driver, and it may include the use of this
driver on other Dell systems.

The Dell libsmbios project aims towards providing access to as much BIOS
information as possible.  See http://linux.dell.com/libsmbios/main/ for
more information about the libsmbios project.

System Management Interrupt

일부 Dell system에서는 management software가 SMI(System Management Interrupt)를 통해 특정 management information에 접근해야 합니다.

SMI data buffer는 32-bit address space에 있어야 하고 SMI에는 buffer physical address가 필요합니다. driver가 필요한 memory를 유지하고 application이 SMI를 발생시키는 방법을 제공합니다.

sysfs entry는 `/sys/devices/platform/dcdbas/smi_data`, `/sys/devices/platform/dcdbas/smi_data_buf_phys_addr`, `/sys/devices/platform/dcdbas/smi_data_buf_size`, `/sys/devices/platform/dcdbas/smi_request`입니다.

SMI를 실행하려면 `smi_data`를 lock하고 system management command를 기록합니다. `smi_request`에 `1`을 쓰면 calling-interface SMI, `2`를 쓰면 raw SMI가 발생합니다. 이후 `smi_data`에서 response를 읽고 unlock합니다.

System Management Interrupt
===========================

On some Dell systems, systems management software must access certain
management information via a system management interrupt (SMI).  The SMI data
buffer must reside in 32-bit address space, and the physical address of the
buffer is required for the SMI.  The driver maintains the memory required for
the SMI and provides a way for the application to generate the SMI.
The driver creates the following sysfs entries for systems management
software to perform these system management interrupts::

	/sys/devices/platform/dcdbas/smi_data
	/sys/devices/platform/dcdbas/smi_data_buf_phys_addr
	/sys/devices/platform/dcdbas/smi_data_buf_size
	/sys/devices/platform/dcdbas/smi_request

Systems management software must perform the following steps to execute
a SMI using this driver:

1) Lock smi_data.
2) Write system management command to smi_data.
3) Write "1" to smi_request to generate a calling interface SMI or
   "2" to generate a raw SMI.
4) Read system management command response from smi_data.
5) Unlock smi_data.

Host Control Action

Dell OpenManage host control은 administrator가 OS shutdown 완료 후 system을 power cycle하거나 power off하게 합니다. 일부 Dell system에서는 shutdown이 끝난 뒤 driver가 SMI를 수행해야 합니다.

예약에 사용하는 sysfs entry는 `/sys/devices/platform/dcdbas/host_control_action`, `host_control_smi_type`, `host_control_on_shutdown`입니다.

OpenManage는 수행할 action을 `host_control_action`에, driver가 실행할 SMI type을 `host_control_smi_type`에 기록합니다. `host_control_on_shutdown`에 `1`을 써서 action을 활성화한 뒤 OS shutdown을 시작합니다.

OS shutdown 완료 notification을 받으면 driver가 host-control SMI를 수행합니다.

Host Control Action
===================

Dell OpenManage supports a host control feature that allows the administrator
to perform a power cycle or power off of the system after the OS has finished
shutting down.  On some Dell systems, this host control feature requires that
a driver perform a SMI after the OS has finished shutting down.

The driver creates the following sysfs entries for systems management software
to schedule the driver to perform a power cycle or power off host control
action after the system has finished shutting down:

/sys/devices/platform/dcdbas/host_control_action
/sys/devices/platform/dcdbas/host_control_smi_type
/sys/devices/platform/dcdbas/host_control_on_shutdown

Dell OpenManage performs the following steps to execute a power cycle or
power off host control action using this driver:

1) Write host control action to be performed to host_control_action.
2) Write type of SMI that driver needs to perform to host_control_smi_type.
3) Write "1" to host_control_on_shutdown to enable host control action.
4) Initiate OS shutdown.
   (Driver will perform host control SMI when it is notified that the OS
   has finished shutting down.)

Host Control SMI Type

power cycle 또는 power off host-control action에 사용할 `host_control_smi_type` 값은 PowerEdge model에 따라 다릅니다.

Host Control SMI Type
=====================

The following table shows the value to write to host_control_smi_type to
perform a power cycle or power off host control action:

=================== =====================
PowerEdge System    Host Control SMI Type
=================== =====================
      300             HC_SMITYPE_TYPE1
     1300             HC_SMITYPE_TYPE1
     1400             HC_SMITYPE_TYPE2
      500SC           HC_SMITYPE_TYPE2
     1500SC           HC_SMITYPE_TYPE2
     1550             HC_SMITYPE_TYPE2
      600SC           HC_SMITYPE_TYPE2
     1600SC           HC_SMITYPE_TYPE2
      650             HC_SMITYPE_TYPE2
     1655MC           HC_SMITYPE_TYPE2
      700             HC_SMITYPE_TYPE3
      750             HC_SMITYPE_TYPE3
=================== =====================