2021-08-24 18:10:20 -04:00
|
|
|
/*
|
2022-12-11 09:58:26 -05:00
|
|
|
arbitratinguniverse.h
|
2021-08-24 18:10:20 -04:00
|
|
|
|
|
|
|
Copyright (c) 2021 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.
|
|
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
|
2022-12-12 13:39:10 -05:00
|
|
|
#include "data.h"
|
2021-08-24 18:10:20 -04:00
|
|
|
#include <memory>
|
|
|
|
#include <unordered_map>
|
2022-12-12 13:39:10 -05:00
|
|
|
#include <shared_mutex>
|
|
|
|
|
|
|
|
namespace DMX {
|
|
|
|
class Universe;
|
|
|
|
}
|
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
|
|
|
|
2022-12-12 13:39:10 -05:00
|
|
|
class Universe;
|
|
|
|
|
2021-08-24 18:10:20 -04:00
|
|
|
/**
|
2021-08-29 00:58:57 -04:00
|
|
|
* @brief Priority based selection of multiple source universes
|
|
|
|
*
|
2021-08-28 09:01:33 -04:00
|
|
|
*
|
2021-08-28 12:54:26 -04:00
|
|
|
* > \cite sACN 6.2.3.1 Multiple Sources at Highest Priority
|
|
|
|
* >
|
2021-08-28 15:28:52 -04:00
|
|
|
* > It is possible for there to be multiple sources, all transmitting data
|
|
|
|
* > at the highest currently active priority for a given universe. When this
|
|
|
|
* > occurs, receivers must handle these sources in some way.
|
2021-08-29 00:58:57 -04:00
|
|
|
*
|
|
|
|
* If multiple universes with highest priority are recieved, the universe
|
2022-12-12 13:43:40 -05:00
|
|
|
* data will be HTP merged (default), or optionally, with the most recently
|
|
|
|
* recieved given dominance (LTP).
|
2021-08-29 00:58:57 -04:00
|
|
|
*
|
|
|
|
* > \cite sACN 6.2.3.2 Note on Merge and Arbitration Algorithms
|
|
|
|
* >
|
|
|
|
* > A process which selects between candidate sources based on some
|
|
|
|
* > additional selection criterion is called arbitration.
|
|
|
|
*
|
|
|
|
* The universe with the highest priority will be determined to be the
|
2022-12-06 14:50:20 -05:00
|
|
|
* dominant source.
|
2021-08-24 18:10:20 -04:00
|
|
|
*/
|
2022-12-11 16:04:44 -05:00
|
|
|
class UniverseArbitrator
|
2021-08-24 18:10:20 -04:00
|
|
|
{
|
|
|
|
public:
|
2022-12-12 13:39:10 -05:00
|
|
|
explicit UniverseArbitrator(sACN::Universe*);
|
2021-08-24 18:10:20 -04:00
|
|
|
|
2022-12-12 11:32:26 -05:00
|
|
|
void refresh();
|
2021-09-04 17:28:00 -04:00
|
|
|
|
2022-12-12 13:39:10 -05:00
|
|
|
// DMX::Universe API:
|
|
|
|
long age() const;
|
|
|
|
uint8_t status() const;
|
|
|
|
uint8_t slot(const uint16_t) const;
|
|
|
|
double rxRate();
|
2021-09-10 12:00:50 -04:00
|
|
|
|
2022-12-12 13:39:10 -05:00
|
|
|
// sACN::Universe API
|
|
|
|
std::shared_ptr<DATA::data_header> metadata() const;
|
|
|
|
bool isEditable() const;
|
|
|
|
uint16_t activeSlots() const;
|
|
|
|
const std::vector<DATA::data_header> sources() const;
|
2021-09-11 09:44:16 -04:00
|
|
|
|
2022-12-12 13:39:10 -05:00
|
|
|
// Source universes
|
|
|
|
bool hasSourceUniverse(const DATA::data_header&) const;
|
|
|
|
std::shared_ptr<Universe> sourceUniverse(const DATA::data_header&);
|
|
|
|
std::shared_ptr<Universe> addNewSource(const DATA::data_header&);
|
|
|
|
void deleteSourceUniverse(const DATA::data_header&);
|
|
|
|
std::shared_ptr<void> onSourceListChange(const std::function<void(DMX::Universe*)>);
|
|
|
|
|
|
|
|
// hold-last-look
|
|
|
|
void setHoldLastLook(const bool);
|
|
|
|
bool getHoldLastLook() const;
|
|
|
|
|
|
|
|
// merge-mode
|
|
|
|
/**
|
|
|
|
* @brief The MergeMode enum
|
|
|
|
*/
|
|
|
|
enum MergeMode {
|
|
|
|
MERGE_OTHER,
|
|
|
|
MERGE_HTP,
|
|
|
|
MERGE_LTP
|
|
|
|
};
|
|
|
|
void setMergeMode(const MergeMode);
|
|
|
|
MergeMode getMergeMode() const;
|
|
|
|
|
|
|
|
protected:
|
|
|
|
inline void doListChangeCallbacks();
|
2022-12-08 18:05:33 -05:00
|
|
|
|
2021-08-24 18:10:20 -04:00
|
|
|
private:
|
2022-12-12 13:39:10 -05:00
|
|
|
void find_dominant_();
|
|
|
|
void purge_stale_sources_();
|
|
|
|
|
|
|
|
sACN::Universe * m_universe;
|
2021-09-11 09:44:16 -04:00
|
|
|
std::unordered_map<DATA::data_header, std::shared_ptr<Universe>> sources_;
|
2022-12-12 13:39:10 -05:00
|
|
|
std::vector<std::shared_ptr<void>> cb_tokens_; //!< dominant universe callback tokens
|
|
|
|
std::vector<std::shared_ptr<void>> source_tokens_; //!< source universe status changes
|
2022-12-12 11:29:41 -05:00
|
|
|
std::vector<std::weak_ptr<const std::function<void(DMX::Universe*)>>> cb_sourceListChange; //!< list of calback functions
|
2022-12-09 18:17:04 -05:00
|
|
|
bool hold_last_look_;
|
2022-12-12 13:39:10 -05:00
|
|
|
MergeMode merge_mode_;
|
2022-12-11 21:30:37 -05:00
|
|
|
std::weak_ptr<Universe> m_dominant;
|
2022-12-12 13:39:10 -05:00
|
|
|
mutable std::shared_mutex mtx_arbitrate;
|
2021-08-24 18:10:20 -04:00
|
|
|
};
|
|
|
|
|
|
|
|
} // SACN namespace
|