/usr/include/olad/Device.h is in libola-dev 0.10.3.nojsmin-2+deb9u1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 | /*
* 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 Library 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 Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Device.h
* Header file for the Device class
* Copyright (C) 2005 Simon Newton
*/
#ifndef INCLUDE_OLAD_DEVICE_H_
#define INCLUDE_OLAD_DEVICE_H_
#include <ola/base/Macro.h>
#include <olad/Port.h>
#include <stdint.h>
#include <map>
#include <string>
#include <vector>
namespace ola {
namespace rpc {
class RpcController;
}
}
namespace ola {
class AbstractPlugin;
/*
* The interface for a Device
*/
class AbstractDevice {
public:
typedef BaseCallback0<void> ConfigureCallback;
AbstractDevice() {}
virtual ~AbstractDevice() {}
// return the name of this device
virtual const std::string Name() const = 0;
// return the plugin that owns this device
virtual AbstractPlugin *Owner() const = 0;
// return the a unique id of this device, this is guaranteed to be unique
// and persist across restarts.
virtual std::string UniqueId() const = 0;
// stop the device
virtual bool Stop() = 0;
// allow input and output ports to be patched to the same univese
virtual bool AllowLooping() const = 0;
// allow multiple ports of the same type to be patched to the same
// universe.
virtual bool AllowMultiPortPatching() const = 0;
// Fetch a list of all ports in this device
virtual void InputPorts(std::vector<InputPort*> *ports) const = 0;
virtual void OutputPorts(std::vector<OutputPort*> *ports) const = 0;
// Lookup a particular port in this device
virtual InputPort *GetInputPort(unsigned int port_id) const = 0;
virtual OutputPort *GetOutputPort(unsigned int port_id) const = 0;
// configure this device
virtual void Configure(ola::rpc::RpcController *controller,
const std::string &request,
std::string *response,
ConfigureCallback *done) = 0;
};
/*
* A partial implementation of a Device.
*/
class Device: public AbstractDevice {
public:
Device(AbstractPlugin *owner, const std::string &name);
virtual ~Device();
const std::string Name() const { return m_name; }
void SetName(const std::string &name) { m_name = name; }
AbstractPlugin *Owner() const { return m_owner; }
std::string UniqueId() const;
/**
* @brief The device ID
* @returns an id which is unique within the plugin,
*/
virtual std::string DeviceId() const = 0;
bool IsEnabled() const { return m_enabled; }
bool Start();
bool Stop();
// sane defaults
bool AllowLooping() const { return false; }
bool AllowMultiPortPatching() const { return false; }
bool AddPort(InputPort *port);
bool AddPort(OutputPort *port);
void InputPorts(std::vector<InputPort*> *ports) const;
void OutputPorts(std::vector<OutputPort*> *ports) const;
InputPort *GetInputPort(unsigned int port_id) const;
OutputPort *GetOutputPort(unsigned int port_id) const;
// Free all ports
void DeleteAllPorts();
// Handle a Configure request
virtual void Configure(ola::rpc::RpcController *controller,
const std::string &request,
std::string *response,
ConfigureCallback *done);
protected:
/**
* @brief Called during Start().
*
* This allows the subclass to perform device initialization.
*/
virtual bool StartHook() { return true; }
virtual void PrePortStop() {}
virtual void PostPortStop() {}
private:
typedef std::map<unsigned int, InputPort*> input_port_map;
typedef std::map<unsigned int, OutputPort*> output_port_map;
bool m_enabled;
AbstractPlugin *m_owner; // which plugin owns this device
std::string m_name; // device name
mutable std::string m_unique_id; // device id
input_port_map m_input_ports;
output_port_map m_output_ports;
template<class PortClass>
bool GenericAddPort(PortClass *port,
std::map<unsigned int, PortClass*> *ports);
template <class PortClass>
void GenericDeletePort(PortClass *p);
DISALLOW_COPY_AND_ASSIGN(Device);
};
} // namespace ola
#endif // INCLUDE_OLAD_DEVICE_H_
|