//----------------------------------------------------------------------------- // // Manager.cpp // // The main public interface to OpenZWave. // // Copyright (c) 2010 Mal Lansell // // SOFTWARE NOTICE AND LICENSE // // This file is part of OpenZWave. // // OpenZWave is free software: you can redistribute it and/or modify // it under the terms of the GNU Lesser General Public License as published // by the Free Software Foundation, either version 3 of the License, // or (at your option) any later version. // // OpenZWave is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public License // along with OpenZWave. If not, see . // //----------------------------------------------------------------------------- #include #include #include #include "Defs.h" #include "Manager.h" #include "Driver.h" #include "Node.h" #include "Notification.h" #include "Options.h" #include "Scene.h" #include "platform/Mutex.h" #include "platform/Event.h" #include "platform/Log.h" #include "command_classes/CommandClasses.h" #include "command_classes/CommandClass.h" #include "command_classes/WakeUp.h" #include "value_classes/ValueID.h" #include "value_classes/ValueBool.h" #include "value_classes/ValueButton.h" #include "value_classes/ValueByte.h" #include "value_classes/ValueDecimal.h" #include "value_classes/ValueInt.h" #include "value_classes/ValueList.h" #include "value_classes/ValueRaw.h" #include "value_classes/ValueSchedule.h" #include "value_classes/ValueShort.h" #include "value_classes/ValueString.h" using namespace OpenZWave; Manager* Manager::s_instance = NULL; extern uint16_t ozw_vers_major; extern uint16_t ozw_vers_minor; extern uint16_t ozw_vers_revision; //----------------------------------------------------------------------------- // Construction //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Static creation of the singleton //----------------------------------------------------------------------------- Manager* Manager::Create ( ) { if( Options::Get() && Options::Get()->AreLocked() ) { if( NULL == s_instance ) { s_instance = new Manager(); } return s_instance; } // Options have not been created and locked. Log::Create( "", false, true, LogLevel_Debug, LogLevel_Debug, LogLevel_None ); Log::Write( LogLevel_Error, "Options have not been created and locked. Exiting..." ); OZW_FATAL_ERROR(OZWException::OZWEXCEPTION_OPTIONS, "Options Not Created and Locked"); return NULL; } //----------------------------------------------------------------------------- // // Static method to destroy the singleton. //----------------------------------------------------------------------------- void Manager::Destroy ( ) { delete s_instance; s_instance = NULL; } //----------------------------------------------------------------------------- // // Static method to get the Version of OZW as a string. //----------------------------------------------------------------------------- std::string Manager::getVersionAsString() { std::ostringstream versionstream; versionstream << ozw_vers_major << "." << ozw_vers_minor << "." << ozw_vers_revision; return versionstream.str(); } //----------------------------------------------------------------------------- // // Static method to get the Version of OZW. //----------------------------------------------------------------------------- ozwversion Manager::getVersion() { return version(ozw_vers_major, ozw_vers_minor); } //----------------------------------------------------------------------------- // // Constructor //----------------------------------------------------------------------------- Manager::Manager ( ): m_notificationMutex( new Mutex() ) { // Ensure the singleton instance is set s_instance = this; // Create the log file (if enabled) bool logging = false; Options::Get()->GetOptionAsBool( "Logging", &logging ); string userPath = ""; Options::Get()->GetOptionAsString( "UserPath", &userPath ); string logFileNameBase = "OZW_Log.txt"; Options::Get()->GetOptionAsString( "LogFileName", &logFileNameBase ); bool bAppend = false; Options::Get()->GetOptionAsBool( "AppendLogFile", &bAppend ); bool bConsoleOutput = true; Options::Get()->GetOptionAsBool( "ConsoleOutput", &bConsoleOutput ); int nSaveLogLevel = (int) LogLevel_Detail; Options::Get()->GetOptionAsInt( "SaveLogLevel", &nSaveLogLevel ); int nQueueLogLevel = (int) LogLevel_Debug; Options::Get()->GetOptionAsInt( "QueueLogLevel", &nQueueLogLevel ); int nDumpTrigger = (int) LogLevel_Warning; Options::Get()->GetOptionAsInt( "DumpTriggerLevel", &nDumpTrigger ); string logFilename = userPath + logFileNameBase; Log::Create( logFilename, bAppend, bConsoleOutput, (LogLevel) nSaveLogLevel, (LogLevel) nQueueLogLevel, (LogLevel) nDumpTrigger ); Log::SetLoggingState( logging ); CommandClasses::RegisterCommandClasses(); Scene::ReadScenes(); Log::Write(LogLevel_Always, "OpenZwave Version %s Starting Up", getVersionAsString().c_str()); } //----------------------------------------------------------------------------- // // Destructor //----------------------------------------------------------------------------- Manager::~Manager ( ) { // Clear the pending list while( !m_pendingDrivers.empty() ) { list::iterator it = m_pendingDrivers.begin(); delete *it; m_pendingDrivers.erase( it ); } // Clear the ready map while( !m_readyDrivers.empty() ) { map::iterator it = m_readyDrivers.begin(); delete it->second; m_readyDrivers.erase( it ); } m_notificationMutex->Release(); // Clear the watchers list while( !m_watchers.empty() ) { list::iterator it = m_watchers.begin(); delete *it; m_watchers.erase( it ); } // Clear the generic device class list while( !Node::s_genericDeviceClasses.empty() ) { map::iterator git = Node::s_genericDeviceClasses.begin(); delete git->second; Node::s_genericDeviceClasses.erase( git ); } Log::Destroy(); } //----------------------------------------------------------------------------- // Configuration //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Save the configuration of a driver to a file //----------------------------------------------------------------------------- void Manager::WriteConfig ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->WriteConfig(); Log::Write( LogLevel_Info, "mgr, Manager::WriteConfig completed for driver with home ID of 0x%.8x", _homeId ); } else { Log::Write( LogLevel_Info, "mgr, Manager::WriteConfig failed - _homeId %d not found", _homeId ); } Scene::WriteXML( "zwscene.xml" ); } //----------------------------------------------------------------------------- // Drivers //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Add a new Z-Wave PC Interface //----------------------------------------------------------------------------- bool Manager::AddDriver ( string const& _controllerPath, Driver::ControllerInterface const& _interface ) { // Make sure we don't already have a driver for this controller // Search the pending list for( list::iterator pit = m_pendingDrivers.begin(); pit != m_pendingDrivers.end(); ++pit ) { if( _controllerPath == (*pit)->GetControllerPath() ) { Log::Write( LogLevel_Info, "mgr, Cannot add driver for controller %s - driver already exists", _controllerPath.c_str() ); return false; } } // Search the ready map for( map::iterator rit = m_readyDrivers.begin(); rit != m_readyDrivers.end(); ++rit ) { if( _controllerPath == rit->second->GetControllerPath() ) { Log::Write( LogLevel_Info, "mgr, Cannot add driver for controller %s - driver already exists", _controllerPath.c_str() ); return false; } } Driver* driver = new Driver( _controllerPath, _interface ); m_pendingDrivers.push_back( driver ); driver->Start(); Log::Write( LogLevel_Info, "mgr, Added driver for controller %s", _controllerPath.c_str() ); return true; } //----------------------------------------------------------------------------- // // Remove a Z-Wave PC Interface //----------------------------------------------------------------------------- bool Manager::RemoveDriver ( string const& _controllerPath ) { // Search the pending list for( list::iterator pit = m_pendingDrivers.begin(); pit != m_pendingDrivers.end(); ++pit ) { if( _controllerPath == (*pit)->GetControllerPath() ) { delete *pit; m_pendingDrivers.erase( pit ); Log::Write( LogLevel_Info, "mgr, Driver for controller %s removed", _controllerPath.c_str() ); return true; } } // Search the ready map for( map::iterator rit = m_readyDrivers.begin(); rit != m_readyDrivers.end(); ++rit ) { if( _controllerPath == rit->second->GetControllerPath() ) { /* data race right here: * Before, we were deleting the Driver Class direct from the Map... this was causing a datarace: * 1) Driver::~Driver destructor starts deleting everything.... * 2) This Triggers Notifications such as ValueDeleted etc * 3) Notifications are delivered to applications, and applications start calling * Manager Functions which require the Driver (such as IsPolled(valueid)) * 4) Manager looks up the Driver in the m_readyDriver and returns a pointer to the Driver Class * which is currently being destructed. * 5) All Hell Breaks loose and we crash and burn. * * But we can't change this, as the Driver Destructor triggers internal GetDriver calls... which * will crash and burn if they can't get a valid Driver back... */ Log::Write( LogLevel_Info, "mgr, Driver for controller %s pending removal", _controllerPath.c_str() ); delete rit->second; m_readyDrivers.erase( rit ); Log::Write( LogLevel_Info, "mgr, Driver for controller %s removed", _controllerPath.c_str() ); return true; } } Log::Write( LogLevel_Info, "mgr, Failed to remove driver for controller %s", _controllerPath.c_str() ); return false; } //----------------------------------------------------------------------------- // // Get a pointer to the driver for a Z-Wave PC Interface //----------------------------------------------------------------------------- Driver* Manager::GetDriver ( uint32 const _homeId ) { map::iterator it = m_readyDrivers.find( _homeId ); if( it != m_readyDrivers.end() ) { return it->second; } Log::Write( LogLevel_Error, "mgr, Manager::GetDriver failed - Home ID 0x%.8x is unknown", _homeId ); OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_HOMEID, "Invalid HomeId passed to GetDriver"); //assert(0); << Don't assert as this might be a valid condition when we call RemoveDriver. See comments above. return NULL; } //----------------------------------------------------------------------------- // // Move a driver from pending to ready, and notify any watchers //----------------------------------------------------------------------------- void Manager::SetDriverReady ( Driver* _driver, bool success ) { // Search the pending list bool found = false; for( list::iterator it = m_pendingDrivers.begin(); it != m_pendingDrivers.end(); ++it ) { if( (*it) == _driver ) { // Remove the driver from the pending list m_pendingDrivers.erase( it ); found = true; break; } } if( found ) { if (success) { Log::Write( LogLevel_Info, "mgr, Driver with Home ID of 0x%.8x is now ready.", _driver->GetHomeId() ); Log::Write( LogLevel_Info, "" ); } // Add the driver to the ready map m_readyDrivers[_driver->GetHomeId()] = _driver; // Notify the watchers Notification* notification = new Notification(success ? Notification::Type_DriverReady : Notification::Type_DriverFailed ); notification->SetHomeAndNodeIds( _driver->GetHomeId(), _driver->GetNodeId() ); _driver->QueueNotification( notification ); } } //----------------------------------------------------------------------------- // // //----------------------------------------------------------------------------- uint8 Manager::GetControllerNodeId ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeId(); } Log::Write( LogLevel_Info, "mgr, GetControllerNodeId() failed - _homeId %d not found", _homeId ); return 0xff; } //----------------------------------------------------------------------------- // // //----------------------------------------------------------------------------- uint8 Manager::GetSUCNodeId ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetSUCNodeId(); } Log::Write( LogLevel_Info, "mgr, GetSUCNodeId() failed - _homeId %d not found", _homeId ); return 0xff; } //----------------------------------------------------------------------------- // // //----------------------------------------------------------------------------- bool Manager::IsPrimaryController ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->IsPrimaryController(); } Log::Write( LogLevel_Info, "mgr, IsPrimaryController() failed - _homeId %d not found", _homeId ); return false; } //----------------------------------------------------------------------------- // // //----------------------------------------------------------------------------- bool Manager::IsStaticUpdateController ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->IsStaticUpdateController(); } Log::Write( LogLevel_Info, "mgr, IsStaticUpdateController() failed - _homeId %d not found", _homeId ); return false; } //----------------------------------------------------------------------------- // // //----------------------------------------------------------------------------- bool Manager::IsBridgeController ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->IsBridgeController(); } Log::Write( LogLevel_Info, "mgr, IsBridgeController() failed - _homeId %d not found", _homeId ); return false; } //----------------------------------------------------------------------------- // // //----------------------------------------------------------------------------- string Manager::GetLibraryVersion ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetLibraryVersion(); } Log::Write( LogLevel_Info, "mgr, GetLibraryVersion() failed - _homeId %d not found", _homeId ); return ""; } //----------------------------------------------------------------------------- // // //----------------------------------------------------------------------------- string Manager::GetLibraryTypeName ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetLibraryTypeName(); } Log::Write( LogLevel_Info, "mgr, GetLibraryTypeName() failed - _homeId %d not found", _homeId ); return ""; } //----------------------------------------------------------------------------- // // //----------------------------------------------------------------------------- int32 Manager::GetSendQueueCount ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetSendQueueCount(); } Log::Write( LogLevel_Info, "mgr, GetSendQueueCount() failed - _homeId %d not found", _homeId ); return -1; } //----------------------------------------------------------------------------- // // Send driver statistics to the log file //----------------------------------------------------------------------------- void Manager::LogDriverStatistics ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->LogDriverStatistics(); } Log::Write( LogLevel_Warning, "mgr, LogDriverStatistics() failed - _homeId %d not found", _homeId ); } //----------------------------------------------------------------------------- // // Retrieve controller interface type //----------------------------------------------------------------------------- Driver::ControllerInterface Manager::GetControllerInterfaceType ( uint32 const _homeId ) { Driver::ControllerInterface ifType = Driver::ControllerInterface_Unknown; if( Driver* driver = GetDriver( _homeId ) ) { ifType = driver->GetControllerInterfaceType(); } return ifType; } //----------------------------------------------------------------------------- // // Retrieve controller interface path //----------------------------------------------------------------------------- string Manager::GetControllerPath ( uint32 const _homeId ) { string path = ""; if( Driver* driver = GetDriver( _homeId ) ) { path = driver->GetControllerPath(); } return path; } //----------------------------------------------------------------------------- // Polling Z-Wave values //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Return the polling interval //----------------------------------------------------------------------------- int32 Manager::GetPollInterval ( ) { for( map::iterator rit = m_readyDrivers.begin(); rit != m_readyDrivers.end(); ++rit ) { return rit->second->GetPollInterval(); } for( list::iterator pit = m_pendingDrivers.begin(); pit != m_pendingDrivers.end(); ++pit ) { return (*pit)->GetPollInterval(); } return 0; } //----------------------------------------------------------------------------- // // Set the polling interval on all drivers //----------------------------------------------------------------------------- void Manager::SetPollInterval ( int32 _milliseconds, bool _bIntervalBetweenPolls ) { for( list::iterator pit = m_pendingDrivers.begin(); pit != m_pendingDrivers.end(); ++pit ) { (*pit)->SetPollInterval( _milliseconds, _bIntervalBetweenPolls ); } for( map::iterator rit = m_readyDrivers.begin(); rit != m_readyDrivers.end(); ++rit ) { rit->second->SetPollInterval( _milliseconds, _bIntervalBetweenPolls ); } } //----------------------------------------------------------------------------- // // Enable polling of a value //----------------------------------------------------------------------------- bool Manager::EnablePoll ( ValueID const &_valueId, uint8 const _intensity ) { if( Driver* driver = GetDriver( _valueId.GetHomeId() ) ) { return( driver->EnablePoll( _valueId, _intensity ) ); } Log::Write( LogLevel_Info, "mgr, EnablePoll failed - Driver with Home ID 0x%.8x is not available", _valueId.GetHomeId() ); return false; } //----------------------------------------------------------------------------- // // Disable polling of a value //----------------------------------------------------------------------------- bool Manager::DisablePoll ( ValueID const &_valueId ) { if( Driver* driver = GetDriver( _valueId.GetHomeId() ) ) { return( driver->DisablePoll( _valueId ) ); } Log::Write( LogLevel_Info, "mgr, DisablePoll failed - Driver with Home ID 0x%.8x is not available", _valueId.GetHomeId() ); return false; } //----------------------------------------------------------------------------- // // Check polling status of a value //----------------------------------------------------------------------------- bool Manager::isPolled ( ValueID const &_valueId ) { if( Driver* driver = GetDriver( _valueId.GetHomeId() ) ) { return( driver->isPolled( _valueId ) ); } Log::Write( LogLevel_Info, "mgr, isPolled failed - Driver with Home ID 0x%.8x is not available", _valueId.GetHomeId() ); return false; } //----------------------------------------------------------------------------- // // Change the intensity with which this value is polled //----------------------------------------------------------------------------- void Manager::SetPollIntensity ( ValueID const &_valueId, uint8 const _intensity ) { if( Driver* driver = GetDriver( _valueId.GetHomeId() ) ) { return( driver->SetPollIntensity( _valueId, _intensity ) ); } Log::Write( LogLevel_Error, "mgr, SetPollIntensity failed - Driver with Home ID 0x%.8x is not available", _valueId.GetHomeId() ); } //----------------------------------------------------------------------------- // // Change the intensity with which this value is polled //----------------------------------------------------------------------------- uint8 Manager::GetPollIntensity ( ValueID const &_valueId ) { uint8 intensity = 0; if( Driver* driver = GetDriver( _valueId.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _valueId ) ) { intensity = value->GetPollIntensity(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetPollIntensity"); } driver->ReleaseNodes(); } return intensity; } //----------------------------------------------------------------------------- // Retrieving Node information //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Fetch the data for a node from the Z-Wave network //----------------------------------------------------------------------------- bool Manager::RefreshNodeInfo ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { // Cause the node's data to be obtained from the Z-Wave network // in the same way as if it had just been added. Node* node = driver->GetNode( _nodeId ); if( node ) { node->SetQueryStage( Node::QueryStage_ProtocolInfo ); driver->ReleaseNodes(); return true; } } return false; } //----------------------------------------------------------------------------- // // Fetch the command class data for a node from the Z-Wave network //----------------------------------------------------------------------------- bool Manager::RequestNodeState ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { // Retreive the Node's session and dynamic data Node* node = driver->GetNode( _nodeId ); if( node ) { node->SetQueryStage( Node::QueryStage_Associations ); driver->ReleaseNodes(); return true; } } return false; } //----------------------------------------------------------------------------- // // Fetch only the dynamic command class data for a node from the Z-Wave network //----------------------------------------------------------------------------- bool Manager::RequestNodeDynamic ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { // Retreive the Node's dynamic data Node* node = driver->GetNode( _nodeId ); if( node ) { node->SetQueryStage( Node::QueryStage_Dynamic ); driver->ReleaseNodes(); return true; } } return false; } //----------------------------------------------------------------------------- // // Get whether the node is a listening device that does not go to sleep //----------------------------------------------------------------------------- bool Manager::IsNodeListeningDevice ( uint32 const _homeId, uint8 const _nodeId ) { bool res = false; if( Driver* driver = GetDriver( _homeId ) ) { res = driver->IsNodeListeningDevice( _nodeId ); } return res; } //----------------------------------------------------------------------------- // // Get whether the node is a listening device that does not go to sleep //----------------------------------------------------------------------------- bool Manager::IsNodeFrequentListeningDevice ( uint32 const _homeId, uint8 const _nodeId ) { bool res = false; if( Driver* driver = GetDriver( _homeId ) ) { res = driver->IsNodeFrequentListeningDevice( _nodeId ); } return res; } //----------------------------------------------------------------------------- // // Get whether the node is a beam capable device. //----------------------------------------------------------------------------- bool Manager::IsNodeBeamingDevice ( uint32 const _homeId, uint8 const _nodeId ) { bool res = false; if( Driver* driver = GetDriver( _homeId ) ) { res = driver->IsNodeBeamingDevice( _nodeId ); } return res; } //----------------------------------------------------------------------------- // // Get whether the node is a routing device that passes messages to other nodes //----------------------------------------------------------------------------- bool Manager::IsNodeRoutingDevice ( uint32 const _homeId, uint8 const _nodeId ) { bool res = false; if( Driver* driver = GetDriver( _homeId ) ) { res = driver->IsNodeRoutingDevice( _nodeId ); } return res; } //----------------------------------------------------------------------------- // // Get the security attribute for a node. //----------------------------------------------------------------------------- bool Manager::IsNodeSecurityDevice ( uint32 const _homeId, uint8 const _nodeId ) { bool security = 0; if( Driver* driver = GetDriver( _homeId ) ) { security = driver->IsNodeSecurityDevice( _nodeId ); } return security; } //----------------------------------------------------------------------------- // // Get the maximum baud rate of a node's communications //----------------------------------------------------------------------------- uint32 Manager::GetNodeMaxBaudRate ( uint32 const _homeId, uint8 const _nodeId ) { uint32 baud = 0; if( Driver* driver = GetDriver( _homeId ) ) { baud = driver->GetNodeMaxBaudRate( _nodeId ); } return baud; } //----------------------------------------------------------------------------- // // Get the version number of a node //----------------------------------------------------------------------------- uint8 Manager::GetNodeVersion ( uint32 const _homeId, uint8 const _nodeId ) { uint8 version = 0; if( Driver* driver = GetDriver( _homeId ) ) { version = driver->GetNodeVersion( _nodeId ); } return version; } //----------------------------------------------------------------------------- // // Get the security byte of a node //----------------------------------------------------------------------------- uint8 Manager::GetNodeSecurity ( uint32 const _homeId, uint8 const _nodeId ) { uint8 version = 0; if( Driver* driver = GetDriver( _homeId ) ) { version = driver->GetNodeSecurity( _nodeId ); } return version; } //----------------------------------------------------------------------------- // // Get the basic type of a node //----------------------------------------------------------------------------- uint8 Manager::GetNodeBasic ( uint32 const _homeId, uint8 const _nodeId ) { uint8 basic = 0; if( Driver* driver = GetDriver( _homeId ) ) { basic = driver->GetNodeBasic( _nodeId ); } return basic; } //----------------------------------------------------------------------------- // // Get the generic type of a node //----------------------------------------------------------------------------- uint8 Manager::GetNodeGeneric ( uint32 const _homeId, uint8 const _nodeId ) { uint8 genericType = 0; if( Driver* driver = GetDriver( _homeId ) ) { genericType = driver->GetNodeGeneric( _nodeId ); } return genericType; } //----------------------------------------------------------------------------- // // Get the specific type of a node //----------------------------------------------------------------------------- uint8 Manager::GetNodeSpecific ( uint32 const _homeId, uint8 const _nodeId ) { uint8 specific = 0; if( Driver* driver = GetDriver( _homeId ) ) { specific = driver->GetNodeSpecific( _nodeId ); } return specific; } //----------------------------------------------------------------------------- // // Get a string describing the type of a node //----------------------------------------------------------------------------- string Manager::GetNodeType ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeType( _nodeId ); } return "Unknown"; } //----------------------------------------------------------------------------- // // Get the bitmap of this node's neighbors //----------------------------------------------------------------------------- uint32 Manager::GetNodeNeighbors ( uint32 const _homeId, uint8 const _nodeId, uint8** o_neighbors ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeNeighbors( _nodeId, o_neighbors ); } return 0; } //----------------------------------------------------------------------------- // // Get the manufacturer name of a node //----------------------------------------------------------------------------- string Manager::GetNodeManufacturerName ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeManufacturerName( _nodeId ); } return "Unknown"; } //----------------------------------------------------------------------------- // // Get the product name of a node //----------------------------------------------------------------------------- string Manager::GetNodeProductName ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeProductName( _nodeId ); } return "Unknown"; } //----------------------------------------------------------------------------- // // Get the user-editable name of a node //----------------------------------------------------------------------------- string Manager::GetNodeName ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeName( _nodeId ); } return "Unknown"; } //----------------------------------------------------------------------------- // // Get the location of a node //----------------------------------------------------------------------------- string Manager::GetNodeLocation ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeLocation( _nodeId ); } return "Unknown"; } //----------------------------------------------------------------------------- // // Set the manufacturer name a node //----------------------------------------------------------------------------- void Manager::SetNodeManufacturerName ( uint32 const _homeId, uint8 const _nodeId, string const& _manufacturerName ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->SetNodeManufacturerName( _nodeId, _manufacturerName ); } } //----------------------------------------------------------------------------- // // Set the product name of a node //----------------------------------------------------------------------------- void Manager::SetNodeProductName ( uint32 const _homeId, uint8 const _nodeId, string const& _productName ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->SetNodeProductName( _nodeId, _productName ); } } //----------------------------------------------------------------------------- // // Set the node name value with the specified ID //----------------------------------------------------------------------------- void Manager::SetNodeName ( uint32 const _homeId, uint8 const _nodeId, string const& _nodeName ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->SetNodeName( _nodeId, _nodeName ); } } //----------------------------------------------------------------------------- // // Set a string describing the location of a node //----------------------------------------------------------------------------- void Manager::SetNodeLocation ( uint32 const _homeId, uint8 const _nodeId, string const& _location ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->SetNodeLocation( _nodeId, _location ); } } //----------------------------------------------------------------------------- // // Get the manufacturer ID value of a node //----------------------------------------------------------------------------- string Manager::GetNodeManufacturerId ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeManufacturerId( _nodeId ); } return "Unknown"; } //----------------------------------------------------------------------------- // // Get the product type value of a node //----------------------------------------------------------------------------- string Manager::GetNodeProductType ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeProductType( _nodeId ); } return "Unknown"; } //----------------------------------------------------------------------------- // // Get the product Id value with the specified ID //----------------------------------------------------------------------------- string Manager::GetNodeProductId ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNodeProductId( _nodeId ); } return "Unknown"; } //----------------------------------------------------------------------------- // // Helper method to turn a node on //----------------------------------------------------------------------------- void Manager::SetNodeOn ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->SetNodeOn( _nodeId ); } } //----------------------------------------------------------------------------- // // Helper method to turn a node off //----------------------------------------------------------------------------- void Manager::SetNodeOff ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->SetNodeOff( _nodeId ); } } //----------------------------------------------------------------------------- // // Helper method to return whether a particular class is available in a node //----------------------------------------------------------------------------- bool Manager::IsNodeInfoReceived ( uint32 const _homeId, uint8 const _nodeId ) { bool result = false; if( Driver* driver = GetDriver( _homeId ) ) { Node *node; // Need to lock and unlock nodes to check this information driver->LockNodes(); if( (node = driver->GetNodeUnsafe( _nodeId ) ) != NULL) { result = node->NodeInfoReceived(); } driver->ReleaseNodes(); } return result; } //----------------------------------------------------------------------------- // // Helper method to return whether a particular class is available in a node //----------------------------------------------------------------------------- bool Manager::GetNodeClassInformation ( uint32 const _homeId, uint8 const _nodeId, uint8 const _commandClassId, string *_className, uint8 *_classVersion ) { bool result = false; if( Driver* driver = GetDriver( _homeId ) ) { Node *node; // Need to lock and unlock nodes to check this information driver->LockNodes(); if( ( node = driver->GetNodeUnsafe( _nodeId ) ) != NULL ) { CommandClass *cc; if( node->NodeInfoReceived() && ( ( cc = node->GetCommandClass( _commandClassId ) ) != NULL ) ) { if( _className ) { *_className = cc->GetCommandClassName(); } if( _classVersion ) { *_classVersion = cc->GetVersion(); } // Positive result result = true; } } driver->ReleaseNodes(); } return result; } //----------------------------------------------------------------------------- // // Helper method to return whether a node is awake or sleeping //----------------------------------------------------------------------------- bool Manager::IsNodeAwake ( uint32 const _homeId, uint8 const _nodeId ) { if( IsNodeListeningDevice( _homeId, _nodeId ) ) { return true; // if listening then always awake } bool result = true; if( Driver* driver = GetDriver( _homeId ) ) { // Need to lock and unlock nodes to check this information driver->LockNodes(); if( Node* node = driver->GetNodeUnsafe( _nodeId ) ) { if( WakeUp* wcc = static_cast( node->GetCommandClass( WakeUp::StaticGetCommandClassId() ) ) ) { result = wcc->IsAwake(); } } driver->ReleaseNodes(); } return result; } //----------------------------------------------------------------------------- // // Helper method to return whether a node is on the network or not //----------------------------------------------------------------------------- bool Manager::IsNodeFailed ( uint32 const _homeId, uint8 const _nodeId ) { bool result = false; if( Driver* driver = GetDriver( _homeId ) ) { if( Node* node = driver->GetNode( _nodeId ) ) { result = !node->IsNodeAlive(); driver->ReleaseNodes(); } } return result; } //----------------------------------------------------------------------------- // // Helper method to return whether a node's query stage //----------------------------------------------------------------------------- string Manager::GetNodeQueryStage ( uint32 const _homeId, uint8 const _nodeId ) { string result = "Unknown"; if( Driver* driver = GetDriver( _homeId ) ) { if( Node* node = driver->GetNode( _nodeId ) ) { result = node->GetQueryStageName( node->GetCurrentQueryStage() ); driver->ReleaseNodes(); } } return result; } //----------------------------------------------------------------------------- // // Helper method to set the basic level of a node //----------------------------------------------------------------------------- void Manager::SetNodeLevel ( uint32 const _homeId, uint8 const _nodeId, uint8 const _level ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->SetNodeLevel( _nodeId, _level ); } } //----------------------------------------------------------------------------- // Values //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Gets the user-friendly label for the value //----------------------------------------------------------------------------- string Manager::GetValueLabel ( ValueID const& _id ) { string label; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { label = value->GetLabel(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueLabel"); } driver->ReleaseNodes(); } return label; } //----------------------------------------------------------------------------- // // Sets the user-friendly label for the value //----------------------------------------------------------------------------- void Manager::SetValueLabel ( ValueID const& _id, string const& _value ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { value->SetLabel( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValueLabel"); } driver->ReleaseNodes(); } } //----------------------------------------------------------------------------- // // Gets the units that the value is measured in //----------------------------------------------------------------------------- string Manager::GetValueUnits ( ValueID const& _id ) { string units; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { units = value->GetUnits(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueUnits"); } driver->ReleaseNodes(); } return units; } //----------------------------------------------------------------------------- // // Sets the units that the value is measured in //----------------------------------------------------------------------------- void Manager::SetValueUnits ( ValueID const& _id, string const& _value ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { value->SetUnits( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValueUnits"); } driver->ReleaseNodes(); } } //----------------------------------------------------------------------------- // // Gets a help string describing the value's purpose and usage //----------------------------------------------------------------------------- string Manager::GetValueHelp ( ValueID const& _id ) { string help; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { help = value->GetHelp(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueHelp"); } driver->ReleaseNodes(); } return help; } //----------------------------------------------------------------------------- // // Sets a help string describing the value's purpose and usage //----------------------------------------------------------------------------- void Manager::SetValueHelp ( ValueID const& _id, string const& _value ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { value->SetHelp( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValueHelp"); } driver->ReleaseNodes(); } } //----------------------------------------------------------------------------- // // Gets the minimum for a value //----------------------------------------------------------------------------- int32 Manager::GetValueMin ( ValueID const& _id ) { int32 limit = 0; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { limit = value->GetMin(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueMin"); } driver->ReleaseNodes(); } return limit; } //----------------------------------------------------------------------------- // // Gets the maximum for a value //----------------------------------------------------------------------------- int32 Manager::GetValueMax ( ValueID const& _id ) { int32 limit = 0; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { limit = value->GetMax(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueMax"); } driver->ReleaseNodes(); } return limit; } //----------------------------------------------------------------------------- // // Test whether the value is read-only //----------------------------------------------------------------------------- bool Manager::IsValueReadOnly ( ValueID const& _id ) { bool res = false; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { res = value->IsReadOnly(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to IsValueReadOnly"); } driver->ReleaseNodes(); } return res; } //----------------------------------------------------------------------------- // // Test whether the value is write-only //----------------------------------------------------------------------------- bool Manager::IsValueWriteOnly ( ValueID const& _id ) { bool res = false; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { res = value->IsWriteOnly(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to IsValueWriteOnly"); } driver->ReleaseNodes(); } return res; } //----------------------------------------------------------------------------- // // Test whether the value has been set by a status message from the device //----------------------------------------------------------------------------- bool Manager::IsValueSet ( ValueID const& _id ) { bool res = false; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { res = value->IsSet(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to IsValueSet"); } driver->ReleaseNodes(); } return res; } //----------------------------------------------------------------------------- // // Test whether the value is currently being polled //----------------------------------------------------------------------------- bool Manager::IsValuePolled ( ValueID const& _id ) { bool res = false; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { res = value->IsPolled(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to IsValuePolled"); } driver->ReleaseNodes(); } return res; } //----------------------------------------------------------------------------- // // Gets a value as a bool //----------------------------------------------------------------------------- bool Manager::GetValueAsBool ( ValueID const& _id, bool* o_value ) { bool res = false; if( o_value ) { if( ValueID::ValueType_Bool == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueBool* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetValue(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsBool"); } driver->ReleaseNodes(); } } else if( ValueID::ValueType_Button == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueButton* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->IsPressed(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsBool"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueAsBool is not a Bool or Button Value"); } } return res; } //----------------------------------------------------------------------------- // // Gets a value as an 8-bit unsigned integer //----------------------------------------------------------------------------- bool Manager::GetValueAsByte ( ValueID const& _id, uint8* o_value ) { bool res = false; if( o_value ) { if( ValueID::ValueType_Byte == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueByte* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetValue(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsByte"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueAsByte is not a Byte Value"); } } return res; } //----------------------------------------------------------------------------- // // Gets a value as a floating point number //----------------------------------------------------------------------------- bool Manager::GetValueAsFloat ( ValueID const& _id, float* o_value ) { bool res = false; if( o_value ) { if( ValueID::ValueType_Decimal == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueDecimal* value = static_cast( driver->GetValue( _id ) ) ) { string str = value->GetValue(); *o_value = (float)atof( str.c_str() ); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsFloat"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueAsFloat is not a Float Value"); } } return res; } //----------------------------------------------------------------------------- // // Gets a value as a 32-bit signed integer //----------------------------------------------------------------------------- bool Manager::GetValueAsInt ( ValueID const& _id, int32* o_value ) { bool res = false; if( o_value ) { if( ValueID::ValueType_Int == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueInt* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetValue(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsInt"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueAsInt is not a Int Value"); } } return res; } //----------------------------------------------------------------------------- // // Gets a value as a collection of bytes //----------------------------------------------------------------------------- bool Manager::GetValueAsRaw ( ValueID const& _id, uint8** o_value, uint8* o_length ) { bool res = false; if( o_value && o_length ) { if( ValueID::ValueType_Raw == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueRaw* value = static_cast( driver->GetValue( _id ) ) ) { *o_length = value->GetLength(); *o_value = new uint8[*o_length]; memcpy( *o_value, value->GetValue(), *o_length ); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsRaw"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueAsRaw is not a Raw Value"); } } return res; } //----------------------------------------------------------------------------- // // Gets a value as a 16-bit signed integer //----------------------------------------------------------------------------- bool Manager::GetValueAsShort ( ValueID const& _id, int16* o_value ) { bool res = false; if( o_value ) { if( ValueID::ValueType_Short == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueShort* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetValue(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsShort"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueAsShort is not a Short Value"); } } return res; } //----------------------------------------------------------------------------- // // Creates a string representation of the value, regardless of type //----------------------------------------------------------------------------- bool Manager::GetValueAsString ( ValueID const& _id, string* o_value ) { bool res = false; char str[256] = {0}; if( o_value ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); switch( _id.GetType() ) { case ValueID::ValueType_Bool: { if( ValueBool* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetValue() ? "True" : "False"; value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } case ValueID::ValueType_Byte: { if( ValueByte* value = static_cast( driver->GetValue( _id ) ) ) { snprintf( str, sizeof(str), "%u", value->GetValue() ); *o_value = str; value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } case ValueID::ValueType_Decimal: { if( ValueDecimal* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetValue(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } case ValueID::ValueType_Int: { if( ValueInt* value = static_cast( driver->GetValue( _id ) ) ) { snprintf( str, sizeof(str), "%d", value->GetValue() ); *o_value = str; value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } case ValueID::ValueType_List: { if( ValueList* value = static_cast( driver->GetValue( _id ) ) ) { ValueList::Item const& item = value->GetItem(); *o_value = item.m_label; value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } case ValueID::ValueType_Raw: { if( ValueRaw* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetAsString(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } case ValueID::ValueType_Short: { if( ValueShort* value = static_cast( driver->GetValue( _id ) ) ) { snprintf( str, sizeof(str), "%d", value->GetValue() ); *o_value = str; value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } case ValueID::ValueType_String: { if( ValueString* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetValue(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } case ValueID::ValueType_Button: { if( ValueButton* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->IsPressed() ? "True" : "False"; value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } case ValueID::ValueType_Schedule: { if( ValueSchedule* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetAsString(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueAsString"); } break; } #if 0 /* comment this out so if we miss a ValueID, GCC warns us loudly! */ default: { // To keep GCC happy break; } #endif } driver->ReleaseNodes(); } } return res; } //----------------------------------------------------------------------------- // // Gets the selected item from a list value (returning a string) //----------------------------------------------------------------------------- bool Manager::GetValueListSelection ( ValueID const& _id, string* o_value ) { bool res = false; if( o_value ) { if( ValueID::ValueType_List == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueList* value = static_cast( driver->GetValue( _id ) ) ) { ValueList::Item const& item = value->GetItem(); if( &item != NULL ) { *o_value = item.m_label; res = true; } value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueListSelection"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueListSelection is not a List Value"); } } return res; } //----------------------------------------------------------------------------- // // Gets the selected item from a list value (returning the index) //----------------------------------------------------------------------------- bool Manager::GetValueListSelection ( ValueID const& _id, int32* o_value ) { bool res = false; if( o_value ) { if( ValueID::ValueType_List == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueList* value = static_cast( driver->GetValue( _id ) ) ) { ValueList::Item const& item = value->GetItem(); *o_value = item.m_value; value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueListSelection"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueListSelection is not a List Value"); } } return res; } //----------------------------------------------------------------------------- // // Gets the list of items from a list value //----------------------------------------------------------------------------- bool Manager::GetValueListItems ( ValueID const& _id, vector* o_value ) { bool res = false; if( o_value ) { if( ValueID::ValueType_List == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueList* value = static_cast( driver->GetValue( _id ) ) ) { o_value->clear(); res = value->GetItemLabels( o_value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueListItems"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueListItems is not a List Value"); } } return res; } //----------------------------------------------------------------------------- // // Gets a value's scale as a uint8 //----------------------------------------------------------------------------- bool Manager::GetValueFloatPrecision ( ValueID const& _id, uint8* o_value ) { bool res = false; if( o_value ) { if( ValueID::ValueType_Decimal == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueDecimal* value = static_cast( driver->GetValue( _id ) ) ) { *o_value = value->GetPrecision(); value->Release(); res = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueFloatPrecision"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueFloatPrecision is not a Decimal Value"); } } return res; } //----------------------------------------------------------------------------- // // Sets the value from a bool //----------------------------------------------------------------------------- bool Manager::SetValue ( ValueID const& _id, bool const _value ) { bool res = false; if( ValueID::ValueType_Bool == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { if( _id.GetNodeId() != driver->GetNodeId() ) { driver->LockNodes(); if( ValueBool* value = static_cast( driver->GetValue( _id ) ) ) { res = value->Set( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } driver->ReleaseNodes(); } } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to SetValue is not a bool Value"); } return res; } //----------------------------------------------------------------------------- // // Sets the value from a byte //----------------------------------------------------------------------------- bool Manager::SetValue ( ValueID const& _id, uint8 const _value ) { bool res = false; if( ValueID::ValueType_Byte == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { if( _id.GetNodeId() != driver->GetNodeId() ) { driver->LockNodes(); if( ValueByte* value = static_cast( driver->GetValue( _id ) ) ) { res = value->Set( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } driver->ReleaseNodes(); } } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to SetValue is not a Byte Value"); } return res; } //----------------------------------------------------------------------------- // // Sets the value from a floating point number //----------------------------------------------------------------------------- bool Manager::SetValue ( ValueID const& _id, float const _value ) { bool res = false; if( ValueID::ValueType_Decimal == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { if( _id.GetNodeId() != driver->GetNodeId() ) { driver->LockNodes(); if( ValueDecimal* value = static_cast( driver->GetValue( _id ) ) ) { char str[256]; snprintf( str, sizeof(str), "%f", _value ); // remove trailing zeros (and the decimal point, if present) // TODO: better way of figuring out which locale is being used ('.' or ',' to separate decimals) size_t nLen; if( ( strchr( str, '.' ) != NULL) || (strchr( str, ',' ) != NULL ) ) { for( nLen = strlen( str ) - 1; nLen > 0; nLen-- ) { if( str[nLen] == '0' ) str[nLen] = 0; else break; } if( (str[nLen] == '.') || (str[nLen] == ',') ) str[nLen] = 0; } // now set the value res = value->Set( str ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } driver->ReleaseNodes(); } } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to SetValue is not a Decimal Value"); } return res; } //----------------------------------------------------------------------------- // // Sets the value from a 32-bit signed integer //----------------------------------------------------------------------------- bool Manager::SetValue ( ValueID const& _id, int32 const _value ) { bool res = false; if( ValueID::ValueType_Int == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { if( _id.GetNodeId() != driver->GetNodeId() ) { driver->LockNodes(); if( ValueInt* value = static_cast( driver->GetValue( _id ) ) ) { res = value->Set( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } driver->ReleaseNodes(); } } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to SetValue is not a Int Value"); } return res; } //----------------------------------------------------------------------------- // // Sets the value from a collection of bytes //----------------------------------------------------------------------------- bool Manager::SetValue ( ValueID const& _id, uint8 const* _value, uint8 const _length ) { bool res = false; if( ValueID::ValueType_Raw == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { if( _id.GetNodeId() != driver->GetNodeId() ) { driver->LockNodes(); if( ValueRaw* value = static_cast( driver->GetValue( _id ) ) ) { res = value->Set( _value, _length ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } driver->ReleaseNodes(); } } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to SetValue is not a Raw Value"); } return res; } //----------------------------------------------------------------------------- // // Sets the value from a 16-bit signed integer //----------------------------------------------------------------------------- bool Manager::SetValue ( ValueID const& _id, int16 const _value ) { bool res = false; if( ValueID::ValueType_Short == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { if( _id.GetNodeId() != driver->GetNodeId() ) { driver->LockNodes(); if( ValueShort* value = static_cast( driver->GetValue( _id ) ) ) { res = value->Set( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } driver->ReleaseNodes(); } } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to SetValue is not a Short Value"); } return res; } //----------------------------------------------------------------------------- // // Sets the selected item in a list by value //----------------------------------------------------------------------------- bool Manager::SetValueListSelection ( ValueID const& _id, string const& _selectedItem ) { bool res = false; if( ValueID::ValueType_List == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { if( _id.GetNodeId() != driver->GetNodeId() ) { driver->LockNodes(); if( ValueList* value = static_cast( driver->GetValue( _id ) ) ) { res = value->SetByLabel( _selectedItem ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValueListSelection"); } driver->ReleaseNodes(); } } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to SetValueListSelection is not a List Value"); } return res; } //----------------------------------------------------------------------------- // // Sets the value from a string //----------------------------------------------------------------------------- bool Manager::SetValue ( ValueID const& _id, string const& _value ) { bool res = false; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { if( _id.GetNodeId() != driver->GetNodeId() ) { driver->LockNodes(); switch( _id.GetType() ) { case ValueID::ValueType_Bool: { if( ValueBool* value = static_cast( driver->GetValue( _id ) ) ) { if( !strcasecmp( "true", _value.c_str() ) ) { res = value->Set( true ); } else if( !strcasecmp( "false", _value.c_str() ) ) { res = value->Set( false ); } value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } break; } case ValueID::ValueType_Byte: { if( ValueByte* value = static_cast( driver->GetValue( _id ) ) ) { uint32 val = (uint32)atoi( _value.c_str() ); if( val < 256 ) { res = value->Set( (uint8)val ); } value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } break; } case ValueID::ValueType_Decimal: { if( ValueDecimal* value = static_cast( driver->GetValue( _id ) ) ) { res = value->Set( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } break; } case ValueID::ValueType_Int: { if( ValueInt* value = static_cast( driver->GetValue( _id ) ) ) { int32 val = atoi( _value.c_str() ); res = value->Set( val ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } break; } case ValueID::ValueType_List: { if( ValueList* value = static_cast( driver->GetValue( _id ) ) ) { res = value->SetByLabel( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } break; } case ValueID::ValueType_Short: { if( ValueShort* value = static_cast( driver->GetValue( _id ) ) ) { int32 val = (uint32)atoi( _value.c_str() ); if( ( val < 32768 ) && ( val >= -32768 ) ) { res = value->Set( (int16)val ); } value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } break; } case ValueID::ValueType_String: { if( ValueString* value = static_cast( driver->GetValue( _id ) ) ) { res = value->Set( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } break; } case ValueID::ValueType_Raw: { if( ValueRaw* value = static_cast( driver->GetValue( _id ) ) ) { res = value->SetFromString( _value ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetValue"); } break; } case ValueID::ValueType_Schedule: case ValueID::ValueType_Button: { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetValueFloatPrecision is not a Decimal Value"); break; } } driver->ReleaseNodes(); } } return res; } //----------------------------------------------------------------------------- // // Instruct the driver to refresh this value by sending a message to the device //----------------------------------------------------------------------------- bool Manager::RefreshValue ( ValueID const& _id ) { bool bRet = false; // return value if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { Node *node; // Need to lock and unlock nodes to check this information driver->LockNodes(); if( (node = driver->GetNodeUnsafe( _id.GetNodeId() ) ) != NULL) { CommandClass* cc = node->GetCommandClass( _id.GetCommandClassId() ); if (cc) { uint8 index = _id.GetIndex(); uint8 instance = _id.GetInstance(); Log::Write( LogLevel_Info, "mgr, Refreshing node %d: %s index = %d instance = %d (to confirm a reported change)", node->m_nodeId, cc->GetCommandClassName().c_str(), index, instance ); cc->RequestValue( 0, index, instance, Driver::MsgQueue_Send ); bRet = true; } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to RefreshValue"); bRet = false; } } driver->ReleaseNodes(); } return bRet; } //----------------------------------------------------------------------------- // // Set the verify changes flag for the specified value //----------------------------------------------------------------------------- void Manager::SetChangeVerified ( ValueID const& _id, bool _verify ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { value->SetChangeVerified( _verify ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetChangeVerified"); } driver->ReleaseNodes(); } } //----------------------------------------------------------------------------- // // Get the verify changes flag for the specified value //----------------------------------------------------------------------------- bool Manager::GetChangeVerified ( ValueID const& _id ) { bool res = false; if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( Value* value = driver->GetValue( _id ) ) { res = value->GetChangeVerified(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetChangeVerified"); } driver->ReleaseNodes(); } return res; } //----------------------------------------------------------------------------- // // Starts an activity in a device. //----------------------------------------------------------------------------- bool Manager::PressButton ( ValueID const& _id ) { bool res = false; if( ValueID::ValueType_Button == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueButton* value = static_cast( driver->GetValue( _id ) ) ) { res = value->PressButton(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to PressButton"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to PressButton is not a Button Value"); } return res; } //----------------------------------------------------------------------------- // // Stops an activity in a device. //----------------------------------------------------------------------------- bool Manager::ReleaseButton ( ValueID const& _id ) { bool res = false; if( ValueID::ValueType_Button == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueButton* value = static_cast( driver->GetValue( _id ) ) ) { res = value->ReleaseButton(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to ReleaseButton"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to ReleaseButton is not a Button Value"); } return res; } //----------------------------------------------------------------------------- // Climate Control Schedules //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Get the number of switch points defined in a schedule //----------------------------------------------------------------------------- uint8 Manager::GetNumSwitchPoints ( ValueID const& _id ) { // bool res = false; uint8 numSwitchPoints = 0; if( ValueID::ValueType_Schedule == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueSchedule* value = static_cast( driver->GetValue( _id ) ) ) { numSwitchPoints = value->GetNumSwitchPoints(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetNumSwitchPoints"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetNumSwitchPoints is not a Schedule Value"); } return numSwitchPoints; } //----------------------------------------------------------------------------- // // Set a switch point in the schedule //----------------------------------------------------------------------------- bool Manager::SetSwitchPoint ( ValueID const& _id, uint8 const _hours, uint8 const _minutes, int8 const _setback ) { bool res = false; if( ValueID::ValueType_Schedule == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueSchedule* value = static_cast( driver->GetValue( _id ) ) ) { res = value->SetSwitchPoint( _hours, _minutes, _setback ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to SetSwitchPoint"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to SetSwitchPoint is not a Schedule Value"); } return res; } //----------------------------------------------------------------------------- // // Remove a switch point from the schedule //----------------------------------------------------------------------------- bool Manager::RemoveSwitchPoint ( ValueID const& _id, uint8 const _hours, uint8 const _minutes ) { bool res = false; if( ValueID::ValueType_Schedule == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueSchedule* value = static_cast( driver->GetValue( _id ) ) ) { uint8 idx; res = value->FindSwitchPoint( _hours, _minutes, &idx ); if( res ) { res = value->RemoveSwitchPoint( idx ); } value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to RemoveSwitchPoint"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to RemoveSwitchPoint is not a Schedule Value"); } return res; } //----------------------------------------------------------------------------- // // Clears all switch points from the schedule //----------------------------------------------------------------------------- void Manager::ClearSwitchPoints ( ValueID const& _id ) { if( ValueID::ValueType_Schedule == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueSchedule* value = static_cast( driver->GetValue( _id ) ) ) { value->ClearSwitchPoints(); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to ClearSwitchPoints"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to ClearSwitchPoints is not a Schedule Value"); } } //----------------------------------------------------------------------------- // // Gets switch point data from the schedule //----------------------------------------------------------------------------- bool Manager::GetSwitchPoint ( ValueID const& _id, uint8 const _idx, uint8* o_hours, uint8* o_minutes, int8* o_setback ) { bool res = false; if( ValueID::ValueType_Schedule == _id.GetType() ) { if( Driver* driver = GetDriver( _id.GetHomeId() ) ) { driver->LockNodes(); if( ValueSchedule* value = static_cast( driver->GetValue( _id ) ) ) { res = value->GetSwitchPoint( _idx, o_hours, o_minutes, o_setback ); value->Release(); } else { OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetSwitchPoint"); } driver->ReleaseNodes(); } } else { OZW_ERROR(OZWException::OZWEXCEPTION_CANNOT_CONVERT_VALUEID, "ValueID passed to GetSwitchPoint is not a Schedule Value"); } return res; } //----------------------------------------------------------------------------- // SwitchAll //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // All devices that support the SwitchAll command class will be turned on //----------------------------------------------------------------------------- void Manager::SwitchAllOn ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->SwitchAllOn(); } } //----------------------------------------------------------------------------- // // All devices that support the SwitchAll command class will be turned off //----------------------------------------------------------------------------- void Manager::SwitchAllOff ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->SwitchAllOff(); } } //----------------------------------------------------------------------------- // Configuration Parameters //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Set the value of one of the configuration parameters of a device //----------------------------------------------------------------------------- bool Manager::SetConfigParam ( uint32 const _homeId, uint8 const _nodeId, uint8 const _param, int32 _value, uint8 const _size ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->SetConfigParam( _nodeId, _param, _value, _size ); } return false; } //----------------------------------------------------------------------------- // // Request the value of one of the configuration parameters of a device //----------------------------------------------------------------------------- void Manager::RequestConfigParam ( uint32 const _homeId, uint8 const _nodeId, uint8 const _param ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->RequestConfigParam( _nodeId, _param ); } } //----------------------------------------------------------------------------- // // Request the values of all of the known configuration parameters of a device //----------------------------------------------------------------------------- void Manager::RequestAllConfigParams ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { Node* node = driver->GetNode( _nodeId ); if( node ) { node->SetQueryStage( Node::QueryStage_Configuration ); driver->ReleaseNodes(); } } } //----------------------------------------------------------------------------- // Groups //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Gets the number of association groups reported by this node //----------------------------------------------------------------------------- uint8 Manager::GetNumGroups ( uint32 const _homeId, uint8 const _nodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetNumGroups( _nodeId ); } return 0; } //----------------------------------------------------------------------------- // // Gets the associations for a group //----------------------------------------------------------------------------- uint32 Manager::GetAssociations ( uint32 const _homeId, uint8 const _nodeId, uint8 const _groupIdx, uint8** o_associations ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetAssociations( _nodeId, _groupIdx, o_associations ); } return 0; } //----------------------------------------------------------------------------- // // Gets the maximum number of associations for a group //----------------------------------------------------------------------------- uint8 Manager::GetMaxAssociations ( uint32 const _homeId, uint8 const _nodeId, uint8 const _groupIdx ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetMaxAssociations( _nodeId, _groupIdx ); } return 0; } //----------------------------------------------------------------------------- // // Gets the label for a particular group //----------------------------------------------------------------------------- string Manager::GetGroupLabel ( uint32 const _homeId, uint8 const _nodeId, uint8 const _groupIdx ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->GetGroupLabel( _nodeId, _groupIdx ); } return ""; } //----------------------------------------------------------------------------- // // Adds a node to an association group //----------------------------------------------------------------------------- void Manager::AddAssociation ( uint32 const _homeId, uint8 const _nodeId, uint8 const _groupIdx, uint8 const _targetNodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->AddAssociation( _nodeId, _groupIdx, _targetNodeId ); } } //----------------------------------------------------------------------------- // // Removes a node from an association group //----------------------------------------------------------------------------- void Manager::RemoveAssociation ( uint32 const _homeId, uint8 const _nodeId, uint8 const _groupIdx, uint8 const _targetNodeId ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->RemoveAssociation( _nodeId, _groupIdx, _targetNodeId ); } } //----------------------------------------------------------------------------- // Notifications //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Add a watcher to the list //----------------------------------------------------------------------------- bool Manager::AddWatcher ( pfnOnNotification_t _watcher, void* _context ) { // Ensure this watcher is not already on the list m_notificationMutex->Lock(); for( list::iterator it = m_watchers.begin(); it != m_watchers.end(); ++it ) { if( ((*it)->m_callback == _watcher ) && ( (*it)->m_context == _context ) ) { // Already in the list m_notificationMutex->Unlock(); return false; } } m_watchers.push_back( new Watcher( _watcher, _context ) ); m_notificationMutex->Unlock(); return true; } //----------------------------------------------------------------------------- // // Remove a watcher from the list //----------------------------------------------------------------------------- bool Manager::RemoveWatcher ( pfnOnNotification_t _watcher, void* _context ) { m_notificationMutex->Lock(); list::iterator it = m_watchers.begin(); while( it != m_watchers.end() ) { if( ((*it)->m_callback == _watcher ) && ( (*it)->m_context == _context ) ) { delete (*it); m_watchers.erase( it ); m_notificationMutex->Unlock(); return true; } ++it; } m_notificationMutex->Unlock(); return false; } //----------------------------------------------------------------------------- // // Notify any watching objects of a value change //----------------------------------------------------------------------------- void Manager::NotifyWatchers ( Notification* _notification ) { m_notificationMutex->Lock(); for( list::iterator it = m_watchers.begin(); it != m_watchers.end(); ++it ) { Watcher* pWatcher = *it; pWatcher->m_callback( _notification, pWatcher->m_context ); } m_notificationMutex->Unlock(); } //----------------------------------------------------------------------------- // Controller commands //----------------------------------------------------------------------------- //----------------------------------------------------------------------------- // // Reset controller and erase all node information //----------------------------------------------------------------------------- void Manager::ResetController ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { Event *event = new Event(); driver->ResetController( event ); Wait::Single( event ); event->Release(); string path = driver->GetControllerPath(); Driver::ControllerInterface intf = driver->GetControllerInterfaceType(); RemoveDriver( path ); AddDriver( path, intf ); Wait::Multiple( NULL, 0, 500 ); } RemoveAllScenes( _homeId ); } //----------------------------------------------------------------------------- // // Soft-reset the Z-Wave controller chip //----------------------------------------------------------------------------- void Manager::SoftReset ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->SoftReset(); } } //----------------------------------------------------------------------------- // // Start the controller performing one of its network management functions //----------------------------------------------------------------------------- bool Manager::BeginControllerCommand ( uint32 const _homeId, Driver::ControllerCommand _command, Driver::pfnControllerCallback_t _callback, // = NULL void* _context, // = NULL bool _highPower, // = false uint8 _nodeId, // = 0xff uint8 _arg // = 0 ) { if( Driver* driver = GetDriver( _homeId ) ) { return driver->BeginControllerCommand( _command, _callback, _context, _highPower, _nodeId, _arg ); } return false; } //----------------------------------------------------------------------------- // // Stop the current controller function //----------------------------------------------------------------------------- bool Manager::CancelControllerCommand ( uint32 const _homeId ) { if( Driver* driver = GetDriver( _homeId ) ) { return( driver->CancelControllerCommand() ); } return false; } //----------------------------------------------------------------------------- // // Send a number of test messages to a node and record results. //----------------------------------------------------------------------------- void Manager::TestNetworkNode ( uint32 const _homeId, uint8 const _nodeId, uint32 const _count ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->TestNetwork( _nodeId, _count ); } } //----------------------------------------------------------------------------- // // Send a number of test messages to every node and record results. //----------------------------------------------------------------------------- void Manager::TestNetwork ( uint32 const _homeId, uint32 const _count ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->TestNetwork( 0, _count ); } } //----------------------------------------------------------------------------- // // Heal a single node in the network //----------------------------------------------------------------------------- void Manager::HealNetworkNode ( uint32 const _homeId, uint8 const _nodeId, bool _doRR ) { if( Driver* driver = GetDriver( _homeId ) ) { Node* node = driver->GetNode( _nodeId ); if( node ) { driver->BeginControllerCommand( Driver::ControllerCommand_RequestNodeNeighborUpdate, NULL, NULL, true, _nodeId, 0 ); if( _doRR ) { driver->UpdateNodeRoutes( _nodeId, true ); } driver->ReleaseNodes(); } } } //----------------------------------------------------------------------------- // // Heal the Z-Wave network one node at a time. //----------------------------------------------------------------------------- void Manager::HealNetwork ( uint32 const _homeId, bool _doRR ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->LockNodes(); for( uint8 i=0; i<255; i++ ) { if( driver->m_nodes[i] != NULL ) { driver->BeginControllerCommand( Driver::ControllerCommand_RequestNodeNeighborUpdate, NULL, NULL, true, i, 0 ); if( _doRR ) { driver->UpdateNodeRoutes( i, true ); } } } driver->ReleaseNodes(); } } //----------------------------------------------------------------------------- // // Return the number of defined scenes. //----------------------------------------------------------------------------- uint8 Manager::GetNumScenes ( ) { return Scene::s_sceneCnt; } //----------------------------------------------------------------------------- // // Return an array of all Scene Ids //----------------------------------------------------------------------------- uint8 Manager::GetAllScenes ( uint8** _sceneIds ) { *_sceneIds = NULL; return Scene::GetAllScenes( _sceneIds ); } //----------------------------------------------------------------------------- // // Remove every scene id //----------------------------------------------------------------------------- void Manager::RemoveAllScenes ( uint32 const _homeId ) { for( int i = 1; i < 256; i++ ) { if( _homeId == 0 ) // remove every device from every scene { RemoveScene( i ); } else { Scene *scene = Scene::Get( i ); if( scene != NULL ) { scene->RemoveValues( _homeId ); } } } } //----------------------------------------------------------------------------- // // Create a new scene and return new Scene ID. //----------------------------------------------------------------------------- uint8 Manager::CreateScene ( ) { for( int i = 1; i < 256; i++ ) { Scene* scene = Scene::Get( i ); if( scene != NULL ) { continue; } new Scene( i ); return i; } return 0; } //----------------------------------------------------------------------------- // // Remove scene and delete its contents //----------------------------------------------------------------------------- bool Manager::RemoveScene ( uint8 const _sceneId ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { delete scene; return true; } return false; } //----------------------------------------------------------------------------- // // Add a bool ValueID/value pair to the scene //----------------------------------------------------------------------------- bool Manager::AddSceneValue ( uint8 const _sceneId, ValueID const& _valueId, bool const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->AddValue( _valueId, _value ? "True" : "False"); } return false; } //----------------------------------------------------------------------------- // // Add a byte ValueID/value pair to the scene //----------------------------------------------------------------------------- bool Manager::AddSceneValue ( uint8 const _sceneId, ValueID const& _valueId, uint8 const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%d", _value ); return scene->AddValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Add a decimal ValueID/value pair to the scene //----------------------------------------------------------------------------- bool Manager::AddSceneValue ( uint8 const _sceneId, ValueID const& _valueId, float const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%f", _value ); return scene->AddValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Add an integer ValueID/value pair to the scene //----------------------------------------------------------------------------- bool Manager::AddSceneValue ( uint8 const _sceneId, ValueID const& _valueId, int32 const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%d", _value ); return scene->AddValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Add a short ValueID/value pair to the scene //----------------------------------------------------------------------------- bool Manager::AddSceneValue ( uint8 const _sceneId, ValueID const& _valueId, int16 const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%d", _value ); return scene->AddValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Add a string ValueID/value pair to the scene //----------------------------------------------------------------------------- bool Manager::AddSceneValue ( uint8 const _sceneId, ValueID const& _valueId, string const& _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->AddValue( _valueId, _value ); } return false; } //----------------------------------------------------------------------------- // // Add a list selection item ValueID/value pair to the scene (as string) //----------------------------------------------------------------------------- bool Manager::AddSceneValueListSelection ( uint8 const _sceneId, ValueID const& _valueId, string const& _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->AddValue( _valueId, _value ); } return false; } //----------------------------------------------------------------------------- // // Add a list selection item ValueID/value pair to the scene (as integer) //----------------------------------------------------------------------------- bool Manager::AddSceneValueListSelection ( uint8 const _sceneId, ValueID const& _valueId, int32 const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%d", _value ); return scene->AddValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Remove a ValueID/value pair from the scene //----------------------------------------------------------------------------- bool Manager::RemoveSceneValue ( uint8 const _sceneId, ValueID const& _valueId ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->RemoveValue( _valueId ); } return false; } //----------------------------------------------------------------------------- // // Return a scene's Value ID //----------------------------------------------------------------------------- int Manager::SceneGetValues ( uint8 const _sceneId, vector* o_value ) { o_value->clear(); Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->GetValues( o_value ); } return 0; } //----------------------------------------------------------------------------- // // Return a scene's Value ID bool value //----------------------------------------------------------------------------- bool Manager::SceneGetValueAsBool ( uint8 const _sceneId, ValueID const& _valueId, bool* o_value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { string str; if( scene->GetValue( _valueId, &str ) ) { *o_value = !strcasecmp( "true", str.c_str() ); return true; } } return false; } //----------------------------------------------------------------------------- // // Return a scene's Value ID byte value //----------------------------------------------------------------------------- bool Manager::SceneGetValueAsByte ( uint8 const _sceneId, ValueID const& _valueId, uint8* o_value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { string str; if( scene->GetValue( _valueId, &str ) ) { *o_value = (uint8)atoi( str.c_str() ); return true; } } return false; } //----------------------------------------------------------------------------- // // Return a scene's Value ID float value //----------------------------------------------------------------------------- bool Manager::SceneGetValueAsFloat ( uint8 const _sceneId, ValueID const& _valueId, float* o_value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { string str; if( scene->GetValue( _valueId, &str ) ) { *o_value = (float)atof( str.c_str() ); return true; } } return false; } //----------------------------------------------------------------------------- // // Return a scene's Value ID integer value //----------------------------------------------------------------------------- bool Manager::SceneGetValueAsInt ( uint8 const _sceneId, ValueID const& _valueId, int32* o_value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { string str; if( scene->GetValue( _valueId, &str ) ) { *o_value = (int32)atoi( str.c_str() ); return true; } } return false; } //----------------------------------------------------------------------------- // // Return a scene's Value ID short value //----------------------------------------------------------------------------- bool Manager::SceneGetValueAsShort ( uint8 const _sceneId, ValueID const& _valueId, int16* o_value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { string str; if( scene->GetValue( _valueId, &str ) ) { *o_value = (int16)atoi( str.c_str() ); return true; } } return false; } //----------------------------------------------------------------------------- // // Return a scene's Value ID string value //----------------------------------------------------------------------------- bool Manager::SceneGetValueAsString ( uint8 const _sceneId, ValueID const& _valueId, string* o_value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { if( scene->GetValue( _valueId, o_value ) ) { return true; } } return false; } //----------------------------------------------------------------------------- // // Return a scene's Value ID list selection (as string) value //----------------------------------------------------------------------------- bool Manager::SceneGetValueListSelection ( uint8 const _sceneId, ValueID const& _valueId, string* o_value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { if( scene->GetValue( _valueId, o_value ) ) { return true; } } return false; } //----------------------------------------------------------------------------- // // Return a scene's Value ID list selection (as integer) value //----------------------------------------------------------------------------- bool Manager::SceneGetValueListSelection ( uint8 const _sceneId, ValueID const& _valueId, int32* o_value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { string str; if( scene->GetValue( _valueId, &str ) ) { *o_value = (int32)atoi( str.c_str() ); return true; } } return false; } //----------------------------------------------------------------------------- // // Set a scene's ValueID bool value. //----------------------------------------------------------------------------- bool Manager::SetSceneValue ( uint8 const _sceneId, ValueID const& _valueId, bool const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->SetValue( _valueId, _value ? "True" : "False" ); } return false; } //----------------------------------------------------------------------------- // // Set a scene's ValueID byte value. //----------------------------------------------------------------------------- bool Manager::SetSceneValue ( uint8 const _sceneId, ValueID const& _valueId, uint8 const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%d", _value ); return scene->SetValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Set a scene's ValueID float value. //----------------------------------------------------------------------------- bool Manager::SetSceneValue ( uint8 const _sceneId, ValueID const& _valueId, float const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%f", _value ); return scene->SetValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Set a scene's ValueID integer value. //----------------------------------------------------------------------------- bool Manager::SetSceneValue ( uint8 const _sceneId, ValueID const& _valueId, int32 const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%d", _value ); return scene->SetValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Set a scene's ValueID short value. //----------------------------------------------------------------------------- bool Manager::SetSceneValue ( uint8 const _sceneId, ValueID const& _valueId, int16 const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%d", _value ); return scene->SetValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Set a scene's ValueID string value. //----------------------------------------------------------------------------- bool Manager::SetSceneValue ( uint8 const _sceneId, ValueID const& _valueId, string const& _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->SetValue( _valueId, _value ); } return false; } //----------------------------------------------------------------------------- // // Set a scene's ValueID list item value (as string). //----------------------------------------------------------------------------- bool Manager::SetSceneValueListSelection ( uint8 const _sceneId, ValueID const& _valueId, string const& _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->SetValue( _valueId, _value ); } return false; } //----------------------------------------------------------------------------- // // Set a scene's ValueID list item value (as integer). //----------------------------------------------------------------------------- bool Manager::SetSceneValueListSelection ( uint8 const _sceneId, ValueID const& _valueId, int32 const _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { char str[16]; snprintf( str, sizeof(str), "%d", _value ); return scene->SetValue( _valueId, str ); } return false; } //----------------------------------------------------------------------------- // // Return a scene's label //----------------------------------------------------------------------------- string Manager::GetSceneLabel ( uint8 const _sceneId ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->GetLabel(); } return NULL; } //----------------------------------------------------------------------------- // // Set a scene's label //----------------------------------------------------------------------------- void Manager::SetSceneLabel ( uint8 const _sceneId, string const& _value ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { scene->SetLabel( _value ); } } //----------------------------------------------------------------------------- // // Check if a Scene ID exists //----------------------------------------------------------------------------- bool Manager::SceneExists ( uint8 const _sceneId ) { return Scene::Get( _sceneId ) != NULL; } //----------------------------------------------------------------------------- // // Perform all the settings for the given Scene ID //----------------------------------------------------------------------------- bool Manager::ActivateScene ( uint8 const _sceneId ) { Scene *scene = Scene::Get( _sceneId ); if( scene != NULL ) { return scene->Activate(); } return false; } //----------------------------------------------------------------------------- // // Retrieve driver based counters. //----------------------------------------------------------------------------- void Manager::GetDriverStatistics ( uint32 const _homeId, Driver::DriverData* _data ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->GetDriverStatistics( _data ); } } //----------------------------------------------------------------------------- // // Retrieve driver based counters. //----------------------------------------------------------------------------- void Manager::GetNodeStatistics ( uint32 const _homeId, uint8 const _nodeId, Node::NodeData* _data ) { if( Driver* driver = GetDriver( _homeId ) ) { driver->GetNodeStatistics( _nodeId, _data ); } }