mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
123 lines
3.5 KiB
C
123 lines
3.5 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
#pragma once
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include "hal/misc.h"
|
|
#include "hal/assert.h"
|
|
#include "soc/debug_probe_targets.h"
|
|
#include "soc/hp_system_struct.h"
|
|
#include "hal/debug_probe_types.h"
|
|
|
|
/**
|
|
* @brief Define how many channels are there in one debug probe unit
|
|
*/
|
|
#define DEBUG_PROBE_LL_CHANNELS_PER_UNIT 2
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// translate the HAL types into register values
|
|
#define DEBUG_PROBE_LL_PART_TO_REG_VAL(part) ((uint8_t[]) {0, 1}[(part)])
|
|
|
|
/**
|
|
* @brief Enable the debug probe module
|
|
*
|
|
* @param en true: enable, false: disable
|
|
*/
|
|
static inline void debug_probe_ll_enable_unit(int unit_id, bool en)
|
|
{
|
|
HP_SYSTEM.probea_ctrl.reg_probe_global_en = en;
|
|
}
|
|
|
|
/**
|
|
* @brief Enable a specific channel in the debug probe unit
|
|
*
|
|
* @param channel channel number (only support 0 and 1)
|
|
* @param en true: enable, false: disable
|
|
*/
|
|
static inline void debug_probe_ll_enable_channel(int unit_id, int channel, bool en)
|
|
{
|
|
// channel 0 is always enabled
|
|
if (channel == 1) {
|
|
HP_SYSTEM.probeb_ctrl.reg_probe_b_en = en;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Set the target module for a probe channel
|
|
*
|
|
* @param channel channel number (only support 0 and 1)
|
|
* @param target_module target module, see soc_debug_probe_target_t
|
|
*/
|
|
static inline void debug_probe_ll_channel_set_target_module(int unit_id, uint8_t channel, soc_debug_probe_target_t target_module)
|
|
{
|
|
if (channel == 0) {
|
|
HP_SYSTEM.probea_ctrl.reg_probe_a_top_sel = target_module;
|
|
} else {
|
|
HP_SYSTEM.probeb_ctrl.reg_probe_b_top_sel = target_module;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Add signals from a specific group to the probe channel
|
|
*
|
|
* @note One sig_group contains 4 bytes of signals. The sig_byte_idx is used to select the byte in the sig_group.
|
|
*
|
|
* @param channel channel number (only support 0 and 1)
|
|
* @param sig_byte_idx signal byte index (0-3)
|
|
* @param sig_group signal group (0-15)
|
|
*/
|
|
static inline void debug_probe_ll_channel_add_signal_group(int unit_id, uint8_t channel, uint8_t sig_byte_idx, uint8_t sig_group)
|
|
{
|
|
if (channel == 0) {
|
|
HP_SYSTEM.probea_ctrl.reg_probe_a_mod_sel &= ~(0xf << (sig_byte_idx * 4));
|
|
HP_SYSTEM.probea_ctrl.reg_probe_a_mod_sel |= (sig_group << (sig_byte_idx * 4));
|
|
} else {
|
|
HP_SYSTEM.probeb_ctrl.reg_probe_b_mod_sel &= ~(0xf << (sig_byte_idx * 4));
|
|
HP_SYSTEM.probeb_ctrl.reg_probe_b_mod_sel |= (sig_group << (sig_byte_idx * 4));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Set the lower 16 bits of the probe output
|
|
*
|
|
* @param part where does the probe_top_out[15:0] come from
|
|
*/
|
|
static inline void debug_probe_ll_set_lower16_output(int unit_id, int channel, debug_probe_split_u16_t part)
|
|
{
|
|
HP_SYSTEM.probea_ctrl.reg_probe_l_sel = channel * 2 + DEBUG_PROBE_LL_PART_TO_REG_VAL(part);
|
|
}
|
|
|
|
/**
|
|
* @brief Set the upper 16 bits of the probe output
|
|
*
|
|
* @param part where does the probe_top_out[31:16] come from
|
|
*/
|
|
static inline void debug_probe_ll_set_upper16_output(int unit_id, int channel, debug_probe_split_u16_t part)
|
|
{
|
|
HP_SYSTEM.probea_ctrl.reg_probe_h_sel = channel * 2 + DEBUG_PROBE_LL_PART_TO_REG_VAL(part);
|
|
}
|
|
|
|
/**
|
|
* @brief Read the value that currently being probed
|
|
*
|
|
* @note ESP32P4 can only route the LSB probe_top_out[15:0] to the GPIO pad. But the register still saves 32 signal bits.
|
|
*
|
|
* @return the value that currently being probed
|
|
*/
|
|
static inline uint32_t debug_probe_ll_read_output(int unit_id)
|
|
{
|
|
return HP_SYSTEM.probe_out.reg_probe_top_out;
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|