HPM SDK
HPMicro Software Development Kit
hpm_soc_feature.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2023-2025 HPMicro
3  *
4  * SPDX-License-Identifier: BSD-3-Clause
5  *
6  */
7 
8 #ifndef HPM_SOC_FEATURE_H
9 #define HPM_SOC_FEATURE_H
10 
11 #include "riscv/riscv_core.h"
12 #include "hpm_soc_ip.h"
13 #include "hpm_soc_ip_feature.h"
14 
15 /*
16  * Cache section
17  */
18 #define HPM_L1C_CACHE_SIZE (uint32_t)(16 * SIZE_1KB)
19 #define HPM_L1C_ICACHE_SIZE (HPM_L1C_CACHE_SIZE)
20 #define HPM_L1C_DCACHE_SIZE (HPM_L1C_CACHE_SIZE)
21 #define HPM_L1C_CACHELINE_SIZE (32)
22 #define HPM_L1C_CACHELINES_PER_WAY (128)
23 #define HPM_L1C_CACHELINE_ALIGN_DOWN(n) ((uint32_t)(n) & ~(HPM_L1C_CACHELINE_SIZE - 1U))
24 #define HPM_L1C_CACHELINE_ALIGN_UP(n) HPM_L1C_CACHELINE_ALIGN_DOWN((uint32_t)(n) + HPM_L1C_CACHELINE_SIZE - 1U)
25 
26 /*
27  * PLIC feature
28  */
29 #define PLIC_SUPPORT_EDGE_TRIGGER (1)
30 
31 /*
32  * PMP/PMA Feature
33  */
34 #define PMP_SUPPORT_PMA (0)
35 
36 /*
37  * I2C Section
38  */
39 #define I2C_SOC_FIFO_SIZE (4U)
40 #define I2C_SOC_TRANSFER_COUNT_MAX (4096U)
41 
42 /*
43  * PMIC Section
44  */
45 #define PCFG_SOC_LDO1P1_MIN_VOLTAGE_IN_MV (700U)
46 #define PCFG_SOC_LDO1P1_MAX_VOLTAGE_IN_MV (1320U)
47 #define PCFG_SOC_LDO2P5_MIN_VOLTAGE_IN_MV (2125)
48 #define PCFG_SOC_LDO2P5_MAX_VOLTAGE_IN_MV (2900U)
49 #define PCFG_SOC_DCDC_MIN_VOLTAGE_IN_MV (600U)
50 #define PCFG_SOC_DCDC_MAX_VOLTAGE_IN_MV (1375U)
51 
52 /*
53  * PLLCTL Section
54  */
55 #define PLLCTL_SOC_PLL_MAX_COUNT (2U)
56 /* PLL reference clock in hz */
57 #define PLLCTL_SOC_PLL_REFCLK_FREQ (24U * 1000000UL)
58 /* only PLL1 and PLL2 have DIV0, DIV1 */
59 #define PLLCTL_SOC_PLL_HAS_DIV0(x) ((((x) == 1) || ((x) == 2)) ? 1 : 0)
60 #define PLLCTL_SOC_PLL_HAS_DIV1(x) ((((x) == 1) || ((x) == 2)) ? 1 : 0)
61 
62 
63 /*
64  * PWM Section
65  */
66 #define PWM_SOC_PWM_MAX_COUNT (8U)
67 #define PWM_SOC_CMP_MAX_COUNT (24U)
68 #define PWM_SOC_OUTPUT_TO_PWM_MAX_COUNT (8U)
69 
70 /*
71  * DMA Section
72  */
73 #define DMA_SOC_TRANSFER_WIDTH_MAX(x) (DMA_TRANSFER_WIDTH_WORD)
74 #define DMA_SOC_TRANSFER_PER_BURST_MAX(x) (DMA_NUM_TRANSFER_PER_BURST_128T)
75 #define DMA_SOC_CHANNEL_NUM (32U)
76 #define DMA_SOC_MAX_COUNT (1U)
77 #define DMA_SOC_CHN_TO_DMAMUX_CHN(x, n) (DMAMUX_MUXCFG_HDMA_MUX0 + n)
78 #define DMA_SOC_HAS_IDLE_FLAG (1U)
79 
80 /*
81  * DMAMUX Section
82  */
83 #define DMAMUX_SOC_WRITEONLY (1U)
84 
85 /*
86  * USB Section
87  */
88 #define USB_SOC_MAX_COUNT (1U)
89 
90 #define USB_SOC_DCD_QTD_NEXT_INVALID (1U)
91 #define USB_SOC_DCD_QHD_BUFFER_COUNT (5U)
92 #define USB_SOC_DCD_MAX_ENDPOINT_COUNT (16U)
93 #ifndef USB_SOC_DCD_QTD_COUNT_EACH_ENDPOINT
94 #define USB_SOC_DCD_QTD_COUNT_EACH_ENDPOINT (8U)
95 #endif
96 #define USB_SOC_DCD_MAX_QTD_COUNT (USB_SOC_DCD_MAX_ENDPOINT_COUNT * 2U * USB_SOC_DCD_QTD_COUNT_EACH_ENDPOINT)
97 #define USB_SOS_DCD_MAX_QHD_COUNT (USB_SOC_DCD_MAX_ENDPOINT_COUNT * 2U)
98 #define USB_SOC_DCD_DATA_RAM_ADDRESS_ALIGNMENT (2048U)
99 
100 #define USB_SOC_HCD_FRAMELIST_MAX_ELEMENTS (1024U)
101 
102 /*
103  * ADC Section
104  */
105 #define ADC_SOC_IP_VERSION (3U)
106 #define ADC_SOC_SEQ_MAX_LEN (16U)
107 #define ADC_SOC_SEQ_HCFG_EN (1U)
108 #define ADC_SOC_MAX_TRIG_CH_LEN (4U)
109 #define ADC_SOC_MAX_TRIG_CH_NUM (11U)
110 #define ADC_SOC_DMA_ADDR_ALIGNMENT (4U)
111 #define ADC_SOC_CONFIG_INTEN_CHAN_BIT_SIZE (8U)
112 #define ADC_SOC_BUSMODE_ENABLE_CTRL_SUPPORT (1U)
113 #define ADC_SOC_PREEMPT_ENABLE_CTRL_SUPPORT (1U)
114 #define ADC_SOC_SEQ_MAX_DMA_BUFF_LEN_IN_4BYTES (16777216U)
115 #define ADC_SOC_PMT_MAX_DMA_BUFF_LEN_IN_4BYTES (48U)
116 
117 #define ADC16_SOC_PARAMS_LEN (34U)
118 #define ADC16_SOC_MAX_CH_NUM (15U)
119 #define ADC16_SOC_MAX_SAMPLE_VALUE (65535U)
120 #define ADC16_SOC_MAX_CONV_CLK_NUM (21U)
121 
122 /*
123  * SYSCTL Section
124  */
125 #define SYSCTL_SOC_CPU_GPR_COUNT (14U)
126 #define SYSCTL_SOC_MONITOR_SLICE_COUNT (4U)
127 
128 /*
129  * PTPC Section
130  */
131 #define PTPC_SOC_TIMER_MAX_COUNT (2U)
132 
133 /*
134  * SDP Section
135  */
136 #define SDP_REGISTER_DESCRIPTOR_COUNT (1U)
137 #define SDP_HAS_SM3_SUPPORT (1U)
138 #define SDP_HAS_SM4_SUPPORT (1U)
139 
140 /*
141  * SOC Privilege mode
142  */
143 #define SOC_HAS_S_MODE (0U)
144 
145 /*
146  * DAC Section
147  */
148 #define DAC_SOC_BUFF_ALIGNED_SIZE (32U)
149 #define DAC_SOC_MAX_DATA (4095U)
150 #define DAC_SOC_MAX_BUFF_COUNT (65536U)
151 #define DAC_SOC_MAX_OUTPUT_FREQ (1000000UL)
152 
153 /*
154  * UART Section
155  */
156 #define UART_SOC_FIFO_SIZE (16U)
157 #define UART_SOC_OVERSAMPLE_MAX (30U) /* only support 30 oversample rate for rx idle detection */
158 
159 /*
160  * SPI Section
161  */
162 #define SPI_SOC_TRANSFER_COUNT_MAX (0xFFFFFFFFU)
163 #define SPI_SOC_FIFO_DEPTH (8U)
164 
165 /*
166  * OTP Section
167  */
168 #define OTP_SOC_UUID_IDX (88U)
169 #define OTP_SOC_UUID_LEN (16U) /* in bytes */
170 
171 /*
172  * PWM Section
173  */
174 #define PWM_SOC_HRPWM_SUPPORT (0U)
175 #define PWM_SOC_SHADOW_TRIG_SUPPORT (0U)
176 #define PWM_SOC_TIMER_RESET_SUPPORT (1U)
177 
178 /*
179  * TRGM section
180  */
181 #define TRGM_SOC_HAS_FILTER_SHIFT (1U)
182 #define TRGM_SOC_HAS_DMAMUX_EN (1U)
183 #define TRGM_SOC_HAS_ADC_MATRIX_SEL (1U)
184 #define TRGM_SOC_HAS_DAC_MATRIX_SEL (1U)
185 #define TRGM_SOC_HAS_POS_MATRIX_SEL (1U)
186 #define TRGM_SOC_TRIM_IN_GROUP_MAX (3U)
187 #define TRGM_SOC_TRIM_OUT_GROUP_MAX (4U)
188 
189 /*
190  * MCAN Section
191  */
192 #define MCAN_SOC_MAX_COUNT (4U)
193 #define MCAN_SOC_MSG_BUF_IN_IP (0U)
194 #define MCAN_SOC_MSG_BUF_IN_AHB_RAM (1U)
195 #define CAN_SOC_MAX_COUNT MCAN_SOC_MAX_COUNT
196 
197 /*
198  * EWDG Section
199  */
200 #define EWDG_SOC_CLK_DIV_VAL_MAX (5U)
201 #define EWDG_SOC_OVERTIME_REG_WIDTH (16U)
202 #define EWDG_TIMEOUT_INTERRUPT_REQUIRE_EDGE_TRIGGER (1)
203 
204 /*
205  * Sync Timer
206  */
207 #define SYNT_SOC_HAS_TIMESTAMP (1U)
208 
209 /*
210  * GPIO
211  */
212 #define GPIO_SOC_HAS_EDGE_BOTH_INTERRUPT (1U)
213 
217 #define OPAMP_SOC_HAS_MAX_PRESET_CHN_NUM (7U)
218 
222 #define PLB_SOC_TYPEA_TRGM_INPUT0 (TRGM_TRGOCFG_PLB_IN_00)
223 #define PLB_SOC_TYPEA_TRGM_OUTPUT0 (HPM_TRGM0_INPUT_SRC_PLB_OUT00)
224 #define PLB_SOC_TYPEB_TRGM_INPUT0 (TRGM_TRGOCFG_PLB_IN_16)
225 #define PLB_SOC_TYPEB_TRGM_OUTPUT0 (HPM_TRGM0_INPUT_SRC_PLB_OUT16)
226 
227 
228 #endif /* HPM_SOC_FEATURE_H */