Software APIs
dif_clkmgr_autogen.c
1// Copyright lowRISC contributors (OpenTitan project).
2// Licensed under the Apache License, Version 2.0, see LICENSE for details.
3// SPDX-License-Identifier: Apache-2.0
4
5
6
7
8
9
10
11// THIS FILE HAS BEEN GENERATED, DO NOT EDIT MANUALLY. COMMAND:
12// util/autogen_dif.py -i
13// hw/top_earlgrey/ip_autogen/clkmgr/data/clkmgr.hjson -o
14// bazel-out/k8-fastbuild/bin/sw/device/lib/dif/autogen
15
16
17#include <stdint.h>
18
20#include "sw/device/lib/dif/autogen/dif_clkmgr_autogen.h"
21
22#include "clkmgr_regs.h" // Generated.
23
24
26dif_result_t dif_clkmgr_init(
27 mmio_region_t base_addr,
28 dif_clkmgr_t *clkmgr) {
29 if (clkmgr == NULL) {
30 return kDifBadArg;
31 }
32
33 clkmgr->dt = kDtClkmgrCount;
34 clkmgr->base_addr = base_addr;
35
36 return kDifOk;
37}
38
40dif_result_t dif_clkmgr_init_from_dt(
41 dt_clkmgr_t dt,
42 dif_clkmgr_t *clkmgr) {
43 if (clkmgr == NULL) {
44 return kDifBadArg;
45 }
46
47 clkmgr->dt = dt;
48 clkmgr->base_addr = mmio_region_from_addr(dt_clkmgr_primary_reg_block(dt));
49
50 return kDifOk;
51}
52
53dif_result_t dif_clkmgr_get_dt(
54 const dif_clkmgr_t *clkmgr,
55 dt_clkmgr_t *dt) {
56 if (clkmgr->dt == kDtClkmgrCount || dt == NULL) {
57 return kDifBadArg;
58 }
59 *dt = clkmgr->dt;
60 return kDifOk;
61}
62
63 dif_result_t dif_clkmgr_alert_force(
64 const dif_clkmgr_t *clkmgr,
65 dif_clkmgr_alert_t alert) {
66 if (clkmgr == NULL) {
67 return kDifBadArg;
68 }
69
70 bitfield_bit32_index_t alert_idx;
71 switch (alert) {
73 alert_idx = CLKMGR_ALERT_TEST_RECOV_FAULT_BIT;
74 break;
76 alert_idx = CLKMGR_ALERT_TEST_FATAL_FAULT_BIT;
77 break;
78 default:
79 return kDifBadArg;
80 }
81
82 uint32_t alert_test_reg = bitfield_bit32_write(0, alert_idx, true);
83 mmio_region_write32(
84 clkmgr->base_addr,
85 (ptrdiff_t)CLKMGR_ALERT_TEST_REG_OFFSET,
86 alert_test_reg);
87
88
89 return kDifOk;
90}
91