Parent: [42eda2] (diff)

Child: [1e975e] (diff)

Download this file

device.hxx    128 lines (107 with data), 4.3 kB

  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
/* Copyright (C) 2014 J.F.Dockes
* 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 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.,
* 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
#ifndef _DEVICE_H_X_INCLUDED_
#define _DEVICE_H_X_INCLUDED_
#include <unordered_map>
#include <functional>
#include "soaphelp.hxx"
class UpnpService;
typedef function<int (const SoapArgs&, SoapData&)> soapfun;
/** Define a virtual interface to link libupnp operations to a device
* implementation
*/
class UpnpDevice {
public:
UpnpDevice(const std::string& deviceId,
const std::unordered_map<std::string, std::string>& xmlfiles);
void addService(UpnpService *, const std::string& serviceId);
/**
* Add mapping from action-name to handler function.
*/
void addActionMapping(const std::string& actName, soapfun fun);
/**
* Generate event.
*
* To be called by the device layer when data changes and an
* event should happen. Use is not mandatory because the polling by
* getEventData() may be sufficient.
*/
void notifyEvent(const std::string& serviceId,
const std::vector<std::string>& names,
const std::vector<std::string>& values);
/**
* Main routine. To be called by main() when done with initialization.
*
* This loop mostly polls getEventData and generates an UPnP event if
* there is anything to broadcast. The UPnP action calls happen in
* other threads with which we synchronize, currently using a global lock.
*/
void eventloop();
/**
* To be called from a service action callback to wake up the
* event loop early if something needs to be broadcast without
* waiting for the normal delay.
*
* Will only do something if the previous event is not too recent.
*/
void loopWakeup(); // To trigger an early event
/** Check status */
bool ok() {return m_lib != 0;}
private:
const std::string& serviceType(const std::string& serviceId);
LibUPnP *m_lib;
std::string m_deviceId;
std::unordered_map<std::string, UpnpService*> m_services;
std::unordered_map<std::string, soapfun> m_calls;
static unordered_map<std::string, UpnpDevice *> o_devices;
/* Static callback for libupnp. This looks up the appropriate
* device using the device ID (UDN), the calls its callback
* method */
static int sCallBack(Upnp_EventType et, void* evp, void*);
/* Gets called when something needs doing */
int callBack(Upnp_EventType et, void* evp);
};
/**
* Upnp service implementation class. This does not do much useful beyond
* encapsulating the service actions and event callback. In most cases, the
* services will need full access to the device state anyway.
*/
class UpnpService {
public:
UpnpService(const std::string& stp,const std::string& sid, UpnpDevice *dev)
: m_serviceType(stp)
{
dev->addService(this, sid);
}
virtual ~UpnpService() {}
/**
* Poll to retrieve evented data changed since last call.
*
* To be implemented by the derived class.
* Called by the library when a control point subscribes, to
* retrieve eventable data. Return name/value pairs in the data array
*/
virtual bool getEventData(bool all, std::vector<std::string>& names,
std::vector<std::string>& values) = 0;
virtual const std::string& getServiceType() const
{
return m_serviceType;
}
protected:
const std::string m_serviceType;
};
#endif /* _DEVICE_H_X_INCLUDED_ */