Page Comparison

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

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

language	cpp

#include <CrcLib.h>

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

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

    //Set up Configurer le port DIO Port 9 ascomme ansortie
Output     CrcLib::SetDigitalPinMode(CRC_DIG_9, OUTPUT);
    
    /* 
    TheReste restdu ofcode yourd'initialisation
setup code     ...
     */
}
void loop() {
    CrcLib::Update();
    
    /* 
    TheReste restde ofla yourboucle loopingprincipale
code     ...
    */
}

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

Versions Compared

Old Version 3

New Version Current

Key

Purpose

When to use

Where to use

Returns

Objectif

Quand l’utiliser?

Où l’utiliser?

Valeur de retour

Prototype principal et paramètres

Overloads

Overloads

Exemples

Pour en apprendre plus

Pourquoi ne pas utiliser la fonction standard arduino pinMode()

au lieu de CrcLib::SetDigitalPinMode() ?

Are there any other mode than `INPUT` and `OUTPUT` ?

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

Related articles

Page Comparison

Versions Compared

Old Version 3

New Version Current

Key

Purpose

When to use

Where to use

Returns

Objectif

Quand l’utiliser?

Où l’utiliser?

Valeur de retour

Prototype principal et paramètres

Overloads

Overloads

Exemples

Pour en apprendre plus

Pourquoi ne pas utiliser la fonction standard arduino pinMode()

au lieu de CrcLib::SetDigitalPinMode() ?

Are there any other mode than INPUT and OUTPUT ?

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

Related articles

Are there any other mode than `INPUT` and `OUTPUT` ?

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