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.

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.

sl_si91x_dac_init#

sl_status_t sl_si91x_dac_init (sl_dac_clock_config_t * dac_clock)

Initialize the DAC.

This API will power_ON to DAC peripheral and set the clock for DAC controller.

• The DAC clock configurations are listed below:

  • soc_pll_clock (Frequency range from 1 MHZ to 180 MHz)

  • soc_pll_reference_clock (Frequency range from 15MHZ to 65 MHz)

  • division_factor (0 to 63). Default value is recommended for DAC clock configurations.

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_PARAMETER (0x0021) - Parameters are invalid

  • SL_STATUS_FAIL (0x0001) - The function failed

  • SL_STATUS_NOT_INITIALIZED (0x0011) - Clock is not initialized

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 (16sps to 5 Msps)

  • DAC FIFO Threshold value(0 to 7).

• Pre-conditions:

  • 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

sl_si91x_dac_write_data#

sl_status_t sl_si91x_dac_write_data (int16_t * data, uint16_t length)

Write digital input samples to DAC.

This API will write digital sample to both dynamic and static mode of DAC. For static mode sample length is '1'.

• 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_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 in 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 return the DAC 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. The rewrite is only applicable for FIFO 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 Range

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. 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.

• 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

sl_si91x_dac_unregister_event_callback#

sl_status_t sl_si91x_dac_unregister_event_callback (void )

Unregister the user callback function.

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