2017-08-20 16:11:38 -04:00
|
|
|
//
|
|
|
|
// FILE: PinOutGroup.cpp
|
|
|
|
// AUTHOR: Rob Tillaart
|
2020-11-27 05:28:57 -05:00
|
|
|
// VERSION: 0.1.2
|
2017-08-20 16:11:38 -04:00
|
|
|
// DATE: 2017-04-26
|
|
|
|
// PURPOSE: PinOutGroup library for Arduino
|
2020-11-27 05:28:57 -05:00
|
|
|
// goal is to easily change a group of pins that logically
|
2017-08-20 16:11:38 -04:00
|
|
|
// belong to each other e.g. 8 data pins of a parallel printer.
|
|
|
|
// these pins can be in any order.
|
2020-11-27 05:28:57 -05:00
|
|
|
// URL:
|
2020-05-20 03:53:04 -04:00
|
|
|
// http://forum.arduino.cc/index.php?topic=469599.0
|
2017-08-20 16:11:38 -04:00
|
|
|
//
|
2020-05-20 03:53:04 -04:00
|
|
|
|
|
|
|
// 0.1.0 - 20-08-2017 initial version (based upon experimental pinGroup)
|
2020-11-27 05:28:57 -05:00
|
|
|
// 0.1.1 - 2020-05-19 main refactor;
|
2020-05-20 03:53:04 -04:00
|
|
|
// added tests; added clear(); added write(idx, value)
|
|
|
|
// renamed set to write() to be in line with digitalWrite()
|
2020-11-27 05:28:57 -05:00
|
|
|
// 0.1.2 2020-06-19 fix library.json
|
|
|
|
//
|
2017-08-20 16:11:38 -04:00
|
|
|
|
|
|
|
#include "PinOutGroup.h"
|
|
|
|
|
|
|
|
PinOutGroup::PinOutGroup()
|
|
|
|
{
|
2020-05-20 03:53:04 -04:00
|
|
|
clear();
|
|
|
|
}
|
|
|
|
|
|
|
|
void PinOutGroup::clear()
|
|
|
|
{
|
|
|
|
// safety: set all to LOW before cleaning up.
|
|
|
|
for (uint8_t i = 0; i < _size; i++) digitalWrite(_pins[i], LOW);
|
2017-08-20 16:11:38 -04:00
|
|
|
_size = 0;
|
|
|
|
}
|
|
|
|
|
2020-05-20 03:53:04 -04:00
|
|
|
bool PinOutGroup::add(uint8_t sz, uint8_t* ar, uint8_t value)
|
2017-08-20 16:11:38 -04:00
|
|
|
{
|
|
|
|
bool b = true;
|
2020-11-27 05:28:57 -05:00
|
|
|
for (uint8_t i = 0; i < sz && b; i++)
|
2017-08-20 16:11:38 -04:00
|
|
|
{
|
|
|
|
b = b && add(ar[i], value);
|
|
|
|
}
|
|
|
|
return b;
|
|
|
|
}
|
|
|
|
|
2020-05-20 03:53:04 -04:00
|
|
|
bool PinOutGroup::add(uint8_t pin, uint8_t value)
|
2017-08-20 16:11:38 -04:00
|
|
|
{
|
2020-05-20 03:53:04 -04:00
|
|
|
if (_size >= PINOUTGROUP_MAXSIZE) return false;
|
|
|
|
|
|
|
|
_pins[_size] = pin;
|
|
|
|
pinMode(pin, OUTPUT);
|
|
|
|
digitalWrite(pin, value);
|
|
|
|
_size++;
|
|
|
|
return true;
|
2017-08-20 16:11:38 -04:00
|
|
|
}
|
|
|
|
|
2020-05-20 03:53:04 -04:00
|
|
|
uint8_t PinOutGroup::write(uint16_t value)
|
2017-08-20 16:11:38 -04:00
|
|
|
{
|
|
|
|
uint16_t changed = _lastValue ^ value; // detect pins that changed
|
|
|
|
if (changed == 0) return 0;
|
|
|
|
|
|
|
|
uint16_t bitMask = 1;
|
|
|
|
uint8_t changeCount = 0;
|
|
|
|
for (uint8_t i = 0; i < _size; i++)
|
|
|
|
{
|
2020-11-27 05:28:57 -05:00
|
|
|
if ((changed & bitMask) > 0)
|
2017-08-20 16:11:38 -04:00
|
|
|
{
|
|
|
|
digitalWrite(_pins[i], (value & bitMask) > 0);
|
|
|
|
changeCount++;
|
|
|
|
}
|
|
|
|
bitMask <<= 1;
|
|
|
|
}
|
|
|
|
_lastValue = value;
|
|
|
|
return changeCount;
|
|
|
|
}
|
2020-05-20 03:53:04 -04:00
|
|
|
|
|
|
|
uint8_t PinOutGroup::write(uint8_t idx, uint8_t value)
|
|
|
|
{
|
|
|
|
if (idx >= _size) return 0;
|
|
|
|
uint16_t mask = (1 << idx);
|
|
|
|
uint16_t lv = _lastValue & mask;
|
|
|
|
|
|
|
|
if ((value > 0) == (lv > 0)) return 0; // no change
|
|
|
|
|
|
|
|
digitalWrite(_pins[idx], value);
|
|
|
|
if (value == LOW) _lastValue &= ~mask;
|
|
|
|
else _lastValue |= mask;
|
|
|
|
return 1;
|
|
|
|
}
|
2017-08-20 16:11:38 -04:00
|
|
|
|
2020-05-20 03:53:04 -04:00
|
|
|
// --- END OF FILE ---
|