mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-10-03 18:09:02 -04:00
113 lines
3.3 KiB
Markdown
113 lines
3.3 KiB
Markdown
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
|
[](https://github.com/RobTillaart/DAC8550/actions/workflows/arduino-lint.yml)
|
|
[](https://github.com/RobTillaart/DAC8550/actions/workflows/jsoncheck.yml)
|
|
[](https://github.com/RobTillaart/DAC8550/issues)
|
|
|
|
[](https://github.com/RobTillaart/DAC8550/blob/master/LICENSE)
|
|
[](https://github.com/RobTillaart/DAC8550/releases)
|
|
[](https://registry.platformio.org/libraries/robtillaart/DAC8550)
|
|
|
|
|
|
# DAC8550 - experimental
|
|
|
|
Arduino library for DAC8550 SPI Digital Analog Convertor.
|
|
|
|
|
|
## Description
|
|
|
|
The DAC8550 is a SPI based 16 bit DAC with one channel.
|
|
|
|
**WARNING** this library is not tested with real hardware yet.
|
|
It is derived from the DAC8551 library.
|
|
|
|
|
|
## Interface
|
|
|
|
```cpp
|
|
#include "DAC8550"
|
|
```
|
|
|
|
### Core
|
|
|
|
- **DAC8550(uint8_t slaveSelect)** Constructor for hardware SPI, the slaveSelect pin needs to be defined.
|
|
- **DAC8550(uint8_t spiData, uint8_t spiClock, uint8_t slaveSelect)** Constructor for the software SPI.
|
|
- **void begin()** initializes all pins to default state.
|
|
- **void setValue(uint16_t value)** set the value of the channel to 0 - 65535
|
|
- **uint16_t getValue()** returns the last value written.
|
|
|
|
|
|
### Hardware SPI
|
|
|
|
To be used only if one needs a specific speed.
|
|
|
|
- **void setSPIspeed(uint32_t speed)** set SPI transfer rate.
|
|
- **uint32_t getSPIspeed()** returns SPI transfer rate.
|
|
- **bool usesHWSPI()** returns true if HW SPI is used.
|
|
|
|
### ESP32 specific
|
|
|
|
- **void selectHSPI()** in case hardware SPI, the ESP32 has two options HSPI and VSPI.
|
|
- **void selectVSPI()** see above.
|
|
- **bool usesHSPI()** returns true if HSPI is used.
|
|
- **bool usesVSPI()** returns true if VSPI is used.
|
|
|
|
The **selectVSPI()** or the **selectHSPI()** needs to be called
|
|
BEFORE the **begin()** function.
|
|
|
|
|
|
#### Experimental
|
|
|
|
- **void setGPIOpins(uint8_t clk, uint8_t miso, uint8_t mosi, uint8_t select)** overrule GPIO pins of ESP32 for hardware SPI. needs to be called
|
|
AFTER the **begin()** function.
|
|
|
|
|
|
### Power down
|
|
|
|
check datasheet for details.
|
|
|
|
- **void setPowerDown(uint8_t powerDownMode)** sets power down mode. 0 - 3.
|
|
- **uint8_t getPowerDownMode()** returns last written mode.
|
|
|
|
|
|
| Power down mode | Value |
|
|
|:---------------------------|:-----:|
|
|
| DAC8550_POWERDOWN_NORMAL | 0 |
|
|
| DAC8550_POWERDOWN_1K | 1 |
|
|
| DAC8550_POWERDOWN_100K | 2 |
|
|
| DAC8550_POWERDOWN_HIGH_IMP | 3 |
|
|
|
|
|
|
## Operation
|
|
|
|
See examples
|
|
|
|
|
|
## Future
|
|
|
|
#### Must
|
|
|
|
- improve documentation
|
|
|
|
#### Should
|
|
|
|
- testing with real hardware
|
|
|
|
#### Could
|
|
|
|
- improve code incl readability
|
|
- spiData => spiDataOut
|
|
|
|
#### Wont
|
|
|
|
|
|
## Support
|
|
|
|
If you appreciate my libraries, you can support the development and maintenance.
|
|
Improve the quality of the libraries by providing issues and Pull Requests, or
|
|
donate through PayPal or GitHub sponsors.
|
|
|
|
Thank you,
|
|
|
|
|