Defined behaviour

Modules
	Analogin hal tests
	The Analogin HAL tests ensure driver conformance to defined behaviour.

Functions
void	analogout_init (dac_t *obj, PinName pin)
	Initialize the analogout peripheral. More...

void	analogout_free (dac_t *obj)
	Release the analogout object. More...

void	analogout_write (dac_t *obj, float value)
	Set the output voltage, specified as a percentage (float) More...

void	analogout_write_u16 (dac_t *obj, uint16_t value)
	Set the output voltage, specified as unsigned 16-bit. More...

float	analogout_read (dac_t *obj)
	Read the current voltage value on the pin. More...

uint16_t	analogout_read_u16 (dac_t *obj)
	Read the current voltage value on the pin, as a normalized unsigned 16bit value. More...

const PinMap *	analogout_pinmap (void)
	Get the pins that support analogout. More...

Detailed Description

The function analogout_init initializes the dac_t control structure
The function analogout_write sets the output voltage, specified as a percentage (float) in range [0.0 (GND), 1.0 (VCC)]
The function analogout_write_u16 sets the output voltage, specified as unsigned 16-bit value [0 (GND), MAX_UINT16 (VCC)]
The function analogout_read reads the current voltage value on the pin and returns a floating-point value representing the current voltage in range [0.0 (GND), 1.0 (VCC)]
The function analogout_read_u16 reads the current voltage value on the pin and returns the output voltage, specified as unsigned 16-bit value [0 (GND), MAX_UINT16 (VCC)]
The accuracy of the DAC is +/- 10%
The DAC operations analogout_write, analogout_write_u16, analogout_read, analogout_read_u16 take less than 20us to complete
The function analogout_free releases the analogout object

analogout_init is called with invalid pin (which does not support analog output function)
Calling other functions before analogout_init

void analogout_free ( dac_t * obj )

Release the analogout object.

Parameters

obj	The analogout object

Initialize the analogout peripheral.

Configures the pin used by analogout.

Parameters

obj	The analogout object to initialize
pin	The analogout pin name

const PinMap* analogout_pinmap ( void )

Get the pins that support analogout.

Return a PinMap array of pins that support analogout. The array is terminated with {NC, NC, 0}.

float analogout_read ( dac_t * obj )

Read the current voltage value on the pin.

Parameters

obj	The analogin object

Returns: A floating-point value representing the current voltage on the pin, measured as a percentage

uint16_t analogout_read_u16 ( dac_t * obj )

Read the current voltage value on the pin, as a normalized unsigned 16bit value.

Parameters

obj	The analogin object

Returns: An unsigned 16-bit value representing the current voltage on the pin

Set the output voltage, specified as a percentage (float)

Parameters

obj	The analogin object
value	The floating-point output voltage to be set

Set the output voltage, specified as unsigned 16-bit.

Parameters

obj	The analogin object
value	The unsigned 16-bit output voltage to be set