Main Content

configureDigitalPin

Set digital pin mode on controller

Since R2023a

    Description

    example

    configureDigitalPin(controller,pin,mode) sets the specified pin on controller to the specified mode. Set a pin to input mode to read its logic level value and set it to output mode to send it a logic level value.

    Examples

    collapse all

    Connect to an NI™ USB-845x Interface Device and configure the digital I/O pins on it.

    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"
    

    Configure the DIO(0), P0.0, pin as output.

    configureDigitalPin(controller,"P0.0","output")

    Since pin P0.0 is an output pin, you can now send it a logic high level using writeDigitalPin. Since the other pins are input pins, you can read their logic level using readDigitalPin.

    Input Arguments

    collapse all

    Controller connection, specified as an aardvark object or ni845x object.

    Example: configureDigitalPin(controller,pin,mode) sets the pin mode for the Aardvark™ or NI USB-845x controller controller.

    Digital I/O pin number to configure as input or output, specified as a character vector or string scalar. Possible values are the pin numbers returned by controller.AvailableDigitalPins.

    Example: configureDigitalPin(controller,"Pin1",mode) sets the mode for the pin Pin1 on the Aardvark controller.

    Data Types: char | string

    Pin mode, specified as "input" or "output". You can read logic values from input pins using readDigitalPin and send logic level values to output pins using writeDigitalPin.

    Example: configureDigitalPin(controller,pin,"output") sets the pin mode to output for the Aardvark or NI USB-845x controller.

    Data Types: char | string

    Version History

    Introduced in R2023a