mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-10-03 18:09:02 -04:00
294 lines
9.7 KiB
Markdown
294 lines
9.7 KiB
Markdown
|
||
[](https://github.com/marketplace/actions/arduino_ci)
|
||
[](https://github.com/RobTillaart/AD985X/actions/workflows/jsoncheck.ym)l
|
||
[](https://github.com/RobTillaart/AD985X/actions/workflows/arduino-lint.yml)
|
||
[](https://github.com/RobTillaart/AD985X/blob/master/LICENSE)
|
||
[](https://github.com/RobTillaart/AD985X/releases)
|
||
|
||
|
||
# AD985X
|
||
|
||
Arduino library for AD9850 and AD9851 function generators.
|
||
|
||
|
||
## Description
|
||
|
||
Library for the AD9850 and AD9851 function generators.
|
||
The library has a AD9850 as base class that implements the commonalities.
|
||
The AD9851 is derived and has its own **setFrequency()** methods.
|
||
Furthermore the AD9851 also has function to select the reference clock,
|
||
a feature the AD9850 does not have.
|
||
|
||
**Warning**
|
||
The library is not suitable for AD9852 as that is a function generator with
|
||
way more functionality.
|
||
|
||
|
||
## Connection
|
||
|
||
|
||
```
|
||
TOP VIEW
|
||
+-----------+
|
||
| X-TAL |
|
||
| L |
|
||
VCC | o o | VCC
|
||
CLK | o o | D0
|
||
PUFD | o o | D1
|
||
DATA | o o | D2
|
||
RESET | o o | D3
|
||
GND | o CCC o | D4
|
||
QOUT1 | o CCC o | D5
|
||
QOUT2 | o o | D6
|
||
ZOUT1 | o o | D7 ----- SELECT SERIAL LOW
|
||
ZOUT2 | o PP o | GND
|
||
| PP |
|
||
+-----------+
|
||
|
||
XTAL = crystal
|
||
L = LED
|
||
C = chip
|
||
P = potmeter => for duty cycle square wave
|
||
|
||
```
|
||
|
||
### Multidevice
|
||
|
||
See Multi_AD985X_devices.pdf
|
||
|
||
|
||
Discussion leading to the document see - https://github.com/RobTillaart/AD985X/issues/13
|
||
|
||
The AD985X board can be connected with a SPI bus like interface.
|
||
However there is **no Chip Select pin (CS)** so one must take other measures to control multiple AD985X devices.
|
||
|
||
|
||
#### Trivial solution
|
||
|
||
The trivial implementation is to give each device a set of unique pins.
|
||
If you have pins to spare this is the perfect solution.
|
||
|
||
|
||
#### Shared line solution
|
||
|
||
A more common SPI solution is to share the data and clock lines.
|
||
However that would typical set all AD985X devices simultaneously.
|
||
So extra hardware is needed to prevent this.
|
||
|
||
A possible solution is to put all needed lines behind an AND port that allows only
|
||
communication when the **SELECT** is HIGH.
|
||
|
||
```
|
||
Arduino AND AD985X
|
||
--------------------------------------------------
|
||
|
||
+--------+
|
||
SELECT ----| A |
|
||
| Y |------- DATA
|
||
DATA -----| B |
|
||
+--------+
|
||
|
||
+--------+
|
||
SELECT ----| A |
|
||
| Y |------- CLOCK
|
||
CLOCK ----| B |
|
||
+--------+
|
||
|
||
+--------+
|
||
SELECT ----| A |
|
||
| Y |------- FQ_UD
|
||
FQ_UD ----| B |
|
||
+--------+
|
||
|
||
+--------+
|
||
SELECT ----| A |
|
||
| Y |------- RESET
|
||
RESET ----| B |
|
||
+--------+
|
||
|
||
```
|
||
|
||
|
||
|
||
The **DATA** line of the device is connected to the output of an **AND** port.
|
||
The inputs if the **AND** port are (a) the SPI bus **DATA** line and (b) the **SELECT** pin.
|
||
Strictly for the **DATA** this is not needed as data will only clock in if there is a **CLOCK**.
|
||
|
||
The **CLOCK** pin of the device is connected to the output of an **AND** port.
|
||
The inputs if the **AND** port are (a) the SPI bus **CLOCK** line and (b) the **SELECT** pin.
|
||
|
||
The **FQ_UD** pin of the device is connected to the output of an **AND** port.
|
||
The inputs if the **AND** port are (a) the MCU **FQ_UD** line and (b) the **SELECT** pin.
|
||
See FQ_UD note below.
|
||
|
||
The **RESET** pin of the device is connected to the output of an **AND** port.
|
||
The inputs if the **AND** port are (a) the MCU **RESET** line and (b) the **SELECT** pin.
|
||
|
||
A typical IC to use is the **74HC08** which has 4 AND ports in it.
|
||
|
||
|
||
In short this setup makes the lines 'switchable' pass through, with the **SELECT** line.
|
||
It allows to have multiple AD985X devices, and even to share the SPI bus **DATA** and **CLOCK**
|
||
lines with other SPI devices.
|
||
|
||
|
||
### FQ_UD note
|
||
|
||
It might be possible to connect a single FQ_UD line to multiple AD985X devices directly.
|
||
The FQ_UD pulse would update the frequency and as this register is not changed, the FQ_UD
|
||
pulse might just have no changing effect. To be investigated to confirm this.
|
||
|
||
If confirmed this would change the above Shared line solution a bit.
|
||
|
||
If the FQ_UD line can be shared directly it offers a way to start / change multiple
|
||
devices at the same time.
|
||
|
||
|
||
|
||
## Interface
|
||
|
||
### Constructors
|
||
|
||
- **AD9850()** 40 MHz signal generator
|
||
- **AD9851()** 70 MHz signal generator, derived from AD9850 with some extra options.
|
||
|
||
|
||
### Common interface
|
||
|
||
- **void begin(selectPin, resetPin, FQUDPin, dataOut = 0, clock = 0)**
|
||
For hardware SPI only use the first three parameters,
|
||
for SW SPI you need to define the data and clock pin too.
|
||
- selectPin = chip select. The library uses HIGH as active and LOW as not selected.
|
||
- resetPin = reset
|
||
- FQUD = Frequency UpDate Pin
|
||
- **void reset()** resets the function generator.
|
||
- **void powerDown()** idem
|
||
- **void powerUp()** idem
|
||
- **void setFrequency(uint32_t freq)** SetFrequency sets the frequency and is limited by the
|
||
MaxFrequency of the class used. For the AD9850 => 40 MHz, for the AD9851 => 70 MHz.
|
||
- Note that the quality of the signal gets less at higher frequencies.
|
||
- Note setFrequency is affected by the autoUpdateFlag.
|
||
- **void setFrequencyF(float freq)** SetFrequencyF sets the frequency with a float with a maximum of **two** decimals.
|
||
- Note that a float only has a mantissa of 6-7 digits so for frequencies above above ~1.000.000 = 1MHz all decimals are lost.
|
||
- Note setFrequencyF is affected by the autoUpdateFlag.
|
||
- **uint32_t getMaxFrequency()** returns the maximum frequency that can be set. For the AD9850 this is 20 MHz.
|
||
For the AD9851 this is 70 MHz.
|
||
- **float getFrequency()** returns the frequency set. As it returns a float it might loose some accuracy at higher frequencies.
|
||
- **void setPhase(uint8_t phase = 0)** set the phase in units of 11.25<EFBFBD> 0..31 allowed.
|
||
Default it sets the phase to 0.
|
||
- **uint8_t getPhase()** returns the phase set, 0 by default. One need to multiply by 11.25<EFBFBD> to get the actual angle.
|
||
|
||
|
||
### Calibration
|
||
|
||
**Warning:** use with care.
|
||
|
||
- **void setCalibrationOffset(int32_t offset = 0)** sets an offset to calibrate the frequency.
|
||
- **uint32_t getCalibrationOffset()** reads back the offset set.
|
||
- **uint32_t getFactor()** internal factor, for debugging
|
||
|
||
Note: reset() resets the offset to 0..
|
||
Note: setting the offset reduces the range of frequencies (at the ends of scale).
|
||
|
||
|
||
### Auto update / manual update
|
||
|
||
(new since 0.2.2)
|
||
|
||
**Warning:** use with care.
|
||
|
||
- **void setAutoUpdate(bool update)** sets the autoUpdate flag, default set to true.
|
||
- **bool getAutoUpdate()** reads the autoUpdate flag.
|
||
- **void update()** manually toggle the FQ_UD flag to update the frequency.
|
||
|
||
Manual updating allows one to prepare the frequency, and actually apply
|
||
it at a later moment.
|
||
|
||
The default of the flag is true, and will be reset to true by the **reset()** call.
|
||
|
||
|
||
|
||
### 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
|
||
|
||
This functionality is new in 0.3.1.
|
||
|
||
- **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.
|
||
|
||
|
||
#### ESP32 experimental
|
||
|
||
- **void setGPIOpins(clk, miso, mosi, select)** overrule GPIO pins of ESP32 for hardware SPI. needs to be called
|
||
AFTER the **begin()** function.
|
||
|
||
```cpp
|
||
void setup()
|
||
{
|
||
freqGen.selectVSPI();
|
||
freqGen.begin(15);
|
||
freqGen.setGPIOpins(CLK, MISO, MOSI, SELECT); // SELECT should match the param of begin()
|
||
...
|
||
}
|
||
```
|
||
|
||
|
||
### AD9850 specific
|
||
|
||
The AD9850 has no specific functions.
|
||
|
||
|
||
### AD9851 specific
|
||
|
||
- **void setRefClockHigh()** set reference clock to 180 Mhz.
|
||
- **void setRefClockLow()** set reference clock to 30 Mhz.
|
||
- **uint8_t getRefClock()** returns 30 or 180.
|
||
- **void setAutoRefClock(bool arc)** sets a flag so the library switches automatically
|
||
to the reference clock of 180 MHz when the frequency is set above 10 MHz and
|
||
to 30 MHz when the frequency is set to 10 MHz or lower.
|
||
The initial value is **false** == OFF for backwards compatibility.
|
||
- **bool getAutoRefClock()** returns true is automode is set.
|
||
- **void setARCCutOffFreq(uint32_t Hz = 10000000UL )** set cut off frequency
|
||
for the auto reference clock. max value is 30 MHz, typical 10MHz
|
||
- **uint32_t getARCCutOffFreq()** returns cut off frequency set.
|
||
|
||
|
||
- Note: the autoRefClock mode does **NOT** automatically adjust the calibration offset.
|
||
- Note: **reset()** does **NOT** reset the autoRefClock flag.
|
||
|
||
|
||
## Operation
|
||
|
||
See examples
|
||
|
||
|
||
### Operational notes
|
||
|
||
- The quality of the signal becomes less at higher frequencies.
|
||
Switch the reference clock to find your optimal quality.
|
||
- If the calibration offset is not 0, it needs to be set by the user after every startup,
|
||
and after switching the reference clock.
|
||
The user is also responsible to store it e.g. in EEPROM to make it persistent.
|
||
- Experimental parts may change or removed in the future.
|
||
|
||
|
||
## Future
|
||
|
||
- test library with an ESP32 (check details)
|
||
- examples for ESP32 HWSPI interface
|
||
- performance measurements
|
||
|