]> sigrok.org Git - pulseview.git/blame_incremental - pv/data/decodesignal.cpp
Fix bar displaying undecoded area
[pulseview.git] / pv / data / decodesignal.cpp
... / ...
CommitLineData
1/*
2 * This file is part of the PulseView project.
3 *
4 * Copyright (C) 2017 Soeren Apel <soeren@apelpie.net>
5 *
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 2 of the License, or
9 * (at your option) any later version.
10 *
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.
15 *
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/>.
18 */
19
20#include <limits>
21
22#include <QDebug>
23
24#include "logic.hpp"
25#include "logicsegment.hpp"
26#include "decodesignal.hpp"
27#include "signaldata.hpp"
28
29#include <pv/binding/decoder.hpp>
30#include <pv/data/decode/decoder.hpp>
31#include <pv/data/decode/row.hpp>
32#include <pv/globalsettings.hpp>
33#include <pv/session.hpp>
34
35using std::lock_guard;
36using std::make_pair;
37using std::make_shared;
38using std::min;
39using std::out_of_range;
40using std::shared_ptr;
41using std::unique_lock;
42using pv::data::decode::Annotation;
43using pv::data::decode::Decoder;
44using pv::data::decode::Row;
45
46namespace pv {
47namespace data {
48
49const double DecodeSignal::DecodeMargin = 1.0;
50const double DecodeSignal::DecodeThreshold = 0.2;
51const int64_t DecodeSignal::DecodeChunkLength = 256 * 1024;
52
53
54DecodeSignal::DecodeSignal(pv::Session &session) :
55 SignalBase(nullptr, SignalBase::DecodeChannel),
56 session_(session),
57 srd_session_(nullptr),
58 logic_mux_data_invalid_(false),
59 stack_config_changed_(true),
60 current_segment_id_(0)
61{
62 connect(&session_, SIGNAL(capture_state_changed(int)),
63 this, SLOT(on_capture_state_changed(int)));
64}
65
66DecodeSignal::~DecodeSignal()
67{
68 reset_decode(true);
69}
70
71const vector< shared_ptr<Decoder> >& DecodeSignal::decoder_stack() const
72{
73 return stack_;
74}
75
76void DecodeSignal::stack_decoder(const srd_decoder *decoder)
77{
78 assert(decoder);
79 const shared_ptr<Decoder> dec = make_shared<decode::Decoder>(decoder);
80
81 stack_.push_back(dec);
82
83 // Set name if this decoder is the first in the list
84 if (stack_.size() == 1)
85 set_name(QString::fromUtf8(decoder->name));
86
87 // Include the newly created decode channels in the channel lists
88 update_channel_list();
89
90 stack_config_changed_ = true;
91 auto_assign_signals(dec);
92 commit_decoder_channels();
93 begin_decode();
94}
95
96void DecodeSignal::remove_decoder(int index)
97{
98 assert(index >= 0);
99 assert(index < (int)stack_.size());
100
101 // Find the decoder in the stack
102 auto iter = stack_.begin();
103 for (int i = 0; i < index; i++, iter++)
104 assert(iter != stack_.end());
105
106 // Delete the element
107 stack_.erase(iter);
108
109 // Update channels and decoded data
110 stack_config_changed_ = true;
111 update_channel_list();
112 begin_decode();
113}
114
115bool DecodeSignal::toggle_decoder_visibility(int index)
116{
117 auto iter = stack_.cbegin();
118 for (int i = 0; i < index; i++, iter++)
119 assert(iter != stack_.end());
120
121 shared_ptr<Decoder> dec = *iter;
122
123 // Toggle decoder visibility
124 bool state = false;
125 if (dec) {
126 state = !dec->shown();
127 dec->show(state);
128 }
129
130 return state;
131}
132
133void DecodeSignal::reset_decode(bool shutting_down)
134{
135 if (stack_config_changed_ || shutting_down)
136 stop_srd_session();
137 else
138 terminate_srd_session();
139
140 if (decode_thread_.joinable()) {
141 decode_interrupt_ = true;
142 decode_input_cond_.notify_one();
143 decode_thread_.join();
144 }
145
146 if (logic_mux_thread_.joinable()) {
147 logic_mux_interrupt_ = true;
148 logic_mux_cond_.notify_one();
149 logic_mux_thread_.join();
150 }
151
152 class_rows_.clear();
153 current_segment_id_ = 0;
154 segments_.clear();
155
156 logic_mux_data_.reset();
157 logic_mux_data_invalid_ = true;
158
159 if (!error_message_.isEmpty()) {
160 error_message_ = QString();
161 // TODO Emulate noquote()
162 qDebug().nospace() << name() << ": Error cleared";
163 }
164
165 decode_reset();
166}
167
168void DecodeSignal::begin_decode()
169{
170 if (decode_thread_.joinable()) {
171 decode_interrupt_ = true;
172 decode_input_cond_.notify_one();
173 decode_thread_.join();
174 }
175
176 if (logic_mux_thread_.joinable()) {
177 logic_mux_interrupt_ = true;
178 logic_mux_cond_.notify_one();
179 logic_mux_thread_.join();
180 }
181
182 reset_decode();
183
184 if (stack_.size() == 0) {
185 set_error_message(tr("No decoders"));
186 return;
187 }
188
189 assert(channels_.size() > 0);
190
191 if (get_assigned_signal_count() == 0) {
192 set_error_message(tr("There are no channels assigned to this decoder"));
193 return;
194 }
195
196 // Make sure that all assigned channels still provide logic data
197 // (can happen when a converted signal was assigned but the
198 // conversion removed in the meanwhile)
199 for (data::DecodeChannel &ch : channels_)
200 if (ch.assigned_signal && !(ch.assigned_signal->logic_data() != nullptr))
201 ch.assigned_signal = nullptr;
202
203 // Check that all decoders have the required channels
204 for (const shared_ptr<decode::Decoder> &dec : stack_)
205 if (!dec->have_required_channels()) {
206 set_error_message(tr("One or more required channels "
207 "have not been specified"));
208 return;
209 }
210
211 // Map out all the annotation classes
212 for (const shared_ptr<decode::Decoder> &dec : stack_) {
213 assert(dec);
214 const srd_decoder *const decc = dec->decoder();
215 assert(dec->decoder());
216
217 for (const GSList *l = decc->annotation_rows; l; l = l->next) {
218 const srd_decoder_annotation_row *const ann_row =
219 (srd_decoder_annotation_row *)l->data;
220 assert(ann_row);
221
222 const Row row(decc, ann_row);
223
224 for (const GSList *ll = ann_row->ann_classes;
225 ll; ll = ll->next)
226 class_rows_[make_pair(decc,
227 GPOINTER_TO_INT(ll->data))] = row;
228 }
229 }
230
231 // Free the logic data and its segment(s) if it needs to be updated
232 if (logic_mux_data_invalid_)
233 logic_mux_data_.reset();
234
235 if (!logic_mux_data_) {
236 const uint32_t ch_count = get_assigned_signal_count();
237 logic_mux_unit_size_ = (ch_count + 7) / 8;
238 logic_mux_data_ = make_shared<Logic>(ch_count);
239 }
240
241 // Receive notifications when new sample data is available
242 connect_input_notifiers();
243
244 if (get_input_segment_count() == 0) {
245 set_error_message(tr("No input data"));
246 return;
247 }
248
249 // Make sure the logic output data is complete and up-to-date
250 logic_mux_interrupt_ = false;
251 logic_mux_thread_ = std::thread(&DecodeSignal::logic_mux_proc, this);
252
253 // Decode the muxed logic data
254 decode_interrupt_ = false;
255 decode_thread_ = std::thread(&DecodeSignal::decode_proc, this);
256}
257
258QString DecodeSignal::error_message() const
259{
260 lock_guard<mutex> lock(output_mutex_);
261 return error_message_;
262}
263
264const vector<data::DecodeChannel> DecodeSignal::get_channels() const
265{
266 return channels_;
267}
268
269void DecodeSignal::auto_assign_signals(const shared_ptr<Decoder> dec)
270{
271 bool new_assignment = false;
272
273 // Try to auto-select channels that don't have signals assigned yet
274 for (data::DecodeChannel &ch : channels_) {
275 // If a decoder is given, auto-assign only its channels
276 if (dec && (ch.decoder_ != dec))
277 continue;
278
279 if (ch.assigned_signal)
280 continue;
281
282 for (shared_ptr<data::SignalBase> s : session_.signalbases()) {
283 const QString ch_name = ch.name.toLower();
284 const QString s_name = s->name().toLower();
285
286 if (s->logic_data() &&
287 ((ch_name.contains(s_name)) || (s_name.contains(ch_name)))) {
288 ch.assigned_signal = s.get();
289 new_assignment = true;
290 }
291 }
292 }
293
294 if (new_assignment) {
295 logic_mux_data_invalid_ = true;
296 stack_config_changed_ = true;
297 commit_decoder_channels();
298 channels_updated();
299 }
300}
301
302void DecodeSignal::assign_signal(const uint16_t channel_id, const SignalBase *signal)
303{
304 for (data::DecodeChannel &ch : channels_)
305 if (ch.id == channel_id) {
306 ch.assigned_signal = signal;
307 logic_mux_data_invalid_ = true;
308 }
309
310 stack_config_changed_ = true;
311 commit_decoder_channels();
312 channels_updated();
313 begin_decode();
314}
315
316int DecodeSignal::get_assigned_signal_count() const
317{
318 // Count all channels that have a signal assigned to them
319 return count_if(channels_.begin(), channels_.end(),
320 [](data::DecodeChannel ch) { return ch.assigned_signal; });
321}
322
323void DecodeSignal::set_initial_pin_state(const uint16_t channel_id, const int init_state)
324{
325 for (data::DecodeChannel &ch : channels_)
326 if (ch.id == channel_id)
327 ch.initial_pin_state = init_state;
328
329 stack_config_changed_ = true;
330 channels_updated();
331 begin_decode();
332}
333
334double DecodeSignal::samplerate() const
335{
336 double result = 0;
337
338 // TODO For now, we simply return the first samplerate that we have
339 if (segments_.size() > 0)
340 result = segments_.front().samplerate;
341
342 return result;
343}
344
345const pv::util::Timestamp DecodeSignal::start_time() const
346{
347 pv::util::Timestamp result;
348
349 // TODO For now, we simply return the first start time that we have
350 if (segments_.size() > 0)
351 result = segments_.front().start_time;
352
353 return result;
354}
355
356int64_t DecodeSignal::get_working_sample_count(uint32_t segment_id) const
357{
358 // The working sample count is the highest sample number for
359 // which all used signals have data available, so go through all
360 // channels and use the lowest overall sample count of the segment
361
362 int64_t count = std::numeric_limits<int64_t>::max();
363 bool no_signals_assigned = true;
364
365 for (const data::DecodeChannel &ch : channels_)
366 if (ch.assigned_signal) {
367 no_signals_assigned = false;
368
369 const shared_ptr<Logic> logic_data = ch.assigned_signal->logic_data();
370 if (!logic_data || logic_data->logic_segments().empty())
371 return 0;
372
373 try {
374 const shared_ptr<LogicSegment> segment = logic_data->logic_segments().at(segment_id);
375 count = min(count, (int64_t)segment->get_sample_count());
376 } catch (out_of_range&) {
377 return 0;
378 }
379 }
380
381 return (no_signals_assigned ? 0 : count);
382}
383
384int64_t DecodeSignal::get_decoded_sample_count(uint32_t segment_id) const
385{
386 lock_guard<mutex> decode_lock(output_mutex_);
387
388 int64_t result = 0;
389
390 try {
391 const DecodeSegment *segment = &(segments_.at(segment_id));
392 result = segment->samples_decoded;
393 } catch (out_of_range&) {
394 // Do nothing
395 }
396
397 return result;
398}
399
400vector<Row> DecodeSignal::visible_rows() const
401{
402 lock_guard<mutex> lock(output_mutex_);
403
404 vector<Row> rows;
405
406 for (const shared_ptr<decode::Decoder> &dec : stack_) {
407 assert(dec);
408 if (!dec->shown())
409 continue;
410
411 const srd_decoder *const decc = dec->decoder();
412 assert(dec->decoder());
413
414 // Add a row for the decoder if it doesn't have a row list
415 if (!decc->annotation_rows)
416 rows.emplace_back(decc);
417
418 // Add the decoder rows
419 for (const GSList *l = decc->annotation_rows; l; l = l->next) {
420 const srd_decoder_annotation_row *const ann_row =
421 (srd_decoder_annotation_row *)l->data;
422 assert(ann_row);
423 rows.emplace_back(decc, ann_row);
424 }
425 }
426
427 return rows;
428}
429
430void DecodeSignal::get_annotation_subset(
431 vector<pv::data::decode::Annotation> &dest,
432 const decode::Row &row, uint32_t segment_id, uint64_t start_sample,
433 uint64_t end_sample) const
434{
435 lock_guard<mutex> lock(output_mutex_);
436
437 try {
438 const DecodeSegment *segment = &(segments_.at(segment_id));
439 const map<const decode::Row, decode::RowData> *rows =
440 &(segment->annotation_rows);
441
442 const auto iter = rows->find(row);
443 if (iter != rows->end())
444 (*iter).second.get_annotation_subset(dest,
445 start_sample, end_sample);
446 } catch (out_of_range&) {
447 // Do nothing
448 }
449}
450
451void DecodeSignal::save_settings(QSettings &settings) const
452{
453 SignalBase::save_settings(settings);
454
455 settings.setValue("decoders", (int)(stack_.size()));
456
457 // Save decoder stack
458 int decoder_idx = 0;
459 for (shared_ptr<decode::Decoder> decoder : stack_) {
460 settings.beginGroup("decoder" + QString::number(decoder_idx++));
461
462 settings.setValue("id", decoder->decoder()->id);
463
464 // Save decoder options
465 const map<string, GVariant*>& options = decoder->options();
466
467 settings.setValue("options", (int)options.size());
468
469 // Note: decode::Decoder::options() returns only the options
470 // that differ from the default. See binding::Decoder::getter()
471 int i = 0;
472 for (auto option : options) {
473 settings.beginGroup("option" + QString::number(i));
474 settings.setValue("name", QString::fromStdString(option.first));
475 GlobalSettings::store_gvariant(settings, option.second);
476 settings.endGroup();
477 i++;
478 }
479
480 settings.endGroup();
481 }
482
483 // Save channel mapping
484 settings.setValue("channels", (int)channels_.size());
485
486 for (unsigned int channel_id = 0; channel_id < channels_.size(); channel_id++) {
487 auto channel = find_if(channels_.begin(), channels_.end(),
488 [&](data::DecodeChannel ch) { return ch.id == channel_id; });
489
490 if (channel == channels_.end()) {
491 qDebug() << "ERROR: Gap in channel index:" << channel_id;
492 continue;
493 }
494
495 settings.beginGroup("channel" + QString::number(channel_id));
496
497 settings.setValue("name", channel->name); // Useful for debugging
498 settings.setValue("initial_pin_state", channel->initial_pin_state);
499
500 if (channel->assigned_signal)
501 settings.setValue("assigned_signal_name", channel->assigned_signal->name());
502
503 settings.endGroup();
504 }
505}
506
507void DecodeSignal::restore_settings(QSettings &settings)
508{
509 SignalBase::restore_settings(settings);
510
511 // Restore decoder stack
512 GSList *dec_list = g_slist_copy((GSList*)srd_decoder_list());
513
514 int decoders = settings.value("decoders").toInt();
515
516 for (int decoder_idx = 0; decoder_idx < decoders; decoder_idx++) {
517 settings.beginGroup("decoder" + QString::number(decoder_idx));
518
519 QString id = settings.value("id").toString();
520
521 for (GSList *entry = dec_list; entry; entry = entry->next) {
522 const srd_decoder *dec = (srd_decoder*)entry->data;
523 if (!dec)
524 continue;
525
526 if (QString::fromUtf8(dec->id) == id) {
527 shared_ptr<decode::Decoder> decoder =
528 make_shared<decode::Decoder>(dec);
529
530 stack_.push_back(decoder);
531
532 // Restore decoder options that differ from their default
533 int options = settings.value("options").toInt();
534
535 for (int i = 0; i < options; i++) {
536 settings.beginGroup("option" + QString::number(i));
537 QString name = settings.value("name").toString();
538 GVariant *value = GlobalSettings::restore_gvariant(settings);
539 decoder->set_option(name.toUtf8(), value);
540 settings.endGroup();
541 }
542
543 // Include the newly created decode channels in the channel lists
544 update_channel_list();
545 break;
546 }
547 }
548
549 settings.endGroup();
550 channels_updated();
551 }
552
553 // Restore channel mapping
554 unsigned int channels = settings.value("channels").toInt();
555
556 const unordered_set< shared_ptr<data::SignalBase> > signalbases =
557 session_.signalbases();
558
559 for (unsigned int channel_id = 0; channel_id < channels; channel_id++) {
560 auto channel = find_if(channels_.begin(), channels_.end(),
561 [&](data::DecodeChannel ch) { return ch.id == channel_id; });
562
563 if (channel == channels_.end()) {
564 qDebug() << "ERROR: Non-existant channel index:" << channel_id;
565 continue;
566 }
567
568 settings.beginGroup("channel" + QString::number(channel_id));
569
570 QString assigned_signal_name = settings.value("assigned_signal_name").toString();
571
572 for (shared_ptr<data::SignalBase> signal : signalbases)
573 if (signal->name() == assigned_signal_name)
574 channel->assigned_signal = signal.get();
575
576 channel->initial_pin_state = settings.value("initial_pin_state").toInt();
577
578 settings.endGroup();
579 }
580
581 // Update the internal structures
582 stack_config_changed_ = true;
583 update_channel_list();
584 commit_decoder_channels();
585
586 begin_decode();
587}
588
589void DecodeSignal::set_error_message(QString msg)
590{
591 error_message_ = msg;
592 // TODO Emulate noquote()
593 qDebug().nospace() << name() << ": " << msg;
594}
595
596uint32_t DecodeSignal::get_input_segment_count() const
597{
598 uint64_t count = std::numeric_limits<uint64_t>::max();
599 bool no_signals_assigned = true;
600
601 for (const data::DecodeChannel &ch : channels_)
602 if (ch.assigned_signal) {
603 no_signals_assigned = false;
604
605 const shared_ptr<Logic> logic_data = ch.assigned_signal->logic_data();
606 if (!logic_data || logic_data->logic_segments().empty())
607 return 0;
608
609 // Find the min value of all segment counts
610 if ((uint64_t)(logic_data->logic_segments().size()) < count)
611 count = logic_data->logic_segments().size();
612 }
613
614 return (no_signals_assigned ? 0 : count);
615}
616
617uint32_t DecodeSignal::get_input_samplerate(uint32_t segment_id) const
618{
619 double samplerate = 0;
620
621 for (const data::DecodeChannel &ch : channels_)
622 if (ch.assigned_signal) {
623 const shared_ptr<Logic> logic_data = ch.assigned_signal->logic_data();
624 if (!logic_data || logic_data->logic_segments().empty())
625 continue;
626
627 try {
628 const shared_ptr<LogicSegment> segment = logic_data->logic_segments().at(segment_id);
629 samplerate = segment->samplerate();
630 } catch (out_of_range&) {
631 // Do nothing
632 }
633 break;
634 }
635
636 return samplerate;
637}
638
639void DecodeSignal::update_channel_list()
640{
641 vector<data::DecodeChannel> prev_channels = channels_;
642 channels_.clear();
643
644 uint16_t id = 0;
645
646 // Copy existing entries, create new as needed
647 for (shared_ptr<Decoder> decoder : stack_) {
648 const srd_decoder* srd_d = decoder->decoder();
649 const GSList *l;
650
651 // Mandatory channels
652 for (l = srd_d->channels; l; l = l->next) {
653 const struct srd_channel *const pdch = (struct srd_channel *)l->data;
654 bool ch_added = false;
655
656 // Copy but update ID if this channel was in the list before
657 for (data::DecodeChannel &ch : prev_channels)
658 if (ch.pdch_ == pdch) {
659 ch.id = id++;
660 channels_.push_back(ch);
661 ch_added = true;
662 break;
663 }
664
665 if (!ch_added) {
666 // Create new entry without a mapped signal
667 data::DecodeChannel ch = {id++, 0, false, nullptr,
668 QString::fromUtf8(pdch->name), QString::fromUtf8(pdch->desc),
669 SRD_INITIAL_PIN_SAME_AS_SAMPLE0, decoder, pdch};
670 channels_.push_back(ch);
671 }
672 }
673
674 // Optional channels
675 for (l = srd_d->opt_channels; l; l = l->next) {
676 const struct srd_channel *const pdch = (struct srd_channel *)l->data;
677 bool ch_added = false;
678
679 // Copy but update ID if this channel was in the list before
680 for (data::DecodeChannel &ch : prev_channels)
681 if (ch.pdch_ == pdch) {
682 ch.id = id++;
683 channels_.push_back(ch);
684 ch_added = true;
685 break;
686 }
687
688 if (!ch_added) {
689 // Create new entry without a mapped signal
690 data::DecodeChannel ch = {id++, 0, true, nullptr,
691 QString::fromUtf8(pdch->name), QString::fromUtf8(pdch->desc),
692 SRD_INITIAL_PIN_SAME_AS_SAMPLE0, decoder, pdch};
693 channels_.push_back(ch);
694 }
695 }
696 }
697
698 // Invalidate the logic output data if the channel assignment changed
699 if (prev_channels.size() != channels_.size()) {
700 // The number of channels changed, there's definitely a difference
701 logic_mux_data_invalid_ = true;
702 } else {
703 // Same number but assignment may still differ, so compare all channels
704 for (size_t i = 0; i < channels_.size(); i++) {
705 const data::DecodeChannel &p_ch = prev_channels[i];
706 const data::DecodeChannel &ch = channels_[i];
707
708 if ((p_ch.pdch_ != ch.pdch_) ||
709 (p_ch.assigned_signal != ch.assigned_signal)) {
710 logic_mux_data_invalid_ = true;
711 break;
712 }
713 }
714
715 }
716
717 channels_updated();
718}
719
720void DecodeSignal::commit_decoder_channels()
721{
722 // Submit channel list to every decoder, containing only the relevant channels
723 for (shared_ptr<decode::Decoder> dec : stack_) {
724 vector<data::DecodeChannel*> channel_list;
725
726 for (data::DecodeChannel &ch : channels_)
727 if (ch.decoder_ == dec)
728 channel_list.push_back(&ch);
729
730 dec->set_channels(channel_list);
731 }
732
733 // Channel bit IDs must be in sync with the channel's apperance in channels_
734 int id = 0;
735 for (data::DecodeChannel &ch : channels_)
736 if (ch.assigned_signal)
737 ch.bit_id = id++;
738}
739
740void DecodeSignal::mux_logic_samples(uint32_t segment_id, const int64_t start, const int64_t end)
741{
742 // Enforce end to be greater than start
743 if (end <= start)
744 return;
745
746 // Fetch the channel segments and their data
747 vector<shared_ptr<LogicSegment> > segments;
748 vector<const uint8_t*> signal_data;
749 vector<uint8_t> signal_in_bytepos;
750 vector<uint8_t> signal_in_bitpos;
751
752 for (data::DecodeChannel &ch : channels_)
753 if (ch.assigned_signal) {
754 const shared_ptr<Logic> logic_data = ch.assigned_signal->logic_data();
755
756 shared_ptr<LogicSegment> segment;
757 try {
758 segment = logic_data->logic_segments().at(segment_id);
759 } catch (out_of_range&) {
760 qDebug() << "Muxer error for" << name() << ":" << ch.assigned_signal->name() \
761 << "has no logic segment" << segment_id;
762 return;
763 }
764 segments.push_back(segment);
765
766 uint8_t* data = new uint8_t[(end - start) * segment->unit_size()];
767 segment->get_samples(start, end, data);
768 signal_data.push_back(data);
769
770 const int bitpos = ch.assigned_signal->logic_bit_index();
771 signal_in_bytepos.push_back(bitpos / 8);
772 signal_in_bitpos.push_back(bitpos % 8);
773 }
774
775
776 shared_ptr<LogicSegment> output_segment;
777 try {
778 output_segment = logic_mux_data_->logic_segments().at(segment_id);
779 } catch (out_of_range&) {
780 qDebug() << "Muxer error for" << name() << ": no logic mux segment" \
781 << segment_id << "in mux_logic_samples(), mux segments size is" \
782 << logic_mux_data_->logic_segments().size();
783 return;
784 }
785
786 // Perform the muxing of signal data into the output data
787 uint8_t* output = new uint8_t[(end - start) * output_segment->unit_size()];
788 unsigned int signal_count = signal_data.size();
789
790 for (int64_t sample_cnt = 0; !logic_mux_interrupt_ && (sample_cnt < (end - start));
791 sample_cnt++) {
792
793 int bitpos = 0;
794 uint8_t bytepos = 0;
795
796 const int out_sample_pos = sample_cnt * output_segment->unit_size();
797 for (unsigned int i = 0; i < output_segment->unit_size(); i++)
798 output[out_sample_pos + i] = 0;
799
800 for (unsigned int i = 0; i < signal_count; i++) {
801 const int in_sample_pos = sample_cnt * segments[i]->unit_size();
802 const uint8_t in_sample = 1 &
803 ((signal_data[i][in_sample_pos + signal_in_bytepos[i]]) >> (signal_in_bitpos[i]));
804
805 const uint8_t out_sample = output[out_sample_pos + bytepos];
806
807 output[out_sample_pos + bytepos] = out_sample | (in_sample << bitpos);
808
809 bitpos++;
810 if (bitpos > 7) {
811 bitpos = 0;
812 bytepos++;
813 }
814 }
815 }
816
817 output_segment->append_payload(output, (end - start) * output_segment->unit_size());
818 delete[] output;
819
820 for (const uint8_t* data : signal_data)
821 delete[] data;
822}
823
824void DecodeSignal::logic_mux_proc()
825{
826 uint32_t segment_id = 0;
827
828 assert(logic_mux_data_);
829
830 // Create initial logic mux segment
831 shared_ptr<LogicSegment> output_segment =
832 make_shared<LogicSegment>(*logic_mux_data_, segment_id,
833 logic_mux_unit_size_, 0);
834 logic_mux_data_->push_segment(output_segment);
835
836 output_segment->set_samplerate(get_input_samplerate(0));
837
838 do {
839 const uint64_t input_sample_count = get_working_sample_count(segment_id);
840 const uint64_t output_sample_count = output_segment->get_sample_count();
841
842 const uint64_t samples_to_process =
843 (input_sample_count > output_sample_count) ?
844 (input_sample_count - output_sample_count) : 0;
845
846 // Process the samples if necessary...
847 if (samples_to_process > 0) {
848 const uint64_t unit_size = output_segment->unit_size();
849 const uint64_t chunk_sample_count = DecodeChunkLength / unit_size;
850
851 uint64_t processed_samples = 0;
852 do {
853 const uint64_t start_sample = output_sample_count + processed_samples;
854 const uint64_t sample_count =
855 min(samples_to_process - processed_samples, chunk_sample_count);
856
857 mux_logic_samples(segment_id, start_sample, start_sample + sample_count);
858 processed_samples += sample_count;
859
860 // ...and process the newly muxed logic data
861 decode_input_cond_.notify_one();
862 } while (!logic_mux_interrupt_ && (processed_samples < samples_to_process));
863 }
864
865 if (samples_to_process == 0) {
866 // TODO Optimize this by caching the input segment count and only
867 // querying it when the cached value was reached
868 if (segment_id < get_input_segment_count() - 1) {
869 // Process next segment
870 segment_id++;
871
872 output_segment =
873 make_shared<LogicSegment>(*logic_mux_data_, segment_id,
874 logic_mux_unit_size_, 0);
875 logic_mux_data_->push_segment(output_segment);
876
877 output_segment->set_samplerate(get_input_samplerate(segment_id));
878
879 } else {
880 // All segments have been processed
881 logic_mux_data_invalid_ = false;
882
883 // Wait for more input
884 unique_lock<mutex> logic_mux_lock(logic_mux_mutex_);
885 logic_mux_cond_.wait(logic_mux_lock);
886 }
887 }
888 } while (!logic_mux_interrupt_);
889}
890
891void DecodeSignal::decode_data(
892 const int64_t abs_start_samplenum, const int64_t sample_count,
893 const shared_ptr<LogicSegment> input_segment)
894{
895 const int64_t unit_size = input_segment->unit_size();
896 const int64_t chunk_sample_count = DecodeChunkLength / unit_size;
897
898 for (int64_t i = abs_start_samplenum;
899 !decode_interrupt_ && (i < (abs_start_samplenum + sample_count));
900 i += chunk_sample_count) {
901
902 const int64_t chunk_end = min(i + chunk_sample_count,
903 abs_start_samplenum + sample_count);
904
905 // Report this chunk as already decoded so that annotations don't
906 // appear in an area that we claim to not having been been decoded yet
907 {
908 lock_guard<mutex> lock(output_mutex_);
909 segments_.at(current_segment_id_).samples_decoded = chunk_end;
910 }
911
912 int64_t data_size = (chunk_end - i) * unit_size;
913 uint8_t* chunk = new uint8_t[data_size];
914 input_segment->get_samples(i, chunk_end, chunk);
915
916 if (srd_session_send(srd_session_, i, chunk_end, chunk,
917 data_size, unit_size) != SRD_OK) {
918 set_error_message(tr("Decoder reported an error"));
919 delete[] chunk;
920 break;
921 }
922
923 delete[] chunk;
924
925 // Notify the frontend that we processed some data and
926 // possibly have new annotations as well
927 new_annotations();
928 }
929}
930
931void DecodeSignal::decode_proc()
932{
933 current_segment_id_ = 0;
934
935 // If there is no input data available yet, wait until it is or we're interrupted
936 if (logic_mux_data_->logic_segments().size() == 0) {
937 unique_lock<mutex> input_wait_lock(input_mutex_);
938 decode_input_cond_.wait(input_wait_lock);
939 }
940
941 if (decode_interrupt_)
942 return;
943
944 shared_ptr<LogicSegment> input_segment = logic_mux_data_->logic_segments().front();
945 assert(input_segment);
946
947 // Create the initial segment and set its sample rate so that we can pass it to SRD
948 create_decode_segment();
949 segments_.at(current_segment_id_).samplerate = input_segment->samplerate();
950 segments_.at(current_segment_id_).start_time = input_segment->start_time();
951
952 start_srd_session();
953
954 uint64_t sample_count = 0;
955 uint64_t abs_start_samplenum = 0;
956 do {
957 // Keep processing new samples until we exhaust the input data
958 do {
959 lock_guard<mutex> input_lock(input_mutex_);
960 sample_count = input_segment->get_sample_count() - abs_start_samplenum;
961
962 if (sample_count > 0) {
963 decode_data(abs_start_samplenum, sample_count, input_segment);
964 abs_start_samplenum += sample_count;
965 }
966 } while (error_message_.isEmpty() && (sample_count > 0) && !decode_interrupt_);
967
968 if (error_message_.isEmpty() && !decode_interrupt_ && sample_count == 0) {
969 if (current_segment_id_ < logic_mux_data_->logic_segments().size() - 1) {
970 // Process next segment
971 current_segment_id_++;
972
973 try {
974 input_segment = logic_mux_data_->logic_segments().at(current_segment_id_);
975 } catch (out_of_range&) {
976 qDebug() << "Decode error for" << name() << ": no logic mux segment" \
977 << current_segment_id_ << "in decode_proc(), mux segments size is" \
978 << logic_mux_data_->logic_segments().size();
979 return;
980 }
981 abs_start_samplenum = 0;
982
983 // Create the next segment and set its metadata
984 create_decode_segment();
985 segments_.at(current_segment_id_).samplerate = input_segment->samplerate();
986 segments_.at(current_segment_id_).start_time = input_segment->start_time();
987
988 // Reset decoder state but keep the decoder stack intact
989 terminate_srd_session();
990 } else {
991 // All segments have been processed
992 decode_finished();
993
994 // Wait for new input data or an interrupt was requested
995 unique_lock<mutex> input_wait_lock(input_mutex_);
996 decode_input_cond_.wait(input_wait_lock);
997 }
998 }
999 } while (error_message_.isEmpty() && !decode_interrupt_);
1000
1001 // Potentially reap decoders when the application no longer is
1002 // interested in their (pending) results.
1003 if (decode_interrupt_)
1004 terminate_srd_session();
1005}
1006
1007void DecodeSignal::start_srd_session()
1008{
1009 uint64_t samplerate;
1010
1011 // If there were stack changes, the session has been destroyed by now, so if
1012 // it hasn't been destroyed, we can just reset and re-use it
1013 if (srd_session_) {
1014 // When a decoder stack was created before, re-use it
1015 // for the next stream of input data, after terminating
1016 // potentially still executing operations, and resetting
1017 // internal state. Skip the rather expensive (teardown
1018 // and) construction of another decoder stack.
1019
1020 // TODO Reduce redundancy, use a common code path for
1021 // the meta/cb/start sequence?
1022 terminate_srd_session();
1023 srd_session_metadata_set(srd_session_, SRD_CONF_SAMPLERATE,
1024 g_variant_new_uint64(segments_.at(current_segment_id_).samplerate));
1025 srd_pd_output_callback_add(srd_session_, SRD_OUTPUT_ANN,
1026 DecodeSignal::annotation_callback, this);
1027 srd_session_start(srd_session_);
1028 return;
1029 }
1030
1031 // Create the session
1032 srd_session_new(&srd_session_);
1033 assert(srd_session_);
1034
1035 // Create the decoders
1036 srd_decoder_inst *prev_di = nullptr;
1037 for (const shared_ptr<decode::Decoder> &dec : stack_) {
1038 srd_decoder_inst *const di = dec->create_decoder_inst(srd_session_);
1039
1040 if (!di) {
1041 set_error_message(tr("Failed to create decoder instance"));
1042 srd_session_destroy(srd_session_);
1043 srd_session_ = nullptr;
1044 return;
1045 }
1046
1047 if (prev_di)
1048 srd_inst_stack(srd_session_, prev_di, di);
1049
1050 prev_di = di;
1051 }
1052
1053 // Start the session
1054 samplerate = segments_.at(current_segment_id_).samplerate;
1055 if (samplerate)
1056 srd_session_metadata_set(srd_session_, SRD_CONF_SAMPLERATE,
1057 g_variant_new_uint64(samplerate));
1058
1059 srd_pd_output_callback_add(srd_session_, SRD_OUTPUT_ANN,
1060 DecodeSignal::annotation_callback, this);
1061
1062 srd_session_start(srd_session_);
1063
1064 // We just recreated the srd session, so all stack changes are applied now
1065 stack_config_changed_ = false;
1066}
1067
1068void DecodeSignal::terminate_srd_session()
1069{
1070 // Call the "terminate and reset" routine for the decoder stack
1071 // (if available). This does not harm those stacks which already
1072 // have completed their operation, and reduces response time for
1073 // those stacks which still are processing data while the
1074 // application no longer wants them to.
1075 if (srd_session_)
1076 srd_session_terminate_reset(srd_session_);
1077}
1078
1079void DecodeSignal::stop_srd_session()
1080{
1081 if (srd_session_) {
1082 // Destroy the session
1083 srd_session_destroy(srd_session_);
1084 srd_session_ = nullptr;
1085
1086 // Mark the decoder instances as non-existant since they were deleted
1087 for (const shared_ptr<decode::Decoder> &dec : stack_)
1088 dec->invalidate_decoder_inst();
1089 }
1090}
1091
1092void DecodeSignal::connect_input_notifiers()
1093{
1094 // Disconnect the notification slot from the previous set of signals
1095 disconnect(this, SLOT(on_data_cleared()));
1096 disconnect(this, SLOT(on_data_received()));
1097
1098 // Connect the currently used signals to our slot
1099 for (data::DecodeChannel &ch : channels_) {
1100 if (!ch.assigned_signal)
1101 continue;
1102
1103 const data::SignalBase *signal = ch.assigned_signal;
1104 connect(signal, SIGNAL(samples_cleared()),
1105 this, SLOT(on_data_cleared()));
1106 connect(signal, SIGNAL(samples_added(uint64_t, uint64_t, uint64_t)),
1107 this, SLOT(on_data_received()));
1108 }
1109}
1110
1111void DecodeSignal::create_decode_segment()
1112{
1113 // Create annotation segment
1114 segments_.emplace_back(DecodeSegment());
1115
1116 // Add annotation classes
1117 for (const shared_ptr<decode::Decoder> &dec : stack_) {
1118 assert(dec);
1119 const srd_decoder *const decc = dec->decoder();
1120 assert(dec->decoder());
1121
1122 // Add a row for the decoder if it doesn't have a row list
1123 if (!decc->annotation_rows)
1124 (segments_.back().annotation_rows)[Row(decc)] =
1125 decode::RowData();
1126
1127 // Add the decoder rows
1128 for (const GSList *l = decc->annotation_rows; l; l = l->next) {
1129 const srd_decoder_annotation_row *const ann_row =
1130 (srd_decoder_annotation_row *)l->data;
1131 assert(ann_row);
1132
1133 const Row row(decc, ann_row);
1134
1135 // Add a new empty row data object
1136 (segments_.back().annotation_rows)[row] =
1137 decode::RowData();
1138 }
1139 }
1140}
1141
1142void DecodeSignal::annotation_callback(srd_proto_data *pdata, void *decode_signal)
1143{
1144 assert(pdata);
1145 assert(decode_signal);
1146
1147 DecodeSignal *const ds = (DecodeSignal*)decode_signal;
1148 assert(ds);
1149
1150 if (ds->decode_interrupt_)
1151 return;
1152
1153 lock_guard<mutex> lock(ds->output_mutex_);
1154
1155 // Find the row
1156 assert(pdata->pdo);
1157 assert(pdata->pdo->di);
1158 const srd_decoder *const decc = pdata->pdo->di->decoder;
1159 assert(decc);
1160
1161 const srd_proto_data_annotation *const pda =
1162 (const srd_proto_data_annotation*)pdata->data;
1163 assert(pda);
1164
1165 auto row_iter = ds->segments_.at(ds->current_segment_id_).annotation_rows.end();
1166
1167 // Try looking up the sub-row of this class
1168 const auto format = pda->ann_class;
1169 const auto r = ds->class_rows_.find(make_pair(decc, format));
1170 if (r != ds->class_rows_.end())
1171 row_iter = ds->segments_.at(ds->current_segment_id_).annotation_rows.find((*r).second);
1172 else {
1173 // Failing that, use the decoder as a key
1174 row_iter = ds->segments_.at(ds->current_segment_id_).annotation_rows.find(Row(decc));
1175 }
1176
1177 if (row_iter == ds->segments_.at(ds->current_segment_id_).annotation_rows.end()) {
1178 qDebug() << "Unexpected annotation: decoder = " << decc <<
1179 ", format = " << format;
1180 assert(false);
1181 return;
1182 }
1183
1184 // Add the annotation
1185 (*row_iter).second.emplace_annotation(pdata);
1186}
1187
1188void DecodeSignal::on_capture_state_changed(int state)
1189{
1190 // If a new acquisition was started, we need to start decoding from scratch
1191 if (state == Session::Running) {
1192 logic_mux_data_invalid_ = true;
1193 begin_decode();
1194 }
1195}
1196
1197void DecodeSignal::on_data_cleared()
1198{
1199 reset_decode();
1200}
1201
1202void DecodeSignal::on_data_received()
1203{
1204 // If we detected a lack of input data when trying to start decoding,
1205 // we have set an error message. Only try again if we now have data
1206 // to work with
1207 if ((!error_message_.isEmpty()) && (get_input_segment_count() == 0))
1208 return;
1209
1210 if (!logic_mux_thread_.joinable())
1211 begin_decode();
1212 else
1213 logic_mux_cond_.notify_one();
1214}
1215
1216} // namespace data
1217} // namespace pv