ra8_dac_b.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "ra8_err.h"

typedef enum : uint8_t {
  k_ra8_dac_b_vref_normal = 0U, 
  k_ra8_dac_b_vref_low    = 1U, 
} ra8_dac_b_vref_t;

typedef enum : uint8_t {
  k_ra8_dac_b_format_right = 0U, 
  k_ra8_dac_b_format_left  = 1U, 
} ra8_dac_b_data_format_t;

typedef struct {
  ra8_dac_b_vref_t        vref;                    
  ra8_dac_b_data_format_t data_format;             
  bool                    internal_output_enabled; 
  bool                    enable_channel0;         
  bool                    enable_channel1;         
} ra8_dac_b_cfg_t;

typedef void (*ra8_dac_b_update_fn_t)(void* ctx, uint8_t channel);
 
/* =============================================================================
 * Lifecycle
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_dac_b_init(void);

[[nodiscard]] ra8_err_t ra8_dac_b_init_configured(const ra8_dac_b_cfg_t* cfg);

[[nodiscard]] ra8_err_t ra8_dac_b_deinit(void);
 
/* =============================================================================
 * Legacy polling API
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_dac_b_write(uint8_t channel, uint16_t value);
 
/* =============================================================================
 * Runtime reconfigure
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_dac_b_set_vref(ra8_dac_b_vref_t vref);

[[nodiscard]] ra8_err_t ra8_dac_b_set_output_enable(uint8_t channel, bool enable);
 
/* =============================================================================
 * Status
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_dac_b_get_status(uint8_t* out_mask);

[[nodiscard]] ra8_err_t ra8_dac_b_clear_status(void);
 
/* =============================================================================
 * Interrupt path
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_dac_b_attach_handler(ra8_dac_b_update_fn_t fn, void* ctx);
 
/* =============================================================================
 * Power transition
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_dac_b_enter_stop(void);

[[nodiscard]] ra8_err_t ra8_dac_b_exit_stop(void);
 
/* =============================================================================
 * ISR dispatch
 * =============================================================================
 */

void ra8_dac_b_dispatch_update(uint8_t channel);
 
#ifdef __cplusplus
}
#endif