Commit 7c913fc1 authored by Matthieu Cattin's avatar Matthieu Cattin

doc: Update doc to describe new features.

parent 267af46a
This diff is collapsed.
...@@ -322,6 +322,26 @@ ...@@ -322,6 +322,26 @@
style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none" style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
transform="scale(0.4,0.4)" /> transform="scale(0.4,0.4)" />
</marker> </marker>
<inkscape:perspective
id="perspective3596"
inkscape:persp3d-origin="0.5 : 0.33333333 : 1"
inkscape:vp_z="1 : 0.5 : 1"
inkscape:vp_y="0 : 1000 : 0"
inkscape:vp_x="0 : 0.5 : 1"
sodipodi:type="inkscape:persp3d" />
<marker
inkscape:stockid="TriangleOutM"
orient="auto"
refY="0"
refX="0"
id="TriangleOutM-9"
style="overflow:visible">
<path
id="path3353-9"
d="m 5.77,0 -8.65,5 0,-10 8.65,5 z"
style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
transform="scale(0.4,0.4)" />
</marker>
</defs> </defs>
<sodipodi:namedview <sodipodi:namedview
id="base" id="base"
...@@ -330,17 +350,17 @@ ...@@ -330,17 +350,17 @@
borderopacity="1.0" borderopacity="1.0"
inkscape:pageopacity="0.0" inkscape:pageopacity="0.0"
inkscape:pageshadow="2" inkscape:pageshadow="2"
inkscape:zoom="1.4" inkscape:zoom="2"
inkscape:cx="297.12732" inkscape:cx="302.48352"
inkscape:cy="159.55387" inkscape:cy="61.274911"
inkscape:document-units="px" inkscape:document-units="px"
inkscape:current-layer="layer1" inkscape:current-layer="layer1"
showgrid="false" showgrid="true"
inkscape:snap-global="true" inkscape:snap-global="true"
inkscape:window-width="1920" inkscape:window-width="1920"
inkscape:window-height="1123" inkscape:window-height="1173"
inkscape:window-x="0" inkscape:window-x="0"
inkscape:window-y="25" inkscape:window-y="0"
inkscape:window-maximized="1"> inkscape:window-maximized="1">
<inkscape:grid <inkscape:grid
type="xygrid" type="xygrid"
...@@ -358,7 +378,7 @@ ...@@ -358,7 +378,7 @@
<dc:format>image/svg+xml</dc:format> <dc:format>image/svg+xml</dc:format>
<dc:type <dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title> <dc:title />
</cc:Work> </cc:Work>
</rdf:RDF> </rdf:RDF>
</metadata> </metadata>
...@@ -533,7 +553,7 @@ ...@@ -533,7 +553,7 @@
style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#TriangleOutM)" /> style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#TriangleOutM)" />
<path <path
style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#TriangleOutM)" style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#TriangleOutM)"
d="m 317.48138,83.464046 0,16.576924" d="m 292.73138,83.464046 0,16.576924"
id="path6082" /> id="path6082" />
<text <text
xml:space="preserve" xml:space="preserve"
...@@ -575,12 +595,12 @@ ...@@ -575,12 +595,12 @@
<text <text
xml:space="preserve" xml:space="preserve"
style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:Verdana;-inkscape-font-specification:Verdana" style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:Verdana;-inkscape-font-specification:Verdana"
x="293.26508" x="268.51508"
y="77.244675" y="77.244675"
id="text8539" id="text8539"
sodipodi:linespacing="125%"><tspan sodipodi:linespacing="125%"><tspan
sodipodi:role="line" sodipodi:role="line"
x="293.26508" x="268.51508"
y="77.244675" y="77.244675"
id="tspan8541">Threshold</tspan></text> id="tspan8541">Threshold</tspan></text>
<text <text
...@@ -780,5 +800,20 @@ ...@@ -780,5 +800,20 @@
style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:square;stroke-linejoin:miter;stroke-opacity:1" style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:square;stroke-linejoin:miter;stroke-opacity:1"
d="m 455.13411,254.23453 8.2921,0" d="m 455.13411,254.23453 8.2921,0"
id="path8587" /> id="path8587" />
<path
style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#TriangleOutM)"
d="m 340.48138,83.46405 0,16.57692"
id="path6082-8" />
<text
xml:space="preserve"
style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;font-family:Verdana;-inkscape-font-specification:Verdana"
x="340.93304"
y="77.244682"
id="text8539-8"
sodipodi:linespacing="125%"><tspan
sodipodi:role="line"
x="340.93304"
y="77.244682"
id="tspan3622">Filter</tspan></text>
</g> </g>
</svg> </svg>
...@@ -27,88 +27,112 @@ REG @tab ...@@ -27,88 +27,112 @@ REG @tab
Number of shots Number of shots
@item @code{0x18} @tab @item @code{0x18} @tab
REG @tab REG @tab
@code{shots_cnt} @tab
Remaining shots counter
@item @code{0x1c} @tab
REG @tab
@code{trig_pos} @tab @code{trig_pos} @tab
Trigger address register Trigger address register
@item @code{0x1c} @tab @item @code{0x20} @tab
REG @tab
@code{fs_freq} @tab
Sampling clock frequency
@item @code{0x24} @tab
REG @tab REG @tab
@code{sr} @tab @code{sr} @tab
Sample rate Sample rate
@item @code{0x20} @tab @item @code{0x28} @tab
REG @tab REG @tab
@code{pre_samples} @tab @code{pre_samples} @tab
Pre-trigger samples Pre-trigger samples
@item @code{0x24} @tab @item @code{0x2c} @tab
REG @tab REG @tab
@code{post_samples} @tab @code{post_samples} @tab
Post-trigger samples Post-trigger samples
@item @code{0x28} @tab @item @code{0x30} @tab
REG @tab REG @tab
@code{samples_cnt} @tab @code{samples_cnt} @tab
Samples counter Samples counter
@item @code{0x2c} @tab @item @code{0x34} @tab
REG @tab REG @tab
@code{ch1_ctl} @tab @code{ch1_ctl} @tab
Channel 1 control register Channel 1 control register
@item @code{0x30} @tab @item @code{0x38} @tab
REG @tab REG @tab
@code{ch1_sta} @tab @code{ch1_sta} @tab
Channel 1 status register Channel 1 status register
@item @code{0x34} @tab @item @code{0x3c} @tab
REG @tab REG @tab
@code{ch1_gain} @tab @code{ch1_gain} @tab
Channel 1 gain calibration register Channel 1 gain calibration register
@item @code{0x38} @tab @item @code{0x40} @tab
REG @tab REG @tab
@code{ch1_offset} @tab @code{ch1_offset} @tab
Channel 1 offset calibration register Channel 1 offset calibration register
@item @code{0x3c} @tab @item @code{0x44} @tab
REG @tab
@code{ch1_sat} @tab
Channel 1 saturation register
@item @code{0x48} @tab
REG @tab REG @tab
@code{ch2_ctl} @tab @code{ch2_ctl} @tab
Channel 2 control register Channel 2 control register
@item @code{0x40} @tab @item @code{0x4c} @tab
REG @tab REG @tab
@code{ch2_sta} @tab @code{ch2_sta} @tab
Channel 2 status register Channel 2 status register
@item @code{0x44} @tab @item @code{0x50} @tab
REG @tab REG @tab
@code{ch2_gain} @tab @code{ch2_gain} @tab
Channel 2 gain calibration register Channel 2 gain calibration register
@item @code{0x48} @tab @item @code{0x54} @tab
REG @tab REG @tab
@code{ch2_offset} @tab @code{ch2_offset} @tab
Channel 2 offset calibration register Channel 2 offset calibration register
@item @code{0x4c} @tab @item @code{0x58} @tab
REG @tab
@code{ch2_sat} @tab
Channel 2 saturation register
@item @code{0x5c} @tab
REG @tab REG @tab
@code{ch3_ctl} @tab @code{ch3_ctl} @tab
Channel 3 control register Channel 3 control register
@item @code{0x50} @tab @item @code{0x60} @tab
REG @tab REG @tab
@code{ch3_sta} @tab @code{ch3_sta} @tab
Channel 3 status register Channel 3 status register
@item @code{0x54} @tab @item @code{0x64} @tab
REG @tab REG @tab
@code{ch3_gain} @tab @code{ch3_gain} @tab
Channel 3 gain calibration register Channel 3 gain calibration register
@item @code{0x58} @tab @item @code{0x68} @tab
REG @tab REG @tab
@code{ch3_offset} @tab @code{ch3_offset} @tab
Channel 3 offset calibration register Channel 3 offset calibration register
@item @code{0x5c} @tab @item @code{0x6c} @tab
REG @tab
@code{ch3_sat} @tab
Channel 3 saturation register
@item @code{0x70} @tab
REG @tab REG @tab
@code{ch4_ctl} @tab @code{ch4_ctl} @tab
Channel 4 control register Channel 4 control register
@item @code{0x60} @tab @item @code{0x74} @tab
REG @tab REG @tab
@code{ch4_sta} @tab @code{ch4_sta} @tab
Channel 4 status register Channel 4 status register
@item @code{0x64} @tab @item @code{0x78} @tab
REG @tab REG @tab
@code{ch4_gain} @tab @code{ch4_gain} @tab
Channel 4 gain calibration register Channel 4 gain calibration register
@item @code{0x68} @tab @item @code{0x7c} @tab
REG @tab REG @tab
@code{ch4_offset} @tab @code{ch4_offset} @tab
Channel 4 offset calibration register Channel 4 offset calibration register
@item @code{0x80} @tab
REG @tab
@code{ch4_sat} @tab
Channel 4 saturation register
@end multitable @end multitable
@regsection @code{ctl} - Control register @regsection @code{ctl} - Control register
@multitable @columnfractions .10 .10 .15 .10 .55 @multitable @columnfractions .10 .10 .15 .10 .55
...@@ -227,11 +251,21 @@ Software trigger enable ...@@ -227,11 +251,21 @@ Software trigger enable
@code{INT_TRIG_SEL} @code{INT_TRIG_SEL}
@tab @code{0} @tab @tab @code{0} @tab
Channel selection for internal trigger Channel selection for internal trigger
@item @code{15...6} @item @code{6}
@tab R/W @tab
@code{INT_TRIG_TEST_EN}
@tab @code{0} @tab
Enable internal trigger test mode
@item @code{7}
@tab R/W @tab @tab R/W @tab
@code{RESERVED} @code{RESERVED}
@tab @code{0} @tab @tab @code{0} @tab
Reserved Reserved
@item @code{15...8}
@tab R/W @tab
@code{INT_TRIG_THRES_FILT}
@tab @code{0} @tab
Internal trigger threshold glitch filter
@item @code{31...16} @item @code{31...16}
@tab R/W @tab @tab R/W @tab
@code{INT_TRIG_THRES} @code{INT_TRIG_THRES}
...@@ -245,7 +279,9 @@ Threshold for internal trigger ...@@ -245,7 +279,9 @@ Threshold for internal trigger
@item @code{hw_trig_en} @tab 0: disable@*1: enable @item @code{hw_trig_en} @tab 0: disable@*1: enable
@item @code{sw_trig_en} @tab 0: disable@*1: enable @item @code{sw_trig_en} @tab 0: disable@*1: enable
@item @code{int_trig_sel} @tab 00: channel 1@*01: channel 2@*10: channel 3@*11: channel 4 @item @code{int_trig_sel} @tab 00: channel 1@*01: channel 2@*10: channel 3@*11: channel 4
@item @code{int_trig_test_en} @tab Test mode:@* ch1 = Channel 1 input(analogue)@* ch2 = Channel input over threshold (digital)@* ch3 = Channel input over threshold filtered (digital)@* ch4 = Trigger (digital)
@item @code{reserved} @tab Ignore on read, write with 0's @item @code{reserved} @tab Ignore on read, write with 0's
@item @code{int_trig_thres_filt} @tab Configures the internal trigger threshold glitch filter length.
@item @code{int_trig_thres} @tab Treated as binary two's complement and compared to raw ADC data. @item @code{int_trig_thres} @tab Treated as binary two's complement and compared to raw ADC data.
@end multitable @end multitable
@regsection @code{trig_dly} - Trigger delay @regsection @code{trig_dly} - Trigger delay
...@@ -290,6 +326,25 @@ Reserved ...@@ -290,6 +326,25 @@ Reserved
@item @code{nb} @tab Number of shots required in multi-shot mode, set to one for single-shot mode. @item @code{nb} @tab Number of shots required in multi-shot mode, set to one for single-shot mode.
@item @code{reserved} @tab Ignore on read, write with 0's @item @code{reserved} @tab Ignore on read, write with 0's
@end multitable @end multitable
@regsection @code{shots_cnt} - Remaining shots counter
@multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name
@item @code{15...0}
@tab R/O @tab
@code{VAL}
@tab @code{X} @tab
Remaining shots counter
@item @code{31...16}
@tab R/W @tab
@code{RESERVED}
@tab @code{0} @tab
Reserved
@end multitable
@multitable @columnfractions 0.15 0.85
@headitem Field @tab Description
@item @code{val} @tab Counts the number of remaining shots to acquire.
@item @code{reserved} @tab Ignore on read, write with 0's
@end multitable
@regsection @code{trig_pos} - Trigger address register @regsection @code{trig_pos} - Trigger address register
@multitable @columnfractions .10 .10 .15 .10 .55 @multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name @headitem Bits @tab Access @tab Prefix @tab Default @tab Name
...@@ -303,6 +358,19 @@ Trigger address ...@@ -303,6 +358,19 @@ Trigger address
@headitem Field @tab Description @headitem Field @tab Description
@item @code{trig_pos} @tab Trigger address in DDR memory.@*Only used in single-shot mode. @item @code{trig_pos} @tab Trigger address in DDR memory.@*Only used in single-shot mode.
@end multitable @end multitable
@regsection @code{fs_freq} - Sampling clock frequency
@multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name
@item @code{31...0}
@tab R/O @tab
@code{FS_FREQ}
@tab @code{X} @tab
Sampling clock frequency
@end multitable
@multitable @columnfractions 0.15 0.85
@headitem Field @tab Description
@item @code{fs_freq} @tab ADC sampling clock frequency in Hz
@end multitable
@regsection @code{sr} - Sample rate @regsection @code{sr} - Sample rate
@multitable @columnfractions .10 .10 .15 .10 .55 @multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name @headitem Bits @tab Access @tab Prefix @tab Default @tab Name
...@@ -431,6 +499,25 @@ Reserved ...@@ -431,6 +499,25 @@ Reserved
@item @code{val} @tab Offset applied to all data coming from the ADC. The format is binary two's complement. @item @code{val} @tab Offset applied to all data coming from the ADC. The format is binary two's complement.
@item @code{reserved} @tab Ignore on read, write with 0's @item @code{reserved} @tab Ignore on read, write with 0's
@end multitable @end multitable
@regsection @code{ch1_sat} - Channel 1 saturation register
@multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name
@item @code{14...0}
@tab R/W @tab
@code{VAL}
@tab @code{0} @tab
Saturation value for channel 1
@item @code{31...15}
@tab R/W @tab
@code{RESERVED}
@tab @code{0} @tab
Reserved
@end multitable
@multitable @columnfractions 0.15 0.85
@headitem Field @tab Description
@item @code{val} @tab Saturation applied to all data coming from the offset/gain correction block. The format is 15-bit unsigned.
@item @code{reserved} @tab Ignore on read, write with 0's
@end multitable
@regsection @code{ch2_ctl} - Channel 2 control register @regsection @code{ch2_ctl} - Channel 2 control register
@multitable @columnfractions .10 .10 .15 .10 .55 @multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name @headitem Bits @tab Access @tab Prefix @tab Default @tab Name
...@@ -507,6 +594,25 @@ Reserved ...@@ -507,6 +594,25 @@ Reserved
@item @code{val} @tab Offset applied to all data coming from the ADC. The format is binary two's complement. @item @code{val} @tab Offset applied to all data coming from the ADC. The format is binary two's complement.
@item @code{reserved} @tab Ignore on read, write with 0's @item @code{reserved} @tab Ignore on read, write with 0's
@end multitable @end multitable
@regsection @code{ch2_sat} - Channel 2 saturation register
@multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name
@item @code{14...0}
@tab R/W @tab
@code{VAL}
@tab @code{0} @tab
Saturation value for channel 2
@item @code{31...15}
@tab R/W @tab
@code{RESERVED}
@tab @code{0} @tab
Reserved
@end multitable
@multitable @columnfractions 0.15 0.85
@headitem Field @tab Description
@item @code{val} @tab Saturation applied to all data coming from the offset/gain correction block. The format is 15-bit unsigned.
@item @code{reserved} @tab Ignore on read, write with 0's
@end multitable
@regsection @code{ch3_ctl} - Channel 3 control register @regsection @code{ch3_ctl} - Channel 3 control register
@multitable @columnfractions .10 .10 .15 .10 .55 @multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name @headitem Bits @tab Access @tab Prefix @tab Default @tab Name
...@@ -583,6 +689,25 @@ Reserved ...@@ -583,6 +689,25 @@ Reserved
@item @code{val} @tab Offset applied to all data coming from the ADC. The format is binary two's complement. @item @code{val} @tab Offset applied to all data coming from the ADC. The format is binary two's complement.
@item @code{reserved} @tab Ignore on read, write with 0's @item @code{reserved} @tab Ignore on read, write with 0's
@end multitable @end multitable
@regsection @code{ch3_sat} - Channel 3 saturation register
@multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name
@item @code{14...0}
@tab R/W @tab
@code{VAL}
@tab @code{0} @tab
Saturation value for channel 3
@item @code{31...15}
@tab R/W @tab
@code{RESERVED}
@tab @code{0} @tab
Reserved
@end multitable
@multitable @columnfractions 0.15 0.85
@headitem Field @tab Description
@item @code{val} @tab Saturation applied to all data coming from the offset/gain correction block. The format is 15-bit unsigned.
@item @code{reserved} @tab Ignore on read, write with 0's
@end multitable
@regsection @code{ch4_ctl} - Channel 4 control register @regsection @code{ch4_ctl} - Channel 4 control register
@multitable @columnfractions .10 .10 .15 .10 .55 @multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name @headitem Bits @tab Access @tab Prefix @tab Default @tab Name
...@@ -659,3 +784,22 @@ Reserved ...@@ -659,3 +784,22 @@ Reserved
@item @code{val} @tab Offset applied to all data coming from the ADC. The format is binary two's complement. @item @code{val} @tab Offset applied to all data coming from the ADC. The format is binary two's complement.
@item @code{reserved} @tab Ignore on read, write with 0's @item @code{reserved} @tab Ignore on read, write with 0's
@end multitable @end multitable
@regsection @code{ch4_sat} - Channel 4 saturation register
@multitable @columnfractions .10 .10 .15 .10 .55
@headitem Bits @tab Access @tab Prefix @tab Default @tab Name
@item @code{14...0}
@tab R/W @tab
@code{VAL}
@tab @code{0} @tab
Saturation value for channel 4
@item @code{31...15}
@tab R/W @tab
@code{RESERVED}
@tab @code{0} @tab
Reserved
@end multitable
@multitable @columnfractions 0.15 0.85
@headitem Field @tab Description
@item @code{val} @tab Saturation applied to all data coming from the offset/gain correction block. The format is 15-bit unsigned.
@item @code{reserved} @tab Ignore on read, write with 0's
@end multitable
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
--------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------
-- File : ../rtl/fmc_adc_100Ms_csr.vhd -- File : ../rtl/fmc_adc_100Ms_csr.vhd
-- Author : auto-generated by wbgen2 from fmc_adc_100Ms_csr.wb -- Author : auto-generated by wbgen2 from fmc_adc_100Ms_csr.wb
-- Created : Wed Mar 19 16:50:21 2014 -- Created : Thu Mar 20 11:08:14 2014
-- Standard : VHDL'87 -- Standard : VHDL'87
--------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------
-- THIS FILE WAS GENERATED BY wbgen2 FROM SOURCE FILE fmc_adc_100Ms_csr.wb -- THIS FILE WAS GENERATED BY wbgen2 FROM SOURCE FILE fmc_adc_100Ms_csr.wb
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
* File : fmc_adc_100Ms_csr.h * File : fmc_adc_100Ms_csr.h
* Author : auto-generated by wbgen2 from fmc_adc_100Ms_csr.wb * Author : auto-generated by wbgen2 from fmc_adc_100Ms_csr.wb
* Created : Wed Mar 19 16:50:21 2014 * Created : Thu Mar 20 11:08:15 2014
* Standard : ANSI C * Standard : ANSI C
THIS FILE WAS GENERATED BY wbgen2 FROM SOURCE FILE fmc_adc_100Ms_csr.wb THIS FILE WAS GENERATED BY wbgen2 FROM SOURCE FILE fmc_adc_100Ms_csr.wb
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment