device_enumerator.h

Go to the documentation of this file.

/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
 * Copyright (C) 2018, Google Inc.
 *
 * API to enumerate and find media devices
 */
 
#pragma once
 
#include <memory>
#include <string>
#include <vector>
 
#include <libcamera/base/regex.h>
#include <libcamera/base/signal.h>
 
namespace libcamera {
 
class MediaDevice;
 
class DeviceMatch
{
public:
    DeviceMatch(const std::string &driver);
 
    void add(const std::string &entity);
    void add(std::regex entity);
 
    bool match(const MediaDevice *device) const;
 
    void clear();
 
private:
    std::string driver_;
    std::vector<std::string> entities_;
    std::vector<std::regex> entityRegexs_;
};
 
class DeviceEnumerator
{
public:
    static std::unique_ptr<DeviceEnumerator> create();
 
    virtual ~DeviceEnumerator();
 
    virtual int init() = 0;
    virtual int enumerate() = 0;
 
    std::shared_ptr<MediaDevice> search(const DeviceMatch &dm);
 
    Signal<> devicesAdded;
 
protected:
    std::unique_ptr<MediaDevice> createDevice(const std::string &deviceNode);
    void addDevice(std::unique_ptr<MediaDevice> media);
    void removeDevice(const std::string &deviceNode);
 
private:
    std::vector<std::shared_ptr<MediaDevice>> devices_;
};
 
} /* namespace libcamera */