Mistake on this page?
Report an issue in GitHub or email us
Public Member Functions
AnalogIn Class Reference

An analog input, used for reading the voltage on a pin. More...

#include <AnalogIn.h>

Public Member Functions

 AnalogIn (PinName pin)
 Create an AnalogIn, connected to the specified pin. More...
 
float read ()
 Read the input voltage, represented as a float in the range [0.0, 1.0]. More...
 
unsigned short read_u16 ()
 Read the input voltage, represented as an unsigned short in the range [0x0, 0xFFFF]. More...
 
 operator float ()
 An operator shorthand for read() More...
 

Detailed Description

An analog input, used for reading the voltage on a pin.

Note
Synchronization level: Thread safe

Example:

// Print messages when the AnalogIn is greater than 50%
#include "mbed.h"
AnalogIn temperature(p20);
int main() {
while(1) {
if(temperature > 0.5) {
printf("Too hot! (%f)", temperature.read());
}
}
}

Definition at line 53 of file AnalogIn.h.

Constructor & Destructor Documentation

AnalogIn ( PinName  pin)

Create an AnalogIn, connected to the specified pin.

Parameters
pinAnalogIn pin to connect to

Definition at line 61 of file AnalogIn.h.

Member Function Documentation

operator float ( )

An operator shorthand for read()

The float() operator can be used as a shorthand for read() to simplify common code sequences

Example:

float x = volume.read();
float x = volume;
if(volume.read() > 0.25) { ... }
if(volume > 0.25) { ... }

Definition at line 106 of file AnalogIn.h.

float read ( )

Read the input voltage, represented as a float in the range [0.0, 1.0].

Returns
A floating-point value representing the current input voltage, measured as a percentage

Definition at line 72 of file AnalogIn.h.

unsigned short read_u16 ( )

Read the input voltage, represented as an unsigned short in the range [0x0, 0xFFFF].

Returns
16-bit unsigned short representing the current input voltage, normalized to a 16-bit value

Definition at line 85 of file AnalogIn.h.

Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.