External Interfaces/API Reference

save (serial)

Save serial port objects and variables to a MAT-file

Syntax

• save filename
  save filename obj1 obj2...
  

Arguments

filename	The MAT-file name.
obj1 obj2...	Serial port objects or arrays of serial port objects.

Description

save filename saves all MATLAB variables to the MAT-file filename. If an extension is not specified for filename, then the .mat extension is used.

save filename obj1 obj2... saves the serial port objects obj1 obj2 ... to the MAT-file filename.

Remarks

You can use save in the functional form as well as the command form shown above. When using the functional form, you must specify the filename and serial port objects as strings. For example. to save the serial port object s to the file MySerial.mat

• s = serial('COM1');
  save('MySerial','s')
  

Any data that is associated with the serial port object is not automatically stored in the MAT-file. For example, suppose there is data in the input buffer for obj. To save that data to a MAT-file, you must bring it into the MATLAB workspace using one of the synchronous read functions, and then save to the MAT-file using a separate variable name. You can also save data to a text file with the record function.

You return objects and variables to the MATLAB workspace with the load command. Values for read-only properties are restored to their default values upon loading. For example, the Status property is restored to closed. To determine if a property is read-only, examine its reference pages.

If you use the help command to display help for save, then you need to supply the pathname shown below.

• help serial/private/save
  

Example

This example illustrates how to use the command and functional form of save.

• s = serial('COM1');
  set(s,'BaudRate',2400,'StopBits',1)
  save MySerial1 s
  set(s,'BytesAvailableFcn',@mycallback)
  save('MySerial2','s')
  

See Also

Functions

load, record

Properties

Status

record

serial