Main Content

Serial Receive

Receive binary data over serial port

  • Library:
  • Instrument Control Toolbox

  • Serial Receive block

Description

The Serial Receive block configures and opens an interface to the specified serial port. The configuration and initialization occur once at the start of the model's execution. The block acquires data from the serial port during the model's run time.

Note

You must configure your serial port parameters using the Serial Configuration block before you specify the Serial Receive block parameters.

This block has no input ports. It has one or two output ports based on whether you select blocking or non-blocking mode. If you select blocking mode, the block has one output port, Data, corresponding to the data it receives. If you do not select blocking mode, the block has two output ports, Data and status.

This block uses a First In, First Out (FIFO) buffer to receive data from the serial port. At each time step, the Data port returns the requested values from the buffer. In non-blocking mode, the status port indicates if the block has received new data. If the status port displays 1, new data is available and if the status port displays 0, no new data is available.

Other Supported Features

  • The Serial Receive block supports the use of Simulink® Accelerator mode, but not Rapid Accelerator. This feature speeds up the execution of Simulink models.

  • The Serial Receive block supports the use of model referencing. This feature lets your model include other Simulink models as modular components.

  • The Serial Receive block supports C/C++ code generation. This feature allows you to generate C and C++ code using Simulink Coder™.

For more information on these features, see the Simulink documentation.

Ports

Output

expand all

Data received by the block from the serial port, returned as a vector, matrix, or array.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

New data available status, returned as numeric or logical 1 (true) or 0 (false). If this port returns 1, new data is available to be read.

Dependencies

To enable this port, unselect the Enable blocking mode parameter.

Data Types: Boolean

Parameters

expand all

Serial port on your machine that you want to receive data from. Select a port from the available ports and then configure the port using the Serial Configuration block. If you have not configured a port, the block returns an error when you run your model.

Note

Each Serial Receive block must have a configured Serial Configuration block. If you use multiple serial ports in your simulation, you must configure each port using a separate Serial Configuration block.

Programmatic Use

Block Parameter: Port
Type: character vector, string

Data type that the block receives from the serial port, specified as a MATLAB numeric data type.

Programmatic Use

Block Parameter: DataType
Type: character vector, string
Values: 'uint8' | 'single' | 'double' | 'int8' | 'int16' | 'uint16' | 'int32' | 'uint32'
Default: 'uint8'

If this parameter is selected, you can specify the header that indicates the beginning of your data block. The simulation disregards data that occurs before the header. The header data is not sent to the output port. By default, this parameter is not selected and no header is specified.

The numeric array specified in this parameter is the uint8 integer representation of the corresponding ASCII characters. The exact form of this parameter depends on the type of the ASCII character.

Type of ASCII CharacterExample ASCII CharacterMATLAB CommandParameter Value
Special character"#"uint8('#')[35]
Numeric"81"uint8('81')[56 49]
Alphabet"Start"uint8('Start')[83 116 97 114 116]

You can also specify this parameter using the hexadecimal representation of the ASCII characters.

Programmatic Use

Block Parameter: ToggleHeader
Type: character vector, string
Values: 'on' | 'off'
Default: 'off'
Block Parameter: Header
Type: character vector, string
Values: integer array

If this parameter is selected, you can specify the terminator that indicates the end of your data block. The simulation considers any data that occurs after the terminator as a new data block. The terminator data is not sent to the output port. This terminator must match the terminator in the data you are reading from your serial port, if it has one.

If you select Custom Terminator, you can specify your own terminator value.

Programmatic Use

Block Parameter: ToggleTerminator
Type: character vector, string
Values: 'on' | 'off'
Default: 'off'
Block Parameter: Terminator
Type: character vector, string
Values: '<none>' | 'CR ('\r')' | 'LF ('\n')' | 'CR/LF ('\r\n')' | 'NULL ('\0')' | 'Custom Terminator'
Default: '<none>'

Custom terminator that indicates the end of your data block. The simulation considers any data that occurs after the terminator as a new data block. The terminator data is not sent to the output port.

The numeric array specified in this parameter is the uint8 integer representation of the corresponding ASCII characters. The exact form of this parameter depends on the type of the ASCII character.

Type of ASCII CharacterExample ASCII CharacterMATLAB CommandParameter Value
Special character"#"uint8('#')[35]
Numeric"81"uint8('81')[56 49]
Alphabet"End"uint8('End')[69 110 100]

You can also specify this parameter using the hexadecimal representation of the ASCII characters.

Programmatic Use

Block Parameter: CustomTerminator
Type: character vector, string
Values: integer array

Output data size, or the number of values that should be read at each simulation time step. This parameter is specified as a multidimensional numeric array. The data size does not include the header or terminator values.

Programmatic Use

Block Parameter: DataSize
Type: character vector, string
Values: integer array
Default: '[1 1]'

This parameter has the simulation wait while the block receives data. When new data becomes available, the simulation continues from the next time step. Unselect the check box if you do not want the read operation to cause the simulation to wait.

If you enable blocking mode, the simulation waits for the requested data to become available. The model waits for up to the amount of time specified by the Timeout parameter in the Serial Configuration block. If new data does not become available during a simulation, you can return an error by selecting the Error option for the Action when data is not available parameter.

If you do not enable blocking mode, the simulation runs continuously and the block has two output ports, status and Data. The Data port contains the requested set of data at each time step. The status port contains 0 or 1 based on whether it received new data at the given time step.

Programmatic Use

Block Parameter: EnableBlockingMode
Type: character vector, string
Values: 'on' | 'off'
Default: 'on'

Action the block should take when data is not available. Available options are:

  • Output last received value — Block returns the value it received at the preceding time step when it does not receive data at current time step.

  • Output custom value — Block returns any user-defined value when it does not receive current data. Define the custom value in the Custom value field.

  • Error — Block returns an error when it does not receive current data. You must select Enable blocking mode to use this option.

Programmatic Use

Block Parameter: ActionDataUnavailable
Type: character vector, string
Values: 'Output last received value' | 'Output custom value' | 'Error'
Default: 'Output last received value'

Custom value for the block to output when it does not receive new data. The custom value can be a scalar or value equal to the size of data that it receives (specified by Data size parameter). You must select Output custom value as the Action when data is unavailable to set this parameter.

Programmatic Use

Block Parameter: CustomValue
Type: character vector, string
Values: numeric
Default: '0'

Sampling time of the block during the simulation. This is the rate at which the block is executed during simulation.

Programmatic Use

Block Parameter: SampleTime
Type: character vector, string
Values: positive numeric
Default: '0.01'

Extended Capabilities

Introduced in R2008a