OEM-IPMI-Befehle
Der XCC unterstützt die folgenden IPMI-OEM-Befehle. Jeder Befehl erfordert eine andere Berechtigungsstufe (siehe unten).
Code | Netfn 0x2E-Befehle | Berechtigung |
---|---|---|
0xCC | XCC auf Standard zurücksetzen | PRIV_USR |
Code | Netfn 0x3A-Befehle | Berechtigung |
---|---|---|
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 Code Befehl Anforderungsdaten, Antwortdaten Beschreibung 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 Code Befehl Anforderungsdaten, Antwortdaten Beschreibung 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 Code Befehl Anforderungsdaten, Antwortdaten Beschreibung 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 Code Befehl Anforderungsdaten, Antwortdaten Beschreibung 0x55
Hostnamen abrufen/festlegen
Anforderungslänge = 0:
Leere Anforderungsdaten
Antwort:
Anforderungslänge 1‑64:Byte 1
Rückgabecode
Bytes 2-65
Aktueller Hostname
ASCIIZ, Null-terminierte Zeichenfolge
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
Antwort:01h:
Aktuellen Eigentümer des USB-Anschlusses am Bedienfeld abrufen
Byte 1 – Rückgabecode
Byte 2
Anforderung:00h:
Eigentum von Host
01h:
Eigentum von BMC
Byte 1
Antwort:02h:
Konfiguration des USB-Anschlusses am Bedienfeld abrufen
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
Antwort:00h:
Zu Host wechseln
01h:
Switch zu BMC
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
Antwort:06h:
Aktiviert/Deaktiviert-Status des USB-Anschlusses am Bedienfeld abrufen
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:
Anforderungslänge = 1:Byte 1
Rückgabecode
Byte 2
Aktueller Aktiviert/Deaktiviert-Status
Antwort:Byte 1
Aktivieren/Deaktivieren-Attribut für native NM-IPMI-Schnittstelle
00h – Deaktivieren
01h – Aktivieren
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.