MG32F10x Standard Peripherals Firmware Library
宏定义 | 函数 | 变量
CMSIS Core Instruction Interface

宏定义

#define __NOP   __nop
 No Operation 更多...
 
#define __WFI   __wfi
 Wait For Interrupt 更多...
 
#define __WFE   __wfe
 Wait For Event 更多...
 
#define __SEV   __sev
 Send Event 更多...
 
#define __ISB()
 Instruction Synchronization Barrier 更多...
 
#define __DSB()
 Data Synchronization Barrier 更多...
 
#define __DMB()
 Data Memory Barrier 更多...
 
#define __REV   __rev
 Reverse byte order (32 bit) 更多...
 
#define __ROR   __ror
 Rotate Right in unsigned value (32 bit) 更多...
 
#define __BKPT(value)   __breakpoint(value)
 Breakpoint 更多...
 
#define __CLZ   __clz
 Count leading zeros 更多...
 
#define __CMSIS_GCC_OUT_REG(r)   "=r" (r)
 
#define __CMSIS_GCC_USE_REG(r)   "r" (r)
 
#define __NOP   __builtin_arm_nop
 No Operation 更多...
 
#define __WFI   __builtin_arm_wfi
 Wait For Interrupt 更多...
 
#define __WFE   __builtin_arm_wfe
 Wait For Event 更多...
 
#define __SEV   __builtin_arm_sev
 Send Event 更多...
 
#define __ISB()   __builtin_arm_isb(0xF);
 Instruction Synchronization Barrier 更多...
 
#define __DSB()   __builtin_arm_dsb(0xF);
 Data Synchronization Barrier 更多...
 
#define __DMB()   __builtin_arm_dmb(0xF);
 Data Memory Barrier 更多...
 
#define __REV(value)   __builtin_bswap32(value)
 Reverse byte order (32 bit) 更多...
 
#define __REV16(value)   __ROR(__REV(value), 16)
 Reverse byte order (16 bit) 更多...
 
#define __REVSH(value)   (int16_t)__builtin_bswap16(value)
 Reverse byte order (16 bit) 更多...
 
#define __BKPT(value)   __ASM volatile ("bkpt "#value)
 Breakpoint 更多...
 
#define __RBIT   __builtin_arm_rbit
 Reverse bit order of value 更多...
 
#define __CLZ   (uint8_t)__builtin_clz
 Count leading zeros 更多...
 
#define __CMSIS_GCC_OUT_REG(r)   "=r" (r)
 
#define __CMSIS_GCC_RW_REG(r)   "+r" (r)
 
#define __CMSIS_GCC_USE_REG(r)   "r" (r)
 
#define __NOP()   __ASM volatile ("nop")
 No Operation 更多...
 
#define __WFI()   __ASM volatile ("wfi")
 Wait For Interrupt 更多...
 
#define __WFE()   __ASM volatile ("wfe")
 Wait For Event 更多...
 
#define __SEV()   __ASM volatile ("sev")
 Send Event 更多...
 
#define __BKPT(value)   __ASM volatile ("bkpt "#value)
 Breakpoint 更多...
 
#define __CLZ   (uint8_t)__builtin_clz
 Count leading zeros 更多...
 

函数

 __attribute__ ((section(".rev16_text"))) __STATIC_INLINE __ASM uint32_t __REV16(uint32_t value)
 Reverse byte order (16 bit) 更多...
 
 __attribute__ ((section(".revsh_text"))) __STATIC_INLINE __ASM int16_t __REVSH(int16_t value)
 Reverse byte order (16 bit) 更多...
 
 __attribute__ ((always_inline)) __STATIC_INLINE uint32_t __RBIT(uint32_t value)
 Reverse bit order of value 更多...
 
__STATIC_FORCEINLINE uint32_t __ROR (uint32_t op1, uint32_t op2)
 Rotate Right in unsigned value (32 bit) 更多...
 
__STATIC_FORCEINLINE int32_t __SSAT (int32_t val, uint32_t sat)
 Signed Saturate 更多...
 
__STATIC_FORCEINLINE uint32_t __USAT (int32_t val, uint32_t sat)
 Unsigned Saturate 更多...
 
__STATIC_FORCEINLINE void __ISB (void)
 Instruction Synchronization Barrier 更多...
 
__STATIC_FORCEINLINE void __DSB (void)
 Data Synchronization Barrier 更多...
 
__STATIC_FORCEINLINE void __DMB (void)
 Data Memory Barrier 更多...
 
__STATIC_FORCEINLINE uint32_t __REV (uint32_t value)
 Reverse byte order (32 bit) 更多...
 
__STATIC_FORCEINLINE uint32_t __REV16 (uint32_t value)
 Reverse byte order (16 bit) 更多...
 
__STATIC_FORCEINLINE int16_t __REVSH (int16_t value)
 Reverse byte order (16 bit) 更多...
 
__STATIC_FORCEINLINE uint32_t __RBIT (uint32_t value)
 Reverse bit order of value 更多...
 

变量

uint32_t sat
 

详细描述

Access to dedicated instructions

宏定义说明

◆ __BKPT [1/3]

#define __BKPT (   value)    __breakpoint(value)

Breakpoint

Causes the processor to enter Debug state. Debug tools can use this to investigate system state when the instruction at a particular address is reached.

参数
[in]valueis ignored by the processor. If required, a debugger can use it to store additional information about the breakpoint.

◆ __BKPT [2/3]

#define __BKPT (   value)    __ASM volatile ("bkpt "#value)

Breakpoint

Causes the processor to enter Debug state. Debug tools can use this to investigate system state when the instruction at a particular address is reached.

参数
[in]valueis ignored by the processor. If required, a debugger can use it to store additional information about the breakpoint.

◆ __BKPT [3/3]

#define __BKPT (   value)    __ASM volatile ("bkpt "#value)

Breakpoint

Causes the processor to enter Debug state. Debug tools can use this to investigate system state when the instruction at a particular address is reached.

参数
[in]valueis ignored by the processor. If required, a debugger can use it to store additional information about the breakpoint.

◆ __CLZ [1/3]

#define __CLZ   __clz

Count leading zeros

Counts the number of leading zeros of a data value.

参数
[in]valueValue to count the leading zeros
返回
number of leading zeros in value

◆ __CLZ [2/3]

#define __CLZ   (uint8_t)__builtin_clz

Count leading zeros

Counts the number of leading zeros of a data value.

参数
[in]valueValue to count the leading zeros
返回
number of leading zeros in value

◆ __CLZ [3/3]

#define __CLZ   (uint8_t)__builtin_clz

Count leading zeros

Counts the number of leading zeros of a data value.

参数
[in]valueValue to count the leading zeros
返回
number of leading zeros in value

◆ __DMB [1/2]

#define __DMB (   void)
值:
do {\
__schedule_barrier();\
__dmb(0xF);\
__schedule_barrier();\
} while (0U)

Data Memory Barrier

Ensures the apparent order of the explicit memory operations before and after the instruction, without ensuring their completion.

◆ __DMB [2/2]

#define __DMB (   void)    __builtin_arm_dmb(0xF);

Data Memory Barrier

Ensures the apparent order of the explicit memory operations before and after the instruction, without ensuring their completion.

◆ __DSB [1/2]

#define __DSB (   void)
值:
do {\
__schedule_barrier();\
__dsb(0xF);\
__schedule_barrier();\
} while (0U)

Data Synchronization Barrier

Acts as a special kind of Data Memory Barrier. It completes when all explicit memory accesses before this instruction complete.

◆ __DSB [2/2]

#define __DSB (   void)    __builtin_arm_dsb(0xF);

Data Synchronization Barrier

Acts as a special kind of Data Memory Barrier. It completes when all explicit memory accesses before this instruction complete.

◆ __ISB [1/2]

#define __ISB (   void)
值:
do {\
__schedule_barrier();\
__isb(0xF);\
__schedule_barrier();\
} while (0U)

Instruction Synchronization Barrier

Instruction Synchronization Barrier flushes the pipeline in the processor, so that all instructions following the ISB are fetched from cache or memory, after the instruction has been completed.

◆ __ISB [2/2]

#define __ISB (   void)    __builtin_arm_isb(0xF);

Instruction Synchronization Barrier

Instruction Synchronization Barrier flushes the pipeline in the processor, so that all instructions following the ISB are fetched from cache or memory, after the instruction has been completed.

◆ __NOP [1/3]

#define __NOP   __nop

No Operation

No Operation does nothing. This instruction can be used for code alignment purposes.

◆ __NOP [2/3]

#define __NOP   __builtin_arm_nop

No Operation

No Operation does nothing. This instruction can be used for code alignment purposes.

◆ __NOP [3/3]

#define __NOP ( )    __ASM volatile ("nop")

No Operation

No Operation does nothing. This instruction can be used for code alignment purposes.

◆ __RBIT

#define __RBIT   __builtin_arm_rbit

Reverse bit order of value

Reverses the bit order of the given value.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __REV [1/2]

#define __REV   __rev

Reverse byte order (32 bit)

Reverses the byte order in unsigned integer value. For example, 0x12345678 becomes 0x78563412.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __REV [2/2]

#define __REV (   value)    __builtin_bswap32(value)

Reverse byte order (32 bit)

Reverses the byte order in unsigned integer value. For example, 0x12345678 becomes 0x78563412.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __REV16

#define __REV16 (   value)    __ROR(__REV(value), 16)

Reverse byte order (16 bit)

Reverses the byte order within each halfword of a word. For example, 0x12345678 becomes 0x34127856.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __REVSH

#define __REVSH (   value)    (int16_t)__builtin_bswap16(value)

Reverse byte order (16 bit)

Reverses the byte order in a 16-bit value and returns the signed 16-bit result. For example, 0x0080 becomes 0x8000.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __ROR

#define __ROR   __ror

Rotate Right in unsigned value (32 bit)

Rotate Right (immediate) provides the value of the contents of a register rotated by a variable number of bits.

参数
[in]op1Value to rotate
[in]op2Number of Bits to rotate
返回
Rotated value

◆ __SEV [1/3]

#define __SEV   __sev

Send Event

Send Event is a hint instruction. It causes an event to be signaled to the CPU.

◆ __SEV [2/3]

#define __SEV   __builtin_arm_sev

Send Event

Send Event is a hint instruction. It causes an event to be signaled to the CPU.

◆ __SEV [3/3]

#define __SEV ( )    __ASM volatile ("sev")

Send Event

Send Event is a hint instruction. It causes an event to be signaled to the CPU.

◆ __WFE [1/3]

#define __WFE   __wfe

Wait For Event

Wait For Event is a hint instruction that permits the processor to enter a low-power state until one of a number of events occurs.

◆ __WFE [2/3]

#define __WFE   __builtin_arm_wfe

Wait For Event

Wait For Event is a hint instruction that permits the processor to enter a low-power state until one of a number of events occurs.

◆ __WFE [3/3]

#define __WFE ( )    __ASM volatile ("wfe")

Wait For Event

Wait For Event is a hint instruction that permits the processor to enter a low-power state until one of a number of events occurs.

◆ __WFI [1/3]

#define __WFI   __wfi

Wait For Interrupt

Wait For Interrupt is a hint instruction that suspends execution until one of a number of events occurs.

◆ __WFI [2/3]

#define __WFI   __builtin_arm_wfi

Wait For Interrupt

Wait For Interrupt is a hint instruction that suspends execution until one of a number of events occurs.

◆ __WFI [3/3]

#define __WFI ( )    __ASM volatile ("wfi")

Wait For Interrupt

Wait For Interrupt is a hint instruction that suspends execution until one of a number of events occurs.

函数说明

◆ __attribute__() [1/3]

__attribute__ ( (section(".rev16_text"))  )

Reverse byte order (16 bit)

Reverses the byte order within each halfword of a word. For example, 0x12345678 becomes 0x34127856.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __attribute__() [2/3]

__attribute__ ( (section(".revsh_text"))  )

Reverse byte order (16 bit)

Reverses the byte order in a 16-bit value and returns the signed 16-bit result. For example, 0x0080 becomes 0x8000.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __attribute__() [3/3]

__attribute__ ( (always_inline)  )

Reverse bit order of value

Unsigned Saturate

Signed Saturate

Reverses the bit order of the given value.

参数
[in]valueValue to reverse
返回
Reversed value

Saturates a signed value.

参数
[in]valueValue to be saturated
[in]satBit position to saturate to (1..32)
返回
Saturated value

Saturates an unsigned value.

参数
[in]valueValue to be saturated
[in]satBit position to saturate to (0..31)
返回
Saturated value

◆ __DMB()

__STATIC_FORCEINLINE void __DMB ( void  )

Data Memory Barrier

Ensures the apparent order of the explicit memory operations before and after the instruction, without ensuring their completion.

◆ __DSB()

__STATIC_FORCEINLINE void __DSB ( void  )

Data Synchronization Barrier

Acts as a special kind of Data Memory Barrier. It completes when all explicit memory accesses before this instruction complete.

◆ __ISB()

__STATIC_FORCEINLINE void __ISB ( void  )

Instruction Synchronization Barrier

Instruction Synchronization Barrier flushes the pipeline in the processor, so that all instructions following the ISB are fetched from cache or memory, after the instruction has been completed.

◆ __RBIT()

__STATIC_FORCEINLINE uint32_t __RBIT ( uint32_t  value)

Reverse bit order of value

Reverses the bit order of the given value.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __REV()

__STATIC_FORCEINLINE uint32_t __REV ( uint32_t  value)

Reverse byte order (32 bit)

Reverses the byte order in unsigned integer value. For example, 0x12345678 becomes 0x78563412.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __REV16()

__STATIC_FORCEINLINE uint32_t __REV16 ( uint32_t  value)

Reverse byte order (16 bit)

Reverses the byte order within each halfword of a word. For example, 0x12345678 becomes 0x34127856.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __REVSH()

__STATIC_FORCEINLINE int16_t __REVSH ( int16_t  value)

Reverse byte order (16 bit)

Reverses the byte order in a 16-bit value and returns the signed 16-bit result. For example, 0x0080 becomes 0x8000.

参数
[in]valueValue to reverse
返回
Reversed value

◆ __ROR()

__STATIC_FORCEINLINE uint32_t __ROR ( uint32_t  op1,
uint32_t  op2 
)

Rotate Right in unsigned value (32 bit)

Rotate Right (immediate) provides the value of the contents of a register rotated by a variable number of bits.

参数
[in]op1Value to rotate
[in]op2Number of Bits to rotate
返回
Rotated value

◆ __SSAT()

__STATIC_FORCEINLINE int32_t __SSAT ( int32_t  val,
uint32_t  sat 
)

Signed Saturate

Saturates a signed value.

参数
[in]valueValue to be saturated
[in]satBit position to saturate to (1..32)
返回
Saturated value

◆ __USAT()

__STATIC_FORCEINLINE uint32_t __USAT ( int32_t  val,
uint32_t  sat 
)

Unsigned Saturate

Saturates an unsigned value.

参数
[in]valueValue to be saturated
[in]satBit position to saturate to (0..31)
返回
Saturated value

变量说明

◆ sat

uint32_t sat
初始值:
{
if ((sat >= 1U) && (sat <= 32U))
{
const int32_t max = (int32_t)((1U << (sat - 1U)) - 1U);
const int32_t min = -1 - max ;
if (val > max)
{
return max;
}
else if (val < min)
{
return min;
}
}
return val