GPIOWrapper.h

/*
        GPIOWrapper.h
        Copyright (c) 2025 Phil Schatzmann. All right reserved.
 
        This library is free software; you can redistribute it and/or
        modify it under the terms of the GNU Lesser General Public
        License as published by the Free Software Foundation; either
        version 2.1 of the License, or (at your option) any later version.
 
        This library is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
        Lesser General Public License for more details.
 
        You should have received a copy of the GNU Lesser General Public
        License along with this library; if not, write to the Free Software
        Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
 
#pragma once
#include "HardwareGPIO.h"
#include "HardwareService.h"
#include "Sources.h"
 
namespace arduino {
 
class GPIOWrapper : public HardwareGPIO {
 public:
  GPIOWrapper() = default;
  GPIOWrapper(GPIOSource& source) { setSource(&source); }
  GPIOWrapper(HardwareGPIO& gpio) { setGPIO(&gpio); }
  ~GPIOWrapper() = default;
  
  void pinMode(pin_size_t pinNumber, PinMode pinMode);
  
  void digitalWrite(pin_size_t pinNumber, PinStatus status);
  
  PinStatus digitalRead(pin_size_t pinNumber);
  
  int analogRead(pin_size_t pinNumber);
  
  void analogReference(uint8_t mode);
  
  void analogWrite(pin_size_t pinNumber, int value);
  
  void tone(uint8_t _pin, unsigned int frequency, unsigned long duration = 0);
  
  void noTone(uint8_t _pin);
  
  unsigned long pulseIn(uint8_t pin, uint8_t state,
                        unsigned long timeout = 1000000L);
  
  unsigned long pulseInLong(uint8_t pin, uint8_t state,
                            unsigned long timeout = 1000000L);
  
  void analogWriteFrequency(pin_size_t pin, uint32_t freq);
  
  void analogWriteResolution(uint8_t bits);
  
  void setGPIO(HardwareGPIO* gpio) {
    p_gpio = gpio;
    p_source = nullptr;
  }
  
  void setSource(GPIOSource* source) {
    p_source = source;
    p_gpio = nullptr;
  }
 
 protected:
  HardwareGPIO* p_gpio = nullptr;
  GPIOSource* p_source = nullptr;
 
  HardwareGPIO* getGPIO() {
    HardwareGPIO* result = p_gpio;
    if (result == nullptr && p_source != nullptr) {
      result = p_source->getGPIO();
    }
    return result;
  }
};
 
extern GPIOWrapper GPIO;
 
}  // namespace arduino