======adc_read====== WMPRO FW >= 1.0 WMMEGA FW >= 2.0 Read an onboard ADC channel ====Description==== int adc_read ( int $channel ) Return the raw ADC value of a channel ====Parameter==== $channel: Value between 0 and 2 Channel 0 is attached to pin A1, which is the voltage divider to measure battery voltage and can measure up to 60V DC. Channel 1 is connected to pin A2 which can handle up to 330V DC. Channel 2 is connected to pin A3, which reads 0-5V DC. ====Return Values==== Integer ADC value: WMPRO 10-bit, 0-1023 WMMEGA 12-bit, 0-4095 ====Examples==== ===Example #1=== Read Channel 0 and use the constants v_adc_offset and v_adc_mul to obtain a calibrated voltage((**Example #1** demonstrates a legacy method to obtain a calibrated voltage, which was the primary method in early [[hardware:wattmons|Wattmon]] releases, and has not yet been removed from the OS. The calibration constants are loaded automatically into [[uphp:uphp_special_variables|$_GLOBALS]] from the SD Card [[software:os:config:battery.ini|/config/battery.ini]]. These constants can be calculated and set using Control Panel > Voltage Calibration (Calibrate Voltage Sensor). However, that Control Panel interface does not produce or set calibration constants for Channels 1 and 2, and as mentioned, it stores the constants on the SD Card. This "old method" has been superseded by "a new method" that stores the calibration constants for A1, A2 and A3 in NVRAM. The new calibration method is accessed in Control Panel > Devices. There it is possible to calibrate any device on the [[hardware:wattmons|Wattmon]] or attached by ModBus, and the constants are then stored in NVRAM on the device itself, instead of on the SD Card. See [[#Additional Information]] for how to obtain calibrated values using the new method.)):

Typical output for the above example (results vary depending on actual voltage and calibration constants):


adc=192
v_adc_offset=24.811435
v_adc_mul=0.065411
volts=14.181854

====Additional Information==== The raw ADC values can be accessed using [[adc_read()]], but it is recommended to use the functions [[mb_get_val_by_role()]] or [[mb_get_dev_by_id()]] in order to obtain calculated values for A1, A2 and A3 that are adjusted by the calibration values stored in //NVRAM//. ===Example #2=== Use [[mb_get_dev_by_id()]] to obtain calibrated values for A1, A2 and A3:

Typical output for the above example (results vary depending on actual voltage and calibration constants):


A1=13.600001 V
A2=2.100000 V
A3=4.980000 V

====See Also==== [[uphp:uphp_special_variables]] - Special arrays that are populated automatically (including ''$_GLOBALS'') [[pin_configure()]] - Configure an I/O pin as a digital input, output, or analog input [for more information on Channel numbers which are also known as Pin Indexes] [[floatval()]] - Return the float value of a number or string