Digital Output
Write to one or multiple digital output channels
Libraries:
Simulink Desktop Real-Time
Description
The Digital Output block connect to and writes to specific digital lines or channels from your Simulink® model. After you have added a Digital Output block to your model, you can enter the parameters for its I/O driver.
Examples
Real-Time Controller
Build a simple closed-loop real-time controller by using Simulink Desktop Real-Time™.
Real-Time Filter
Build a real-time filter using DSP System Toolbox™ and Simulink Desktop Real-Time™.
Ports
Input
Digital Data — Digital data to write to output channels
vector
The data type and range of the input values depend upon the capabilities of the board.
Data Types: single
| double
| int8
| uint8
| int16
| uint16
| int32
| uint32
Output
Missed Ticks — Missed tick count (optional)
double
In Connected IO mode, returns the number of timer ticks that your model lags behind the real-time kernel. When the model lags by more than Maximum missed ticks, the software reports an error and simulation stops.
Dependency
When you select Show “Missed Ticks” port, this port is visible.
Data Types: double
Parameters
Install new board — Register a board
< no board selected >
(default)
When you click Install new board, the software displays a list of manufacturers of supported boards. When you select a manufacturer, the software displays a list of boards available from that manufacturer. When you select a board, the software adds the board to the list of registered boards and makes that board the current board.
By default, the initial selection in the list of registered boards is <
no board selected >
.
For more information about driver support for I/O boards, see Hardware Support from Simulink Desktop Real-Time.
Dependency
When you select a board in the list of registered boards, the Delete current board and Board setup buttons are available.
Programmatic Use
Block Parameter:
DrvName |
Delete current board — Delete the current board
(button)
To delete the current board, click this button. The initial
selection of the list of registered boards changes to <
no board selected >
.
Dependency
To activate this parameter, select a board in the list of registered boards.
When you delete the current board, the Delete current board and Board setup buttons are no longer available.
Programmatic Use
Block Parameter:
DrvName |
Board setup — Set up the board
(button)
To set up the board, click this button.
A board-specific dialog box opens to set up the board. For more information, see the board manufacturer documentation.
Dependency
To activate this parameter, select a board in the list of registered boards.
To deactivate this parameter, click Delete current board.
Programmatic Use
Block Parameter:
DrvAddress |
Block Parameter:
DrvOptions |
Sample time — Sample time of block
0.1
(default) | double
Enter a value, in seconds, that represents how frequently you want the block to execute and interact with the I/O hardware. The block synchronizes your model with the real-time clock at this sample rate.
If you are using a fixed-step solver, enter the value that you entered as the Fixed step size configuration parameter or an integer multiple of that value.
Programmatic Use
Block Parameter:
SampleTime |
Maximum missed ticks — Number of timer ticks by which your model can trail the kernel
10
(default) | integer
In Connected IO mode, enter the number of timer ticks that your model can lag behind the real-time kernel. When the model lags behind by this number or fewer timer ticks, the software assumes that the lag is temporary. It allows the model to catch up, even if the model misses some ticks. When the model lags by more than this number, the software reports an error and simulation stops.
In Run in Kernel mode, the software ignores this value.
Programmatic Use
Block
Parameter:
MaxMissedTicks |
Show “Missed Ticks” port — Send number of missed ticks to port Missed Ticks
'off'
(default) | 'on'
In Connected IO mode, select this check box to send the number of missed
ticks to output port Missed Ticks
.
In Run in Kernel mode, the Missed Ticks
port is
zero.
Programmatic Use
Block Parameter:
ShowMissedTicks |
Yield CPU when waiting — Yield CPU while kernel waits for hardware
'off'
(default) | 'on'
In Connected IO mode, select this check box to grant other programs more CPU time while the kernel waits for a response from the hardware.
In Run in Kernel mode, the software ignores this value.
Programmatic Use
Block Parameter:
YieldWhenWaiting |
Output channels — Select digital output channels
vector
Enter a channel vector that selects the digital output channels you are using on this board. The vector can be any valid MATLAB® vector form. For example, to select the first eight digital output channels, enter:
[1,2,3,4,5,6,7,8]
or
[1:8]
If you want to use the first four digital output lines, enter:
[1,2,3,4]
If you have one 8-bit digital channel, enter [1]
. If you have two 8-bit
digital channels, enter [1 9]
, and from the
Channel mode list, select
Byte
.
Programmatic Use
Block Parameter:
Channels |
Channel mode — Mode of representing the output lines
Bit
(default) | Byte
From the list, select from one of the following:
Bit
— Expects a value of0
or1
.Byte
— Expects a value of0–255
that is converted to one digital channel of eight digital lines.
Programmatic Use
Block Parameter:
BitMode |
Initial value — Initial value for output channels
vector
Enter the initial values for each digital output
line or channel that you entered as the Output channels parameter.
For example, if you entered [1,2,3,4]
, and
you want initial values of 0
and 1
,
enter:
[0,0,1,1]
If you select Byte
from the Channel mode list,
enter a value from 0
through 255
for
each digital output channel. For example, for 1 byte (eight digital lines)
with an initial value of 25
, enter
[25]
. For 2 bytes (16 digital lines) with initial
values of 25
and 50
, enter
[25 50]
.
Programmatic Use
Block Parameter:
InitialValue |
Final value — Final value for output channels
vector
Enter a final value for each digital output channel
that you entered as the Output channels parameter.
For example, if you entered [1,2,3,4]
, and
you want final values of 0
, enter:
[0,0,0,0]
If you select Byte
from the Channel mode list,
enter a value from 0
through 255
for
each digital output channel.
Programmatic Use
Block Parameter:
FinalValue |
Version History
Introduced before R2006aR2024b: Update to blocks with port names
In R2024b, when you enable optional ports, such as Show "Missed Ticks" port, these Simulink Desktop Real-Time™ block ports appear with labels.
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: United States.
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)
Asia Pacific
- Australia (English)
- India (English)
- New Zealand (English)
- 中国
- 日本Japanese (日本語)
- 한국Korean (한국어)