Miosix  2.0alpha1
gpio.h File Reference
#include "interfaces-impl/gpio_impl.h"
Include dependency graph for gpio.h:

Detailed Description

The interface to gpios provided by Miosix is in the form of templates, therefore this file can only include gpio_impl.h with the architecture dependand code.

The interface should be as follows: First a class Mode containing an enum Mode_ needs to be defined. Its minimum implementation is this:

class Mode
{
public:
enum Mode_
{
INPUT,
OUTPUT
};
private:
Mode(); //Just a wrapper class, disallow creating instances
};

This class should define the possible configurations of a gpio pin. The minimum required is INPUT and OUTPUT, but this can be extended to other options to reflect the hardware capabilities of gpios. For example, if gpios can be set as input with pull up, it is possible to add INPUT_PULL_UP to the enum.

Then a template Gpio class should be provided, with at least the following member functions:

template<typename P, unsigned char N>
class Gpio
{
public:
static void mode(Mode::Mode_ m);
static void high();
static void low();
static int value();
private:
Gpio();//Only static member functions, disallow creating instances
};

mode() should take a Mode::Mode_ enum and set the mode of the gpio (input, output or other architecture specific)

high() should set a gpio configured as output to high logic level

low() should set a gpio configured as output to low logic level

value() should return either 1 or 0 to refect the state of a gpio configured as input

Lastly, a number of constants must be provided to be passed as first template parameter of the Gpio class, usually identifying the gpio port, while the second template parameter should be used to specify a gpio pin within a port.

The intended use is this: considering an architecture with two ports, PORTA and PORTB each with 8 pins. The header gpio_impl.h should provide two constants, for example named GPIOA_BASE and GPIOB_BASE.

The user can declare the hardware mapping between gpios and what is connected to them, usually in an header file. If for example PORTA.0 is connected to a button while PORTB.4 to a led, the header file might contain:

typedef Gpio<GPIOA_BASE,0> button;
typedef Gpio<GPIOB_BASE,4> led;

This allows the rest of the code to be written in terms of leds and buttons, without a reference to which pin they are connected to, something that might change.

A simple code using these gpios could be:

void blinkUntilButtonPressed()
{
led::mode(Mode::OUTPUT);
button::mode(Mode::INPUT);
for(;;)
{
if(button::value()==1) break;
led::high();
Thread::sleep(250);
led::low();
Thread::sleep(250);
}
}