awtk/docs/manual/tk_iostream_serial_t.md

81 lines
2.7 KiB
Markdown
Raw Normal View History

2019-09-30 17:11:53 +08:00
## tk\_iostream\_serial\_t
### 概述
![image](images/tk_iostream_serial_t_0.png)
2019-11-15 15:56:59 +08:00
基于串口实现的输入输出流。
2022-12-05 12:10:53 +08:00
备注:如果需要在 Windows 平台运行,请在应用程序初始化时,调用 tk_socket_init 函数初始化 socket。
2019-09-30 17:11:53 +08:00
----------------------------------
### 函数
<p id="tk_iostream_serial_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
2020-06-04 21:43:16 +08:00
| <a href="#tk_iostream_serial_t_tk_iostream_serial_config">tk\_iostream\_serial\_config</a> | 配置串口。 |
2019-11-15 11:33:43 +08:00
| <a href="#tk_iostream_serial_t_tk_iostream_serial_create">tk\_iostream\_serial\_create</a> | 创建iostream对象。 |
2022-12-05 12:10:53 +08:00
| <a href="#tk_iostream_serial_t_tk_iostream_serial_wait_for_data">tk\_iostream\_serial\_wait\_for\_data</a> | 等待串口数据。 |
2020-06-04 21:43:16 +08:00
#### tk\_iostream\_serial\_config 函数
-----------------------
* 函数功能:
> <p id="tk_iostream_serial_t_tk_iostream_serial_config">配置串口。
2022-12-05 12:10:53 +08:00
备注:如果需要在 Windows 平台运行,请在应用程序初始化时,调用 tk_socket_init 函数初始化 socket。
2020-06-04 21:43:16 +08:00
* 函数原型:
```
ret_t tk_iostream_serial_config (tk_iostream_t* iostream, int32_t baudrate, bytesize_t bytesize, parity_t parity, stopbits_t stopbits, flowcontrol_t flowcontrol);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| iostream | tk\_iostream\_t* | 串口对象。 |
| baudrate | int32\_t | 波特率。 |
| bytesize | bytesize\_t | 字节位数。 |
| parity | parity\_t | 奇偶校验。 |
| stopbits | stopbits\_t | 停止位。 |
| flowcontrol | flowcontrol\_t | 流控。 |
2019-09-30 17:11:53 +08:00
#### tk\_iostream\_serial\_create 函数
-----------------------
* 函数功能:
2019-11-15 11:33:43 +08:00
> <p id="tk_iostream_serial_t_tk_iostream_serial_create">创建iostream对象。
2020-06-04 21:43:16 +08:00
> 缺省配置: baudrate=115200 bytesize=8 stopbits=1 flowcontrol=0 parity=0
2019-10-16 09:02:32 +08:00
2019-09-30 17:11:53 +08:00
* 函数原型:
```
tk_iostream_t* tk_iostream_serial_create (const char* port);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | tk\_iostream\_t* | 返回iostream对象。 |
| port | const char* | port name。 |
2022-12-05 12:10:53 +08:00
#### tk\_iostream\_serial\_wait\_for\_data 函数
-----------------------
* 函数功能:
> <p id="tk_iostream_serial_t_tk_iostream_serial_wait_for_data">等待串口数据。
* 函数原型:
```
ret_t tk_iostream_serial_wait_for_data (tk_iostream_t* iostream, uint32_t timeout);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| iostream | tk\_iostream\_t* | 串口对象。 |
| timeout | uint32\_t | 等待时间(ms)。 |