SysTimer Functions

Functions that configure the Core System Timer. More...

Macros
#define	SysTimer_GetHartID()   (__get_hart_index())
	SysTimer_GetHartID() is used to get timer hartid which might not be the same as cpu hart id, for example, cpu hartid may be 1, but timer hartid may be 0, then timer hartid offset is 1. More...

Functions
__STATIC_FORCEINLINE void	SysTimer_SetLoadValue (uint64_t value)
	Set system timer load value. More...
__STATIC_FORCEINLINE uint64_t	SysTimer_GetLoadValue (void)
	Get system timer load value. More...
__STATIC_FORCEINLINE void	SysTimer_SetHartCompareValue (uint64_t value, unsigned long hartid)
	Set system timer compare value by hartid. More...
__STATIC_FORCEINLINE void	SysTimer_SetCompareValue (uint64_t value)
	Set system timer compare value in machine mode. More...
__STATIC_FORCEINLINE uint64_t	SysTimer_GetHartCompareValue (unsigned long hartid)
	Get system timer compare value by hartid. More...
__STATIC_FORCEINLINE uint64_t	SysTimer_GetCompareValue (void)
	Get system timer compare value in machine mode. More...
__STATIC_FORCEINLINE void	SysTimer_Start (void)
	Enable system timer counter running. More...
__STATIC_FORCEINLINE void	SysTimer_Stop (void)
	Stop system timer counter running. More...
__STATIC_FORCEINLINE void	SysTimer_SetControlValue (uint32_t mctl)
	Set system timer control value. More...
__STATIC_FORCEINLINE uint32_t	SysTimer_GetControlValue (void)
	Get system timer control value. More...
__STATIC_FORCEINLINE void	SysTimer_SetHartSWIRQ (unsigned long hartid)
	Trigger or set software interrupt via system timer by hartid. More...
__STATIC_FORCEINLINE void	SysTimer_SetSWIRQ (void)
	Trigger or set software interrupt via system timer in machine mode. More...
__STATIC_FORCEINLINE void	SysTimer_ClearHartSWIRQ (unsigned long hartid)
	Clear system timer software interrupt pending request by hartid. More...
__STATIC_FORCEINLINE void	SysTimer_ClearSWIRQ (void)
	Clear system timer software interrupt pending request in machine mode. More...
__STATIC_FORCEINLINE uint32_t	SysTimer_GetHartMsipValue (unsigned long hartid)
	Get system timer MSIP register value by hartid. More...
__STATIC_FORCEINLINE uint32_t	SysTimer_GetMsipValue (void)
	Get system timer MSIP register value in machine mode. More...
__STATIC_FORCEINLINE void	SysTimer_SetHartMsipValue (uint32_t msip, unsigned long hartid)
	Set system timer MSIP register value by hartid. More...
__STATIC_FORCEINLINE void	SysTimer_SetMsipValue (uint32_t msip)
	Set system timer MSIP register value in machine mode. More...
__STATIC_FORCEINLINE void	SysTimer_SoftwareReset (void)
	Do software reset request. More...
__STATIC_FORCEINLINE void	SysTimer_SendIPI (unsigned long hartid)
	send ipi to target hart using Systimer Clint More...
__STATIC_FORCEINLINE void	SysTimer_ClearIPI (unsigned long hartid)
	clear ipi to target hart using Systimer Clint More...
__STATIC_INLINE uint32_t	SysTick_Config (uint64_t ticks)
	System Tick Configuration. More...
__STATIC_INLINE uint32_t	SysTick_HartConfig (uint64_t ticks, unsigned long hartid)
	System Tick Configuration By hartid. More...
__STATIC_FORCEINLINE uint32_t	SysTick_Reload (uint64_t ticks)
	System Tick Reload. More...
__STATIC_FORCEINLINE uint32_t	SysTick_HartReload (uint64_t ticks, unsigned long hartid)
	System Tick Reload. More...

Detailed Description

Functions that configure the Core System Timer.

Macro Definition Documentation

SysTimer_GetHartID

#define SysTimer_GetHartID

(

)

(__get_hart_index())

SysTimer_GetHartID() is used to get timer hartid which might not be the same as cpu hart id, for example, cpu hartid may be 1, but timer hartid may be 0, then timer hartid offset is 1.

If defined __SYSTIMER_HARTID, it will use __SYSTIMER_HARTID as timer hartid, otherwise, it will use __get_hart_index(). The cpu hartid is get by using __get_hart_id function

Definition at line 118 of file core_feature_timer.h.

Function Documentation

SysTick_Config()

__STATIC_INLINE uint32_t SysTick_Config

(

uint64_t

ticks

)

System Tick Configuration.

Initializes the System Timer and its non-vector interrupt, and starts the System Tick Timer.

In our default implementation, the timer counter will be set to zero, and it will start a timer compare non-vector interrupt when it matchs the ticks user set, during the timer interrupt user should reload the system tick using SysTick_Reload function or similar function written by user, so it can produce period timer interrupt.

Parameters

[in]

ticks

Number of ticks between two interrupts.

Returns

0 Function succeeded.

1 Function failed.

Remarks

• For __NUCLEI_N_REV >= 0x0104, the CMPCLREN bit in MTIMECTL is introduced, but we assume that the CMPCLREN bit is set to 0, so MTIMER register will not be auto cleared to 0 when MTIMER >= MTIMERCMP.
• When the variable __Vendor_SysTickConfig is set to 1, then the function SysTick_Config is not included.
• In this case, the file <Device>.h must contain a vendor-specific implementation of this function.
• If user need this function to start a period timer interrupt, then in timer interrupt handler routine code, user should call SysTick_Reload with ticks to reload the timer.
• This function only available when __SYSTIMER_PRESENT == 1 and __ECLIC_PRESENT == 1 and __Vendor_SysTickConfig == 0

See also

• SysTimer_SetCompareValue; SysTimer_SetLoadValue

Definition at line 545 of file core_feature_timer.h.

{
    uint64_t loadticks = SysTimer_GetLoadValue();
    SysTimer_SetCompareValue(ticks + loadticks);
    ECLIC_SetShvIRQ(SysTimer_IRQn, ECLIC_NON_VECTOR_INTERRUPT);
    ECLIC_SetLevelIRQ(SysTimer_IRQn, 0);
    ECLIC_EnableIRQ(SysTimer_IRQn);
    return (0UL);
}

References ECLIC_EnableIRQ, ECLIC_NON_VECTOR_INTERRUPT, ECLIC_SetLevelIRQ, ECLIC_SetShvIRQ, SysTimer_GetLoadValue(), SysTimer_IRQn, and SysTimer_SetCompareValue().

SysTick_HartConfig()

__STATIC_INLINE uint32_t SysTick_HartConfig	(	uint64_t	ticks,
		unsigned long	hartid
	)

System Tick Configuration By hartid.

Initializes the System Timer and its non-vector interrupt, and starts the System Tick Timer.

In our default implementation, the timer counter will be set to zero, and it will start a timer compare non-vector interrupt when it matchs the ticks user set, during the timer interrupt user should reload the system tick using SysTick_Reload function or similar function written by user, so it can produce period timer interrupt.

Parameters

[in]	ticks	Number of ticks between two interrupts.
[in]	hartid	hart ID, one hart is required to have a known hart ID of 0, other harts ID can be in 1~1023.

Returns

0 Function succeeded.

1 Function failed.

Remarks

• For __NUCLEI_N_REV >= 0x0104, the CMPCLREN bit in MTIMECTL is introduced, but we assume that the CMPCLREN bit is set to 0, so MTIMER register will not be auto cleared to 0 when MTIMER >= MTIMERCMP.
• When the variable __Vendor_SysTickConfig is set to 1, then the function SysTick_Config is not included.
• In this case, the file <Device>.h must contain a vendor-specific implementation of this function.
• If user need this function to start a period timer interrupt, then in timer interrupt handler routine code, user should call SysTick_Reload with ticks to reload the timer.
• This function only available when __SYSTIMER_PRESENT == 1 and __ECLIC_PRESENT == 1 and __Vendor_SysTickConfig == 0
• In S-mode, hartid can't be get by using __get_hart_id function, so this api suits S-mode particularly.

See also

• SysTimer_SetCompareValue; SysTimer_SetLoadValue

Definition at line 581 of file core_feature_timer.h.

{
    uint64_t loadticks = SysTimer_GetLoadValue();
    SysTimer_SetHartCompareValue(ticks + loadticks, hartid);
    ECLIC_SetShvIRQ(SysTimer_IRQn, ECLIC_NON_VECTOR_INTERRUPT);
    ECLIC_SetLevelIRQ(SysTimer_IRQn, 0);
    ECLIC_EnableIRQ(SysTimer_IRQn);
    return (0UL);
}

References ECLIC_EnableIRQ, ECLIC_NON_VECTOR_INTERRUPT, ECLIC_SetLevelIRQ, ECLIC_SetShvIRQ, SysTimer_GetLoadValue(), SysTimer_IRQn, and SysTimer_SetHartCompareValue().

SysTick_HartReload()

__STATIC_FORCEINLINE uint32_t SysTick_HartReload	(	uint64_t	ticks,
		unsigned long	hartid
	)

System Tick Reload.

Reload the System Timer Tick when the MTIMECMP reached TIME value

Parameters

[in]	ticks	Number of ticks between two interrupts.
[in]	hartid	hart ID, one hart is required to have a known hart ID of 0, other harts ID can be in 1~1023.

Returns

0 Function succeeded.

1 Function failed.

Remarks

• For __NUCLEI_N_REV >= 0x0104, the CMPCLREN bit in MTIMECTL is introduced, but for this SysTick_Config function, we assume this CMPCLREN bit is set to 0, so in interrupt handler function, user still need to set the MTIMERCMP or MTIMER to reload the system tick, if vendor want to use this timer's auto clear feature, they can define __Vendor_SysTickConfig to 1, and implement SysTick_Config and SysTick_Reload functions.
• When the variable __Vendor_SysTickConfig is set to 1, then the function SysTick_Reload is not included.
• In this case, the file <Device>.h must contain a vendor-specific implementation of this function.
• This function only available when __SYSTIMER_PRESENT == 1 and __ECLIC_PRESENT == 1 and __Vendor_SysTickConfig == 0
• Since the MTIMERCMP value might overflow, if overflowed, MTIMER will be set to 0, and MTIMERCMP set to ticks
• In S-mode, hartid can't be get by using __get_hart_id function, so this api suits S-mode particularly.

See also

• SysTimer_SetCompareValue
• SysTimer_SetLoadValue

Definition at line 657 of file core_feature_timer.h.

{
    uint64_t cur_ticks = SysTimer_GetLoadValue();
    uint64_t reload_ticks = ticks + cur_ticks;
 
    if (__USUALLY(reload_ticks > cur_ticks)) {
        SysTimer_SetHartCompareValue(reload_ticks, hartid);
    } else {
        /* When added the ticks value, then the MTIMERCMP < TIMER,
         * which means the MTIMERCMP is overflowed,
         * so we need to reset the counter to zero */
        SysTimer_SetLoadValue(0);
        SysTimer_SetHartCompareValue(ticks, hartid);
    }
 
    return (0UL);
}

References __USUALLY, SysTimer_GetLoadValue(), SysTimer_SetHartCompareValue(), and SysTimer_SetLoadValue().

SysTick_Reload()

__STATIC_FORCEINLINE uint32_t SysTick_Reload

(

uint64_t

ticks

)

System Tick Reload.

Reload the System Timer Tick when the MTIMECMP reached TIME value

Parameters

[in]

ticks

Number of ticks between two interrupts.

Returns

0 Function succeeded.

1 Function failed.

Remarks

• For __NUCLEI_N_REV >= 0x0104, the CMPCLREN bit in MTIMECTL is introduced, but for this SysTick_Config function, we assume this CMPCLREN bit is set to 0, so in interrupt handler function, user still need to set the MTIMERCMP or MTIMER to reload the system tick, if vendor want to use this timer's auto clear feature, they can define __Vendor_SysTickConfig to 1, and implement SysTick_Config and SysTick_Reload functions.
• When the variable __Vendor_SysTickConfig is set to 1, then the function SysTick_Reload is not included.
• In this case, the file <Device>.h must contain a vendor-specific implementation of this function.
• This function only available when __SYSTIMER_PRESENT == 1 and __ECLIC_PRESENT == 1 and __Vendor_SysTickConfig == 0
• Since the MTIMERCMP value might overflow, if overflowed, MTIMER will be set to 0, and MTIMERCMP set to ticks

See also

• SysTimer_SetCompareValue
• SysTimer_SetLoadValue

Definition at line 614 of file core_feature_timer.h.

{
    uint64_t cur_ticks = SysTimer_GetLoadValue();
    uint64_t reload_ticks = ticks + cur_ticks;
 
    if (__USUALLY(reload_ticks > cur_ticks)) {
        SysTimer_SetCompareValue(reload_ticks);
    } else {
        /* When added the ticks value, then the MTIMERCMP < TIMER,
         * which means the MTIMERCMP is overflowed,
         * so we need to reset the counter to zero */
        SysTimer_SetLoadValue(0);
        SysTimer_SetCompareValue(ticks);
    }
 
    return (0UL);
}

References __USUALLY, SysTimer_GetLoadValue(), SysTimer_SetCompareValue(), and SysTimer_SetLoadValue().

SysTimer_ClearHartSWIRQ()

__STATIC_FORCEINLINE void SysTimer_ClearHartSWIRQ

(

unsigned long

hartid

)

Clear system timer software interrupt pending request by hartid.

This function clear the system timer MSIP bit in MSIP register.

Parameters

[in]

hartid

hart ID, one hart is required to have a known hart ID of 0, other harts ID can be in 1~1023.

Remarks

• Clear system timer MSIP bit in MSIP register to clear the software interrupt pending.
• In S-mode, hartid can't be get by using __get_hart_id function, so this api suits S-mode particularly.
• SysTimer_SetHartSWIRQ
• SysTimer_GetHartMsipValue

Definition at line 379 of file core_feature_timer.h.

{
    if (hartid == 0) {
        SysTimer->MSIP &= ~SysTimer_MSIP_MSIP_Msk;
    } else {
        uint8_t *addr = (uint8_t *)(SysTimer_CLINT_MSIP_BASE(hartid));
        __SW(addr, 0);
    }
}

References __SW(), SysTimer, SysTimer_CLINT_MSIP_BASE, and SysTimer_MSIP_MSIP_Msk.

Referenced by SysTimer_ClearSWIRQ().

SysTimer_ClearIPI()

__STATIC_FORCEINLINE void SysTimer_ClearIPI

(

unsigned long

hartid

)

clear ipi to target hart using Systimer Clint

This function clear ipi using Systimer clint timer.

Parameters

[in]

hart

target hart

Definition at line 514 of file core_feature_timer.h.

{
    uint8_t *addr = (uint8_t *)(SysTimer_CLINT_MSIP_BASE(hartid));
    __SW(addr, 0);
}

References __SW(), and SysTimer_CLINT_MSIP_BASE.

SysTimer_ClearSWIRQ()

__STATIC_FORCEINLINE void SysTimer_ClearSWIRQ

(

void

)

Clear system timer software interrupt pending request in machine mode.

This function clear the system timer MSIP bit in MSIP register.

Remarks

• Clear system timer MSIP bit in MSIP register to clear the software interrupt pending.
• SysTimer_SetSWIRQ
• SysTimer_GetMsipValue

Definition at line 398 of file core_feature_timer.h.

{
    unsigned long hartid = SysTimer_GetHartID();
    SysTimer_ClearHartSWIRQ(hartid);
}

References SysTimer_ClearHartSWIRQ(), and SysTimer_GetHartID.

SysTimer_GetCompareValue()

__STATIC_FORCEINLINE uint64_t SysTimer_GetCompareValue

(

void

)

Get system timer compare value in machine mode.

This function get the system timer compare value in MTIMERCMP register.

Returns

compare value of system timer MTIMERCMP register.

Remarks

• Compare value is 64bits wide.
• SysTimer_SetCompareValue

Definition at line 272 of file core_feature_timer.h.

{
    unsigned long hartid = SysTimer_GetHartID();
    return SysTimer_GetHartCompareValue(hartid);
}

References SysTimer_GetHartCompareValue(), and SysTimer_GetHartID.

SysTimer_GetControlValue()

__STATIC_FORCEINLINE uint32_t SysTimer_GetControlValue

(

void

)

Get system timer control value.

This function get the system timer MTIMECTL register value.

Returns

MTIMECTL register value

Remarks

• SysTimer_SetControlValue

Definition at line 327 of file core_feature_timer.h.

{
    return (SysTimer->MTIMECTL & SysTimer_MTIMECTL_Msk);
}

References SysTimer, and SysTimer_MTIMECTL_Msk.

SysTimer_GetHartCompareValue()

__STATIC_FORCEINLINE uint64_t SysTimer_GetHartCompareValue

(

unsigned long

hartid

)

Get system timer compare value by hartid.

This function get the system timer compare value in MTIMERCMP register.

Parameters

[in]

hartid

hart ID, one hart is required to have a known hart ID of 0, other harts ID can be in 1~1023.

Returns

compare value of system timer MTIMERCMP register.

Remarks

• Compare value is 64bits wide.
• In S-mode, hartid can't be get by using __get_hart_id function, so this api suits S-mode particularly.
• SysTimer_SetHartCompareValue

Definition at line 242 of file core_feature_timer.h.

{
    if (hartid == 0) {
        return SysTimer->MTIMERCMP;
    } else {
        uint64_t full;
        uint8_t *addr = (uint8_t *)(SysTimer_CLINT_MTIMECMP_BASE(hartid));
#if __RISCV_XLEN == 32
        // MTIMECMP didn't increase
        uint32_t high, low;
 
        high = __LW(addr + 4);
        low = __LW(addr);
        full = (((uint64_t)high) << 32) | low;
#else
        full = __LD(addr);
#endif
        return full;
    }
}

References __LW(), SysTimer, and SysTimer_CLINT_MTIMECMP_BASE.

Referenced by SysTimer_GetCompareValue().

SysTimer_GetHartMsipValue()

__STATIC_FORCEINLINE uint32_t SysTimer_GetHartMsipValue

(

unsigned long

hartid

)

Get system timer MSIP register value by hartid.

This function get the system timer MSIP register value.

Parameters

[in]

hartid

hart ID, one hart is required to have a known hart ID of 0, other harts ID can be in 1~1023.

Returns

Value of Timer MSIP register.

Remarks

• Bit0 is SW interrupt flag. Bit0 is 1 then SW interrupt set. Bit0 is 0 then SW interrupt clear.
• In S-mode, hartid can't be get by using __get_hart_id function, so this api suits S-mode particularly.
• SysTimer_SetHartSWIRQ
• SysTimer_ClearHartSWIRQ
• SysTimer_SetHartMsipValue

Definition at line 418 of file core_feature_timer.h.

{
    if (hartid == 0) {
        return (uint32_t)(SysTimer->MSIP & SysTimer_MSIP_Msk);
    } else {
        uint8_t *addr = (uint8_t *)(SysTimer_CLINT_MSIP_BASE(hartid));
        return __LW(addr);
    }
}

References __LW(), SysTimer, SysTimer_CLINT_MSIP_BASE, and SysTimer_MSIP_Msk.

Referenced by SysTimer_GetMsipValue().

SysTimer_GetLoadValue()

__STATIC_FORCEINLINE uint64_t SysTimer_GetLoadValue

(

void

)

Get system timer load value.

This function get the system timer current value in MTIMER register.

Returns

current value(64bit) of system timer MTIMER register.

Remarks

• Load value is 64bits wide.
• SysTimer_SetLoadValue

Definition at line 154 of file core_feature_timer.h.

{
#if __RISCV_XLEN == 32
    volatile uint32_t high0, low, high;
    uint64_t full;
    uint8_t *addr;
 
    addr = (uint8_t *)(&(SysTimer->MTIMER));
 
    high0 = __LW(addr + 4);
    low = __LW(addr);
    high = __LW(addr + 4);
    if (high0 != high) {
        low = __LW(addr);
    }
    full = (((uint64_t)high) << 32) | low;
    return full;
#else
    return SysTimer->MTIMER;
#endif
}

References __LW(), and SysTimer.

Referenced by SysTick_Config(), SysTick_HartConfig(), SysTick_HartReload(), and SysTick_Reload().

SysTimer_GetMsipValue()

__STATIC_FORCEINLINE uint32_t SysTimer_GetMsipValue

(

void

)

Get system timer MSIP register value in machine mode.

This function get the system timer MSIP register value.

Returns

Value of Timer MSIP register.

Remarks

• Bit0 is SW interrupt flag. Bit0 is 1 then SW interrupt set. Bit0 is 0 then SW interrupt clear.
• SysTimer_SetSWIRQ
• SysTimer_ClearSWIRQ
• SysTimer_SetMsipValue

Definition at line 440 of file core_feature_timer.h.

{
    unsigned long hartid = SysTimer_GetHartID();
    return SysTimer_GetHartMsipValue(hartid);
}

References SysTimer_GetHartID, and SysTimer_GetHartMsipValue().

SysTimer_SendIPI()

__STATIC_FORCEINLINE void SysTimer_SendIPI

(

unsigned long

hartid

)

send ipi to target hart using Systimer Clint

This function send ipi using clint timer.

Parameters

[in]

hart

target hart

Definition at line 502 of file core_feature_timer.h.

{
    uint8_t *addr = (uint8_t *)(SysTimer_CLINT_MSIP_BASE(hartid));
    __SW(addr, 1);
}

References __SW(), and SysTimer_CLINT_MSIP_BASE.

SysTimer_SetCompareValue()

__STATIC_FORCEINLINE void SysTimer_SetCompareValue

(

uint64_t

value

)

Set system timer compare value in machine mode.

This function set the system Timer compare value in MTIMERCMP register.

Parameters

[in]

value

compare value to set system timer MTIMERCMP register.

Remarks

• Compare value is 64bits wide.
• If compare value is larger than current value timer interrupt generate.
• Modify the load value or compare value less to clear the interrupt.
• __get_hart_id function can only be accessed in machine mode, or else exception will occur.
• SysTimer_GetCompareValue

Definition at line 225 of file core_feature_timer.h.

{
    unsigned long hartid = SysTimer_GetHartID();
    SysTimer_SetHartCompareValue(value, hartid);
}

References SysTimer_GetHartID, and SysTimer_SetHartCompareValue().

Referenced by SysTick_Config(), and SysTick_Reload().

SysTimer_SetControlValue()

__STATIC_FORCEINLINE void SysTimer_SetControlValue

(

uint32_t

mctl

)

Set system timer control value.

This function set the system timer MTIMECTL register value.

Parameters

[in]

mctl

value to set MTIMECTL register

Remarks

• Bit TIMESTOP is used to start and stop timer. Clear TIMESTOP bit to 0 to start timer, otherwise to stop timer.
• Bit CMPCLREN is used to enable auto MTIMER clear to zero when MTIMER >= MTIMERCMP. Clear CMPCLREN bit to 0 to stop auto clear MTIMER feature, otherwise to enable it.
• Bit CLKSRC is used to select timer clock source. Clear CLKSRC bit to 0 to use mtime_toggle_a, otherwise use core_clk_aon
• SysTimer_GetControlValue

Definition at line 314 of file core_feature_timer.h.

{
    SysTimer->MTIMECTL = (mctl & SysTimer_MTIMECTL_Msk);
}

References SysTimer, and SysTimer_MTIMECTL_Msk.

SysTimer_SetHartCompareValue()

__STATIC_FORCEINLINE void SysTimer_SetHartCompareValue	(	uint64_t	value,
		unsigned long	hartid
	)

Set system timer compare value by hartid.

This function set the system Timer compare value in MTIMERCMP register.

Parameters

[in]	value	compare value to set system timer MTIMERCMP register.
[in]	hartid	hart ID, one hart is required to have a known hart ID of 0, other harts ID can be in 1~1023.

Remarks

• Compare value is 64bits wide.
• If compare value is larger than current value timer interrupt generate.
• Modify the load value or compare value less to clear the interrupt.
• In S-mode, hartid can't be get by using __get_hart_id function, so this api suits S-mode particularly.
• SysTimer_GetHartCompareValue

Definition at line 189 of file core_feature_timer.h.

{
    if (hartid == 0) {
#if __RISCV_XLEN == 32
        uint8_t *addr;
        addr = (uint8_t *)(&(SysTimer->MTIMERCMP));
        __SW(addr, -1U);      // prevent load > timecmp
        __SW(addr + 4, (uint32_t)(value >> 32));
        __SW(addr, (uint32_t)(value));
#else
        SysTimer->MTIMERCMP = value;
#endif
    } else {
        uint8_t *addr = (uint8_t *)(SysTimer_CLINT_MTIMECMP_BASE(hartid));
#if __RISCV_XLEN == 32
        __SW(addr, -1U);      // prevent load > timecmp
        __SW(addr + 4, (uint32_t)(value >> 32));
        __SW(addr, (uint32_t)value);
#else
        __SD(addr, value);
#endif
    }
}

References __SW(), SysTimer, and SysTimer_CLINT_MTIMECMP_BASE.

Referenced by SysTick_HartConfig(), SysTick_HartReload(), and SysTimer_SetCompareValue().

SysTimer_SetHartMsipValue()

__STATIC_FORCEINLINE void SysTimer_SetHartMsipValue	(	uint32_t	msip,
		unsigned long	hartid
	)

Set system timer MSIP register value by hartid.

This function set the system timer MSIP register value.

Parameters

[in]	msip	value to set MSIP register
[in]	hartid	hart ID, one hart is required to have a known hart ID of 0, other harts ID can be in 1~1023.

Remarks

• In S-mode, hartid can't be get using __get_hart_id function, so this api suits S-mode particularly.
• SysTimer_GetHartMsipValue

Definition at line 456 of file core_feature_timer.h.

{
    if (hartid == 0) {
        SysTimer->MSIP = (msip & SysTimer_MSIP_Msk);
    } else {
        uint8_t *addr = (uint8_t *)(SysTimer_CLINT_MSIP_BASE(hartid));
        __SW(addr, msip);
    }
}

References __SW(), SysTimer, SysTimer_CLINT_MSIP_BASE, and SysTimer_MSIP_Msk.

Referenced by SysTimer_SetMsipValue().

SysTimer_SetHartSWIRQ()

__STATIC_FORCEINLINE void SysTimer_SetHartSWIRQ

(

unsigned long

hartid

)

Trigger or set software interrupt via system timer by hartid.

This function set the system timer MSIP bit in MSIP register.

Parameters

[in]

hartid

hart ID, one hart is required to have a known hart ID of 0, other harts ID can be in 1~1023.

Remarks

• Set system timer MSIP bit and generate a SW interrupt.
• In S-mode, hartid can't be get by using __get_hart_id function, so this api suits S-mode particularly.
• SysTimer_ClearHartSWIRQ
• SysTimer_GetHartMsipValue

Definition at line 343 of file core_feature_timer.h.

{
    if (hartid == 0) {
        SysTimer->MSIP |= SysTimer_MSIP_MSIP_Msk;
    } else {
        uint8_t *addr = (uint8_t *)(SysTimer_CLINT_MSIP_BASE(hartid));
        __SW(addr, SysTimer_MSIP_MSIP_Msk);
    }
}

References __SW(), SysTimer, SysTimer_CLINT_MSIP_BASE, and SysTimer_MSIP_MSIP_Msk.

Referenced by SysTimer_SetSWIRQ().

SysTimer_SetLoadValue()

__STATIC_FORCEINLINE void SysTimer_SetLoadValue

(

uint64_t

value

)

Set system timer load value.

This function set the system timer load value in MTIMER register.

Parameters

[in]

value

value to set system timer MTIMER register.

Remarks

• Load value is 64bits wide.
• SysTimer_GetLoadValue

Definition at line 132 of file core_feature_timer.h.

{
#if __RISCV_XLEN == 32
    uint8_t *addr;
    addr = (uint8_t *)(&(SysTimer->MTIMER));
    __SW(addr, 0);      // prevent carry
    __SW(addr + 4, (uint32_t)(value >> 32));
    __SW(addr, (uint32_t)(value));
#else
    SysTimer->MTIMER = value;
#endif
}

References __SW(), and SysTimer.

Referenced by SysTick_HartReload(), and SysTick_Reload().

SysTimer_SetMsipValue()

__STATIC_FORCEINLINE void SysTimer_SetMsipValue

(

uint32_t

msip

)

Set system timer MSIP register value in machine mode.

This function set the system timer MSIP register value.

Parameters

[in]

msip

value to set MSIP register SysTimer_GetMsipValue

Definition at line 473 of file core_feature_timer.h.

{
    unsigned long hartid = SysTimer_GetHartID();
    SysTimer_SetHartMsipValue(msip, hartid);
}

References SysTimer_GetHartID, and SysTimer_SetHartMsipValue().

SysTimer_SetSWIRQ()

__STATIC_FORCEINLINE void SysTimer_SetSWIRQ

(

void

)

Trigger or set software interrupt via system timer in machine mode.

This function set the system timer MSIP bit in MSIP register.

Remarks

• Set system timer MSIP bit and generate a SW interrupt.
• SysTimer_ClearSWIRQ
• SysTimer_GetMsipValue

Definition at line 362 of file core_feature_timer.h.

{
    unsigned long hartid = SysTimer_GetHartID();
    SysTimer_SetHartSWIRQ(hartid);
}

References SysTimer_GetHartID, and SysTimer_SetHartSWIRQ().

SysTimer_SoftwareReset()

__STATIC_FORCEINLINE void SysTimer_SoftwareReset

(

void

)

Do software reset request.

This function will do software reset request through MTIMER

• Software need to write SysTimer_MSFRST_KEY to generate software reset request
• The software request flag can be cleared by reset operation to clear

  Remarks

• The software reset is sent to SoC, SoC need to generate reset signal and send back to Core
• This function will not return, it will do while(1) to wait the Core reset happened

Definition at line 489 of file core_feature_timer.h.

{
    SysTimer->MSFTRST = SysTimer_MSFRST_KEY;
    // will reset cpu, never return
    while (1);
}

References SysTimer, and SysTimer_MSFRST_KEY.

SysTimer_Start()

__STATIC_FORCEINLINE void SysTimer_Start

(

void

)

Enable system timer counter running.

Enable system timer counter running by clear TIMESTOP bit in MTIMECTL register.

Definition at line 284 of file core_feature_timer.h.

{
    SysTimer->MTIMECTL &= ~(SysTimer_MTIMECTL_TIMESTOP_Msk);
}

References SysTimer, and SysTimer_MTIMECTL_TIMESTOP_Msk.

SysTimer_Stop()

__STATIC_FORCEINLINE void SysTimer_Stop

(

void

)

Stop system timer counter running.

Stop system timer counter running by set TIMESTOP bit in MTIMECTL register.

Definition at line 295 of file core_feature_timer.h.

{
    SysTimer->MTIMECTL |= SysTimer_MTIMECTL_TIMESTOP_Msk;
}

References SysTimer, and SysTimer_MTIMECTL_TIMESTOP_Msk.