2021-08-24 18:10:20 -04:00
|
|
|
/*
|
|
|
|
mergeproxyuniverse.cpp
|
|
|
|
|
|
|
|
Copyright (c) 2020 Kevin Matz (kevin.matz@gmail.com)
|
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
|
|
in the Software without restriction, including without limitation the rights
|
|
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
|
|
copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
|
|
SOFTWARE.
|
|
|
|
*/
|
|
|
|
|
2021-08-28 15:28:52 -04:00
|
|
|
#include "arbitratinguniverse.h"
|
2021-08-24 18:10:20 -04:00
|
|
|
|
2021-08-28 09:01:33 -04:00
|
|
|
namespace sACN {
|
2021-08-24 18:10:20 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::MergeProxyUniverse
|
|
|
|
*/
|
2021-08-28 15:28:52 -04:00
|
|
|
ArbitratingUniverse::ArbitratingUniverse()
|
2021-08-28 09:01:33 -04:00
|
|
|
: sACN::Universe()
|
2021-09-04 17:28:00 -04:00
|
|
|
, expectedUniverse(0)
|
2021-09-10 16:26:31 -04:00
|
|
|
, HoldLastLook(true)
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::~MergeProxyUniverse
|
|
|
|
*/
|
2021-08-28 15:28:52 -04:00
|
|
|
ArbitratingUniverse::~ArbitratingUniverse()
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2021-09-10 16:26:31 -04:00
|
|
|
/**
|
|
|
|
* @brief ArbitratingUniverse::setHoldLastLook
|
|
|
|
* @param state
|
|
|
|
*/
|
|
|
|
void ArbitratingUniverse::setHoldLastLook(const bool state)
|
|
|
|
{
|
|
|
|
HoldLastLook = state;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief ArbitratingUniverse::getHoldLastLook
|
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
bool ArbitratingUniverse::getHoldLastLook() const
|
|
|
|
{
|
|
|
|
return HoldLastLook;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2021-08-28 15:28:52 -04:00
|
|
|
const std::vector<DATA::data_header> ArbitratingUniverse::sources() const
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
2021-08-28 14:47:30 -04:00
|
|
|
std::vector<DATA::data_header> keys;
|
2021-08-24 18:10:20 -04:00
|
|
|
for (const auto& [key, _] : sources_)
|
|
|
|
keys.push_back(key);
|
|
|
|
return keys;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::sourceUniverse
|
2021-08-25 17:20:33 -04:00
|
|
|
* @param src
|
2021-08-24 18:10:20 -04:00
|
|
|
* @return
|
|
|
|
*/
|
2021-09-10 09:55:34 -04:00
|
|
|
std::shared_ptr<Universe> ArbitratingUniverse::sourceUniverse(const DATA::data_header &src)
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
|
|
|
if (!hasSourceUniverse(src))
|
2021-09-10 12:00:50 -04:00
|
|
|
return nullptr;
|
|
|
|
|
2021-08-24 18:10:20 -04:00
|
|
|
return sources_.at(src);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::hasSourceUniverse
|
2021-08-25 17:20:33 -04:00
|
|
|
* @param src
|
2021-08-24 18:10:20 -04:00
|
|
|
* @return
|
|
|
|
*/
|
2021-08-28 15:28:52 -04:00
|
|
|
bool ArbitratingUniverse::hasSourceUniverse(const DATA::data_header& src) const
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
2021-09-10 09:55:34 -04:00
|
|
|
return (sources_.count(src));
|
2021-08-24 18:10:20 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
|
2021-09-10 12:00:50 -04:00
|
|
|
std::shared_ptr<Universe> ArbitratingUniverse::addNewSource(const DATA::data_header &src)
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
2021-09-10 12:00:50 -04:00
|
|
|
sources_.emplace(src, std::make_shared<Universe>());
|
2021-09-11 09:44:16 -04:00
|
|
|
auto token = sources_.at(src)->onData(std::bind(&sACN::ArbitratingUniverse::dataChangedNotifier,
|
|
|
|
this, std::placeholders::_1));
|
|
|
|
source_data_tokens.push_back(token);
|
|
|
|
doListChangeCallbacks();
|
2021-09-10 12:00:50 -04:00
|
|
|
|
|
|
|
return sources_.at(src);
|
2021-08-24 18:10:20 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::deleteSourceUniverse
|
2021-08-25 17:20:33 -04:00
|
|
|
* @param src
|
2021-08-24 18:10:20 -04:00
|
|
|
*/
|
2021-08-28 15:28:52 -04:00
|
|
|
void ArbitratingUniverse::deleteSourceUniverse(const DATA::data_header& src)
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
2021-09-10 12:00:50 -04:00
|
|
|
if (!hasSourceUniverse(src))
|
|
|
|
return;
|
2021-08-24 18:10:20 -04:00
|
|
|
|
2021-09-11 09:44:16 -04:00
|
|
|
/// \todo also erase token for data change callbacks
|
|
|
|
|
2021-09-10 12:00:50 -04:00
|
|
|
sources_.erase(src);
|
2021-09-11 09:44:16 -04:00
|
|
|
doListChangeCallbacks();
|
2021-08-24 18:10:20 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::dataChangedNotifier
|
2021-08-25 17:20:33 -04:00
|
|
|
* @param dmx
|
2021-08-24 18:10:20 -04:00
|
|
|
*/
|
2021-08-28 15:28:52 -04:00
|
|
|
void ArbitratingUniverse::dataChangedNotifier(DMX::Universe* dmx)
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
2021-08-28 09:01:33 -04:00
|
|
|
auto sacn = static_cast<sACN::Universe*>(dmx);
|
2021-08-24 18:10:20 -04:00
|
|
|
auto universe = dominant_();
|
|
|
|
if (!universe)
|
|
|
|
return;
|
2021-08-28 10:17:53 -04:00
|
|
|
if (sacn->provenance() == universe->provenance())
|
2021-09-11 09:44:16 -04:00
|
|
|
doDataCallbacks();
|
2021-08-24 18:10:20 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
|
2021-09-10 12:00:50 -04:00
|
|
|
/**
|
|
|
|
* @brief ArbitratingUniverse::onSourceListChange
|
|
|
|
* @param cb
|
2021-09-11 09:44:16 -04:00
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
std::shared_ptr<void> ArbitratingUniverse::onSourceListChange(std::function<void()> cb)
|
|
|
|
{
|
|
|
|
// wrap the callback with a shared pointer
|
|
|
|
auto sp = std::make_shared<std::function<void()>>(std::move(cb));
|
|
|
|
// add callback to list (as a weak pointer)
|
|
|
|
cb_sourceListChange.push_back(sp);
|
|
|
|
// return token that caller must keep throughout it's scope
|
|
|
|
return sp;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief ArbitratingUniverse::doListChangeCallbacks
|
2021-09-10 12:00:50 -04:00
|
|
|
*/
|
2021-09-11 09:44:16 -04:00
|
|
|
void ArbitratingUniverse::doListChangeCallbacks()
|
2021-09-10 12:00:50 -04:00
|
|
|
{
|
2021-09-11 09:44:16 -04:00
|
|
|
for (auto it = cb_sourceListChange.begin(); it != cb_sourceListChange.end();)
|
|
|
|
{
|
|
|
|
if (auto sp = it->lock())
|
|
|
|
{ // if the caller is still holding the token
|
|
|
|
(*sp)();
|
|
|
|
++it;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{ // or remove the callback
|
|
|
|
it = cb_sourceListChange.erase(it);
|
|
|
|
}
|
|
|
|
}
|
2021-09-10 12:00:50 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
|
2021-08-24 18:10:20 -04:00
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::isSyncronized
|
|
|
|
* @return
|
|
|
|
*/
|
2021-09-10 12:48:33 -04:00
|
|
|
bool ArbitratingUniverse::isSyncronized()
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
|
|
|
auto universe = dominant_();
|
|
|
|
if (!universe)
|
|
|
|
return false;
|
|
|
|
return universe->isSyncronized();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
2021-08-28 10:17:53 -04:00
|
|
|
* @brief MergeProxyUniverse::provenance
|
2021-08-24 18:10:20 -04:00
|
|
|
* @return
|
|
|
|
*/
|
2021-09-10 12:48:33 -04:00
|
|
|
std::shared_ptr<DATA::data_header> ArbitratingUniverse::provenance()
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
|
|
|
auto universe = dominant_();
|
2021-09-04 17:28:46 -04:00
|
|
|
if (universe)
|
|
|
|
return universe->provenance();
|
|
|
|
|
|
|
|
auto prov = std::make_shared<DATA::data_header>();
|
|
|
|
prov->universe = expectedUniverse;
|
|
|
|
prov->priority = 255; // invalid data
|
|
|
|
prov->source_name = "Pending data...";
|
|
|
|
return prov;
|
2021-08-24 18:10:20 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::set
|
|
|
|
* @param pdu
|
2021-08-25 17:20:33 -04:00
|
|
|
* @param src
|
2021-08-24 18:10:20 -04:00
|
|
|
*/
|
2021-08-28 15:28:52 -04:00
|
|
|
void ArbitratingUniverse::set(std::shared_ptr<ACN::DMP::Pdu> pdu,
|
2021-08-28 14:47:30 -04:00
|
|
|
std::shared_ptr<DATA::data_header> src)
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
2021-09-10 12:00:50 -04:00
|
|
|
if (expectedUniverse != 0 &&
|
|
|
|
src->universe != expectedUniverse)
|
2021-09-04 17:28:00 -04:00
|
|
|
return;
|
|
|
|
|
2021-08-24 18:10:20 -04:00
|
|
|
if (!sources_.count(*src))
|
2021-09-10 12:00:50 -04:00
|
|
|
addNewSource(*src);
|
2021-08-24 18:10:20 -04:00
|
|
|
|
|
|
|
sources_.at(*src)->set(pdu, src);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
2021-08-29 01:12:11 -04:00
|
|
|
* @brief ArbitratingUniverse::synchronize
|
|
|
|
* @param sequence_number
|
2021-08-24 18:10:20 -04:00
|
|
|
*/
|
2021-08-29 01:12:11 -04:00
|
|
|
void ArbitratingUniverse::synchronize(uint8_t sequence_number)
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
|
|
|
for ( auto& [_, uni] : sources_)
|
2021-08-29 01:12:11 -04:00
|
|
|
uni->synchronize(sequence_number);
|
2021-08-24 18:10:20 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
|
2021-09-03 17:37:12 -04:00
|
|
|
bool ArbitratingUniverse::isEditable() const {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2021-09-10 12:48:33 -04:00
|
|
|
uint16_t ArbitratingUniverse::activeSlots()
|
2021-09-03 17:43:50 -04:00
|
|
|
{
|
|
|
|
auto universe = dominant_();
|
|
|
|
if (!universe)
|
|
|
|
return 0;
|
|
|
|
return universe->activeSlots();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2021-08-24 18:10:20 -04:00
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::slot
|
|
|
|
* @param s
|
|
|
|
* @return
|
|
|
|
*/
|
2021-09-10 12:48:33 -04:00
|
|
|
uint8_t ArbitratingUniverse::slot(const uint16_t s)
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
|
|
|
auto universe = dominant_();
|
|
|
|
if (!universe)
|
|
|
|
return 0;
|
|
|
|
return universe->slot(s);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::rxRate
|
|
|
|
* @return
|
|
|
|
*/
|
2021-08-28 15:28:52 -04:00
|
|
|
double ArbitratingUniverse::rxRate()
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
|
|
|
auto universe = dominant_();
|
|
|
|
if (!universe)
|
|
|
|
return 0.0;
|
|
|
|
return universe->rxRate();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief MergeProxyUniverse::dominant_
|
|
|
|
* @return
|
|
|
|
*/
|
2021-09-10 12:48:33 -04:00
|
|
|
std::shared_ptr<Universe> ArbitratingUniverse::dominant_()
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
2021-09-10 12:48:33 -04:00
|
|
|
bool sourceListChanged = false;
|
2021-09-10 12:00:50 -04:00
|
|
|
std::shared_ptr<Universe> ret = nullptr;
|
2021-09-10 12:48:33 -04:00
|
|
|
|
|
|
|
for(auto it = sources_.begin(); it != sources_.end(); )
|
2021-09-11 09:44:16 -04:00
|
|
|
{
|
|
|
|
auto universe = it->second;
|
2021-09-10 12:48:33 -04:00
|
|
|
|
2021-09-11 09:44:16 -04:00
|
|
|
if (!ret && HoldLastLook)
|
|
|
|
{ // anything is better than nothing
|
|
|
|
++it;
|
|
|
|
ret = universe;
|
|
|
|
continue;
|
|
|
|
}
|
2021-09-10 12:48:33 -04:00
|
|
|
|
|
|
|
auto age = universe->rxAge();
|
|
|
|
|
|
|
|
if (age > E131_NETWORK_DATA_LOSS_TIMEOUT)
|
2021-09-11 09:44:16 -04:00
|
|
|
{ // clean up zombie universes
|
|
|
|
it = sources_.erase(it);
|
|
|
|
sourceListChanged = true;
|
|
|
|
continue;
|
|
|
|
}
|
2021-09-10 12:48:33 -04:00
|
|
|
|
|
|
|
if (age > DMX::E111_DATA_LOSS_TIMEOUT)
|
2021-09-11 09:44:16 -04:00
|
|
|
{
|
|
|
|
++it;
|
|
|
|
continue; // stale universes cannot be dominant
|
|
|
|
}
|
2021-09-10 12:48:33 -04:00
|
|
|
|
2021-09-11 09:44:16 -04:00
|
|
|
if (universe->provenance()->priority > ret->provenance()->priority)
|
2021-09-10 12:48:33 -04:00
|
|
|
ret = universe; // rank by provenance
|
|
|
|
|
|
|
|
++it;
|
2021-09-11 09:44:16 -04:00
|
|
|
}
|
2021-09-10 12:48:33 -04:00
|
|
|
|
|
|
|
if (sourceListChanged)
|
2021-09-11 09:44:16 -04:00
|
|
|
doListChangeCallbacks();
|
2021-09-10 12:48:33 -04:00
|
|
|
|
2021-08-24 18:10:20 -04:00
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
|
|
|
} // namespace SACN
|