==== GetInputValue ====

Fetch the value of a hardware input.

=== Description ===

<code>GetInputValue( inputno, mode )</code>

The value returned will depend on the hardware mode of the input, which should have been set already using the [[ezeio2:scriptref:setinputmode|SetInputMode]] command. 

=== Parameters ===

| ''inputno'' | Input number to read. Inputs 1-8 are on the ezeio. Use "DVCn+inputno" for expansion devices |
| ''mode'' | The desired read mode. See below. |

Input numbers:
^ Input ^ Description ^
^ IN_1 .. IN_16 | Input numbers (equivalent to 1 .. 16) |
^ IN_VIN | Supply voltage (in mV) |
^ IN_VBAT | Voltage on Battery Terminals (in mV) |
^ IN_V5 | 5V regulated output voltage |
^ DVC1+IN_1 | (example) First input on first expansion device |


Available read modes:
^ Mode ^ Reading ^
^ INVAL_RAW | Momentary value. Unit depends on input hardware setting. | 
^ INVAL_MIN | Smallest value in this sampling interval. Unit depends on input hardware setting. | 
^ INVAL_MAX | Largest value in this sampling interval.  Unit depends on input hardware setting. | 
^ INVAL_AVG | Average value in this sampling interval. Unit depends on input hardware setting. | 
^ INVAL_INTERVAL | Pulse interval in ms |
^ INVAL_FREQ | Pulse frequency in Hz x1000 (mHz) |
^ INVAL_COUNT | Pulse count |

=== Return value ===

Value of input.

The unit of the returned value depends on the input hardware setting:
^ Hardware setting ^ Input unit ^ Description ^
| INMODE_10V | mV (milliVolt) | 0-10240 mV |
| INMODE_30mA | uA (microAmpere) | 0-30000 uA |
| INMODE_PULLUP | Ω (Ohm) | 0-10000000 Ohm (0-1MΩ) |
| INMODE_THERMISTOR* | °K x100 (Kelvin) | 0-60000 Kelvin x 100 | 

=== Example usage ===

<code javascript>    
    new x;
    x = GetInputValue(IN_3, INVAL_RAW);  // Return the current value of the input
</code>