pluto_hdl_adi/docs/regmap/adi_regmap_dac.txt

923 lines
23 KiB
Plaintext

TITLE
DAC Common (axi_ad)
DAC_COMMON
ENDTITLE
############################################################################################
############################################################################################
REG
0x0010
RSTN
DAC Interface Control & Status
ENDREG
FIELD
[2] 0x00000000
CE_N
RW
Clock enable, default is enabled(0x0). An inverse version of the signal is exported out of
the module to control clock enables
ENDFIELD
FIELD
[1] 0x00000000
MMCM_RSTN
RW
MMCM reset only (required for DRP access).
Reset, default is IN-RESET (0x0), software must write 0x1 to bring up the core.
ENDFIELD
FIELD
[0] 0x00000000
RSTN
RW
Reset, default is IN-RESET (0x0), software must write 0x1 to bring up the core.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0011
CNTRL_1
DAC Interface Control & Status
ENDREG
FIELD
[0] 0x00000000
SYNC
RW
Setting this bit synchronizes channels within a DAC, and across multiple instances.
This bit self clears.
ENDFIELD
FIELD
[1] 0x00000000
EXT_SYNC_ARM
RW
Setting this bit will arm the trigger mechanism sensitive to an external sync signal.
Once the external sync signal goes high it synchronizes channels within a DAC, and across multiple instances.
This bit has an effect only the EXT_SYNC synthesis parameter is set.
This bit self clears.
ENDFIELD
FIELD
[2] 0x00000000
EXT_SYNC_DISARM
RW
Setting this bit will disarm the trigger mechanism sensitive to an external sync signal.
This bit has an effect only the EXT_SYNC synthesis parameter is set.
This bit self clears.
ENDFIELD
FIELD
[8] 0x00000000
MANUAL_SYNC_REQUEST
RW
Setting this bit will issue an external sync event if it is hooked up inside the fabric.
This bit has an effect only the EXT_SYNC synthesis parameter is set.
This bit self clears.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0012
CNTRL_2
DAC Interface Control & Status
ENDREG
FIELD
[16] 0x00000000
SDR_DDR_N
RW
Interface type (1 represents SDR, 0 represents DDR)
ENDFIELD
FIELD
[15] 0x00000000
SYMB_OP
RW
Select data symbol format mode (0x1)
ENDFIELD
FIELD
[14] 0x00000000
SYMB_8_16B
RW
Select number of bits for symbol format mode (1 represents 8b, 0 represents 16b)
ENDFIELD
FIELD
[12:8] 0x00000000
NUM_LANES
RW
Number of active lanes (1 : CSSI 1-lane, LSSI 1-lane, 2 : LSSI 2-lane, 4 : CSSI 4-lane)
ENDFIELD
FIELD
[7] 0x00000000
PAR_TYPE
RW
Select parity even (0x0) or odd (0x1).
ENDFIELD
FIELD
[6] 0x00000000
PAR_ENB
RW
Select parity (0x1) or frame (0x0) mode.
ENDFIELD
FIELD
[5] 0x00000000
R1_MODE
RW
Select number of RF channels 1 (0x1) or 2 (0x0).
ENDFIELD
FIELD
[4] 0x00000000
DATA_FORMAT
RW
Select data format 2's complement (0x0) or offset binary (0x1).
NOT-APPLICABLE if DAC_DP_DISABLE is set (0x1).
ENDFIELD
FIELD
[3:0] 0x00000000
RESERVED
NA
Reserved
ENDFIELD
############################################################################################
############################################################################################
REG
0x0013
RATECNTRL
DAC Interface Control & Status
ENDREG
FIELD
[7:0] 0x00000000
RATE
RW
The effective dac rate (the maximum possible rate is dependent on the interface clock).
The samples are generated at 1/RATE of the interface clock.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0014
FRAME
DAC Interface Control & Status
ENDREG
FIELD
[0] 0x00000000
FRAME
RW
The use of frame is device specific. Usually setting this bit to 1 generates a FRAME (1
DCI clock period) pulse on the interface. This bit self clears.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0015
STATUS1
DAC Interface Control & Status
ENDREG
FIELD
[31:0] 0x00000000
CLK_FREQ
RO
Interface clock frequency. This is relative to the processor clock and in many cases is
100MHz. The number is represented as unsigned 16.16 format. Assuming a 100MHz processor
clock the minimum is 1.523kHz and maximum is 6.554THz. The actual interface clock
is CLK_FREQ * CLK_RATIO (see below). Note that the actual sampling clock may not be
the same as the interface clock- software must consider device specific implementation
parameters to calculate the final sampling clock.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0016
STATUS2
DAC Interface Control & Status
ENDREG
FIELD
[31:0] 0x00000000
CLK_RATIO
RO
Interface clock ratio - as a factor actual received clock. This is implementation specific
and depends on any serial to parallel conversion and interface type (ddr/sdr/qdr).
ENDFIELD
############################################################################################
############################################################################################
REG
0x0017
STATUS3
DAC Interface Control & Status
ENDREG
FIELD
[0] 0x00000000
STATUS
RO
Interface status, if set indicates no errors. If not set, there
are errors, software may try resetting the cores.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0018
DAC_CLKSEL
DAC Interface Control & Status
ENDREG
FIELD
[0] 0x00000000
DAC_CLKSEL
RW
Allows changing of the clock polarity. Note: its default value is CLK_EDGE_SEL
ENDFIELD
############################################################################################
############################################################################################
REG
0x001A
SYNC_STATUS
DAC Synchronization Status register
ENDREG
FIELD
[0] 0x00000000
DAC_SYNC_STATUS
RO
DAC synchronization status. Will be set to 1 while waiting for the external synchronization signal
This bit has an effect only the EXT_SYNC synthesis parameter is set.
ENDFIELD
############################################################################################
############################################################################################
REG
0x001C
DRP_CNTRL
DRP Control & Status
ENDREG
FIELD
[28] 0x00000000
DRP_RWN
RW
DRP read (0x1) or write (0x0) select (does not include GTX lanes).
NOT-APPLICABLE if DRP_DISABLE is set (0x1).
ENDFIELD
FIELD
[27:16] 0x00000000
DRP_ADDRESS
RW
DRP address, designs that contain more than one DRP accessible primitives
have selects based on the most significant bits (does not include GTX lanes).
NOT-APPLICABLE if DRP_DISABLE is set (0x1).
ENDFIELD
FIELD
[15:0] 0x00000000
RESERVED
RO
Reserved for backwards compatibility
ENDFIELD
############################################################################################
############################################################################################
REG
0x001D
DRP_STATUS
DAC Interface Control & Status
ENDREG
FIELD
[17] 0x00000000
DRP_LOCKED
RO
If set indicates the MMCM/PLL is locked
ENDFIELD
FIELD
[16] 0x00000000
DRP_STATUS
RO
If set indicates busy (access pending). The read data may not be valid if
this bit is set (does not include GTX lanes).
NOT-APPLICABLE if DRP_DISABLE is set (0x1).
ENDFIELD
FIELD
[15:0] 0x00000000
RESERVED
RO
Reserved for backwards compatibility
ENDFIELD
############################################################################################
############################################################################################
REG
0x001E
DRP_WDATA
DAC Interface Control & Status
ENDREG
FIELD
[15:0] 0x00000000
DRP_WDATA
RW
DRP write data (does not include GTX lanes).
NOT-APPLICABLE if DRP_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x001F
DRP_RDATA
DAC Interface Control & Status
ENDREG
FIELD
[15:0] 0x00000000
DRP_RDATA
RO
DRP read data (does not include GTX lanes).
NOT-APPLICABLE if DRP_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x0020
DAC_CUSTOM_RD
DAC Read Configuration Data
ENDREG
FIELD
[31:0] 0x00000000
DAC_CUSTOM_RD
RO
Custom Read of the available registers.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0021
DAC_CUSTOM_WR
DAC Write Configuration Data
ENDREG
FIELD
[31:0] 0x00000000
DAC_CUSTOM_WR
RW
Custom Write of the available registers.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0022
UI_STATUS
User Interface Status
ENDREG
FIELD
[4] 0x00000000
IF_BUSY
RO
Interface busy. If set, indicates that the data interface is busy.
ENDFIELD
FIELD
[1] 0x00000000
UI_OVF
RW1C
User Interface overflow. If set, indicates an overflow occurred during data transfer at
the user interface (FIFO interface). Software must write a 0x1 to clear this register
bit.
ENDFIELD
FIELD
[0] 0x00000000
UI_UNF
RW1C
User Interface underflow. If set, indicates an underflow occurred during data transfer at
the user interface (FIFO interface). Software must write a 0x1 to clear this register
bit.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0023
DAC_CUSTOM_CTRL
DAC Control Configuration Data
ENDREG
FIELD
[31:0] 0x00000000
DAC_CUSTOM_CTRL
RW
Custom Control of the available registers.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0028
USR_CNTRL_1
DAC User Control & Status
ENDREG
FIELD
[7:0] 0x00000000
USR_CHANMAX
RW
This indicates the maximum number of inputs for the channel data multiplexers. User may add
different processing modules as inputs to the dac.
NOT-APPLICABLE if USERPORTS_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x002E
DAC_GPIO_IN
DAC GPIO inputs
ENDREG
FIELD
[31:0] 0x00000000
DAC_GPIO_IN
RO
This reads auxiliary GPI pins of the DAC core
ENDFIELD
############################################################################################
############################################################################################
REG
0x002F
DAC_GPIO_OUT
DAC GPIO outputs
ENDREG
FIELD
[31:0] 0x00000000
DAC_GPIO_OUT
RW
This controls auxiliary GPO pins of the DAC core
NOT-APPLICABLE if GPIO_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
TITLE
DAC Channel (axi_ad*)
DAC_CHANNEL
ENDTITLE
############################################################################################
############################################################################################
REG
0x0100 + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_1
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[21:16] 0x00000000
DDS_PHASE_DW
R
The DDS phase data width offers the HDL parameter configuration with the same
name. This information is used in conjunction with CHAN_CNTRL_9 and CHAN_CNTRL_10.
More info at :ref:`ad_dds`.
ENDFIELD
FIELD
[15:0] 0x00000000
DDS_SCALE_1
RW
The DDS scale for tone 1. Sets the amplitude of the tone. The format is 1.1.14
fixed point (signed, integer, fractional). The DDS in general runs on 16-bits,
note that if you do use both channels and set both scale to 0x4000, it is
over-range. The final output is (tone_1_fullscale * scale_1) +
(tone_2_fullscale * scale_2). NOT-APPLICABLE if DDS_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x0101 + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_2
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[31:16] 0x00000000
DDS_INIT_1
RW
The DDS phase initialization for tone 1. Sets the initial phase offset
of the tone. NOT-APPLICABLE if DDS_DISABLE is set (0x1).
ENDFIELD
FIELD
[15:0] 0x00000000
DDS_INCR_1
RW
Sets the frequency of the phase accumulator. Its value can be calculated
by :math:`INCR = (f_{out} * 2^{16}) * clkratio / f_{if}`; where f_out is the
generated output frequency, and f_if is the frequency of the digital
interface, and clock_ratio is the ratio between the sampling clock and
the interface clock. If DDS_PHASE_DW is greater than 16(from CHAN_CNTRL_1),
the phase increment for tone 1 is extended in CHAN_CNTRL_9. NOT-APPLICABLE
if DDS_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x0102 + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_3
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[15:0] 0x00000000
DDS_SCALE_2
RW
The DDS scale for tone 2. Sets the amplitude of the tone. The format
is 1.1.14 fixed point (signed, integer, fractional).
The DDS in general runs on 16-bits, note that if you do use both
channels and set both scale to 0x4000, it is over-range. The final
output is (tone_1_fullscale * scale_1) + (tone_2_fullscale * scale_2).
NOT-APPLICABLE if DDS_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x0103 + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_4
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[31:16] 0x00000000
DDS_INIT_2
RW
The DDS phase initialization for tone 2. Sets the initial phase offset of the
tone. If DDS_PHASE_DW is greater than 16(from CHAN_CNTRL_1), the phase init
for tone 2 is extended in CHAN_CNTRL_10. NOT-APPLICABLE if DDS_DISABLE is
set (0x1).
ENDFIELD
FIELD
[15:0] 0x00000000
DDS_INCR_2
RW
Sets the frequency of the phase accumulator. Its value can be calculated by
:math:`INCR = (f_{out} * 2^{16}) * clkratio / f_{if}`; where f_out is the generated
output frequency, and f_if is the frequency of the digital interface, and
clock_ratio is the ratio between the sampling clock and the interface clock.
If DDS_PHASE_DW is greater than 16(from CHAN_CNTRL_1), the phase increment
for tone 2 is extended in CHAN_CNTRL_10. NOT-APPLICABLE if DDS_DISABLE is
set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x0104 + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_5
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[31:16] 0x00000000
DDS_PATT_2
RW
The DDS data pattern for this channel.
ENDFIELD
FIELD
[15:0] 0x00000000
DDS_PATT_1
RW
The DDS data pattern for this channel.
ENDFIELD
############################################################################################
############################################################################################
REG
0x0105 + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_6
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[2] 0x00000000
IQCOR_ENB
RW
if set, enables IQ correction.
NOT-APPLICABLE if DAC_DP_DISABLE is set (0x1).
ENDFIELD
FIELD
[1] 0x00000000
DAC_LB_OWR
RW
If set, forces DAC_DDS_SEL to 0x8, loopback
If DAC_LB_OWR and DAC_PN_OWR are both set, they are ignored
ENDFIELD
FIELD
[0] 0x00000000
DAC_PN_OWR
RW
IF set, forces DAC_DDS_SEL to 0x09, device specific pnX
If DAC_LB_OWR and DAC_PN_OWR are both set, they are ignored
ENDFIELD
############################################################################################
############################################################################################
REG
0x0106 + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_7
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[3:0] 0x00000000
DAC_DDS_SEL
RW
Select internal data sources (available only if the DAC supports it). \\
- 0x00: internal tone (DDS) \\
- 0x01: pattern (SED) \\
- 0x02: input data (DMA) \\
- 0x03: 0x00 \\
- 0x04: inverted pn7 \\
- 0x05: inverted pn15 \\
- 0x06: pn7 (standard O.150) \\
- 0x07: pn15 (standard O.150) \\
- 0x08: loopback data (ADC) \\
- 0x09: pnX (Device specific e.g. ad9361) \\
- 0x0A: Nibble ramp (Device specific e.g. adrv9001) \\
- 0x0B: 16 bit ramp (Device specific e.g. adrv9001) \\
ENDFIELD
############################################################################################
############################################################################################
REG
0x0107 + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_8
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[31:16] 0x00000000
IQCOR_COEFF_1
RW
IQ correction (if equipped) coefficient. If scale & offset is implemented, this is the scale value
and the format is 1.1.14 (sign, integer and fractional bits). If matrix multiplication is used,
this is the channel I coefficient and the format is 1.1.14 (sign, integer and fractional bits).
NOT-APPLICABLE if IQCORRECTION_DISABLE is set (0x1).
ENDFIELD
FIELD
[15:0] 0x00000000
IQCOR_COEFF_2
RW
IQ correction (if equipped) coefficient. If scale & offset is implemented, this is the offset value
and the format is 2's complement. If matrix multiplication is used, this is the channel Q coefficient
and the format is 1.1.14 (sign, integer and fractional bits).
NOT-APPLICABLE if IQCORRECTION_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x0108 + 0x16*n
WHERE n IS FROM 0 TO 15
USR_CNTRLn_3
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[25] 0x00000000
USR_DATATYPE_BE
RW
The user data type format- if set, indicates big endian (default is little endian).
NOT-APPLICABLE if USERPORTS_DISABLE is set (0x1).
ENDFIELD
FIELD
[24] 0x00000000
USR_DATATYPE_SIGNED
RW
The user data type format- if set, indicates signed (2's complement) data (default is unsigned).
NOT-APPLICABLE if USERPORTS_DISABLE is set (0x1).
ENDFIELD
FIELD
[23:16] 0x00000000
USR_DATATYPE_SHIFT
RW
The user data type format- the amount of right shift for actual samples within the total number
of bits.
NOT-APPLICABLE if USERPORTS_DISABLE is set (0x1).
ENDFIELD
FIELD
[15:8] 0x00000000
USR_DATATYPE_TOTAL_BITS
RW
The user data type format- number of total bits used for a sample. The total number of bits must
be an integer multiple of 8 (byte aligned).
NOT-APPLICABLE if USERPORTS_DISABLE is set (0x1).
ENDFIELD
FIELD
[7:0] 0x00000000
USR_DATATYPE_BITS
RW
The user data type format- number of bits in a sample. This indicates the actual sample data bits.
NOT-APPLICABLE if USERPORTS_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x0109 + 0x16*n
WHERE n IS FROM 0 TO 15
USR_CNTRLn_4
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[31:16] 0x00000000
USR_INTERPOLATION_M
RW
This holds the user interpolation M value of the channel that is currently being
selected on the multiplexer above. The total interpolation factor is of the
form M/N. NOT-APPLICABLE if USERPORTS_DISABLE is set (0x1).
ENDFIELD
FIELD
[15:0] 0x00000000
USR_INTERPOLATION_N
RW
This holds the user interpolation N value of the channel that is currently being selected on
the multiplexer above. The total interpolation factor is of the form M/N.
NOT-APPLICABLE if USERPORTS_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x010A + 0x16*n
WHERE n IS FROM 0 TO 15
USR_CNTRLn_5
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[0] 0x00000000
DAC_IQ_MODE
RW
Enable complex mode. In this mode the driven data to the DAC must be a sequence
of I and Q sample pairs.
ENDFIELD
FIELD
[1] 0x00000000
DAC_IQ_SWAP
RW
Allows IQ swapping in complex mode. Only takes effect if complex mode
is enabled.
ENDFIELD
############################################################################################
############################################################################################
REG
0x010B + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_9
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[31:16] 0x00000000
DDS_INIT_1_EXTENDED
RW
The extended DDS phase initialization for tone 1. Sets the initial phase offset
of the tone. The extended init(phase) value should be calculated according to
DDS_PHASE_DW value from CHAN_CNTRL_1 NOT-APPLICABLE if DDS_DISABLE is
set (0x1).
ENDFIELD
FIELD
[15:0] 0x00000000
DDS_INCR_1_EXTENDED
RW
Sets the frequency of tone 1's phase accumulator. Its value can be calculated
by :math:`INCR = (f_{out} * 2^{phaseDW}) * clkratio / f_{if}`; Where f_out is the
generated output frequency, DDS_PHASE_DW value can be found in CHAN_CNTRL_1
in case DDS_PHASE_DW is not 16, f_if is the frequency of the digital interface,
and clock_ratio is the ratio between the sampling clock and the interface clock.
NOT-APPLICABLE if DDS_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################
REG
0x010C + 0x16*n
WHERE n IS FROM 0 TO 15
CHAN_CNTRLn_10
DAC Channel Control & Status (channel - 0)
ENDREG
FIELD
[31:16] 0x00000000
DDS_INIT_2_EXTENDED
RW
The extended DDS phase initialization for tone 2. Sets the initial phase offset
of the tone. The extended init(phase) value should be calculated according to
DDS_PHASE_DW value from CHAN_CNTRL_2 NOT-APPLICABLE if DDS_DISABLE is
set (0x1).
ENDFIELD
FIELD
[15:0] 0x00000000
DDS_INCR_2_EXTENDED
RW
Sets the frequency of tone 2's phase accumulator. Its value can be calculated
by :math:`INCR = (f_{out} * 2^{phaseDW}) * clkratio / f_{if}`; Where f_out is the
generated output frequency, DDS_PHASE_DW value can be found in CHAN_CNTRL_2
in case DDS_PHASE_DW is not 16, f_if is the frequency of the digital interface,
and clock_ratio is the ratio between the sampling clock and the interface clock.
NOT-APPLICABLE if DDS_DISABLE is set (0x1).
ENDFIELD
############################################################################################
############################################################################################