3.2. 支持交互式运行

交互式运行需要一个读取用户输入字节的底层接口 __platform_getchar() ，这个接口是一个 weak 函数，用户需要在自己的代码里面也实现一个 __platform_getchar() 来覆盖这个 weak 函数。

weak 函数原型在 PikaPlatform.c 里面，如果用户没有覆盖，就会在使用交互式运行时报错。

用户可以直接在工程的 main.c 里面实现一个 __platform_getchar()。

如果平台本身支持 getchar() ，那么可以直接接入平台的 getchar()。

/* main.c */
char __platform_getchar(){
    return getchar();
}

如果平台不支持，就需要自己实现，注意要实现一个阻塞的 getchar()，也就是说，当没有串口输入字符时，要在 __platform_getchar() 中等待，有输入时返回一个字符。例如：

/* main.c */
    char res = 0;
    while(rx_char == 0){
    };
    res = rx_char;
    rx_char = 0;
}

pikaScriptShell() 入口参数是 pika 的根对象，运行 pikaScriptInit() 就能创建一个根对象。

rt-thread:

obj_runChar 内核 API 可以指定一个对象执行脚本，且输入为一个字节。

在使用 obj_runChar 前，需要先运行 obj_runCharInit() 。

示例代码：

PikaObj* pikaMain = pikaScriptInit();
obj_runCharInit(pikaMain);
while(1){
    char ch = my_get_char();
    obj_runChar(pikaMain, ch);

内核版本需要不低于 v1.8.3

obj_run 内核 API 可以指定一个对象执行脚本，使用这个 API 可以执行单行或者多行的脚本。下面以 CH32 的交互式运行驱动为例，这个交互式运行的支持写在固件的主循环内，在初始化脚本执行完毕之后，开始执行。

使用空闲时间来判断字符串的传输完成就可以支持交互式运行多行脚本了。如果只需要运行单号脚本，则可以使用换行符 '\n' 来判断字符串接收结束。在运行单行脚本时，可以不带 '\n' 换行符，多行脚本需要带 '\n' 换行符。"\r\n" 形式的换行符也是支持的。

指定的对象是 pikaScriptInit() 初始化脚本创建的根对象，执行的内容是接收到的字符串。

例如：下面的脚本是完整的代码块，尤其需要注意的是第 4 行，需要有一个缩进为 0 的行，用来标志代码块的结束。以及最后一行需要有一个空行，这意味着 print('the end') 这行脚本末尾带有换行符。

while a < 10：
    a = a + 1
    print(a)
print('the end')
(空行)

以下的例子也是可以的

# 缺少最后的换行符
while a < 10：
    a = a + 1
    print(a)

输入 exit() 即可退出交互运行。