diff --git a/arch/arc/core/fatal.c b/arch/arc/core/fatal.c index cc2586dcb4e..247d49b1d1d 100644 --- a/arch/arc/core/fatal.c +++ b/arch/arc/core/fatal.c @@ -52,10 +52,7 @@ const NANO_ESF _default_esf = { * create its own or use a pointer to the global default ESF <_default_esf>. * * @return This function does not return. - * - * \NOMANUAL */ - FUNC_NORETURN void _NanoFatalErrorHandler(unsigned int reason, const NANO_ESF *pEsf) { diff --git a/arch/arc/core/fault.c b/arch/arc/core/fault.c index eac5cac324a..959337fc6f4 100644 --- a/arch/arc/core/fault.c +++ b/arch/arc/core/fault.c @@ -52,10 +52,7 @@ * (short form). * * @return N/A - * - * \NOMANUAL */ - void _FaultDump(const NANO_ESF *esf, int fault) { ARG_UNUSED(esf); @@ -81,10 +78,7 @@ void _FaultDump(const NANO_ESF *esf, int fault) * responsible for implementing the error handling policy. * * @return This function does not return. - * - * \NOMANUAL */ - void _Fault(void) { uint32_t ecr = _arc_v2_aux_reg_read(_ARC_V2_ECR); diff --git a/arch/arc/core/sys_fatal_error_handler.c b/arch/arc/core/sys_fatal_error_handler.c index c7f5daae078..ecba0252df0 100644 --- a/arch/arc/core/sys_fatal_error_handler.c +++ b/arch/arc/core/sys_fatal_error_handler.c @@ -65,8 +65,6 @@ static inline void nonEssentialTaskAbort(void) * @param pEsf pointer to exception stack frame * * @return N/A - * - * \NOMANUAL */ void _SysFatalErrorHandler(unsigned int reason, const NANO_ESF * pEsf) { diff --git a/arch/arc/include/nano_private.h b/arch/arc/include/nano_private.h index 91a41cfa971..121b438a86d 100644 --- a/arch/arc/include/nano_private.h +++ b/arch/arc/include/nano_private.h @@ -234,10 +234,7 @@ static ALWAYS_INLINE void nanoArchInit(void) * the fiber's thread is stored in its struct tcs structure. * * @return N/A - * - * \NOMANUAL */ - static ALWAYS_INLINE void fiberRtnValueSet(struct tcs *fiber, unsigned int value) { fiber->return_value = value; @@ -248,10 +245,7 @@ static ALWAYS_INLINE void fiberRtnValueSet(struct tcs *fiber, unsigned int value * @brief Indicates if kernel is handling interrupt * * @return 1 if interrupt handler is executed, 0 otherwise - * - * \NOMANUAL */ - static ALWAYS_INLINE int _IS_IN_ISR(void) { uint32_t act = _arc_v2_aux_reg_read(_ARC_V2_AUX_IRQ_ACT); diff --git a/arch/arm/core/fatal.c b/arch/arm/core/fatal.c index fbb226d397a..b328f00aff2 100644 --- a/arch/arm/core/fatal.c +++ b/arch/arm/core/fatal.c @@ -65,10 +65,7 @@ const NANO_ESF _default_esf = {0xdeaddead, /* a1 */ * @param pEsf pointer to the exception stack frame * * @return This function does not return. - * - * \NOMANUAL */ - FUNC_NORETURN void _NanoFatalErrorHandler(unsigned int reason, const NANO_ESF *pEsf) { diff --git a/arch/arm/core/fault.c b/arch/arm/core/fault.c index a8d1546e0df..f7ffafd2adf 100644 --- a/arch/arm/core/fault.c +++ b/arch/arm/core/fault.c @@ -60,10 +60,7 @@ * BFAR: 0xff001234 * * @return N/A - * - * \NOMANUAL */ - void _FaultDump(const NANO_ESF *esf, int fault) { int escalation = 0; @@ -111,10 +108,7 @@ void _FaultDump(const NANO_ESF *esf, int fault) * See _FaultDump() for example. * * @return N/A - * - * \NOMANUAL */ - static void _FaultThreadShow(const NANO_ESF *esf) { PR_EXC(" Executing thread ID (thread): 0x%x\n" @@ -130,10 +124,7 @@ static void _FaultThreadShow(const NANO_ESF *esf) * See _FaultDump() for example. * * @return N/A - * - * \NOMANUAL */ - static void _MpuFault(const NANO_ESF *esf, int fromHardFault) { PR_EXC("***** MPU FAULT *****\n"); @@ -164,10 +155,7 @@ static void _MpuFault(const NANO_ESF *esf, int fromHardFault) * See _FaultDump() for example. * * @return N/A - * - * \NOMANUAL */ - static void _BusFault(const NANO_ESF *esf, int fromHardFault) { PR_EXC("***** BUS FAULT *****\n"); @@ -204,10 +192,7 @@ static void _BusFault(const NANO_ESF *esf, int fromHardFault) * See _FaultDump() for example. * * @return N/A - * - * \NOMANUAL */ - static void _UsageFault(const NANO_ESF *esf) { PR_EXC("***** USAGE FAULT *****\n"); @@ -244,10 +229,7 @@ static void _UsageFault(const NANO_ESF *esf) * See _FaultDump() for example. * * @return N/A - * - * \NOMANUAL */ - static void _HardFault(const NANO_ESF *esf) { PR_EXC("***** HARD FAULT *****\n"); @@ -272,10 +254,7 @@ static void _HardFault(const NANO_ESF *esf) * See _FaultDump() for example. * * @return N/A - * - * \NOMANUAL */ - static void _DebugMonitor(const NANO_ESF *esf) { PR_EXC("***** Debug monitor exception (not implemented) *****\n"); @@ -288,10 +267,7 @@ static void _DebugMonitor(const NANO_ESF *esf) * See _FaultDump() for example. * * @return N/A - * - * \NOMANUAL */ - static void _ReservedException(const NANO_ESF *esf, int fault) { PR_EXC("***** %s %d) *****\n", @@ -317,10 +293,7 @@ static void _ReservedException(const NANO_ESF *esf, int fault) * Address: 0xff001234 * * @return N/A - * - * \NOMANUAL */ - static void _FaultDump(const NANO_ESF *esf, int fault) { switch (fault) { @@ -363,10 +336,7 @@ static void _FaultDump(const NANO_ESF *esf, int fault) * @param psp pointer to potential ESF on PSP * * @return This function does not return. - * - * \NOMANUAL */ - void _Fault(const NANO_ESF *msp, const NANO_ESF *psp) { const NANO_ESF *esf = _ScbIsNestedExc() ? msp : psp; @@ -384,10 +354,7 @@ void _Fault(const NANO_ESF *msp, const NANO_ESF *psp) * Turns on the desired hardware faults. * * @return N/A - * - * \NOMANUAL */ - void _FaultInit(void) { _ScbDivByZeroFaultEnable(); diff --git a/arch/arm/core/sys_fatal_error_handler.c b/arch/arm/core/sys_fatal_error_handler.c index f0964dbfd87..9a908275c15 100644 --- a/arch/arm/core/sys_fatal_error_handler.c +++ b/arch/arm/core/sys_fatal_error_handler.c @@ -66,10 +66,7 @@ static inline void nonEssentialTaskAbort(void) * @param pEsf pointer to exception stack frame * * @return N/A - * - * \NOMANUAL */ - void _SysFatalErrorHandler(unsigned int reason, const NANO_ESF * pEsf) { nano_context_type_t curCtx = sys_execution_context_type_get(); diff --git a/arch/arm/core/task_abort.c b/arch/arm/core/task_abort.c index 1f9256da93b..03ae8588178 100644 --- a/arch/arm/core/task_abort.c +++ b/arch/arm/core/task_abort.c @@ -49,10 +49,7 @@ static struct k_args cmd_packet; * - the task encounters a fatal exception * * @return N/A - * - * \NOMANUAL */ - void _TaskAbort(void) { const int taskAbortCode = 1; diff --git a/arch/arm/include/cortex_m/asm_inline_gcc.h b/arch/arm/include/cortex_m/asm_inline_gcc.h index 88f645fbbe2..e8b7e6f44ed 100644 --- a/arch/arm/include/cortex_m/asm_inline_gcc.h +++ b/arch/arm/include/cortex_m/asm_inline_gcc.h @@ -33,10 +33,7 @@ * Obtain and return current value of IPSR register. * * @return the contents of the IPSR register - * - * \NOMANUAL */ - static ALWAYS_INLINE uint32_t _IpsrGet(void) { uint32_t vector; @@ -52,10 +49,7 @@ static ALWAYS_INLINE uint32_t _IpsrGet(void) * Store the value of in MSP register. * * @return N/A - * - * \NOMANUAL */ - static ALWAYS_INLINE void _MspSet(uint32_t msp /* value to store in MSP */ ) { diff --git a/arch/arm/include/cortex_m/exc.h b/arch/arm/include/cortex_m/exc.h index 5ed6914e106..c25ca0587ea 100644 --- a/arch/arm/include/cortex_m/exc.h +++ b/arch/arm/include/cortex_m/exc.h @@ -43,8 +43,6 @@ * interrupt context. * * @return 1 if in ISR, 0 if not. - * - * \NOMANUAL */ static ALWAYS_INLINE int _IsInIsr(void) { @@ -63,10 +61,7 @@ static ALWAYS_INLINE int _IsInIsr(void) * Enable fault exceptions. * * @return N/A - * - * \NOMANUAL */ - static ALWAYS_INLINE void _ExcSetup(void) { _ScbExcPrioSet(_EXC_PENDSV, _EXC_PRIO(0xff)); diff --git a/arch/arm/include/cortex_m/stack.h b/arch/arm/include/cortex_m/stack.h index fe4d5ee94b8..a8b22ad4461 100644 --- a/arch/arm/include/cortex_m/stack.h +++ b/arch/arm/include/cortex_m/stack.h @@ -52,10 +52,7 @@ extern char _interrupt_stack[CONFIG_ISR_STACK_SIZE]; * pointer) register, and switched to automatically when taking an exception. * * @return N/A - * - * \NOMANUAL */ - static ALWAYS_INLINE void _InterruptStackSetup(void) { uint32_t msp = __GET_MSP(); diff --git a/arch/arm/include/nano_private.h b/arch/arm/include/nano_private.h index 066a0b41e0d..19cf76908aa 100644 --- a/arch/arm/include/nano_private.h +++ b/arch/arm/include/nano_private.h @@ -179,10 +179,7 @@ static ALWAYS_INLINE void nanoArchInit(void) * @param value is the value to set as a return value * * @return N/A - * - * \NOMANUAL */ - static ALWAYS_INLINE void fiberRtnValueSet(struct tcs *fiber, unsigned int value) { diff --git a/arch/x86/core/fatal.c b/arch/x86/core/fatal.c index 1c8a408b246..e1fb73af0ab 100644 --- a/arch/x86/core/fatal.c +++ b/arch/x86/core/fatal.c @@ -67,10 +67,7 @@ const NANO_ESF _default_esf = { * @param pEsf pointer to the exception stack frame * * @return This function does not return. - * - * \NOMANUAL */ - FUNC_NORETURN void _NanoFatalErrorHandler(unsigned int reason, const NANO_ESF *pEsf) { diff --git a/arch/x86/core/intstub.S b/arch/x86/core/intstub.S index eb4ae79c21b..4e03599bf5e 100644 --- a/arch/x86/core/intstub.S +++ b/arch/x86/core/intstub.S @@ -87,10 +87,7 @@ entering and exiting a C interrupt handler. * C function prototype: * * void _IntEnt (void); - * - * NOMANUAL */ - SECTION_FUNC(TEXT, _IntEnt) /* @@ -252,10 +249,7 @@ BRANCH_LABEL(_HandleIdle) * C function prototype: * * void _IntExit (void); - * - * NOMANUAL */ - SECTION_FUNC(TEXT, _IntExit) cli /* disable interrupts */ @@ -409,10 +403,7 @@ BRANCH_LABEL(nestedInterrupt) * in the EFLAGS register upon execution of the handler, * thus _SpuriousIntNoErrCodeHandler()/_SpuriousIntHandler() shall be * invoked with interrupts disabled. - * - * NOMANUAL */ - SECTION_FUNC(TEXT, _SpuriousIntNoErrCodeHandler) pushl $0 /* push dummy err code onto stk */ diff --git a/arch/x86/core/sys_fatal_error_handler.c b/arch/x86/core/sys_fatal_error_handler.c index 252f3506111..1bde145bd10 100644 --- a/arch/x86/core/sys_fatal_error_handler.c +++ b/arch/x86/core/sys_fatal_error_handler.c @@ -52,10 +52,7 @@ * @param pEsf the pointer to the exception stack frame * * @return This function does not return. - * - * \NOMANUAL */ - FUNC_NORETURN void _SysFatalErrorHandler(unsigned int reason, const NANO_ESF * pEsf) { diff --git a/arch/x86/core/thread.c b/arch/x86/core/thread.c index 14c2a8a098d..73101891739 100644 --- a/arch/x86/core/thread.c +++ b/arch/x86/core/thread.c @@ -62,10 +62,7 @@ void _thread_entry_wrapper(_thread_entry_t, _thread_arg_t, * @param options thread options: USE_FP, USE_SSE * * @return N/A - * - * \NOMANUAL */ - static void _new_thread_internal(char *pStackMem, unsigned stackSize, int priority, unsigned options) { @@ -250,10 +247,7 @@ static void _new_thread_internal(char *pStackMem, unsigned stackSize, * _thread_entry after it has done its work. * * @return this routine does NOT return. - * - * \NOMANUAL */ - __asm__("\t.globl _thread_entry\n" "\t.section .text\n" "_thread_entry_wrapper:\n" /* should place this func .S file and use @@ -284,10 +278,7 @@ __asm__("\t.globl _thread_entry\n" * * * @return opaque pointer to initialized TCS structure - * - * \NOMANUAL */ - void _new_thread(char *pStackMem, unsigned stackSize, _thread_entry_t pEntry, void *parameter1, void *parameter2, void *parameter3, int priority, unsigned options) diff --git a/arch/x86/include/asm_inline_gcc.h b/arch/x86/include/asm_inline_gcc.h index 9e9d58cd511..efaae3aa10c 100644 --- a/arch/x86/include/asm_inline_gcc.h +++ b/arch/x86/include/asm_inline_gcc.h @@ -36,10 +36,7 @@ NANO_CPU_EXC_CONNECT_NO_ERR(handler, vector, 0) * @brief Return the current value of the EFLAGS register * * @return the EFLAGS register. - * - * \NOMANUAL */ - static inline unsigned int EflagsGet(void) { unsigned int eflags; /* EFLAGS register contents */ @@ -65,7 +62,6 @@ static inline unsigned int EflagsGet(void) * * @return N/A */ - static inline void _FpAccessDisable(void) { void *tempReg; @@ -91,7 +87,6 @@ static inline void _FpAccessDisable(void) * * @return N/A */ - static inline void _do_fp_ctx_save(int flags, void *preemp_float_reg) { #ifdef CONFIG_SSE @@ -121,7 +116,6 @@ static inline void _do_fp_ctx_save(int flags, void *preemp_float_reg) * * @return N/A */ - static inline void _do_fp_ctx_init(int flags) { /* initialize x87 FPU */ diff --git a/arch/x86/include/nano_private.h b/arch/x86/include/nano_private.h index 906f14e9124..5828f509e4c 100644 --- a/arch/x86/include/nano_private.h +++ b/arch/x86/include/nano_private.h @@ -759,10 +759,7 @@ extern unsigned int _interrupt_vectors_allocated[]; * function calls. * * @return N/A - * - * \NOMANUAL */ - static inline void nanoArchInit(void) { extern void *__isr___SpuriousIntHandler; @@ -811,10 +808,7 @@ static inline void nanoArchInit(void) * thus the fibers context is stored in its TCS. * * @return N/A - * - * \NOMANUAL */ - static inline void fiberRtnValueSet(struct tcs *fiber, unsigned int value) { /* write into 'eax' slot created in _Swap() entry */ diff --git a/drivers/pci/pci.c b/drivers/pci/pci.c index 3684f206286..b9bc90e6936 100644 --- a/drivers/pci/pci.c +++ b/drivers/pci/pci.c @@ -176,10 +176,7 @@ static inline int pci_bar_config_get(union pci_addr_reg pci_ctrl_addr, * @return -1 on error, 0 if 32 bit BAR retrieved or 1 if 64 bit BAR retrieved * * NOTE: Routine does not set up parameters for 64 bit BARS, they are ignored. - * - * \NOMANUAL */ - static inline int pci_bar_params_get(union pci_addr_reg pci_ctrl_addr, struct pci_dev_info *dev_info) { @@ -225,10 +222,7 @@ static inline int pci_bar_params_get(union pci_addr_reg pci_ctrl_addr, * @brief Scan the specified PCI device for all sub functions * * @return 1 if a device has been found, 0 otherwise. - * - * \NOMANUAL */ - static inline int pci_dev_scan(union pci_addr_reg pci_ctrl_addr, struct pci_dev_info *dev_info) { @@ -350,10 +344,7 @@ void pci_bus_scan_init(void) * * @return 1 on success, 0 otherwise. On success, dev_info is filled in with * currently found device information - * - * \NOMANUAL */ - int pci_bus_scan(struct pci_dev_info *dev_info) { union pci_addr_reg pci_ctrl_addr; diff --git a/drivers/timer/arcv2_timer0.c b/drivers/timer/arcv2_timer0.c index 3e9da62c560..e88fd01e403 100644 --- a/drivers/timer/arcv2_timer0.c +++ b/drivers/timer/arcv2_timer0.c @@ -65,10 +65,7 @@ static uint32_t clock_accumulated_count; * - enabling interrupt generation. * * @return N/A - * - * \NOMANUAL */ - static ALWAYS_INLINE void enable( uint32_t count /* interrupt triggers when up-counter reaches this value */ ) @@ -90,8 +87,6 @@ static ALWAYS_INLINE void enable( * value is the 'time' elapsed from the starting count (assumed to be 0). * * @return the current counter value - * - * \NOMANUAL */ static ALWAYS_INLINE uint32_t count_get(void) { @@ -106,8 +101,6 @@ static ALWAYS_INLINE uint32_t count_get(void) * value to which the timer will count up to. * * @return the limit value - * - * \NOMANUAL */ static ALWAYS_INLINE uint32_t limit_get(void) { @@ -122,10 +115,7 @@ static ALWAYS_INLINE uint32_t limit_get(void) * event is pushed onto the microkernel stack. * * @return N/A - * - * \NOMANUAL */ - void _timer_int_handler(void *unused) { uint32_t zero_ip_bit = _ARC_V2_TMR_CTRL_NH | _ARC_V2_TMR_CTRL_IE; @@ -149,7 +139,6 @@ void _timer_int_handler(void *unused) * * @return 0 */ - int _sys_clock_driver_init(struct device *device) { int irq = CONFIG_ARCV2_TIMER0_INT_LVL; @@ -185,7 +174,6 @@ int _sys_clock_driver_init(struct device *device) * * @return up counter of elapsed clock cycles */ - uint32_t _sys_clock_cycle_get(void) { return (clock_accumulated_count + count_get()); @@ -204,7 +192,6 @@ FUNC_ALIAS(_sys_clock_cycle_get, task_cycle_get_32, uint32_t); * * @return N/A */ - void timer_disable(void) { unsigned int key; /* interrupt lock level */ diff --git a/drivers/timer/cortex_m_systick.c b/drivers/timer/cortex_m_systick.c index d17ffd9b403..0f201f41369 100644 --- a/drivers/timer/cortex_m_systick.c +++ b/drivers/timer/cortex_m_systick.c @@ -120,10 +120,7 @@ static unsigned char idle_mode = IDLE_NOT_TICKLESS; * This routine disables the systick counter. * * @return N/A - * - * \NOMANUAL */ - static ALWAYS_INLINE void sysTickStop(void) { union __stcsr reg; @@ -149,10 +146,7 @@ static ALWAYS_INLINE void sysTickStop(void) * This routine enables the systick counter. * * @return N/A - * - * \NOMANUAL */ - static ALWAYS_INLINE void sysTickStart(void) { union __stcsr reg; @@ -178,8 +172,6 @@ static ALWAYS_INLINE void sysTickStart(void) * interrupt. * * @return the current counter value - * - * \NOMANUAL */ static ALWAYS_INLINE uint32_t sysTickCurrentGet(void) { @@ -193,8 +185,6 @@ static ALWAYS_INLINE uint32_t sysTickCurrentGet(void) * This routine returns the value from the reload value register. * * @return the counter's initial count/wraparound value - * - * \NOMANUAL */ static ALWAYS_INLINE uint32_t sysTickReloadGet(void) { @@ -212,10 +202,7 @@ static ALWAYS_INLINE uint32_t sysTickReloadGet(void) * Note that the value given is assumed to be valid (i.e., count < (1<<24)). * * @return N/A - * - * \NOMANUAL */ - static ALWAYS_INLINE void sysTickReloadSet( uint32_t count /* count from which timer is to count down */ ) @@ -241,10 +228,7 @@ static ALWAYS_INLINE void sysTickReloadSet( * system operation) or _real_timer_int_handler (when GDB_INFO is enabled). * * @return N/A - * - * \NOMANUAL */ - void _TIMER_INT_HANDLER(void *unused) { ARG_UNUSED(unused); @@ -382,10 +366,7 @@ void _TIMER_INT_HANDLER(void *unused) * more elapsed ticks during a "tickless idle". * * @return N/A - * - * \NOMANUAL */ - static void sysTickTicklessIdleInit(void) { /* enable counter, disable interrupt and set clock src to system clock @@ -461,7 +442,6 @@ static void sysTickTicklessIdleInit(void) * * @return N/A */ - void _timer_idle_enter(int32_t ticks /* system ticks */ ) { @@ -519,7 +499,6 @@ void _timer_idle_enter(int32_t ticks /* system ticks */ * * @return N/A */ - void _timer_idle_exit(void) { uint32_t count; /* timer's current count register value */ @@ -650,7 +629,6 @@ int _sys_clock_driver_init(struct device *device) * systick counter is a 24-bit down counter which is reset to "reload" value * once it reaches 0. */ - uint32_t _sys_clock_cycle_get(void) { return clock_accumulated_count + (__scs.systick.strvr - __scs.systick.stcvr); @@ -670,7 +648,6 @@ FUNC_ALIAS(_sys_clock_cycle_get, task_cycle_get_32, uint32_t); * * @return N/A */ - void timer_disable(void) { unsigned int key; /* interrupt lock level */ diff --git a/drivers/timer/hpet.c b/drivers/timer/hpet.c index 30b102ac713..aa7dab1abd9 100644 --- a/drivers/timer/hpet.c +++ b/drivers/timer/hpet.c @@ -216,10 +216,7 @@ static int stale_irq_check; * significant word is being retrieved (as per HPET documentation). * * @return current 64-bit counter value - * - * \NOMANUAL */ - static uint64_t _hpetMainCounterAtomic(void) { uint32_t highBits; @@ -243,10 +240,7 @@ static uint64_t _hpetMainCounterAtomic(void) * is pushed onto the microkernel stack. * * @return N/A - * - * \NOMANUAL */ - void _timer_int_handler(void *unused) { ARG_UNUSED(unused); diff --git a/drivers/timer/loapic_timer.c b/drivers/timer/loapic_timer.c index 6ead3d32675..e468c3bedc4 100644 --- a/drivers/timer/loapic_timer.c +++ b/drivers/timer/loapic_timer.c @@ -158,10 +158,7 @@ extern struct nano_stack _k_command_stack; * This routine sets the timer for periodic mode. * * @return N/A - * - * \NOMANUAL */ - static inline void periodic_mode_set(void) { *_REG_TIMER |= LOAPIC_TIMER_PERIODIC; @@ -177,10 +174,7 @@ static inline void periodic_mode_set(void) * This routine disables the LOAPIC timer by masking it. * * @return N/A - * - * \NOMANUAL */ - static inline void timer_interrupt_mask(void) { *_REG_TIMER |= LOAPIC_LVT_MASKED; @@ -196,10 +190,7 @@ static inline void timer_interrupt_mask(void) * This routine enables the LOAPIC timer by unmasking it. * * @return N/A - * - * \NOMANUAL */ - static inline void timer_interrupt_unmask(void) { *_REG_TIMER &= ~LOAPIC_LVT_MASKED; @@ -214,10 +205,7 @@ static inline void timer_interrupt_unmask(void) * Note that setting the value to zero stops the timer. * * @return N/A - * - * \NOMANUAL */ - static inline void initial_count_register_set( uint32_t count /* count from which timer is to count down */ ) @@ -233,10 +221,7 @@ static inline void initial_count_register_set( * This routine sets the timer for one shot mode. * * @return N/A - * - * \NOMANUAL */ - static inline void one_shot_mode_set(void) { *_REG_TIMER &= ~LOAPIC_TIMER_PERIODIC; @@ -251,10 +236,7 @@ static inline void one_shot_mode_set(void) * external bus frequency. * * @return N/A - * - * \NOMANUAL */ - static inline void divide_configuration_register_set(void) { *_REG_TIMER_CFG = (*_REG_TIMER_CFG & ~0xf) | LOAPIC_TIMER_DIVBY_1; @@ -269,8 +251,6 @@ static inline void divide_configuration_register_set(void) * interrupt. * * @return N/A - * - * \NOMANUAL */ static inline uint32_t current_count_register_get(void) { @@ -285,8 +265,6 @@ static inline uint32_t current_count_register_get(void) * This routine gets the value from the initial count register. * * @return N/A - * - * \NOMANUAL */ static inline uint32_t initial_count_register_get(void) { @@ -303,7 +281,6 @@ static inline uint32_t initial_count_register_get(void) * * @return N/A */ - void _timer_int_handler(void *unused /* parameter is not used */ ) { @@ -399,10 +376,7 @@ void _timer_int_handler(void *unused /* parameter is not used */ * "tickless idle". * * @return N/A - * - * \NOMANUAL */ - static void tickless_idle_init(void) { /* @@ -426,7 +400,6 @@ static void tickless_idle_init(void) * * @return N/A */ - void _timer_idle_enter(int32_t ticks /* system ticks */ ) { @@ -482,7 +455,6 @@ void _timer_idle_enter(int32_t ticks /* system ticks */ * * @return N/A */ - void _timer_idle_exit(void) { uint32_t remaining_cycles; @@ -578,7 +550,6 @@ void _timer_idle_exit(void) * * @return 0 */ - int _sys_clock_driver_init(struct device *device) { ARG_UNUSED(device); @@ -617,7 +588,6 @@ int _sys_clock_driver_init(struct device *device) * * @return up counter of elapsed clock cycles */ - uint32_t _sys_clock_cycle_get(void) { uint32_t val; /* system clock value */ @@ -655,7 +625,6 @@ FUNC_ALIAS(_sys_clock_cycle_get, task_cycle_get_32, uint32_t); * * @return N/A */ - void timer_disable(void) { unsigned int key; /* interrupt lock level */ diff --git a/include/toolchain.h b/include/toolchain.h index 2dad077da1f..5208dd9cf29 100644 --- a/include/toolchain.h +++ b/include/toolchain.h @@ -20,8 +20,6 @@ * DESCRIPTION * This file contains various macros to abstract compiler capabilities that * utilize toolchain specific attributes and/or pragmas. - * - * \NOMANUAL */ #ifndef _TOOLCHAIN_H diff --git a/include/toolchain/common.h b/include/toolchain/common.h index 38fda6b9361..b1905ce45a0 100644 --- a/include/toolchain/common.h +++ b/include/toolchain/common.h @@ -19,8 +19,6 @@ /* * DESCRIPTION * Macros to abstract compiler capabilities (common to all toolchains). - * - * \NOMANUAL */ /* diff --git a/include/toolchain/gcc.h b/include/toolchain/gcc.h index ad0a39c6a97..5c834ac79ba 100644 --- a/include/toolchain/gcc.h +++ b/include/toolchain/gcc.h @@ -19,10 +19,7 @@ /* * DESCRIPTION * Macros to abstract compiler capabilities for GCC toolchain. - * - * \NOMANUAL */ - #include #define FUNC_ALIAS(real_func, new_alias, return_type) \ diff --git a/kernel/nanokernel/idle.c b/kernel/nanokernel/idle.c index 8e36a9b5578..7b038c27f8f 100644 --- a/kernel/nanokernel/idle.c +++ b/kernel/nanokernel/idle.c @@ -38,8 +38,6 @@ * @param ticks the number of ticks to idle * * @return N/A - * - * \NOMANUAL */ void nano_cpu_set_idle(int32_t ticks) { diff --git a/kernel/nanokernel/include/gen_offset.h b/kernel/nanokernel/include/gen_offset.h index b62c12168ad..10dc2694844 100644 --- a/kernel/nanokernel/include/gen_offset.h +++ b/kernel/nanokernel/include/gen_offset.h @@ -78,8 +78,6 @@ * 0000000c A __tNANO_nested_OFFSET * 00000000 A __tNANO_fiber_OFFSET * 00000004 A __tNANO_task_OFFSET - * - * \NOMANUAL */ #ifndef _GEN_OFFSET_H diff --git a/kernel/nanokernel/nano_lifo.c b/kernel/nanokernel/nano_lifo.c index fb1a15c3c9b..f55029ff7b3 100644 --- a/kernel/nanokernel/nano_lifo.c +++ b/kernel/nanokernel/nano_lifo.c @@ -193,8 +193,6 @@ void *nano_task_lifo_get_wait(struct nano_lifo *lifo) * @param lifo LIFO from which to receive. * * @return Pointer to first element in the list - * - * \NOMANUAL */ void *_nano_fiber_lifo_get_panic(struct nano_lifo *lifo) { diff --git a/samples/microkernel/benchmark/app_kernel/src/event_b.c b/samples/microkernel/benchmark/app_kernel/src/event_b.c index ee6ec330290..09578bbd6da 100644 --- a/samples/microkernel/benchmark/app_kernel/src/event_b.c +++ b/samples/microkernel/benchmark/app_kernel/src/event_b.c @@ -44,10 +44,7 @@ int example_handler (int event); * @brief Event signal speed test * * @return N/A - * - * \NOMANUAL */ - void event_test(void) { int nReturn; @@ -168,10 +165,7 @@ void event_test(void) * This variable is used in the main test. * * @return 1 - * - * \NOMANUAL */ - int example_handler (int event) { nEventValue = event + 1; diff --git a/samples/microkernel/benchmark/app_kernel/src/fifo_b.c b/samples/microkernel/benchmark/app_kernel/src/fifo_b.c index c3523bc0324..a53b6bd5f90 100644 --- a/samples/microkernel/benchmark/app_kernel/src/fifo_b.c +++ b/samples/microkernel/benchmark/app_kernel/src/fifo_b.c @@ -25,10 +25,7 @@ * @brief Queue transfer speed test * * @return N/A - * - * \NOMANUAL */ - void queue_test(void) { uint32_t et; /* elapsed time */ diff --git a/samples/microkernel/benchmark/app_kernel/src/fifo_r.c b/samples/microkernel/benchmark/app_kernel/src/fifo_r.c index 0fbd517e4a0..d8905a8570e 100644 --- a/samples/microkernel/benchmark/app_kernel/src/fifo_r.c +++ b/samples/microkernel/benchmark/app_kernel/src/fifo_r.c @@ -27,10 +27,7 @@ * @brief Data receive task * * @return N/A - * - * \NOMANUAL */ - void dequtask(void) { int x, i; diff --git a/samples/microkernel/benchmark/app_kernel/src/mailbox_b.c b/samples/microkernel/benchmark/app_kernel/src/mailbox_b.c index 45931bfd1b7..97f76f9248c 100644 --- a/samples/microkernel/benchmark/app_kernel/src/mailbox_b.c +++ b/samples/microkernel/benchmark/app_kernel/src/mailbox_b.c @@ -81,10 +81,7 @@ void mailbox_put(uint32_t size, int count, uint32_t *time); * @brief Mailbox transfer speed test * * @return N/A - * - * \NOMANUAL */ - void mailbox_test(void) { uint32_t putsize; @@ -131,15 +128,12 @@ void mailbox_test(void) * * @brief Write the number of data chunks into the mailbox * - * @return N/A - * * @param size The size of the data chunk. * @param count Number of data chunks. * @param time The total time. * - * \NOMANUAL + * @return N/A */ - void mailbox_put(uint32_t size, int count, uint32_t *time) { int i; diff --git a/samples/microkernel/benchmark/app_kernel/src/mailbox_r.c b/samples/microkernel/benchmark/app_kernel/src/mailbox_r.c index 5ac7b2fe699..a2cec929b42 100644 --- a/samples/microkernel/benchmark/app_kernel/src/mailbox_r.c +++ b/samples/microkernel/benchmark/app_kernel/src/mailbox_r.c @@ -37,10 +37,7 @@ int mailbox_get(kmbox_t mailbox,int size,int count,unsigned int* time); * @brief Receive task * * @return N/A - * - * \NOMANUAL */ - void mailrecvtask(void) { int getsize; @@ -77,10 +74,7 @@ void mailrecvtask(void) * @param size Size of each data portion. * @param count Number of data portions. * @param time Resulting time. - * - * \NOMANUAL */ - int mailbox_get(kmbox_t mailbox, int size, int count, unsigned int* time) { int i; diff --git a/samples/microkernel/benchmark/app_kernel/src/master.c b/samples/microkernel/benchmark/app_kernel/src/master.c index f679de84b17..31e9a4ca3bb 100644 --- a/samples/microkernel/benchmark/app_kernel/src/master.c +++ b/samples/microkernel/benchmark/app_kernel/src/master.c @@ -52,10 +52,7 @@ uint32_t tm_off; * @brief Check for keypress * * @return 1 when a keyboard key is pressed, or 0 if no keyboard support - * - * \NOMANUAL */ - int kbhit(void) { return 0; @@ -70,10 +67,7 @@ int kbhit(void) * * @param continuously Run test till the user presses the key. * @param autorun Expect user input. - * - * \NOMANUAL */ - void init_output(int *continuously, int *autorun) { ARG_UNUSED(continuously); @@ -90,10 +84,7 @@ void init_output(int *continuously, int *autorun) * @brief Close output for the test * * @return N/A - * - * \NOMANUAL */ - void output_close(void) { } @@ -105,13 +96,10 @@ void output_close(void) /** * * @brief Perform all selected benchmarks + * see config.h to select or to unselect * * @return N/A - * - * \NOMANUAL */ - -/* see config.h to select or to unselect*/ void BenchTask(void) { int autorun = 0, continuously = 0; @@ -158,10 +146,7 @@ void BenchTask(void) * @brief Dummy test * * @return N/A - * - * \NOMANUAL */ - void dummy_test(void) { return; diff --git a/samples/microkernel/benchmark/app_kernel/src/memmap_b.c b/samples/microkernel/benchmark/app_kernel/src/memmap_b.c index f403d088617..2b12afe9d29 100644 --- a/samples/microkernel/benchmark/app_kernel/src/memmap_b.c +++ b/samples/microkernel/benchmark/app_kernel/src/memmap_b.c @@ -27,10 +27,7 @@ * @brief Memory map get/free test * * @return N/A - * - * \NOMANUAL */ - void memorymap_test(void) { uint32_t et; /* elapsed time */ diff --git a/samples/microkernel/benchmark/app_kernel/src/mempool_b.c b/samples/microkernel/benchmark/app_kernel/src/mempool_b.c index a77c9a09e52..5e9d8744264 100644 --- a/samples/microkernel/benchmark/app_kernel/src/mempool_b.c +++ b/samples/microkernel/benchmark/app_kernel/src/mempool_b.c @@ -25,10 +25,7 @@ * @brief Memory pool get/free test * * @return N/A - * - * \NOMANUAL */ - void mempool_test(void) { uint32_t et; /* elapsed time */ diff --git a/samples/microkernel/benchmark/app_kernel/src/mutex_b.c b/samples/microkernel/benchmark/app_kernel/src/mutex_b.c index 973283cce5c..df541b04549 100644 --- a/samples/microkernel/benchmark/app_kernel/src/mutex_b.c +++ b/samples/microkernel/benchmark/app_kernel/src/mutex_b.c @@ -25,10 +25,7 @@ * @brief Mutex lock/unlock test * * @return N/A - * - * \NOMANUAL */ - void mutex_test(void) { uint32_t et; /* elapsed time */ diff --git a/samples/microkernel/benchmark/app_kernel/src/nop_b.c b/samples/microkernel/benchmark/app_kernel/src/nop_b.c index a16aea2cac2..3bee948f9a1 100644 --- a/samples/microkernel/benchmark/app_kernel/src/nop_b.c +++ b/samples/microkernel/benchmark/app_kernel/src/nop_b.c @@ -29,10 +29,7 @@ extern void _task_nop(void); * @brief Kernel entry timing test * * @return N/A - * - * \NOMANUAL */ - void call_test(void) { uint32_t et; /* Elapsed Time */ diff --git a/samples/microkernel/benchmark/app_kernel/src/pipe_b.c b/samples/microkernel/benchmark/app_kernel/src/pipe_b.c index 9e3872dd800..a2414be9c3c 100644 --- a/samples/microkernel/benchmark/app_kernel/src/pipe_b.c +++ b/samples/microkernel/benchmark/app_kernel/src/pipe_b.c @@ -98,10 +98,7 @@ int pipeput(kpipe_t pipe, K_PIPE_OPTION * @brief Test the pipes transfer speed * * @return N/A - * - * \NOMANUAL */ - void pipe_test(void) { uint32_t putsize; @@ -199,10 +196,7 @@ void pipe_test(void) * @param size Data chunk size. * @param count Number of data chunks. * @param time Total write time. - * - * \NOMANUAL */ - int pipeput(kpipe_t pipe, K_PIPE_OPTION option, int size, int count, uint32_t *time) { int i; diff --git a/samples/microkernel/benchmark/app_kernel/src/pipe_r.c b/samples/microkernel/benchmark/app_kernel/src/pipe_r.c index d10c831bd1d..27537f4ec5d 100644 --- a/samples/microkernel/benchmark/app_kernel/src/pipe_r.c +++ b/samples/microkernel/benchmark/app_kernel/src/pipe_r.c @@ -38,10 +38,7 @@ int pipeget(kpipe_t pipe, K_PIPE_OPTION option, * @brief Receive task * * @return N/A - * - * \NOMANUAL */ - void piperecvtask(void) { int getsize; @@ -95,10 +92,7 @@ void piperecvtask(void) * @param size Data chunk size. * @param count Number of data chunks. * @param time Total write time. - * - * \NOMANUAL */ - int pipeget(kpipe_t pipe, K_PIPE_OPTION option, int size, int count, unsigned int* time) { diff --git a/samples/microkernel/benchmark/app_kernel/src/receiver.c b/samples/microkernel/benchmark/app_kernel/src/receiver.c index 2253aba32f3..7ac172da129 100644 --- a/samples/microkernel/benchmark/app_kernel/src/receiver.c +++ b/samples/microkernel/benchmark/app_kernel/src/receiver.c @@ -39,10 +39,7 @@ void piperecvtask(void); * @brief Main function of the task that receives data in the test * * @return N/A - * - * \NOMANUAL */ - void recvtask(void) { /* order must be compatible with master.c ! */ diff --git a/samples/microkernel/benchmark/app_kernel/src/sema_b.c b/samples/microkernel/benchmark/app_kernel/src/sema_b.c index 64ee7d5301e..099b3c46148 100644 --- a/samples/microkernel/benchmark/app_kernel/src/sema_b.c +++ b/samples/microkernel/benchmark/app_kernel/src/sema_b.c @@ -26,10 +26,7 @@ * @brief Semaphore signal speed test * * @return N/A - * - * \NOMANUAL */ - void sema_test(void) { uint32_t et; /* elapsed Time */ diff --git a/samples/microkernel/benchmark/app_kernel/src/sema_r.c b/samples/microkernel/benchmark/app_kernel/src/sema_r.c index 94abd7a8dfc..2cb3682213e 100644 --- a/samples/microkernel/benchmark/app_kernel/src/sema_r.c +++ b/samples/microkernel/benchmark/app_kernel/src/sema_r.c @@ -28,10 +28,7 @@ * @brief Receive task (Wait task) * * @return N/A - * - * \NOMANUAL */ - void waittask(void) { int i; diff --git a/samples/microkernel/benchmark/footprint/src/microkernel_footprint.c b/samples/microkernel/benchmark/footprint/src/microkernel_footprint.c index ef44f2ef21c..5bd9da7721f 100644 --- a/samples/microkernel/benchmark/footprint/src/microkernel_footprint.c +++ b/samples/microkernel/benchmark/footprint/src/microkernel_footprint.c @@ -119,7 +119,6 @@ static pfunc func_array[] = { * * @return N/A */ - void dummyIsr(void *unused) { ARG_UNUSED(unused); @@ -136,7 +135,6 @@ void dummyIsr(void *unused) * * @return N/A */ - static void isrDummyIntStub(void *unused) { ARG_UNUSED(unused); @@ -155,10 +153,7 @@ static void isrDummyIntStub(void *unused) * (Gdb can be used to observe the counter as it increases.) * * @return N/A - * - * \NOMANUAL */ - void fgTaskEntry(void) { #ifdef TEST_max diff --git a/samples/microkernel/benchmark/latency_measure/src/main.c b/samples/microkernel/benchmark/latency_measure/src/main.c index 5346d5902ee..dc135bdb5d1 100644 --- a/samples/microkernel/benchmark/latency_measure/src/main.c +++ b/samples/microkernel/benchmark/latency_measure/src/main.c @@ -35,10 +35,7 @@ int errorCount = 0; /* track number of errors */ * @brief Test latency of nanokernel * * @return N/A - * - * \NOMANUAL */ - void nanoTest(void) { PRINT_NANO_BANNER(); @@ -66,10 +63,7 @@ void nanoTest(void) * @brief Nanokernel-only testing entry point * * @return N/A - * - * \NOMANUAL */ - void main(void) { bench_test_init(); @@ -93,10 +87,7 @@ void microTaskSwitchYield(void); * @brief Test latency of microkernel * * @return N/A - * - * \NOMANUAL */ - void microTest(void) { PRINT_MICRO_BANNER(); @@ -123,10 +114,7 @@ void microTest(void) * @brief Microkernel testing entry point * * @return N/A - * - * \NOMANUAL */ - void microMain(void) { bench_test_init(); diff --git a/samples/microkernel/benchmark/latency_measure/src/micro_int_to_task.c b/samples/microkernel/benchmark/latency_measure/src/micro_int_to_task.c index abc82e5f59e..4631292e00c 100644 --- a/samples/microkernel/benchmark/latency_measure/src/micro_int_to_task.c +++ b/samples/microkernel/benchmark/latency_measure/src/micro_int_to_task.c @@ -39,10 +39,7 @@ static uint32_t timestamp; * The interrupt handler gets the second timestamp. * * @return N/A - * - * \NOMANUAL */ - static void latencyTestIsr(void *unused) { ARG_UNUSED(unused); @@ -59,10 +56,7 @@ static void latencyTestIsr(void *unused) * gets the first timestamp and invokes the software interrupt. * * @return N/A - * - * \NOMANUAL */ - static void makeInt(void) { initSwInterrupt(latencyTestIsr); @@ -80,10 +74,7 @@ static void makeInt(void) * @brief The test main function * * @return 0 on success - * - * \NOMANUAL */ - int microIntToTask(void) { PRINT_FORMAT(" 1- Measure time to switch from ISR to back to" diff --git a/samples/microkernel/benchmark/latency_measure/src/micro_int_to_task_evt.c b/samples/microkernel/benchmark/latency_measure/src/micro_int_to_task_evt.c index eb2016d174e..2132f90f95e 100644 --- a/samples/microkernel/benchmark/latency_measure/src/micro_int_to_task_evt.c +++ b/samples/microkernel/benchmark/latency_measure/src/micro_int_to_task_evt.c @@ -41,10 +41,7 @@ static uint32_t timestamp = 0; * The interrupt handler gets the second timestamp. * * @return N/A - * - * \NOMANUAL */ - static void latencyTestIsr(void *unused) { ARG_UNUSED(unused); @@ -62,10 +59,7 @@ static void latencyTestIsr(void *unused) * software interrupt * * @return 0 on success - * - * \NOMANUAL */ - void microInt(void) { task_sem_take_wait(INTSEMA); @@ -79,10 +73,7 @@ void microInt(void) * @brief The test main function * * @return 0 on success - * - * \NOMANUAL */ - int microIntToTaskEvt(void) { PRINT_FORMAT(" 2- Measure time from ISR to executing a different task" diff --git a/samples/microkernel/benchmark/latency_measure/src/micro_sema_lock_release.c b/samples/microkernel/benchmark/latency_measure/src/micro_sema_lock_release.c index 5b8d526e7e6..d6fc57719ea 100644 --- a/samples/microkernel/benchmark/latency_measure/src/micro_sema_lock_release.c +++ b/samples/microkernel/benchmark/latency_measure/src/micro_sema_lock_release.c @@ -47,10 +47,7 @@ static uint32_t timestamp; * acquires them in order to measure the necessary time. * * @return 0 on success - * - * \NOMANUAL */ - int microSemaLockUnlock(void) { int i; @@ -97,10 +94,7 @@ int microSemaLockUnlock(void) * unlocks to measure the necessary time. * * @return 0 on success - * - * \NOMANUAL */ - int microMutexLockUnlock(void) { int i; diff --git a/samples/microkernel/benchmark/latency_measure/src/micro_task_switch_yield.c b/samples/microkernel/benchmark/latency_measure/src/micro_task_switch_yield.c index 3adc390de67..1cf776dcdc3 100644 --- a/samples/microkernel/benchmark/latency_measure/src/micro_task_switch_yield.c +++ b/samples/microkernel/benchmark/latency_measure/src/micro_task_switch_yield.c @@ -43,10 +43,7 @@ static uint32_t helper_task_iterations = 0; * This task is define in .mdef as SEMYIELDTSK * * @return N/A - * - * \NOMANUAL */ - void yieldingTask(void) { while (helper_task_iterations < NB_OF_YIELD) { @@ -60,10 +57,7 @@ void yieldingTask(void) * @brief Entry point for task context switch using yield test * * @return N/A - * - * \NOMANUAL */ - void microTaskSwitchYield(void) { uint32_t iterations = 0; diff --git a/samples/microkernel/benchmark/latency_measure/src/nano_ctx_switch.c b/samples/microkernel/benchmark/latency_measure/src/nano_ctx_switch.c index 7fab836abc2..c198b0a61c4 100644 --- a/samples/microkernel/benchmark/latency_measure/src/nano_ctx_switch.c +++ b/samples/microkernel/benchmark/latency_measure/src/nano_ctx_switch.c @@ -58,10 +58,7 @@ static volatile int ctxSwitchBalancer = 0; * gets the first timestamp and invokes the software interrupt. * * @return N/A - * - * \NOMANUAL */ - static void fiberOne(void) { nano_fiber_sem_take_wait(&syncSema); @@ -82,10 +79,7 @@ static void fiberOne(void) * the semaphore, fiber measures the time. * * @return 0 on success - * - * \NOMANUAL */ - static void fiberTwo(void) { nano_fiber_sem_give(&syncSema); @@ -101,10 +95,7 @@ static void fiberTwo(void) * @brief The test main function * * @return 0 on success - * - * \NOMANUAL */ - int nanoCtxSwitch(void) { PRINT_FORMAT(" 4- Measure average context switch time between fibers"); diff --git a/samples/microkernel/benchmark/latency_measure/src/nano_int.c b/samples/microkernel/benchmark/latency_measure/src/nano_int.c index fc8d85fd141..8fc545f9131 100644 --- a/samples/microkernel/benchmark/latency_measure/src/nano_int.c +++ b/samples/microkernel/benchmark/latency_measure/src/nano_int.c @@ -41,10 +41,7 @@ static uint32_t timestamp; * The interrupt handler gets the second timestamp. * * @return N/A - * - * \NOMANUAL */ - static void latencyTestIsr(void *unused) { ARG_UNUSED(unused); @@ -60,10 +57,7 @@ static void latencyTestIsr(void *unused) * gets the first timestamp and invokes the software interrupt. * * @return N/A - * - * \NOMANUAL */ - static void fiberInt(void) { initSwInterrupt(latencyTestIsr); @@ -76,10 +70,7 @@ static void fiberInt(void) * @brief The test main function * * @return 0 on success - * - * \NOMANUAL */ - int nanoIntLatency(void) { PRINT_FORMAT(" 1- Measure time to switch from fiber to ISR execution"); diff --git a/samples/microkernel/benchmark/latency_measure/src/nano_int_lock_unlock.c b/samples/microkernel/benchmark/latency_measure/src/nano_int_lock_unlock.c index c8cd033f806..cf732085dc8 100644 --- a/samples/microkernel/benchmark/latency_measure/src/nano_int_lock_unlock.c +++ b/samples/microkernel/benchmark/latency_measure/src/nano_int_lock_unlock.c @@ -40,10 +40,7 @@ static uint32_t timestamp = 0; * @brief The test main function * * @return 0 on success - * - * \NOMANUAL */ - int nanoIntLockUnlock(void) { int i; diff --git a/samples/microkernel/benchmark/latency_measure/src/nano_int_to_fiber.c b/samples/microkernel/benchmark/latency_measure/src/nano_int_to_fiber.c index f8571ed2dc0..789fd9cb0a7 100644 --- a/samples/microkernel/benchmark/latency_measure/src/nano_int_to_fiber.c +++ b/samples/microkernel/benchmark/latency_measure/src/nano_int_to_fiber.c @@ -43,10 +43,7 @@ static uint32_t timestamp; * The interrupt handler gets the second timestamp. * * @return N/A - * - * \NOMANUAL */ - static void latencyTestIsr(void *unused) { ARG_UNUSED(unused); @@ -63,10 +60,7 @@ static void latencyTestIsr(void *unused) * gets the first timestamp and invokes the software interrupt. * * @return N/A - * - * \NOMANUAL */ - static void fiberInt(void) { setSwInterrupt(latencyTestIsr); @@ -84,10 +78,7 @@ static void fiberInt(void) * @brief The test main function * * @return 0 on success - * - * \NOMANUAL */ - int nanoIntToFiber(void) { PRINT_FORMAT(" 2- Measure time to switch from ISR back to interrupted" diff --git a/samples/microkernel/benchmark/latency_measure/src/nano_int_to_fiber_sem.c b/samples/microkernel/benchmark/latency_measure/src/nano_int_to_fiber_sem.c index 2efc247c502..83c92ed57d6 100644 --- a/samples/microkernel/benchmark/latency_measure/src/nano_int_to_fiber_sem.c +++ b/samples/microkernel/benchmark/latency_measure/src/nano_int_to_fiber_sem.c @@ -54,10 +54,7 @@ static uint32_t timestamp = 0; * The interrupt handler gets the second timestamp. * * @return N/A - * - * \NOMANUAL */ - static void latencyTestIsr(void *unused) { ARG_UNUSED(unused); @@ -74,10 +71,7 @@ static void latencyTestIsr(void *unused) * gets the first timestamp and invokes the software interrupt. * * @return N/A - * - * \NOMANUAL */ - static void fiberInt(void) { setSwInterrupt(latencyTestIsr); @@ -93,10 +87,7 @@ static void fiberInt(void) * the semaphore, fiber measures the time. * * @return N/A - * - * \NOMANUAL */ - static void fiberWaiter(void) { nano_fiber_sem_take_wait(&testSema); @@ -108,10 +99,7 @@ static void fiberWaiter(void) * @brief The test main function * * @return 0 on success - * - * \NOMANUAL */ - int nanoIntToFiberSem(void) { PRINT_FORMAT(" 3- Measure time from ISR to executing a different fiber" diff --git a/samples/microkernel/benchmark/latency_measure/src/raise_int.c b/samples/microkernel/benchmark/latency_measure/src/raise_int.c index 134b8209380..4eb45d945e7 100644 --- a/samples/microkernel/benchmark/latency_measure/src/raise_int.c +++ b/samples/microkernel/benchmark/latency_measure/src/raise_int.c @@ -1382,8 +1382,6 @@ static void (*intFPtr[256])(void) = { * value passed to it (which is essentially the interrupt vector number). * * @return N/A - * - * \NOMANUAL */ void raiseInt(uint8_t id) { @@ -1400,10 +1398,7 @@ void raiseInt(uint8_t id) * Trigger via NVIC. is the IRQ number. * * @return N/A - * - * \NOMANUAL */ - void raiseInt(uint8_t id) { _NvicSwInterruptTrigger((unsigned int)id); diff --git a/samples/microkernel/benchmark/latency_measure/src/utils.c b/samples/microkernel/benchmark/latency_measure/src/utils.c index 8982ddf7fac..07d47cd4295 100644 --- a/samples/microkernel/benchmark/latency_measure/src/utils.c +++ b/samples/microkernel/benchmark/latency_measure/src/utils.c @@ -44,10 +44,7 @@ char tmpString[TMP_STRING_SIZE]; * the current interrupt service routine and stub code memory block. * * @return the allocated interrupt vector - * - * \NOMANUAL */ - int initSwInterrupt(ptestIsr pIsrHdlr) { vector = irq_connect(NANO_SOFT_IRQ, IRQ_PRIORITY, pIsrHdlr, @@ -66,10 +63,7 @@ int initSwInterrupt(ptestIsr pIsrHdlr) * initialized and connected by initSwInterrupt. * * @return N/A - * - * \NOMANUAL */ - void setSwInterrupt(ptestIsr pIsrHdlr) { extern void _irq_handler_set(unsigned int irq, void (*old)(void *arg), @@ -88,8 +82,6 @@ void setSwInterrupt(ptestIsr pIsrHdlr) * initialized and connected by initSwInterrupt. * * @return N/A - * - * \NOMANUAL */ void raiseIntFunc(void) { diff --git a/samples/microkernel/benchmark/latency_measure/src/utils.h b/samples/microkernel/benchmark/latency_measure/src/utils.h index 7f7125a69ca..2b74a7d96dc 100644 --- a/samples/microkernel/benchmark/latency_measure/src/utils.h +++ b/samples/microkernel/benchmark/latency_measure/src/utils.h @@ -48,10 +48,7 @@ extern int errorCount; * @brief Print dash line * * @return N/A - * - * \NOMANUAL */ - static inline void printDashLine(void) { PRINTF("|-----------------------------------------------------------------" @@ -109,10 +106,7 @@ typedef void (*ptestIsr) (void *unused); * the current interrupt service routine and stub code memory block. * * @return the allocated interrupt vector - * - * \NOMANUAL */ - int initSwInterrupt(ptestIsr pIsrHdlr); /** @@ -124,8 +118,5 @@ int initSwInterrupt(ptestIsr pIsrHdlr); * initialized and connected by initSwInterrupt. * * @return N/A - * - * \NOMANUAL */ - void setSwInterrupt(ptestIsr pIsrHdlr); diff --git a/samples/microkernel/test/test_task_irq/src/raise_int.c b/samples/microkernel/test/test_task_irq/src/raise_int.c index 523d3cce867..54f183f15b5 100644 --- a/samples/microkernel/test/test_task_irq/src/raise_int.c +++ b/samples/microkernel/test/test_task_irq/src/raise_int.c @@ -1382,8 +1382,6 @@ static void (*intFPtr[256])(void) = { * value passed to it (which is essentially the interrupt vector number). * * @return N/A - * - * \NOMANUAL */ void raiseInt(uint8_t id) { @@ -1400,10 +1398,7 @@ void raiseInt(uint8_t id) * Trigger via NVIC. is the IRQ number. * * @return N/A - * - * \NOMANUAL */ - void raiseInt(uint8_t id) { _NvicSwInterruptTrigger((unsigned int)id); diff --git a/samples/microkernel/test/test_tickless/src/timestamps.c b/samples/microkernel/test/test_tickless/src/timestamps.c index b7b523b76ea..08634afbd98 100644 --- a/samples/microkernel/test/test_tickless/src/timestamps.c +++ b/samples/microkernel/test/test_tickless/src/timestamps.c @@ -64,10 +64,7 @@ Platform-specific timestamp support for the tickless idle test. * This routine initializes the timestamp timer. * * @return N/A - * - * \NOMANUAL */ - void _TimestampOpen(void) { /* QEMU does not currently support the 32-bit timer modes of the GPTM */ @@ -96,10 +93,7 @@ void _TimestampOpen(void) * This routine returns the timestamp value. * * @return timestamp value - * - * \NOMANUAL */ - uint32_t _TimestampRead(void) { static uint32_t lastTimerVal = 0; @@ -132,10 +126,7 @@ uint32_t _TimestampRead(void) * This routine releases the timestamp timer. * * @return N/A - * - * \NOMANUAL */ - void _TimestampClose(void) { @@ -179,10 +170,7 @@ void _TimestampClose(void) * This routine initializes the timestamp timer. * * @return N/A - * - * \NOMANUAL */ - void _TimestampOpen(void) { /* enable timer access */ @@ -216,10 +204,7 @@ void _TimestampOpen(void) * This routine returns the timestamp value. * * @return timestamp value - * - * \NOMANUAL */ - uint32_t _TimestampRead(void) { static uint32_t lastPrescale = 0; @@ -253,10 +238,7 @@ uint32_t _TimestampRead(void) * This routine releases the timestamp timer. * * @return N/A - * - * \NOMANUAL */ - void _TimestampClose(void) { _TIMESTAMP_STATUS = 0x0; /* disable counter */ diff --git a/samples/nanokernel/benchmark/sys_kernel/src/lifo.c b/samples/nanokernel/benchmark/sys_kernel/src/lifo.c index 38ea3ab323b..7d6e1a778dc 100644 --- a/samples/nanokernel/benchmark/sys_kernel/src/lifo.c +++ b/samples/nanokernel/benchmark/sys_kernel/src/lifo.c @@ -28,10 +28,7 @@ static struct nano_fifo nanoFifo_sync; /* for synchronization */ * @brief Initialize LIFOs for the test * * @return N/A - * - * \NOMANUAL */ - void lifo_test_init(void) { nano_lifo_init(&nanoLifo1); @@ -47,10 +44,7 @@ void lifo_test_init(void) * @param par2 Number of test loops. * * @return N/A - * - * \NOMANUAL */ - void lifo_fiber1(int par1, int par2) { int i; @@ -87,10 +81,7 @@ void lifo_fiber1(int par1, int par2) * @param par2 Number of test cycles. * * @return N/A - * - * \NOMANUAL */ - void lifo_fiber2(int par1, int par2) { int i; @@ -119,10 +110,7 @@ void lifo_fiber2(int par1, int par2) * @param par2 Number of test loops. * * @return N/A - * - * \NOMANUAL */ - void lifo_fiber3(int par1, int par2) { int i; @@ -150,10 +138,7 @@ void lifo_fiber3(int par1, int par2) * @brief The main test entry * * @return 1 if success and 0 on failure - * - * \NOMANUAL */ - int lifo_test(void) { uint32_t t; diff --git a/samples/nanokernel/benchmark/sys_kernel/src/mwfifo.c b/samples/nanokernel/benchmark/sys_kernel/src/mwfifo.c index 14491bdca00..abadec99f6d 100644 --- a/samples/nanokernel/benchmark/sys_kernel/src/mwfifo.c +++ b/samples/nanokernel/benchmark/sys_kernel/src/mwfifo.c @@ -29,10 +29,7 @@ static struct nano_fifo nanoFifo_sync; /* for synchronization */ * @brief Initialize FIFOs for the test * * @return N/A - * - * \NOMANUAL */ - void fifo_test_init(void) { nano_fifo_init(&nanoFifo1); @@ -44,14 +41,11 @@ void fifo_test_init(void) * * @brief Fifo test fiber * - * @return N/A - * * @param par1 Ignored parameter. * @param par2 Number of test loops. * - * \NOMANUAL + * @return N/A */ - void fifo_fiber1(int par1, int par2) { int i; @@ -76,14 +70,11 @@ void fifo_fiber1(int par1, int par2) * * @brief Fifo test fiber * - * @return N/A - * * @param par1 Address of the counter. * @param par2 Number of test cycles. * - * \NOMANUAL + * @return N/A */ - void fifo_fiber2(int par1, int par2) { int i; @@ -109,14 +100,11 @@ void fifo_fiber2(int par1, int par2) * * @brief Fifo test fiber * - * @return N/A - * * @param par1 Address of the counter. * @param par2 Number of test cycles. * - * \NOMANUAL + * @return N/A */ - void fifo_fiber3(int par1, int par2) { int i; @@ -145,10 +133,7 @@ void fifo_fiber3(int par1, int par2) * @brief The main test entry * * @return 1 if success and 0 on failure - * - * \NOMANUAL */ - int fifo_test(void) { uint32_t t; diff --git a/samples/nanokernel/benchmark/sys_kernel/src/sema.c b/samples/nanokernel/benchmark/sys_kernel/src/sema.c index d91ad8e71b6..acca52bb34a 100644 --- a/samples/nanokernel/benchmark/sys_kernel/src/sema.c +++ b/samples/nanokernel/benchmark/sys_kernel/src/sema.c @@ -26,10 +26,7 @@ struct nano_sem nanoSem2; * @brief Initialize semaphores for the test * * @return N/A - * - * \NOMANUAL */ - void sema_test_init(void) { nano_sem_init(&nanoSem1); @@ -45,10 +42,7 @@ void sema_test_init(void) * @param par2 Number of test loops. * * @return N/A - * - * \NOMANUAL */ - void sema_fiber1(int par1, int par2) { int i; @@ -70,10 +64,7 @@ void sema_fiber1(int par1, int par2) * @param par2 Number of test cycles. * * @return N/A - * - * \NOMANUAL */ - void sema_fiber2(int par1, int par2) { int i; @@ -94,10 +85,7 @@ void sema_fiber2(int par1, int par2) * @param par2 Number of test cycles. * * @return N/A - * - * \NOMANUAL */ - void sema_fiber3(int par1, int par2) { int i; @@ -118,10 +106,7 @@ void sema_fiber3(int par1, int par2) * @brief The main test entry * * @return 1 if success and 0 on failure - * - * \NOMANUAL */ - int sema_test(void) { uint32_t t; diff --git a/samples/nanokernel/benchmark/sys_kernel/src/stack.c b/samples/nanokernel/benchmark/sys_kernel/src/stack.c index 5c2b415ce29..0695b587996 100644 --- a/samples/nanokernel/benchmark/sys_kernel/src/stack.c +++ b/samples/nanokernel/benchmark/sys_kernel/src/stack.c @@ -30,9 +30,7 @@ uint32_t stack2[2]; * * @return N/A * - * \NOMANUAL */ - void stack_test_init(void) { nano_stack_init(&nano_stack_1, stack1); @@ -49,9 +47,7 @@ void stack_test_init(void) * * @return N/A * - * \NOMANUAL */ - void stack_fiber1(int par1, int par2) { int i; @@ -85,9 +81,7 @@ void stack_fiber1(int par1, int par2) * * @return N/A * - * \NOMANUAL */ - void stack_fiber2(int par1, int par2) { int i; @@ -115,9 +109,7 @@ void stack_fiber2(int par1, int par2) * * @return N/A * - * \NOMANUAL */ - void stack_fiber3(int par1, int par2) { int i; @@ -145,9 +137,7 @@ void stack_fiber3(int par1, int par2) * * @return 1 if success and 0 on failure * - * \NOMANUAL */ - int stack_test(void) { uint32_t t; diff --git a/samples/nanokernel/benchmark/sys_kernel/src/syskernel.c b/samples/nanokernel/benchmark/sys_kernel/src/syskernel.c index 45de55cb93a..137d6859c0c 100644 --- a/samples/nanokernel/benchmark/sys_kernel/src/syskernel.c +++ b/samples/nanokernel/benchmark/sys_kernel/src/syskernel.c @@ -64,8 +64,6 @@ uint32_t tm_off; * Routine does necessary preparations for the test to start * * @return N/A - * - * \NOMANUAL */ void begin_test(void) { @@ -84,10 +82,7 @@ void begin_test(void) * * @param i Number of tests. * @param t Time in ticks for the whole test. - * - * \NOMANUAL */ - int check_result(int i, uint32_t t) { /* @@ -124,10 +119,7 @@ int check_result(int i, uint32_t t) * @brief Check for a key press * * @return 1 when a keyboard key is pressed, or 0 if no keyboard support - * - * \NOMANUAL */ - int kbhit(void) { return 0; @@ -138,11 +130,9 @@ int kbhit(void) * * @brief Prepares the test output * - * @return N/A - * * @param continuously Run test till the user presses the key. * - * \NOMANUAL + * @return N/A */ void init_output(int *continuously) @@ -161,10 +151,7 @@ void init_output(int *continuously) * @brief Close output for the test * * @return N/A - * - * \NOMANUAL */ - void output_close(void) { } @@ -174,10 +161,7 @@ void output_close(void) * @brief Perform all selected benchmarks * * @return N/A - * - * \NOMANUAL */ - #ifdef CONFIG_MICROKERNEL void SysKernelBench(void) #else