Purpose

Get the value of a Digital Input (DI) of the board.

When to use

Whenever you need to use the state of a DI.

Where to use

Most probably in the void loop() part of your .ino file, since we’d usually want to actively monitor the value.

Click here to learn more on the DIOs of the 9880 board.

This function requires the use of the following CrcLib functions at some point of your .ino file in order to work properly:

Returns

This function returns state of the DI mentioned as the function’s argument as an unsigned char type. The value returned will be either one of these two possible values:

HIGH, if voltage is applied to the SIG pin of the digital port.
LOW, if no voltage is applied to the SIG pin of the digital port.

Main prototype and parameters

static unsigned char CrcLib::GetDigitalInput(unsigned char pin)

The following parameters must be passed to the function for it to work properly:

pin: The name of the digital pin you want to read the state of. Must be of the type unsigned char.

Overloads

This function does not have any overloads. It can only be used as described by the main prototype.

Examples

#include <CrcLib.h>

// Variable declaration
bool ButtonState;

void setup() {
    CrcLib::Initialize();

    CrcLib::SetDigitalPinMode(CRC_DIG_5, INPUT); //Set up DIO Port 5 as an Input

    /* 
    The rest of your setup code
    ...
     */
}
void loop() {
    CrcLib::Update();

    //The variable ButtonState will have the same value as DIO Port 5
    ButtonState = CrcLib::GetDigitalInput(CRC_DIG_5);
    
    /* 
    The rest of your looping code
    ...
    */
}

More on this function

Why does this function return `HIGH` / `LOW`, instead of `true` / `false`?

The Arduino environment, when speaking of voltage, uses the constant HIGH to represent its presence and LOW to represent its absence. In electronics, a voltage presence (or when is is greater than a certain value) is usually represented by true, while an absence of voltage (or when it is lower than a certain value) is usually represented by false.

Système CrcDuino System

GetDigitalInput()

Analytics

Purpose

When to use

Where to use

Returns

Main prototype and parameters

Overloads

Examples

More on this function

Why does this function return `HIGH` / `LOW`, instead of `true` / `false`?

Related articles

Related content

GetDigitalInput()

Purpose

When to use

Where to use

Returns

Main prototype and parameters

Overloads

Examples

More on this function

Why does this function return HIGH / LOW, instead of true / false?

Related articles

Related content

Why does this function return `HIGH` / `LOW`, instead of `true` / `false`?