Digital to Analog Converter#

sl_dac_operation_mode_t#

sl_dac_operation_mode_t

Enumeration for DAC operation mode.

sl_dac_callback_event_t#

sl_dac_callback_event_t

Enumeration for DAC callback events.

sl_channel_id_for_adc_t#

sl_channel_id_for_adc_t

Enumeration for ADC channel this enum only used on Reference voltage for ADC mode of DAC.

note: These enums are not used as SL_DAC_OUTPUT_REF_VOLTAGE_FOR_ADC mode is not supported currently.

sl_dac_callback_t#

typedef void(* sl_dac_callback_t) (uint8_t event) )(uint8_t event)

Typedef for user supplied callback function which is called when a DAC samples completes.

release#

uint8_t sl_dac_version_t::release

Release version number.

major#

uint8_t sl_dac_version_t::major

sqa version number

minor#

uint8_t sl_dac_version_t::minor

dev version number

division_factor#

uint16_t sl_dac_clock_config_t::division_factor

Division Factor.

soc_pll_clock#

uint32_t sl_dac_clock_config_t::soc_pll_clock

SoC PLL clock frequency.

soc_pll_reference_clock#

uint32_t sl_dac_clock_config_t::soc_pll_reference_clock

SoC PLL reference clock frequency.

operating_mode#

uint8_t sl_dac_config_t::operating_mode

dac_fifo_threshold#

uint8_t sl_dac_config_t::dac_fifo_threshold

adc_channel#

uint8_t sl_dac_config_t::adc_channel

dac_sample_rate#

uint32_t sl_dac_config_t::dac_sample_rate

dac_pin#

uint8_t sl_dac_config_t::dac_pin

dac_port#

uint8_t sl_dac_config_t::dac_port

sl_si91x_dac_init#

sl_status_t sl_si91x_dac_init (sl_dac_clock_config_t * dac_clock)

Initializes the DAC(Digital to Analog Converter).

This API will enable on the DAC peripheral as well as set the clock for the DAC controller.

• The DAC clock configurations are mentioned as follows:

  • soc_pll_clock (Frequency range: 1 MHz to 180 MHz),

  • soc_pll_reference_clock (Frequency range: 15 MHz to 65 MHz) and 

  • division_factor (0–63).

Returns

• Status 0 if successful, else below are the error codes:

  • SL_STATUS_OK (0x0000) - Success

  • SL_STATUS_NULL_POINTER (0x0022) - The parameter is a null pointer

  • SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid

  • SL_STATUS_FAIL (0x0001) - The function failed

  • SL_STATUS_NOT_INITIALIZED (0x0011) - Clock is not initialized

Note

• Default value is recommended for DAC clock configurations.

sl_si91x_dac_set_configuration#

sl_status_t sl_si91x_dac_set_configuration (sl_dac_config_t dac_config, float vref_value)

Configure DAC control parameters.

The configurations are listed below:

• Operation mode (Static/FIFO/Reference voltage for ADC)

• Sample rate (63 sps to 5 Msps)

• DAC FIFO Threshold value(0 to 7)

• ADC Channel(0 to 15)

  • Pre-condition:

    • sl_si91x_dac_init

  Returns

  • Status 0 if successful, else error code:

    • SL_STATUS_OK (0x0000) - Success

    • SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid

    • SL_STATUS_INVALID_RANGE (0x0028) - Mismatch Range

  Note

  • In DAC If "Reference voltage for ADC" is the operation mode, choose ADC Channel.

sl_si91x_dac_write_data#

sl_status_t sl_si91x_dac_write_data (int16_t * data, uint16_t length)

Writes digital input samples to DAC and also writes the digital sample to both dynamic and static mode of DAC.

If Static mode is enabled data written to the DR will not be written to the FIFO It will be played on DAC directly. Only single sample can be held at a time. If FIFO mode enabled. Data written to the DR is written to the FIFO in this mode. Note

• For static mode sample length is '1'.

• Pre-condition:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

Returns

• Status 0 if successful, else error code:

  • SL_STATUS_OK (0x0000) - Success

  • SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid

  • SL_STATUS_INVALID_RANGE (0x0028) - Mismatch Range

sl_si91x_dac_read_data#

sl_status_t sl_si91x_dac_read_data (uint16_t * dac_output_data)

Read DAC analog output data.

Reads the analog output data of the DAC from data register for dynamic and static mode, returning the last data played on DAC.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

  • sl_si91x_dac_write_data

  • sl_si91x_dac_start

Returns

• Status 0 for successful execution (SL_STATUS_OK)

sl_si91x_dac_get_achieved_sample_clock#

sl_status_t sl_si91x_dac_get_achieved_sample_clock (uint32_t sample_rate, uint32_t * sample_clock)

Get the DAC sample clock.

This API will read the configured clock and return the achieved sample clock.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

Returns

• Status 0 if successful, else error code:

  • SL_STATUS_OK (0x0000) - Success

  • SL_STATUS_INVALID_RANGE (0x0028) - Mismatch Range

sl_si91x_dac_rewrite_data#

sl_status_t sl_si91x_dac_rewrite_data (int16_t * data, uint16_t length)

Rewrite the DAC sample data.

Rewrites the input sample data in DAC FIFO operating mode, it will rewrite the sample data in DAC continuously.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

  • sl_si91x_dac_write_data

  • sl_si91x_dac_start

Returns

• Status 0 if successful, else error code:

  • SL_STATUS_OK (0x0000) - Success

  • SL_STATUS_NULL_POINTER (0x0022) - The parameter is a null pointer

  • SL_STATUS_INVALID_RANGE (0x0028) - Mismatch

Note

• The rewrite is only applicable for FIFO mode.

sl_si91x_dac_register_event_callback#

sl_status_t sl_si91x_dac_register_event_callback (sl_dac_callback_t callback_event)

Register the user callback function.

At the time of events, the function passed in the parameter is called with the respective event as the parameter.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

Returns

• Status 0 if successful, else error code:

  • SL_STATUS_OK (0x0000) - Success

  • SL_STATUS_NULL_POINTER (0x0022) - The parameter is a null pointer

  • SL_STATUS_BUSY (0x0004) - Driver is busy

Note

• Before calling this function again, it is mandatory to call the sl_si91x_dac_unregister_event_callback function to unregister the callback, otherwise it returns SL_STATUS_BUSY error code.

sl_si91x_dac_unregister_event_callback#

sl_status_t sl_si91x_dac_unregister_event_callback (void )

Unregister the user callback function.

Note

• It is mandatory to call this function before registering the callback again.

• Pre-condition:

  • sl_si91x_dac_register_event_callback

Returns

• Status 0 for successful execution (SL_STATUS_OK)

sl_si91x_dac_start#

sl_status_t sl_si91x_dac_start (void )

Start the DAC operation.

It will enable signal to DAC, enable path to DAC controller, enable the DAC FIFO config and enable dynamic.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

  • sl_si91x_dac_register_event_callback

  • sl_si91x_dac_write_data

Returns

• Status 0 for successful execution (SL_STATUS_OK)

sl_si91x_dac_stop#

sl_status_t sl_si91x_dac_stop (void )

Stop the DAC operation.

It will stop signal to DAC, disconnect path to DAC controller and disable the DAC FIFO config.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

  • sl_si91x_dac_register_event_callback

  • sl_si91x_dac_write_data

  • sl_si91x_dac_start

Returns

• Status 0 for successful execution (SL_STATUS_OK)

sl_si91x_dac_deinit#

sl_status_t sl_si91x_dac_deinit (void )

De-initialize the DAC.

It will shutdown/power_off the power of DAC.

• Pre-condition:

  • sl_si91x_dac_init

Returns

• Status 0 for successful execution (SL_STATUS_OK)

sl_si91x_dac_get_version#

sl_dac_version_t sl_si91x_dac_get_version (void )

Get the DAC version.

Returns the release, SQA, and dev versions of the DAC.

Returns

• (sl_dac_version_t) type structure