source:Interfaces/DigitalOut/DigitalOut_Interfaces.png

DigitalOut

The DigitalOut interface is used to configure and control a digital output pin.

Hello World!

// Flash an LED

#include "mbed.h"

DigitalOut myled(LED1);

int main() {
    while(1) {
        myled = 1;
        wait(0.25);
        myled = 0;
        wait(0.25);
    }
}

API

DigitalOutA digital output, used for setting the state of a pin
Functions
DigitalOutCreate a DigitalOut connected to the specified pin
writeSet the output, specified as 0 or 1 (int)
readReturn the output setting, represented as 0 or 1 (int)
operator=A shorthand for write
operator int()A shorthand for read
class DigitalOut : public Base
A digital output, used for setting the state of a pin
DigitalOut(PinName pin,  
const char *name =  NULL)
Create a DigitalOut connected to the specified pin
void write(int value)
Set the output, specified as 0 or 1 (int)
int read()
Return the output setting, represented as 0 or 1 (int)
DigitalOut& operator= (int value)
A shorthand for write
operator int()
A shorthand for read

Interface

The DigitalOut Interface can be used on mbed pins p5-p30, and also on-board LED1-LED4

The DigitalOut Interface can be used to set the state of the output pin, and also read back the current output state. Set the DigitalOut to zero to turn it off, or 1 to turn it on.

Details

The pin output is 0v and 3.3v (0 and 1), and can source or sink a maximum of 40mA.

Examples

// Alternative flashing

#include "mbed.h"

DigitalOut myled(LED1);

int main() {
    while(1) {
        myled = !myled;
        wait(0.25);
    }
}
// Alternative flashing

#include "mbed.h"

DigitalOut red(p5);
DigitalOut green(p6);
DigitalOut blue(p7);

int main() {
    // red
    red = 1;
    green = blue = 0;
    wait(1);
    
    // green
    green = 1;
    red = blue = 0;
    wait(1);

    // white
    red = green = blue = 1;
}