Software APIs
dif_otp_macro_autogen.h File Reference

OTP_MACRO 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 "hw/top/dt/otp_macro.h"

Go to the source code of this file.

Data Structures

struct  dif_otp_macro
 A handle to otp_macro. More...
 

Typedefs

typedef struct dif_otp_macro dif_otp_macro_t
 A handle to otp_macro.
 

Functions

OT_WARN_UNUSED_RESULT dif_result_t dif_otp_macro_init (mmio_region_t base_addr, dif_otp_macro_t *otp_macro)
 Creates a new handle for a(n) otp_macro peripheral.
 
OT_WARN_UNUSED_RESULT dif_result_t dif_otp_macro_init_from_dt (dt_otp_macro_t dt, dif_otp_macro_t *otp_macro)
 Creates a new handle for a(n) otp_macro peripheral.
 
OT_WARN_UNUSED_RESULT dif_result_t dif_otp_macro_get_dt (const dif_otp_macro_t *otp_macro, dt_otp_macro_t *dt)
 Get the DT handle from this DIF.
 

Detailed Description

OTP_MACRO Device Interface Functions

Definition in file dif_otp_macro_autogen.h.


Data Structure Documentation

◆ dif_otp_macro

struct dif_otp_macro

A handle to otp_macro.

This type should be treated as opaque by users.

Definition at line 37 of file dif_otp_macro_autogen.h.

Data Fields
mmio_region_t base_addr The base address for the otp_macro hardware registers.
dt_otp_macro_t dt The instance, set to kDtOtpMacroCount if not initialized through dif_otp_macro_init_from_dt.

Typedef Documentation

◆ dif_otp_macro_t

A handle to otp_macro.

This type should be treated as opaque by users.

Function Documentation

◆ dif_otp_macro_get_dt()

OT_WARN_UNUSED_RESULT dif_result_t dif_otp_macro_get_dt ( const dif_otp_macro_t * otp_macro,
dt_otp_macro_t * dt )

Get the DT handle from this DIF.

If this DIF was initialized by dif_otp_macro_init_from_dt(dt, ..) then this function will return dt. Otherwise it will return an error.

Parameters
otp_macroA otp_macro handle.
[out]dtDT handle.
Returns
kDifBadArg if the DIF has no DT information, kDifOk otherwise.

Definition at line 52 of file dif_otp_macro_autogen.c.

◆ dif_otp_macro_init()

OT_WARN_UNUSED_RESULT dif_result_t dif_otp_macro_init ( mmio_region_t base_addr,
dif_otp_macro_t * otp_macro )

Creates a new handle for a(n) otp_macro peripheral.

This function does not actuate the hardware.

Parameters
base_addrThe MMIO base address of the otp_macro peripheral.
[out]otp_macroOut param for the initialized handle.
Returns
The result of the operation.

DEPRECATED This function exists solely for the transition to dt-based DIFs and will be removed in the future.

Definition at line 25 of file dif_otp_macro_autogen.c.

◆ dif_otp_macro_init_from_dt()

OT_WARN_UNUSED_RESULT dif_result_t dif_otp_macro_init_from_dt ( dt_otp_macro_t dt,
dif_otp_macro_t * otp_macro )

Creates a new handle for a(n) otp_macro peripheral.

This function does not actuate the hardware.

Parameters
dtThe devicetable description of the device.
[out]otp_macroOut param for the initialized handle.
Returns
The result of the operation.

Definition at line 39 of file dif_otp_macro_autogen.c.