Documentation

Digital Input

Read from one or multiple digital input channels

Description

Connect to and read from specific digital lines or channels into your Simulink® model. After you have added a Digital Input block to your model, you can enter the parameters for its I/O driver.

Ports

Output

expand all

The data type and range of the output values depend upon the capabilities of the board.

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

In normal or accelerator modes, 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

expand all

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 >.

Dependency

When you select a board in the list of registered boards, the Delete current board and Board setup buttons are available.

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.

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.

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.

In normal or accelerator modes, 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 external mode, the software ignores this value.

In normal or accelerator modes, select this check box to send the number of missed ticks to output port Missed Ticks.

In external mode, the Missed Ticks port is zero.

In normal or accelerator modes, select this check box to grant other programs more CPU time while the kernel waits for a response from the hardware.

In external mode, the software ignores this value.

Enter a channel vector that selects the digital input channels you are using on this board. The vector can be any valid MATLAB® vector form. For example, to select the first eight digital input channels, enter:

[1,2,3,4,5,6,7,8]

or

[1:8]

If you want to use the first four digital input 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.

From the list, select one of the following options:

  • Bit — Returns a value of 0 or 1.

  • Byte — Groups eight digital lines into one digital channel. Returns a value of 0–255.

From the list, select the type of data that the block outputs to the model. The valid values depend on the capabilities of the board.

Introduced before R2006a

Was this topic helpful?