1e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler/* 2e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * Copyright (C) 2016 The Android Open Source Project 3e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * 4e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * Licensed under the Apache License, Version 2.0 (the "License"); 5e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * you may not use this file except in compliance with the License. 6e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * You may obtain a copy of the License at 7e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * 8e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * http://www.apache.org/licenses/LICENSE-2.0 9e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * 10e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * Unless required by applicable law or agreed to in writing, software 11e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * distributed under the License is distributed on an "AS IS" BASIS, 12e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * See the License for the specific language governing permissions and 14e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler * limitations under the License. 15e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler */ 16e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 1753ae6a87c685623d8b7cb6e9bbd7f27da501af81Mattias Nissler#ifndef NVRAM_HAL_NVRAM_DEVICE_ADAPTER_H_ 1853ae6a87c685623d8b7cb6e9bbd7f27da501af81Mattias Nissler#define NVRAM_HAL_NVRAM_DEVICE_ADAPTER_H_ 1953ae6a87c685623d8b7cb6e9bbd7f27da501af81Mattias Nissler 2043fec02506fc163a232af191d0d5460d994eae91Elliott Hughes#include <memory> 21e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 22e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler#include <hardware/nvram.h> 23e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler#include <nvram/messages/nvram_messages.h> 24e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 25e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nisslernamespace nvram { 26e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 27e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// |NvramImplementation| subclasses provide an implementation of the NVRAM HAL 28e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// logic. 29e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nisslerclass NvramImplementation { 30e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler public: 31e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler virtual ~NvramImplementation() = default; 32e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 33e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler // This function services all operations defined for the NVRAM HAL. The input 34e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler // parameters are passed in |request| and |response| will be filled in with 35e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler // the result and output parameters of the operation. 36e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler virtual void Execute(const nvram::Request& request, 37e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler nvram::Response* response) = 0; 38e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler}; 39e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 40e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// |NvramDeviceAdapater| provides glue to turn an |NvramImplementation| object 41e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// into an |nvram_device_t| as defined by the NVRAM HAL C API. This is intended 42e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// to be used in the HAL module's |open()| operation. To obtain the desired 43e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// |hw_device_t|, just create an |NvramDeviceAdapter| with a suitable 44e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// |NvramImplementation| and call |as_device()| to get the HAL device pointer. 45e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nisslerstruct NvramDeviceAdapter { 46e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler public: 47e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler // Takes ownership of |implementation|. 48e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler NvramDeviceAdapter(const hw_module_t* module, 49e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler NvramImplementation* implementation); 50e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 51e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler hw_device_t* as_device() { return &device_.common; } 52e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler NvramImplementation* nvram_implementation() { return implementation_.get(); } 53e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 54e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler private: 55e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler nvram_device_t device_; 5643fec02506fc163a232af191d0d5460d994eae91Elliott Hughes std::unique_ptr<NvramImplementation> implementation_; 57e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler}; 58e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 59e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// Make sure |NvramDeviceAdapter| is a standard layout type. This guarantees 60e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// that casting from/to the type of the first non-static member (i.e. |device_|) 61e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler// works as expected. 62e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nisslerstatic_assert(std::is_standard_layout<NvramDeviceAdapter>::value, 63e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler "NvramDeviceAdapater must be a standard layout type."); 64e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler 65e7ddae7492c04da4650dfa8833bbc5946fe24cbcMattias Nissler} // namespace nvram 6653ae6a87c685623d8b7cb6e9bbd7f27da501af81Mattias Nissler 6753ae6a87c685623d8b7cb6e9bbd7f27da501af81Mattias Nissler#endif // NVRAM_HAL_NVRAM_DEVICE_ADAPTER_H_ 68