Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Purpose

Enables the use of a Digital Input/Output (DIO) Pin by telling the program if it should be considered as an Input or an Output.

When to use

Once for each DIO Pin used on the board. If you connect anything to a digital pin, its mode should be set.

Where to use

At the beginning of your code execution, in the void setup() part of your .ino file, so that the pin mode is set before the pin is referred to by your code.

Info

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

Note

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

Returns

This function does not return a value once it has completed its tasks.

Main prototype and parameters

static void Crc::

Objectif

Permets d’utiliser les entrées sorties digitales (DIO) en indiquant à la librairie si cette broche doit être une entrée ou une sortie.

Quand l’utiliser?

Une fois pour chacune des broches DIO utilisées sur le CRCduino. Peu importe ce que vous connectez, le mode de la broche devrait être indiqué.

Où l’utiliser?

Au début de l’exécution du programme, dans la fonction void setup() de votre fichier .ino, pour que le mode soit définit avant tout accès à la broche.

Info

Cliquer ici pour en apprendre plus sur les DIOs du CRCduino

Note

Cette fonction requiert l’utilisation des fonctions suivantes dans votre programme:

Valeur de retour

Cette fonction n’a pas de valeur de retour.

Prototype principal et paramètres

static void CrcLib::SetDigitalPinMode(unsigned char pin, unsigned char mode)

The following parameters must be passed to the function for it to work properlyLes paramètres suivants doivent être passés à la fonction:

  • pin: The name of the digital pin you want to set. Must be of the type unsigned charLe numéro de broche correspondant. Doit être de type unsigned char. Par exemple, CRC_DIG_3.

  • mode: The mode you want to set the pin to. Must be of the Le mode auquel doit être assigné la broche. De type unsigned char. Needs to be one of the followingDoit être soit:

    • INPUT, if you are using the digital pin as as inputpour une broche utilisée comme entrée.

    • OUTPUT, if you are using the digital pin as as output.

Overloads

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

Examples
    • pour une broche utilisée comme sortie.

Overloads

C’est fonction n’a pas d’overloads et n’est définie que pas son prototype principal

Exemples

Expand
title#1: We want to connect a digital sensor, like a limit switch, to DIO Port 5. We want to connect a small light or a relay control signal, to DIO Port Nous voulons connecter un capteur digital (comme une « limit switch ») au port DIO 5. Nous souhaitons aussi connecter une petite lumière au port DIO 9.
Code Block
languagecpp
#include <CrcLib.h>

using namespace Crc;

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

    //Set up Configurer le port DIO Port 5 ascomme an Inputentrée
    CrcLib::SetDigitalPinMode(CRC_DIG_5, INPUT);

    //Set up Configurer le port DIO Port 9 ascomme an Outputsortie
    CrcLib::SetDigitalPinMode(CRC_DIG_9, OUTPUT);
    
    /* 
    TheReste restdu of your setup codecode d'initialisation
    ...
     */
}
void loop() {
    CrcLib::Update();
    
    /* 
    TheReste restde ofla yourboucle looping codeprincipale
    ...
    */
}
More on this function

Pour en apprendre plus

Info
Why not use the native Arduino function
Pourquoi ne pas utiliser la fonction standard arduino pinMode()
instead of
au lieu de CrcLib::SetDigitalPinMode() ?

We recommend using Nous recommandons d’utiliser CrcLib::SetDigitalPinMode() because it adds a few layers of validation to make sure you don't assign a mode to an unsafe pin.

Info
Are there any other mode than INPUT and OUTPUT ?

Click here to learn more about the different pin modes on an Arduino board. Note that a pull-up resistor is connected to all digital pins of the 9880 board, so using INPUT has the same effect as using INPUT_PULLUP. Google is a great place to learn about pull-up resistors (and its sister, the pull-down resistor), but this page is a good introduction.

Articles liés

parce qu’elle ajoute quelques couches de protection comme une validation pour s’assurer que les pins utilisées sont sécuritaires.

Info
Existe-t’il d’autres modes que INPUT et OUTPUT ?

Dirigez-vous ici (en anglais) pour en apprendre plus sur les différents modes des pins sur un Arduino. Notez qu’une « pull-up » est installée sur tous les ports digitaux du CRCduino, donc utiliser INPUT est équivalent à INPUT_PULLUP. Les moteurs de recherche sont d’excellents amis pour en apprendre plus sur les « pull-up » et « pull-down », mais cette page (en anglais) est une excellente introduction.

Filter by label (Content by label)
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@831
sorttitle
typepage
excerptTyperich content
labelskb-how-to-article
cqllabel = "ar-esdigital_discrete"labelskb-how-to-articleio"