A P P E N D I X  B

Sun OEM IPMI Commands

This appendix contains the following sections:

 

The commands described in this appendix are specific to ATCA node boards designed by Sun Microsystems. The Internet Assigned Numbers Authority (IANA) number assigned to Sun Microsystems is 42.

Refer to http://www.iana.org/assignments/enterprise-numbers for more information about IANA number assignments.

The netfunction (NetFn) used for these commands is 0x2E, which is the OEM netfunction as defined in the IPMI specification. For this netfunction, the first three data bytes in the request packet must be this IANA number and the first three bytes in the response packet following the completion code are the IANA number. For Sun ATCA node boards, these three bytes are 00 00 2A.

The Sun OEM IPMI commands are listed in TABLE B-1 and described in the following sections.


TABLE B-1 Sun OEM IPMI Commands

Command

Opcode

Syntax

Get Version

0x80

#GET_VERSION

Set Boot Page|

0x81

#SET_BOOT_PAGE

Get Boot Page|

0x82

#GET_BOOT_PAGE

Set Front panel reset button state

0x83

#SET_FP_RESET_BUTTON

Get Front panel reset button state

0x84

#GET_FP_RESET_BUTTON_STATE

Set Ethernet Force Front bit

0x85

#SET_ETH_FORCE_FRONT

Get Ethernet Force Front bit

0x86

#GET_ETH_FORCE_FRONT

Get RTM status

0x88

#GET_RTM_STATUS


| Valid for the Sun CP3010 node board only


B.1 Get Version Command

Get Version returns the IPM controller (IPMC) firmware version and Standby CPLD version. Bytes 8, 9, and A are reserved for future use.


Command

NetFn

Opcode

Reference

Get Version

0x2E (OEM)

0x80

- -


Data Bytes


Type

Byte

Data Field

Request data

Byte1

00

Byte2

00

Byte3

2A

Response data

Byte1

Completion code:
00 = OK
C1 = Command not supported
CC = Invalid data in request

(Refer to IPMI specification for more completion codes)

Byte2

00

Byte3

00

Byte4

2A

Byte5

CPLD version

Byte6

REV1 byte of IPMC firmware

Byte7

REV2 byte of IPMC firmware

Byte8

Reserved for future use (ignore)

Byte9

Reserved for future use (ignore)

ByteA

Reserved for future use (ignore)


Example (Terminal Mode):

[B8 00 80 00 00 2A] <-------Request
[BC 00 80 00 00 00 2A 02 02 00 00 00 00] <----Response

lower nibble of REV1 . high nibble of REV2 . low nibble of REV2

In the preceding example, the IPMC version is 2.0.0.

-> lower nibble of CPLD version byte

In the example, the CPLD version is 2.


B.2 Set Boot Page Command

Set Boot Page sets the boot page bits in the standby CPLD to select the boot page for the Open Boot PROM. This feature can be used in bootFlash failure recovery. This command is valid only for the Sun CP3010 node board.


Command

NetFn

Opcode

Reference

Set Boot Page

0x2E (OEM)

0x81

CPLD Specification 1.0


Data Bytes


Type

Byte

Data Field

Request data

Byte1

00

Byte2

00

Byte3

2A

 

Byte4

Boot page setting.
Bits 7 to 2 = 0
Bits 1 and 0 = Boot page number

Response data

Byte1

Completion code:
00 = OK
C1 = Command not supported
CC = Invalid data in request

(Refer to IPMI specification for more completion codes)

Byte2

00

Byte3

00

Byte4

2A


Example (Terminal Mode):

[B8 00 81 00 00 2A 02] <------Request
[BC 00 81 00 00 00 2A] <------Response

 


B.3 Get Boot Page Command

Get Boot Page returns current settings of the selected OpenBoot PROM boot page and the current settings of the hardware switch selecting the boot page. This command is valid only for the Sun CP3010 node board.


Command

NetFn

Opcode

Reference

Get Boot Page

0x2E (OEM)

0x82

- -


Data Bytes


Type

Byte

Data Field

Request data

Byte1

00

Byte2

00

Byte3

2A

Response data

Byte1

Completion code:

00 = OK
C1 = Command not supported
CC = Invalid data in request

(Refer to IPMI specification for more completion codes)

Byte2

00

Byte3

00

Byte4

2A

Byte5

Boot Page Settings

Bit 7 to 4 = Ignore. Shall be zeros
Bit 3, 2 = Hardware switch settings
Bit 1, 0 = Currently set boot page


Example (Terminal Mode):

[B8 00 82 00 00 2A] <------Request
[BC 00 82 00 00 00 2A 02] <------Response


B.4 Set Front Panel Reset Button State Command

Set Front panel reset button state is used by the software to change the way the front panel reset is handled by CPLD when this button is pressed. Default on CPLD power up is 10.


Command

NetFn

Opcode

Reference

Set Front panel reset button state

0x2E (OEM)

0x83

CPLD Specification 1.0


Data Bytes


Type

Byte

Data Field

Request data

Byte1

00

Byte2

00

Byte3

2A

 

Byte4

Front panel reset button setting.
Bits 7 to 2 = 0
Bits 1 and 0 = Front panel button state:
00 = Reset IPMC and assert POR to CPU
01 = XIR to CPU
10 = POR to CPU
11 = Front panel reset button disabled

Response data

Byte1

Completion code:

00 = OK
C1 = Command not supported
CC = Invalid data in request

(Refer to IPMI specification for more completion codes)

Byte2

00

Byte3

00

Byte4

2A


Example (Terminal Mode):

[B8 00 83 00 00 2A 02] <------Request
[BC 00 83 00 00 00 2A] <------Response


B.5 Get Front Panel Reset Button State Command

Get Front panel reset button state returns current settings of the front panel reset button handling. By default, on CPLD power-on it comes up as 10, that is, pressing this button causes a Power-on reset to the CPU.


Command

NetFn

Opcode

Reference

Get Front panel reset button state

0x2E (OEM)

0x84

CPLD Specification 1.0


Data Bytes


Type

Byte

Data Field

Request data

Byte1

00

Byte2

00

Byte3

2A

Response data

Byte1

Completion code:

00 = OK
C1 = Command not supported
CC = Invalid data in request

(Refer to IPMI specification for more completion codes)

Byte2

00

Byte3

00

Byte4

2A

Byte5

Front panel reset button setting.
Bits 7 to 2 = Zeros.
Bits 1 and 0 = Front panel button state:
00 = Reset IPMC and assert POR to CPU
01 = XIR to CPU
10 = POR to CPU
11 = Front panel reset button disabled


Example (Terminal Mode):

[B8 00 84 00 00 2A] <------Request
[BC 00 84 00 00 00 2A 02] <------Response


B.6 Set Ethernet Force Front Bit Command

Set Ethernet Force Front Bit is used by software to force the Ethernet connection to the front I/O panel even if the rear transition card is present in the system. Setting this bit to 1 forces the Ethernet connection to front I/O panel.


Command

NetFn

Opcode

Reference

Set Ethernet Force Front Bit

0x2E (OEM)

0x85

CPLD Specification 1.0


Data Bytes


Type

Byte

Data Field

Request data

Byte1

00

Byte2

00

Byte3

2A

 

Byte4

Ethernet Force front bit setting
Bits 7 to 1 = 0
Bits 0 = Force front state (1 = Force Ethernet connection to front)

Response data

Byte1

Completion code:
00 = OK
C1 = Command not supported
CC = Invalid data in request

(Refer to IPMI specification for more completion codes)

Byte2

00

Byte3

00

Byte4

2A


Example (Terminal Mode):

[B8 00 85 00 00 2A 01] <------Request
[BC 00 85 00 00 00 2A] <------Response

 


B.7 Get Ethernet Force Front Bit Command

Get Ethernet Force Front Bit returns the current setting of the Ethernet force front bit.


Command

NetFn

Opcode

Reference

Get Ethernet Force Front Bit

0x2E (OEM)

0x86

CPLD Specification 1.0


Data Bytes


Type

Byte

Data Field

Request data

Byte1

00

Byte2

00

Byte3

2A

Response data

Byte1

Completion code:
00 = OK
C1 = Command not supported
CC = Invalid data in request

(Refer to IPMI specification for more completion codes)

Byte2

00

Byte3

00

Byte4

2A

 

Byte5

Ethernet Force front bit setting
Bits 7 to 1 = 0
Bits 0 = Ethernet force front bit setting (1 = Force Ethernet connection to front)


Example (Terminal Mode):

[B8 00 86 00 00 2A] <------Request
[BC 00 86 00 00 00 2A 01] <------Response


B.8 Get RTM Status Command

Get RTM Status can be used to detect the presence of a rear transion module (RTM) in the system.


Command

NetFn

Opcode

Reference

Get RTM Status

0x2E (OEM)

0x88

CPLD Specification


Data Bytes


Type

Byte

Data Field

Request data

Byte1

00

Byte2

00

Byte3

2A

Response data

Byte1

Completion code:
00 = OK
C1 = Command not supported
CC = Invalid data in request

Byte2

00

Byte3

00

Byte4

2A

 

Byte5

RTM presence
Bits 7 to 1 = 0
Bits 0 = RTM presence (0 = RTM not detected, 1 = RTM detected)


Example (Terminal Mode):

[B8 00 88 00 00 2A] <------Request
[BC 00 88 00 00 00 2A 01] <------Response