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/signal.h>

namespace libcamera {

class MediaDevice;

class DeviceMatch
{
public:
    DeviceMatch(const std::string &driver);

    void add(const std::string &entity);

    bool match(const MediaDevice *device) const;

private:
    std::string driver_;
    std::vector<std::string> entities_;
};

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 */