//----------------------------------------------------------------------------- // // Basic.cpp // // Implementation of the Z-Wave COMMAND_CLASS_BASIC // // 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 "CommandClasses.h" #include "Basic.h" #include "Association.h" #include "../Defs.h" #include "../Msg.h" #include "../Node.h" #include "../Driver.h" #include "../Notification.h" #include "../platform/Log.h" #include "../value_classes/ValueByte.h" #include "NoOperation.h" #include "../tinyxml.h" using namespace OpenZWave; enum BasicCmd { BasicCmd_Set = 0x01, BasicCmd_Get = 0x02, BasicCmd_Report = 0x03 }; //----------------------------------------------------------------------------- // // Constructor //----------------------------------------------------------------------------- Basic::Basic ( uint32 const _homeId, uint8 const _nodeId ): CommandClass( _homeId, _nodeId ), m_mapping( 0 ), m_ignoreMapping( false ), m_setAsReport( false ) { } //----------------------------------------------------------------------------- // // Read configuration. //----------------------------------------------------------------------------- void Basic::ReadXML ( TiXmlElement const* _ccElement ) { CommandClass::ReadXML( _ccElement ); char const* str = _ccElement->Attribute("ignoremapping"); if( str ) { m_ignoreMapping = !strcmp( str, "true"); } int32 intVal; if( TIXML_SUCCESS == _ccElement->QueryIntAttribute( "mapping", &intVal ) ) { if( intVal < 256 && intVal != 0 ) { SetMapping( (uint8)intVal, false ); } } str = _ccElement->Attribute("setasreport"); if( str ) { m_setAsReport = !strcmp( str, "true"); } } //----------------------------------------------------------------------------- // // Save changed configuration //----------------------------------------------------------------------------- void Basic::WriteXML ( TiXmlElement* _ccElement ) { CommandClass::WriteXML( _ccElement ); if( m_ignoreMapping ) { _ccElement->SetAttribute( "ignoremapping", "true" ); } char str[32]; if( m_mapping != 0 ) { snprintf( str, sizeof(str), "%d", m_mapping ); _ccElement->SetAttribute( "mapping", str ); } if( m_setAsReport ) { _ccElement->SetAttribute( "setasreport", "true" ); } } //----------------------------------------------------------------------------- // // Request current state from the device //----------------------------------------------------------------------------- bool Basic::RequestState ( uint32 const _requestFlags, uint8 const _instance, Driver::MsgQueue const _queue ) { if( _requestFlags & RequestFlag_Dynamic ) { return RequestValue( _requestFlags, 0, _instance, _queue ); } return false; } //----------------------------------------------------------------------------- // // Request current state from the device //----------------------------------------------------------------------------- bool Basic::RequestValue ( uint32 const _requestFlags, uint8 const _dummy1, // = 0 (not used) uint8 const _instance, Driver::MsgQueue const _queue ) { if ( IsGetSupported() ) { Msg* msg = new Msg( "BasicCmd_Get", GetNodeId(), REQUEST, FUNC_ID_ZW_SEND_DATA, true, true, FUNC_ID_APPLICATION_COMMAND_HANDLER, GetCommandClassId() ); msg->SetInstance( this, _instance ); msg->Append( GetNodeId() ); msg->Append( 2 ); msg->Append( GetCommandClassId() ); msg->Append( BasicCmd_Get ); msg->Append( GetDriver()->GetTransmitOptions() ); GetDriver()->SendMsg( msg, _queue ); return true; } else { Log::Write( LogLevel_Info, GetNodeId(), "BasicCmd_Get Not Supported on this node"); } return false; } //----------------------------------------------------------------------------- // // Handle a message from the Z-Wave network //----------------------------------------------------------------------------- bool Basic::HandleMsg ( uint8 const* _data, uint32 const _length, uint32 const _instance // = 1 ) { if( BasicCmd_Report == (BasicCmd)_data[0] ) { // Level Log::Write( LogLevel_Info, GetNodeId(), "Received Basic report from node %d: level=%d", GetNodeId(), _data[1] ); if( !m_ignoreMapping && m_mapping != 0 ) { UpdateMappedClass( _instance, m_mapping, _data[1] ); } else if( ValueByte* value = static_cast( GetValue( _instance, 0 ) ) ) { value->OnValueRefreshed( _data[1] ); value->Release(); } return true; } if( BasicCmd_Set == (BasicCmd)_data[0] ) { if( m_setAsReport ) { Log::Write( LogLevel_Info, GetNodeId(), "Received Basic set from node %d: level=%d. Treating it as a Basic report.", GetNodeId(), _data[1] ); if( !m_ignoreMapping && m_mapping != 0 ) { UpdateMappedClass( _instance, m_mapping, _data[1] ); } else if( ValueByte* value = static_cast( GetValue( _instance, 0 ) ) ) { value->OnValueRefreshed( _data[1] ); value->Release(); } } else { // Commmand received from the node. Handle as a notification event Log::Write( LogLevel_Info, GetNodeId(), "Received Basic set from node %d: level=%d. Sending event notification.", GetNodeId(), _data[1] ); Notification* notification = new Notification( Notification::Type_NodeEvent ); notification->SetHomeNodeIdAndInstance( GetHomeId(), GetNodeId(), _instance ); notification->SetEvent( _data[1] ); GetDriver()->QueueNotification( notification ); } return true; } return false; } //----------------------------------------------------------------------------- // // Set a value on the Z-Wave device //----------------------------------------------------------------------------- bool Basic::SetValue ( Value const& _value ) { if( ValueID::ValueType_Byte == _value.GetID().GetType() ) { ValueByte const* value = static_cast(&_value); Log::Write( LogLevel_Info, GetNodeId(), "Basic::Set - Setting node %d to level %d", GetNodeId(), value->GetValue() ); Msg* msg = new Msg( "Basic Set", GetNodeId(), REQUEST, FUNC_ID_ZW_SEND_DATA, true ); msg->SetInstance( this, _value.GetID().GetInstance() ); msg->Append( GetNodeId() ); msg->Append( 3 ); msg->Append( GetCommandClassId() ); msg->Append( BasicCmd_Set ); msg->Append( value->GetValue() ); msg->Append( GetDriver()->GetTransmitOptions() ); GetDriver()->SendMsg( msg, Driver::MsgQueue_Send ); return true; } return false; } //----------------------------------------------------------------------------- // // Create the values managed by this command class //----------------------------------------------------------------------------- void Basic::CreateVars ( uint8 const _instance ) { if( m_mapping == 0 ) { if( Node* node = GetNodeUnsafe() ) { node->CreateValueByte( ValueID::ValueGenre_Basic, GetCommandClassId(), _instance, 0, "Basic", "", false, false, 0, 0 ); } } } //----------------------------------------------------------------------------- // // Helper method to set the level //----------------------------------------------------------------------------- void Basic::Set ( uint8 const _level ) { // This may look like a long winded way to do this, but // it ensures that all the proper notifications get sent. if( ValueByte* value = static_cast( GetValue( 1, 0 ) ) ) { value->Set( _level ); value->Release(); } } //----------------------------------------------------------------------------- // // Map COMMAND_CLASS_BASIC messages to another command class //----------------------------------------------------------------------------- bool Basic::SetMapping ( uint8 const _commandClassId, bool const _doLog ) { bool res = false; if( _commandClassId != NoOperation::StaticGetCommandClassId() ) { if( _doLog ) { char str[16]; snprintf( str, sizeof(str), "0x%02x", _commandClassId ); string ccstr = str; if( Node const* node = GetNodeUnsafe() ) { if( CommandClass* cc = node->GetCommandClass( _commandClassId ) ) { ccstr = cc->GetCommandClassName(); } } if( m_ignoreMapping ) { Log::Write( LogLevel_Info, GetNodeId(), " COMMAND_CLASS_BASIC will not be mapped to %s (ignored)", ccstr.c_str() ); } else { Log::Write( LogLevel_Info, GetNodeId(), " COMMAND_CLASS_BASIC will be mapped to %s", ccstr.c_str() ); } } m_mapping = _commandClassId; RemoveValue( 1, 0 ); res = true; } if( m_mapping == 0 && _doLog ) { Log::Write( LogLevel_Info, GetNodeId(), " COMMAND_CLASS_BASIC is not mapped" ); } return res; }