RT-Thread-RT-Thread的书写格式能否美观点。RT-Thread问答社区

RT-Thread的书写格式能否美观点。

发布于 2015-04-27 19:56:10 浏览：3965 订阅该版

最近学操作系统，浏览了几个系统的原代码，感觉RT-Thread的书写格式有点乱，
虽说不影响性能但阅读的时候看着不舒服。个人感觉好的代码不但要内在美，
外表也应该让人看着舒心。

RT-Thread的书写格式

```
#include <rthw.h>
#include <rtthread.h>

static rt_tick_t rt_tick = 0;

extern void rt_timer_check(void);

/**
 * This function will init system tick and set it to zero.
 * @ingroup SystemInit
 *
 * @deprecated since 1.1.0, this function does not need to be invoked
 * in the system initialization.
 */
void rt_system_tick_init(void)
{
}

/**
 * @addtogroup Clock
 */

/*@{*/

/**
 * This function will return current tick from operating system startup
 *
 * @return current tick
 */
rt_tick_t rt_tick_get(void)
{
    /* return the global tick */
    return rt_tick;
}
RTM_EXPORT(rt_tick_get);

/**
 * This function will set current tick
 */
void rt_tick_set(rt_tick_t tick)
{
    rt_base_t level;

level = rt_hw_interrupt_disable();
    rt_tick = tick;
    rt_hw_interrupt_enable(level);
}

/**
 * This function will notify kernel there is one tick passed. Normally,
 * this function is invoked by clock ISR.
 */
void rt_tick_increase(void)
{
    struct rt_thread *thread;

/* increase the global tick */
    ++ rt_tick;

/* check time slice */
    thread = rt_thread_self();

-- thread->remaining_tick;
    if (thread->remaining_tick == 0)
    {
        /* change to initialized tick */
        thread->remaining_tick = thread->init_tick;

/* yield */
        rt_thread_yield();
    }

/* check timer */
    rt_timer_check();
}

/**
 * This function will calculate the tick from millisecond.
 *
 * @param ms the specified millisecond
 *
 * @return the calculated tick
 */
rt_tick_t rt_tick_from_millisecond(rt_uint32_t ms)
{
    /* return the calculated tick */
    return (RT_TICK_PER_SECOND * ms + 999) / 1000;
}
RTM_EXPORT(rt_tick_from_millisecond);

/*@}*/

```

Trochili的代码书写格式，*有点错位。

```
/*************************************************************************************************
 *                                     Trochili RTOS Kernel                                                                                                            *
 *                             Copyright(C) 2012,2013,2014 LIUXUMING                                                                                    *
 *                                        www.trochili.com                                                                                                              *
 *************************************************************************************************/
#include "trochili.h"

/*************************************************************************************************
 *  功能：设置线程属性                                                                                                                                                   *
 *  参数：(1) pThread  线程结构地址                                                                                                                                *
 *          (2) property 线程属性数值                                                                                                                                 *
 *  返回：无                                                                                                                                                                 *
 *  说明：                                                                                                                                                                    *
 *************************************************************************************************/
void TclSetThreadProperty(TThread* pThread, TProperty property)
{
    TCL_ASSERT((pThread != (TThread*)0), "");
    property &= THREAD_AUTHORITY_ALL;
    xThreadSetProperty(pThread, property);
}

/*************************************************************************************************
 *  功能：获得线程属性                                                                           *
 *  参数：(1) pThread 线程结构地址                                                               *
 *        (2) property  线程属性变量指针                                                         *
 *  返回：无                                                                                     *
 *  说明：                                                                                       *
 *************************************************************************************************/
void TclGetThreadProperty(TThread* pThread, TProperty* pProperty)
{
    TCL_ASSERT((pThread != (TThread*)0), "");
    TCL_ASSERT((pProperty != (TProperty*)0), "");
    xThreadGetProperty(pThread, pProperty);
}

/*************************************************************************************************
 *  功能：内核启动API                                                                            *
 *  参数：无                                                                                     *
 *  返回：无                                                                                     *
 *  说明：这是内核的启动函数                                                                     *
 *************************************************************************************************/
void TclStartKernel(void)
{
    xKernelStart();
}

/*************************************************************************************************
 *  功能：设置用户入口函数API                                                                    *
 *  参数：(1) pEntry 用户初始入口函数                                                            *
 *  返回：无                                                                                     *
 *  说明：                                                                                       *
 *************************************************************************************************/
void TclSetUserEntry(TUserMainEntry pEntry)
{
    TCL_ASSERT((pEntry != (TUserMainEntry)0), "");
    xKernelSetUserEntry(pEntry);
}

/*************************************************************************************************
 *  功能：设置处理器初始化函数API                                                                *
 *  参数：(1) pEntry 处理器初始入口函数                                                          *
 *  返回：无                                                                                     *
 *  说明：                                                                                       *
 *************************************************************************************************/
void TclSetCpuEntry(TCpuSetupEntry pEntry)
{
    TCL_ASSERT((pEntry != (TCpuSetupEntry)0), "");
    xKernelSetCpuEntry(pEntry);
}

/*************************************************************************************************
 *  功能：设置板级初始化函数API                                                                  *
 *  参数：(1) pEntry 板极初始入口函数                                                            *
 *  返回：无                                                                                     *
 *  说明：                                                                                       *
 *************************************************************************************************/
void TclSetBoardEntry(TBoardSetupEntry pEntry)
{
    TCL_ASSERT((pEntry != (TBoardSetupEntry)0), "");
    xKernelSetBoardEntry(pEntry);
}

/*************************************************************************************************
 *  功能：设置板级调试打印函数API                                                                *
 *  参数：(1) pRoutine 字符串打印函数                                                            *
 *  返回：无                                                                                     *
 *  说明：                                                                                       *
 *************************************************************************************************/
void TclSetTraceRoutine(TTraceRoutine pRoutine)
{
    TCL_ASSERT((pRoutine != (TTraceRoutine)0), "");
    xKernelSetTraceRoutine(pRoutine);
}

#if ((TCL_HOOKS_ENABLE)&&(TCL_IDLE_HOOK_ENABLE))
/*************************************************************************************************
 *  功能：设置IDEL线程Hook函数                                                                   *
 *  参数：(1) pEntry Idle线程的HOOK函数                                                          *
 *  返回：无                                                                                     *
 *  说明：                                                                                       *
 *************************************************************************************************/
void TclSetIdleHookEntry(TIdleHookEntry pEntry)
{
    TCL_ASSERT((pEntry != (TIdleHookEntry)0), "");
    xKernelSetIdelHookEntry(pEntry);
}

/*************************************************************************************************
 *  功能：清除IDEL线程Hook函数                                                                   *
 *  参数：无                                                                                     *
 *  返回：无                                                                                     *
 *  说明：                                                                                       *
 *************************************************************************************************/
void TclCleanIdleHookEntry(void)
{
    xKernelCleanIdelHookEntry();
}

#endif

/*************************************************************************************************
 *  功能：设置中断向量函数                                                                       *
 *  参数：(1) vector   中断向量编号                                                              *
 *        (2) property 中断向量描述符属性                                                        *
 *        (3) pISR     ISR处理函数                                                               *
 *        (4) pDsr     ISR处理函数                                                               *
 *        (5) devid    挂接在中断向量上的设备ID                                                  *
 *        (6) data     应用提供的回调数据                                                        *
 *  返回：无                                                                                     *
 *  说明：                                                                                       *
 *************************************************************************************************/
void TclSetIntVector(TVector vector, TProperty property, TISR pISR, TThread* pDsr, TWord data)
{
    TCL_ASSERT((vector < TCL_INT_VECTOR_NR), "");
    TCL_ASSERT((pISR != (TISR)0), "");

xKernelSetIntVector(vector, property, pISR, pDsr, data);
}
```

注释有点错位