Zum Hauptinhalt springen

OEM-IPMI-Befehle

Der XCC unterstützt die folgenden IPMI-OEM-Befehle. Jeder Befehl erfordert eine andere Berechtigungsstufe (siehe unten).

CodeNetfn 0x2E-BefehleBerechtigung

0xCC

XCC auf Standard zurücksetzen

PRIV_USR

CodeNetfn 0x3A-BefehleBerechtigung

0x00

Firmwareversion abfragen

PRIV_USR

0x0D

Platineninformationen

PRIV_USR

0x1E

Verzögerungsoptionen für Wiederherstellung der Gehäusestromversorgung

PRIV_USR

0x38

NMI und Zurücksetzen

PRIV_USR

0x49

Datenerfassung einleiten

PRIV_USR

0x4A

Datei weiterleiten

PRIV_USR

0x4D

Status der Datenerfassung

PRIV_USR

0x50

Build-Informationen abrufen

PRIV_USR

0x55

Hostnamen abrufen/festlegen

PRIV_USR

0x6B

FPGA-Firmware-Revisionsstufe abfragen

PRIV_USR

0x6C

Platinenhardware-Revisionsstufe abfragen

PRIV_USR

0x6D

PSoC-Firmware-Revisionsstufe abfragen

PRIV_USR

0x98

Steuerung BF-USB-Anschluss

PRIV_USR

0xC7

Nativer NM-IPMI-Switch

PRIV_ADM

Befehl „XCC auf Standard zurücksetzen“

Mit diesem Befehl wird die XCC-Konfigurationseinstellung auf die Standardwerte zurückgesetzt.

Nettofunktion = 0x2E
CodeBefehlAnforderungsdaten, AntwortdatenBeschreibung
0xCC

XCC auf Standard zurücksetzen

Anforderung:

Byte 1 – 0x5E Byte 2 – 0x2B

Byte 3 – 0x00

Byte 4 – 0x0A Byte 5 – 0x01

Byte 6 – 0xFF

Byte 7 – 0x00 Byte 8 – 0x00

Byte 9 – 0x00

Antwort:

Byte 1 – Rückgabecode Byte 2 – 0x5E Byte 3 – 0x2B

Byte 4 – 0x00

Byte 5 – 0x0A Byte 6 – 0x01

Byte 7 – Antwortdaten
  • 0 = Erfolg
  • ungleich Null = Fehler

Mit diesem Befehl werden die XCC-Konfigurationseinstellungen auf die Standardwerte zurückgesetzt.

Befehle „Platinen‑/Firmwareinformationen“

In diesem Abschnitt werden die Befehle für die Abfrage der Platinen‑ und Firmwareinformationen aufgeführt.

Nettofunktion = 0x3A
CodeBefehlAnforderungsdaten, AntwortdatenBeschreibung

0x00

Firmwareversion abfragen

Anforderung:

Keine Daten bei Anforderung

Antwort:

Byte 1 – Rückgabecode

Byte 2 – Hauptversion

Byte 3 – Unterversion

Dieser Befehl gibt die Haupt‑ und Unterversionsnummern der Firmware zurück. Wenn der Befehl mit dem optionalen 1 Byte an Anforderungsdaten erfolgt, gibt die XCC-Antwort auch das dritte Feld (Revision) der Version zurück.

(Haupt.Unter.Revision)

0x0D

Platineninformationen abfragen

Anforderung: Nicht zutreffend

Antwort:

Byte 1 – System-ID

Byte 2 – Platinenrevision

Dieser Befehl gibt die Platinen-ID und ‑Revision zurück.

0x50

Build-Informationen abfragen

Anforderung: Nicht zutreffend

Antwort:

Byte 1 – Rückgabecode

Bytes 2:10 – ASCIIZ-Build-Name

Bytes 11:23 – ASCIIZ-Build-Datum

Bytes 24:31 – ASCII-Build-Zeit

Dieser Befehl gibt Build‑Name, ‑Datum und ‑Zeit zurück. Die Zeichenfolge für Build-Name und ‑Datum weisen eine Nullterminierung auf.

Das Format des Build-Datums ist JJJJ-MM-TT.

Bsp.: „ZUBT99A“
  • “2005-03-07”
  • “23:59:59”

0x6B

FPGA-Firmware-Revisionsstufe abfragen

Anforderung:

Byte 1 – FPGA-Einheitentyp*

FPGA-Einheitentyp

0 = Lokal (aktive Stufe)

1 = CPU-Karte 1 (aktive Stufe)

2 = CPU-Karte 2 (aktive Stufe)

3 = CPU-Karte 3 (aktive Stufe)

4 = CPU-Karte 4 (aktive Stufe)

5 = Lokaler primärer ROM

6 = Lokaler Wiederherstellungs-ROM

Antwort:

Byte 1 – Rückgabecode

Byte 2 – Hauptrevisionsstufe

Byte 3 – Unterrevisionsstufe

Byte 4 – Sub-Unterrevisionsstufe

(Test-Byte auf XCC-Plattformen)

Dieser Befehl gibt die Revisionsstufe der FPGA-Firmware zurück.

Wenn Byte 1 ausgelassen wird, wird „Lokal (aktive Stufe)“ ausgewählt.

0x6C

Platinenhardware-Revisionsstufe abfragen

Anforderung:

Keine Daten

Antwort:

Byte 1 – Rückgabecode

Byte 2 – Revisionsstufe

Dieser Befehl gibt die Revisionsstufe der Platinenhardware zurück, auf der sich das FPGA befindet.

0x6D

PSoC-Firmware-Revisionsstufe abfragen

Anforderung:

Keine Angabe

Antwort:

Byte 1 – Rückgabecode

Byte 2 – bin#

Byte 3 – APID

Byte 4 – Rev

Byte 5-6 – FRU-ID

Bytes 6:n – Wiederholung von Bytes 2-6 für jeden erkannten PSoC

Dieser Befehl gibt die Revisionsstufe aller erkannten PSoC-Einheiten zurück.

Hinweis: bin# stellt eine physische Position dar. Weitere Informationen finden Sie in der Systemspezifikation.

Systemsteuerbefehle

Die IPMI-Spezifikation bietet eine grundlegende Stromversorgungs‑ und Wiederherstellungssteuerung. Lenovo fügt zusätzliche Steuerfunktionen hinzu.

Nettofunktion = 0x2E
CodeBefehlAnforderungsdaten, AntwortdatenBeschreibung

0x1E

Verzögerungsoptionen für Wiederherstellung der Gehäusestromversorgung

Anforderung:

Byte 1

Anforderungstyp:

0x00 = Verzögerungsoptionen festlegen

0x01 = Verzögerungsoptionen abfragen

Byte 2

(falls Byte 1 = 0x00)

0x00 = Deaktiviert (Standard)

0x01 = Zufällig

0x02 - 0xFF reserviert

Antwort:

Byte 1 – Rückgabecode

Byte 2 – Verzögerungsoptionen (nur für Abfrageanforderung)

Diese Einstellung wird verwendet, wenn die Richtlinie zum Wiederherstellen der Gehäusestromversorgung so konfiguriert ist, dass die Stromversorgung nach der (erneuten) Aktivierung der Wechselstromversorgung immer eingeschaltet oder wieder eingeschaltet wird (falls zuvor eingeschaltet). Es gibt 2 Optionen: „Deaktiviert“ (die Standardeinstellung, keine Verzögerung beim Einschalten) und „Zufällig“. Die zufällige Verzögerungseinstellung bietet eine zufällige Verzögerung zwischen 1 und 15 Sekunden ab dem Moment, in dem der Wechselstrom (wieder) eingeschaltet wird und wenn der Server automatisch eingeschaltet wird.

Der Befehl wird von XCC nur auf Rack-Servern unterstützt.

0x38

NMI und Zurücksetzen

Anforderung:

Byte 1 – Anzahl der Sekunden
  • 0 = nur NMI

Byte 2 – Rücksetzungstyp
  • 0 = Warmstart
  • 1 = Aus‑ und Wiedereinschaltung

Antwort:

Byte 1 – Rückgabecode

Dieser Befehl wird verwendet, um einen System-NMI durchzuführen. Optional kann das System warmgestartet (neu gestartet) oder nach dem NMI aus‑ und wieder eingeschaltet werden.

Wenn das Feld „Anzahl der Sekunden“ nicht 0 ist, wird das System nach der angegebenen Anzahl von Sekunden warmgestartet oder aus‑ und wieder eingeschaltet.

Byte 2 der Anforderung ist optional. Wenn Byte 2 nicht angegeben wird oder den Wert 0x00 hat, wird ein Warmstart ausgeführt. Wenn Byte 2 den Wert 0x01 hat, wird das System aus‑ und wieder eingeschaltet.

Verschiedene Befehle

In diesem Abschnitt befinden sich Befehle, die nicht in andere Abschnitte passen.

Nettofunktion = 0x3A
CodeBefehlAnforderungsdaten, AntwortdatenBeschreibung

0x55

Hostnamen abrufen/festlegen

Anforderungslänge = 0:

Leere Anforderungsdaten

Antwort:

Byte 1

Rückgabecode

Bytes 2-65

Aktueller Hostname

ASCIIZ, nullterminierte Zeichenfolge

Anforderungslänge 1‑64:

Bytes 1-64

DHCP-Hostname

ASCIIZ, terminiert mit 00h

Verwenden Sie diesen Befehl, um den Hostnamen abzurufen/festzulegen.

Bei der Einstellung des Hostnamens muss der gewünschte Wert mit 00h terminiert werden. Der Hostname ist auf 63 Zeichen plus die Null beschränkt.

0x98

Steuerung BF-USB-Anschluss

Anforderung:

Byte 1

01h:

Aktuellen Eigentümer des USB-Anschlusses am Bedienfeld abrufen

Antwort:

Byte 1 – Rückgabecode

Byte 2

00h:

Eigentum von Host

01h:

Eigentum von BMC

Anforderung:

Byte 1

02h:

Konfiguration des USB-Anschlusses am Bedienfeld abrufen

Antwort:

Byte 1 – Rückgabecode

Byte 2

00h:

Dediziert für Host

01h:

Dediziert für BMC

02h:

Modus für gemeinsame Nutzung

Byte 3:4 – Inaktivitätszeitlimit in Minuten (zuerst MS-Byte)

Byte 5 – ID-Taste aktivieren

00h:

Deaktiviert

01h:

Aktiviert

Byte 6 – Hysterese (optional) in Sekunden

Anforderung:

Byte 1

03h: Konfiguration des USB-Anschlusses am Bedienfeld festlegen

Byte 2

00h:

Dediziert für Host

01h:

Dediziert für BMC

02h:

Modus für gemeinsame Nutzung

Byte 3:4 – Inaktivitätszeitlimit in Minuten (zuerst MS-Byte)

Byte 5 – ID-Taste aktivieren

00h:

Deaktiviert

01h:

Aktiviert

Byte 6 – Hysterese (optional) in Sekunden

Antwort:

Byte 1 – Rückgabecode Byte 2

00h:

Zu Host wechseln

01h:

Switch zu BMC

Antwort:

Byte 1 – Rückgabecode

Byte 1

05h:

USB-Anschluss am Bedienfeld aktivieren/deaktivieren

Byte 2

00h:

Deaktivieren

01h:

Aktivieren

Antwort:

Byte 1 – Rückgabecode

Anforderung:

Byte 1

06h:

Aktiviert/Deaktiviert-Status des USB-Anschlusses am Bedienfeld abrufen

Antwort:

Byte 1 – Rückgabecode

Byte 2

Dieser Befehl wird für die Abfrage von Status/Konfiguration des BF-USB-Anschlusses, Konfiguration von Modus/Zeitlimit des BF-USB-Anschlusses und Eigentümerwechsel des USB-Anschlusses zwischen Host und BMC verwendet.

Bei Konfiguration kann der BF-USB 3 Modi haben: dediziert für Host, nur Eigentum von BMC oder Modus für gemeinsame Nutzung, mit dem ein Eigentümerwechsel zwischen Host und BMC durchgeführt werden kann.

Wenn der Modus für gemeinsame Nutzung aktiviert ist, ist der USB-Anschluss bei ausgeschaltetem Server mit dem BMC verbunden und bei eingeschaltetem Server mit dem Server verbunden.

Wenn der Modus für gemeinsame Nutzung aktiviert und die Serverstromversorgung eingeschaltet ist, gibt der BMC den USB-Anschluss zurück zum Server, nachdem das in der Konfiguration festgelegte Inaktivitätszeitlimit abgelaufen ist.

Wenn der Server über eine ID-Taste verfügt, können Benutzer die ID-Taste aktivieren/deaktivieren, um den Eigentümer des BF-USB-Anschlusses zu wechseln, indem Sie die ID-Taste länger als 3 Sekunden gedrückt halten.

Bei automatischer Umschaltung des Anschlusses bei einer Aus- und Wiedereinschaltung wird die Hysterese in Sekunden festgelegt. Dies ist ein optionaler Parameter.

SD530 Server

Auf der SD530 Plattform ist der Anschluss optional und, falls vorhanden, direkt und ausschließlich mit dem XCC verbunden. Wechsel des Anschlusses zum Host in nicht verfügbar.

  • Wenn der Befehl mit Byte 1 = 1 ausgegeben wird, antwortet der XCC immer, dass der Anschluss das Eigentum des BMC ist.

  • Wenn der Befehl mit Byte 1 = 2 ausgegeben wird, antwortet der XCC immer, dass der Anschluss dediziert für den BMC ist.

  • Wenn der Befehl mit Byte 1 = 3 oder Byte 1 = 4 ausgegeben wird, antwortet der XCC mit dem Rückgabecode D6h.

Andere Server

Auf allen Plattformen außer SD530 kann die XCC-Verwendung des USB-Anschlusses am Bedienfeld deaktiviert werden, indem Sie auf den Modus „Nur Host“ umschalten.

Wenn der Befehl mit Byte 1 = 5 oder Byte 1 = 6 ausgegeben wird, antwortet der XCC mit dem Rückgabecode D6h.

0xC7

Nativer NM-IPMI-Switch

Anforderungslänge = 0:

Leere Anforderungsdaten

Antwort:

Byte 1

Rückgabecode

Byte 2

Aktueller Aktiviert/Deaktiviert-Status

Anforderungslänge = 1:

Byte 1

Aktivieren/Deaktivieren-Attribut für native NM-IPMI-Schnittstelle

00h – Deaktivieren

01h – Aktivieren

Antwort:

Byte 1

Rückgabecode

Dieser Befehl wird verwendet, um die Überbrückungsfunktion von XCC für native Intel IPMI-Befehle zu aktivieren oder zu deaktivieren.