SOC_PROXY Device Interface Functions More...
#include <stdbool.h>
#include <stdint.h>
#include "sw/device/lib/base/macros.h"
#include "sw/device/lib/base/mmio.h"
#include "sw/device/lib/dif/dif_base.h"
#include "dt/dt_soc_proxy.h"
Go to the source code of this file.
Data Structures | |
struct | dif_soc_proxy |
A handle to soc_proxy. More... | |
Typedefs | |
typedef struct dif_soc_proxy | dif_soc_proxy_t |
A handle to soc_proxy. | |
typedef enum dif_soc_proxy_alert | dif_soc_proxy_alert_t |
A soc_proxy alert type. | |
typedef dt_soc_proxy_irq_t | dif_soc_proxy_irq_t |
typedef uint32_t | dif_soc_proxy_irq_state_snapshot_t |
A snapshot of the state of the interrupts for this IP. | |
typedef uint32_t | dif_soc_proxy_irq_enable_snapshot_t |
A snapshot of the enablement state of the interrupts for this IP. | |
Functions | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_init (mmio_region_t base_addr, dif_soc_proxy_t *soc_proxy) |
Creates a new handle for a(n) soc_proxy peripheral. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_init_from_dt (dt_soc_proxy_t dt, dif_soc_proxy_t *soc_proxy) |
Creates a new handle for a(n) soc_proxy peripheral. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_get_dt (const dif_soc_proxy_t *soc_proxy, dt_soc_proxy_t *dt) |
Get the DT handle from this DIF. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_alert_force (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_alert_t alert) |
Forces a particular alert, causing it to be escalated as if the hardware had raised it. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_get_type (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_irq_t, dif_irq_type_t *type) |
Returns the type of a given interrupt (i.e., event or status) for this IP. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_get_state (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_irq_state_snapshot_t *snapshot) |
Returns the state of all interrupts (i.e., pending or not) for this IP. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_is_pending (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_irq_t, bool *is_pending) |
Returns whether a particular interrupt is currently pending. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_acknowledge_state (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_irq_state_snapshot_t snapshot) |
Acknowledges all interrupts that were pending at the time of the state snapshot. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_acknowledge_all (const dif_soc_proxy_t *soc_proxy) |
Acknowledges all interrupts, indicating to the hardware that all interrupts have been successfully serviced. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_acknowledge (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_irq_t) |
Acknowledges a particular interrupt, indicating to the hardware that it has been successfully serviced. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_force (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_irq_t, const bool val) |
Forces a particular interrupt, causing it to be serviced as if hardware had asserted it. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_get_enabled (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_irq_t, dif_toggle_t *state) |
Checks whether a particular interrupt is currently enabled or disabled. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_set_enabled (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_irq_t, dif_toggle_t state) |
Sets whether a particular interrupt is currently enabled or disabled. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_disable_all (const dif_soc_proxy_t *soc_proxy, dif_soc_proxy_irq_enable_snapshot_t *snapshot) |
Disables all interrupts, optionally snapshotting all enable states for later restoration. | |
OT_WARN_UNUSED_RESULT dif_result_t | dif_soc_proxy_irq_restore_all (const dif_soc_proxy_t *soc_proxy, const dif_soc_proxy_irq_enable_snapshot_t *snapshot) |
Restores interrupts from the given (enable) snapshot. | |
SOC_PROXY Device Interface Functions
Definition in file dif_soc_proxy_autogen.h.
struct dif_soc_proxy |
A handle to soc_proxy.
This type should be treated as opaque by users.
Definition at line 38 of file dif_soc_proxy_autogen.h.
Data Fields | ||
---|---|---|
mmio_region_t | base_addr | The base address for the soc_proxy hardware registers. |
dt_soc_proxy_t | dt |
The instance, set to kDtSocProxyCount if not initialized through dif_soc_proxy_init_from_dt . |
#define kDifSocProxyIrqExternal0 kDtSocProxyIrqExternal0 |
A soc_proxy interrupt request type.
DEPRECATED Use dt_soc_proxy_irq_t
instead. This enumeration exists solely for the transition to dt-based interrupt numbers and will be removed in the future.
The following are defines to keep the types consistent with DT. External interrupt request
Definition at line 247 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal1 kDtSocProxyIrqExternal1 |
Definition at line 248 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal10 kDtSocProxyIrqExternal10 |
Definition at line 257 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal11 kDtSocProxyIrqExternal11 |
Definition at line 258 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal12 kDtSocProxyIrqExternal12 |
Definition at line 259 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal13 kDtSocProxyIrqExternal13 |
Definition at line 260 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal14 kDtSocProxyIrqExternal14 |
Definition at line 261 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal15 kDtSocProxyIrqExternal15 |
Definition at line 262 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal16 kDtSocProxyIrqExternal16 |
Definition at line 263 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal17 kDtSocProxyIrqExternal17 |
Definition at line 264 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal18 kDtSocProxyIrqExternal18 |
Definition at line 265 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal19 kDtSocProxyIrqExternal19 |
Definition at line 266 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal2 kDtSocProxyIrqExternal2 |
Definition at line 249 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal20 kDtSocProxyIrqExternal20 |
Definition at line 267 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal21 kDtSocProxyIrqExternal21 |
Definition at line 268 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal22 kDtSocProxyIrqExternal22 |
Definition at line 269 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal23 kDtSocProxyIrqExternal23 |
Definition at line 270 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal24 kDtSocProxyIrqExternal24 |
Definition at line 271 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal25 kDtSocProxyIrqExternal25 |
Definition at line 272 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal26 kDtSocProxyIrqExternal26 |
Definition at line 273 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal27 kDtSocProxyIrqExternal27 |
Definition at line 274 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal28 kDtSocProxyIrqExternal28 |
Definition at line 275 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal29 kDtSocProxyIrqExternal29 |
Definition at line 276 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal3 kDtSocProxyIrqExternal3 |
Definition at line 250 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal30 kDtSocProxyIrqExternal30 |
Definition at line 277 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal31 kDtSocProxyIrqExternal31 |
Definition at line 278 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal4 kDtSocProxyIrqExternal4 |
Definition at line 251 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal5 kDtSocProxyIrqExternal5 |
Definition at line 252 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal6 kDtSocProxyIrqExternal6 |
Definition at line 253 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal7 kDtSocProxyIrqExternal7 |
Definition at line 254 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal8 kDtSocProxyIrqExternal8 |
Definition at line 255 of file dif_soc_proxy_autogen.h.
#define kDifSocProxyIrqExternal9 kDtSocProxyIrqExternal9 |
Definition at line 256 of file dif_soc_proxy_autogen.h.
typedef uint32_t dif_soc_proxy_irq_enable_snapshot_t |
A snapshot of the enablement state of the interrupts for this IP.
This is an opaque type, to be used with the dif_soc_proxy_irq_disable_all()
and dif_soc_proxy_irq_restore_all()
functions.
Definition at line 388 of file dif_soc_proxy_autogen.h.
typedef uint32_t dif_soc_proxy_irq_state_snapshot_t |
A snapshot of the state of the interrupts for this IP.
This is an opaque type, to be used with the dif_soc_proxy_irq_get_state()
and dif_soc_proxy_irq_acknowledge_state()
functions.
Definition at line 286 of file dif_soc_proxy_autogen.h.
typedef dt_soc_proxy_irq_t dif_soc_proxy_irq_t |
Definition at line 233 of file dif_soc_proxy_autogen.h.
typedef struct dif_soc_proxy dif_soc_proxy_t |
A handle to soc_proxy.
This type should be treated as opaque by users.
enum dif_soc_proxy_alert |
A soc_proxy alert type.
Definition at line 99 of file dif_soc_proxy_autogen.h.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_alert_force | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_alert_t | alert ) |
Forces a particular alert, causing it to be escalated as if the hardware had raised it.
soc_proxy | A soc_proxy handle. |
alert | The alert to force. |
Definition at line 63 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_get_dt | ( | const dif_soc_proxy_t * | soc_proxy, |
dt_soc_proxy_t * | dt ) |
Get the DT handle from this DIF.
If this DIF was initialized by dif_soc_proxy_init_from_dt(dt, ..)
then this function will return dt
. Otherwise it will return an error.
soc_proxy | A soc_proxy handle. | |
[out] | dt | DT handle. |
kDifBadArg
if the DIF has no DT information, kDifOk
otherwise. Definition at line 53 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_init | ( | mmio_region_t | base_addr, |
dif_soc_proxy_t * | soc_proxy ) |
Creates a new handle for a(n) soc_proxy peripheral.
This function does not actuate the hardware.
base_addr | The MMIO base address of the soc_proxy peripheral. | |
[out] | soc_proxy | Out param for the initialized handle. |
DEPRECATED This function exists solely for the transition to dt-based DIFs and will be removed in the future.
Definition at line 26 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_init_from_dt | ( | dt_soc_proxy_t | dt, |
dif_soc_proxy_t * | soc_proxy ) |
Creates a new handle for a(n) soc_proxy peripheral.
This function does not actuate the hardware.
dt | The devicetable description of the device. | |
[out] | soc_proxy | Out param for the initialized handle. |
Definition at line 40 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_acknowledge | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_irq_t | irq ) |
Acknowledges a particular interrupt, indicating to the hardware that it has been successfully serviced.
soc_proxy | A soc_proxy handle. |
irq | An interrupt request. |
Definition at line 387 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_acknowledge_all | ( | const dif_soc_proxy_t * | soc_proxy | ) |
Acknowledges all interrupts, indicating to the hardware that all interrupts have been successfully serviced.
soc_proxy | A soc_proxy handle. |
Definition at line 368 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_acknowledge_state | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_irq_state_snapshot_t | snapshot ) |
Acknowledges all interrupts that were pending at the time of the state snapshot.
soc_proxy | A soc_proxy handle. |
snapshot | Interrupt state snapshot. |
Definition at line 326 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_disable_all | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_irq_enable_snapshot_t * | snapshot ) |
Disables all interrupts, optionally snapshotting all enable states for later restoration.
soc_proxy | A soc_proxy handle. | |
[out] | snapshot | Out-param for the snapshot; may be NULL . |
Definition at line 495 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_force | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_irq_t | irq, | ||
const bool | val ) |
Forces a particular interrupt, causing it to be serviced as if hardware had asserted it.
soc_proxy | A soc_proxy handle. |
irq | An interrupt request. |
val | Value to be set. |
Definition at line 412 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_get_enabled | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_irq_t | irq, | ||
dif_toggle_t * | state ) |
Checks whether a particular interrupt is currently enabled or disabled.
soc_proxy | A soc_proxy handle. | |
irq | An interrupt request. | |
[out] | state | Out-param toggle state of the interrupt. |
Definition at line 437 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_get_state | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_irq_state_snapshot_t * | snapshot ) |
Returns the state of all interrupts (i.e., pending or not) for this IP.
soc_proxy | A soc_proxy handle. | |
[out] | snapshot | Out-param for interrupt state snapshot. |
Definition at line 309 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_get_type | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_irq_t | irq, | ||
dif_irq_type_t * | type ) |
Returns the type of a given interrupt (i.e., event or status) for this IP.
soc_proxy | A soc_proxy handle. | |
irq | An interrupt request. | |
[out] | type | Out-param for the interrupt type. |
Definition at line 290 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_is_pending | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_irq_t | irq, | ||
bool * | is_pending ) |
Returns whether a particular interrupt is currently pending.
soc_proxy | A soc_proxy handle. | |
irq | An interrupt request. | |
[out] | is_pending | Out-param for whether the interrupt is pending. |
Definition at line 343 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_restore_all | ( | const dif_soc_proxy_t * | soc_proxy, |
const dif_soc_proxy_irq_enable_snapshot_t * | snapshot ) |
Restores interrupts from the given (enable) snapshot.
soc_proxy | A soc_proxy handle. |
snapshot | A snapshot to restore from. |
Definition at line 522 of file dif_soc_proxy_autogen.c.
OT_WARN_UNUSED_RESULT dif_result_t dif_soc_proxy_irq_set_enabled | ( | const dif_soc_proxy_t * | soc_proxy, |
dif_soc_proxy_irq_t | irq, | ||
dif_toggle_t | state ) |
Sets whether a particular interrupt is currently enabled or disabled.
soc_proxy | A soc_proxy handle. |
irq | An interrupt request. |
state | The new toggle state for the interrupt. |
Definition at line 464 of file dif_soc_proxy_autogen.c.