2021-07-14

---

前言

---

写新函数时注释模板，放这以后随时用

一、注释模板

代码如下（示例）：

/******************************************************************************
 * Function: ate_start
 * Description:
       Routine of starting ate.
 * Input:
    1) argc: num of params
    2) argv: params
 * Output:
       none
 * Return:
       1) 0: success
       2) otherwise: failed
 * History note:
     > Description: New function
     > Author: ******
     > Date: 2019-12-19 21:30
     > Version: V1.0
 *****************************************************************************/
static int ate_start( int argc, char **argv )
{
    char *tty_name = NULL;
    char cmd[64] = {0};

    if(get_ate_enable())
    {
        ATE_TRACE("ate started, do nothing.\n");
        return 0;
    }

    ATE_TRACE("start ate\n");
    do_system("killall -q loop");
    do_system("killall -q nvram_daemon");
    do_system(RED_STOP);
    do_system(GREEN_STOP);
    do_system(YELLO_STOP);

    /* 获取当前tty名称 */
    tty_name = ttyname(STDOUT_FILENO);
    //printf("tty_name: %s\n", tty_name);
    sprintf(cmd, "button_mode 1>%s &", tty_name);
    do_system(cmd);

    printf("factory mode started\n");

    return 0;
}