2022-02-14 14:53:03 -05:00
|
|
|
#pragma once
|
|
|
|
//
|
|
|
|
// FILE: X9C10X.h
|
|
|
|
// AUTHOR: Rob Tillaart
|
2022-02-23 09:57:01 -05:00
|
|
|
// VERSION: 0.1.3
|
2022-02-14 14:53:03 -05:00
|
|
|
// PURPOSE: Arduino Library for X9C10X series digital potentiometer.
|
2022-02-23 09:57:01 -05:00
|
|
|
// URL: https://github.com/RobTillaart/X9C10X
|
2022-02-14 14:53:03 -05:00
|
|
|
|
|
|
|
|
|
|
|
#include "Arduino.h"
|
|
|
|
|
2022-02-23 09:57:01 -05:00
|
|
|
#define X9C10X_LIB_VERSION (F("0.1.3"))
|
2022-02-14 14:53:03 -05:00
|
|
|
|
|
|
|
|
|
|
|
class X9C10X
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
// ohm can be actual measured value e.g 9950 ohm (calibration)
|
2022-02-16 14:14:45 -05:00
|
|
|
X9C10X(uint32_t maxOhm = 10000);
|
2022-02-14 14:53:03 -05:00
|
|
|
|
|
|
|
void begin(uint8_t pulsePin, uint8_t directionPin, uint8_t selectPin, uint8_t position = 0);
|
|
|
|
|
|
|
|
// position = 0..99
|
2022-02-23 09:57:01 -05:00
|
|
|
// forced = true will ignore the cached position
|
|
|
|
// takes up to 150 steps as one cannot read the position from device.
|
|
|
|
// forced = default false as that is safer and backwards compatible.
|
|
|
|
void setPosition(uint8_t position, bool forced = false);
|
2022-02-14 14:53:03 -05:00
|
|
|
uint8_t getPosition() { return _position; };
|
|
|
|
|
|
|
|
// step size 1.
|
2022-02-23 09:57:01 -05:00
|
|
|
bool incr();
|
|
|
|
bool decr();
|
2022-02-14 14:53:03 -05:00
|
|
|
|
|
|
|
// use with care
|
|
|
|
uint8_t store();
|
|
|
|
|
|
|
|
// current resistance in ohm.
|
|
|
|
// Q: rounding needed?
|
2022-02-16 14:14:45 -05:00
|
|
|
uint32_t getOhm() { return (_maxOhm * _position + 49) / 99; };
|
2022-02-14 14:53:03 -05:00
|
|
|
// misc
|
2022-02-16 14:14:45 -05:00
|
|
|
uint32_t getMaxOhm() { return _maxOhm; };
|
2022-02-14 14:53:03 -05:00
|
|
|
|
|
|
|
// Q: needed?
|
|
|
|
uint16_t getType() { return _type; };
|
|
|
|
|
|
|
|
|
|
|
|
protected:
|
|
|
|
uint8_t _pulsePin;
|
|
|
|
uint8_t _directionPin;
|
|
|
|
uint8_t _selectPin;
|
|
|
|
|
2022-02-16 14:14:45 -05:00
|
|
|
uint32_t _maxOhm;
|
2022-02-14 14:53:03 -05:00
|
|
|
uint8_t _position;
|
|
|
|
uint16_t _type = 0; // needed?
|
|
|
|
|
|
|
|
void _move(uint8_t direction, uint8_t steps = 1);
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
/////////////////////////////////////////////////////////
|
|
|
|
//
|
|
|
|
// DERIVED
|
|
|
|
//
|
|
|
|
class X9C102 : public X9C10X
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
X9C102(uint32_t ohm = 1000);
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
class X9C103 : public X9C10X
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
X9C103(uint32_t ohm = 10000);
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
class X9C104 : public X9C10X
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
X9C104(uint32_t ohm = 100000);
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
class X9C503 : public X9C10X
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
X9C503(uint32_t ohm = 50000);
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// -- END OF FILE --
|
|
|
|
|