Minor whitespace and Doxygen fixes.

[pulseview.git] / pv / binding / device.cpp

/*
 * This file is part of the PulseView project.
 *
 * Copyright (C) 2012 Joel Holdsworth <joel@airwebreathe.org.uk>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 */

#include <stdint.h>

#include <QDebug>

#include "device.hpp"

#include <pv/prop/bool.hpp>
#include <pv/prop/double.hpp>
#include <pv/prop/enum.hpp>
#include <pv/prop/int.hpp>

#include <libsigrokcxx/libsigrokcxx.hpp>

using boost::optional;
using std::function;
using std::make_pair;
using std::pair;
using std::shared_ptr;
using std::string;
using std::vector;

using sigrok::Capability;
using sigrok::Configurable;
using sigrok::ConfigKey;
using sigrok::Error;

using pv::prop::Bool;
using pv::prop::Double;
using pv::prop::Enum;
using pv::prop::Int;
using pv::prop::Property;

namespace pv {
namespace binding {

Device::Device(shared_ptr<sigrok::Configurable> configurable) :
	configurable_(configurable)
{
	std::map< const ConfigKey*, std::set<Capability> > keys;

	try {
		keys = configurable->config_keys(ConfigKey::DEVICE_OPTIONS);
	} catch (const Error) {
		return;
	}

	for (auto entry : keys) {
		auto key = entry.first;
		auto capabilities = entry.second;

		if (!capabilities.count(Capability::GET) ||
			!capabilities.count(Capability::SET))
			continue;

		string name_str;
		try {
			name_str = key->description();
		} catch (Error e) {
			name_str = key->name();
		}

		const QString name = QString::fromStdString(name_str);

		const Property::Getter get = [&, key]() {
			return configurable_->config_get(key); };
		const Property::Setter set = [&, key](Glib::VariantBase value) {
			configurable_->config_set(key, value);
			config_changed();
		};

		switch (key->id()) {
		case SR_CONF_SAMPLERATE:
			// Sample rate values are not bound because they are shown
			// in the MainBar
			break;

		case SR_CONF_CAPTURE_RATIO:
			bind_int(name, "%", pair<int64_t, int64_t>(0, 100),
				get, set);
			break;

		case SR_CONF_PATTERN_MODE:
		case SR_CONF_BUFFERSIZE:
		case SR_CONF_TRIGGER_SOURCE:
		case SR_CONF_TRIGGER_SLOPE:
		case SR_CONF_FILTER:
		case SR_CONF_COUPLING:
		case SR_CONF_CLOCK_EDGE:
			bind_enum(name, key, capabilities, get, set);
			break;

		case SR_CONF_EXTERNAL_CLOCK:
		case SR_CONF_RLE:
		case SR_CONF_POWER_OFF:
			bind_bool(name, get, set);
			break;

		case SR_CONF_TIMEBASE:
			bind_enum(name, key, capabilities, get, set, print_timebase);
			break;

		case SR_CONF_VDIV:
			bind_enum(name, key, capabilities, get, set, print_vdiv);
			break;

		case SR_CONF_VOLTAGE_THRESHOLD:
			bind_enum(name, key, capabilities, get, set, print_voltage_threshold);
			break;

		case SR_CONF_PROBE_FACTOR:
			bind_int(name, "", pair<int64_t, int64_t>(1, 500), get, set);
			break;

		default:
			break;
		}
	}
}

void Device::bind_bool(const QString &name,
	Property::Getter getter, Property::Setter setter)
{
	assert(configurable_);
	properties_.push_back(shared_ptr<Property>(new Bool(
		name, getter, setter)));
}

void Device::bind_enum(const QString &name,
	const ConfigKey *key, std::set<Capability> capabilities,
	Property::Getter getter,
	Property::Setter setter, function<QString (Glib::VariantBase)> printer)
{
	Glib::VariantBase gvar;
	vector< pair<Glib::VariantBase, QString> > values;

	assert(configurable_);

	if (!capabilities.count(Capability::LIST))
		return;

	Glib::VariantIter iter(configurable_->config_list(key));
	while ((iter.next_value(gvar)))
		values.push_back(make_pair(gvar, printer(gvar)));

	properties_.push_back(shared_ptr<Property>(new Enum(name, values,
		getter, setter)));
}

void Device::bind_int(const QString &name, QString suffix,
	optional< std::pair<int64_t, int64_t> > range,
	Property::Getter getter, Property::Setter setter)
{
	assert(configurable_);

	properties_.push_back(shared_ptr<Property>(new Int(name, suffix, range,
		getter, setter)));
}

QString Device::print_timebase(Glib::VariantBase gvar)
{
	uint64_t p, q;
	g_variant_get(gvar.gobj(), "(tt)", &p, &q);
	return QString::fromUtf8(sr_period_string(p * q));
}

QString Device::print_vdiv(Glib::VariantBase gvar)
{
	uint64_t p, q;
	g_variant_get(gvar.gobj(), "(tt)", &p, &q);
	return QString::fromUtf8(sr_voltage_string(p, q));
}

QString Device::print_voltage_threshold(Glib::VariantBase gvar)
{
	gdouble lo, hi;
	g_variant_get(gvar.gobj(), "(dd)", &lo, &hi);
	return QString("L<%1V H>%2V").arg(lo, 0, 'f', 1).arg(hi, 0, 'f', 1);
}

} // binding
} // pv