Digital to Analog Converter#

sl_dac_operation_mode_t#

sl_dac_operation_mode_t

Enumeration for DAC operation modes.

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

This enum is only used in the 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 a user-defined callback function, triggered upon the completion of a DAC sample.

sl_si91x_dac_init#

sl_status_t sl_si91x_dac_init (sl_dac_clock_config_t * dac_clock)

To initialize the DAC (Digital to Analog Converter).

This API enables the DAC peripheral and sets the clock for the DAC controller.

Returns

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully initialized the DAC.

  • SL_STATUS_FAIL (0x0001) - The function failed.

  • SL_STATUS_NOT_INITIALIZED (0x0011) - Clock is not initialized.

  • SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid.

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

For more information on status codes, see SL STATUS DOCUMENTATION.

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)

To configure DAC control parameters.

This API configures the DAC control parameters, including:

• 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

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully configured the DAC.

  • SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid.

  • SL_STATUS_INVALID_RANGE (0x0028) - Mismatch range.

For more information on status codes, see SL STATUS DOCUMENTATION.

Note

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

sl_si91x_dac_write_data#

sl_status_t sl_si91x_dac_write_data (int16_t * data, uint16_t length)

To write digital input samples to the DAC.

This API writes the digital sample to both dynamic and static modes of the DAC.

• When Static mode is enabled, any data written to the Data Register (DR) will bypass the FIFO and be sent directly to the DAC for playback. Only a single sample can be held at a time.

• If FIFO mode is enabled, data is written to the FIFO.

Note

• For static mode, the sample length is 1.

• For FIFO mode, the sample length is 1 - 1024.

• Pre-condition:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

Returns

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully wrote the data to the DAC.

  • SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid.

  • SL_STATUS_INVALID_RANGE (0x0028) - Mismatch range.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_dac_read_data#

sl_status_t sl_si91x_dac_read_data (uint16_t * dac_output_data)

To read the DAC sampled output data.

This API reads the sampled output data of the DAC from the data register for dynamic and static modes, returning the last data played on the DAC.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

  • sl_si91x_dac_write_data

  • sl_si91x_dac_start

Returns

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully read the data from the DAC.

  • SL_STATUS_FAIL (0x0001) - Function failed.

For more information on status codes, see SL STATUS DOCUMENTATION.

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)

To get the DAC sample clock.

This API reads the AUX clock and returns the achieved sample clock.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

Returns

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully got the achieved sample clock.

  • SL_STATUS_INVALID_RANGE (0x0028) - Mismatch range.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_dac_rewrite_data#

sl_status_t sl_si91x_dac_rewrite_data (int16_t * data, uint16_t length)

To rewrite the DAC sample data.

This API rewrites the input sample data in DAC FIFO operating mode, continuously rewriting the sample data in the DAC.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

  • sl_si91x_dac_write_data

  • sl_si91x_dac_start

Returns

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully rewrote the sample data.

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

  • SL_STATUS_INVALID_RANGE (0x0028) - Mismatch range.

For more information on status codes, see SL STATUS DOCUMENTATION.

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)

To register the user callback function.

This API registers a user-provided callback function that is invoked when an event occurs.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

Returns

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully registered the callback.

  • SL_STATUS_BUSY (0x0004) - Driver is busy.

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

For more information on status codes, see SL STATUS DOCUMENTATION.

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 the SL_STATUS_BUSY error code.

sl_si91x_dac_unregister_event_callback#

sl_status_t sl_si91x_dac_unregister_event_callback (void )

To unregister the user callback function.

This API unregisters the previously registered 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

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully deregistered the callback.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_dac_start#

sl_status_t sl_si91x_dac_start (void )

To start the DAC operation.

This API starts writing the samples in static/FIFO modes.

• Pre-conditions:

  • sl_si91x_dac_init

  • sl_si91x_dac_set_configuration

  • sl_si91x_dac_register_event_callback

  • sl_si91x_dac_write_data

Returns

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully started the DAC operation.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_dac_stop#

sl_status_t sl_si91x_dac_stop (void )

To stop the DAC operation.

This API stops writing the samples in static/FIFO modes.

• 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

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully stopped the DAC operation.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_dac_deinit#

sl_status_t sl_si91x_dac_deinit (void )

To deinitialize the DAC module.

This API deinitializes the DAC module, releases the hardware resources, and resets the DAC parameters.

• Pre-conditions:

  • sl_si91x_dac_init

Returns

• sl_status_t Status code indicating the result:

  • SL_STATUS_OK (0x0000) - Successfully deinitialized the DAC module.

  • SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid.

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

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_dac_get_version#

sl_dac_version_t sl_si91x_dac_get_version (void )

To get the DAC version.

This API returns the release, major, and minor versions of the DAC.

Returns

• sl_dac_version_t Structure containing the DAC version information, see sl_dac_version_t.