2 * This file is part of the libsigrok project.
4 * Copyright (C) 2011 Daniel Ribeiro <drwyrm@gmail.com>
5 * Copyright (C) 2012 Renato Caldas <rmsc@fe.up.pt>
6 * Copyright (C) 2013 Lior Elazary <lelazary@yahoo.com>
8 * This program is free software: you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation, either version 3 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program. If not, see <http://www.gnu.org/licenses/>.
22 #ifndef LIBSIGROK_HARDWARE_LINK_MSO19_PROTOCOL_H
23 #define LIBSIGROK_HARDWARE_LINK_MSO19_PROTOCOL_H
29 #include "libsigrok.h"
30 #include "libsigrok-internal.h"
32 #define LOG_PREFIX "link-mso19"
34 #define USB_VENDOR "3195"
35 #define USB_PRODUCT "f190"
37 #define NUM_PROBES (1 + 8)
38 #define NUM_TRIGGER_STAGES 4
39 #define TRIGGER_TYPE "01" //the first r/f is used for the whole group
40 #define SERIALCOMM "460800/8n1/flow=2"
41 #define SERIALCONN "/dev/ttyUSB0"
42 #define CLOCK_RATE SR_MHZ(100)
43 #define MIN_NUM_SAMPLES 4
45 #define MSO_TRIGGER_UNKNOWN '!'
46 #define MSO_TRIGGER_UNKNOWN1 '1'
47 #define MSO_TRIGGER_UNKNOWN2 '2'
48 #define MSO_TRIGGER_UNKNOWN3 '3'
49 #define MSO_TRIGGER_WAIT '4'
50 #define MSO_TRIGGER_FIRED '5'
51 #define MSO_TRIGGER_DATAREADY '6'
58 /* Structure for the pattern generator state */
60 /* Pattern generator clock config */
62 /* Buffer start address */
64 /* Buffer end address */
66 /* Pattern generator config */
70 /* Input/output configuration for the samples buffer (?) */
72 /* Number of loops for the pattern generator */
74 /* Bit enable mask for the I/O lines */
78 /* Data structure for the protocol trigger state */
79 struct mso_prototrig {
80 /* Word match buffer */
82 /* Masks for the wordmatch buffer */
84 /* SPI mode 0, 1, 2, 3. Set to 0 for I2C */
88 /* Private, per-device-instance driver context. */
93 struct sr_serial_dev_inst *serial;
94 // uint8_t num_sample_rates;
98 uint16_t offset_range;
99 uint64_t limit_samples;
100 uint64_t num_samples;
105 uint8_t la_threshold;
107 uint8_t dso_probe_attn;
109 uint8_t trigger_chan;
110 uint8_t trigger_slope;
111 uint8_t trigger_outsrc;
112 uint8_t trigger_state;
113 uint8_t trigger_holdoff[2];
115 uint8_t la_trigger_mask;
116 double dso_trigger_voltage;
117 uint16_t dso_trigger_width;
118 struct mso_prototrig protocol_trigger;
124 SR_PRIV int mso_parse_serial(const char *iSerial, const char *iProduct,
125 struct dev_context *ctx);
126 SR_PRIV int mso_check_trigger(struct sr_serial_dev_inst *serial,
128 SR_PRIV int mso_reset_adc(struct sr_dev_inst *sdi);
129 SR_PRIV int mso_clkrate_out(struct sr_serial_dev_inst *serial, uint16_t val);
130 SR_PRIV int mso_configure_rate(const struct sr_dev_inst *sdi, uint32_t rate);
131 SR_PRIV int mso_receive_data(int fd, int revents, void *cb_data);
132 SR_PRIV int mso_configure_trigger(const struct sr_dev_inst *sdi);
133 SR_PRIV int mso_configure_threshold_level(const struct sr_dev_inst *sdi);
134 SR_PRIV int mso_read_buffer(struct sr_dev_inst *sdi);
135 SR_PRIV int mso_arm(const struct sr_dev_inst *sdi);
136 SR_PRIV int mso_force_capture(struct sr_dev_inst *sdi);
137 SR_PRIV int mso_dac_out(const struct sr_dev_inst *sdi, uint16_t val);
138 SR_PRIV inline uint16_t mso_calc_raw_from_mv(struct dev_context *devc);
139 SR_PRIV int mso_reset_fsm(struct sr_dev_inst *sdi);
140 SR_PRIV int mso_toggle_led(struct sr_dev_inst *sdi, int state);
142 SR_PRIV int mso_configure_probes(const struct sr_dev_inst *sdi);
143 SR_PRIV void stop_acquisition(const struct sr_dev_inst *sdi);
145 /* bank agnostic registers */
148 /* bank 0 registers */
150 #define REG_TRIGGER 2
151 #define REG_CLKRATE1 9
152 #define REG_CLKRATE2 10
155 /* possibly bank agnostic: */
158 /* bank 2 registers (SPI/I2C protocol trigger) */
159 #define REG_PT_WORD(x) (x)
160 #define REG_PT_MASK(x) (x + 4)
161 #define REG_PT_SPIMODE 8
163 /* bits - REG_CTL1 */
164 #define BIT_CTL1_RESETFSM (1 << 0)
165 #define BIT_CTL1_ARM (1 << 1)
166 #define BIT_CTL1_ADC_UNKNOWN4 (1 << 4) /* adc enable? */
167 #define BIT_CTL1_RESETADC (1 << 6)
168 #define BIT_CTL1_LED (1 << 7)
170 /* bits - REG_CTL2 */
171 #define BITS_CTL2_BANK(x) (x & 0x3)
172 #define BIT_CTL2_SLOWMODE (1 << 5)
180 static const struct rate_map rate_map[] = {
181 { SR_MHZ(200), 0x0205, 0 },
182 { SR_MHZ(100), 0x0105, 0 },
183 { SR_MHZ(50), 0x0005, 0 },
184 { SR_MHZ(20), 0x0303, 0 },
185 { SR_MHZ(10), 0x0308, 0 },
186 { SR_MHZ(5), 0x030c, 0 },
187 { SR_MHZ(2), 0x0330, 0 },
188 { SR_MHZ(1), 0x0362, 0 },
189 { SR_KHZ(500), 0x03c6, 0 },
190 { SR_KHZ(200), 0x07f2, 0 },
191 { SR_KHZ(100), 0x0fe6, 0 },
192 { SR_KHZ(50), 0x1fce, 0 },
193 { SR_KHZ(20), 0x4f86, 0 },
194 { SR_KHZ(10), 0x9f0e, 0 },
195 { SR_KHZ(5), 0x03c7, 0x20 },
196 { SR_KHZ(2), 0x07f3, 0x20 },
197 { SR_KHZ(1), 0x0fe7, 0x20 },
198 { SR_HZ(500), 0x1fcf, 0x20 },
199 { SR_HZ(200), 0x4f87, 0x20 },
200 { SR_HZ(100), 0x9f0f, 0x20 },
203 /* FIXME: Determine corresponding voltages */
204 static const uint16_t la_threshold_map[] = {