blob: 939bf3149a46956beaf0311a596e84f6b9b3007a [file] [log] [blame]
/*
*
* Copyright (c) 2023 Project CHIP Authors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @file
* This file contains definitions for the CHIP DeviceManager Interface
*
* This object will co-ordinate multiple activities such as
* initialisation, rendezvous, session mgmt and other such
* activities within the CHIP stack. This is a singleton object.
*/
#pragma once
#include <lib/core/CHIPCore.h>
#include <lib/core/CHIPError.h>
#include <platform/CHIPDeviceLayer.h>
#include <lib/support/DLLUtil.h>
#include <stdarg.h>
#include <stdlib.h>
namespace chip {
namespace DeviceManager {
/**
* @brief
* This class provides a skeleton for all the callback functions. The functions will be
* called by other objects within the CHIP stack for specific events.
* Applications interested in receiving specific callbacks can specialize this class and handle
* these events in their implementation of this class.
*/
class DLL_EXPORT CHIPDeviceManagerCallbacks
{
public:
/**
* @brief
* Called when CHIP Device events (PublicEventTypes) are triggered.
*
* @param event ChipDeviceEvent that occurred
* @param arg arguments specific to the event, if any
*/
virtual void DeviceEventCallback(const chip::DeviceLayer::ChipDeviceEvent * event, intptr_t arg);
virtual ~CHIPDeviceManagerCallbacks();
};
/**
* @brief
* A common class that drives other components of the CHIP stack
*/
class DLL_EXPORT CHIPDeviceManager
{
public:
CHIPDeviceManager(const CHIPDeviceManager &) = delete;
CHIPDeviceManager(const CHIPDeviceManager &&) = delete;
CHIPDeviceManager & operator=(const CHIPDeviceManager &) = delete;
static CHIPDeviceManager & GetInstance()
{
static CHIPDeviceManager instance;
return instance;
}
/**
* @brief
* Initialise CHIPDeviceManager
*
* @param cb Application's instance of the CHIPDeviceManagerCallbacks for consuming events
*/
CHIP_ERROR Init(CHIPDeviceManagerCallbacks * cb);
/**
* @brief
* Fetch a pointer to the registered CHIPDeviceManagerCallbacks object.
*
*/
CHIPDeviceManagerCallbacks * GetCHIPDeviceManagerCallbacks() { return mCB; }
/**
* Use internally for registration of the ChipDeviceEvents
*/
static void DeviceEventHandler(const chip::DeviceLayer::ChipDeviceEvent * event, intptr_t arg);
private:
CHIPDeviceManagerCallbacks * mCB = nullptr;
CHIPDeviceManager() {}
};
} // namespace DeviceManager
} // namespace chip