2 * This file is part of the libsigrok project.
4 * Copyright (C) 2017 Sven Schnelle <svens@stackframe.org>
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
26 struct lecroy_wavedesc_2_x {
28 uint16_t comm_order; /* 1 - little endian */
29 uint32_t wave_descriptor_length;
30 uint32_t user_text_len;
32 uint32_t trigtime_array_length;
33 uint32_t ris_time1_array_length;
35 uint32_t wave_array1_length;
36 uint32_t wave_array2_length;
37 uint32_t wave_array3_length;
38 uint32_t wave_array4_length;
39 char instrument_name[16];
40 uint32_t instrument_number;
43 uint32_t wave_array_count;
44 uint32_t points_per_screen;
45 uint32_t first_valid_point;
46 uint32_t last_valid_point;
48 uint32_t sparsing_factor;
49 uint32_t segment_index;
50 uint32_t subarray_count;
51 uint32_t sweeps_per_acq;
52 uint16_t points_per_pair;
55 float vertical_offset;
58 uint16_t nominal_bits;
59 uint16_t nom_subarray_count;
67 } __attribute__((packed));
69 struct lecroy_wavedesc {
70 char descriptor_name[16];
71 char template_name[16];
73 struct lecroy_wavedesc_2_x version_2_x;
75 } __attribute__((packed));
77 static const char *coupling_options[] = {
78 "A1M", ///< AC with 1 MOhm termination
79 "D50", ///< DC with 50 Ohm termination
80 "D1M", ///< DC with 1 MOhm termination
85 static const char *scope_trigger_slopes[] = {
89 static const char *trigger_sources[] = {
90 "C1", "C2", "C3", "C4", "LINE", "EXT",
93 static const uint64_t timebases[][2] = {
95 { 20, 1000000000000 },
96 { 50, 1000000000000 },
97 { 100, 1000000000000 },
98 { 200, 1000000000000 },
99 { 500, 1000000000000 },
143 static const uint64_t vdivs[][2] = {
163 static const char *scope_analog_channel_names[] = {
164 "CH1", "CH2", "CH3", "CH4",
167 static const struct scope_config scope_models[] = {
172 .analog_channels = 4,
173 .analog_names = &scope_analog_channel_names,
175 .coupling_options = &coupling_options,
176 .num_coupling_options = ARRAY_SIZE(coupling_options),
178 .trigger_sources = &trigger_sources,
179 .num_trigger_sources = ARRAY_SIZE(trigger_sources),
181 .trigger_slopes = &scope_trigger_slopes,
182 .num_trigger_slopes = ARRAY_SIZE(scope_trigger_slopes),
184 .timebases = &timebases,
185 .num_timebases = ARRAY_SIZE(timebases),
188 .num_vdivs = ARRAY_SIZE(vdivs),
195 static void scope_state_dump(const struct scope_config *config,
196 struct scope_state *state)
201 for (i = 0; i < config->analog_channels; i++) {
202 tmp = sr_voltage_string((*config->vdivs)[state->analog_channels[i].vdiv][0],
203 (*config->vdivs)[state->analog_channels[i].vdiv][1]);
204 sr_info("State of analog channel %d -> %s : %s (coupling) %s (vdiv) %2.2e (offset)",
205 i + 1, state->analog_channels[i].state ? "On" : "Off",
206 (*config->coupling_options)[state->analog_channels[i].coupling],
207 tmp, state->analog_channels[i].vertical_offset);
210 tmp = sr_period_string((*config->timebases)[state->timebase][0],
211 (*config->timebases)[state->timebase][1]);
212 sr_info("Current timebase: %s", tmp);
215 tmp = sr_samplerate_string(state->sample_rate);
216 sr_info("Current samplerate: %s", tmp);
219 sr_info("Current trigger: %s (source), %s (slope) %.2f (offset)",
220 (*config->trigger_sources)[state->trigger_source],
221 (*config->trigger_slopes)[state->trigger_slope],
222 state->horiz_triggerpos);
225 static int scope_state_get_array_option(const char *resp,
226 const char *(*array)[], unsigned int n, int *result)
230 for (i = 0; i < n; i++) {
231 if (!g_strcmp0(resp, (*array)[i])) {
241 * This function takes a value of the form "2.000E-03" and returns the index
242 * of an array where a matching pair was found.
244 * @param value The string to be parsed.
245 * @param array The array of s/f pairs.
246 * @param array_len The number of pairs in the array.
247 * @param result The index at which a matching pair was found.
249 * @return SR_ERR on any parsing error, SR_OK otherwise.
251 static int array_float_get(gchar *value, const uint64_t array[][2],
252 int array_len, unsigned int *result)
254 struct sr_rational rval;
255 struct sr_rational aval;
257 if (sr_parse_rational(value, &rval) != SR_OK)
260 for (int i = 0; i < array_len; i++) {
261 sr_rational_set(&aval, array[i][0], array[i][1]);
262 if (sr_rational_eq(&rval, &aval)) {
271 static int analog_channel_state_get(struct sr_scpi_dev_inst *scpi,
272 const struct scope_config *config, struct scope_state *state)
275 char command[MAX_COMMAND_SIZE];
278 for (i = 0; i < config->analog_channels; i++) {
279 g_snprintf(command, sizeof(command), "C%d:TRACE?", i + 1);
281 if (sr_scpi_get_bool(scpi, command,
282 &state->analog_channels[i].state) != SR_OK)
285 g_snprintf(command, sizeof(command), "C%d:VDIV?", i + 1);
287 if (sr_scpi_get_string(scpi, command, &tmp_str) != SR_OK)
290 if (array_float_get(tmp_str, ARRAY_AND_SIZE(vdivs), &j) != SR_OK) {
292 sr_err("Could not determine array index for vertical div scale.");
297 state->analog_channels[i].vdiv = j;
299 g_snprintf(command, sizeof(command), "C%d:OFFSET?", i + 1);
301 if (sr_scpi_get_float(scpi, command, &state->analog_channels[i].vertical_offset) != SR_OK)
304 g_snprintf(command, sizeof(command), "C%d:COUPLING?", i + 1);
306 if (sr_scpi_get_string(scpi, command, &tmp_str) != SR_OK)
310 if (scope_state_get_array_option(tmp_str, config->coupling_options,
311 config->num_coupling_options,
312 &state->analog_channels[i].coupling) != SR_OK)
321 SR_PRIV int lecroy_xstream_channel_state_set(const struct sr_dev_inst *sdi,
322 const int ch_index, gboolean ch_state)
325 struct sr_channel *ch;
326 struct dev_context *devc = NULL;
327 struct scope_state *state;
328 char command[MAX_COMMAND_SIZE];
335 state = devc->model_state;
338 for (l = sdi->channels; l; l = l->next) {
342 case SR_CHANNEL_ANALOG:
343 if (ch->index == ch_index) {
344 g_snprintf(command, sizeof(command), "C%d:TRACE %s", ch_index + 1,
345 (ch_state ? "ON" : "OFF"));
346 if ((sr_scpi_send(sdi->conn, command) != SR_OK ||
347 sr_scpi_get_opc(sdi->conn) != SR_OK)) {
352 ch->enabled = ch_state;
353 state->analog_channels[ch->index].state = ch_state;
363 if ((result == SR_OK) && !chan_found)
369 SR_PRIV int lecroy_xstream_update_sample_rate(const struct sr_dev_inst *sdi)
371 struct dev_context *devc;
372 struct scope_state *state;
373 const struct scope_config *config;
374 float memsize, timediv;
377 state = devc->model_state;
378 config = devc->model_config;
380 if (sr_scpi_get_float(sdi->conn, "MEMORY_SIZE?", &memsize) != SR_OK)
383 if (sr_scpi_get_float(sdi->conn, "TIME_DIV?", &timediv) != SR_OK)
386 state->sample_rate = 1 / ((timediv * config->num_xdivs) / memsize);
391 SR_PRIV int lecroy_xstream_state_get(struct sr_dev_inst *sdi)
393 struct dev_context *devc;
394 struct scope_state *state;
395 const struct scope_config *config;
397 char *tmp_str, *tmp_str2, *tmpp, *p, *key;
398 char command[MAX_COMMAND_SIZE];
399 char *trig_source = NULL;
402 config = devc->model_config;
403 state = devc->model_state;
405 sr_info("Fetching scope state");
407 if (analog_channel_state_get(sdi->conn, config, state) != SR_OK)
410 if (sr_scpi_get_string(sdi->conn, "TIME_DIV?", &tmp_str) != SR_OK)
413 if (array_float_get(tmp_str, ARRAY_AND_SIZE(timebases), &i) != SR_OK) {
415 sr_err("Could not determine array index for timbase scale.");
421 if (sr_scpi_get_string(sdi->conn, "TRIG_SELECT?", &tmp_str) != SR_OK)
427 while ((p = strtok_r(tmp_str2, ",", &tmpp))) {
434 } else if (!(i & 1)) {
435 if (!strcmp(key, "SR"))
441 if (!trig_source || scope_state_get_array_option(trig_source,
442 config->trigger_sources, config->num_trigger_sources,
443 &state->trigger_source) != SR_OK)
446 g_snprintf(command, sizeof(command), "%s:TRIG_SLOPE?", trig_source);
447 if (sr_scpi_get_string(sdi->conn, command, &tmp_str) != SR_OK)
450 if (scope_state_get_array_option(tmp_str, config->trigger_slopes,
451 config->num_trigger_slopes, &state->trigger_slope) != SR_OK)
454 if (sr_scpi_get_float(sdi->conn, "TRIG_DELAY?", &state->horiz_triggerpos) != SR_OK)
457 if (lecroy_xstream_update_sample_rate(sdi) != SR_OK)
460 sr_info("Fetching finished.");
462 scope_state_dump(config, state);
467 static struct scope_state *scope_state_new(const struct scope_config *config)
469 struct scope_state *state;
471 state = g_malloc0(sizeof(struct scope_state));
472 state->analog_channels = g_malloc0_n(config->analog_channels,
473 sizeof(struct analog_channel_state));
477 SR_PRIV void lecroy_xstream_state_free(struct scope_state *state)
479 g_free(state->analog_channels);
483 SR_PRIV int lecroy_xstream_init_device(struct sr_dev_inst *sdi)
485 char command[MAX_COMMAND_SIZE];
488 struct sr_channel *ch;
489 struct dev_context *devc;
490 gboolean channel_enabled;
495 /* Find the exact model. */
496 for (i = 0; i < ARRAY_SIZE(scope_models); i++) {
497 for (j = 0; scope_models[i].name[j]; j++) {
498 if (!strcmp(sdi->model, scope_models[i].name[j])) {
503 if (model_index != -1)
507 if (model_index == -1) {
508 sr_dbg("Unknown LeCroy device, using default config.");
509 for (i = 0; i < ARRAY_SIZE(scope_models); i++)
510 if (scope_models[i].name[0] == NULL)
514 /* Set the desired response and format modes. */
515 sr_scpi_send(sdi->conn, "COMM_HEADER OFF");
516 sr_scpi_send(sdi->conn, "COMM_FORMAT DEF9,WORD,BIN");
518 devc->analog_groups = g_malloc0(sizeof(struct sr_channel_group*) *
519 scope_models[model_index].analog_channels);
521 /* Add analog channels. */
522 for (i = 0; i < scope_models[model_index].analog_channels; i++) {
523 g_snprintf(command, sizeof(command), "C%d:TRACE?", i + 1);
525 if (sr_scpi_get_bool(sdi->conn, command, &channel_enabled) != SR_OK)
528 g_snprintf(command, sizeof(command), "C%d:VDIV?", i + 1);
530 ch = sr_channel_new(sdi, i, SR_CHANNEL_ANALOG, channel_enabled,
531 (*scope_models[model_index].analog_names)[i]);
533 devc->analog_groups[i] = g_malloc0(sizeof(struct sr_channel_group));
535 devc->analog_groups[i]->name = g_strdup(
536 (char *)(*scope_models[model_index].analog_names)[i]);
537 devc->analog_groups[i]->channels = g_slist_append(NULL, ch);
539 sdi->channel_groups = g_slist_append(sdi->channel_groups,
540 devc->analog_groups[i]);
543 devc->model_config = &scope_models[model_index];
544 devc->frame_limit = 0;
545 devc->model_state = scope_state_new(devc->model_config);
550 static int lecroy_waveform_2_x_to_analog(GByteArray *data,
551 struct lecroy_wavedesc *desc, struct sr_datafeed_analog *analog)
553 struct sr_analog_encoding *encoding = analog->encoding;
554 struct sr_analog_meaning *meaning = analog->meaning;
555 struct sr_analog_spec *spec = analog->spec;
557 int16_t *waveform_data;
558 unsigned int i, num_samples;
560 data_float = g_malloc(desc->version_2_x.wave_array_count * sizeof(float));
561 num_samples = desc->version_2_x.wave_array_count;
563 waveform_data = (int16_t*)(data->data +
564 + desc->version_2_x.wave_descriptor_length
565 + desc->version_2_x.user_text_len);
567 for (i = 0; i < num_samples; i++)
568 data_float[i] = (float)waveform_data[i]
569 * desc->version_2_x.vertical_gain
570 + desc->version_2_x.vertical_offset;
572 analog->data = data_float;
573 analog->num_samples = num_samples;
575 encoding->unitsize = sizeof(float);
576 encoding->is_signed = TRUE;
577 encoding->is_float = TRUE;
578 encoding->is_bigendian = FALSE;
579 encoding->scale.p = 1;
580 encoding->scale.q = 1;
581 encoding->offset.p = 0;
582 encoding->offset.q = 1;
584 encoding->digits = 6;
585 encoding->is_digits_decimal = FALSE;
587 if (strcmp(desc->version_2_x.vertunit, "A")) {
588 meaning->mq = SR_MQ_CURRENT;
589 meaning->unit = SR_UNIT_AMPERE;
591 /* Default to voltage. */
592 meaning->mq = SR_MQ_VOLTAGE;
593 meaning->unit = SR_UNIT_VOLT;
596 meaning->mqflags = 0;
597 spec->spec_digits = 3;
602 static int lecroy_waveform_to_analog(GByteArray *data,
603 struct sr_datafeed_analog *analog)
605 struct lecroy_wavedesc *desc;
607 if (data->len < sizeof(struct lecroy_wavedesc))
610 desc = (struct lecroy_wavedesc*)data->data;
612 if (!strncmp(desc->template_name, "LECROY_2_2", 16) ||
613 !strncmp(desc->template_name, "LECROY_2_3", 16)) {
614 return lecroy_waveform_2_x_to_analog(data, desc, analog);
617 sr_err("Waveformat template '%.16s' not supported.", desc->template_name);
621 SR_PRIV int lecroy_xstream_receive_data(int fd, int revents, void *cb_data)
623 char command[MAX_COMMAND_SIZE];
624 struct sr_channel *ch;
625 struct sr_dev_inst *sdi;
626 struct dev_context *devc;
627 struct sr_datafeed_packet packet;
629 struct sr_datafeed_analog analog;
630 struct sr_analog_encoding encoding;
631 struct sr_analog_meaning meaning;
632 struct sr_analog_spec spec;
640 if (!(sdi = cb_data))
643 if (!(devc = sdi->priv))
646 ch = devc->current_channel->data;
648 if (ch->type != SR_CHANNEL_ANALOG)
651 /* Pass on the received data of the channel(s). */
652 if (sr_scpi_read_data(sdi->conn, buf, 4) != 4) {
653 sr_err("Reading header failed, scope probably didn't send any data.");
657 if (sr_scpi_get_block(sdi->conn, NULL, &data) != SR_OK) {
659 g_byte_array_free(data, TRUE);
663 analog.encoding = &encoding;
664 analog.meaning = &meaning;
667 if (lecroy_waveform_to_analog(data, &analog) != SR_OK)
670 if (analog.num_samples == 0) {
671 /* No data available, we have to acquire data first. */
672 g_snprintf(command, sizeof(command), "ARM;WAIT;*OPC;C%d:WAVEFORM?", ch->index + 1);
673 sr_scpi_send(sdi->conn, command);
678 * Send "frame begin" packet upon reception of data for the
679 * first enabled channel.
681 if (devc->current_channel == devc->enabled_channels) {
682 packet.type = SR_DF_FRAME_BEGIN;
683 sr_session_send(sdi, &packet);
686 meaning.channels = g_slist_append(NULL, ch);
687 packet.payload = &analog;
688 packet.type = SR_DF_ANALOG;
689 sr_session_send(sdi, &packet);
691 g_byte_array_free(data, TRUE);
694 g_slist_free(meaning.channels);
698 * Advance to the next enabled channel. When data for all enabled
699 * channels was received, then flush potentially queued logic data,
700 * and send the "frame end" packet.
702 if (devc->current_channel->next) {
703 devc->current_channel = devc->current_channel->next;
704 lecroy_xstream_request_data(sdi);
708 packet.type = SR_DF_FRAME_END;
709 sr_session_send(sdi, &packet);
712 * End of frame was reached. Stop acquisition after the specified
713 * number of frames, or continue reception by starting over at
714 * the first enabled channel.
716 if (++devc->num_frames == devc->frame_limit) {
717 sr_dev_acquisition_stop(sdi);
719 devc->current_channel = devc->enabled_channels;
720 lecroy_xstream_request_data(sdi);