readDigitalPin
Description
value = readDigitalPin(
reads the logic level value of the digital input pin controller
,pin
)pin
on the
Aardvark™ or NI™ USB-845x controller controller
and returns it as a double
0
or 1
.
Examples
Read Logic Level Value from Digital Pin on NI USB-845x Controller
Connect to an NI USB-845x Interface Device and read the logic level values of its digital I/O pins.
Connect to the NI USB-845x using its serial number. In this example, the NI USB-845x controller board that is connected to the computer has the serial
number 01F26E0A
.
controller = ni845x("01F26E0A");
View the available digital I/O (DIO) pins on the controller and their respective pin
modes by using the DigitalPinModes
property.
controller.DigitalPinModes
ans = 8×2 table Pin Mode ______ _______ "P0.0" "input" "P0.1" "input" "P0.2" "input" "P0.3" "input" "P0.4" "input" "P0.5" "input" "P0.6" "input" "P0.7" "input"
Since these are input pins, you can read the logic level value of any of these. These pins are connected to pins on the I2C peripheral device. Read the logic level value of the DIO(0) pin, P0.0.
value = readDigitalPin(controller,"P0.0")
value = 0
You can also read the values of all the pins at once.
value = readDigitalPin(controller,controller.AvailableDigitalPins)
value = 0 1 1 0 0 1 1 0
The order of these values corresponds to the order of the pins returned by
controller.DigitalPinModes
. For example, the value of
P0.0
is 0
, P0.1
is
1
, P0.2
is 1
, and so
on.
Input Arguments
controller
— Controller connection
aardvark
object | ni845x
object
Controller connection, specified as an aardvark
object or
ni845x
object.
Example: readDigitalPin(controller,pin)
reads the pin's logic
level value for the Aardvark or NI USB-845x controller controller
.
pin
— Digital input pin number
character vector | string
Digital input pin number to read the logic level value of, specified as a character
vector or string. Possible values are the pin numbers returned as strings by
controller.AvailableDigitalPins
. You can also read the values of
all the pins by specifying pin
as the string array returned by
controller.AvailableDigitalPins
.
If a digital pin is not already configured as an input pin, you can set it using the
configureDigitalPin
function.
Example: readDigitalPin(controller,"Pin1")
reads the logic level
of the pin "Pin1"
on the Aardvark controller.
Example: readDigitalPin(controller,"P0.0")
reads the logic level
of the pin "P0.0"
on the NI USB-845x controller.
Data Types: char
| string
Version History
Introduced in R2023a
See Also
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: .
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)