add examples/lua/pts.lua showing one use of read_ts; add read_ts to tio man(1) file

This commit is contained in:
Keith Hill 2024-10-25 11:52:12 -05:00
parent 9d74fe9e74
commit f99a85b9da
2 changed files with 20 additions and 0 deletions

13
examples/lua/pts.lua Normal file
View file

@ -0,0 +1,13 @@
send("\n")
msleep(100)
read_ts(650, 60) -- main menu
send("S") -- S menu
msleep(30)
read_ts(650, 60)
send("t") -- Parallel Value Table
read_ts(650, 60)
while true do
msleep(970)
send("t")
read_ts(650, 50) -- repeat PVT forever
end

View file

@ -375,6 +375,13 @@ SCRIPT API
On success, returns read string as second return value.
read_ts(size, timeout)
Read from serial device. If timeout is 0 or not provided it will wait forever until data is ready to read.
Returns number of bytes read on success, 0 on timeout, or -1 on error.
On success, returns read string as second return value. Additionally, emit timestamp to stdout and log file per options.timestamp and options.log.
set{line=state, ...}
Set state of one or multiple tty modem lines.