|
- /*
- ==============================================================================
-
- This file is part of the JUCE library.
- Copyright (c) 2022 - Raw Material Software Limited
-
- JUCE is an open source library subject to commercial or open-source
- licensing.
-
- By using JUCE, you agree to the terms of both the JUCE 7 End-User License
- Agreement and JUCE Privacy Policy.
-
- End User License Agreement: www.juce.com/juce-7-licence
- Privacy Policy: www.juce.com/juce-privacy-policy
-
- Or: You may also use this code under the terms of the GPL v3 (see
- www.gnu.org/licenses).
-
- JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
- EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
- DISCLAIMED.
-
- ==============================================================================
- */
-
- namespace juce::midi_ci
- {
-
- class Device::Impl
- {
- template <typename This>
- static auto getProfileHostImpl (This& t) { return t.profileHost.has_value() ? &*t.profileHost : nullptr; }
-
- template <typename This>
- static auto getPropertyHostImpl (This& t) { return t.propertyHost.has_value() ? &*t.propertyHost : nullptr; }
-
- public:
- explicit Impl (const Options& opt)
- : options (getValidated (opt)),
- muid (getReallyRandomMuid())
- {
- if (options.getFeatures().isProfileConfigurationSupported())
- profileHost.emplace (options.getFunctionBlock(), profileDelegate, concreteBufferOutput);
-
- if (options.getFeatures().isPropertyExchangeSupported())
- propertyHost.emplace (options.getFunctionBlock(), propertyDelegate, concreteBufferOutput, cacheProvider);
-
- outgoing.reserve (options.getMaxSysExSize());
- }
-
- ~Impl()
- {
- if (concreteBufferOutput.hasSentMuid())
- {
- detail::MessageTypeUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- MUID::getBroadcast(),
- ChannelInGroup::wholeBlock,
- Message::InvalidateMUID { muid });
- }
- }
-
- void sendDiscovery()
- {
- {
- const auto aboutToRemove = std::move (discovered);
-
- for (const auto& pair : aboutToRemove)
- listeners.call ([&] (auto& l) { l.deviceRemoved (pair.first); });
- }
-
- const Message::Header header
- {
- ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::Discovery>::subID2,
- detail::MessageMeta::implementationVersion,
- muid,
- MUID::getBroadcast(),
- };
-
- jassert (options.getOutputs().size() < 128);
-
- for (size_t i = 0; i < options.getOutputs().size(); ++i)
- {
- const Message::Discovery discovery
- {
- options.getDeviceInfo(),
- options.getFeatures().getSupportedCapabilities(),
- uint32_t (options.getMaxSysExSize()),
- std::byte (i % 128),
- };
-
- outgoing.clear();
- detail::Marshalling::Writer { outgoing } (header, discovery);
- options.getOutputs()[i]->processMessage ({ options.getFunctionBlock().firstGroup, outgoing });
- }
- }
-
- void sendEndpointInquiry (MUID destination, Message::EndpointInquiry endpoint)
- {
- detail::MessageTypeUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- destination,
- ChannelInGroup::wholeBlock,
- endpoint);
- }
-
- void sendProfileInquiry (MUID receiver, ChannelInGroup address)
- {
- if (! supportsProfiles (receiver))
- return;
-
- detail::MessageTypeUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- receiver,
- address,
- Message::ProfileInquiry{});
- }
-
- void sendProfileDetailsInquiry (MUID receiver, ChannelInGroup address, Profile profile, std::byte target)
- {
- if (! supportsProfiles (receiver))
- return;
-
- detail::MessageTypeUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- receiver,
- address,
- Message::ProfileDetails { profile, target });
- }
-
- void sendProfileSpecificData (MUID receiver, ChannelInGroup address, Profile profile, Span<const std::byte> data)
- {
- if (! supportsProfiles (receiver))
- return;
-
- detail::MessageTypeUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- receiver,
- address,
- Message::ProfileSpecificData { profile, data });
- }
-
- void sendProfileEnablement (MUID m, ChannelInGroup address, Profile profile, int numChannels)
- {
- if (! supportsProfiles (m))
- return;
-
- // There are only 256 channels on a UMP endpoint, so requesting more probably doesn't make sense!
- jassert (numChannels <= 256);
-
- if (numChannels > 0)
- {
- detail::MessageTypeUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- m,
- address,
- Message::ProfileOn { profile, (uint16_t) numChannels });
- }
- else
- {
- detail::MessageTypeUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- m,
- address,
- Message::ProfileOff { profile });
- }
- }
-
- void sendPropertyCapabilitiesInquiry (MUID m)
- {
- if (! supportsProperties (m))
- return;
-
- detail::MessageTypeUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- m,
- ChannelInGroup::wholeBlock,
- Message::PropertyExchangeCapabilities { std::byte { propertyDelegate.getNumSimultaneousRequestsSupported() }, {}, {} });
- }
-
- ErasedScopeGuard sendPropertyGetInquiry (MUID m,
- const PropertyRequestHeader& propertyHeader,
- std::function<void (const PropertyExchangeResult&)> callback)
- {
- const auto iter = discovered.find (m);
-
- if (iter == discovered.end() || ! Features { iter->second.discovery.capabilities }.isPropertyExchangeSupported())
- return {};
-
- auto primed = iter->second.initiatorPropertyCaches.primeCache (propertyDelegate.getNumSimultaneousRequestsSupported(),
- std::move (callback),
- detail::PropertyHostUtils::getTerminator (concreteBufferOutput, options.getFunctionBlock(), m));
-
- if (! primed.isValid())
- return {};
-
- detail::MessageTypeUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- m,
- ChannelInGroup::wholeBlock,
- Message::PropertyGetData { { primed.id, Encodings::jsonTo7BitText (propertyHeader.toVarCondensed()) } });
-
- return std::move (primed.token);
- }
-
- void sendPropertySetInquiry (MUID m,
- const PropertyRequestHeader& propertyHeader,
- Span<const std::byte> propertyBody,
- std::function<void (const PropertyExchangeResult&)> callback)
- {
- const auto iter = discovered.find (m);
-
- if (iter == discovered.end() || ! Features { iter->second.discovery.capabilities }.isPropertyExchangeSupported())
- return;
-
- const auto encoded = Encodings::tryEncode (propertyBody, propertyHeader.mutualEncoding);
-
- if (! encoded.has_value())
- {
- NullCheckedInvocation::invoke (callback, PropertyExchangeResult { PropertyExchangeResult::Error::invalidPayload });
- return;
- }
-
- auto primed = iter->second.initiatorPropertyCaches.primeCache (propertyDelegate.getNumSimultaneousRequestsSupported(),
- std::move (callback),
- detail::PropertyHostUtils::getTerminator (concreteBufferOutput, options.getFunctionBlock(), m));
-
- if (! primed.isValid())
- return;
-
- detail::PropertyHostUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- detail::MessageMeta::Meta<Message::PropertySetData>::subID2,
- m,
- primed.id,
- Encodings::jsonTo7BitText (propertyHeader.toVarCondensed()),
- *encoded,
- cacheProvider.getMaxSysexSizeForMuid (m));
- }
-
- void sendPropertySubscriptionStart (MUID m,
- const PropertySubscriptionHeader& header,
- std::function<void (const PropertyExchangeResult&)> cb)
- {
- const auto resource = header.resource;
- auto wrappedCallback = [this, m, resource, callback = std::move (cb)] (const PropertyExchangeResult& result)
- {
- if (! result.getError().has_value())
- {
- const auto foundMuid = discovered.find (m);
-
- if (foundMuid != discovered.end())
- {
- const auto parsed = result.getHeaderAsSubscriptionHeader();
-
- // The responder should have given us a subscription ID so that we can reference the original subscription
- // whenever we get updates in the future, or if we want to end the subscription.
- jassert (parsed.subscribeId.isNotEmpty());
- const auto emplaceResult = foundMuid->second.subscriptions.insert ({ parsed.subscribeId, resource });
-
- // If this fails, the device gave us a subscribeId that it was already using for another subscription.
- jassertquiet (emplaceResult.second);
- }
- }
-
- NullCheckedInvocation::invoke (callback, result);
- };
-
- inquirePropertySubscribe (m, header, std::move (wrappedCallback));
- }
-
- void sendPropertySubscriptionEnd (MUID m,
- const String& subscribeId,
- std::function<void (const PropertyExchangeResult&)> cb)
- {
- const auto iter = discovered.find (m);
-
- if (iter == discovered.end() || ! Features { iter->second.discovery.capabilities }.isPropertyExchangeSupported())
- {
- // Trying to send a subscription message to a device that doesn't exist (maybe it got removed), or
- // that doesn't support property exchange.
- jassertfalse;
- return;
- }
-
- if (iter->second.subscriptions.count ({ subscribeId, {} }) == 0)
- {
- // Trying to end a subscription that doesn't exist - perhaps it already ended.
- jassertfalse;
- return;
- }
-
- auto wrappedCallback = [this, m, subscribeId, callback = std::move (cb)] (const PropertyExchangeResult& result)
- {
- if (! result.getError().has_value())
- {
- const auto foundMuid = discovered.find (m);
-
- if (foundMuid != discovered.end())
- foundMuid->second.subscriptions.erase ({ subscribeId, {} });
- }
-
- NullCheckedInvocation::invoke (callback, result);
- };
-
- PropertySubscriptionHeader header;
- header.subscribeId = subscribeId;
- header.command = PropertySubscriptionCommand::end;
- inquirePropertySubscribe (m, header, std::move (wrappedCallback));
- }
-
- std::vector<Subscription> getOngoingSubscriptionsForMuid (MUID m) const
- {
- const auto iter = discovered.find (m);
-
- if (iter == discovered.end())
- return {};
-
- std::vector<Subscription> result;
- result.reserve (iter->second.subscriptions.size());
-
- for (const auto& [subscribeId, resource] : iter->second.subscriptions)
- result.push_back ({ subscribeId, resource });
-
- return result;
- }
-
- int countOngoingPropertyTransactions() const
- {
- return std::accumulate (discovered.begin(),
- discovered.end(),
- 0,
- [] (auto acc, const auto& pair)
- {
- return acc + pair.second.initiatorPropertyCaches.countOngoingTransactions();
- });
- }
-
- void processMessage (ump::BytesOnGroup msg)
- {
- // Queried before the property host to unconditionally register capabilities of property exchange hosts.
- FirstListener firstListener { this };
- LastListener lastListener { this };
-
- ResponderDelegate* const l[] { &firstListener,
- getProfileHostImpl (*this),
- getPropertyHostImpl (*this),
- &lastListener };
-
- const auto status = detail::Responder::processCompleteMessage (concreteBufferOutput, msg, l);
-
- if (status == Parser::Status::collidingMUID)
- {
- muid = getReallyRandomMuid();
- concreteBufferOutput.resetSentMuid();
- sendDiscovery();
- }
- }
-
- void addListener (Listener& l)
- {
- listeners.add (&l);
- }
-
- void removeListener (Listener& l)
- {
- listeners.remove (&l);
- }
-
- std::vector<MUID> getDiscoveredMuids() const
- {
- std::vector<MUID> result (discovered.size(), MUID::makeUnchecked (0));
- std::transform (discovered.begin(), discovered.end(), result.begin(), [] (const auto& p) { return p.first; });
- return result;
- }
-
- std::optional<Message::Discovery> getDiscoveryInfoForMuid (MUID m) const
- {
- const auto iter = discovered.find (m);
- return iter != discovered.end()
- ? std::optional<Message::Discovery> (iter->second.discovery)
- : std::nullopt;
- }
-
- std::optional<int> getNumPropertyExchangeRequestsSupportedForMuid (MUID m) const
- {
- const auto iter = discovered.find (m);
- return iter != discovered.end()
- ? std::optional<int> ((int) iter->second.propertyExchangeResponse->numSimultaneousRequestsSupported)
- : std::nullopt;
- }
-
- const ChannelProfileStates* getProfileStateForMuid (MUID m, ChannelAddress address) const
- {
- const auto iter = discovered.find (m);
- return iter != discovered.end() ? iter->second.profileStates.getStateForDestination (address) : nullptr;
- }
-
- var getResourceListForMuid (MUID x) const
- {
- const auto iter = discovered.find (x);
- return iter != discovered.end() ? iter->second.resourceList : var();
- }
-
- var getDeviceInfoForMuid (MUID x) const
- {
- const auto iter = discovered.find (x);
- return iter != discovered.end() ? iter->second.deviceInfo : var();
- }
-
- var getChannelListForMuid (MUID x) const
- {
- const auto iter = discovered.find (x);
- return iter != discovered.end() ? iter->second.channelList : var();
- }
-
- MUID getMuid() const { return muid; }
-
- Options getOptions() const { return options; }
-
- ProfileHost* getProfileHost() { return getProfileHostImpl (*this); }
- const ProfileHost* getProfileHost() const { return getProfileHostImpl (*this); }
-
- PropertyHost* getPropertyHost() { return getPropertyHostImpl (*this); }
- const PropertyHost* getPropertyHost() const { return getPropertyHostImpl (*this); }
-
- private:
- class FirstListener : public ResponderDelegate
- {
- public:
- explicit FirstListener (Impl* d) : device (d) {}
-
- bool tryRespond (ResponderOutput& output, const Message::Parsed& message) override
- {
- detail::MessageTypeUtils::visit (message, Visitor { device, &output });
- return false;
- }
-
- private:
- class Visitor : public detail::MessageTypeUtils::MessageVisitor
- {
- public:
- Visitor (Impl* d, ResponderOutput* o)
- : device (d), output (o) {}
-
- void visit (const Message::PropertyExchangeCapabilities& caps) const override { visitImpl (caps); }
- void visit (const Message::PropertyExchangeCapabilitiesResponse& caps) const override { visitImpl (caps); }
- using MessageVisitor::visit;
-
- private:
- template <typename Body>
- void visitImpl (const Body& t) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return;
-
- iter->second.propertyExchangeResponse = Message::PropertyExchangeCapabilitiesResponse { t.numSimultaneousRequestsSupported,
- t.majorVersion,
- t.minorVersion };
- }
-
- Impl* device = nullptr;
- ResponderOutput* output = nullptr;
- };
-
- Impl* device = nullptr;
- };
-
- class LastListener : public ResponderDelegate
- {
- public:
- explicit LastListener (Impl* d) : device (d) {}
-
- bool tryRespond (ResponderOutput& output, const Message::Parsed& message) override
- {
- bool result = false;
- detail::MessageTypeUtils::visit (message, Visitor { device, &output, &result });
- return result;
- }
-
- private:
- class Visitor : public detail::MessageTypeUtils::MessageVisitor
- {
- public:
- Visitor (Impl* d, ResponderOutput* o, bool* b)
- : device (d), output (o), handled (b) {}
-
- void visit (const Message::Discovery& x) const override { visitImpl (x); }
- void visit (const Message::DiscoveryResponse& x) const override { visitImpl (x); }
- void visit (const Message::InvalidateMUID& x) const override { visitImpl (x); }
- void visit (const Message::EndpointInquiry& x) const override { visitImpl (x); }
- void visit (const Message::EndpointInquiryResponse& x) const override { visitImpl (x); }
- void visit (const Message::NAK& x) const override { visitImpl (x); }
- void visit (const Message::ProfileInquiryResponse& x) const override { visitImpl (x); }
- void visit (const Message::ProfileAdded& x) const override { visitImpl (x); }
- void visit (const Message::ProfileRemoved& x) const override { visitImpl (x); }
- void visit (const Message::ProfileEnabledReport& x) const override { visitImpl (x); }
- void visit (const Message::ProfileDisabledReport& x) const override { visitImpl (x); }
- void visit (const Message::ProfileDetailsResponse& x) const override { visitImpl (x); }
- void visit (const Message::ProfileSpecificData& x) const override { visitImpl (x); }
- void visit (const Message::PropertyExchangeCapabilitiesResponse& x) const override { visitImpl (x); }
- void visit (const Message::PropertyGetDataResponse& x) const override { visitImpl (x); }
- void visit (const Message::PropertySetDataResponse& x) const override { visitImpl (x); }
- void visit (const Message::PropertySubscribe& x) const override { visitImpl (x); }
- void visit (const Message::PropertySubscribeResponse& x) const override { visitImpl (x); }
- void visit (const Message::PropertyNotify& x) const override { visitImpl (x); }
- using MessageVisitor::visit;
-
- private:
- template <typename Body>
- void visitImpl (const Body& body) const { *handled = messageReceived (body); }
-
- bool messageReceived (const Message::Discovery& body) const
- {
- const auto replyPath = uint8_t (output->getIncomingHeader().version) >= 0x02 ? body.outputPathID : std::byte { 0x00 };
-
- detail::MessageTypeUtils::send (*output, Message::DiscoveryResponse
- {
- device->options.getDeviceInfo(),
- device->options.getFeatures().getSupportedCapabilities(),
- uint32_t (device->options.getMaxSysExSize()),
- replyPath,
- device->options.getFunctionBlock().identifier,
- });
-
- // TODO(reuk) rather than sending a new discovery inquiry, we should store the details from the incoming message
- const auto iter = device->discovered.find (output->getIncomingHeader().source);
-
- if (iter == device->discovered.end())
- {
- const auto initiator = output->getIncomingHeader().source;
- device->discovered.emplace (initiator, Discovered { body });
- device->listeners.call ([&] (auto& l) { l.deviceAdded (initiator); });
- device->sendEndpointInquiry (initiator, Message::EndpointInquiry { std::byte{} });
- }
-
- return true;
- }
-
- bool messageReceived (const Message::DiscoveryResponse& response) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter != device->discovered.end())
- {
- device->discovered.erase (iter);
- device->listeners.call ([&] (auto& l) { l.deviceRemoved (responderMUID); });
-
- const Message::Header header
- {
- ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::InvalidateMUID>::subID2,
- detail::MessageMeta::implementationVersion,
- device->muid,
- MUID::getBroadcast(),
- };
-
- detail::MessageTypeUtils::send (*output, output->getIncomingGroup(), header, Message::InvalidateMUID { responderMUID });
- }
- else
- {
- const Message::Discovery discovery { response.device,
- response.capabilities,
- response.maximumSysexSize,
- response.outputPathID };
- device->discovered.emplace (responderMUID, Discovered { discovery });
- device->listeners.call ([&] (auto& l) { l.deviceAdded (responderMUID); });
- device->sendEndpointInquiry (output->getIncomingHeader().source, Message::EndpointInquiry { std::byte{} });
- }
-
- return true;
- }
-
- bool messageReceived (const Message::InvalidateMUID& invalidate) const
- {
- const auto targetMuid = invalidate.target;
- const auto iter = device->discovered.find (targetMuid);
-
- if (iter != device->discovered.end())
- {
- device->discovered.erase (iter);
- device->listeners.call ([&] (auto& l) { l.deviceRemoved (targetMuid); });
- }
-
- if (invalidate.target != device->muid)
- return false;
-
- device->muid = getReallyRandomMuid();
- device->concreteBufferOutput.resetSentMuid();
- device->sendDiscovery();
-
- return true;
- }
-
- bool messageReceived (const Message::EndpointInquiry& endpoint) const
- {
- // Only status 0 is defined at time of writing
- if (endpoint.status == std::byte{})
- {
- const auto& id = device->options.getProductInstanceId();
- const auto length = std::distance (id.begin(), std::find (id.begin(), id.end(), 0));
-
- if (length <= 0)
- return false;
-
- Message::EndpointInquiryResponse response;
- response.status = endpoint.status;
- response.data = Span<const std::byte> (reinterpret_cast<const std::byte*> (id.data()), (size_t) length);
- detail::MessageTypeUtils::send (*output, response);
- return true;
- }
-
- return false;
- }
-
- bool messageReceived (const Message::EndpointInquiryResponse& endpoint) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return false; // Got an endpoint response for a device we haven't discovered
-
- device->listeners.call ([&] (auto& l) { l.endpointReceived (responderMUID, endpoint); });
- return true;
- }
-
- bool messageReceived (const Message::NAK& nak) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- device->listeners.call ([&] (auto& l) { l.messageNotAcknowledged (responderMUID, nak); });
- return true;
- }
-
- bool messageReceived (const Message::ProfileInquiryResponse& response) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return false;
-
- const auto destination = output->getIncomingHeader().deviceID;
- auto* state = iter->second.profileStates.getStateForDestination (output->getChannelAddress());
-
- if (state == nullptr)
- return false;
-
- ChannelProfileStates newState;
-
- for (auto& enabled : response.enabledProfiles)
- newState.set (enabled, { 1, 1 });
-
- for (auto& disabled : response.disabledProfiles)
- newState.set (disabled, { 1, 0 });
-
- *state = newState;
- device->listeners.call ([&] (auto& l) { l.profileStateReceived (responderMUID, destination); });
-
- return true;
- }
-
- bool messageReceived (const Message::ProfileAdded& added) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return false;
-
- const auto address = output->getChannelAddress();
- auto* state = iter->second.profileStates.getStateForDestination (address);
-
- if (state == nullptr)
- return false;
-
- state->set (added.profile, { 1, 0 });
- device->listeners.call ([&] (auto& l) { l.profilePresenceChanged (responderMUID, address.getChannel(), added.profile, true); });
-
- return true;
- }
-
- bool messageReceived (const Message::ProfileRemoved& removed) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return false;
-
- const auto address = output->getChannelAddress();
- auto* state = iter->second.profileStates.getStateForDestination (address);
-
- if (state == nullptr)
- return false;
-
- state->erase (removed.profile);
- device->listeners.call ([&] (auto& l) { l.profilePresenceChanged (responderMUID, address.getChannel(), removed.profile, false); });
-
- return true;
- }
-
- bool messageReceived (const Message::ProfileEnabledReport& x) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return false;
-
- const auto address = output->getChannelAddress();
- auto* state = iter->second.profileStates.getStateForDestination (address);
-
- if (state == nullptr)
- return false;
-
- const auto numChannels = jmax ((uint16_t) 1, x.numChannels);
-
- state->set (x.profile, { state->get (x.profile).supported, numChannels });
- device->listeners.call ([&] (auto& l) { l.profileEnablementChanged (responderMUID, address.getChannel(), x.profile, numChannels); });
-
- return true;
- }
-
- bool messageReceived (const Message::ProfileDisabledReport& x) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return false;
-
- const auto address = output->getChannelAddress();
- auto* state = iter->second.profileStates.getStateForDestination (address);
-
- if (state == nullptr)
- return false;
-
- state->set (x.profile, { state->get (x.profile).supported, 0 });
- device->listeners.call ([&] (auto& l) { l.profileEnablementChanged (responderMUID, address.getChannel(), x.profile, 0); });
-
- return true;
- }
-
- bool messageReceived (const Message::ProfileDetailsResponse& response) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto destination = output->getIncomingHeader().deviceID;
- device->listeners.call ([&] (auto& l) { l.profileDetailsReceived (responderMUID, destination, response.profile, response.target, response.data); });
-
- return true;
- }
-
- bool messageReceived (const Message::ProfileSpecificData& data) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto destination = output->getIncomingHeader().deviceID;
- device->listeners.call ([&] (auto& l) { l.profileSpecificDataReceived (responderMUID, destination, data.profile, data.data); });
-
- return true;
- }
-
- bool messageReceived (const Message::PropertyExchangeCapabilitiesResponse&) const
- {
- const auto source = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (source);
-
- constexpr auto hasResource = [] (var obj, auto resource)
- {
- if (auto* array = obj.getArray())
- for (const auto& item : *array)
- if (item.isObject() && item.getProperty ("resource", {}) == var (resource))
- return true;
-
- return false;
- };
-
- const auto transaction = device->ongoingTransactions.emplace (device->ongoingTransactions.end());
-
- const auto onResourceListReceived = [this, iter, source, hasResource, transaction] (const PropertyExchangeResult& result)
- {
- const auto validateResponse = [] (const PropertyExchangeResult& r)
- {
- const auto parsed = r.getHeaderAsReplyHeader();
- return ! r.getError().has_value()
- && parsed.mediaType == PropertySubscriptionHeader().mediaType
- && parsed.status == 200;
- };
-
- const auto allDone = [this, source, transaction]
- {
- device->ongoingTransactions.erase (transaction);
- device->listeners.call ([source] (auto& l) { l.propertyExchangeCapabilitiesReceived (source); });
- };
-
- if (! validateResponse (result))
- {
- jassertfalse;
- allDone();
- return;
- }
-
- const auto bodyAsObj = Encodings::jsonFrom7BitText (result.getBody());
- iter->second.resourceList = bodyAsObj;
-
- const auto onChannelListReceived = [iter, allDone, validateResponse] (const PropertyExchangeResult& r)
- {
- if (validateResponse (r))
- iter->second.channelList = Encodings::jsonFrom7BitText (r.getBody());
-
- allDone();
- return;
- };
-
- const auto getChannelList = [this, bodyAsObj, source, allDone, hasResource, onChannelListReceived, transaction]
- {
- if (hasResource (bodyAsObj, "ChannelList"))
- {
- PropertyRequestHeader header;
- header.resource = "ChannelList";
- *transaction = device->sendPropertyGetInquiry (source, header, onChannelListReceived);
- return;
- }
-
- allDone();
- return;
- };
-
- if (hasResource (bodyAsObj, "DeviceInfo"))
- {
- PropertyRequestHeader header;
- header.resource = "DeviceInfo";
- *transaction = device->sendPropertyGetInquiry (source,
- header,
- [iter, getChannelList, validateResponse] (const PropertyExchangeResult& r)
- {
- if (validateResponse (r))
- iter->second.deviceInfo = Encodings::jsonFrom7BitText (r.getBody());
-
- getChannelList();
- });
- return;
- }
-
- return getChannelList();
- };
-
- PropertyRequestHeader header;
- header.resource = "ResourceList";
- *transaction = device->sendPropertyGetInquiry (source, header, onResourceListReceived);
-
- return true;
- }
-
- bool handlePropertyDataResponse (const Message::DynamicSizePropertyExchange& response) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return false;
-
- iter->second.initiatorPropertyCaches.addChunk (response.requestID, response);
-
- return true;
- }
-
- bool messageReceived (const Message::PropertyGetDataResponse& response) const
- {
- handlePropertyDataResponse (response);
- return true;
- }
-
- bool messageReceived (const Message::PropertySetDataResponse& response) const
- {
- handlePropertyDataResponse (Message::DynamicSizePropertyExchange { response.requestID,
- response.header,
- 1,
- 1,
- {} });
- return true;
- }
-
- bool messageReceived (const Message::PropertySubscribe& subscription) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return false;
-
- const auto request = subscription.requestID;
- const auto source = output->getIncomingHeader().source;
-
- const auto jsonHeader = Encodings::jsonFrom7BitText (subscription.header);
- const auto typedHeader = PropertySubscriptionHeader::parseCondensed (jsonHeader);
- const auto subscribeId = typedHeader.subscribeId;
-
- const auto callback = [this, request, source, subscribeId] (const PropertyExchangeResult& result)
- {
- if (result.getError().has_value())
- return;
-
- PropertySubscriptionData data;
-
- data.header = result.getHeaderAsSubscriptionHeader();
- data.body = result.getBody();
-
- if (data.header.command == PropertySubscriptionCommand::end)
- {
- const auto foundMuid = device->discovered.find (source);
-
- if (foundMuid != device->discovered.end())
- foundMuid->second.subscriptions.erase ({ data.header.subscribeId, {} });
- }
-
- if (data.header.command != PropertySubscriptionCommand::start)
- device->listeners.call ([source, &data] (auto& l) { l.propertySubscriptionDataReceived (source, data); });
-
- PropertyReplyHeader header;
- header.extended["subscribeId"] = subscribeId;
- const auto headerBytes = Encodings::jsonTo7BitText (header.toVarCondensed());
-
- detail::MessageTypeUtils::send (device->concreteBufferOutput,
- device->options.getFunctionBlock().firstGroup,
- source,
- ChannelInGroup::wholeBlock,
- Message::PropertySubscribeResponse { { request, headerBytes, 1, 1, {} } });
- };
-
- // Subscription events may be sent at any time by the responder, so there may not be
- // an existing transaction ID for new subscription messages.
- iter->second.responderPropertyCaches.primeCache (device->propertyDelegate.getNumSimultaneousRequestsSupported(),
- callback,
- subscription.requestID);
-
- iter->second.responderPropertyCaches.addChunk (subscription.requestID, subscription);
-
- return true;
- }
-
- bool messageReceived (const Message::PropertySubscribeResponse& response) const
- {
- handlePropertyDataResponse (response);
- return true;
- }
-
- bool messageReceived (const Message::PropertyNotify& notify) const
- {
- const auto responderMUID = output->getIncomingHeader().source;
- const auto iter = device->discovered.find (responderMUID);
-
- if (iter == device->discovered.end())
- return false;
-
- iter->second.initiatorPropertyCaches.notify (notify.requestID, notify.header);
- iter->second.responderPropertyCaches.notify (notify.requestID, notify.header);
-
- return true;
- }
-
-
- Impl* device = nullptr;
- ResponderOutput* output = nullptr;
- bool* handled = nullptr;
- };
-
- Impl* device = nullptr;
- };
-
- struct Discovered
- {
- explicit Discovered (Message::Discovery r) : discovery (r) {}
-
- Message::Discovery discovery;
- std::optional<Message::PropertyExchangeCapabilitiesResponse> propertyExchangeResponse;
- BlockProfileStates profileStates;
- InitiatorPropertyExchangeCache initiatorPropertyCaches;
- ResponderPropertyExchangeCache responderPropertyCaches;
- var resourceList, deviceInfo, channelList;
- std::set<Subscription> subscriptions; ///< subscribeIds of subscriptions that we initiated
- };
-
- class ConcreteBufferOutput : public BufferOutput
- {
- public:
- explicit ConcreteBufferOutput (Impl& d) : device (d) {}
-
- MUID getMuid() const override { return device.muid; }
- std::vector<std::byte>& getOutputBuffer() override { return device.outgoing; }
-
- void send (uint8_t group) override
- {
- sentMuid = true;
-
- for (auto* o : device.options.getOutputs())
- o->processMessage ({ group, getOutputBuffer() });
- }
-
- bool hasSentMuid() const { return sentMuid; }
- void resetSentMuid() { sentMuid = false; }
-
- private:
- Impl& device;
- bool sentMuid = false;
- };
-
- class CacheProviderImpl : public CacheProvider
- {
- public:
- explicit CacheProviderImpl (Impl& d) : device (d) {}
-
- std::set<MUID> getDiscoveredMuids() const override
- {
- std::set<MUID> result;
-
- for (const auto& d : device.discovered)
- result.insert (d.first);
-
- return result;
- }
-
- InitiatorPropertyExchangeCache* getCacheForMuidAsInitiator (MUID m) override
- {
- const auto iter = device.discovered.find (m);
- return iter != device.discovered.end() ? &iter->second.initiatorPropertyCaches : nullptr;
- }
-
- ResponderPropertyExchangeCache* getCacheForMuidAsResponder (MUID m) override
- {
- const auto iter = device.discovered.find (m);
- return iter != device.discovered.end() ? &iter->second.responderPropertyCaches : nullptr;
- }
-
- int getMaxSysexSizeForMuid (MUID m) const override
- {
- constexpr auto defaultResult = 1 << 16;
-
- const auto iter = device.discovered.find (m);
- return iter != device.discovered.end() ? jmin (defaultResult, (int) iter->second.discovery.maximumSysexSize) : defaultResult;
- }
-
- public:
- Impl& device;
- };
-
- class ProfileDelegateImpl : public ProfileDelegate
- {
- public:
- explicit ProfileDelegateImpl (Impl& d) : device (d) {}
-
- void profileEnablementRequested (MUID x, ProfileAtAddress profileAtAddress, int numChannels, bool enabled) override
- {
- if (auto* d = device.options.getProfileDelegate())
- return d->profileEnablementRequested (x, profileAtAddress, numChannels, enabled);
-
- if (! device.profileHost.has_value())
- return;
-
- if (enabled)
- device.profileHost->enableProfile (profileAtAddress, numChannels);
- else
- device.profileHost->disableProfile (profileAtAddress);
- }
-
- public:
- Impl& device;
- };
-
- class PropertyDelegateImpl : public PropertyDelegate
- {
- public:
- explicit PropertyDelegateImpl (Impl& d) : device (d) {}
-
- uint8_t getNumSimultaneousRequestsSupported() const override
- {
- if (auto* d = device.options.getPropertyDelegate())
- return d->getNumSimultaneousRequestsSupported();
-
- return 127;
- }
-
- PropertyReplyData propertyGetDataRequested (MUID m, const PropertyRequestHeader& header) override
- {
- if (auto* d = device.options.getPropertyDelegate())
- return d->propertyGetDataRequested (m, header);
-
- PropertyReplyData result;
- result.header.status = 404; // Resource not found, do not retry
- result.header.message = TRANS ("Handling for \"Inquiry: Get Property Data\" is not implemented.");
- return result;
- }
-
- PropertyReplyHeader propertySetDataRequested (MUID m, const PropertyRequestData& data) override
- {
- if (auto* d = device.options.getPropertyDelegate())
- return d->propertySetDataRequested (m, data);
-
- PropertyReplyHeader result;
- result.status = 404; // Resource not found, do not retry
- result.message = TRANS ("Handling for \"Inquiry: Set Property Data\" is not implemented.");
- return result;
- }
-
- bool subscriptionStartRequested (MUID m, const PropertySubscriptionHeader& data) override
- {
- if (auto* d = device.options.getPropertyDelegate())
- return d->subscriptionStartRequested (m, data);
-
- return false;
- }
-
- void subscriptionDidStart (MUID m, const String& id, const PropertySubscriptionHeader& data) override
- {
- if (auto* d = device.options.getPropertyDelegate())
- d->subscriptionDidStart (m, id, data);
- }
-
- void subscriptionWillEnd (MUID m, const ci::Subscription& subscription) override
- {
- if (auto* d = device.options.getPropertyDelegate())
- d->subscriptionWillEnd (m, subscription);
- }
-
- public:
- Impl& device;
- };
-
- static MUID getReallyRandomMuid()
- {
- Random random;
- random.setSeedRandomly();
- return MUID::makeRandom (random);
- }
-
- static DeviceOptions getValidated (DeviceOptions opt)
- {
- opt = opt.withMaxSysExSize (jmax ((size_t) 128, opt.getMaxSysExSize()));
-
- if (opt.getFeatures().isPropertyExchangeSupported())
- opt = opt.withMaxSysExSize (jmax ((size_t) 512, opt.getMaxSysExSize()));
-
- opt = opt.withFeatures (opt.getFeatures().withProcessInquirySupported (false));
-
- // You'll need to provide some outputs if you want the device to talk to the outside world!
- jassert (! opt.getOutputs().empty());
-
- return opt;
- }
-
- template <typename Member>
- bool supportsFlag (MUID m, Member member) const
- {
- const auto iter = discovered.find (m);
- return iter != discovered.end() && (Features (iter->second.discovery.capabilities).*member)();
- }
-
- bool supportsProfiles (MUID m) const
- {
- return supportsFlag (m, &Features::isProfileConfigurationSupported);
- }
-
- bool supportsProperties (MUID m) const
- {
- return supportsFlag (m, &Features::isPropertyExchangeSupported);
- }
-
- void inquirePropertySubscribe (MUID m,
- const PropertySubscriptionHeader& header,
- std::function<void (const PropertyExchangeResult&)> cb)
- {
- const auto iter = discovered.find (m);
-
- if (iter == discovered.end() || ! Features { iter->second.discovery.capabilities }.isPropertyExchangeSupported())
- {
- // Trying to send a subscription message to a device that doesn't exist (maybe it got removed), or
- // that doesn't support property exchange.
- jassertfalse;
- return;
- }
-
- auto primed = iter->second.initiatorPropertyCaches.primeCache (propertyDelegate.getNumSimultaneousRequestsSupported(),
- std::move (cb),
- detail::PropertyHostUtils::getTerminator (concreteBufferOutput, options.getFunctionBlock(), m));
-
- if (! primed.isValid())
- return;
-
- detail::PropertyHostUtils::send (concreteBufferOutput,
- options.getFunctionBlock().firstGroup,
- detail::MessageMeta::Meta<Message::PropertySubscribe>::subID2,
- m,
- primed.id,
- Encodings::jsonTo7BitText (header.toVarCondensed()),
- {},
- cacheProvider.getMaxSysexSizeForMuid (m));
- }
-
- DeviceOptions options;
- MUID muid;
- std::vector<std::byte> outgoing;
- std::map<MUID, Discovered> discovered;
- ListenerList<Listener> listeners;
- ConcreteBufferOutput concreteBufferOutput { *this };
- CacheProviderImpl cacheProvider { *this };
- ProfileDelegateImpl profileDelegate { *this };
- PropertyDelegateImpl propertyDelegate { *this };
- std::optional<ProfileHost> profileHost;
- std::optional<PropertyHost> propertyHost;
- std::list<ErasedScopeGuard> ongoingTransactions;
- };
-
- //==============================================================================
- Device::Device (const Options& opt) : pimpl (std::make_unique<Impl> (opt)) {}
- Device::~Device() = default;
- Device::Device (Device&&) noexcept = default;
- Device& Device::operator= (Device&&) noexcept = default;
-
- void Device::processMessage (ump::BytesOnGroup msg) { pimpl->processMessage (msg); }
- void Device::sendDiscovery() { pimpl->sendDiscovery(); }
- void Device::sendEndpointInquiry (MUID destination, Message::EndpointInquiry endpoint) { pimpl->sendEndpointInquiry (destination, endpoint); }
- void Device::sendProfileInquiry (MUID destination, ChannelInGroup address) { pimpl->sendProfileInquiry (destination, address); }
- void Device::sendProfileDetailsInquiry (MUID destination, ChannelInGroup address, Profile profile, std::byte target)
- {
- pimpl->sendProfileDetailsInquiry (destination, address, profile, target);
- }
- void Device::sendProfileSpecificData (MUID destination, ChannelInGroup address, Profile profile, Span<const std::byte> data)
- {
- pimpl->sendProfileSpecificData (destination, address, profile, data);
- }
- void Device::sendProfileEnablement (MUID destination, ChannelInGroup address, Profile profile, int numChannels)
- {
- pimpl->sendProfileEnablement (destination, address, profile, numChannels);
- }
- void Device::sendPropertyCapabilitiesInquiry (MUID destination)
- {
- pimpl->sendPropertyCapabilitiesInquiry (destination);
- }
- ErasedScopeGuard Device::sendPropertyGetInquiry (MUID destination,
- const PropertyRequestHeader& header,
- std::function<void (const PropertyExchangeResult&)> onResult)
- {
- return pimpl->sendPropertyGetInquiry (destination, header, std::move (onResult));
- }
- void Device::sendPropertySetInquiry (MUID destination,
- const PropertyRequestHeader& header,
- Span<const std::byte> body,
- std::function<void (const PropertyExchangeResult&)> onResult)
- {
- pimpl->sendPropertySetInquiry (destination, header, body, std::move (onResult));
- }
- void Device::sendPropertySubscriptionStart (MUID destination,
- const PropertySubscriptionHeader& header,
- std::function<void (const PropertyExchangeResult&)> onResult)
- {
- pimpl->sendPropertySubscriptionStart (destination, header, std::move (onResult));
- }
- void Device::sendPropertySubscriptionEnd (MUID destination,
- const String& subscribeId,
- std::function<void (const PropertyExchangeResult&)> onResult)
- {
- pimpl->sendPropertySubscriptionEnd (destination, subscribeId, std::move (onResult));
- }
- std::vector<Subscription> Device::getOngoingSubscriptionsForMuid (MUID m) const { return pimpl->getOngoingSubscriptionsForMuid (m); }
- int Device::countOngoingPropertyTransactions() const { return pimpl->countOngoingPropertyTransactions(); }
- void Device::addListener (Listener& l) { pimpl->addListener (l); }
- void Device::removeListener (Listener& l) { pimpl->removeListener (l); }
- MUID Device::getMuid() const { return pimpl->getMuid(); }
- DeviceOptions Device::getOptions() const { return pimpl->getOptions(); }
- std::vector<MUID> Device::getDiscoveredMuids() const { return pimpl->getDiscoveredMuids(); }
- const ProfileHost* Device::getProfileHost() const { return pimpl->getProfileHost(); }
- ProfileHost* Device::getProfileHost() { return pimpl->getProfileHost(); }
- const PropertyHost* Device::getPropertyHost() const { return pimpl->getPropertyHost(); }
- PropertyHost* Device::getPropertyHost() { return pimpl->getPropertyHost(); }
- std::optional<Message::Discovery> Device::getDiscoveryInfoForMuid (MUID m) const { return pimpl->getDiscoveryInfoForMuid (m); }
- const ChannelProfileStates* Device::getProfileStateForMuid (MUID m, ChannelAddress address) const { return pimpl->getProfileStateForMuid (m, address); }
- std::optional<int> Device::getNumPropertyExchangeRequestsSupportedForMuid (MUID m) const
- {
- return pimpl->getNumPropertyExchangeRequestsSupportedForMuid (m);
- }
- var Device::getResourceListForMuid (MUID x) const { return pimpl->getResourceListForMuid (x); }
- var Device::getDeviceInfoForMuid (MUID x) const { return pimpl->getDeviceInfoForMuid (x); }
- var Device::getChannelListForMuid (MUID x) const { return pimpl->getChannelListForMuid (x); }
-
- //==============================================================================
- //==============================================================================
- #if JUCE_UNIT_TESTS
-
- class DeviceTests : public UnitTest
- {
- public:
- DeviceTests() : UnitTest ("Device", UnitTestCategories::midi) {}
-
- void runTest() override
- {
- auto random = getRandom();
-
- struct GroupOutput
- {
- uint8_t group;
- std::vector<std::byte> bytes;
-
- bool operator== (const GroupOutput& other) const
- {
- const auto tie = [] (const auto& x) { return std::tie (x.group, x.bytes); };
- return tie (*this) == tie (other);
- }
-
- bool operator!= (const GroupOutput& other) const { return ! operator== (other); }
- };
-
- struct Output : public DeviceMessageHandler
- {
- void processMessage (ump::BytesOnGroup msg) override
- {
- messages.push_back ({ msg.group, std::vector<std::byte> (msg.bytes.begin(), msg.bytes.end()) });
- }
-
- std::vector<GroupOutput> messages;
- };
-
- const ump::DeviceInfo deviceInfo { { std::byte { 0x01 }, std::byte { 0x02 }, std::byte { 0x03 } },
- { std::byte { 0x11 }, std::byte { 0x12 } },
- { std::byte { 0x21 }, std::byte { 0x22 } },
- { std::byte { 0x31 }, std::byte { 0x32 }, std::byte { 0x33 }, std::byte { 0x34 } } };
-
- FunctionBlock functionBlock;
-
- beginTest ("When receiving Discovery from a MUID that matches the Device MUID, reply with InvalidateMUID and initiate discovery");
- {
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512);
- Device device { options };
-
- const auto commonMUID = device.getMuid();
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::Discovery>::subID2,
- detail::MessageMeta::implementationVersion,
- commonMUID,
- MUID::getBroadcast() },
- Message::Discovery { ump::DeviceInfo { { std::byte { 0x05 }, std::byte { 0x06 }, std::byte { 0x07 } },
- { std::byte { 0x15 }, std::byte { 0x16 } },
- { std::byte { 0x25 }, std::byte { 0x26 } },
- { std::byte { 0x35 }, std::byte { 0x36 }, std::byte { 0x37 }, std::byte { 0x38 } } },
- std::byte{},
- 1024,
- std::byte{} }) });
-
- expect (device.getMuid() != commonMUID);
- const std::vector<GroupOutput> responses
- {
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::InvalidateMUID>::subID2,
- detail::MessageMeta::implementationVersion,
- commonMUID,
- MUID::getBroadcast() },
- Message::InvalidateMUID { commonMUID }) },
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::Discovery>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- MUID::getBroadcast() },
- Message::Discovery { deviceInfo, std::byte{}, 512, std::byte{} }) },
- };
- expect (output.messages == responses);
- }
-
- beginTest ("When receiving Discovery from a MUID that does not match the Device MUID, reply with DiscoveryResponse and EndpointInquiry");
- {
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512);
- Device device { options };
-
- const auto responderMUID = device.getMuid();
- const auto initiatorMUID = MUID::makeRandom (random);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::Discovery>::subID2,
- detail::MessageMeta::implementationVersion,
- initiatorMUID,
- MUID::getBroadcast() },
- Message::Discovery { ump::DeviceInfo { { std::byte { 0x05 }, std::byte { 0x06 }, std::byte { 0x07 } },
- { std::byte { 0x15 }, std::byte { 0x16 } },
- { std::byte { 0x25 }, std::byte { 0x26 } },
- { std::byte { 0x35 }, std::byte { 0x36 }, std::byte { 0x37 }, std::byte { 0x38 } } },
- std::byte{},
- 1024,
- std::byte{} }) });
-
- expect (device.getMuid() == responderMUID);
- const std::vector<GroupOutput> responses
- {
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::DiscoveryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- initiatorMUID },
- Message::DiscoveryResponse { deviceInfo, std::byte{}, 512, std::byte{}, std::byte { 0x7f } }) },
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::EndpointInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- initiatorMUID },
- Message::EndpointInquiry { std::byte{} }) },
- };
- expect (output.messages == responses);
- }
-
- beginTest ("Sending a V1 discovery message notifies the listener");
- {
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512);
- Device device { options };
-
- const auto responderMUID = device.getMuid();
- const auto initiatorMUID = MUID::makeRandom (random);
- constexpr uint8_t version = 0x01;
-
- auto bytes = getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::Discovery>::subID2,
- std::byte { version },
- initiatorMUID,
- MUID::getBroadcast() },
- Message::Discovery { ump::DeviceInfo { { std::byte { 0x05 }, std::byte { 0x06 }, std::byte { 0x07 } },
- { std::byte { 0x15 }, std::byte { 0x16 } },
- { std::byte { 0x25 }, std::byte { 0x26 } },
- { std::byte { 0x35 }, std::byte { 0x36 }, std::byte { 0x37 }, std::byte { 0x38 } } },
- std::byte{},
- 1024,
- std::byte{} });
-
- // V1 message doesn't have an output path
- bytes.pop_back();
- device.processMessage ({ 0, bytes });
-
- expect (device.getMuid() == responderMUID);
- const std::vector<GroupOutput> responses
- {
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::DiscoveryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- initiatorMUID },
- Message::DiscoveryResponse { deviceInfo, std::byte{}, 512, std::byte{}, std::byte { 0x7f } }) },
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::EndpointInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- initiatorMUID },
- Message::EndpointInquiry { std::byte{} }) },
- };
- expect (output.messages == responses);
- }
-
- beginTest ("Sending a V2 discovery message notifies the input listener");
- {
- constexpr std::byte outputPathID { 5 };
- const auto initiatorMUID = MUID::makeRandom (random);
- constexpr std::byte version { 0x02 };
-
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512);
- Device device { options };
-
- const auto responderMUID = device.getMuid();
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::Discovery>::subID2,
- version,
- initiatorMUID,
- MUID::getBroadcast() },
- Message::Discovery { ump::DeviceInfo { { std::byte { 0x05 }, std::byte { 0x06 }, std::byte { 0x07 } },
- { std::byte { 0x15 }, std::byte { 0x16 } },
- { std::byte { 0x25 }, std::byte { 0x26 } },
- { std::byte { 0x35 }, std::byte { 0x36 }, std::byte { 0x37 }, std::byte { 0x38 } } },
- std::byte{},
- 1024,
- outputPathID }) });
-
- expect (device.getMuid() == responderMUID);
- const std::vector<GroupOutput> responses
- {
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::DiscoveryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- initiatorMUID },
- Message::DiscoveryResponse { deviceInfo, std::byte{}, 512, outputPathID, std::byte { 0x7f } }) },
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::EndpointInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- initiatorMUID },
- Message::EndpointInquiry { std::byte{} }) },
- };
- expect (output.messages == responses);
- }
-
- beginTest ("Sending a discovery message with a future version notifies the input listener and ignores trailing fields");
- {
- constexpr std::byte outputPathID { 10 };
- const auto initiatorMUID = MUID::makeRandom (random);
- constexpr std::byte version { 0x03 };
-
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512);
- Device device { options };
-
- const auto responderMUID = device.getMuid();
-
- auto bytes = getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::Discovery>::subID2,
- version,
- initiatorMUID,
- MUID::getBroadcast() },
- Message::Discovery { ump::DeviceInfo { { std::byte { 0x05 }, std::byte { 0x06 }, std::byte { 0x07 } },
- { std::byte { 0x15 }, std::byte { 0x16 } },
- { std::byte { 0x25 }, std::byte { 0x26 } },
- { std::byte { 0x35 }, std::byte { 0x36 }, std::byte { 0x37 }, std::byte { 0x38 } } },
- std::byte{},
- 1024,
- outputPathID });
-
- // Future versions might have more trailing bytes
- bytes.insert (bytes.end(), { std::byte{}, std::byte{} });
- device.processMessage ({ 0, bytes });
-
- expect (device.getMuid() == responderMUID);
- const std::vector<GroupOutput> responses
- {
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::DiscoveryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- initiatorMUID },
- Message::DiscoveryResponse { deviceInfo, std::byte{}, 512, outputPathID, std::byte { 0x7f } }) },
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::EndpointInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- initiatorMUID },
- Message::EndpointInquiry { std::byte{} }) },
- };
- expect (output.messages == responses);
- }
-
- beginTest ("When receiving an InvalidateMUID that matches the Device MUID, initiate discovery using a new MUID");
- {
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512);
- Device device { options };
-
- const auto deviceMUID = device.getMuid();
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::InvalidateMUID>::subID2,
- detail::MessageMeta::implementationVersion,
- MUID::makeRandom (random),
- MUID::getBroadcast() },
- Message::InvalidateMUID { deviceMUID }) });
-
- expect (device.getMuid() != deviceMUID);
-
- expect (Parser::parse (MUID::makeRandom (random), output.messages.front().bytes) == Message::Parsed { { ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::Discovery>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- MUID::getBroadcast() },
- Message::Discovery { deviceInfo,
- {},
- 512,
- {} } });
- }
-
- struct Listener : public DeviceListener
- {
- void deviceAdded (MUID x) override { added .push_back (x); }
- void deviceRemoved (MUID x) override { removed.push_back (x); }
-
- std::vector<MUID> added, removed;
- };
-
- beginTest ("When receiving a DiscoveryResponse, update the set of known devices, notify outputs, and request endpoint info");
- {
- Listener delegate;
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512);
- Device device { options };
- device.addListener (delegate);
-
- expect (device.getDiscoveredMuids().empty());
-
- const auto deviceMUID = device.getMuid();
- const auto responderMUID = MUID::makeRandom (random);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::DiscoveryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- deviceMUID },
- Message::DiscoveryResponse { deviceInfo, std::byte{}, 512, std::byte{}, std::byte { 0x7f } }) });
-
- expect (device.getDiscoveredMuids() == std::vector { responderMUID });
- expect (delegate.added == std::vector { responderMUID });
-
- std::vector<GroupOutput> responses
- {
- { 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::EndpointInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- deviceMUID,
- responderMUID },
- Message::EndpointInquiry { std::byte{} }) },
- };
- expect (output.messages == responses);
-
- beginTest ("When receiving a DiscoveryResponse with a MUID that matches a known device, invalidate that MUID");
- {
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::DiscoveryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- deviceMUID },
- Message::DiscoveryResponse { deviceInfo, std::byte{}, 512, std::byte{}, std::byte { 0x7f } }) });
-
- expect (device.getDiscoveredMuids().empty());
- expect (delegate.removed == std::vector { responderMUID });
-
- responses.push_back ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::InvalidateMUID>::subID2,
- detail::MessageMeta::implementationVersion,
- deviceMUID,
- MUID::getBroadcast() },
- Message::InvalidateMUID { responderMUID }) });
- expect (output.messages == responses);
- }
- }
-
- beginTest ("After receiving an EndpointResponse, the listener is notified");
- {
- static constexpr std::byte dataBytes[] { std::byte { 0x01 }, std::byte { 0x7f }, std::byte { 0x41 } };
-
- struct EndpointListener : public DeviceListener
- {
- EndpointListener (UnitTest& t, Device& d) : test (t), device (d) {}
-
- void endpointReceived (MUID, Message::EndpointInquiryResponse) override { called = true; }
-
- UnitTest& test;
- Device& device;
- bool called = false;
- };
-
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512);
- Device device { options };
-
- EndpointListener delegate { *this, device };
- device.addListener (delegate);
-
- const auto responderMUID = MUID::makeRandom (random);
- const auto deviceMUID = device.getMuid();
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::DiscoveryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- deviceMUID },
- Message::DiscoveryResponse { deviceInfo, std::byte{}, 512, std::byte{}, std::byte { 0x7f } }) });
-
- expect (! delegate.called);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::EndpointInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- responderMUID,
- deviceMUID },
- Message::EndpointInquiryResponse { std::byte{}, dataBytes }) });
-
- expect (delegate.called);
- }
-
- beginTest ("If a device has not previously acted as a responder, modifying profiles does not emit events");
- {
- Output output;
-
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withProfileConfigurationSupported (true));
- Device device { options };
-
- expect (device.getProfileHost() != nullptr);
-
- const Profile profile { std::byte { 0x01 },
- std::byte { 0x02 },
- std::byte { 0x03 },
- std::byte { 0x04 },
- std::byte { 0x05 } };
-
- device.getProfileHost()->addProfile ({ profile, ChannelAddress{}.withChannel (ChannelInGroup::wholeBlock) });
-
- expect (output.messages.empty());
-
- beginTest ("The device reports profiles accurately");
- {
- const auto inquiryMUID = MUID::makeRandom (random);
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileInquiry{}) });
-
- const Profile disabledProfiles[] { profile };
- expect (output.messages.size() == 1);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, disabledProfiles }));
- }
-
- beginTest ("If a device has previously acted as a responder to profile inquiry, then modifying profiles emits events");
- {
- const auto numChannels = 0;
- device.getProfileHost()->enableProfile ({ profile, ChannelAddress{}.withChannel (ChannelInGroup::wholeBlock) }, numChannels);
-
- expect (output.messages.size() == 2);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileEnabledReport>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- MUID::getBroadcast() },
- Message::ProfileEnabledReport { profile, numChannels }));
- }
- }
-
- beginTest ("If a device receives a details inquiry message addressed to an unsupported profile, a NAK with a code of 0x04 is emitted");
- {
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withProfileConfigurationSupported (true));
- Device device { options };
-
- expect (device.getProfileHost() != nullptr);
-
- const auto inquiryMUID = MUID::makeRandom (random);
-
- const Profile profile { std::byte { 0x01 },
- std::byte { 0x02 },
- std::byte { 0x03 },
- std::byte { 0x04 },
- std::byte { 0x05 } };
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileDetails>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileDetails { profile, std::byte { 0x02 } }) });
-
- expect (output.messages.size() == 1);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::NAK>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::NAK { detail::MessageMeta::Meta<Message::ProfileDetails>::subID2,
- std::byte { 0x04 },
- {},
- {},
- {} }));
- }
-
- beginTest ("If a device receives a set profile on and enables the profile, profile enabled report is emitted");
- {
- // Note: if there's no explicit profile delegate, the device will toggle profiles as requested.
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withProfileConfigurationSupported (true));
- Device device { options };
- expect (device.getProfileHost() != nullptr);
-
- const Profile profile { std::byte { 0x01 },
- std::byte { 0x02 },
- std::byte { 0x03 },
- std::byte { 0x04 },
- std::byte { 0x05 } };
-
- device.getProfileHost()->addProfile ({ profile, ChannelAddress{}.withChannel (ChannelInGroup::wholeBlock) });
-
- const auto inquiryMUID = MUID::makeRandom (random);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileOn>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileOn { profile, 1 }) });
-
- expect (output.messages.size() == 1);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileEnabledReport>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- MUID::getBroadcast() },
- Message::ProfileEnabledReport { profile, 1 }));
- }
-
- struct DoNothingProfileDelegate : public ProfileDelegate
- {
- void profileEnablementRequested (MUID, ProfileAtAddress, int, bool) override {}
- };
-
- beginTest ("If a device receives a set profile on but then doesn't enable the profile, profile disabled report is emitted");
- {
- DoNothingProfileDelegate delegate;
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withProfileConfigurationSupported (true))
- .withProfileDelegate (&delegate);
- Device device { options };
-
- expect (device.getProfileHost() != nullptr);
-
- const Profile profile { std::byte { 0x01 },
- std::byte { 0x02 },
- std::byte { 0x03 },
- std::byte { 0x04 },
- std::byte { 0x05 } };
-
- device.getProfileHost()->addProfile ({ profile, ChannelAddress{}.withChannel (ChannelInGroup::wholeBlock) });
-
- const auto inquiryMUID = MUID::makeRandom (random);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileOn>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileOn { profile, 1 }) });
-
- expect (output.messages.size() == 1);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileDisabledReport>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- MUID::getBroadcast() },
- Message::ProfileDisabledReport { profile, {} }));
- }
-
- beginTest ("If a device receives a set profile on for an unsupported profile, NAK is emitted");
- {
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withProfileConfigurationSupported (true));
- Device device { options };
-
- expect (device.getProfileHost() != nullptr);
-
- const Profile profile { std::byte { 0x01 },
- std::byte { 0x02 },
- std::byte { 0x03 },
- std::byte { 0x04 },
- std::byte { 0x05 } };
-
- const auto inquiryMUID = MUID::makeRandom (random);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileOn>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileOn { profile, 1 }) });
-
- expect (output.messages.size() == 1);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::NAK>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::NAK { detail::MessageMeta::Meta<Message::ProfileOn>::subID2,
- {},
- {},
- {},
- {} }));
- }
-
- beginTest ("If a device receives a set profile off and disables the profile, profile disabled report is emitted");
- {
- // Note: if there's no explicit profile delegate, the device will toggle profiles as requested.
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withProfileConfigurationSupported (true));
- Device device { options };
-
- expect (device.getProfileHost() != nullptr);
-
- const Profile profile { std::byte { 0x01 },
- std::byte { 0x02 },
- std::byte { 0x03 },
- std::byte { 0x04 },
- std::byte { 0x05 } };
-
- device.getProfileHost()->addProfile ({ profile, ChannelAddress{}.withChannel (ChannelInGroup::wholeBlock) });
- device.getProfileHost()->enableProfile ({ profile, ChannelAddress{}.withChannel (ChannelInGroup::wholeBlock) }, 0);
-
- const auto inquiryMUID = MUID::makeRandom (random);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileOff>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileOff { profile }) });
-
- expect (output.messages.size() == 1);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileDisabledReport>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- MUID::getBroadcast() },
- Message::ProfileDisabledReport { profile, {} }));
- }
-
- beginTest ("If a device receives a set profile off but then doesn't disable the profile, profile enabled report is emitted");
- {
- Output output;
- DoNothingProfileDelegate delegate;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withProfileConfigurationSupported (true))
- .withProfileDelegate (&delegate);
- Device device { options };
-
- expect (device.getProfileHost() != nullptr);
-
- const Profile profile { std::byte { 0x01 },
- std::byte { 0x02 },
- std::byte { 0x03 },
- std::byte { 0x04 },
- std::byte { 0x05 } };
-
- device.getProfileHost()->addProfile ({ profile, ChannelAddress{}.withChannel (ChannelInGroup::wholeBlock) });
- device.getProfileHost()->enableProfile ({ profile, ChannelAddress{}.withChannel (ChannelInGroup::wholeBlock) }, 1);
-
- const auto inquiryMUID = MUID::makeRandom (random);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileOff>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileOff { profile }) });
-
- expect (output.messages.size() == 1);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileEnabledReport>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- MUID::getBroadcast() },
- Message::ProfileEnabledReport { profile, 1 }));
- }
-
- beginTest ("If a device receives a set profile off for an unsupported profile, NAK is emitted");
- {
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (functionBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withProfileConfigurationSupported (true));
- Device device { options };
-
- expect (device.getProfileHost() != nullptr);
-
- const Profile profile { std::byte { 0x01 },
- std::byte { 0x02 },
- std::byte { 0x03 },
- std::byte { 0x04 },
- std::byte { 0x05 } };
-
- const auto inquiryMUID = MUID::makeRandom (random);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileOff>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileOff { profile }) });
-
- expect (output.messages.size() == 1);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::NAK>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::NAK { detail::MessageMeta::Meta<Message::ProfileOff>::subID2,
- {},
- {},
- {},
- {} }));
- }
-
- const FunctionBlock realBlock { std::byte{}, 0, 3 };
-
- beginTest ("If a device receives a profile inquiry addressed to a channel, that channel's profiles are emitted");
- {
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (realBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withProfileConfigurationSupported (true));
- Device device { options };
-
- auto& profileHost = *device.getProfileHost();
-
- Profile channel0Profile { std::byte { 0x01 } };
- Profile channel1Profile { std::byte { 0x02 } };
-
- profileHost.addProfile ({ channel0Profile, ChannelAddress{}.withChannel (ChannelInGroup::channel0) });
- profileHost.addProfile ({ channel1Profile, ChannelAddress{}.withChannel (ChannelInGroup::channel1) });
-
- const auto inquiryMUID = MUID::makeRandom (random);
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::channel0,
- detail::MessageMeta::Meta<Message::ProfileInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileInquiry{}) });
-
- const Profile channel0Profiles[] { channel0Profile };
- const Profile channel1Profiles[] { channel1Profile };
-
- expect (output.messages.size() == 1);
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::channel0,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, channel0Profiles }));
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::channel2,
- detail::MessageMeta::Meta<Message::ProfileInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileInquiry{}) });
-
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::channel2,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, {} }));
-
- Profile group0Profile { std::byte { 0x05 } };
- Profile group1Profile { std::byte { 0x06 } };
- const Profile group0Profiles[] { group0Profile };
- const Profile group1Profiles[] { group1Profile };
-
- beginTest ("If a device receives a profile inquiry addressed to a group, that group's profiles are emitted");
- {
- profileHost.addProfile ({ group0Profile, ChannelAddress{}.withGroup (0).withChannel (ChannelInGroup::wholeGroup) });
- profileHost.addProfile ({ group1Profile, ChannelAddress{}.withGroup (1).withChannel (ChannelInGroup::wholeGroup) });
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeGroup,
- detail::MessageMeta::Meta<Message::ProfileInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileInquiry{}) });
-
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeGroup,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, group0Profiles }));
-
- device.processMessage ({ 2, getMessageBytes ({ ChannelInGroup::wholeGroup,
- detail::MessageMeta::Meta<Message::ProfileInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileInquiry{}) });
-
- expect (output.messages.back().bytes == getMessageBytes ({ ChannelInGroup::wholeGroup,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, {} }));
- }
-
- beginTest ("If a device receives a profile inquiry addressed to a block, the profiles for member channels, then member groups, then the block are emitted");
- {
- Profile blockProfile { std::byte { 0x0a } };
-
- profileHost.addProfile ({ blockProfile, ChannelAddress{}.withChannel (ChannelInGroup::wholeBlock) });
-
- output.messages.clear();
-
- device.processMessage ({ 1, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileInquiry>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::ProfileInquiry{}) });
-
- const Profile blockProfiles[] { blockProfile };
-
- expect (output.messages == std::vector<GroupOutput> { { 0, getMessageBytes ({ ChannelInGroup::channel0,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, channel0Profiles }) },
- { 0, getMessageBytes ({ ChannelInGroup::channel1,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, channel1Profiles }) },
- { 0, getMessageBytes ({ ChannelInGroup::wholeGroup,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, group0Profiles }) },
- { 1, getMessageBytes ({ ChannelInGroup::wholeGroup,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, group1Profiles }) },
- { 1, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::ProfileInquiryResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID },
- Message::ProfileInquiryResponse { {}, blockProfiles }) } });
- }
- }
-
- // Property exchange
- {
- const auto inquiryMUID = MUID::makeRandom (random);
-
- struct Delegate : public PropertyDelegate
- {
- uint8_t getNumSimultaneousRequestsSupported() const override { return 1; }
- PropertyReplyData propertyGetDataRequested (MUID, const PropertyRequestHeader&) override { return {}; }
- PropertyReplyHeader propertySetDataRequested (MUID, const PropertyRequestData&) override { return {}; }
- bool subscriptionStartRequested (MUID, const PropertySubscriptionHeader&) override { return true; }
- void subscriptionDidStart (MUID, const String&, const PropertySubscriptionHeader&) override {}
- void subscriptionWillEnd (MUID, const Subscription&) override {}
- };
-
- Delegate delegate;
- Output output;
- const auto options = DeviceOptions().withOutputs ({ &output })
- .withFunctionBlock (realBlock)
- .withDeviceInfo (deviceInfo)
- .withMaxSysExSize (512)
- .withFeatures (DeviceFeatures{}.withPropertyExchangeSupported (true))
- .withPropertyDelegate (&delegate);
- Device device { options };
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::Discovery>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- MUID::getBroadcast() },
- Message::Discovery { {}, DeviceFeatures{}.withPropertyExchangeSupported (true).getSupportedCapabilities(), 512, {} }) });
-
- expect (output.messages.size() == 2);
- output.messages.clear();
-
- beginTest ("If a device receives too many concurrent property exchange requests, it responds with a retry status code.");
- {
- auto obj = std::make_unique<DynamicObject>();
- obj->setProperty ("resource", "X-CustomProp");
- const auto header = Encodings::jsonTo7BitText (obj.release());
-
- for (const auto& requestID : { std::byte { 0 }, std::byte { 1 } })
- {
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::PropertySetData>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::PropertySetData { { requestID, header, 0, 1, {} } }) });
- }
-
- expect (output.messages.size() == 1);
- const auto parsed = Parser::parse (output.messages.back().bytes);
-
- expect (parsed.has_value());
- expect (parsed->header == Message::Header { ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::PropertySetDataResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID });
-
- auto* body = std::get_if<Message::PropertySetDataResponse> (&parsed->body);
- expect (body != nullptr);
- expect (body->requestID == std::byte { 1 });
- auto replyHeader = Encodings::jsonFrom7BitText (body->header);
- expect (replyHeader.getProperty ("status", "") == var (343));
- }
-
- // Terminate ongoing message
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::PropertySetData>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::PropertySetData { { {}, {}, 0, 0, {} } }) });
- output.messages.clear();
-
- beginTest ("If a device receives an unexpectedly-terminated request, it responds with an error status code.");
- {
- auto obj = std::make_unique<DynamicObject>();
- obj->setProperty ("resource", "X-CustomProp");
- const auto header = Encodings::jsonTo7BitText (obj.release());
- const std::byte requestID { 3 };
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::PropertySetData>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::PropertySetData { { requestID, header, 2, 1, {} } }) });
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::PropertySetData>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::PropertySetData { { requestID, header, 2, 0, {} } }) });
-
- expect (output.messages.size() == 1);
- const auto parsed = Parser::parse (output.messages.back().bytes);
-
- expect (parsed.has_value());
- expect (parsed->header == Message::Header { ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::PropertySetDataResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID });
-
- auto* body = std::get_if<Message::PropertySetDataResponse> (&parsed->body);
- expect (body != nullptr);
- expect (body->requestID == requestID);
- auto replyHeader = Encodings::jsonFrom7BitText (body->header);
- expect (replyHeader.getProperty ("status", "") == var (400));
- }
-
- output.messages.clear();
-
- beginTest ("If a request is terminated via notify, the device responds with an error status code.");
- {
- auto obj = std::make_unique<DynamicObject>();
- obj->setProperty ("resource", "X-CustomProp");
- const auto header = Encodings::jsonTo7BitText (obj.release());
- const std::byte requestID { 100 };
-
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::PropertySetData>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::PropertySetData { { requestID, header, 2, 1, {} } }) });
-
- auto notifyHeader = std::make_unique<DynamicObject>();
- notifyHeader->setProperty ("status", 144);
- device.processMessage ({ 0, getMessageBytes ({ ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::PropertyNotify>::subID2,
- detail::MessageMeta::implementationVersion,
- inquiryMUID,
- device.getMuid() },
- Message::PropertyNotify { { requestID, Encodings::jsonTo7BitText (notifyHeader.release()), 1, 1, {} } }) });
-
- expect (output.messages.size() == 1);
- const auto parsed = Parser::parse (output.messages.back().bytes);
-
- expect (parsed.has_value());
- expect (parsed->header == Message::Header { ChannelInGroup::wholeBlock,
- detail::MessageMeta::Meta<Message::PropertySetDataResponse>::subID2,
- detail::MessageMeta::implementationVersion,
- device.getMuid(),
- inquiryMUID });
-
- auto* body = std::get_if<Message::PropertySetDataResponse> (&parsed->body);
- expect (body != nullptr);
- expect (body->requestID == requestID);
- auto replyHeader = Encodings::jsonFrom7BitText (body->header);
- expect (replyHeader.getProperty ("status", "") == var (400));
- }
- }
- }
-
- private:
- template <typename Msg>
- static std::vector<std::byte> getMessageBytes (const Message::Header& header, const Msg& body)
- {
- std::vector<std::byte> bytes;
- detail::Marshalling::Writer { bytes } (header, body);
- return bytes;
- }
- };
-
- static DeviceTests deviceTests;
-
- #endif
-
- } // namespace juce::midi_ci
|