0x0019 - RAID

This module can be used to manage and check physical components in a RAID hard disk array.

0x8nn0 – Module Header

SubIndex

Type

Name

Value

Type

Access

00

VAR

Len

 

UNSIGNED16

read-only

01

VAR

Address

0x0019 00nn

UNSIGNED32

read-only

02

VAR

Type

RAID Controller

VISIBLE STRING

read-only

03

VAR

Name

SCSI Number

VISIBLE STRING

read-only

04

VAR

Dev type

0x0019 2710

UNSIGNED32

read-only

0x8nn1 – Controller Info

SubIndex

Type

Name

Type

Access

00

VAR

Len

UNSIGNED16

read-only

01

VAR

State

UNSIGNED32

read-only

02

VAR

Offline Reason

UNSIGNED32

read-only

State Info

1 = GOOD => Normal operation.
2 = FAILED => Controller signals error. In this state read or write access to the controller should be avoided.
3 = OFFLINE => The controller is in a transition mode and currently unreachable.
In this state, read or write access to the controller must be avoided.
4 = POWEROFF => The controller is currently switched off. (This state may have been preceded by an error.)

Offline Reason Info

0 = NO_REASON => reason unknown.
1 = INITIALIZING => The driver is still being initialized by the controller.
2 = BUS_DEGRADED => The physical interface to the SAS or SATA domain is not working properly (sporadic errors).
3 = BUS_FAILURE => The physical interface to the SAS or SATA domain is not working.

0x8nn2 – RAID Set: Type

The tables 0x8nn2, 0x8nn3 and 0x8nn4 are connected to each other. Each table contains information on existing Raid Sets. The same index references the same Raid Set.

Example: In all three tables index 1 contains detailed information on the same Raid Set.

SubIndex

Type

Name

Type

Access

00

VAR

Len

UNSIGNED16

read-only

01..Len

VAR

Type

UNSIGNED8

read-only

Type info

0 = no RAID
1 = RAID type 0
2 = RAID type 1
3 = RAID type 10
4 = RAID type 5
5 = RAID type 15
255 = RAID type is not a standard type

0x8nn3 – RAID Set: State & Info

SubIndex

Type

Name

Type

Access

00

VAR

Len

UNSIGNED16

read-only

01..Len

VAR

State & Info

UNSIGNED16

read-only

State = low byte

0 = OK => indicator: RAID set is ready for operation.
1 = DEGRADED => indicator: RAID set no longer operates in fault-tolerant mode.
2 = REBUILDING => indicator: RAID set is being restored. This follows a "degraded operation". As soon as the rebuild is completed successfully, the state is set to "OK". If the rebuild fails, the state is updated accordingly.
3 = FAILED => indicator: RAID set shows faulty behavior. The function of the RAID Set is no longer ensured. Data loss is imminent or has already occurred.

Information = high byte

state == OK: Info is 0.
state == DEGRADED: Info contains the index of the faulty hard disk.1
state == REBUILDING: Info contains the percentage value of the recovery. The value is in the range 0 to 100 (0x0 to 0x64).
state == FAILED: Information is 0 or vendor-specific. A manufacturer-specific code may contain hard disk or controller error messages.

1 Not supported

0x8nn4 – RAID Set: Hard disks

This is a list of all RAID Sets in the current system configuration. Each line contains a specific number of hard disks. One byte of the value represents an index in the 0x8nn9 / 0x8nnA list. Detailed information can be found in the 0x8nn9 and 0x8nnA tables. The maximum value is 255.

SubIndex

Type

Name

Type

Access

00

VAR

Len

UNSIGNED16

read-only

01..Len

VAR

Hard disks

ARRAY [ ] OF UNSIGNED8

read-only

0x8nn5 – 0x8nn8 : Reserved

0x8nn9 – Hard disk: Serial number

SubIndex

Type

Name

Type

Access

00

VAR

Len

UNSIGNED16

read-only

01..Len

VAR

Serial Number

VISIBLE STRING

read-only

Serial Number

Maximum 40 bytes

0x8nnA – Hard disk: State

SubIndex

Type

Name

Type

Access

00

VAR

Len

UNSIGNED16

read-only

01..Len

VAR

State

UNSIGNED8

read-only

State

0 = OK => indicator: The physical hard disk is in operation.
1 = REBUILDING => indicator: The physical hard disk is part of the configuration of a RAID set.
As soon as the build is completed successfully, the state changes to OK.
If the (re-)configuration is unsuccessful, the state is updated accordingly.1
2 = FAILED => indicator: The physical hard disk has reported unrecoverable errors to the controller, or it has started a manufacturer-specific action, in order to remove the physical hard disk from the RAID set.
The behavior of the hard disk cannot be guaranteed, data loss is imminent or has already occurred.
3 = DEGRADED => indicator: The physical hard disk has sent a SMART message to the controller.

1 Not Supported

System requirements

OS

XPE, WES, WES 7
XP, Windows 7, Windows 10

RAID driver

IMSM 7.0 PV or higher