dcdbas: add Dell Systems Management Base Driver with sysfs support
PATCH 1/1 dcdbas: add Dell Systems Management Base Driver with sysfs support
This patch adds the Dell Systems Management Base Driver with sysfs support.
This patch incorporates changes based on comments from the previous posting.
Summary of changes:
* Changed permissions on sysfs files so that only owner can read.
* Changed to use __uNN/__sNN types in structs.
* smi_data_write will grow smi_data_buf if needed.
* Renamed struct callintf_cmd to struct smi_cmd.
* Renamed callintf_smi to smi_request.
* Added 2 more supported values that were requested in smi_request_store.
* Hold rtc_lock across SMI in host_control_smi.
---
Documentation/dcdbas.txt +87 -0
@@ -0,0 +1,87 @@ +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 library +is expected to make use of this driver, and it may include the use of this +driver on other Dell systems. + + +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 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 + +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 + +
drivers/firmware/dcdbas.c +593 -0
593 lines not on this page · raw message
drivers/firmware/dcdbas.h +107 -0
107 lines not on this page · raw message
drivers/firmware/Kconfig +17 -0
@@ -58,4 +58,21 @@ config EFI_PCDP See <http://www.dig64.org/specifications/DIG64_HCDPv20_042804.pdf> +config DCDBAS + tristate "Dell Systems Management Base Driver" + depends on X86 || X86_64 + default m + help + The Dell Systems Management Base Driver provides a sysfs interface + for systems management software to perform System Management + Interrupts (SMIs) and Host Control Actions (system power cycle or + power off after OS shutdown) on certain Dell systems. + + See <file:Documentation/dcdbas.txt> for more details on the driver + and the Dell systems on which Dell systems management software makes + use of this driver. + + Say Y or M here to enable the driver for use by Dell systems + management software such as Dell OpenManage. + endmenu
drivers/firmware/Makefile +1 -0
@@ -4,3 +4,4 @@ obj-$(CONFIG_EDD) += edd.o obj-$(CONFIG_EFI_VARS) += efivars.o obj-$(CONFIG_EFI_PCDP) += pcdp.o +obj-$(CONFIG_DCDBAS) += dcdbas.o
MAINTAINERS +5 -0
@@ -696,6 +696,11 @@ M: [email protected] W: http://www.debian.org/~dz/i8k/ S: Maintained +DELL SYSTEMS MANAGEMENT BASE DRIVER (dcdbas) +P: Doug Warzecha +M: [email protected] +S: Maintained + DEVICE-MAPPER P: Alasdair Kergon L: [email protected]
Hi
Quoted 4 lines
This patch adds the Dell Systems Management Base Driver with sysfs support.
This patch incorporates changes based on comments from the previous posting.
Could we get some better name for this one?
drivers/firmware/dcdbas.c
Quoted 3 lines
diff -uprN
linux-2.6.13-rc6.orig/drivers/firmware/dcdbas.clinux-2.6.13-rc6/drivers/firmware/dcdbas.cdrivers/firmware/dcdbas.c +0
-0
Like dell_mgmt.c?
Pavel
Signature · 1 line
if you have sharp zaurus hardware you don't need... you know my address
Quoted 6 lines · Doug Warzecha
This patch adds the Dell Systems Management Base Driver with sysfs support.
This patch incorporates changes based on comments from the previous posting.
Summary of changes:
Quoted 10 lines
* Changed permissions on sysfs files so that only owner can read.
* Changed to use __uNN/__sNN types in structs.
*smi_data_writewill growsmi_data_bufif needed.
* Renamed structcallintf_cmdto structsmi_cmd.
* Renamedcallintf_smitosmi_request.
* Added 2 more supported values that were requested insmi_request_store.
* Holdrtc_lockacross SMI inhost_control_smi.
Hi Doug
I've followed this thread as best I can and I have a query...
I have a Dell SC420
Is there a way (based around this patch) to allow users to enable and set the auto-power-on BIOS feature?
(ie tell the BIOS to power on at 3:40am, power the system down, watch it power up at 3:40am)
Normally I'd use 'nvram-wakeup' but it dosen't understand the Dell BIOS.
If so what I'd _like_ to do is send a patch to nvram-wakeup that tests for this capability and uses it if it's there.
David
Please download libsmbios 0.10.0-beta1 and send the "dumpCmos" output from your machine. Please send it to the libsmbios devel mailing list.
Quoted 1 line
From that output, I can tell you if this token is available on that
machine. If that token is available, then yes, you can set that feature.
libsmbios can be obtained from http://linux.dell.com/libsmbios/main/
dumpCmos is part of "make minimal", so you don't need any other libs present to compile. It is found under bins/output/ after compile. (alternatively, install the libs and bins rpms)
--
Michael
Quoted 16 lines · David Greaves
I have a Dell SC420
Is there a way (based around this patch) to allow users to enable and set the auto-power-on BIOS feature?
(ie tell the BIOS to power on at 3:40am, power the system down, watch it
power up at 3:40am)Normally I'd use 'nvram-wakeup' but it dosen't understand the Dell BIOS.
If so what I'd _like_ to do is send a patch to nvram-wakeup that tests for this capability and uses it if it's there.
David