from the buffer to variables. Once data are in variables, string manipulation
instructions are used to format and parse the data.
SerialClose() must be executed before SerialOpen() can be used again to
reconfigure the same serial port, or before the port can be used to communicate
with a PC.
7.9.17.5.1 Serial I/O Programming Basics
SerialOpen()
1
• Closes PPP (if active)
• Returns TRUE or FALSE when set equal to a Boolean variable
• Be aware of buffer size (ring memory)
SerialClose()
• Examples of when to close
o Reopen PPP
o Finished setting new settings in a Hayes modem
o Finished dialing a modem
• Returns TRUE or FALSE when set equal to a Boolean variable
SerialFlush()
• Puts the read and write pointers back to the beginning
• Returns TRUE or FALSE when set equal to a Boolean variable
SerialIn()
1
• Can wait on the string until it comes in
• Timeout is renewed after each character is received
• SerialInRecord() tends to obsolete SerialIn().
• Buffer-size margin (one extra record + one byte)
SerialInBlock()
1
• For binary data (perhaps integers, floats, data with NULL characters).
• Destination can be of any type.
• Buffer-size margin (one extra record + one byte).
SerialOutBlock()
1,3
• Binary
• Can run in pipeline mode inside the digital measurement task (along with
SDM instructions) if the COMPort parameter is set to a constant such as
COM1, COM2, COM3, or COM4, and the number of bytes is also entered
as a constant.
SerialOut()
• Use for ASCII commands and a known response, such as Hayes-modem
commands.
• If open, returns the number of bytes sent. If not open, returns 0.
250