dif_soc_dbg_ctrl_autogen.c

// Copyright lowRISC contributors (OpenTitan project).
// Licensed under the Apache License, Version 2.0, see LICENSE for details.
// SPDX-License-Identifier: Apache-2.0
 
 
 
 
 
 
 
// THIS FILE HAS BEEN GENERATED, DO NOT EDIT MANUALLY. COMMAND:
// util/autogen_dif.py -i hw/ip/soc_dbg_ctrl/data/soc_dbg_ctrl.hjson -o
// bazel-out/k8-fastbuild-ST-ae23cdef058d/bin/sw/device/lib/dif/autogen
 
 
#include <stdint.h>
 
#include "sw/device/lib/dif/dif_base.h"
#include "sw/device/lib/dif/autogen/dif_soc_dbg_ctrl_autogen.h"
 
#include "soc_dbg_ctrl_regs.h"  // Generated.
 
 
OT_WARN_UNUSED_RESULT
dif_result_t dif_soc_dbg_ctrl_init(
  mmio_region_t base_addr,
  dif_soc_dbg_ctrl_t *soc_dbg_ctrl) {
  if (soc_dbg_ctrl == NULL) {
    return kDifBadArg;
  }
 
  soc_dbg_ctrl->dt = kDtSocDbgCtrlCount;
  soc_dbg_ctrl->base_addr = base_addr;
 
  return kDifOk;
}
 
OT_WARN_UNUSED_RESULT
dif_result_t dif_soc_dbg_ctrl_init_from_dt(
  dt_soc_dbg_ctrl_t dt,
  dif_soc_dbg_ctrl_t *soc_dbg_ctrl) {
  if (soc_dbg_ctrl == NULL) {
    return kDifBadArg;
  }
 
  soc_dbg_ctrl->dt = dt;
  soc_dbg_ctrl->base_addr = mmio_region_from_addr(dt_soc_dbg_ctrl_primary_reg_block(dt));
 
  return kDifOk;
}
 
dif_result_t dif_soc_dbg_ctrl_get_dt(
  const dif_soc_dbg_ctrl_t *soc_dbg_ctrl,
  dt_soc_dbg_ctrl_t *dt) {
  if (soc_dbg_ctrl->dt == kDtSocDbgCtrlCount || dt == NULL) {
    return kDifBadArg;
  }
  *dt = soc_dbg_ctrl->dt;
  return kDifOk;
}
 
  dif_result_t dif_soc_dbg_ctrl_alert_force(
    const dif_soc_dbg_ctrl_t *soc_dbg_ctrl,
    dif_soc_dbg_ctrl_alert_t alert) {
  if (soc_dbg_ctrl == NULL) {
    return kDifBadArg;
  }
 
  bitfield_bit32_index_t alert_idx;
  switch (alert) {
    case kDifSocDbgCtrlAlertFatalFault:
      alert_idx = SOC_DBG_CTRL_ALERT_TEST_FATAL_FAULT_BIT;
      break;
    case kDifSocDbgCtrlAlertRecovCtrlUpdateErr:
      alert_idx = SOC_DBG_CTRL_ALERT_TEST_RECOV_CTRL_UPDATE_ERR_BIT;
      break;
    default:
      return kDifBadArg;
  }
 
  uint32_t alert_test_reg = bitfield_bit32_write(0, alert_idx, true);
  mmio_region_write32(
    soc_dbg_ctrl->base_addr,
    (ptrdiff_t)SOC_DBG_CTRL_ALERT_TEST_REG_OFFSET,
    alert_test_reg);
 
 
  return kDifOk;
}