Realterm RS232 comms - serial()-like version

Use Realterm the way you can using the MATLAB "serial" commands and instrument control toolbox.
536 Downloads
Updated 24 Jun 2013

View License

This is a package of files for using Realterm (via ActiveX) almost exactly like you normally would with serial/fread/fprintf etc etc. from the instrument control toolbox - the MATLAB help files more fully explain some of the input/output arguments. rt has been implemented as an hgsetget class, so the same set()/get() and dot notation applies. Properties can be set with case-insensitive and partial matches.

The most significant limitation is that it does not support software flow control as yet.

rtObject = rt(Port, Property/Value pairs)
Create a Realterm activeX control in the same manner as you would with serial(). Property/Value pairs can be in serial() format.

fopen(rtObject)
Connects

fclose(rtObject)
Closes and cleans up

delete(rtObject)
Deletes the object

output = fread(rtObject)
output = fread(rtObject, bytes)
output = fread(rtObject, bytes, precision)
[output, count, message] = fread(...)
Reads up to the number of bytes, or until it times out.

output = fscanf(rtObject)
output = fscanf(rtObject, format)
output = fscanf(rtObject, format, bytes)
[output, count, message] = fscanf(...)
Reads up to the number of bytes, or the terminator, or until it times out.

output = fgets(rtObject)
[output, count, message] = fgets(...)
Reads one line up to the terminator cf fscanf, including the terminator.

output = fgetl(rtObject)
[output, count, message] = fgetl(...)
Reads one line up the terminator cf fscanf, discarding the terminators.

fwrite(rtObject, data)
fwrite(rtObject, data, precision)
Sends a message to an rtObject - see serial/fread for a fuller description of the precision argument

fprintf(rtObject, input, format)
Sends a message to an rtObject, appending on the terminator.

Cite As

Geoffrey Akien (2024). Realterm RS232 comms - serial()-like version (https://www.mathworks.com/matlabcentral/fileexchange/42297-realterm-rs232-comms-serial-like-version), MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2012b
Compatible with any release
Platform Compatibility
Windows macOS Linux
Categories
Find more on Instrument Control Toolbox Supported Hardware in Help Center and MATLAB Answers
Tags Add Tags
Acknowledgements

Inspired by: Realterm communications suite

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Version Published Release Notes
1.3.0.0

Add disp method for better serial()-like behaviour, and some small changes to the set/get methods.

1.1.0.0

Updated description to reflect issues with software flow control.

1.0.0.0