| Linduino 1.3.0 Linear Technology Arduino-Compatible Demonstration Board

Functions | Macros
LTC6945.h File Reference
RF, Silicon Oscillators, PLL Synthesizers, and VCOs » LTC6945: Ultralow Noise and Spurious 0.35GHz to 6GHz Integer-N Synthesizer

LTC6945: Ultralow Noise and Spurious 0.35GHz to 6GHz Integer-N Synthesizer. More...

## Detailed Description

LTC6945: Ultralow Noise and Spurious 0.35GHz to 6GHz Integer-N Synthesizer.

     SPI DATA FORMAT (MSB First):

     Write Sequence:
           Byte #1                    Byte #2
     MOSI: A6 A5 A4 A3 A2 A1 A0 W   D7 D6 D5 D4 D3 D2 D1 D0
     MISO: X  X  X  X  X  X  X  X   X  X  X  X  X  X  X  X

     Read Sequence:
           Byte #1                    Byte #2
     MOSI: A6 A5 A4 A3 A2 A1 A0 R   X  X  X  X  X  X  X  X
     MISO: X  X  X  X  X  X  X  X   D7 D6 D5 D4 D3 D2 D1 D0

     W    : SPI Write (0)
     R    : SPI Read  (1)
     Ax   : Address
     Dx   : Data Bits
     X    : Don't care

http://www.linear.com/product/LTC6945

http://www.linear.com/product/LTC6945#demoboards

Copyright 2018(c) Analog Devices, Inc.

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of Analog Devices, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
- The use of this software may or may not infringe the patent rights of one or more patent holders. This license does not release you from the requirement that you obtain separate licenses from these patent holders to use this software.
- Use of the software either in source or binary form, must be run on or directly connected to an Analog Devices Inc. component.

THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, INTELLECTUAL PROPERTY RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Header for LTC6945: Ultralow Noise and Spurious 0.35GHz to 6.39GHz Integer-N Synthesizer

Definition in file LTC6945.h.

Go to the source code of this file.

## Functions
uint8_t | LTC6945_read (uint8_t cs, int8_t address)
| LTC6945 Read Single Address reads 8 bit Data field to LTC6945. More...
long | LTC6945_read_field (uint8_t cs, uint8_t address, uint8_t MSB_loc, uint8_t numbits)
| LTC6945 Read Single Field For SPI FIELDS located in 1 or multiple address location reads specific address locations identifies and returns specific field in question can handle SPI fields in multiple addresses, if MSB bit is in the lower number address. More...
long | get_LTC6945_SPI_FIELD (uint8_t cs, uint8_t f)
| Gets the LTC6945 SPI field value calls function LTC6945_read_field, which reads specific address locations identifies and returns specific field in question can handle SPI fields in multiple addresses, if MSB bit is in the lower number address. More...
void | LTC6945_write (uint8_t cs, uint8_t address, uint8_t Data)
| LTC6945 Write Single Address writes 8 bit Data field to LTC6945. More...
uint8_t | LTC6945_write_field (uint8_t cs, long field_data, uint8_t address, uint8_t MSB_loc, uint8_t numbits)
| LTC6945 Write Single Field For SPI FIELDS in 1 or multiple address locations reads specific address/field location then writes to specific field can handle SPI fields in multiple addresses, if MSB bit is in the lower number address. More...
void | set_LTC6945_SPI_FIELD (uint8_t cs, uint8_t f, long field_data)
| Sets the LTC6945 SPI field value calls function LTC6945_read_field, which reads specific address/field location then writes to specific field can handle SPI fields in multiple addresses, if MSB bit is in the lower number address. More...
void | set_LTC6945_ALLREGS (uint8_t cs, uint8_t reg01, uint8_t reg02, uint8_t reg03, uint8_t reg04, uint8_t reg05, uint8_t reg06, uint8_t reg07, uint8_t reg08, uint8_t reg09, uint8_t reg0A)
| Writes values to ALL LTC6945 RW addresses. More...
void | LTC6945_init ()
| Initializes the SPI MAP arrays The values set in initialization are used for all the LTC6945 SPI/WRITE and read functions (set_LTC6945_SPI_FIELD, get_LTC6945_SPI_FIELD, LTC6945_read, LTC6945_write, etc, etc) More...
uint8_t | get_LTC6945_REGSIZE ()
| returns # of addresses in parts register map (array size) More...
uint8_t | get_LTC6945_SPI_FIELD_NUMBITS (uint8_t f)
| returns the number of bits for a given field name in the SPI map More...
uint8_t | get_LTC6945_SPI_FIELD_RW (uint8_t f)
| returns if the given field name is (0)read/write or (1)read_only field More...
unsigned long | LTC6945_calc_odiv (unsigned long frf[2])
| calculates the output divider setting based on the frf and on board VCO frequencies of LTC6945 More...
void | LTC6945_set_frf ()
| FUNCTION: LTC6945_set_frf Calculates the integer (N), fractional (NUM) and output divider (OD) SPI values using self created 64bit math functions. More...
void | set_LTC6945_global_fref (unsigned long fref_MHz, unsigned long fref_Hz)
| sets globals LTC6945_Fref_MHz and LTC6945_Fref_Hz More...
void | set_LTC6945_global_frf (unsigned long frf_MHz, unsigned long frf_Hz)
| sets globals LTC6945_Frf_MHz and LTC6945_Frf_Hz More...
void | set_LTC6945_global_vcolim (unsigned long fvco_max_MHz, unsigned long fvco_max_Hz, unsigned long fvco_min_MHz, unsigned long fvco_min_Hz)
| sets globals LTC6945_VCO_Max_Freq_MHz, LTC6945_VCO_Max_Freq_Hz, LTC6945_VCO_Min_Freq_MHz and LTC6945_VCO_Min_Freq_Hz More...
unsigned long | get_LTC6945_global_fref_MHz ()
| returns global LTC6945_Fref_MHz More...
unsigned long | get_LTC6945_global_fref_Hz ()
| returns global LTC6945_Fref_Hz More...
unsigned long | get_LTC6945_global_frf_MHz ()
| returns global LTC6945_Frf_MHz More...
unsigned long | get_LTC6945_global_frf_Hz ()
| returns global LTC6945_Frf_Hz More...
unsigned long | get_LTC6945_global_VCO_MAX_MHz ()
| returns global LTC6945_VCO_Max_Freq_MHz More...
unsigned long | get_LTC6945_global_VCO_MIN_MHz ()
| returns global LTC6945_VCO_Min_Freq_MHz More...
unsigned long | get_LTC6945_global_VCO_MAX_Hz ()
| returns global LTC6945_VCO_Max_Freq_Hz More...
unsigned long | get_LTC6945_global_VCO_MIN_Hz ()
| returns global LTC6945_VCO_Min_Freq_Hz More...
void | HZto64 (unsigned long an[], unsigned long MHzPart, unsigned long HzPart)
| create a 64 bit Hz number from 32 bit xxxx MHz number and 32 bit yyy yyy Hz number. More...
void | init64 (unsigned long an[], unsigned long bigPart, unsigned long littlePart)
| Creates a equivalent 64 bit number from 2 32 bit numbers. More...
void | shl64 (unsigned long an[])
| Single Bit shift left of equivalent 64 bit number (an[] = an[]<<1) More...
void | shl64by (unsigned long an[], uint8_t shiftnum)
| Multi Bit shift left of equivalent 64 bit number (an[] = an[]<<shiftnum) More...
void | shr64 (unsigned long an[])
| Single Bit shift right of equivalent 64 bit number (an[] = an[]<<1) More...
void | shr64by (unsigned long an[], uint8_t shiftnum)
| Multi Bit shift right of equivalent 64 bit number (an[] = an[]>>shiftnum) More...
void | add64 (unsigned long an[], unsigned long ann[])
| 64 bit Add ann to an (an[] = an[] + ann[]) More...
void | sub64 (unsigned long an[], unsigned long ann[])
| 64 bit Subtract ann from an (an[] = an[] - ann[]) More...
boolean | eq64 (unsigned long an[], unsigned long ann[])
| 64 bit, if an == ann, then true More...
boolean | lt64 (unsigned long an[], unsigned long ann[])
| 64 bit, if an < ann, then true More...
void | div64 (unsigned long num[], unsigned long den[])
| 64 bit Divide, num=num/div More...
void | mul64 (unsigned long an[], unsigned long ann[])
| 64 bit multiply, an=an*ann More...
void | prt (unsigned long an[])
| Prints HEX representation of 64 bit an. More...

## Macros
#define | LTC6945_CS QUIKEVAL_CS
| Define the SPI CS pin. More...
LTC6945 Registers Fields in Alphabetical Order
#define | LTC6945_BST 1
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_CP 2
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_CPCHI 3
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_CPCLO 4
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_CPDN 5
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_CPINV 6
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_CPMID 7
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_CPRST 8
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_CPUP 9
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_CPWIDE 10
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_FILT 11
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_LKCT 12
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_LKEN 13
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_LKWIN 14
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_LOCK 15
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_ND 16
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_OD 17
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_OMUTE 18
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_PART 19
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_PDALL 20
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_PDOUT 21
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_PDPLL 22
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_PDREFO 23
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_POR 24
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_RD 25
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_REV 26
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_RFO 27
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_THI 28
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_TLO 29
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_UNLOCK 30
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_x 31
| for spi_map array, defines location for field specific information used to create the spi map More...
#define | LTC6945_NUM_REGADDR 12
| Defines number of LTC6945 SPI registers, used in spi_map array. More...
#define | LTC6945_NUM_REGFIELD 31
| Defines number of LTC6945 SPI fields, used in spi_map array. More...
#define | ADDRx 0
| used for 2nd dim of 2d spi_map array More...
#define | DxMSB 1
| used for 2nd dim of 2d spi_map array More...
#define | NUMBITS 2
| used for 2nd dim of 2d spi_map array More...
#define | R_ONLY 3
| used for 2nd dim of 2d spi_map array More...
#define | OneMHz 1000000L
| 1MHz in long format, used in 64 bit math More...
#define | LTC6945_MINFREQ 350
| LTC6945 lower freq limit. More...
#define | LTC6945_MAXFREQ 6000
| LTC6945 upper freq limit. More...
#define | LTC6945_MIN_REF_FREQ 10
| LTC6945 lower reference frequency limit. More...
#define | LTC6945_MAX_REF_FREQ 250
| LTC6945 upper reference frequency limit. More...

## Function Documentation

## ◆ add64()

void add64 | ( | unsigned long | an[],
|  | unsigned long | ann[]
| ) |  |

64 bit Add ann to an (an[] = an[] + ann[])

Returns
  void

Parameters

  an | 64 bit number, in 1x2 32bit array
  ann | 64 bit number, in 1x2 32bit array

Definition at line 810 of file LTC6945.cpp.

## ◆ div64()

void div64 | ( | unsigned long | num[],
|  | unsigned long | den[]
| ) |  |

64 bit Divide, num=num/div

Returns
  void

Parameters

  num | numerator: 64 bit number, in 1x2 32bit array
  den | denominator: 64 bit number, in 1x2 32bit array

Definition at line 859 of file LTC6945.cpp.

## ◆ eq64()

boolean eq64 | ( | unsigned long | an[],
|  | unsigned long | ann[]
| ) |  |

64 bit, if an == ann, then true

Returns
  true, if an==ann; false, if an<>ann

Parameters

  an | 64 bit number, in 1x2 32bit array
  ann | 64 bit number, in 1x2 32bit array

Definition at line 838 of file LTC6945.cpp.

## ◆ get_LTC6945_global_fref_Hz()

unsigned long get_LTC6945_global_fref_Hz | ( |  | ) |

returns global LTC6945_Fref_Hz

Returns
  LTC6945_Fref_Hz

Definition at line 467 of file LTC6945.cpp.

## ◆ get_LTC6945_global_fref_MHz()

unsigned long get_LTC6945_global_fref_MHz | ( |  | ) |

returns global LTC6945_Fref_MHz

Returns
  LTC6945_Fref_MHz

Definition at line 462 of file LTC6945.cpp.

## ◆ get_LTC6945_global_frf_Hz()

unsigned long get_LTC6945_global_frf_Hz | ( |  | ) |

returns global LTC6945_Frf_Hz

Returns
  LTC6945_Frf_Hz

Definition at line 477 of file LTC6945.cpp.

## ◆ get_LTC6945_global_frf_MHz()

unsigned long get_LTC6945_global_frf_MHz | ( |  | ) |

returns global LTC6945_Frf_MHz

Returns
  LTC6945_Frf_MHz

Definition at line 472 of file LTC6945.cpp.

## ◆ get_LTC6945_global_VCO_MAX_Hz()

unsigned long get_LTC6945_global_VCO_MAX_Hz | ( |  | ) |

returns global LTC6945_VCO_Max_Freq_Hz

Returns
  LTC6945_VCO_Max_Freq_Hz

Definition at line 492 of file LTC6945.cpp.

## ◆ get_LTC6945_global_VCO_MAX_MHz()

unsigned long get_LTC6945_global_VCO_MAX_MHz | ( |  | ) |

returns global LTC6945_VCO_Max_Freq_MHz

Returns
  LTC6945_VCO_Max_Freq_MHz

Definition at line 482 of file LTC6945.cpp.

## ◆ get_LTC6945_global_VCO_MIN_Hz()

unsigned long get_LTC6945_global_VCO_MIN_Hz | ( |  | ) |

returns global LTC6945_VCO_Min_Freq_Hz

Returns
  LTC6945_VCO_Min_Freq_Hz

Definition at line 497 of file LTC6945.cpp.

## ◆ get_LTC6945_global_VCO_MIN_MHz()

unsigned long get_LTC6945_global_VCO_MIN_MHz | ( |  | ) |

returns global LTC6945_VCO_Min_Freq_MHz

Returns
  LTC6945_VCO_Min_Freq_MHz

Definition at line 487 of file LTC6945.cpp.

## ◆ get_LTC6945_REGSIZE()

uint8_t get_LTC6945_REGSIZE | ( |  | ) |

returns # of addresses in parts register map (array size)

Returns
  # of addresses in parts register map

Definition at line 241 of file LTC6945.cpp.

## ◆ get_LTC6945_SPI_FIELD()

long get_LTC6945_SPI_FIELD | ( | uint8_t | cs,
|  | uint8_t | f
| ) |  |

Gets the LTC6945 SPI field value calls function LTC6945_read_field, which reads specific address locations identifies and returns specific field in question can handle SPI fields in multiple addresses, if MSB bit is in the lower number address.

Returns
  data that was read from field

Parameters

  cs | Chip Select Pin
  f | SPI field number

Definition at line 163 of file LTC6945.cpp.

## ◆ get_LTC6945_SPI_FIELD_NUMBITS()

uint8_t get_LTC6945_SPI_FIELD_NUMBITS | ( | uint8_t | f | ) |

returns the number of bits for a given field name in the SPI map

Returns
  the number of bits for a given field name in the SPI map

Parameters

  f | SPI field number

Definition at line 251 of file LTC6945.cpp.

## ◆ get_LTC6945_SPI_FIELD_RW()

uint8_t get_LTC6945_SPI_FIELD_RW | ( | uint8_t | f | ) |

returns if the given field name is (0)read/write or (1)read_only field

Returns
  if the given field is a (0)read/write or (1)read_only field

Parameters

  f | SPI field number

Definition at line 261 of file LTC6945.cpp.

## ◆ HZto64()

void HZto64 | ( | unsigned long | an[],
|  | unsigned long | MHzPart,
|  | unsigned long | HzPart
| ) |  |

create a 64 bit Hz number from 32 bit xxxx MHz number and 32 bit yyy yyy Hz number.

A) if an < 2^32 bits:

- an(upper 32b) = 0;
- an(lower 32b) = MHzPart(32b)*1MHz + HzPart (32b)

B) if an > 2^32 bits (4,294,967,296):

- an(upper 32b) = 1
- an(lower 32b) = ((MHzPart-4294)*1MHz+HzPart)-967296
  Returns
    void

Parameters

  an | 64 bit number, 1x2 32 bit array
  MHzPart | integer in MHZ
  HzPart | integer in Hz

Definition at line 729 of file LTC6945.cpp.

## ◆ init64()

void init64 | ( | unsigned long | an[],
|  | unsigned long | bigPart,
|  | unsigned long | littlePart
| ) |  |

Creates a equivalent 64 bit number from 2 32 bit numbers.

- an[0]=bigPart upper 32 bits
- an[1]=littlePart lower 32 bits
  Returns
    void

Parameters

  an | 64 bit number, 1x2 32 bit array
  bigPart | upper 32 bits
  littlePart | lower 32 bits

Definition at line 712 of file LTC6945.cpp.

## ◆ lt64()

boolean lt64 | ( | unsigned long | an[],
|  | unsigned long | ann[]
| ) |  |

64 bit, if an < ann, then true

Returns
  true, if an<ann; false, if an=>ann

Parameters

  an | 64 bit number, in 1x2 32bit array
  ann | 64 bit number, in 1x2 32bit array

Definition at line 848 of file LTC6945.cpp.

## ◆ LTC6945_calc_odiv()

unsigned long LTC6945_calc_odiv | ( | unsigned long | frf[2] | ) |

calculates the output divider setting based on the frf and on board VCO frequencies of LTC6945

Returns
  odiv = 1-6 divider setting for valid frequency, or 999 for invalid frequency

Parameters

  frf | output frequency

Definition at line 508 of file LTC6945.cpp.

## ◆ LTC6945_init()

void LTC6945_init | ( |  | ) |

Initializes the SPI MAP arrays The values set in initialization are used for all the LTC6945 SPI/WRITE and read functions (set_LTC6945_SPI_FIELD, get_LTC6945_SPI_FIELD, LTC6945_read, LTC6945_write, etc, etc)

Returns
  void

Definition at line 308 of file LTC6945.cpp.

## ◆ LTC6945_read()

uint8_t LTC6945_read | ( | uint8_t | cs,
|  | int8_t | address
| ) |  |

LTC6945 Read Single Address reads 8 bit Data field to LTC6945.

has to shift data by one bit to account for RW bit

Returns
  data that was read from address

Parameters

  cs | Chip Select Pin
  address | Register address for the LTC6945.

Definition at line 107 of file LTC6945.cpp.

## ◆ LTC6945_read_field()

long LTC6945_read_field | ( | uint8_t | cs,
|  | uint8_t | address,
|  | uint8_t | MSB_loc,
|  | uint8_t | numbits
| ) |  |

LTC6945 Read Single Field For SPI FIELDS located in 1 or multiple address location reads specific address locations identifies and returns specific field in question can handle SPI fields in multiple addresses, if MSB bit is in the lower number address.

Returns
  data that was read from field

Parameters

  cs | Chip Select Pin
  address | Register address for the LTC6945.
  MSB_loc | MSB bit location of field
  numbits | length of field (i.e. number of bits in field)

Definition at line 127 of file LTC6945.cpp.

## ◆ LTC6945_set_frf()

void LTC6945_set_frf | ( |  | ) |

FUNCTION: LTC6945_set_frf Calculates the integer (N), fractional (NUM) and output divider (OD) SPI values using self created 64bit math functions.

Datasheet equations:

- fvco = fpfd*(N + F)
- frf = fvco/O

- fpfd = fref/R

  can be modified to the following equations:

  - N = (int) (fvco/fpfd) = (int) frf*O*R/fref

  where:

  - N = ndiv, O= odiv in the code below

  Linduino One (Arduino Uno) is limited to 32 bit floats/double/long. 32 bit math functions will create rounding errors with the above equations, that can result in frequency errors. Therefore, the following code uses self created 64bit functions for 64bit integer math.

  - frf (33 bits) LTC6945 max frf/fvco = 6.0GHZ, which is 23 bit number (2^33 = 8.59G)
  - fref (23 bits) LTC6945 min fref = 10MHz, which is a 23 bit number (2^23 = 8.3M)
  - O (3 bits)
  - R (10 bits)

  step 1: create 64 bit frf and fref numbers

  step 2: calculate O (output divider)

  step 3: get current R-divider setting

  step 4: calculate frf*O*R

  - max bit count/resolution: 33b+3b+10b= 46b

  step 5: calculate N(16b), using value from step 1

  - N = (int) frf*O*R/fref
  - max bit count/resolution: 46b-23b = 13b

Returns
  void

Definition at line 583 of file LTC6945.cpp.

## ◆ LTC6945_write()

void LTC6945_write | ( | uint8_t | cs,
|  | uint8_t | address,
|  | uint8_t | Data
| ) |  |

LTC6945 Write Single Address writes 8 bit Data field to LTC6945.

has to shift data by one bit to account for RW bit

Returns
  void

Parameters

  cs | Chip Select Pin
  address | Register address for the LTC6945.
  Data | 8-bit data to be written to register

Definition at line 174 of file LTC6945.cpp.

## ◆ LTC6945_write_field()

uint8_t LTC6945_write_field | ( | uint8_t | cs,
|  | long | field_data,
|  | uint8_t | address,
|  | uint8_t | MSB_loc,
|  | uint8_t | numbits
| ) |  |

LTC6945 Write Single Field For SPI FIELDS in 1 or multiple address locations reads specific address/field location then writes to specific field can handle SPI fields in multiple addresses, if MSB bit is in the lower number address.

Returns
  void

Parameters

  cs | Chip Select Pin
  field_data | Value field value to be set to
  address | Register address for the LTC6945.
  MSB_loc | MSB bit location of field
  numbits | length of field (i.e. number of bits in field)

Definition at line 190 of file LTC6945.cpp.

## ◆ mul64()

void mul64 | ( | unsigned long | an[],
|  | unsigned long | ann[]
| ) |  |

64 bit multiply, an=an*ann

Returns
  void

Parameters

  an | 64 bit number, in 1x2 32bit array
  ann | 64 bit number, in 1x2 32bit array

Definition at line 906 of file LTC6945.cpp.

## ◆ prt()

void prt | ( | unsigned long | an[] | ) |

Prints HEX representation of 64 bit an.

Returns
  void

Parameters

  an | 64 bit number, in 1x2 32bit array

Definition at line 698 of file LTC6945.cpp.

## ◆ set_LTC6945_ALLREGS()

void set_LTC6945_ALLREGS | ( | uint8_t | cs,
|  | uint8_t | reg01,
|  | uint8_t | reg02,
|  | uint8_t | reg03,
|  | uint8_t | reg04,
|  | uint8_t | reg05,
|  | uint8_t | reg06,
|  | uint8_t | reg07,
|  | uint8_t | reg08,
|  | uint8_t | reg09,
|  | uint8_t | reg0A
| ) |  |

Writes values to ALL LTC6945 RW addresses.

Returns
  void

Parameters

  cs | Chip Select Pin
  reg01 | LTC6945 register 1
  reg02 | LTC6945 register 2
  reg03 | LTC6945 register 3
  reg04 | LTC6945 register 4
  reg05 | LTC6945 register 5
  reg06 | LTC6945 register 6
  reg07 | LTC6945 register 7
  reg08 | LTC6945 register 8
  reg09 | LTC6945 register 9
  reg0A | LTC6945 register 10

Definition at line 284 of file LTC6945.cpp.

## ◆ set_LTC6945_global_fref()

void set_LTC6945_global_fref | ( | unsigned long | fref_MHz,
|  | unsigned long | fref_Hz
| ) |  |

sets globals LTC6945_Fref_MHz and LTC6945_Fref_Hz

Returns
  void

Definition at line 440 of file LTC6945.cpp.

## ◆ set_LTC6945_global_frf()

void set_LTC6945_global_frf | ( | unsigned long | frf_MHz,
|  | unsigned long | frf_Hz
| ) |  |

sets globals LTC6945_Frf_MHz and LTC6945_Frf_Hz

Returns
  void

Definition at line 446 of file LTC6945.cpp.

## ◆ set_LTC6945_global_vcolim()

void set_LTC6945_global_vcolim | ( | unsigned long | fvco_max_MHz,
|  | unsigned long | fvco_max_Hz,
|  | unsigned long | fvco_min_MHz,
|  | unsigned long | fvco_min_Hz
| ) |  |

sets globals LTC6945_VCO_Max_Freq_MHz, LTC6945_VCO_Max_Freq_Hz, LTC6945_VCO_Min_Freq_MHz and LTC6945_VCO_Min_Freq_Hz

Returns
  void

Definition at line 452 of file LTC6945.cpp.

## ◆ set_LTC6945_SPI_FIELD()

void set_LTC6945_SPI_FIELD | ( | uint8_t | cs,
|  | uint8_t | f,
|  | long | field_data
| ) |  |

Sets the LTC6945 SPI field value calls function LTC6945_read_field, which reads specific address/field location then writes to specific field can handle SPI fields in multiple addresses, if MSB bit is in the lower number address.

Returns
  void

Parameters

  cs | Chip Select Pin
  f | SPI field number
  field_data | Value field value to be set to

Definition at line 274 of file LTC6945.cpp.

## ◆ shl64()

void shl64 | ( | unsigned long | an[] | ) |

Single Bit shift left of equivalent 64 bit number (an[] = an[]<<1)

Returns
  void

Parameters

  an | an[] = an[]<<1

Definition at line 748 of file LTC6945.cpp.

## ◆ shl64by()

void shl64by | ( | unsigned long | an[],
|  | uint8_t | shiftnum
| ) |  |

Multi Bit shift left of equivalent 64 bit number (an[] = an[]<<shiftnum)

Returns
  void

Parameters

  an | an[] = an[]<<shiftnum
  shiftnum | number of bits to shift left

Definition at line 774 of file LTC6945.cpp.

## ◆ shr64()

void shr64 | ( | unsigned long | an[] | ) |

Single Bit shift right of equivalent 64 bit number (an[] = an[]<<1)

Returns
  void

Parameters

  an | an[] = an[]>>shiftnum

Definition at line 761 of file LTC6945.cpp.

## ◆ shr64by()

void shr64by | ( | unsigned long | an[],
|  | uint8_t | shiftnum
| ) |  |

Multi Bit shift right of equivalent 64 bit number (an[] = an[]>>shiftnum)

Returns
  void

Parameters

  an | an[] = an[]>>shiftnum
  shiftnum | number of bits to shift right

Definition at line 792 of file LTC6945.cpp.

## ◆ sub64()

void sub64 | ( | unsigned long | an[],
|  | unsigned long | ann[]
| ) |  |

64 bit Subtract ann from an (an[] = an[] - ann[])

Returns
  void

Parameters

  an | 64 bit number, in 1x2 32bit array
  ann | 64 bit number, in 1x2 32bit array

Definition at line 823 of file LTC6945.cpp.

## Macro Definition Documentation

## ◆ ADDRx

#define ADDRx 0

used for 2nd dim of 2d spi_map array

Definition at line 116 of file LTC6945.h.

## ◆ DxMSB

#define DxMSB 1

used for 2nd dim of 2d spi_map array

Definition at line 117 of file LTC6945.h.

## ◆ LTC6945_BST

#define LTC6945_BST 1

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 81 of file LTC6945.h.

## ◆ LTC6945_CP

#define LTC6945_CP 2

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 82 of file LTC6945.h.

## ◆ LTC6945_CPCHI

#define LTC6945_CPCHI 3

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 83 of file LTC6945.h.

## ◆ LTC6945_CPCLO

#define LTC6945_CPCLO 4

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 84 of file LTC6945.h.

## ◆ LTC6945_CPDN

#define LTC6945_CPDN 5

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 85 of file LTC6945.h.

## ◆ LTC6945_CPINV

#define LTC6945_CPINV 6

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 86 of file LTC6945.h.

## ◆ LTC6945_CPMID

#define LTC6945_CPMID 7

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 87 of file LTC6945.h.

## ◆ LTC6945_CPRST

#define LTC6945_CPRST 8

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 88 of file LTC6945.h.

## ◆ LTC6945_CPUP

#define LTC6945_CPUP 9

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 89 of file LTC6945.h.

## ◆ LTC6945_CPWIDE

#define LTC6945_CPWIDE 10

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 90 of file LTC6945.h.

## ◆ LTC6945_CS

#define LTC6945_CS QUIKEVAL_CS

Define the SPI CS pin.

Definition at line 76 of file LTC6945.h.

## ◆ LTC6945_FILT

#define LTC6945_FILT 11

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 91 of file LTC6945.h.

## ◆ LTC6945_LKCT

#define LTC6945_LKCT 12

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 92 of file LTC6945.h.

## ◆ LTC6945_LKEN

#define LTC6945_LKEN 13

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 93 of file LTC6945.h.

## ◆ LTC6945_LKWIN

#define LTC6945_LKWIN 14

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 94 of file LTC6945.h.

## ◆ LTC6945_LOCK

#define LTC6945_LOCK 15

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 95 of file LTC6945.h.

## ◆ LTC6945_MAX_REF_FREQ

#define LTC6945_MAX_REF_FREQ 250

LTC6945 upper reference frequency limit.

Definition at line 127 of file LTC6945.h.

## ◆ LTC6945_MAXFREQ

#define LTC6945_MAXFREQ 6000

LTC6945 upper freq limit.

Definition at line 124 of file LTC6945.h.

## ◆ LTC6945_MIN_REF_FREQ

#define LTC6945_MIN_REF_FREQ 10

LTC6945 lower reference frequency limit.

Definition at line 126 of file LTC6945.h.

## ◆ LTC6945_MINFREQ

#define LTC6945_MINFREQ 350

LTC6945 lower freq limit.

Definition at line 123 of file LTC6945.h.

## ◆ LTC6945_ND

#define LTC6945_ND 16

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 96 of file LTC6945.h.

## ◆ LTC6945_NUM_REGADDR

#define LTC6945_NUM_REGADDR 12

Defines number of LTC6945 SPI registers, used in spi_map array.

Definition at line 113 of file LTC6945.h.

## ◆ LTC6945_NUM_REGFIELD

#define LTC6945_NUM_REGFIELD 31

Defines number of LTC6945 SPI fields, used in spi_map array.

Definition at line 114 of file LTC6945.h.

## ◆ LTC6945_OD

#define LTC6945_OD 17

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 97 of file LTC6945.h.

## ◆ LTC6945_OMUTE

#define LTC6945_OMUTE 18

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 98 of file LTC6945.h.

## ◆ LTC6945_PART

#define LTC6945_PART 19

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 99 of file LTC6945.h.

## ◆ LTC6945_PDALL

#define LTC6945_PDALL 20

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 100 of file LTC6945.h.

## ◆ LTC6945_PDOUT

#define LTC6945_PDOUT 21

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 101 of file LTC6945.h.

## ◆ LTC6945_PDPLL

#define LTC6945_PDPLL 22

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 102 of file LTC6945.h.

## ◆ LTC6945_PDREFO

#define LTC6945_PDREFO 23

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 103 of file LTC6945.h.

## ◆ LTC6945_POR

#define LTC6945_POR 24

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 104 of file LTC6945.h.

## ◆ LTC6945_RD

#define LTC6945_RD 25

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 105 of file LTC6945.h.

## ◆ LTC6945_REV

#define LTC6945_REV 26

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 106 of file LTC6945.h.

## ◆ LTC6945_RFO

#define LTC6945_RFO 27

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 107 of file LTC6945.h.

## ◆ LTC6945_THI

#define LTC6945_THI 28

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 108 of file LTC6945.h.

## ◆ LTC6945_TLO

#define LTC6945_TLO 29

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 109 of file LTC6945.h.

## ◆ LTC6945_UNLOCK

#define LTC6945_UNLOCK 30

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 110 of file LTC6945.h.

## ◆ LTC6945_x

#define LTC6945_x 31

for spi_map array, defines location for field specific information used to create the spi map

Definition at line 111 of file LTC6945.h.

## ◆ NUMBITS

#define NUMBITS 2

used for 2nd dim of 2d spi_map array

Definition at line 118 of file LTC6945.h.

## ◆ OneMHz

#define OneMHz 1000000L

1MHz in long format, used in 64 bit math

Definition at line 121 of file LTC6945.h.

## ◆ R_ONLY

#define R_ONLY 3

used for 2nd dim of 2d spi_map array

Definition at line 119 of file LTC6945.h.