0.1.1 DAC8550

Author: RobTillaart

libraries/DAC8550/.arduino-ci.yml

@@ -0,0 +1,7 @@
+compile:
+  # Choosing to run compilation tests on 2 different Arduino platforms
+  platforms:
+    - uno
+    - leonardo
+    - due
+    - zero

libraries/DAC8550/.github/workflows/arduino-lint.yml

@@ -0,0 +1,13 @@
+
+name: Arduino-lint
+
+on: [push, pull_request]
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: arduino/arduino-lint-action@v1
+        with:
+          library-manager: update
+          compliance: strict

libraries/DAC8550/.github/workflows/arduino_test_runner.yml

@@ -0,0 +1,17 @@
+---
+name: Arduino CI
+
+on: [push, pull_request]
+
+jobs:
+  runTest:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.6
+      - run: |
+          gem install arduino_ci
+          arduino_ci.rb

libraries/DAC8550/.github/workflows/jsoncheck.yml

@@ -0,0 +1,18 @@
+name: JSON check
+
+on:
+  push:
+    paths:
+      - '**.json'
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: json-syntax-check
+        uses: limitusus/json-syntax-check@v1
+        with:
+          pattern: "\\.json$"
+

libraries/DAC8550/DAC8550.cpp

@@ -0,0 +1,167 @@
+//
+//    FILE: DAC8550.cpp
+//  AUTHOR: Rob Tillaart
+// PURPOSE: Arduino library for DAC8550 SPI Digital Analog Convertor
+// VERSION: 0.1.1
+//     URL: https://github.com/RobTillaart/DAC8550
+//
+//  HISTORY:
+//  0.1.0  2021-02-04 initial version (based upon DAC8551)
+//  0.1.1  2021-08-29 add support for HSPI/VSPI ESP32
+//                    some performance improvements.
+
+
+
+#include "DAC8550.h"
+
+
+DAC8550::DAC8550(uint8_t slaveSelect)
+{
+  _hwSPI  = true;
+  _select = slaveSelect;
+}
+
+
+DAC8550::DAC8550(uint8_t spiData, uint8_t spiClock, uint8_t slaveSelect)
+{
+  _hwSPI   = false;
+  _dataOut = spiData;
+  _clock   = spiClock;
+  _select  = slaveSelect;
+}
+
+
+// initializes the SPI
+// and sets internal state
+void DAC8550::begin()
+{
+  pinMode(_select, OUTPUT);
+  digitalWrite(_select, HIGH);
+
+  _spi_settings = SPISettings(_SPIspeed, MSBFIRST, SPI_MODE1);
+
+  if(_hwSPI)
+  {
+    #if defined(ESP32)
+    if (_useHSPI)      // HSPI
+    {
+      mySPI = new SPIClass(HSPI);
+      mySPI->end();
+      mySPI->begin(14, 12, 13, _select);   // CLK=14 MISO=12 MOSI=13
+    }
+    else               // VSPI
+    {
+      mySPI = new SPIClass(VSPI);
+      mySPI->end();
+      mySPI->begin(18, 19, 23, _select);   // CLK=18 MISO=19 MOSI=23
+    }
+    #else              // generic hardware SPI
+    mySPI = &SPI;
+    mySPI->end();
+    mySPI->begin();
+    #endif
+    delay(1);
+  }
+  else                 // software SPI
+  {
+    pinMode(_dataOut, OUTPUT);
+    pinMode(_clock, OUTPUT);
+    digitalWrite(_dataOut, LOW);
+    digitalWrite(_clock, LOW);
+  }
+
+  _register = 0;
+  _value = 0;
+}
+
+
+#if defined(ESP32)
+void DAC8550::setGPIOpins(uint8_t clk, uint8_t miso, uint8_t mosi, uint8_t select)
+{
+  _clock   = clk;
+  _dataOut = mosi;
+  _select  = select;
+  pinMode(_select, OUTPUT);
+  digitalWrite(_select, HIGH);
+
+  mySPI->end();  // disable SPI 
+  mySPI->begin(clk, miso, mosi, select);
+}
+#endif
+
+
+// value = 0..65535
+void DAC8550::setValue(uint16_t value)
+{
+  _value = value;
+  updateDevice();
+}
+
+
+// returns 0..65535
+uint16_t DAC8550::getValue()
+{
+  return _value;
+}
+
+
+void DAC8550::setPowerDown(uint8_t powerDownMode)
+{
+  _register = powerDownMode;
+  updateDevice();
+}
+
+uint8_t DAC8550::getPowerDownMode()
+{
+  return _register & 0x03;
+}
+
+
+void DAC8550::setSPIspeed(uint32_t speed)
+{
+  _SPIspeed = speed;
+  _spi_settings = SPISettings(_SPIspeed, MSBFIRST, SPI_MODE1);
+};
+
+
+//////////////////////////////////////////////////////////////////
+//
+// PRIVATE
+//
+void DAC8550::updateDevice()
+{
+  uint8_t configRegister = _register;
+
+  digitalWrite(_select, LOW);
+  if (_hwSPI)
+  {
+    mySPI->beginTransaction(_spi_settings);
+    mySPI->transfer(configRegister);
+    mySPI->transfer(_value >> 8);
+    mySPI->transfer(_value & 0xFF);
+    mySPI->endTransaction();
+  }
+  else // Software SPI 
+  {
+    swSPI_transfer(configRegister);
+    swSPI_transfer(_value >> 8);
+    swSPI_transfer(_value & 0xFF);
+  }
+  digitalWrite(_select, HIGH);
+}
+
+
+// simple one mode version
+void DAC8550::swSPI_transfer(uint8_t value)
+{
+  uint8_t clk = _clock;
+  uint8_t dao = _dataOut;
+  for (uint8_t mask = 0x80; mask; mask >>= 1)
+  {
+    digitalWrite(dao,(value & mask));
+    digitalWrite(clk, HIGH);
+    digitalWrite(clk, LOW);
+  }
+}
+
+// -- END OF FILE --

libraries/DAC8550/DAC8550.h

@@ -0,0 +1,79 @@
+#pragma once
+//
+//    FILE: DAC8550.h
+//  AUTHOR: Rob Tillaart
+// PURPOSE: Arduino library for DAC8550 SPI Digital Analog Convertor  
+// VERSION: 0.1.1
+// HISTORY: See DAC8550.cpp
+//     URL: https://github.com/RobTillaart/DAC8550
+//
+
+
+#include "Arduino.h"
+#include "SPI.h"
+
+
+#define DAC8550_LIB_VERSION            (F("0.1.1"))
+
+
+#define DAC8550_POWERDOWN_NORMAL        0
+#define DAC8550_POWERDOWN_1K            1
+#define DAC8550_POWERDOWN_100K          2
+#define DAC8550_POWERDOWN_HIGH_IMP      3
+
+
+class DAC8550
+{
+public:
+  DAC8550(uint8_t slaveSelect);
+  DAC8550(uint8_t spiData, uint8_t spiClock, uint8_t slaveSelect);
+
+  void     begin();
+
+  void     setValue(uint16_t value);
+  uint16_t getValue();
+
+  void     setPowerDown(uint8_t powerDownMode);
+  uint8_t  getPowerDownMode();
+
+  //       speed in Hz
+  void     setSPIspeed(uint32_t speed);
+  uint32_t getSPIspeed() { return _SPIspeed; };
+
+  bool     usesHWSPI() { return _hwSPI; };
+
+  // ESP32 specific
+  #if defined(ESP32)
+  void     selectHSPI() { _useHSPI = true;  };
+  void     selectVSPI() { _useHSPI = false; };
+  bool     usesHSPI()   { return _useHSPI;  };
+  bool     usesVSPI()   { return !_useHSPI; };
+
+  // to overrule ESP32 default hardware pins
+  void     setGPIOpins(uint8_t clk, uint8_t miso, uint8_t mosi, uint8_t select);
+  #endif
+
+private:
+  uint8_t  _dataOut     = 255;
+  uint8_t  _clock       = 255;
+  uint8_t  _select      = 255;
+
+  bool     _hwSPI       = false;
+  uint16_t _value       = 0;
+  uint8_t  _register    = 0;
+
+  uint32_t _SPIspeed    = 16000000;
+
+  void     updateDevice();
+  void     swSPI_transfer(uint8_t value);
+
+
+  SPIClass    * mySPI;
+  SPISettings _spi_settings;
+
+  #if defined(ESP32)
+  bool        _useHSPI = true;
+  #endif
+};
+
+// -- END OF FILE --

libraries/DAC8550/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2021 Rob Tillaart
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.