Size:
3.03 Mb
Download

System Management:Vendor Commands

Reset IPMC Command

The Reset IPMC command allows the payload to reset the IPMC over the SIPL.

Table 9-19: Reset IPMC Command

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

4

Reset Type Code

 

 

0x00 Cold IPMC reset to the current mode

 

 

0x01 Cold IPMC reset to the Normal mode

 

 

0x02 Cold IPMC reset to the Standalone mode

 

 

0x03 Cold IPMC reset to the Manual Standalone mode

 

 

0x04 Reset the IPMC and enter Upgrade mode

 

 

 

Response Data

1

Completion Code

 

 

 

 

2:4

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

Hang IPMC Command

The IPMC provides a way to test the watchdog timer support by implementing the Hang

IPMC command, which simulates firmware hanging by entering an endless loop.

Table 9-20: Hang IPMC Command

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

Response Data

1

Completion Code

 

 

 

 

2:4

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

10007175-02

KAT4000 User’s Manual

9-21

 

 

 

System Management:Vendor Commands

Bused Resource Control Command

To send a Bused Resource Control command to the shelf manager, the payload uses the

Bused Resource Control command of the SIPL.

Table 9-21: Bused Resource Control Command

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

4

Command Types for Shelf Manager to Board

 

 

0 Query if board has control of the bus

 

 

1 Release requests a board to release control of the bus

 

 

2 Force board to release control of bus immediately

 

 

3 Bus Free informs board that the bus is available

 

 

Command Types for Board to Shelf Manager

 

 

0 Request to seize control of the bus

 

 

1 Relinquish control of the bus, Shelf Manager can reassign

 

 

control of bus

 

 

2 Notify Shelf Manager that control of the bussed resource has

 

 

been transferred to this board from another authorized board

 

 

 

 

5

Bused Resource ID

 

 

0 Metallic Test Bus pair #1

 

 

1 Metallic Test Bus pair #2

 

 

2 Synch clock group 1 (CLK1A and CLK1B pairs)

 

 

3 Synch clock group 2 (CLK2A and CLK2B pairs)

 

 

3 Synch clock group 3 (CLK3A and CLK3B pairs)

 

 

 

Response Data

1

Completion Code

 

 

 

 

2:4

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

5

Status

 

 

0 Ack; Shelf Manager acknowledges that board has control

 

 

1 Error; same as Ack, but Shelf Manager believes board should

 

 

not have been given control of the resource (optional)

 

 

2 Deny; Shelf Manager denies control of resource by the board

 

 

 

Bused Resource Status Command

If the IPMC receives a Bused Resource Control command from IPMB-0,it asserts an appropriate event and notifies the payload which uses the Bused Resource Status command over the SIPL. When the IPMC receives a Bused Resource Status command, the respective bit in the IPMC status is cleared.

The payload must issue a Bused Resource Status command before the payload communication time-outtime. If the payload does not issue such a command before the payload communicationtime-outtime, the IPMC sends the 0xC3 completion code(Time-Out)in the appropriate Bused Resource Control command reply.

9-22

KAT4000 User’s Manual

10007175-02

 

 

 

System Management:Vendor Commands

Table 9-22: Bused Resource Status Command

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

4

Command Types for Shelf Manager to Board

 

 

0 Query if board has control of the bus

 

 

(0=In control, 1= No control)

 

 

1 Release request a board to release control of the bus

 

 

(0=Ack, 1=Refused, 2=No control)

 

 

2 Force board to release control of bus immediately

 

 

(0=Ack, 1=No control)

 

 

3 Bus Free informs board that the bus is available

 

 

(0=Accept, 1=Not needed)

 

 

Command Types for Board to Shelf Manager

 

 

0 Request to seize control of the bus

 

 

(0=Grant, 1=Busy, 2=Defer, 3=Deny)

 

 

1 Relinquish control of the bus, Shelf Manager can reassign

 

 

control of bus (0=Ack, 1=Error)

 

 

2 Notify Shelf Manager that control of the bussed resource has

 

 

been transferred to this board from another authorized board

 

 

(0=Ack, 1=Error, 2=Deny)

 

 

 

 

5

Bused Resource ID

 

 

0 Metallic Test Bus pair #1

 

 

1 Metallic Test Bus pair #2

 

 

2 Synch clock group 1 (CLK1A and CLK1B pairs)

 

 

3 Synch clock group 2 (CLK2A and CLK2B pairs)

 

 

4 Synch clock group 3 (CLK3A and CLK3B pairs)

 

 

 

 

6

Status

 

 

0 Ack; Shelf Manager acknowledges that board has control

 

 

1 Error; same as Ack, but Shelf Manager believes board should

 

 

not have been given control of the resource (optional)

 

 

2 Deny; Shelf Manager denies control of resource by the board

 

 

 

Response Data

1

Completion Code

 

 

 

 

2:4

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

Graceful Reset Command

The IPMC supports the Graceful Reboot option of the FRU Control command. On receiving such a command, the IPMC sets the Graceful Reboot Request bit of the IPMC status, sends a status update notification to the payload, and waits for the Graceful Reset command from the payload. If the IPMC receives such a command before the payload communication time-outtime, it sends the 0x00 completion code (Success) to the shelf manager. Otherwise the 0xCC completion code is sent.

10007175-02

KAT4000 User’s Manual

9-23

 

 

 

System Management:Vendor Commands

The IPMC does not reset the payload on receiving the Graceful Reset command or timeout. If the IPMC participation is necessary, the payload must request the IPMC to perform a payload reset. The Graceful Reset command is also used to notify the IPMC about the completion of the payload shutdown sequence.

Table 9-23: Graceful Reset Command

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

Response Data

1

Completion Code

 

 

 

 

2:4

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

Diagnostic Interrupt Results

The IPMC supports the Issue Diagnostic Interrupt feature of the FRU Control command. The payload is notified about a diagnostic interrupt over the SIPL. The payload is expected to return diagnostic interrupt results before the payload communication time-outusing the Diagnostic Interrupt Results command of the SIPL.

Table 9-24: Diagnostic Interrupt Results Command

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

4

If the payload responds before the payload communication

 

 

time-out,the diagnostic interrupt return code is forwarded to

 

 

the shelf controller as the completion code of the FRU Control

 

 

command response. Otherwise, the 0xCC completion code is

 

 

returned.

 

 

 

Response Data

1

Completion Code

 

 

 

 

2:4

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

Get Payload Shutdown Time-OutCommand

When the shelf manager commands the IPMC to shut down the payload (i.e. sends the Set Power Level (0) command), the IPMC notifies the payload by asserting an appropriate alert and sending an alert notification to the payload. Upon receiving this notification, the payload software is expected to initiate the payload shutdown sequence. After performing this sequence, the payload should send the Graceful Reset command to the IPMC over the Payload Interface to notify the IPMC that the payload shutdown is complete.

9-24

KAT4000 User’s Manual

10007175-02

 

 

 

System Management:Vendor Commands

To avoid deadlocks that may occur if the payload software does not respond, the IPMC provides a special time-outfor the payload shutdown sequence. If the payload does not send the Graceful Reset command within a definite period of time, the IPMC assumes that the payload shutdown sequence is finished, and sends a Module Quiesced Hot Swap event to the KAT4000 controller.

Table 9-25: Get Payload ShutdownTime-OutCommand

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

Response Data

1

Completion Code

 

 

 

 

2:4

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

5:6

Time-Outmeasured in hundreds of milliseconds, LSB first

 

 

 

Set Payload Shutdown Time-OutCommand

The Set Payload Shutdown Time-Outcommand is defined as follows.

Table 9-26: Set Payload ShutdownTime-OutCommand

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

4:5

Time-Outmeasured in hundreds of milliseconds, LSB first

 

 

 

Response Data

1

Completion Code

 

 

 

 

2:4

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

Get Module State Command

The Get Module State command is used to query the state of an AMC via any of the external interfaces.

Table 9-27: Get Module State Command

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

4

AMC Site ID

 

 

 

10007175-02

KAT4000 User’s Manual

9-25

 

 

 

System Management:Vendor Commands

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Type:

 

 

Byte:

 

Data Field: (continued)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Response Data

 

1

 

 

 

 

 

Completion Code

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2:4

 

 

 

 

 

PPS IANA Private Enterprise ID, MS Byte first

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

5

 

 

 

 

 

AMC Status

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

0

0

= AMC site is enabled

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1

= AMC site is disabled

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1

0

= AMC is not present

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1

= AMC is present

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2

0

= Management power is disabled

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1

= Management power is enabled

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3

0

= Management power is bad

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1

= Management power is good

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

4

0

= Payload power is disabled

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1

= Payload power is enabled

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

5

0

= Payload power is bad

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1

= Payload power is good

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

6

0

= IPMB-Lbuffer is not attached

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1

= IPMB-Lbuffer is attached

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

7

0

= IPMB-Lbuffer is not ready

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1

= IPMB-Lbuffer is ready

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Enable AMC Site Command

The Enable AMC Site command is used to enable an AMC site.

Table 9-28: Enable AMC Site Command

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

4

AMC Site ID

 

 

 

Response Data

1

Completion Code

 

 

 

 

2:4

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

Disable AMC Site Command

The Disable AMC Site command is used to disable an AMC site. If an AMC site is disabled, the IPMC firmware ignores the AMC inserted and acts as if the AMC is not present.

Table 9-29: Disable AMC Site Command

Type:

Byte:

Data Field:

Request Data

1:3

PPS IANA Private Enterprise ID, MS Byte first

 

 

0x00400A = 16394 (Pigeon Point Systems)

 

 

 

 

4

AMC Site ID

 

 

 

9-26

KAT4000 User’s Manual

10007175-02

 

 

 

System Management: IPMC Watchdog Timer Commands

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Type:

 

 

Byte:

Data Field: (continued)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Response Data

1

 

 

 

 

 

Completion Code

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2:4

 

 

 

 

 

PPS IANA Private Enterprise ID, MS Byte first

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

0x00400A = 16394 (Pigeon Point Systems)

IPMC WATCHDOG TIMER COMMANDS

The IPMC implements a standardized ‘Watchdog Timer’ that can be used for a number of system time-outfunctions by System Management Software (SMS) or by the monitor. Setting atime-outvalue of zero allows the selectedtime-outaction to occur immediately. This provides a standardized means for devices on the IPMB to perform emergency recovery actions.

Table 9-30: IPMC Watchdog Timer Commands

Command:

See Page:

Optional/Mandatory:

Reset Watchdog Timer

9-29

M

 

 

 

Set Watchdog Timer

9-29

M

 

 

 

Get Watchdog Timer

9-31

M

 

 

 

Watchdog Timer Actions

The following actions are available on expiration of the Watchdog Timer:

System Reset

System Power Off

The System Reset and System Power Off on time-outselections are mutually exclusive. The watchdog timer is stopped whenever the system is powered down. A command must be sent to start the timer after the system powers up.

Watchdog Timer Use Field and Expiration Flags

The watchdog timer provides a ‘timer use’ field that indicates the current use assigned to the watchdog timer. The watchdog timer provides a corresponding set of ‘timer use expiration’ flags that are used to track the type of time-out(s)that had occurred.

The time-outuse expiration flags retain their state across system resets and power cycles, as long as the IPMC remains powered. The flags are normally cleared solely by the Set Watchdog Timer command; with the exception of the “don’t log” flag, which is cleared after every system hard reset or timertime-out.

10007175-02

KAT4000 User’s Manual

9-27

 

 

 

System Management: IPMC Watchdog Timer Commands

The Timer Use fields indicate:

Monitor FRB-2Time-out:

A Fault-resilientBooting, level 2(FRB-2)time-outhas occurred. This indicates that the last system reset or power cycle was due to the systemtime-outduring POST, presumed to be caused by a failure or hang related to the bootstrap processor.

Monitor POST Time-out:

In this mode, the time-outoccurred while the watchdog timer was being used by the monitor for some purpose other thanFRB-2or OS Load Watchdog.

OS Load Time-out: The last reset or power cycle was caused by the timer being used to ‘watchdog’ the interval from ‘boot’ to OS up and running. This mode requires system management software, or OS support. The monitor should clear this flag if it starts this timer during POST.

SMS ‘OS Watchdog’ Time-out:

This indicates that the timer was being used by System Management Software (SMS). During run-time,SMS starts the timer, then periodically resets it to keep it from expiring. This periodic action serves as a ‘heartbeat’ that indicates that the OS (or at least the SMS task) is still functioning. If SMS hangs, the timer expires and the IPMC generates a system reset. When SMS enables the timer, it should make sure the ‘SMS’ bit is set to indicate that the timer is being used in its ‘OS Watchdog’ role.

OEM: This indicates that the timer was being used for anOEM-specificfunction.

Using the Timer Use Field and Expiration Flags

The software that sets the Timer Use field is responsible for managing the associated Timer Use Expiration flag. For example, if System Management Software (SMS) sets the timer use to “SMS/OS Watchdog,” then that same SMS is responsible for acting on and clearing the associated Timer Use Expiration flag.

In addition, software should only interpret or manage the expiration flags for watchdog timer uses that it set. For example, the monitor should not report watchdog timer expirations or clear the expiration flags fornon-monitoruses of the timer. This is to allow the software that did set the Timer Use to see that a matching expiration occurred.

Watchdog Timer Event Logging

By default, the IPMC will automatically log the corresponding sensor-specificwatchdog sensor event when a timer expiration occurs. A “don’t log” bit is provided to temporarily disable the automatic logging. The “don’t log” bit is automatically cleared (logging reenabled) whenever a timer expiration occurs.

9-28

KAT4000 User’s Manual

10007175-02

 

 

 

System Management: IPMC Watchdog Timer Commands

Monitor Support for Watchdog Timer

If a system “Warm Reset” occurs, the watchdog timer may still be running while the monitor executes POST. Therefore, the monitor should take steps to stop or restart the watchdog timer early in POST. Otherwise, the timer may expire later during POST or after the OS has booted.

Reset Watchdog Timer Command

The Reset Watchdog Timer command is used for starting and restarting the Watchdog Timer from the initial countdown value that was specified in the Set Watchdog Timer command.

If a pretime-outinterrupt has been configured, the Reset Watchdog Timer command will not restart the timer once thepretime-outinterval has been reached. The only way to stop the timer once it has reached this point is via the Set Watchdog Timer command.

Table 9-31: Reset Watchdog Timer Command

Type:

Byte:

Data Field:

Request Data

 

 

 

Response Data

1

Completion Code

 

 

 

Set Watchdog Timer Command

The Set Watchdog Timer command is used for initializing and configuring the watchdog timer. The command is also used for stopping the timer.

If the timer is already running, the Set Watchdog Timer command stops the timer (unless the “don’t stop” bit is set) and clears the Watchdog pretime-outinterrupt flag (see Get Message Flags command in the IPMI specification v1.5). IPMC hard resets, system hard resets, and the Cold Reset command also stop the timer and clear the flag.

Byte 1: This selects the timer use and configures whether an event will be logged on expiration.

Byte 2: This selects thetime-outaction andpretime-outinterrupt type.

Byte 3: This sets thepretime-outinterval. If the interval is set to zero, thepretime-outaction occurs concurrently with thetime-outaction.

Byte 4: This clears the Timer Use Expiration flags. A bit set in byte 4 of this command clears the corresponding bit in byte 5 of the Get Watchdog Timer command.

Bytes 5 and 6: These hold the least significant and most significant bytes, respectfully, of the countdown value. The Watchdog Timer decrement is one count/100 ms. The counter expires when the count reaches zero. If the counter is loaded with zero and the Reset Watchdog command is issued to start the timer, the associated timer events occur immediately.

10007175-02

KAT4000 User’s Manual

9-29

 

 

 

System Management: IPMC Watchdog Timer Commands

Table 9-32: Set Watchdog Timer Command

Type:

Byte:

Data Field:

Request Data

1

Timer Use

 

 

[7] 1b=don’t log

 

 

[6] 1b=don’t stop timer on Set Watchdog Timer command (new

 

 

for IPMI v1.5) new parameters take effect immediately. If

 

 

timer is already running, countdown value will get set to

 

 

given value and countdown will continue from that point.

 

 

If timer is already stopped, it will remain stopped. If the

 

 

pretime-outinterrupt bit is set, it will get cleared.1

 

 

0b=timer stops automatically when Set Watchdog Timer

 

 

command is received

 

 

[5:3] reserved

 

 

[2:0] timer use (logged on expiration when “don’t log” bit = 0b)

 

 

000b=reserved

 

 

001b=Monitor FRB-2

 

 

010b=Monitor/POST

 

 

011b=OS Load

 

 

100b=SMS/OS

 

 

101b=OEM

 

 

110b-111b=reserved

 

 

 

 

2

Timer Actions

 

 

[7] reserved

 

 

[6:4] pretime-outinterrupt (logged on expiration when “don’t

 

 

log” bit = 0b)

 

 

000b=none

 

 

001b=SMI

 

 

010b=NMI/Diagnostic Interrupt

 

 

011b=Messaging Interrupt (this is the same interrupt as

 

 

allocated to the messaging interface)

 

 

100b, 111b =reserved

 

 

[3] reserved

 

 

[2:0] time-outaction

 

 

000b=no action

 

 

001b=Hard Reset

 

 

010b=Power Down

 

 

011b=Power Cycle

 

 

100b, 111b=reserved

 

 

 

 

3

Pretime-outinterval in seconds, ‘1’ based

 

 

 

9-30

KAT4000 User’s Manual

10007175-02