【Contiki学习】01.Contiki-stm32系统下实现serial-shell功能

一，背景介绍

之前通过网上收集资料（资料后期整理之后会在博客分享），在stm32上面跑通了，就是实现了简单的点灯程序，以及串口输出。

但是后期开发使用肯定需要用到shell，经过一番折腾后小有收获。

在这说一下开发环境：IAR+stm32vet6(ST官方库3.5+contiki3.0)

二，准备工作

1，在contiki源码中按照目录提取以下文件：

ps. stm32_shell.c是自行添加的代码

三，源码分析

1，先看一下main函数：

int main()
{
  dbg_setup_uart();
  led_init();
  printf("Initialising\r\n");
  
  clock_init();
  process_init();
  //shell serial_line 初始化
  uart1_set_input(serial_line_input_byte);
  serial_line_init();
  //
  process_start(&etimer_process, NULL);
  autostart_start(autostart_processes);
  printf("Processes running\r\n");
  while(1) {
    do 
    {
    } 
    while(process_run() > 0);
    idle_count++;
    /* Idle! */
    /* Stop processor clock */
    /* asm("wfi"::); */ 
  }
  return 0;
}

需要注意的是：

  //shell serial_line 初始化
  uart1_set_input(serial_line_input_byte);
  serial_line_init();
  //

2，usrt1_set_input定义在串口底层驱动里面

static int (* uart1_input_handler)(unsigned char c);


void uart1_set_input(int (* input)(unsigned char c))
{
    uart1_input_handler = input;
}

先建立一个函数指针：

static int (* uart1_input_handler)(unsigned char c);

再通过

uart1_set_input(serial_line_input_byte);

将（*uart1_input_handler）指向 serial_line_input_byte()函数，

这样就可以通过调用uart1_input_handler();将串口接到的数据导入serial_line中，从而可以通过serial_line_process进程进行命令分析做出相应处理。

uart1_input_handler();的调用写在串口中断中即可：

void USART1_IRQHandler(void)
{
      ENERGEST_ON(ENERGEST_TYPE_IRQ);
      if(USART_GetITStatus(USART1, USART_IT_RXNE) != RESET)
    {
	if(uart1_input_handler != NULL)
	{
 		/* Read one byte from the receive data register */
		uint8_t buf = USART_ReceiveData(USART1);
		uart1_input_handler(buf);
	}		
    }
	ENERGEST_OFF(ENERGEST_TYPE_IRQ);
}

3，通过上面的处理已经把串口接收到的数据导入serial_line中了，当然串口配置初始化在这就不用多说了，

接下来就是要把shell进程加入系统了：

调用serial_shell_init()函数即可

定义：

void
serial_shell_init(void)
{
  process_start(&serial_shell_process, NULL);
}

就是开启serial_shell_process进程，但是我这边新建立一个进程，用于后续其他自定义的shell命令的初始化：

#include "contiki.h"
#include "shell.h"
#include "serial-shell.h"

PROCESS(stm32_shell_process, "STM32 Contiki Shell");

PROCESS_THREAD(stm32_shell_process, ev, data)
{
    PROCESS_BEGIN();

    serial_shell_init();//初始化shell

    PROCESS_END();
}

然后再将改进程加入main函数即可，

到这边就已经完成了shell的功能，可以通过串口看见

发送 help(加回车)

这是一些默认的命令，你也可以自己定义一些命令，通过阅读shell部分的源码进一步了解原理。

4，在shell.c中可以看见关于上面打印出来的命令的定义，其实每个shell命令对应一个process，

PROCESS(help_command_process, "help");
SHELL_COMMAND(help_command, "help", "help: shows this help",
	      &help_command_process);
SHELL_COMMAND(question_command, "?", "?: shows this help",
	      &help_command_process);
PROCESS(shell_killall_process, "killall");
SHELL_COMMAND(killall_command, "killall", "killall: stop all running commands",
	      &shell_killall_process);
PROCESS(shell_kill_process, "kill");
SHELL_COMMAND(kill_command, "kill", "kill <command>: stop a specific command",
	      &shell_kill_process);
PROCESS(shell_null_process, "null");
SHELL_COMMAND(null_command, "null", "null: discard input",
	      &shell_null_process);
PROCESS(shell_exit_process, "exit");
SHELL_COMMAND(exit_command, "exit", "exit: exit shell",
	      &shell_exit_process);
SHELL_COMMAND(quit_command, "quit", "quit: exit shell",
	      &shell_exit_process);

PROCESS_THREAD(shell_kill_process, ev, data)
{
  struct shell_command *c;
  char *name;
  PROCESS_BEGIN();


  name = data;
  if(name == NULL || strlen(name) == 0) {
    shell_output_str(&kill_command,
		     "kill <command>: command name must be given", "");
  }


  for(c = list_head(commands);
      c != NULL;
      c = c->next) {
    if(strcmp(name, c->command) == 0 &&
       c != &kill_command &&
       process_is_running(c->process)) {
      command_kill(c);
      PROCESS_EXIT();
    }
  }


  shell_output_str(&kill_command, "Command not found: ", name);
  
  PROCESS_END();
}

5，添加自定义命令通过一下方式即可：

#include "contiki.h"
#include "shell.h"


#include "stdio.h"
#include "string.h"
#include "stm32f10x.h"




PROCESS(shell_blink_process, "shell blink");
SHELL_COMMAND(blink_command, "blink",
              "blink on/off : led on/off", &shell_blink_process);
							
static void
led_init()
{
    GPIO_InitTypeDef GPIO_InitStructure;


    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOF,ENABLE);


    GPIO_InitStructure.GPIO_Mode  = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;


    GPIO_InitStructure.GPIO_Pin   = GPIO_Pin_7;
    GPIO_Init(GPIOF, &GPIO_InitStructure);
}


/**
 * \brief
 * \param
 *
 */
static void
led_on()
{
    GPIO_SetBits(GPIOF, GPIO_Pin_7);
}


static void
led_off()
{
    GPIO_ResetBits(GPIOF, GPIO_Pin_7);
}


PROCESS_THREAD(shell_blink_process, ev, data)
{
    PROCESS_BEGIN();
    if(data != NULL)
    {
        if(strcmp(data, "on"))
        {
            led_on();
        }
        else if(strcmp(data, "off"))
        {
            led_off();
        }
        else
        {
            printf("Invalid param!\n");
        }
    }


    PROCESS_END();
}


void
shell_blink_init(void)
{
    led_init();
    shell_register_command(&blink_command);
}

a，通过SHELL_COMMAND(blink_command, "blink",
              "blink on/off : led on/off", &shell_blink_process);定义shell命令；

b，通过shell_register_command(&blink_command);在shell初始化的时候一并初始化即可

其他的内容，在后续的学习中将陆续记录。

ps.我还只是个初级入门的菜鸟，有些地方写的有问题也请大家指点啊。

贴上我的源码：（仅供参考）

点击打开链接