<emphasis>ibm,get-dynamic-sensor-state</emphasis> 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 .   <emphasis>ibm,get-dynamic-sensor-state</emphasis> Argument Call Buffer 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