ibm,get-dynamic-sensor-state RTAS Call
This RTAS call behaves as the RTAS
get-sensor-state call, except that the instance of
the sensor is identified by a location code instead of a index.
R1--1.
Platforms that
implement any sensors that are identified by location code instead of
index (see Requirement
) must implement the
ibm,get-dynamic-sensor-state RTAS function.
R1--2.
The RTAS function
ibm,get-dynamic-sensor-state must implement the
argument call buffer defined by
.
Argument Call Buffer
ibm,get-dynamic-sensor-state
Parameter Type
Name
Values
In
Token
Token for
ibm,get-dynamic-sensor-state
Number Inputs
2
Number Outputs
2
Sensor
Token defining the sensor
Location Code Address
Real or Logical address of a location code string, in the
format defined by Requirement
Out
Status
-1: Hardware error
-2: Busy, try again later
-3: No such indicator
0: Success
990x: Extended delay, where x is a number between 0 and
5, as described below
State
Current state of the sensor as defined in the
Defined Values column of
.
When 990x
Status is returned, it is suggested that software
delay for 10 raised to the power
x milliseconds (where
x is the last digit of the 990x return code), before
calling
ibm,get-dynamic-sensor-state with the same indicator
type and location code. However, software may call
ibm,get-dynamic-sensor-state again either earlier or
later than this.
R1--3.
The OS must not call
ibm,get-dynamic-sensor-state with a different sensor
until a non-busy return
Status has been received from the previous
ibm,get-dynamic-sensor-state call.
R1--4.
The work area must be contiguous in real
memory and must reside below 4GB.
R1--5.
The input data
format in the work area must be as follows:
32-bit integer length of the location code string, including
NULL
Location code string, NULL terminated, identifying the sensor to
be set.
R1--6.
The platform must not modify the location
code string.
R1--7.
The OS must only use this call with sensors
which have been provided by the
ibm,get-indices RTAS call with an index value of
0xFFFFFFFF.
R1--8.
The platform must use the
ibm,get-dynamic-sensor-state RTAS call only for
dynamic sensor types of 9004, 9006 and 9007.
R1--9.
A Status of -3 must be returned for the following
conditions:
Sensor type not supported
The specified location code does not identify a valid
sensor