1 /*
2 * Copyright (c) 2015 - 2018, 2020, The Linux Foundation. All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without modification, are permitted
5 * provided that the following conditions are met:
6 *    * Redistributions of source code must retain the above copyright notice, this list of
7 *      conditions and the following disclaimer.
8 *    * Redistributions in binary form must reproduce the above copyright notice, this list of
9 *      conditions and the following disclaimer in the documentation and/or other materials provided
10 *      with the distribution.
11 *    * Neither the name of The Linux Foundation nor the names of its contributors may be used to
12 *      endorse or promote products derived from this software without specific prior written
13 *      permission.
14 *
15 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
16 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
17 * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
19 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
20 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
21 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
22 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23 */
24 
25 #ifndef __EXTENSION_INTERFACE_H__
26 #define __EXTENSION_INTERFACE_H__
27 
28 #include <core/sdm_types.h>
29 #include <core/display_interface.h>
30 
31 #include "partial_update_interface.h"
32 #include "strategy_interface.h"
33 #include "resource_interface.h"
34 #include "dpps_control_interface.h"
35 
36 namespace sdm {
37 
38 #define EXTENSION_LIBRARY_NAME "libsdmextension.so"
39 #define CREATE_EXTENSION_INTERFACE_NAME "CreateExtensionInterface"
40 #define DESTROY_EXTENSION_INTERFACE_NAME "DestroyExtensionInterface"
41 
42 #define EXTENSION_REVISION_MAJOR (2)
43 #define EXTENSION_REVISION_MINOR (0)
44 
45 #define EXTENSION_VERSION_TAG ((uint16_t) ((EXTENSION_REVISION_MAJOR << 8) \
46                                           | EXTENSION_REVISION_MINOR))
47 
48 class ExtensionInterface;
49 
50 typedef DisplayError (*CreateExtensionInterface)(uint16_t version, ExtensionInterface **interface);
51 typedef DisplayError (*DestroyExtensionInterface)(ExtensionInterface *interface);
52 
53 class ExtensionInterface {
54  public:
55   virtual DisplayError CreatePartialUpdate(int32_t display_id, DisplayType type,
56                                            const HWResourceInfo &hw_resource_info,
57                                            const HWPanelInfo &hw_panel_info,
58                                            const HWMixerAttributes &mixer_attributes,
59                                            const HWDisplayAttributes &display_attributes,
60                                            const DisplayConfigVariableInfo &fb_config,
61                                            PartialUpdateInterface **interface) = 0;
62   virtual DisplayError DestroyPartialUpdate(PartialUpdateInterface *interface) = 0;
63 
64   virtual DisplayError CreateStrategyExtn(int32_t display_id, DisplayType type,
65                                           BufferAllocator *buffer_allocator,
66                                           const HWResourceInfo &hw_resource_info,
67                                           const HWPanelInfo &hw_panel_info,
68                                           const HWMixerAttributes &mixer_attributes,
69                                           const DisplayConfigVariableInfo &fb_config,
70                                           StrategyInterface **interface) = 0;
71   virtual DisplayError DestroyStrategyExtn(StrategyInterface *interface) = 0;
72 
73   virtual DisplayError CreateResourceExtn(const HWResourceInfo &hw_resource_info,
74                                           BufferAllocator *buffer_allocator,
75                                           ResourceInterface **interface) = 0;
76   virtual DisplayError DestroyResourceExtn(ResourceInterface *interface) = 0;
77   virtual DisplayError CreateDppsControlExtn(DppsControlInterface **dpps_control_interface,
78                                              SocketHandler *socket_handler) = 0;
79   virtual DisplayError DestroyDppsControlExtn(DppsControlInterface *interface) = 0;
80 
81  protected:
~ExtensionInterface()82   virtual ~ExtensionInterface() { }
83 };
84 
85 }  // namespace sdm
86 
87 #endif  // __EXTENSION_INTERFACE_H__
88 
89