2 * This file is part of the PulseView project.
4 * Copyright (C) 2017 Soeren Apel <soeren@apelpie.net>
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.
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/>.
21 #include <forward_list>
27 #include "logicsegment.hpp"
28 #include "decodesignal.hpp"
29 #include "signaldata.hpp"
31 #include <pv/data/decode/decoder.hpp>
32 #include <pv/data/decode/row.hpp>
33 #include <pv/globalsettings.hpp>
34 #include <pv/session.hpp>
36 using std::lock_guard;
37 using std::make_shared;
39 using std::out_of_range;
40 using std::shared_ptr;
41 using std::unique_lock;
42 using pv::data::decode::AnnotationClass;
43 using pv::data::decode::DecodeChannel;
48 const double DecodeSignal::DecodeMargin = 1.0;
49 const double DecodeSignal::DecodeThreshold = 0.2;
50 const int64_t DecodeSignal::DecodeChunkLength = 256 * 1024;
53 DecodeSignal::DecodeSignal(pv::Session &session) :
54 SignalBase(nullptr, SignalBase::DecodeChannel),
56 srd_session_(nullptr),
57 logic_mux_data_invalid_(false),
58 stack_config_changed_(true),
59 current_segment_id_(0)
61 connect(&session_, SIGNAL(capture_state_changed(int)),
62 this, SLOT(on_capture_state_changed(int)));
65 DecodeSignal::~DecodeSignal()
70 const vector< shared_ptr<Decoder> >& DecodeSignal::decoder_stack() const
75 void DecodeSignal::stack_decoder(const srd_decoder *decoder, bool restart_decode)
79 // Set name if this decoder is the first in the list or the name is unchanged
80 const srd_decoder* prev_dec = stack_.empty() ? nullptr : stack_.back()->get_srd_decoder();
81 const QString prev_dec_name = prev_dec ? QString::fromUtf8(prev_dec->name) : QString();
83 if ((stack_.empty()) || ((stack_.size() > 0) && (name() == prev_dec_name)))
84 set_name(QString::fromUtf8(decoder->name));
86 const shared_ptr<Decoder> dec = make_shared<Decoder>(decoder, stack_.size());
87 stack_.push_back(dec);
89 connect(dec.get(), SIGNAL(annotation_visibility_changed()),
90 this, SLOT(on_annotation_visibility_changed()));
92 // Include the newly created decode channels in the channel lists
93 update_channel_list();
95 stack_config_changed_ = true;
96 auto_assign_signals(dec);
97 commit_decoder_channels();
99 decoder_stacked((void*)dec.get());
105 void DecodeSignal::remove_decoder(int index)
108 assert(index < (int)stack_.size());
110 // Find the decoder in the stack
111 auto iter = stack_.begin() + index;
112 assert(iter != stack_.end());
114 shared_ptr<Decoder> dec = *iter;
116 decoder_removed(dec.get());
118 // Delete the element
121 // Update channels and decoded data
122 stack_config_changed_ = true;
123 update_channel_list();
127 bool DecodeSignal::toggle_decoder_visibility(int index)
129 auto iter = stack_.cbegin();
130 for (int i = 0; i < index; i++, iter++)
131 assert(iter != stack_.end());
133 shared_ptr<Decoder> dec = *iter;
135 // Toggle decoder visibility
138 state = !dec->visible();
139 dec->set_visible(state);
145 void DecodeSignal::reset_decode(bool shutting_down)
147 resume_decode(); // Make sure the decode thread isn't blocked by pausing
149 if (stack_config_changed_ || shutting_down)
152 terminate_srd_session();
154 if (decode_thread_.joinable()) {
155 decode_interrupt_ = true;
156 decode_input_cond_.notify_one();
157 decode_thread_.join();
160 if (logic_mux_thread_.joinable()) {
161 logic_mux_interrupt_ = true;
162 logic_mux_cond_.notify_one();
163 logic_mux_thread_.join();
166 current_segment_id_ = 0;
169 logic_mux_data_.reset();
170 logic_mux_data_invalid_ = true;
172 if (!error_message_.isEmpty()) {
173 error_message_.clear();
174 // TODO Emulate noquote()
175 qDebug().nospace() << name() << ": Error cleared";
181 void DecodeSignal::begin_decode()
183 if (decode_thread_.joinable()) {
184 decode_interrupt_ = true;
185 decode_input_cond_.notify_one();
186 decode_thread_.join();
189 if (logic_mux_thread_.joinable()) {
190 logic_mux_interrupt_ = true;
191 logic_mux_cond_.notify_one();
192 logic_mux_thread_.join();
197 if (stack_.size() == 0) {
198 set_error_message(tr("No decoders"));
202 assert(channels_.size() > 0);
204 if (get_assigned_signal_count() == 0) {
205 set_error_message(tr("There are no channels assigned to this decoder"));
209 // Make sure that all assigned channels still provide logic data
210 // (can happen when a converted signal was assigned but the
211 // conversion removed in the meanwhile)
212 for (decode::DecodeChannel& ch : channels_)
213 if (ch.assigned_signal && !(ch.assigned_signal->logic_data() != nullptr))
214 ch.assigned_signal = nullptr;
216 // Check that all decoders have the required channels
217 for (const shared_ptr<Decoder>& dec : stack_)
218 if (!dec->have_required_channels()) {
219 set_error_message(tr("One or more required channels "
220 "have not been specified"));
224 // Free the logic data and its segment(s) if it needs to be updated
225 if (logic_mux_data_invalid_)
226 logic_mux_data_.reset();
228 if (!logic_mux_data_) {
229 const uint32_t ch_count = get_assigned_signal_count();
230 logic_mux_unit_size_ = (ch_count + 7) / 8;
231 logic_mux_data_ = make_shared<Logic>(ch_count);
234 if (get_input_segment_count() == 0)
235 set_error_message(tr("No input data"));
237 // Make sure the logic output data is complete and up-to-date
238 logic_mux_interrupt_ = false;
239 logic_mux_thread_ = std::thread(&DecodeSignal::logic_mux_proc, this);
241 // Decode the muxed logic data
242 decode_interrupt_ = false;
243 decode_thread_ = std::thread(&DecodeSignal::decode_proc, this);
246 void DecodeSignal::pause_decode()
248 decode_paused_ = true;
251 void DecodeSignal::resume_decode()
253 // Manual unlocking is done before notifying, to avoid waking up the
254 // waiting thread only to block again (see notify_one for details)
255 decode_pause_mutex_.unlock();
256 decode_pause_cond_.notify_one();
257 decode_paused_ = false;
260 bool DecodeSignal::is_paused() const
262 return decode_paused_;
265 const vector<decode::DecodeChannel> DecodeSignal::get_channels() const
270 void DecodeSignal::auto_assign_signals(const shared_ptr<Decoder> dec)
272 bool new_assignment = false;
274 // Disconnect all input signal notifications so we don't have duplicate connections
275 disconnect_input_notifiers();
277 // Try to auto-select channels that don't have signals assigned yet
278 for (decode::DecodeChannel& ch : channels_) {
279 // If a decoder is given, auto-assign only its channels
280 if (dec && (ch.decoder_ != dec))
283 if (ch.assigned_signal)
286 QString ch_name = ch.name.toLower();
287 ch_name = ch_name.replace(QRegExp("[-_.]"), " ");
289 shared_ptr<data::SignalBase> match;
290 for (const shared_ptr<data::SignalBase>& s : session_.signalbases()) {
294 QString s_name = s->name().toLower();
295 s_name = s_name.replace(QRegExp("[-_.]"), " ");
297 if (s->logic_data() &&
298 ((ch_name.contains(s_name)) || (s_name.contains(ch_name)))) {
302 // Only replace an existing match if it matches more characters
303 int old_unmatched = ch_name.length() - match->name().length();
304 int new_unmatched = ch_name.length() - s->name().length();
305 if (abs(new_unmatched) < abs(old_unmatched))
311 // Prevent using a signal more than once as D1 would match e.g. D1 and D10
312 bool signal_not_already_used = true;
313 for (decode::DecodeChannel& ch : channels_)
314 if (ch.assigned_signal && (ch.assigned_signal == match))
315 signal_not_already_used = false;
317 if (match && signal_not_already_used) {
318 ch.assigned_signal = match;
319 new_assignment = true;
323 if (new_assignment) {
324 // Receive notifications when new sample data is available
325 connect_input_notifiers();
327 logic_mux_data_invalid_ = true;
328 stack_config_changed_ = true;
329 commit_decoder_channels();
334 void DecodeSignal::assign_signal(const uint16_t channel_id, shared_ptr<const SignalBase> signal)
336 // Disconnect all input signal notifications so we don't have duplicate connections
337 disconnect_input_notifiers();
339 for (decode::DecodeChannel& ch : channels_)
340 if (ch.id == channel_id) {
341 ch.assigned_signal = signal;
342 logic_mux_data_invalid_ = true;
345 // Receive notifications when new sample data is available
346 connect_input_notifiers();
348 stack_config_changed_ = true;
349 commit_decoder_channels();
354 int DecodeSignal::get_assigned_signal_count() const
356 // Count all channels that have a signal assigned to them
357 return count_if(channels_.begin(), channels_.end(),
358 [](decode::DecodeChannel ch) { return ch.assigned_signal.get(); });
361 void DecodeSignal::set_initial_pin_state(const uint16_t channel_id, const int init_state)
363 for (decode::DecodeChannel& ch : channels_)
364 if (ch.id == channel_id)
365 ch.initial_pin_state = init_state;
367 stack_config_changed_ = true;
372 double DecodeSignal::get_samplerate() const
376 // TODO For now, we simply return the first samplerate that we have
377 if (segments_.size() > 0)
378 result = segments_.front().samplerate;
383 const pv::util::Timestamp DecodeSignal::start_time() const
385 pv::util::Timestamp result;
387 // TODO For now, we simply return the first start time that we have
388 if (segments_.size() > 0)
389 result = segments_.front().start_time;
394 int64_t DecodeSignal::get_working_sample_count(uint32_t segment_id) const
396 // The working sample count is the highest sample number for
397 // which all used signals have data available, so go through all
398 // channels and use the lowest overall sample count of the segment
400 int64_t count = std::numeric_limits<int64_t>::max();
401 bool no_signals_assigned = true;
403 for (const decode::DecodeChannel& ch : channels_)
404 if (ch.assigned_signal) {
405 if (!ch.assigned_signal->logic_data())
408 no_signals_assigned = false;
410 const shared_ptr<Logic> logic_data = ch.assigned_signal->logic_data();
411 if (logic_data->logic_segments().empty())
414 if (segment_id >= logic_data->logic_segments().size())
417 const shared_ptr<const LogicSegment> segment = logic_data->logic_segments()[segment_id]->get_shared_ptr();
419 count = min(count, (int64_t)segment->get_sample_count());
422 return (no_signals_assigned ? 0 : count);
425 int64_t DecodeSignal::get_decoded_sample_count(uint32_t segment_id,
426 bool include_processing) const
428 lock_guard<mutex> decode_lock(output_mutex_);
432 if (segment_id >= segments_.size())
435 if (include_processing)
436 result = segments_[segment_id].samples_decoded_incl;
438 result = segments_[segment_id].samples_decoded_excl;
443 vector<Row*> DecodeSignal::get_rows(bool visible_only)
447 for (const shared_ptr<Decoder>& dec : stack_) {
449 if (visible_only && !dec->visible())
452 for (Row* row : dec->get_rows())
459 vector<const Row*> DecodeSignal::get_rows(bool visible_only) const
461 vector<const Row*> rows;
463 for (const shared_ptr<Decoder>& dec : stack_) {
465 if (visible_only && !dec->visible())
468 for (const Row* row : dec->get_rows())
475 uint64_t DecodeSignal::get_annotation_count(const Row* row, uint32_t segment_id) const
477 if (segment_id >= segments_.size())
480 const DecodeSegment* segment = &(segments_.at(segment_id));
482 auto row_it = segment->annotation_rows.find(row);
485 if (row_it == segment->annotation_rows.end())
488 rd = &(row_it->second);
490 return rd->get_annotation_count();
493 void DecodeSignal::get_annotation_subset(deque<const Annotation*> &dest,
494 const Row* row, uint32_t segment_id, uint64_t start_sample,
495 uint64_t end_sample) const
497 lock_guard<mutex> lock(output_mutex_);
499 if (segment_id >= segments_.size())
502 const DecodeSegment* segment = &(segments_.at(segment_id));
504 auto row_it = segment->annotation_rows.find(row);
507 if (row_it == segment->annotation_rows.end())
510 rd = &(row_it->second);
512 rd->get_annotation_subset(dest, start_sample, end_sample);
515 void DecodeSignal::get_annotation_subset(deque<const Annotation*> &dest,
516 uint32_t segment_id, uint64_t start_sample, uint64_t end_sample) const
518 for (const Row* row : get_rows())
519 get_annotation_subset(dest, row, segment_id, start_sample, end_sample);
522 uint32_t DecodeSignal::get_binary_data_chunk_count(uint32_t segment_id,
523 const Decoder* dec, uint32_t bin_class_id) const
525 if ((segments_.size() == 0) || (segment_id >= segments_.size()))
528 const DecodeSegment *segment = &(segments_[segment_id]);
530 for (const DecodeBinaryClass& bc : segment->binary_classes)
531 if ((bc.decoder == dec) && (bc.info->bin_class_id == bin_class_id))
532 return bc.chunks.size();
537 void DecodeSignal::get_binary_data_chunk(uint32_t segment_id,
538 const Decoder* dec, uint32_t bin_class_id, uint32_t chunk_id,
539 const vector<uint8_t> **dest, uint64_t *size)
541 if (segment_id >= segments_.size())
544 const DecodeSegment *segment = &(segments_[segment_id]);
546 for (const DecodeBinaryClass& bc : segment->binary_classes)
547 if ((bc.decoder == dec) && (bc.info->bin_class_id == bin_class_id)) {
548 if (dest) *dest = &(bc.chunks.at(chunk_id).data);
549 if (size) *size = bc.chunks.at(chunk_id).data.size();
554 void DecodeSignal::get_merged_binary_data_chunks_by_sample(uint32_t segment_id,
555 const Decoder* dec, uint32_t bin_class_id, uint64_t start_sample,
556 uint64_t end_sample, vector<uint8_t> *dest) const
558 assert(dest != nullptr);
560 if (segment_id >= segments_.size())
563 const DecodeSegment *segment = &(segments_[segment_id]);
565 const DecodeBinaryClass* bin_class = nullptr;
566 for (const DecodeBinaryClass& bc : segment->binary_classes)
567 if ((bc.decoder == dec) && (bc.info->bin_class_id == bin_class_id))
570 // Determine overall size before copying to resize dest vector only once
572 uint64_t matches = 0;
573 for (const DecodeBinaryDataChunk& chunk : bin_class->chunks)
574 if ((chunk.sample >= start_sample) && (chunk.sample < end_sample)) {
575 size += chunk.data.size();
581 uint64_t matches2 = 0;
582 for (const DecodeBinaryDataChunk& chunk : bin_class->chunks)
583 if ((chunk.sample >= start_sample) && (chunk.sample < end_sample)) {
584 memcpy(dest->data() + offset, chunk.data.data(), chunk.data.size());
585 offset += chunk.data.size();
588 // Make sure we don't overwrite memory if the array grew in the meanwhile
589 if (matches2 == matches)
594 void DecodeSignal::get_merged_binary_data_chunks_by_offset(uint32_t segment_id,
595 const Decoder* dec, uint32_t bin_class_id, uint64_t start, uint64_t end,
596 vector<uint8_t> *dest) const
598 assert(dest != nullptr);
600 if (segment_id >= segments_.size())
603 const DecodeSegment *segment = &(segments_[segment_id]);
605 const DecodeBinaryClass* bin_class = nullptr;
606 for (const DecodeBinaryClass& bc : segment->binary_classes)
607 if ((bc.decoder == dec) && (bc.info->bin_class_id == bin_class_id))
610 // Determine overall size before copying to resize dest vector only once
613 for (const DecodeBinaryDataChunk& chunk : bin_class->chunks) {
615 size += chunk.data.size();
616 offset += chunk.data.size();
623 uint64_t dest_offset = 0;
624 for (const DecodeBinaryDataChunk& chunk : bin_class->chunks) {
625 if (offset >= start) {
626 memcpy(dest->data() + dest_offset, chunk.data.data(), chunk.data.size());
627 dest_offset += chunk.data.size();
629 offset += chunk.data.size();
635 const DecodeBinaryClass* DecodeSignal::get_binary_data_class(uint32_t segment_id,
636 const Decoder* dec, uint32_t bin_class_id) const
638 if (segment_id >= segments_.size())
641 const DecodeSegment *segment = &(segments_[segment_id]);
643 for (const DecodeBinaryClass& bc : segment->binary_classes)
644 if ((bc.decoder == dec) && (bc.info->bin_class_id == bin_class_id))
650 const deque<const Annotation*>* DecodeSignal::get_all_annotations_by_segment(
651 uint32_t segment_id) const
653 if (segment_id >= segments_.size())
656 const DecodeSegment *segment = &(segments_[segment_id]);
658 return &(segment->all_annotations);
661 void DecodeSignal::save_settings(QSettings &settings) const
663 SignalBase::save_settings(settings);
665 settings.setValue("decoders", (int)(stack_.size()));
667 // Save decoder stack
669 for (const shared_ptr<Decoder>& decoder : stack_) {
670 settings.beginGroup("decoder" + QString::number(decoder_idx++));
672 settings.setValue("id", decoder->get_srd_decoder()->id);
673 settings.setValue("visible", decoder->visible());
675 // Save decoder options
676 const map<string, GVariant*>& options = decoder->options();
678 settings.setValue("options", (int)options.size());
680 // Note: Decoder::options() returns only the options
681 // that differ from the default. See binding::Decoder::getter()
683 for (auto& option : options) {
684 settings.beginGroup("option" + QString::number(i));
685 settings.setValue("name", QString::fromStdString(option.first));
686 GlobalSettings::store_gvariant(settings, option.second);
691 // Save row properties
693 for (const Row* row : decoder->get_rows()) {
694 settings.beginGroup("row" + QString::number(i));
695 settings.setValue("visible", row->visible());
700 // Save class properties
702 for (const AnnotationClass* ann_class : decoder->ann_classes()) {
703 settings.beginGroup("ann_class" + QString::number(i));
704 settings.setValue("visible", ann_class->visible());
712 // Save channel mapping
713 settings.setValue("channels", (int)channels_.size());
715 for (unsigned int channel_id = 0; channel_id < channels_.size(); channel_id++) {
716 auto channel = find_if(channels_.begin(), channels_.end(),
717 [&](decode::DecodeChannel ch) { return ch.id == channel_id; });
719 if (channel == channels_.end()) {
720 qDebug() << "ERROR: Gap in channel index:" << channel_id;
724 settings.beginGroup("channel" + QString::number(channel_id));
726 settings.setValue("name", channel->name); // Useful for debugging
727 settings.setValue("initial_pin_state", channel->initial_pin_state);
729 if (channel->assigned_signal)
730 settings.setValue("assigned_signal_name", channel->assigned_signal->name());
736 void DecodeSignal::restore_settings(QSettings &settings)
738 SignalBase::restore_settings(settings);
740 // Restore decoder stack
741 GSList *dec_list = g_slist_copy((GSList*)srd_decoder_list());
743 int decoders = settings.value("decoders").toInt();
745 for (int decoder_idx = 0; decoder_idx < decoders; decoder_idx++) {
746 settings.beginGroup("decoder" + QString::number(decoder_idx));
748 QString id = settings.value("id").toString();
750 for (GSList *entry = dec_list; entry; entry = entry->next) {
751 const srd_decoder *dec = (srd_decoder*)entry->data;
755 if (QString::fromUtf8(dec->id) == id) {
756 shared_ptr<Decoder> decoder = make_shared<Decoder>(dec, stack_.size());
758 connect(decoder.get(), SIGNAL(annotation_visibility_changed()),
759 this, SLOT(on_annotation_visibility_changed()));
761 stack_.push_back(decoder);
762 decoder->set_visible(settings.value("visible", true).toBool());
764 // Restore decoder options that differ from their default
765 int options = settings.value("options").toInt();
767 for (int i = 0; i < options; i++) {
768 settings.beginGroup("option" + QString::number(i));
769 QString name = settings.value("name").toString();
770 GVariant *value = GlobalSettings::restore_gvariant(settings);
771 decoder->set_option(name.toUtf8(), value);
775 // Include the newly created decode channels in the channel lists
776 update_channel_list();
778 // Restore row properties
780 for (Row* row : decoder->get_rows()) {
781 settings.beginGroup("row" + QString::number(i));
782 row->set_visible(settings.value("visible", true).toBool());
787 // Restore class properties
789 for (AnnotationClass* ann_class : decoder->ann_classes()) {
790 settings.beginGroup("ann_class" + QString::number(i));
791 ann_class->set_visible(settings.value("visible", true).toBool());
804 // Restore channel mapping
805 unsigned int channels = settings.value("channels").toInt();
807 const vector< shared_ptr<data::SignalBase> > signalbases =
808 session_.signalbases();
810 for (unsigned int channel_id = 0; channel_id < channels; channel_id++) {
811 auto channel = find_if(channels_.begin(), channels_.end(),
812 [&](decode::DecodeChannel ch) { return ch.id == channel_id; });
814 if (channel == channels_.end()) {
815 qDebug() << "ERROR: Non-existant channel index:" << channel_id;
819 settings.beginGroup("channel" + QString::number(channel_id));
821 QString assigned_signal_name = settings.value("assigned_signal_name").toString();
823 for (const shared_ptr<data::SignalBase>& signal : signalbases)
824 if ((signal->name() == assigned_signal_name) && (signal->type() != SignalBase::DecodeChannel))
825 channel->assigned_signal = signal;
827 channel->initial_pin_state = settings.value("initial_pin_state").toInt();
832 connect_input_notifiers();
834 // Update the internal structures
835 stack_config_changed_ = true;
836 update_channel_list();
837 commit_decoder_channels();
842 bool DecodeSignal::all_input_segments_complete(uint32_t segment_id) const
844 bool all_complete = true;
846 for (const decode::DecodeChannel& ch : channels_)
847 if (ch.assigned_signal) {
848 if (!ch.assigned_signal->logic_data())
851 const shared_ptr<Logic> logic_data = ch.assigned_signal->logic_data();
852 if (logic_data->logic_segments().empty())
855 if (segment_id >= logic_data->logic_segments().size())
858 const shared_ptr<const LogicSegment> segment = logic_data->logic_segments()[segment_id]->get_shared_ptr();
859 if (segment && !segment->is_complete())
860 all_complete = false;
866 uint32_t DecodeSignal::get_input_segment_count() const
868 uint64_t count = std::numeric_limits<uint64_t>::max();
869 bool no_signals_assigned = true;
871 for (const decode::DecodeChannel& ch : channels_)
872 if (ch.assigned_signal) {
873 no_signals_assigned = false;
875 const shared_ptr<Logic> logic_data = ch.assigned_signal->logic_data();
876 if (!logic_data || logic_data->logic_segments().empty())
879 // Find the min value of all segment counts
880 if ((uint64_t)(logic_data->logic_segments().size()) < count)
881 count = logic_data->logic_segments().size();
884 return (no_signals_assigned ? 0 : count);
887 double DecodeSignal::get_input_samplerate(uint32_t segment_id) const
889 double samplerate = 0;
891 for (const decode::DecodeChannel& ch : channels_)
892 if (ch.assigned_signal) {
893 const shared_ptr<Logic> logic_data = ch.assigned_signal->logic_data();
894 if (!logic_data || logic_data->logic_segments().empty())
898 const shared_ptr<const LogicSegment> segment =
899 logic_data->logic_segments().at(segment_id)->get_shared_ptr();
901 samplerate = segment->samplerate();
902 } catch (out_of_range&) {
911 Decoder* DecodeSignal::get_decoder_by_instance(const srd_decoder *const srd_dec)
913 for (shared_ptr<Decoder>& d : stack_)
914 if (d->get_srd_decoder() == srd_dec)
920 void DecodeSignal::update_channel_list()
922 vector<decode::DecodeChannel> prev_channels = channels_;
927 // Copy existing entries, create new as needed
928 for (shared_ptr<Decoder>& decoder : stack_) {
929 const srd_decoder* srd_dec = decoder->get_srd_decoder();
932 // Mandatory channels
933 for (l = srd_dec->channels; l; l = l->next) {
934 const struct srd_channel *const pdch = (struct srd_channel *)l->data;
935 bool ch_added = false;
937 // Copy but update ID if this channel was in the list before
938 for (decode::DecodeChannel& ch : prev_channels)
939 if (ch.pdch_ == pdch) {
941 channels_.push_back(ch);
947 // Create new entry without a mapped signal
948 decode::DecodeChannel ch = {id++, 0, false, nullptr,
949 QString::fromUtf8(pdch->name), QString::fromUtf8(pdch->desc),
950 SRD_INITIAL_PIN_SAME_AS_SAMPLE0, decoder, pdch};
951 channels_.push_back(ch);
956 for (l = srd_dec->opt_channels; l; l = l->next) {
957 const struct srd_channel *const pdch = (struct srd_channel *)l->data;
958 bool ch_added = false;
960 // Copy but update ID if this channel was in the list before
961 for (decode::DecodeChannel& ch : prev_channels)
962 if (ch.pdch_ == pdch) {
964 channels_.push_back(ch);
970 // Create new entry without a mapped signal
971 decode::DecodeChannel ch = {id++, 0, true, nullptr,
972 QString::fromUtf8(pdch->name), QString::fromUtf8(pdch->desc),
973 SRD_INITIAL_PIN_SAME_AS_SAMPLE0, decoder, pdch};
974 channels_.push_back(ch);
979 // Invalidate the logic output data if the channel assignment changed
980 if (prev_channels.size() != channels_.size()) {
981 // The number of channels changed, there's definitely a difference
982 logic_mux_data_invalid_ = true;
984 // Same number but assignment may still differ, so compare all channels
985 for (size_t i = 0; i < channels_.size(); i++) {
986 const decode::DecodeChannel& p_ch = prev_channels[i];
987 const decode::DecodeChannel& ch = channels_[i];
989 if ((p_ch.pdch_ != ch.pdch_) ||
990 (p_ch.assigned_signal != ch.assigned_signal)) {
991 logic_mux_data_invalid_ = true;
1001 void DecodeSignal::commit_decoder_channels()
1003 // Submit channel list to every decoder, containing only the relevant channels
1004 for (shared_ptr<Decoder> dec : stack_) {
1005 vector<decode::DecodeChannel*> channel_list;
1007 for (decode::DecodeChannel& ch : channels_)
1008 if (ch.decoder_ == dec)
1009 channel_list.push_back(&ch);
1011 dec->set_channels(channel_list);
1014 // Channel bit IDs must be in sync with the channel's apperance in channels_
1016 for (decode::DecodeChannel& ch : channels_)
1017 if (ch.assigned_signal)
1021 void DecodeSignal::mux_logic_samples(uint32_t segment_id, const int64_t start, const int64_t end)
1023 // Enforce end to be greater than start
1027 // Fetch the channel segments and their data
1028 vector<shared_ptr<const LogicSegment> > segments;
1029 vector<const uint8_t*> signal_data;
1030 vector<uint8_t> signal_in_bytepos;
1031 vector<uint8_t> signal_in_bitpos;
1033 for (decode::DecodeChannel& ch : channels_)
1034 if (ch.assigned_signal) {
1035 const shared_ptr<Logic> logic_data = ch.assigned_signal->logic_data();
1037 shared_ptr<const LogicSegment> segment;
1038 if (segment_id < logic_data->logic_segments().size()) {
1039 segment = logic_data->logic_segments().at(segment_id)->get_shared_ptr();
1041 qDebug() << "Muxer error for" << name() << ":" << ch.assigned_signal->name() \
1042 << "has no logic segment" << segment_id;
1043 logic_mux_interrupt_ = true;
1050 segments.push_back(segment);
1052 uint8_t* data = new uint8_t[(end - start) * segment->unit_size()];
1053 segment->get_samples(start, end, data);
1054 signal_data.push_back(data);
1056 const int bitpos = ch.assigned_signal->logic_bit_index();
1057 signal_in_bytepos.push_back(bitpos / 8);
1058 signal_in_bitpos.push_back(bitpos % 8);
1061 shared_ptr<LogicSegment> output_segment;
1063 output_segment = logic_mux_data_->logic_segments().at(segment_id);
1064 } catch (out_of_range&) {
1065 qDebug() << "Muxer error for" << name() << ": no logic mux segment" \
1066 << segment_id << "in mux_logic_samples(), mux segments size is" \
1067 << logic_mux_data_->logic_segments().size();
1068 logic_mux_interrupt_ = true;
1072 // Perform the muxing of signal data into the output data
1073 uint8_t* output = new uint8_t[(end - start) * output_segment->unit_size()];
1074 unsigned int signal_count = signal_data.size();
1076 for (int64_t sample_cnt = 0; !logic_mux_interrupt_ && (sample_cnt < (end - start));
1080 uint8_t bytepos = 0;
1082 const int out_sample_pos = sample_cnt * output_segment->unit_size();
1083 for (unsigned int i = 0; i < output_segment->unit_size(); i++)
1084 output[out_sample_pos + i] = 0;
1086 for (unsigned int i = 0; i < signal_count; i++) {
1087 const int in_sample_pos = sample_cnt * segments[i]->unit_size();
1088 const uint8_t in_sample = 1 &
1089 ((signal_data[i][in_sample_pos + signal_in_bytepos[i]]) >> (signal_in_bitpos[i]));
1091 const uint8_t out_sample = output[out_sample_pos + bytepos];
1093 output[out_sample_pos + bytepos] = out_sample | (in_sample << bitpos);
1103 output_segment->append_payload(output, (end - start) * output_segment->unit_size());
1106 for (const uint8_t* data : signal_data)
1110 void DecodeSignal::logic_mux_proc()
1112 uint32_t input_segment_count;
1114 input_segment_count = get_input_segment_count();
1115 if (input_segment_count == 0) {
1116 // Wait for input data
1117 unique_lock<mutex> logic_mux_lock(logic_mux_mutex_);
1118 logic_mux_cond_.wait(logic_mux_lock);
1120 } while ((!logic_mux_interrupt_) && (input_segment_count == 0));
1122 if (logic_mux_interrupt_)
1125 assert(logic_mux_data_);
1127 uint32_t segment_id = 0;
1129 // Create initial logic mux segment
1130 shared_ptr<LogicSegment> output_segment =
1131 make_shared<LogicSegment>(*logic_mux_data_, segment_id, logic_mux_unit_size_, 0);
1132 logic_mux_data_->push_segment(output_segment);
1134 output_segment->set_samplerate(get_input_samplerate(0));
1136 // Logic mux data is being updated
1137 logic_mux_data_invalid_ = false;
1139 uint64_t samples_to_process;
1142 const uint64_t input_sample_count = get_working_sample_count(segment_id);
1143 const uint64_t output_sample_count = output_segment->get_sample_count();
1145 samples_to_process =
1146 (input_sample_count > output_sample_count) ?
1147 (input_sample_count - output_sample_count) : 0;
1149 if (samples_to_process > 0) {
1150 const uint64_t unit_size = output_segment->unit_size();
1151 const uint64_t chunk_sample_count = DecodeChunkLength / unit_size;
1153 uint64_t processed_samples = 0;
1155 const uint64_t start_sample = output_sample_count + processed_samples;
1156 const uint64_t sample_count =
1157 min(samples_to_process - processed_samples, chunk_sample_count);
1159 mux_logic_samples(segment_id, start_sample, start_sample + sample_count);
1160 processed_samples += sample_count;
1162 // ...and process the newly muxed logic data
1163 decode_input_cond_.notify_one();
1164 } while (!logic_mux_interrupt_ && (processed_samples < samples_to_process));
1166 } while (!logic_mux_interrupt_ && (samples_to_process > 0));
1168 if (!logic_mux_interrupt_) {
1169 // samples_to_process is now 0, we've exhausted the currently available input data
1171 // If the input segments are complete, we've completed this segment
1172 if (all_input_segments_complete(segment_id)) {
1173 if (!output_segment->is_complete())
1174 output_segment->set_complete();
1176 if (segment_id < get_input_segment_count() - 1) {
1178 // Process next segment
1182 make_shared<LogicSegment>(*logic_mux_data_, segment_id,
1183 logic_mux_unit_size_, 0);
1184 logic_mux_data_->push_segment(output_segment);
1186 output_segment->set_samplerate(get_input_samplerate(segment_id));
1188 // Wait for more input data if we're processing the currently last segment
1189 unique_lock<mutex> logic_mux_lock(logic_mux_mutex_);
1190 logic_mux_cond_.wait(logic_mux_lock);
1193 // Input segments aren't all complete yet but samples_to_process is 0, wait for more input data
1194 unique_lock<mutex> logic_mux_lock(logic_mux_mutex_);
1195 logic_mux_cond_.wait(logic_mux_lock);
1198 } while (!logic_mux_interrupt_);
1201 void DecodeSignal::decode_data(
1202 const int64_t abs_start_samplenum, const int64_t sample_count,
1203 const shared_ptr<const LogicSegment> input_segment)
1205 const int64_t unit_size = input_segment->unit_size();
1206 const int64_t chunk_sample_count = DecodeChunkLength / unit_size;
1208 for (int64_t i = abs_start_samplenum;
1209 !decode_interrupt_ && (i < (abs_start_samplenum + sample_count));
1210 i += chunk_sample_count) {
1212 const int64_t chunk_end = min(i + chunk_sample_count,
1213 abs_start_samplenum + sample_count);
1216 lock_guard<mutex> lock(output_mutex_);
1217 // Update the sample count showing the samples including currently processed ones
1218 segments_.at(current_segment_id_).samples_decoded_incl = chunk_end;
1221 int64_t data_size = (chunk_end - i) * unit_size;
1222 uint8_t* chunk = new uint8_t[data_size];
1223 input_segment->get_samples(i, chunk_end, chunk);
1225 if (srd_session_send(srd_session_, i, chunk_end, chunk,
1226 data_size, unit_size) != SRD_OK) {
1227 set_error_message(tr("Decoder reported an error"));
1228 decode_interrupt_ = true;
1234 lock_guard<mutex> lock(output_mutex_);
1235 // Now that all samples are processed, the exclusive sample count catches up
1236 segments_.at(current_segment_id_).samples_decoded_excl = chunk_end;
1239 // Notify the frontend that we processed some data and
1240 // possibly have new annotations as well
1243 if (decode_paused_) {
1244 unique_lock<mutex> pause_wait_lock(decode_pause_mutex_);
1245 decode_pause_cond_.wait(pause_wait_lock);
1250 void DecodeSignal::decode_proc()
1252 current_segment_id_ = 0;
1254 // If there is no input data available yet, wait until it is or we're interrupted
1256 if (logic_mux_data_->logic_segments().size() == 0) {
1257 // Wait for input data
1258 unique_lock<mutex> input_wait_lock(input_mutex_);
1259 decode_input_cond_.wait(input_wait_lock);
1261 } while ((!decode_interrupt_) && (logic_mux_data_->logic_segments().size() == 0));
1263 if (decode_interrupt_)
1266 shared_ptr<const LogicSegment> input_segment = logic_mux_data_->logic_segments().front()->get_shared_ptr();
1270 // Create the initial segment and set its sample rate so that we can pass it to SRD
1271 create_decode_segment();
1272 segments_.at(current_segment_id_).samplerate = input_segment->samplerate();
1273 segments_.at(current_segment_id_).start_time = input_segment->start_time();
1275 start_srd_session();
1277 uint64_t samples_to_process = 0;
1278 uint64_t abs_start_samplenum = 0;
1280 // Keep processing new samples until we exhaust the input data
1282 samples_to_process = input_segment->get_sample_count() - abs_start_samplenum;
1284 if (samples_to_process > 0) {
1285 decode_data(abs_start_samplenum, samples_to_process, input_segment);
1286 abs_start_samplenum += samples_to_process;
1288 } while (!decode_interrupt_ && (samples_to_process > 0));
1290 if (!decode_interrupt_) {
1291 // samples_to_process is now 0, we've exhausted the currently available input data
1293 // If the input segment is complete, we've exhausted this segment
1294 if (input_segment->is_complete()) {
1295 if (current_segment_id_ < (logic_mux_data_->logic_segments().size() - 1)) {
1296 // Process next segment
1297 current_segment_id_++;
1300 input_segment = logic_mux_data_->logic_segments().at(current_segment_id_);
1301 } catch (out_of_range&) {
1302 qDebug() << "Decode error for" << name() << ": no logic mux segment" \
1303 << current_segment_id_ << "in decode_proc(), mux segments size is" \
1304 << logic_mux_data_->logic_segments().size();
1305 decode_interrupt_ = true;
1308 abs_start_samplenum = 0;
1310 // Create the next segment and set its metadata
1311 create_decode_segment();
1312 segments_.at(current_segment_id_).samplerate = input_segment->samplerate();
1313 segments_.at(current_segment_id_).start_time = input_segment->start_time();
1315 // Reset decoder state but keep the decoder stack intact
1316 terminate_srd_session();
1318 // All segments have been processed
1319 if (!decode_interrupt_)
1322 // Wait for more input data
1323 unique_lock<mutex> input_wait_lock(input_mutex_);
1324 decode_input_cond_.wait(input_wait_lock);
1327 // Input segment isn't complete yet but samples_to_process is 0, wait for more input data
1328 unique_lock<mutex> input_wait_lock(input_mutex_);
1329 decode_input_cond_.wait(input_wait_lock);
1333 } while (!decode_interrupt_);
1336 void DecodeSignal::start_srd_session()
1338 // If there were stack changes, the session has been destroyed by now, so if
1339 // it hasn't been destroyed, we can just reset and re-use it
1341 // When a decoder stack was created before, re-use it
1342 // for the next stream of input data, after terminating
1343 // potentially still executing operations, and resetting
1344 // internal state. Skip the rather expensive (teardown
1345 // and) construction of another decoder stack.
1347 // TODO Reduce redundancy, use a common code path for
1348 // the meta/start sequence?
1349 terminate_srd_session();
1351 // Metadata is cleared also, so re-set it
1352 uint64_t samplerate = 0;
1353 if (segments_.size() > 0)
1354 samplerate = segments_.at(current_segment_id_).samplerate;
1356 srd_session_metadata_set(srd_session_, SRD_CONF_SAMPLERATE,
1357 g_variant_new_uint64(samplerate));
1358 for (const shared_ptr<Decoder>& dec : stack_)
1359 dec->apply_all_options();
1360 srd_session_start(srd_session_);
1365 // Create the session
1366 srd_session_new(&srd_session_);
1367 assert(srd_session_);
1369 // Create the decoders
1370 srd_decoder_inst *prev_di = nullptr;
1371 for (const shared_ptr<Decoder>& dec : stack_) {
1372 srd_decoder_inst *const di = dec->create_decoder_inst(srd_session_);
1375 set_error_message(tr("Failed to create decoder instance"));
1376 srd_session_destroy(srd_session_);
1377 srd_session_ = nullptr;
1382 srd_inst_stack(srd_session_, prev_di, di);
1387 // Start the session
1388 if (segments_.size() > 0)
1389 srd_session_metadata_set(srd_session_, SRD_CONF_SAMPLERATE,
1390 g_variant_new_uint64(segments_.at(current_segment_id_).samplerate));
1392 srd_pd_output_callback_add(srd_session_, SRD_OUTPUT_ANN,
1393 DecodeSignal::annotation_callback, this);
1395 srd_pd_output_callback_add(srd_session_, SRD_OUTPUT_BINARY,
1396 DecodeSignal::binary_callback, this);
1398 srd_session_start(srd_session_);
1400 // We just recreated the srd session, so all stack changes are applied now
1401 stack_config_changed_ = false;
1404 void DecodeSignal::terminate_srd_session()
1406 // Call the "terminate and reset" routine for the decoder stack
1407 // (if available). This does not harm those stacks which already
1408 // have completed their operation, and reduces response time for
1409 // those stacks which still are processing data while the
1410 // application no longer wants them to.
1412 srd_session_terminate_reset(srd_session_);
1414 // Metadata is cleared also, so re-set it
1415 uint64_t samplerate = 0;
1416 if (segments_.size() > 0)
1417 samplerate = segments_.at(current_segment_id_).samplerate;
1419 srd_session_metadata_set(srd_session_, SRD_CONF_SAMPLERATE,
1420 g_variant_new_uint64(samplerate));
1421 for (const shared_ptr<Decoder>& dec : stack_)
1422 dec->apply_all_options();
1426 void DecodeSignal::stop_srd_session()
1429 // Destroy the session
1430 srd_session_destroy(srd_session_);
1431 srd_session_ = nullptr;
1433 // Mark the decoder instances as non-existant since they were deleted
1434 for (const shared_ptr<Decoder>& dec : stack_)
1435 dec->invalidate_decoder_inst();
1439 void DecodeSignal::connect_input_notifiers()
1441 // Connect the currently used signals to our slot
1442 for (decode::DecodeChannel& ch : channels_) {
1443 if (!ch.assigned_signal)
1445 const data::SignalBase *signal = ch.assigned_signal.get();
1447 connect(signal, SIGNAL(samples_cleared()),
1448 this, SLOT(on_data_cleared()), Qt::UniqueConnection);
1449 connect(signal, SIGNAL(samples_added(uint64_t, uint64_t, uint64_t)),
1450 this, SLOT(on_data_received()), Qt::UniqueConnection);
1452 if (signal->logic_data())
1453 connect(signal->logic_data().get(), SIGNAL(segment_completed()),
1454 this, SLOT(on_input_segment_completed()), Qt::UniqueConnection);
1458 void DecodeSignal::disconnect_input_notifiers()
1460 // Disconnect the notification slot from the previous set of signals
1461 for (decode::DecodeChannel& ch : channels_) {
1462 if (!ch.assigned_signal)
1464 const data::SignalBase *signal = ch.assigned_signal.get();
1465 disconnect(signal, nullptr, this, SLOT(on_data_cleared()));
1466 disconnect(signal, nullptr, this, SLOT(on_data_received()));
1468 if (signal->logic_data())
1469 disconnect(signal->logic_data().get(), nullptr, this, SLOT(on_input_segment_completed()));
1473 void DecodeSignal::create_decode_segment()
1475 // Create annotation segment
1476 segments_.emplace_back();
1478 // Add annotation classes
1479 for (const shared_ptr<Decoder>& dec : stack_)
1480 for (Row* row : dec->get_rows())
1481 segments_.back().annotation_rows.emplace(row, RowData(row));
1483 // Prepare our binary output classes
1484 for (const shared_ptr<Decoder>& dec : stack_) {
1485 uint32_t n = dec->get_binary_class_count();
1487 for (uint32_t i = 0; i < n; i++)
1488 segments_.back().binary_classes.push_back(
1489 {dec.get(), dec->get_binary_class(i), deque<DecodeBinaryDataChunk>()});
1493 void DecodeSignal::annotation_callback(srd_proto_data *pdata, void *decode_signal)
1496 assert(decode_signal);
1498 DecodeSignal *const ds = (DecodeSignal*)decode_signal;
1501 if (ds->decode_interrupt_)
1504 if (ds->segments_.empty())
1507 lock_guard<mutex> lock(ds->output_mutex_);
1509 // Get the decoder and the annotation data
1511 assert(pdata->pdo->di);
1512 const srd_decoder *const srd_dec = pdata->pdo->di->decoder;
1515 const srd_proto_data_annotation *const pda = (const srd_proto_data_annotation*)pdata->data;
1519 Decoder* dec = ds->get_decoder_by_instance(srd_dec);
1522 AnnotationClass* ann_class = dec->get_ann_class_by_id(pda->ann_class);
1524 qWarning() << "Decoder" << ds->display_name() << "wanted to add annotation" <<
1525 "with class ID" << pda->ann_class << "but there are only" <<
1526 dec->ann_classes().size() << "known classes";
1530 const Row* row = ann_class->row;
1533 row = dec->get_row_by_id(0);
1535 RowData& row_data = ds->segments_[ds->current_segment_id_].annotation_rows.at(row);
1537 // Add the annotation to the row
1538 const Annotation* ann = row_data.emplace_annotation(pdata);
1540 // We insert the annotation into the global annotation list in a way so that
1541 // the annotation list is sorted by start sample and length. Otherwise, we'd
1542 // have to sort the model, which is expensive
1543 deque<const Annotation*>& all_annotations =
1544 ds->segments_[ds->current_segment_id_].all_annotations;
1546 if (all_annotations.empty()) {
1547 all_annotations.emplace_back(ann);
1549 const uint64_t new_ann_len = (pdata->end_sample - pdata->start_sample);
1550 bool ann_has_earlier_start = (pdata->start_sample < all_annotations.back()->start_sample());
1551 bool ann_is_longer = (new_ann_len >
1552 (all_annotations.back()->end_sample() - all_annotations.back()->start_sample()));
1554 if (ann_has_earlier_start && ann_is_longer) {
1555 bool ann_has_same_start;
1556 auto it = all_annotations.end();
1560 ann_has_earlier_start = (pdata->start_sample < (*it)->start_sample());
1561 ann_has_same_start = (pdata->start_sample == (*it)->start_sample());
1562 ann_is_longer = (new_ann_len > (*it)->length());
1563 } while ((ann_has_earlier_start || (ann_has_same_start && ann_is_longer)) && (it != all_annotations.begin()));
1565 // Allow inserting at the front
1566 if (it != all_annotations.begin())
1569 all_annotations.emplace(it, ann);
1571 all_annotations.emplace_back(ann);
1574 // When emplace_annotation() inserts instead of appends an annotation,
1575 // the pointers in all_annotations that follow the inserted annotation and
1576 // point to annotations for this row are off by one and must be updated
1577 if (&(row_data.annotations().back()) != ann) {
1578 // Search backwards until we find the annotation we just added
1579 auto row_it = row_data.annotations().end();
1580 auto all_it = all_annotations.end();
1583 if ((*all_it)->row_data() == &row_data)
1585 } while (&(*row_it) != ann);
1587 // Update the annotation addresses for this row's annotations until the end
1589 if ((*all_it)->row_data() == &row_data) {
1590 *all_it = &(*row_it);
1594 } while (all_it != all_annotations.end());
1598 void DecodeSignal::binary_callback(srd_proto_data *pdata, void *decode_signal)
1601 assert(decode_signal);
1603 DecodeSignal *const ds = (DecodeSignal*)decode_signal;
1606 if (ds->decode_interrupt_)
1609 // Get the decoder and the binary data
1611 assert(pdata->pdo->di);
1612 const srd_decoder *const srd_dec = pdata->pdo->di->decoder;
1615 const srd_proto_data_binary *const pdb = (const srd_proto_data_binary*)pdata->data;
1618 // Find the matching DecodeBinaryClass
1619 DecodeSegment* segment = &(ds->segments_.at(ds->current_segment_id_));
1621 DecodeBinaryClass* bin_class = nullptr;
1622 for (DecodeBinaryClass& bc : segment->binary_classes)
1623 if ((bc.decoder->get_srd_decoder() == srd_dec) &&
1624 (bc.info->bin_class_id == (uint32_t)pdb->bin_class))
1628 qWarning() << "Could not find valid DecodeBinaryClass in segment" <<
1629 ds->current_segment_id_ << "for binary class ID" << pdb->bin_class <<
1630 ", segment only knows" << segment->binary_classes.size() << "classes";
1634 // Add the data chunk
1635 bin_class->chunks.emplace_back();
1636 DecodeBinaryDataChunk* chunk = &(bin_class->chunks.back());
1638 chunk->sample = pdata->start_sample;
1639 chunk->data.resize(pdb->size);
1640 memcpy(chunk->data.data(), pdb->data, pdb->size);
1642 Decoder* dec = ds->get_decoder_by_instance(srd_dec);
1644 ds->new_binary_data(ds->current_segment_id_, (void*)dec, pdb->bin_class);
1647 void DecodeSignal::on_capture_state_changed(int state)
1649 // If a new acquisition was started, we need to start decoding from scratch
1650 if (state == Session::Running) {
1651 logic_mux_data_invalid_ = true;
1656 void DecodeSignal::on_data_cleared()
1661 void DecodeSignal::on_data_received()
1663 // If we detected a lack of input data when trying to start decoding,
1664 // we have set an error message. Bail out if we still don't have data
1666 if ((!error_message_.isEmpty()) && (get_input_segment_count() == 0))
1669 if (!error_message_.isEmpty()) {
1670 error_message_.clear();
1671 // TODO Emulate noquote()
1672 qDebug().nospace() << name() << ": Input data available, error cleared";
1675 if (!logic_mux_thread_.joinable())
1678 logic_mux_cond_.notify_one();
1681 void DecodeSignal::on_input_segment_completed()
1683 if (!logic_mux_thread_.joinable())
1684 logic_mux_cond_.notify_one();
1687 void DecodeSignal::on_annotation_visibility_changed()
1689 annotation_visibility_changed();