Finished library implementation

This commit is contained in:
BlackMark 2019-07-26 18:49:53 +02:00
parent 7396831828
commit 468368692e

514
io.hpp
View File

@ -1,69 +1,39 @@
/* #pragma once
* Copyright (c) by BlackMark 2015-2019
* Date 02/01/2019
* Version 3.1
*/
#ifndef INOUT_H
#define INOUT_H
//////////////////////////////////////////////////////////////////////////
#include <stdint.h> #include <stdint.h>
#include <avr/io.h> #include <avr/io.h>
/************************************************************************/ //////////////////////////////////////////////////////////////////////////
// Preprocessor defines
#define GPIO_32 \
defined(__AVR_ATmega32__) || defined(__AVR_ATmega32A__) || defined(__AVR_ATmega644P__) || \
defined(__AVR_ATmega1284P__)
#define GPIO_23 \
defined(__AVR_ATmega8__) || defined(__AVR_ATmega8A__) || defined(__AVR_ATmega168A__) || defined(__AVR_ATmega328P__)
#define GPIO_6 defined(__AVR_ATtiny13A__) || defined(__AVR_ATtiny85__)
#define PORT_A_AVAILABLE GPIO_32
#define PORT_B_AVAILABLE GPIO_32 || GPIO_23 || GPIO_6
#define PORT_C_AVAILABLE GPIO_32 || GPIO_23
#define PORT_D_AVAILABLE GPIO_32 || GPIO_23
#define PIN_B6_AVAILABLE GPIO_32 || GPIO_23
#define PIN_B7_AVAILABLE GPIO_32 || GPIO_23
#define PIN_C7_AVAILABLE GPIO_32
#define FORCE_INLINE __attribute__((always_inline))
////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////
namespace InOut // Library implementation
{
#define AVR_DIP40 defined (__AVR_ATmega32A__) || defined (__AVR_ATmega644P__) || defined (__AVR_ATmega1284P__)
#define AVR_DIP28 defined (__AVR_ATmega8__) || defined (__AVR_ATmega8A__) || defined (__AVR_ATmega168A__) || defined (__AVR_ATmega328P__)
#define AVR_DIP8 defined (__AVR_ATtiny13A__) || defined (__AVR_ATtiny85__)
#if AVR_DIP40 namespace io {
static constexpr volatile uint8_t *IO_PINA = &PINA;
static constexpr volatile uint8_t *IO_DDRA = &DDRA;
static constexpr volatile uint8_t *IO_PORTA = &PORTA;
#else
static constexpr volatile uint8_t *IO_PINA = nullptr;
static constexpr volatile uint8_t *IO_DDRA = nullptr;
static constexpr volatile uint8_t *IO_PORTA = nullptr;
#endif
#if AVR_DIP40 || AVR_DIP28 || AVR_DIP8 enum class Dir { IN, OUT };
static constexpr volatile uint8_t *IO_PINB = &PINB;
static constexpr volatile uint8_t *IO_DDRB = &DDRB;
static constexpr volatile uint8_t *IO_PORTB = &PORTB;
#else
static constexpr volatile uint8_t *IO_PINB = nullptr;
static constexpr volatile uint8_t *IO_DDRB = nullptr;
static constexpr volatile uint8_t *IO_PORTB = nullptr;
#endif
#if AVR_DIP40 || AVR_DIP28 enum class P {
static constexpr volatile uint8_t *IO_PINC = &PINC; #if PORT_A_AVAILABLE
static constexpr volatile uint8_t *IO_DDRC = &DDRC;
static constexpr volatile uint8_t *IO_PORTC = &PORTC;
#else
static constexpr volatile uint8_t *IO_PINC = nullptr;
static constexpr volatile uint8_t *IO_DDRC = nullptr;
static constexpr volatile uint8_t *IO_PORTC = nullptr;
#endif
#if AVR_DIP40 || AVR_DIP28
static constexpr volatile uint8_t *IO_PIND = &PIND;
static constexpr volatile uint8_t *IO_DDRD = &DDRD;
static constexpr volatile uint8_t *IO_PORTD = &PORTD;
#else
static constexpr volatile uint8_t *IO_PIND = nullptr;
static constexpr volatile uint8_t *IO_DDRD = nullptr;
static constexpr volatile uint8_t *IO_PORTD = nullptr;
#endif
enum class Pin
{
#if AVR_DIP40
A0 = 0x00, A0 = 0x00,
A1 = 0x01, A1 = 0x01,
A2 = 0x02, A2 = 0x02,
@ -73,17 +43,23 @@ namespace InOut
A6 = 0x06, A6 = 0x06,
A7 = 0x07, A7 = 0x07,
#endif #endif
#if AVR_DIP40 || AVR_DIP28 || AVR_DIP8
#if PORT_B_AVAILABLE
B0 = 0x10, B0 = 0x10,
B1 = 0x11, B1 = 0x11,
B2 = 0x12, B2 = 0x12,
B3 = 0x13, B3 = 0x13,
B4 = 0x14, B4 = 0x14,
B5 = 0x15, B5 = 0x15,
#endif #if PIN_B6_AVAILABLE
#if AVR_DIP40 || AVR_DIP28
B6 = 0x16, B6 = 0x16,
#endif
#if PIN_B7_AVAILABLE
B7 = 0x17, B7 = 0x17,
#endif
#endif
#if PORT_C_AVAILABLE
C0 = 0x20, C0 = 0x20,
C1 = 0x21, C1 = 0x21,
C2 = 0x22, C2 = 0x22,
@ -91,11 +67,12 @@ namespace InOut
C4 = 0x24, C4 = 0x24,
C5 = 0x25, C5 = 0x25,
C6 = 0x26, C6 = 0x26,
#endif #if PIN_C7_AVAILABLE
#if AVR_DIP40
C7 = 0x27, C7 = 0x27,
#endif #endif
#if AVR_DIP40 || AVR_DIP28 #endif
#if PORT_D_AVAILABLE
D0 = 0x30, D0 = 0x30,
D1 = 0x31, D1 = 0x31,
D2 = 0x32, D2 = 0x32,
@ -107,208 +84,291 @@ namespace InOut
#endif #endif
}; };
enum class Port enum class Bus {
{ #if PORT_A_AVAILABLE
#if AVR_DIP40 A = 0x00,
A = Pin::A0,
#endif #endif
#if AVR_DIP40 || AVR_DIP28 || AVR_DIP8 #if PORT_B_AVAILABLE
B = Pin::B0, B = 0x01,
#endif #endif
#if AVR_DIP40 || AVR_DIP28 #if PORT_C_AVAILABLE
C = Pin::C0, C = 0x02,
D = Pin::D0, #endif
#if PORT_D_AVAILABLE
D = 0x03,
#endif #endif
}; };
enum class Dir
{
IN,
OUT
};
enum class Type
{
DDR,
PIN,
PORT
};
constexpr volatile uint8_t* getPort( Pin enmPin, Type enmType )
{
volatile uint8_t *vpui8Port = nullptr;
uint8_t ui8Port = static_cast<uint16_t>( enmPin ) >> 4 & 0x0F;
switch( ui8Port )
{
case 0:
{
if( enmType == Type::DDR )
vpui8Port = IO_DDRA;
else if( enmType == Type::PIN )
vpui8Port = IO_PINA;
else if( enmType == Type::PORT )
vpui8Port = IO_PORTA;
break;
}
case 1:
{
if( enmType == Type::DDR )
vpui8Port = IO_DDRB;
else if( enmType == Type::PIN )
vpui8Port = IO_PINB;
else if( enmType == Type::PORT )
vpui8Port = IO_PORTB;
break;
}
case 2:
{
if( enmType == Type::DDR )
vpui8Port = IO_DDRC;
else if( enmType == Type::PIN )
vpui8Port = IO_PINC;
else if( enmType == Type::PORT )
vpui8Port = IO_PORTC;
break;
}
case 3:
{
if( enmType == Type::DDR )
vpui8Port = IO_DDRD;
else if( enmType == Type::PIN )
vpui8Port = IO_PIND;
else if( enmType == Type::PORT )
vpui8Port = IO_PORTD;
break;
}
}
return vpui8Port;
}
constexpr uint8_t getPin( Pin enmPin )
{
return static_cast<uint16_t>( enmPin ) & 0x0F;
}
}
/************************************************************************/
////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////
template<InOut::Pin enmPin> // Implementation details
class InOutPin
namespace detail {
#if PORT_A_AVAILABLE
static constexpr volatile uint8_t *PORT_A_DIR_REG = &DDRA;
static constexpr volatile uint8_t *PORT_A_OUTPUT_REG = &PORTA;
static constexpr volatile uint8_t *PORT_A_INPUT_REG = &PINA;
#else
static constexpr volatile uint8_t *PORT_A_DIR_REG = nullptr;
static constexpr volatile uint8_t *PORT_A_OUTPUT_REG = nullptr;
static constexpr volatile uint8_t *PORT_A_INPUT_REG = nullptr;
#endif
#if PORT_B_AVAILABLE
static constexpr volatile uint8_t *PORT_B_DIR_REG = &DDRB;
static constexpr volatile uint8_t *PORT_B_OUTPUT_REG = &PORTB;
static constexpr volatile uint8_t *PORT_B_INPUT_REG = &PINB;
#else
static constexpr volatile uint8_t *PORT_B_DIR_REG = nullptr;
static constexpr volatile uint8_t *PORT_B_OUTPUT_REG = nullptr;
static constexpr volatile uint8_t *PORT_B_INPUT_REG = nullptr;
#endif
#if PORT_C_AVAILABLE
static constexpr volatile uint8_t *PORT_C_DIR_REG = &DDRC;
static constexpr volatile uint8_t *PORT_C_OUTPUT_REG = &PORTC;
static constexpr volatile uint8_t *PORT_C_INPUT_REG = &PINC;
#else
static constexpr volatile uint8_t *PORT_C_DIR_REG = nullptr;
static constexpr volatile uint8_t *PORT_C_OUTPUT_REG = nullptr;
static constexpr volatile uint8_t *PORT_C_INPUT_REG = nullptr;
#endif
#if PORT_D_AVAILABLE
static constexpr volatile uint8_t *PORT_D_DIR_REG = &DDRD;
static constexpr volatile uint8_t *PORT_D_OUTPUT_REG = &PORTD;
static constexpr volatile uint8_t *PORT_D_INPUT_REG = &PIND;
#else
static constexpr volatile uint8_t *PORT_D_DIR_REG = nullptr;
static constexpr volatile uint8_t *PORT_D_OUTPUT_REG = nullptr;
static constexpr volatile uint8_t *PORT_D_INPUT_REG = nullptr;
#endif
static constexpr auto getBus(const P pin)
{ {
// Upper 4 bits of pin encode which port this pin is on
uint8_t port = static_cast<uint8_t>(pin) >> 4 & 0x0F;
return static_cast<Bus>(port);
}
static constexpr auto getPin(const P pin)
{
// Lower 4 bits of pin encode which pin bit it is
uint8_t pinBit = static_cast<uint8_t>(pin) & 0x0F;
return pinBit;
}
static constexpr auto getDDR(const Bus bus)
{
switch (static_cast<uint8_t>(bus)) {
case 0: // Bus::A
return PORT_A_DIR_REG;
case 1: // Bus::B
return PORT_B_DIR_REG;
case 2: // Bus::C
return PORT_C_DIR_REG;
case 3: // Bus::D
return PORT_D_DIR_REG;
}
}
static constexpr auto getPORT(const Bus bus)
{
switch (static_cast<uint8_t>(bus)) {
case 0: // Bus::A
return PORT_A_OUTPUT_REG;
case 1: // Bus::B
return PORT_B_OUTPUT_REG;
case 2: // Bus::C
return PORT_C_OUTPUT_REG;
case 3: // Bus::D
return PORT_D_OUTPUT_REG;
}
}
static constexpr auto getPIN(const Bus bus)
{
switch (static_cast<uint8_t>(bus)) {
case 0: // Bus::A
return PORT_A_INPUT_REG;
case 1: // Bus::B
return PORT_B_INPUT_REG;
case 2: // Bus::C
return PORT_C_INPUT_REG;
case 3: // Bus::D
return PORT_D_INPUT_REG;
}
}
} // namespace detail
//////////////////////////////////////////////////////////////////////////
// Zero overhead Pin object for pretty code without losing performance
template <const P pin>
class Pin {
public: public:
static inline void direction( InOut::Dir enmDir ) __attribute__( (always_inline) ); // Pin objects cannot be moved or copied
static inline void pullup( bool bPullup ) __attribute__( (always_inline) ); Pin(const Pin &) = delete;
Pin(Pin &&) = delete;
Pin &operator=(const Pin &) = delete;
Pin &operator=(Pin &&) = delete;
static inline bool read() __attribute__( (always_inline) ); // The only valid way to create a Pin object is with the default constructor
static inline void write( bool bValue ) __attribute__( (always_inline) ); Pin() = default;
static inline void toggle() __attribute__( (always_inline) );
};
////////////////////////////////////////////////////////////////////////// static inline void dir(const Dir dir) FORCE_INLINE
template<InOut::Pin enmPin>
inline void InOutPin<enmPin>::direction( InOut::Dir enmDir )
{ {
constexpr volatile uint8_t *vpui8DDR = InOut::getPort( enmPin, InOut::Type::DDR ); constexpr auto bus = detail::getBus(pin);
constexpr uint8_t ui8Pin = InOut::getPin( enmPin ); constexpr auto dirReg = detail::getDDR(bus);
constexpr auto pinBit = detail::getPin(pin);
if( enmDir == InOut::Dir::OUT ) if (dir == Dir::IN)
*vpui8DDR |= ( 1 << ui8Pin ); *dirReg &= ~(1 << pinBit);
else if (dir == Dir::OUT)
*dirReg |= (1 << pinBit);
}
static inline void pullup(const bool enable) FORCE_INLINE
{
constexpr auto bus = detail::getBus(pin);
constexpr auto portReg = detail::getPORT(bus);
constexpr auto pinBit = detail::getPin(pin);
if (enable)
*portReg |= (1 << pinBit);
else else
*vpui8DDR &= ~( 1 << ui8Pin ); *portReg &= ~(1 << pinBit);
} }
////////////////////////////////////////////////////////////////////////// static inline void write(const bool value) FORCE_INLINE
template<InOut::Pin enmPin>
inline void InOutPin<enmPin>::pullup( bool bPullup )
{ {
write( bPullup ); constexpr auto bus = detail::getBus(pin);
constexpr auto portReg = detail::getPORT(bus);
constexpr auto pinBit = detail::getPin(pin);
if (value)
*portReg |= (1 << pinBit);
else
*portReg &= ~(1 << pinBit);
} }
////////////////////////////////////////////////////////////////////////// static inline void toggle() FORCE_INLINE
template<InOut::Pin enmPin>
inline bool InOutPin<enmPin>::read()
{ {
constexpr volatile uint8_t *vpui8PIN = InOut::getPort( enmPin, InOut::Type::PIN ); constexpr auto bus = detail::getBus(pin);
constexpr uint8_t ui8Pin = InOut::getPin( enmPin ); constexpr auto portReg = detail::getPORT(bus);
constexpr auto pinBit = detail::getPin(pin);
if( *vpui8PIN >> ui8Pin & 1 ) *portReg ^= (1 << pinBit);
}
static inline bool read() FORCE_INLINE
{
constexpr auto bus = detail::getBus(pin);
constexpr auto pinReg = detail::getPIN(bus);
constexpr auto pinBit = detail::getPin(pin);
if (*pinReg >> pinBit & 1)
return true; return true;
return false; return false;
} }
////////////////////////////////////////////////////////////////////////// Pin &operator=(const bool value) FORCE_INLINE
template<InOut::Pin enmPin>
inline void InOutPin<enmPin>::write( bool bValue )
{ {
constexpr volatile uint8_t *vpui8PORT = InOut::getPort( enmPin, InOut::Type::PORT ); write(value);
constexpr uint8_t ui8Pin = InOut::getPin( enmPin ); return *this;
if( bValue )
*vpui8PORT |= ( 1 << ui8Pin );
else
*vpui8PORT &= ~( 1 << ui8Pin );
} }
////////////////////////////////////////////////////////////////////////// operator bool() const FORCE_INLINE
template<InOut::Pin enmPin>
inline void InOutPin<enmPin>::toggle()
{ {
constexpr volatile uint8_t *vpui8PORT = InOut::getPort( enmPin, InOut::Type::PORT ); return read();
constexpr uint8_t ui8Pin = InOut::getPin( enmPin );
*vpui8PORT ^= ( 1 << ui8Pin );
} }
/************************************************************************/
//////////////////////////////////////////////////////////////////////////
template<InOut::Port enmPort>
class InOutPort
{
public:
static inline void direction( InOut::Dir enmDir ) __attribute__( (always_inline) );
static inline void pullup( bool bPullup ) __attribute__( (always_inline) );
static inline uint8_t read() __attribute__( (always_inline) );
static inline void write( uint8_t ui8Value ) __attribute__( (always_inline) );
}; };
////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////
template<InOut::Port enmPort> // Zero overhead Port object for pretty code without losing performance
inline void InOutPort<enmPort>::direction( InOut::Dir enmDir )
template <const Bus port>
class Port {
public:
// Port objects cannot be moved or copied
Port(const Port &) = delete;
Port(Port &&) = delete;
Port &operator=(const Port &) = delete;
Port &operator=(Port &&) = delete;
// The only valid way to create a Port object is with the default constructor
Port() = default;
static inline void dir(const Dir dir) FORCE_INLINE
{ {
constexpr volatile uint8_t *vpui8DDR = InOut::getPort( static_cast<InOut::Pin>( enmPort ), InOut::Type::DDR ); constexpr auto dirReg = detail::getDDR(port);
*vpui8DDR = ( enmDir == InOut::Dir::OUT ) ? 0xFF : 0x00;
if (dir == Dir::IN)
*dirReg = 0x00;
else if (dir == Dir::OUT)
*dirReg = 0xFF;
} }
static inline void pullup(const bool enable) FORCE_INLINE
{
constexpr auto portReg = detail::getPORT(port);
if (enable)
*portReg = 0xFF;
else
*portReg = 0x00;
}
static inline void write(const uint8_t value) FORCE_INLINE
{
constexpr auto portReg = detail::getPORT(port);
*portReg = value;
}
static inline void invert() FORCE_INLINE
{
constexpr auto portReg = detail::getPORT(port);
*portReg = ~(*portReg);
}
static inline uint8_t read() FORCE_INLINE
{
constexpr auto pinReg = detail::getPIN(port);
return *pinReg;
}
inline Port &operator=(const uint8_t value) FORCE_INLINE
{
write(value);
return *this;
}
inline operator uint8_t() const FORCE_INLINE
{
return read();
}
};
} // namespace io
////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////
template<InOut::Port enmPort>
inline void InOutPort<enmPort>::pullup( bool bPullup )
{
write( bPullup ? 0xFF : 0x00 );
}
////////////////////////////////////////////////////////////////////////// #undef GPIO_32
template<InOut::Port enmPort> #undef GPIO_23
inline uint8_t InOutPort<enmPort>::read() #undef GPIO_6
{
constexpr volatile uint8_t *vpui8PIN = InOut::getPort( static_cast<InOut::Pin>( enmPort ), InOut::Type::PIN );
return *vpui8PIN;
}
////////////////////////////////////////////////////////////////////////// #undef PORT_A_AVAILABLE
template<InOut::Port enmPort> #undef PORT_B_AVAILABLE
inline void InOutPort<enmPort>::write( uint8_t ui8Value ) #undef PORT_C_AVAILABLE
{ #undef PORT_D_AVAILABLE
constexpr volatile uint8_t *vpui8PORT = InOut::getPort( static_cast<InOut::Pin>( enmPort ), InOut::Type::PORT );
*vpui8PORT = ui8Value;
}
#endif #undef PIN_B6_AVAILABLE
#undef PIN_B7_AVAILABLE
#undef PIN_C7_AVAILABLE
#undef FORCE_INLINE