summaryrefslogtreecommitdiff
path: root/src/components/application_manager/rpc_plugins/rc_rpc_plugin/include/rc_rpc_plugin/rc_helpers.h
blob: 1bf4a7a259c122833d4d6e1d0e0bf7069b5dde49 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
/*
 Copyright (c) 2018, Ford Motor Company
 All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

 Redistributions of source code must retain the above copyright notice, this
 list of conditions and the following disclaimer.

 Redistributions in binary form must reproduce the above copyright notice,
 this list of conditions and the following
 disclaimer in the documentation and/or other materials provided with the
 distribution.

 Neither the name of the Ford Motor Company nor the names of its contributors
 may be used to endorse or promote products derived from this software
 without specific prior written permission.

 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef SRC_COMPONENTS_APPLICATION_MANAGER_RPC_PLUGINS_RC_RPC_PLUGIN_INCLUDE_RC_RPC_PLUGIN_RC_HELPERS_H_
#define SRC_COMPONENTS_APPLICATION_MANAGER_RPC_PLUGINS_RC_RPC_PLUGIN_INCLUDE_RC_RPC_PLUGIN_RC_HELPERS_H_

#include <map>
#include <string>
#include "application_manager/application.h"
#include "rc_rpc_plugin/rc_app_extension.h"
#include "rc_rpc_plugin/rc_rpc_types.h"

namespace rc_rpc_plugin {
class RCRPCPlugin;

/**
 * @brief The RCHelpers class contains frequently used static data
 * structures related strictly to RC
 * Converters, mapping, factory functions
 */
class RCHelpers {
 public:
  /**
   * @brief GetModuleTypeToDataMapping get mapping of module type enum naming to
   * actual module data filed name
   * @return module mapping from enum naming to filed name
   */
  static const std::function<std::string(const std::string& module_type)>
  GetModuleTypeToDataMapping();

  /**
   * @brief GetModuleTypeToDataMapping get mapping of module type enum naming to
   * actual module capabilities key
   * @return module mapping from enum naming to capabilities key
   */
  static const std::function<std::string(const std::string& module_type)>
  GetModuleTypeToCapabilitiesMapping();

  /**
   * @brief GetModuleTypesList get list of all known module types
   * @return vector contains all known module types
   */
  static const std::vector<std::string> GetModuleTypesList();

  /**
   * @brief GetRCExtension extract RC extension from application
   * @param app application to extract extension
   * @return rc extension of app is rc applicaiton, otherwise return emty shared
   * pointer.
   */
  static RCAppExtensionPtr GetRCExtension(
      application_manager::Application& app);

  enum InteriorDataAction { SUBSCRIBE, UNSUBSCRIBE, NONE };

  static smart_objects::SmartObjectSPtr CreateGetInteriorVDRequestToHMI(
      const ModuleUid& module,
      const uint32_t correlation_id,
      const InteriorDataAction action);

  static std::vector<application_manager::ApplicationSharedPtr>
  AppsSubscribedToModule(application_manager::ApplicationManager& app_mngr,
                         const ModuleUid& module);

  static std::vector<application_manager::ApplicationSharedPtr>
  AppsSubscribedToModuleType(application_manager::ApplicationManager& app_mngr,
                             const std::string& module_type);

  typedef std::map<application_manager::ApplicationSharedPtr,
                   std::vector<std::string> >
      AppsModuleTypes;

  static AppsModuleTypes GetApplicationsAllowedModuleTypes(
      application_manager::ApplicationManager& app_mngr);

  typedef std::map<std::string, mobile_apis::ButtonName::eType> ButtonsMap;

  static const std::vector<std::string> buttons_climate();

  static const std::vector<std::string> buttons_radio();

  static const ButtonsMap buttons_map();

  static std::vector<std::string> GetModuleReadOnlyParams(
      const std::string& module_type);

  /**
   * @brief Combines module ids and alloweds for these ids and fills vector with
   * ModuleConsents
   * @param module_type Module type as string
   * @param module_ids Modules ids which needed consents from driver
   * @param allowed Consents for modules
   */
  static rc_rpc_types::ModuleIdConsentVector FillModuleConsents(
      const std::string& module_type,
      const std::vector<std::string>& module_ids,
      const std::vector<bool> allowed);

  /**
   * @brief Retrieves module ids from SmartObject.
   * @param moduleIds Smartobject which contains collection of module ids
   * @return Collection of module ids
   */
  static std::vector<std::string> RetrieveModuleIds(
      const smart_objects::SmartObject& moduleIds);

  /**
   * @brief Retrieves module ids consents from SmartObject.
   * @param moduleIds Smartobject which contains collection of module ids
   * consents
   * @return Collection of module ids consents.
   */
  static std::vector<bool> RetrieveModuleConsents(
      const smart_objects::SmartObject& consents);

  /**
   * @brief RemoveRedundantGPSDataFromVIDataMsg removes redundant GPS data
   * params from interior vehicle data response message if one contains radio
   * station location data
   * @param msg_params Params of the interior vehicle data response message
   */
  static void RemoveRedundantGPSDataFromIVDataMsg(
      smart_objects::SmartObject& msg_params);

  /**
   * @brief MergeModuleData all keys and values from first parameter and
   * update and append keys and values from the second
   * @param data1 - initial data
   * @param data2 - updated data
   * @return updated data1 with data2 keys and values
   */
  static smart_objects::SmartObject MergeModuleData(
      const smart_objects::SmartObject& data1,
      const smart_objects::SmartObject& data2);

  /**
   * @brief MergeArray merge two arrays if their elements contain an `id`
   * parameter
   * @param data1 - initial data
   * @param data2 - updated data
   * @return updated data1 with any values in data2 if the arrays can be merged,
   * otherwise data2
   */
  static smart_objects::SmartObject MergeArray(
      const smart_objects::SmartObject& data1,
      const smart_objects::SmartObject& data2);

  /**
   * @brief Determines the success of the response
   * judging from message type received from HMI
   * @param response from HMI
   */
  static bool IsResponseSuccessful(const smart_objects::SmartObject& response);
};

}  // namespace rc_rpc_plugin
#endif  // SRC_COMPONENTS_APPLICATION_MANAGER_RPC_PLUGINS_RC_RPC_PLUGIN_INCLUDE_RC_RPC_PLUGIN_RC_HELPERS_H_