DeviceDriver.h

Go to the documentation of this file.

/*
 * Copyright (C) 2006-2020 Istituto Italiano di Tecnologia (IIT)
 * Copyright (C) 2006-2010 RobotCub Consortium
 * All rights reserved.
 *
 * This software may be modified and distributed under the terms of the
 * BSD-3-Clause license. See the accompanying LICENSE file for details.
 */
 
#ifndef YARP_DEV_DEVICEDRIVER_H
#define YARP_DEV_DEVICEDRIVER_H
 
#include <yarp/os/ConnectionReader.h>
#include <yarp/os/ConnectionWriter.h>
#include <yarp/os/BufferedPort.h>
#include <yarp/os/Property.h>
#include <yarp/os/IConfig.h>
 
#include <yarp/dev/api.h>
 
namespace yarp {
    namespace dev {
        class DeviceDriver;
        class DeprecatedDeviceDriver;
        class DeviceResponder;
    }
}
 
class YARP_dev_API yarp::dev::DeviceDriver : public yarp::os::IConfig
{
public:
    ~DeviceDriver() override = default;
 
    bool open(yarp::os::Searchable& config) override { YARP_UNUSED(config); return true; }
 
    bool close() override { return true; }
 
 
    template <class T>
    bool view(T *&x) {
        x = nullptr;
 
        // This is not super-portable; and it requires RTTI compiled
        // in.  For systems on which this is a problem, suggest:
        // either replace it with a regular cast (and warn user) or
        // implement own method for checking interface support.
        T *v = dynamic_cast<T *>(getImplementation());
 
        if (v != nullptr) {
            x = v;
            return true;
        }
 
        return false;
    }
 
    virtual DeviceDriver *getImplementation() {
        return this;
    }
};
 
class YARP_dev_API yarp::dev::DeprecatedDeviceDriver : public yarp::dev::DeviceDriver
{
};
 
 
class YARP_dev_API yarp::dev::DeviceResponder : public yarp::os::PortReader,
            public yarp::os::TypedReaderCallback<yarp::os::Bottle>
{
 
private:
    yarp::os::Bottle examples;
    yarp::os::Bottle explains;
    yarp::os::Bottle details;
 
public:
    DeviceResponder();
 
    void addUsage(const char *txt, const char *explain = nullptr);
 
    void addUsage(const yarp::os::Bottle& bot, const char *explain = nullptr);
 
    virtual bool respond(const yarp::os::Bottle& command,
                         yarp::os::Bottle& reply);
 
    bool read(yarp::os::ConnectionReader& connection) override;
 
    using yarp::os::TypedReaderCallback<yarp::os::Bottle>::onRead;
    void onRead(yarp::os::Bottle& v) override {
        yarp::os::Bottle reply;
        respond(v,reply);
    }
 
    void makeUsage();
 
    void attach(yarp::os::TypedReader<yarp::os::Bottle>& source) {
        source.useCallback(*this);
        source.setReplier(*this);
    }
};
 
 
#endif // YARP_DEV_DEVICEDRIVER_H