X-Git-Url: https://sigrok.org/gitweb/?p=pulseview.git;a=blobdiff_plain;f=pv%2Fdevicemanager.cpp;h=ca8f66bee5316e6116d4fb38afcbdd93ca78a24d;hp=11a5fe3c2ff9564f56ae1dfaf33c81e23eb16859;hb=46ebcd3f6f85092a9eb6401f6f56cee8fa08131a;hpb=945745012eb57cefa1ef457daf48cfffa99f9ec2 diff --git a/pv/devicemanager.cpp b/pv/devicemanager.cpp index 11a5fe3c..ca8f66be 100644 --- a/pv/devicemanager.cpp +++ b/pv/devicemanager.cpp @@ -14,169 +14,342 @@ * 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 + * along with this program; if not, see . */ -#include "devicemanager.h" -#include "device/devinst.h" -#include "sigsession.h" +#include "devicemanager.hpp" +#include "session.hpp" #include +#include +#include +#include #include #include -#include +#include -using boost::shared_ptr; +#include +#include +#include + +#include + +#include +#include + +using std::bind; using std::list; using std::map; -using std::ostringstream; -using std::runtime_error; +using std::placeholders::_1; +using std::placeholders::_2; +using std::shared_ptr; using std::string; +using std::unique_ptr; +using std::vector; + +using Glib::VariantBase; + +using sigrok::ConfigKey; +using sigrok::Context; +using sigrok::Driver; namespace pv { -DeviceManager::DeviceManager(struct sr_context *sr_ctx) : - _sr_ctx(sr_ctx) +DeviceManager::DeviceManager(shared_ptr context, + std::string driver, bool do_scan) : + context_(context) { - init_drivers(); - scan_all_drivers(); + unique_ptr progress(new QProgressDialog("", + QObject::tr("Cancel"), 0, context->drivers().size() + 1)); + progress->setWindowModality(Qt::WindowModal); + progress->setMinimumDuration(1); // To show the dialog immediately + + int entry_num = 1; + + /* + * Check the presence of an optional user spec for device scans. + * Determine the driver name and options (in generic format) when + * applicable. + */ + std::string user_name; + vector user_opts; + if (!driver.empty()) { + user_opts = pv::util::split_string(driver, ":"); + user_name = user_opts.front(); + user_opts.erase(user_opts.begin()); + } + + /* + * Scan for devices. No specific options apply here, this is + * best effort auto detection. + */ + for (auto entry : context->drivers()) { + if (!do_scan) + break; + + // Skip drivers we won't scan anyway + if (!driver_supported(entry.second)) + continue; + + progress->setLabelText(QObject::tr("Scanning for %1...") + .arg(QString::fromStdString(entry.first))); + + if (entry.first == user_name) + continue; + driver_scan(entry.second, map()); + + progress->setValue(entry_num++); + QApplication::processEvents(); + if (progress->wasCanceled()) + break; + } + + /* + * Optionally run another scan with potentially more specific + * options when requested by the user. This is motivated by + * several different uses: It can find devices that are not + * covered by the above auto detection (UART, TCP). It can + * prefer one out of multiple found devices, and have this + * device pre-selected for new sessions upon user's request. + */ + user_spec_device_.reset(); + if (!driver.empty()) { + shared_ptr scan_drv; + map scan_opts; + + /* + * Lookup the device driver name. + */ + map> drivers = context->drivers(); + auto entry = drivers.find(user_name); + scan_drv = (entry != drivers.end()) ? entry->second : nullptr; + + /* + * Convert generic string representation of options + * to the driver specific data types. + */ + if (scan_drv && !user_opts.empty()) { + auto drv_opts = scan_drv->scan_options(); + scan_opts = drive_scan_options(user_opts, drv_opts); + } + + /* + * Run another scan for the specified driver, passing + * user provided scan options this time. + */ + list< shared_ptr > found; + if (scan_drv) { + found = driver_scan(scan_drv, scan_opts); + if (!found.empty()) + user_spec_device_ = found.front(); + } + } + progress->setValue(entry_num++); } -DeviceManager::~DeviceManager() +const shared_ptr& DeviceManager::context() const { - release_devices(); + return context_; } -const list< shared_ptr >& DeviceManager::devices() const +shared_ptr DeviceManager::context() { - return _devices; + return context_; } -void DeviceManager::use_device(shared_ptr dev_inst, - SigSession *owner) +const list< shared_ptr >& +DeviceManager::devices() const { - assert(dev_inst); - assert(owner); - - _used_devices[dev_inst] = owner; + return devices_; +} - sr_dev_open(dev_inst->dev_inst()); +/** + * Get the device that was detected with user provided scan options. + */ +shared_ptr +DeviceManager::user_spec_device() const +{ + return user_spec_device_; } -void DeviceManager::release_device(shared_ptr dev_inst) +/** + * Convert generic options to data types that are specific to Driver::scan(). + * + * @param[in] user_spec Vector of tokenized words, string format. + * @param[in] driver_opts Driver's scan options, result of Driver::scan_options(). + * + * @return Map of options suitable for Driver::scan(). + */ +map +DeviceManager::drive_scan_options(vector user_spec, + set driver_opts) { - assert(dev_inst); + map result; + + for (auto entry : user_spec) { + /* + * Split key=value specs. Accept entries without separator + * (for simplified boolean specifications). + */ + string key, val; + size_t pos = entry.find("="); + if (pos == std::string::npos) { + key = entry; + val = ""; + } else { + key = entry.substr(0, pos); + val = entry.substr(pos + 1); + } - // Notify the owner, and remove the device from the used device list - map< shared_ptr, pv::SigSession*>::const_iterator - iter = _used_devices.find(dev_inst); - assert(iter != _used_devices.end()); + /* + * Skip user specifications that are not a member of the + * driver's set of supported options. Have the text format + * input spec converted to the required driver specific type. + */ + const ConfigKey *cfg; + try { + cfg = ConfigKey::get_by_identifier(key); + if (!cfg) + continue; + if (driver_opts.find(cfg) == driver_opts.end()) + continue; + } catch (...) { + continue; + } + result[cfg] = cfg->parse_string(val); + } + + return result; +} - (*iter).second->release_device(dev_inst); - _used_devices.erase(dev_inst); +bool DeviceManager::driver_supported(shared_ptr driver) const +{ + /* + * We currently only support devices that can deliver samples at + * a fixed samplerate (i.e. oscilloscopes and logic analysers). + * + * @todo Add support for non-monotonic devices (DMMs, sensors, etc). + */ + const auto keys = driver->config_keys(); + + return keys.count(ConfigKey::LOGIC_ANALYZER) | keys.count(ConfigKey::OSCILLOSCOPE); } -list< shared_ptr > DeviceManager::driver_scan( - struct sr_dev_driver *const driver, GSList *const drvopts) +list< shared_ptr > +DeviceManager::driver_scan( + shared_ptr driver, map drvopts) { - list< shared_ptr > driver_devices; + list< shared_ptr > driver_devices; assert(driver); + if (!driver_supported(driver)) + return driver_devices; + // Remove any device instances from this driver from the device // list. They will not be valid after the scan. - list< shared_ptr >::iterator i = _devices.begin(); - while (i != _devices.end()) { - if ((*i)->dev_inst()->driver == driver) - i = _devices.erase(i); - else - i++; - } - - // Release this driver and all it's attached devices - release_driver(driver); + devices_.remove_if([&](shared_ptr device) { + return device->hardware_device()->driver() == driver; }); // Do the scan - GSList *const devices = sr_driver_scan(driver, drvopts); - for (GSList *l = devices; l; l = l->next) - driver_devices.push_back(shared_ptr( - new device::DevInst((sr_dev_inst*)l->data))); - g_slist_free(devices); - driver_devices.sort(compare_devices); - - // Add the scanned devices to the main list - _devices.insert(_devices.end(), driver_devices.begin(), - driver_devices.end()); - _devices.sort(compare_devices); - - return driver_devices; -} + auto devices = driver->scan(drvopts); -void DeviceManager::init_drivers() -{ - // Initialise all libsigrok drivers - sr_dev_driver **const drivers = sr_driver_list(); - for (sr_dev_driver **driver = drivers; *driver; driver++) { - if (sr_driver_init(_sr_ctx, *driver) != SR_OK) { - throw runtime_error( - string("Failed to initialize driver ") + - string((*driver)->name)); - } + // Add the scanned devices to the main list, set display names and sort. + for (shared_ptr device : devices) { + const shared_ptr d( + new devices::HardwareDevice(context_, device)); + driver_devices.push_back(d); } -} - -void DeviceManager::release_devices() -{ - // Release all the used devices - for (map, SigSession*>::iterator i = - _used_devices.begin(); i != _used_devices.end(); i++) - release_device((*i).first); - _used_devices.clear(); + devices_.insert(devices_.end(), driver_devices.begin(), + driver_devices.end()); + devices_.sort(bind(&DeviceManager::compare_devices, this, _1, _2)); + driver_devices.sort(bind( + &DeviceManager::compare_devices, this, _1, _2)); - // Clear all the drivers - sr_dev_driver **const drivers = sr_driver_list(); - for (sr_dev_driver **driver = drivers; *driver; driver++) - sr_dev_clear(*driver); + return driver_devices; } -void DeviceManager::scan_all_drivers() +const map DeviceManager::get_device_info( + shared_ptr device) { - // Scan all drivers for all devices. - struct sr_dev_driver **const drivers = sr_driver_list(); - for (struct sr_dev_driver **driver = drivers; *driver; driver++) - driver_scan(*driver); + map result; + + assert(device); + + const shared_ptr sr_dev = device->device(); + if (sr_dev->vendor().length() > 0) + result["vendor"] = sr_dev->vendor(); + if (sr_dev->model().length() > 0) + result["model"] = sr_dev->model(); + if (sr_dev->version().length() > 0) + result["version"] = sr_dev->version(); + if (sr_dev->serial_number().length() > 0) + result["serial_num"] = sr_dev->serial_number(); + if (sr_dev->connection_id().length() > 0) + result["connection_id"] = sr_dev->connection_id(); + + return result; } -void DeviceManager::release_driver(struct sr_dev_driver *const driver) +const shared_ptr DeviceManager::find_device_from_info( + const map search_info) { - assert(driver); - for (map, SigSession*>::iterator i = - _used_devices.begin(); i != _used_devices.end(); i++) - if((*i).first->dev_inst()->driver == driver) - { - // Notify the current owner of the device - (*i).second->release_device((*i).first); - - // Remove it from the used device list - _used_devices.erase(i); - - // Close the device instance - sr_dev_close((*i).first->dev_inst()); - } + shared_ptr last_resort_dev; + map dev_info; + + for (shared_ptr dev : devices_) { + assert(dev); + dev_info = get_device_info(dev); + + // If present, vendor and model always have to match. + if (dev_info.count("vendor") > 0 && search_info.count("vendor") > 0) + if (dev_info.at("vendor") != search_info.at("vendor")) + continue; + + if (dev_info.count("model") > 0 && search_info.count("model") > 0) + if (dev_info.at("model") != search_info.at("model")) + continue; + + // Most unique match: vendor/model/serial_num (but don't match a S/N of 0) + if ((dev_info.count("serial_num") > 0) && (dev_info.at("serial_num") != "0") + && search_info.count("serial_num") > 0) + if (dev_info.at("serial_num") == search_info.at("serial_num") && + dev_info.at("serial_num") != "0") + return dev; + + // Second best match: vendor/model/connection_id + if (dev_info.count("connection_id") > 0 && + search_info.count("connection_id") > 0) + if (dev_info.at("connection_id") == search_info.at("connection_id")) + return dev; + + // Last resort: vendor/model/version + if (dev_info.count("version") > 0 && + search_info.count("version") > 0) + if (dev_info.at("version") == search_info.at("version") && + dev_info.at("version") != "0") + return dev; + + // For this device, we merely have a vendor/model match. + last_resort_dev = dev; + } - // Clear all the old device instances from this driver - sr_dev_clear(driver); + // If there wasn't even a vendor/model/version match, we end up here. + // This is usually the case for devices with only vendor/model data. + // The selected device may be wrong with multiple such devices attached + // but it is the best we can do at this point. After all, there may be + // only one such device and we do want to select it in this case. + return last_resort_dev; } -bool DeviceManager::compare_devices(shared_ptr a, - shared_ptr b) +bool DeviceManager::compare_devices(shared_ptr a, + shared_ptr b) { assert(a); assert(b); - return a->format_device_title().compare(b->format_device_title()) < 0; + return a->display_name(*this).compare(b->display_name(*this)) < 0; } } // namespace pv