AWTK控件serial_widget的使用方法

把串口做成一个控件并不新鲜，在VB里有个通信组件，就是用来简化串口编程的。最近AWTK也提供了这样一个控件serial_widget，本文介绍一下它的使用方法。

基本功能

我们编写一个简单的应用程序，它有两个功能：

• 把收到的数据显示出来。
• 把界面输入的数据发送给对方。

UI界面描述文件

  "open" text="Open Device" x="10" y="100" w="160" h="36" />  "device"x="180"y="100"w="-200"h="36"text="/dev/ttys032"/>"send"text="SendMessage"x="10"y="150"w="160"h="36"/>  "send_msg"x="180"y="150"w="-200"h="36"text="helloserial"/>  "recv_msg"x="c"y="b:100"w="90%"h="100"/>  "serial"/>

接收数据

•先注册数据事件的处理函数。

widget_child_on(win, "serial", EVT_DATA, on_data, win);

•在处理函数中读取数据并显示到界面上。

static ret_t on_data(void* ctx, event_t* e) { char text[128] = {0}; widget_t* win = WIDGET(ctx); serial_widget_t* serial = SERIAL_WIDGET(e->target); widget_t* label = widget_lookup(win, "recv_msg", TRUE); int32_t len = tk_istream_read(serial->istream, text, sizeof(text)-1); if(len > 0) {    text[len] = '0';    widget_set_text_utf8(label, text);  }returnRET_OK;}

发送数据

从界面读取数据，并发送到串口。

static ret_t on_send(void* ctx, event_t* e) { char text[128] = {0}; widget_t* win = WIDGET(ctx); serial_widget_t* serial = SERIAL_WIDGET(widget_lookup(win, "serial", TRUE)); widget_t* edit = widget_lookup(win, "send_msg", TRUE);  widget_get_text_utf8(edit, text, sizeof(text)-1);  tk_ostream_write_len(serial->ostream, text, strlen(text), 3000); return RET_OK;}

完整代码请参考 serial 可以下载 awtk-c-demos 编译运行。

./bin/demo_serial

测试

下面操作是在 Linux/MacOS 上测试的，Windows 下需要安装虚拟串口软件，具体做法有些不同，请自行调整。

•使用socat创建虚拟串口

socat -d -d pty,raw,echo=0 pty,raw,echo=0

该命令会生成两个设备文件，对应串口的两端（每次生成的设备名可能不同）。

2022/07/08 16:32:33 socat[1879] N PTY is /dev/ttys0322022/07/08 16:32:33 socat[1879] N PTY is /dev/ttys0332022/07/08 16:32:33 socat[1879] N starting data transfer loop with FDs [5,5] and [7,7]

•在AWTK 这端我们使用设备/dev/ttys032
•在另外一端读取数据
打开一个新的终端，并运行下面的命令（有数据时自动显示出来）：

cat /dev/ttys033

•在另外一端发送数据

打开一个新的终端，并运行下面的命令（发送当前时间字符串）：

date >/dev/ttys033

使用fscript进行串口编程

也可以使用 fscript 进行串口编程（配合 AWBlock 就简单了）。AWTK 里提供一个与前面功能相同的例子，总体来看要简洁不少。

  "打开设备" x="16" y="15" w="76" h="34" >    "on:click">      var device = widget_get('device', 'text')      widget_set('serial','device', device)        "device" x="119" y="13" w="178" h="38" text="/dev/ttys028" />  "recv" x="5" y="123" w="303" h="101" />  "send" text="hello serial" x="5" y="273" w="200" h="34" />  "button" tr_text="send" x="220" y="274" w="81" h="34" >    "on:click">      var os = widget_get('serial','ostream')      var msg = widget_get('send', 'text')      ostream_write_string(os, msg)        "serial">    "on:data">      var is = widget_get('self','istream')      var msg = istream_read_string(is, 100, 0)      widget_set('recv', 'text', msg)      

在 AWTK 根目录下可以运行该例子，测试方法与前面相同。

./bin/preview_ui design/default/ui/serial.xml

移植

目前串口只实现了Windows, Linux, MacOS, Android 和 AWorks 等平台，其它平台需要自己移植。

请参考AWorks平台的移植：

src/platforms/aworkslp/serial_helper.c

审核编辑：汤梓红