16#ifndef ZEPHYR_INCLUDE_DRIVERS_REGULATOR_H_
17#define ZEPHYR_INCLUDE_DRIVERS_REGULATOR_H_
39#ifdef CONFIG_REGULATOR_THREAD_SAFE_REFCNT
64#define REGULATOR_ERROR_OVER_VOLTAGE BIT(0)
66#define REGULATOR_ERROR_OVER_CURRENT BIT(1)
68#define REGULATOR_ERROR_OVER_TEMP BIT(2)
70#define REGULATOR_ERROR_UNDER_VOLTAGE BIT(3)
99 const void *
const user_data);
152 unsigned int idx,
int32_t *volt_uv);
179 unsigned int idx,
int32_t *current_ua);
214 bool active_discharge);
221 bool *active_discharge);
285#define REGULATOR_ALWAYS_ON BIT(0)
287#define REGULATOR_BOOT_ON BIT(1)
289#define REGULATOR_INIT_ENABLED (REGULATOR_ALWAYS_ON | REGULATOR_BOOT_ON)
291#define REGULATOR_ACTIVE_DISCHARGE_MASK GENMASK(3, 2)
293#define REGULATOR_ACTIVE_DISCHARGE_POS 2
295#define REGULATOR_ACTIVE_DISCHARGE_DISABLE 0
297#define REGULATOR_ACTIVE_DISCHARGE_ENABLE 1
299#define REGULATOR_ACTIVE_DISCHARGE_DEFAULT 2
301#define REGULATOR_ACTIVE_DISCHARGE_SET_BITS(x) \
302 (((x) << REGULATOR_ACTIVE_DISCHARGE_POS) & REGULATOR_ACTIVE_DISCHARGE_MASK)
304#define REGULATOR_ACTIVE_DISCHARGE_GET_BITS(x) \
305 (((x) & REGULATOR_ACTIVE_DISCHARGE_MASK) >> REGULATOR_ACTIVE_DISCHARGE_POS)
307#define REGULATOR_BOOT_OFF BIT(4)
312#define REGULATOR_INITIAL_MODE_UNKNOWN UINT8_MAX
319struct regulator_common_config {
351#define REGULATOR_DT_COMMON_CONFIG_INIT(node_id) \
353 .min_uv = DT_PROP_OR(node_id, regulator_min_microvolt, \
355 .max_uv = DT_PROP_OR(node_id, regulator_max_microvolt, \
357 .init_uv = DT_PROP_OR(node_id, regulator_init_microvolt, \
359 .min_ua = DT_PROP_OR(node_id, regulator_min_microamp, \
361 .max_ua = DT_PROP_OR(node_id, regulator_max_microamp, \
363 .init_ua = DT_PROP_OR(node_id, regulator_init_microamp, \
365 .startup_delay_us = DT_PROP_OR(node_id, startup_delay_us, 0), \
366 .off_on_delay_us = DT_PROP_OR(node_id, off_on_delay_us, 0), \
367 .allowed_modes = (const regulator_mode_t []) \
368 DT_PROP_OR(node_id, regulator_allowed_modes, {}), \
369 .allowed_modes_cnt = \
370 DT_PROP_LEN_OR(node_id, regulator_allowed_modes, 0), \
371 .initial_mode = DT_PROP_OR(node_id, regulator_initial_mode, \
372 REGULATOR_INITIAL_MODE_UNKNOWN), \
373 .flags = ((DT_PROP_OR(node_id, regulator_always_on, 0U) * \
374 REGULATOR_ALWAYS_ON) | \
375 (DT_PROP_OR(node_id, regulator_boot_on, 0U) * \
376 REGULATOR_BOOT_ON) | \
377 (REGULATOR_ACTIVE_DISCHARGE_SET_BITS( \
378 DT_PROP_OR(node_id, regulator_active_discharge, \
379 REGULATOR_ACTIVE_DISCHARGE_DEFAULT))) | \
380 (DT_PROP_OR(node_id, regulator_boot_off, 0U) * \
381 REGULATOR_BOOT_OFF)), \
389#define REGULATOR_DT_INST_COMMON_CONFIG_INIT(inst) \
390 REGULATOR_DT_COMMON_CONFIG_INIT(DT_DRV_INST(inst))
397struct regulator_common_data {
398#if defined(CONFIG_REGULATOR_THREAD_SAFE_REFCNT) || defined(__DOXYGEN__)
413void regulator_common_data_init(
const struct device *dev);
436int regulator_common_init(
const struct device *dev,
bool is_enabled);
445static inline bool regulator_common_is_init_enabled(
const struct device *dev)
447 const struct regulator_common_config *config =
448 (
const struct regulator_common_config *)dev->
config;
450 return (config->flags & REGULATOR_INIT_ENABLED) != 0U;
462static inline int regulator_common_get_min_voltage(
const struct device *dev,
int32_t *min_uv)
464 const struct regulator_common_config *config =
465 (
const struct regulator_common_config *)dev->
config;
471 *min_uv = config->min_uv;
484static inline int regulator_common_get_max_voltage(
const struct device *dev,
int32_t *max_uv)
486 const struct regulator_common_config *config =
487 (
const struct regulator_common_config *)dev->
config;
493 *max_uv = config->max_uv;
641 unsigned int idx,
int32_t *volt_uv)
744 unsigned int idx,
int32_t *current_ua)
843 bool active_discharge)
864 bool *active_discharge)
912 const void *
const user_data)
APIs and macros for the Zephyr device model.
#define DEVICE_API_GET(_class, _dev)
Expands to the pointer of a device's API for a given class.
Definition device.h:1505
int(* regulator_get_active_discharge_t)(const struct device *dev, bool *active_discharge)
Get active discharge setting.
Definition regulator.h:220
int(* regulator_set_voltage_t)(const struct device *dev, int32_t min_uv, int32_t max_uv)
Set the output voltage.
Definition regulator.h:158
int(* regulator_list_current_limit_t)(const struct device *dev, unsigned int idx, int32_t *current_ua)
Obtain the value of a current limit given an index.
Definition regulator.h:178
int(* regulator_set_active_discharge_t)(const struct device *dev, bool active_discharge)
Set active discharge setting.
Definition regulator.h:213
int(* regulator_get_current_limit_t)(const struct device *dev, int32_t *curr_ua)
Get output current limit.
Definition regulator.h:192
int(* regulator_get_mode_t)(const struct device *dev, regulator_mode_t *mode)
Get mode.
Definition regulator.h:206
unsigned int(* regulator_count_current_limits_t)(const struct device *dev)
Obtain the number of supported current limit levels.
Definition regulator.h:172
int(* regulator_get_error_flags_t)(const struct device *dev, regulator_error_flags_t *flags)
Get active error flags.
Definition regulator.h:227
int(* regulator_set_mode_t)(const struct device *dev, regulator_mode_t mode)
Set mode.
Definition regulator.h:199
int(* regulator_get_voltage_t)(const struct device *dev, int32_t *volt_uv)
Obtain output voltage.
Definition regulator.h:165
int(* regulator_set_current_limit_t)(const struct device *dev, int32_t min_ua, int32_t max_ua)
Set output current limit.
Definition regulator.h:185
int(* regulator_ship_mode_t)(const struct device *dev)
Enter ship mode.
Definition regulator.h:117
int(* regulator_dvs_state_set_t)(const struct device *dev, regulator_dvs_state_t state)
Set a DVS state.
Definition regulator.h:110
int(* regulator_disable_t)(const struct device *dev)
Disable a regulator.
Definition regulator.h:139
int(* regulator_enable_t)(const struct device *dev)
Enable a regulator.
Definition regulator.h:133
unsigned int(* regulator_count_voltages_t)(const struct device *dev)
Obtain the number of supported voltage levels.
Definition regulator.h:145
int(* regulator_set_callback_t)(const struct device *dev, regulator_callback_t cb, const void *const user_data)
Set event handler function.
Definition regulator.h:234
int(* regulator_list_voltage_t)(const struct device *dev, unsigned int idx, int32_t *volt_uv)
Obtain the value of a voltage given an index.
Definition regulator.h:151
void(* regulator_callback_t)(const struct device *dev, const struct regulator_event *const evt, const void *const user_data)
Regulator callback function signature.
Definition regulator.h:97
int regulator_enable(const struct device *dev)
Enable a regulator.
int regulator_set_mode(const struct device *dev, regulator_mode_t mode)
Set mode.
uint8_t regulator_mode_t
Opaque type to store regulator modes.
Definition regulator.h:52
static unsigned int regulator_count_current_limits(const struct device *dev)
Obtain the number of supported current limit levels.
Definition regulator.h:717
bool regulator_is_enabled(const struct device *dev)
Check if a regulator is enabled.
int regulator_set_voltage(const struct device *dev, int32_t min_uv, int32_t max_uv)
Set the output voltage.
int regulator_set_current_limit(const struct device *dev, int32_t min_ua, int32_t max_ua)
Set output current limit.
bool regulator_is_supported_voltage(const struct device *dev, int32_t min_uv, int32_t max_uv)
Check if a voltage within a window is supported.
uint8_t regulator_error_flags_t
Opaque bit map for regulator error flags (see REGULATOR_ERRORS).
Definition regulator.h:55
static int regulator_get_active_discharge(const struct device *dev, bool *active_discharge)
Get active discharge setting.
Definition regulator.h:863
static int regulator_list_voltage(const struct device *dev, unsigned int idx, int32_t *volt_uv)
Obtain the value of a voltage given an index.
Definition regulator.h:640
static int regulator_get_current_limit(const struct device *dev, int32_t *curr_ua)
Get output current limit.
Definition regulator.h:783
static int regulator_set_active_discharge(const struct device *dev, bool active_discharge)
Set active discharge setting.
Definition regulator.h:842
static int regulator_get_error_flags(const struct device *dev, regulator_error_flags_t *flags)
Get active error flags.
Definition regulator.h:884
static unsigned int regulator_count_voltages(const struct device *dev)
Obtain the number of supported voltage levels.
Definition regulator.h:614
uint8_t regulator_dvs_state_t
Opaque type to store regulator DVS states.
Definition regulator.h:49
static int regulator_get_mode(const struct device *dev, regulator_mode_t *mode)
Get mode.
Definition regulator.h:821
static int regulator_get_voltage(const struct device *dev, int32_t *volt_uv)
Obtain output voltage.
Definition regulator.h:694
int regulator_disable(const struct device *dev)
Disable a regulator.
regulator_event_type
Regulator event types.
Definition regulator.h:77
static int regulator_set_callback(const struct device *dev, regulator_callback_t cb, const void *const user_data)
Set event handler function.
Definition regulator.h:910
static int regulator_list_current_limit(const struct device *dev, unsigned int idx, int32_t *current_ua)
Obtain the value of a current limit given an index.
Definition regulator.h:743
@ REGULATOR_VOLTAGE_DETECTED
Regulator voltage is detected.
Definition regulator.h:79
@ REGULATOR_VOLTAGE_REMOVED
Regulator voltage is removed.
Definition regulator.h:81
static int regulator_parent_dvs_state_set(const struct device *dev, regulator_dvs_state_t state)
Set a DVS state.
Definition regulator.h:523
static int regulator_parent_ship_mode(const struct device *dev)
Enter ship mode.
Definition regulator.h:548
#define ENOENT
No such file or directory.
Definition errno.h:41
#define EINVAL
Invalid argument.
Definition errno.h:61
#define ENOSYS
Function not implemented.
Definition errno.h:83
flags
Definition parser.h:86
state
Definition parser_state.h:29
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
__INT32_TYPE__ int32_t
Definition stdint.h:74
#define INT32_MAX
Definition stdint.h:18
__UINT8_TYPE__ uint8_t
Definition stdint.h:88
#define INT32_MIN
Definition stdint.h:24
Runtime device structure (in ROM) per driver instance.
Definition device.h:543
const void * config
Address of device instance config information.
Definition device.h:547
<span class="mlabel">Driver Operations</span> Regulator driver operations
Definition regulator.h:240
regulator_set_current_limit_t set_current_limit
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:258
regulator_list_current_limit_t list_current_limit
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:256
regulator_enable_t enable
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:242
regulator_set_voltage_t set_voltage
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:250
regulator_count_voltages_t count_voltages
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:246
regulator_get_error_flags_t get_error_flags
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:270
regulator_list_voltage_t list_voltage
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:248
regulator_set_active_discharge_t set_active_discharge
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:266
regulator_get_mode_t get_mode
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:264
regulator_set_callback_t set_callback
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:272
regulator_set_mode_t set_mode
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:262
regulator_get_active_discharge_t get_active_discharge
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:268
regulator_get_voltage_t get_voltage
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:252
regulator_disable_t disable
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:244
regulator_get_current_limit_t get_current_limit
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:260
regulator_count_current_limits_t count_current_limits
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:254
Regulator event structure.
Definition regulator.h:85
enum regulator_event_type type
Event type.
Definition regulator.h:87
<span class="mlabel">Driver Operations</span> Regulator Parent driver operations
Definition regulator.h:122
regulator_dvs_state_set_t dvs_state_set
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:124
regulator_ship_mode_t ship_mode
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition regulator.h:126